Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

compiler

package

Go to main page

Versions in this module

v0

v0.0.2

Apr 25, 2026

Changes in this version

type Program

+ func (p *Program) Tracing() *tracing.Tracing

type ProgramOptions

+ Tracing *tracing.Tracing

v0.0.1

Apr 11, 2026

Changes in this version

+ func FilterNoEmitSemanticDiagnostics(diagnostics []*ast.Diagnostic, options *core.CompilerOptions) []*ast.Diagnostic

+ func GetDiagnosticsOfAnyProgram(ctx context.Context, program ProgramLike, file *ast.SourceFile, ...) []*ast.Diagnostic

+ func SortAndDeduplicateDiagnostics(diagnostics []*ast.Diagnostic) []*ast.Diagnostic

+ type CheckerPool interface

+ GetChecker func(ctx context.Context, file *ast.SourceFile) (*checker.Checker, func())

+ type CompilerHost interface

+ DefaultLibraryPath func() string

+ FS func() vfs.FS

+ GetCurrentDirectory func() string

+ GetResolvedProjectReference func(fileName string, path tspath.Path) *tsoptions.ParsedCommandLine

+ GetSourceFile func(opts ast.SourceFileParseOptions) *ast.SourceFile

+ Trace func(msg *diagnostics.Message, args ...any)

+ func NewCachedFSCompilerHost(currentDirectory string, fs vfs.FS, defaultLibraryPath string, ...) CompilerHost

+ func NewCompilerHost(currentDirectory string, fs vfs.FS, defaultLibraryPath string, ...) CompilerHost

+ type DuplicateSourceFile struct

+ Hash xxh3.Uint128

+ ParseOptions ast.SourceFileParseOptions

+ ScriptKind core.ScriptKind

+ type EmitHost interface

+ CommonSourceDirectory func() string

+ GetCurrentDirectory func() string

+ IsEmitBlocked func(file string) bool

+ Options func() *core.CompilerOptions

+ SourceFiles func() []*ast.SourceFile

+ UseCaseSensitiveFileNames func() bool

+ type EmitOnly byte

+ const EmitAll

+ const EmitOnlyDts

+ const EmitOnlyForcedDts

+ const EmitOnlyJs

+ type EmitOptions struct

+ EmitOnly EmitOnly

+ TargetSourceFile *ast.SourceFile

+ WriteFile WriteFile

+ type EmitResult struct

+ Diagnostics []*ast.Diagnostic

+ EmitSkipped bool

+ EmittedFiles []string

+ SourceMaps []*SourceMapEmitResult

+ func CombineEmitResults(results []*EmitResult) *EmitResult

+ func HandleNoEmitOnError(ctx context.Context, program ProgramLike, file *ast.SourceFile) *EmitResult

+ type FileIncludeReason struct

+ type LibFile struct

+ Name string

+ Replaced bool

+ type Program struct

+ func NewProgram(opts ProgramOptions) *Program

+ func (p *Program) BindSourceFiles()

+ func (p *Program) CommandLine() *tsoptions.ParsedCommandLine

+ func (p *Program) CommonSourceDirectory() string

+ func (p *Program) DuplicateSourceFiles() []*DuplicateSourceFile

+ func (p *Program) Emit(ctx context.Context, options EmitOptions) *EmitResult

+ func (p *Program) ExplainFiles(w io.Writer, locale locale.Locale)

+ func (p *Program) FileExists(path string) bool

+ func (p *Program) FilesByPath() map[tspath.Path]*ast.SourceFile

+ func (p *Program) ForEachCheckerParallel(cb func(idx int, c *checker.Checker))

+ func (p *Program) ForEachResolvedModule(...)

+ func (p *Program) ForEachResolvedTypeReferenceDirective(...)

+ func (p *Program) GetBindDiagnostics(ctx context.Context, sourceFile *ast.SourceFile) []*ast.Diagnostic

+ func (p *Program) GetConfigFileParsingDiagnostics() []*ast.Diagnostic

+ func (p *Program) GetCurrentDirectory() string

+ func (p *Program) GetDeclarationDiagnostics(ctx context.Context, sourceFile *ast.SourceFile) []*ast.Diagnostic

+ func (p *Program) GetDefaultLibFile(path tspath.Path) *LibFile

+ func (p *Program) GetDefaultResolutionModeForFile(sourceFile ast.HasFileName) core.ResolutionMode

+ func (p *Program) GetEmitModuleFormatOfFile(sourceFile ast.HasFileName) core.ModuleKind

+ func (p *Program) GetEmitSyntaxForUsageLocation(sourceFile ast.HasFileName, location *ast.StringLiteralLike) core.ResolutionMode

+ func (p *Program) GetGlobalDiagnostics(ctx context.Context) []*ast.Diagnostic

+ func (p *Program) GetGlobalTypingsCacheLocation() string

+ func (p *Program) GetImpliedNodeFormatForEmit(sourceFile ast.HasFileName) core.ResolutionMode

+ func (p *Program) GetImportHelpersImportSpecifier(path tspath.Path) *ast.Node

+ func (p *Program) GetIncludeProcessorDiagnostics(sourceFile *ast.SourceFile) []*ast.Diagnostic

+ func (p *Program) GetIncludeReasons() map[tspath.Path][]*FileIncludeReason

+ func (p *Program) GetJSXRuntimeImportSpecifier(path tspath.Path) (moduleReference string, specifier *ast.Node)

+ func (p *Program) GetLibFileFromReference(ref *ast.FileReference) *ast.SourceFile

+ func (p *Program) GetModeForUsageLocation(sourceFile ast.HasFileName, location *ast.StringLiteralLike) core.ResolutionMode

+ func (p *Program) GetNearestAncestorDirectoryWithPackageJson(dirname string) string

+ func (p *Program) GetPackageJsonInfo(pkgJsonPath string) *packagejson.InfoCacheEntry

+ func (p *Program) GetPackagesMap() map[string]bool

+ func (p *Program) GetParseFileRedirect(fileName string) string

+ func (p *Program) GetProgramDiagnostics() []*ast.Diagnostic

+ func (p *Program) GetProjectReferenceFromOutputDts(path tspath.Path) *tsoptions.SourceOutputAndProjectReference

+ func (p *Program) GetProjectReferenceFromSource(path tspath.Path) *tsoptions.SourceOutputAndProjectReference

+ func (p *Program) GetRedirectForResolution(file ast.HasFileName) *tsoptions.ParsedCommandLine

+ func (p *Program) GetRedirectTargets(path tspath.Path) []string

+ func (p *Program) GetResolvedModule(file ast.HasFileName, moduleReference string, mode core.ResolutionMode) *module.ResolvedModule

+ func (p *Program) GetResolvedModuleFromModuleSpecifier(file ast.HasFileName, moduleSpecifier *ast.StringLiteralLike) *module.ResolvedModule

+ func (p *Program) GetResolvedModules() map[tspath.Path]module.ModeAwareCache[*module.ResolvedModule]

+ func (p *Program) GetResolvedProjectReferenceFor(path tspath.Path) (*tsoptions.ParsedCommandLine, bool)

+ func (p *Program) GetResolvedProjectReferences() []*tsoptions.ParsedCommandLine

+ func (p *Program) GetResolvedTypeReferenceDirectiveFromTypeReferenceDirective(typeRef *ast.FileReference, sourceFile *ast.SourceFile) *module.ResolvedTypeReferenceDirective

+ func (p *Program) GetResolvedTypeReferenceDirectives() map[tspath.Path]module.ModeAwareCache[*module.ResolvedTypeReferenceDirective]

+ func (p *Program) GetSemanticDiagnostics(ctx context.Context, sourceFile *ast.SourceFile) []*ast.Diagnostic

+ func (p *Program) GetSemanticDiagnosticsWithoutNoEmitFiltering(ctx context.Context, sourceFiles []*ast.SourceFile) map[*ast.SourceFile][]*ast.Diagnostic

+ func (p *Program) GetSourceFile(filename string) *ast.SourceFile

+ func (p *Program) GetSourceFileByPath(path tspath.Path) *ast.SourceFile

+ func (p *Program) GetSourceFileForResolvedModule(fileName string) *ast.SourceFile

+ func (p *Program) GetSourceFileFromReference(origin *ast.SourceFile, ref *ast.FileReference) *ast.SourceFile

+ func (p *Program) GetSourceFileMetaData(path tspath.Path) ast.SourceFileMetaData

+ func (p *Program) GetSourceFiles() []*ast.SourceFile

+ func (p *Program) GetSourceOfProjectReferenceIfOutputIncluded(file ast.HasFileName) string

+ func (p *Program) GetSuggestionDiagnostics(ctx context.Context, sourceFile *ast.SourceFile) []*ast.Diagnostic

+ func (p *Program) GetSymlinkCache() *symlinks.KnownSymlinks

+ func (p *Program) GetSyntacticDiagnostics(ctx context.Context, sourceFile *ast.SourceFile) []*ast.Diagnostic

+ func (p *Program) GetTypeChecker(ctx context.Context) (*checker.Checker, func())

+ func (p *Program) GetTypeCheckerForFile(ctx context.Context, file *ast.SourceFile) (*checker.Checker, func())

+ func (p *Program) GetTypeCheckerForFileExclusive(ctx context.Context, file *ast.SourceFile) (*checker.Checker, func())

+ func (p *Program) GetUnresolvedImports() *collections.Set[string]

+ func (p *Program) HasSameFileNames(other *Program) bool

+ func (p *Program) HasTSFile() bool

+ func (p *Program) Host() CompilerHost

+ func (p *Program) IdentifierCount() int

+ func (p *Program) InstantiationCount() int

+ func (p *Program) IsEmitBlocked(emitFileName string) bool

+ func (p *Program) IsGlobalTypingsFile(fileName string) bool

+ func (p *Program) IsLibFile(sourceFile *ast.SourceFile) bool

+ func (p *Program) IsMissingPath(path tspath.Path) bool

+ func (p *Program) IsSourceFileDefaultLibrary(path tspath.Path) bool

+ func (p *Program) IsSourceFileFromExternalLibrary(file *ast.SourceFile) bool

+ func (p *Program) IsSourceFromProjectReference(path tspath.Path) bool

+ func (p *Program) LineCount() int

+ func (p *Program) Options() *core.CompilerOptions

+ func (p *Program) Program() *Program

+ func (p *Program) RangeResolvedProjectReference(f func(path tspath.Path, config *tsoptions.ParsedCommandLine, ...) bool) bool

+ func (p *Program) RangeResolvedProjectReferenceInChildConfig(childConfig *tsoptions.ParsedCommandLine, ...) bool

+ func (p *Program) ResolveModuleName(moduleName string, containingFile string, resolutionMode core.ResolutionMode) *module.ResolvedModule

+ func (p *Program) ResolvedPackageNames() *collections.Set[string]

+ func (p *Program) SingleThreaded() bool

+ func (p *Program) SkipTypeChecking(sourceFile *ast.SourceFile, ignoreNoCheck bool) bool

+ func (p *Program) SourceFileMayBeEmitted(sourceFile *ast.SourceFile, forceDtsEmit bool) bool

+ func (p *Program) SourceFiles() []*ast.SourceFile

+ func (p *Program) SymbolCount() int

+ func (p *Program) TypeCount() int

+ func (p *Program) UnresolvedPackageNames() *collections.Set[string]

+ func (p *Program) UpdateProgram(changedFilePath tspath.Path, newHost CompilerHost) (*Program, bool)

+ func (p *Program) UseCaseSensitiveFileNames() bool

+ func (p *Program) UsesUriStyleNodeCoreModules() core.Tristate

+ type ProgramLike interface

+ CommonSourceDirectory func() string

+ Emit func(ctx context.Context, options EmitOptions) *EmitResult

+ GetBindDiagnostics func(ctx context.Context, file *ast.SourceFile) []*ast.Diagnostic

+ GetConfigFileParsingDiagnostics func() []*ast.Diagnostic

+ GetDeclarationDiagnostics func(ctx context.Context, file *ast.SourceFile) []*ast.Diagnostic

+ GetGlobalDiagnostics func(ctx context.Context) []*ast.Diagnostic

+ GetProgramDiagnostics func() []*ast.Diagnostic

+ GetSemanticDiagnostics func(ctx context.Context, file *ast.SourceFile) []*ast.Diagnostic

+ GetSourceFile func(path string) *ast.SourceFile

+ GetSourceFiles func() []*ast.SourceFile

+ GetSuggestionDiagnostics func(ctx context.Context, file *ast.SourceFile) []*ast.Diagnostic

+ GetSyntacticDiagnostics func(ctx context.Context, file *ast.SourceFile) []*ast.Diagnostic

+ IsSourceFileDefaultLibrary func(path tspath.Path) bool

+ Options func() *core.CompilerOptions

+ Program func() *Program

+ type ProgramOptions struct

+ Config *tsoptions.ParsedCommandLine

+ CreateCheckerPool func(*Program) CheckerPool

+ Host CompilerHost

+ ProjectName string

+ SingleThreaded core.Tristate

+ TypingsLocation string

+ UseSourceOfProjectReference bool

+ type SourceFileMayBeEmittedHost interface

+ GetCurrentDirectory func() string

+ GetProjectReferenceFromSource func(path tspath.Path) *tsoptions.SourceOutputAndProjectReference

+ IsSourceFileFromExternalLibrary func(file *ast.SourceFile) bool

+ Options func() *core.CompilerOptions

+ SourceFiles func() []*ast.SourceFile

+ UseCaseSensitiveFileNames func() bool

+ type SourceMapEmitResult struct

+ GeneratedFile string

+ InputSourceFileNames []string

+ SourceMap *sourcemap.RawSourceMap

+ type WriteFile func(fileName string, text string, data *WriteFileData) error

+ type WriteFileData struct

+ BuildInfo any

+ Diagnostics []*ast.Diagnostic

+ SkippedDtsWrite bool

+ SourceMapUrlPos int