package cache

Import Path
	github.com/evanw/esbuild/internal/cache (on go.dev)

Dependency Relation
	imports 8 packages, and imported by 3 packages

Involved Source Files

	      cache.go
	      cache_ast.go
	      cache_fs.go
Package-Level Type Names (total 12, in which 7 are exported)

	/* sort exporteds by: alphabet | popularity */
	 type CacheSet (struct)
		This is a cache of the parsed contents of a set of files. The idea is to be
		able to reuse the results of parsing between builds and make subsequent
		builds faster by avoiding redundant parsing work. This only works if:

		* The AST information in the cache must be considered immutable. There is
		  no way to enforce this in Go, but please be disciplined about this. The
		  ASTs are shared in between builds. Any information that must be mutated
		  in the AST during a build must be done on a shallow clone of the data if
		  the mutation happens after parsing (i.e. a clone that clones everything
		  that will be mutated and shares only the parts that won't be mutated).

		* The information in the cache must not depend at all on the contents of
		  any file other than the file being cached. Invalidating an entry in the
		  cache does not also invalidate any entries that depend on that file, so
		  caching information that depends on other files can result in incorrect
		  results due to reusing stale data. For example, do not "bake in" some
		  value imported from another file.

		* Cached ASTs must only be reused if the parsing options are identical
		  between builds. For example, it would be bad if the AST parser depended
		  on options inherited from a nearby "package.json" file but those options
		  were not part of the cache key. Then the cached AST could incorrectly be
		  reused even if the contents of that "package.json" file have changed.

		Fields (total 5, all are exported)
			CSSCache CSSCache
			FSCache FSCache
			JSCache JSCache
			JSONCache JSONCache
			SourceIndexCache SourceIndexCache
		As Outputs Of (at least one exported)
			func MakeCacheSet() *CacheSet
		As Inputs Of (at least 3, in which 2 are exported)
			func github.com/evanw/esbuild/internal/bundler.ScanBundle(log logger.Log, fs fs.FS, res resolver.Resolver, caches *CacheSet, entryPoints []string, options config.Options) bundler.Bundle
			func github.com/evanw/esbuild/internal/resolver.NewResolver(fs fs.FS, log logger.Log, caches *CacheSet, options config.Options) resolver.Resolver
			/* at least one unexported ... *//* at least one unexported: */
			func github.com/evanw/esbuild/pkg/api.rebuildImpl(buildOpts api.BuildOptions, caches *CacheSet, plugins []config.Plugin, logOptions logger.OutputOptions, log logger.Log, isRebuild bool) api.internalBuildResult

	 type CSSCache (struct)

		Fields (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			entries map[logger.Path]*cssCacheEntry
			mutex sync.Mutex
		Methods (only one, which is exported)
			(*T) Parse(log logger.Log, source logger.Source, options css_parser.Options) css_ast.AST

	 type FSCache (struct)

		Fields (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			entries map[string]*fsEntry
			mutex sync.Mutex
		Methods (only one, which is exported)
			(*T) ReadFile(fs fs.FS, path string) (string, error)
		As Inputs Of (at least 2, neither is exported)
			/* 2+ unexporteds ... *//* 2+ unexporteds: */
			func github.com/evanw/esbuild/internal/bundler.extractSourceMapFromComment(log logger.Log, fs fs.FS, fsCache *FSCache, res resolver.Resolver, source *logger.Source, comment js_ast.Span, absResolveDir string) (logger.Path, *string)
			func github.com/evanw/esbuild/internal/bundler.runOnLoadPlugins(plugins []config.Plugin, res resolver.Resolver, fs fs.FS, fsCache *FSCache, log logger.Log, source *logger.Source, importSource *logger.Source, importPathRange logger.Range, pluginData interface{}, isWatchMode bool) (bundler.loaderPluginResult, bool)

	 type JSCache (struct)

		Fields (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			entries map[logger.Path]*jsCacheEntry
			mutex sync.Mutex
		Methods (only one, which is exported)
			(*T) Parse(log logger.Log, source logger.Source, options js_parser.Options) (js_ast.AST, bool)

	 type JSONCache (struct)

		Fields (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			entries map[logger.Path]*jsonCacheEntry
			mutex sync.Mutex
		Methods (only one, which is exported)
			(*T) Parse(log logger.Log, source logger.Source, options js_parser.JSONOptions) (js_ast.Expr, bool)
		As Inputs Of (at least one exported)
			func github.com/evanw/esbuild/internal/resolver.ParseTSConfigJSON(log logger.Log, source logger.Source, jsonCache *JSONCache, extends func(string, logger.Range) *resolver.TSConfigJSON) *resolver.TSConfigJSON

	 type SourceIndexCache (struct)

		Fields (total 3, none are exported)
			/* 3 unexporteds ... *//* 3 unexporteds: */
			entries map[sourceIndexKey]uint32
			mutex sync.Mutex
			nextSourceIndex uint32
		Methods (total 2, both are exported)
			(*T) Get(path logger.Path, kind SourceIndexKind) uint32
			(*T) LenHint() uint32

	 type SourceIndexKind uint8 (basic type)

		As Inputs Of (at least one exported)
			func (*SourceIndexCache).Get(path logger.Path, kind SourceIndexKind) uint32
		As Types Of (total 2, both are exported)
			const SourceIndexJSStubForCSS
			const SourceIndexNormal

	/* 5 unexporteds ... *//* 5 unexporteds: */
	 type cssCacheEntry (struct)

		Fields (total 4, none are exported)
			/* 4 unexporteds ... *//* 4 unexporteds: */
			ast css_ast.AST
			msgs []logger.Msg
			options css_parser.Options
			source logger.Source

	 type fsEntry (struct)

		Fields (total 3, none are exported)
			/* 3 unexporteds ... *//* 3 unexporteds: */
			contents string
			isModKeyUsable bool
			modKey fs.ModKey

	 type jsCacheEntry (struct)

		Fields (total 5, none are exported)
			/* 5 unexporteds ... *//* 5 unexporteds: */
			ast js_ast.AST
			msgs []logger.Msg
			ok bool
			options js_parser.Options
			source logger.Source

	 type jsonCacheEntry (struct)

		Fields (total 5, none are exported)
			/* 5 unexporteds ... *//* 5 unexporteds: */
			expr js_ast.Expr
			msgs []logger.Msg
			ok bool
			options js_parser.JSONOptions
			source logger.Source

	 type sourceIndexKey (struct)

		Fields (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			kind SourceIndexKind
			path logger.Path


Package-Level Functions (only one, which is exported)

	 func MakeCacheSet() *CacheSet
Package-Level Constants (total 2, both are exported)

	const SourceIndexJSStubForCSS SourceIndexKind = 1
	const SourceIndexNormal SourceIndexKind = 0

The pages are generated with Golds v0.3.2-preview. (GOOS=darwin GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @Go100and1 (reachable from the left QR code) to get the latest news of Golds.