@ttsc/wasm 0.30.4 → 0.31.1

package/shim-vendor/shim/scanner/go.mod

@@ -2,4 +2,13 @@ module github.com/microsoft/typescript-go/shim/scanner
 
 go 1.26
 
-require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/zeebo/xxh3 v1.1.0 // indirect
+	golang.org/x/sync v0.21.0 // indirect
+	golang.org/x/sys v0.46.0 // indirect
+	golang.org/x/text v0.38.0 // indirect
+)

package/shim-vendor/shim/scanner/go.sum

@@ -0,0 +1,20 @@
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 h1:nxP4pPoyqOAgX8lYDFCfl3DyKeXErCvSvhcyzwGV9CE=
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=
+github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
+github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
+github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
+github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
+golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
+golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.38.0 h1:sXmwo9DwP3OK9EZ7PqAdaooSGozfl/3a6/xJcbzPRhE=
+golang.org/x/text v0.38.0/go.mod h1:YXZt3QhHUKYT53r2lLKFIVi6Ao1jdzrTR/KQ09qyxF4=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim-vendor/shim/scanner/regexp.go

@@ -5,10 +5,25 @@ import (
   "github.com/microsoft/typescript-go/internal/diagnostics"
 )
 
-// IsValidRegularExpressionLiteral reports whether text is one complete,
-// grammar-valid ECMAScript regular-expression literal. It deliberately uses
-// typescript-go's own scanner and regexp parser so callers share the compiler's
-// handling of escapes, flags, Unicode mode, and Unicode Sets syntax.
+// IsValidRegularExpressionLiteral reports whether text contains one regexp
+// literal accepted without diagnostics by the pinned compiler's scanner and
+// regexp parser, after optional leading scanner trivia. It uses the scanner's
+// default latest target and the compiler's escape, flag, Unicode and Unicode
+// Sets policies. This is not a runtime regexp-execution check or a complete
+// certificate of ECMAScript grammar validity: the compiler can diagnose
+// otherwise Annex-B-compatible backreferences as likely mistakes.
+//
+// Trailing text is rejected, including whitespace after the literal. Scanner
+// diagnostics cause a false result rather than escaping.
+//
+// @evidence contracts/common.md#principled-implementation The initial slash token enters upstream's regexp rescan mode; success requires a regexp token, no scanner diagnostic, and a token end equal to the input byte length, establishing one literal after the scanner's permitted leading trivia.
+// @evidence contracts/common.md#clear-and-simple-design A fresh local scanner and diagnostic flag handle one input without shared parser state or an independent regexp grammar.
+// @evidence contracts/common.md#prohibited-implementation-shortcuts Slash and slash-equals are the scanner's documented regexp-entry tokens; the diagnostic callback uses supported injection rather than replacing scanner internals.
+// @evidence contracts/common.md#meaningful-documentation Native prose states compiler grammar ownership, leading-trivia acceptance, trailing-text rejection and diagnostic-to-false behavior, with a separate acknowledgment section.
+// @evidence contracts/performance.md#bound-retention-and-release-resources One local scanner retains the input during the call, and regexp parsing can allocate capture/name/reference maps and lists plus recursive group state. Only a boolean escapes; scanner, callback and parser storage become unreachable after completion. There is no historical cache, handle, input-size cap or adapter-enforced nesting limit.
+// @evidence contracts/performance.md#efficient-algorithms One scanner performs leading-trivia admission, delimiter and flag scanning and compiler regexp parsing, then checks token-end equality without an independent grammar implementation. Work grows with text bytes, nested groups, captures and references; invalid named references can also trigger upstream spelling suggestions across capture names even though diagnostics only set a flag here. The adapter does not claim fixed work or an early parser stop after the first diagnostic.
+// @evidenceExclude contracts/performance.md#reuse-equivalent-work This predicate owns no cross-request producer or validity coordinator; a fresh scanner keeps token state and diagnostic observation local to the supplied text, with no shared mutable parse state.
+// @evidenceExclude contracts/portability.md#os-neutral-implementation IsValidRegularExpressionLiteral computes from its arguments only; it opens no file, builds no path and calls no platform or process API.
 func IsValidRegularExpressionLiteral(text string) bool {
   scanner := NewScanner()
   valid := true

package/shim-vendor/shim/scanner/shim.go

@@ -74,6 +74,9 @@ func GetShebang(text string) string
 //go:linkname GetSourceTextOfNodeFromSourceFile github.com/microsoft/typescript-go/internal/scanner.GetSourceTextOfNodeFromSourceFile
 func GetSourceTextOfNodeFromSourceFile(sourceFile *ast.SourceFile, node *ast.Node, includeTrivia bool) string
 
+//go:linkname GetTextOfJSDocComment github.com/microsoft/typescript-go/internal/scanner.GetTextOfJSDocComment
+func GetTextOfJSDocComment(comment *ast.NodeList) string
+
 //go:linkname GetTextOfNode github.com/microsoft/typescript-go/internal/scanner.GetTextOfNode
 func GetTextOfNode(node *ast.Node) string
 

package/shim-vendor/shim/stringutil/extra-shim.json

@@ -0,0 +1 @@
+{}

package/shim-vendor/shim/stringutil/go.mod

@@ -0,0 +1,5 @@
+module github.com/microsoft/typescript-go/shim/stringutil
+
+go 1.26
+
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063

package/shim-vendor/shim/stringutil/go.sum

@@ -0,0 +1,2 @@
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=

package/shim-vendor/shim/stringutil/shim.go

@@ -0,0 +1,119 @@
+// Code generated by packages/ttsc/tools/gen_shims. DO NOT EDIT.
+
+package stringutil
+
+import "github.com/microsoft/typescript-go/internal/stringutil"
+import _ "unsafe"
+
+//go:linkname AddUTF8ByteOrderMark github.com/microsoft/typescript-go/internal/stringutil.AddUTF8ByteOrderMark
+func AddUTF8ByteOrderMark(text string) string
+
+//go:linkname CodePointToSurrogatePair github.com/microsoft/typescript-go/internal/stringutil.CodePointToSurrogatePair
+func CodePointToSurrogatePair(ch rune) (high rune, low rune)
+
+//go:linkname CombineSurrogatePairs github.com/microsoft/typescript-go/internal/stringutil.CombineSurrogatePairs
+func CombineSurrogatePairs(s string) string
+
+//go:linkname CompareStringsCaseInsensitive github.com/microsoft/typescript-go/internal/stringutil.CompareStringsCaseInsensitive
+func CompareStringsCaseInsensitive(a string, b string) stringutil.Comparison
+
+//go:linkname CompareStringsCaseInsensitiveEslintCompatible github.com/microsoft/typescript-go/internal/stringutil.CompareStringsCaseInsensitiveEslintCompatible
+func CompareStringsCaseInsensitiveEslintCompatible(a string, b string) stringutil.Comparison
+
+//go:linkname CompareStringsCaseInsensitiveThenSensitive github.com/microsoft/typescript-go/internal/stringutil.CompareStringsCaseInsensitiveThenSensitive
+func CompareStringsCaseInsensitiveThenSensitive(a string, b string) stringutil.Comparison
+
+//go:linkname CompareStringsCaseSensitive github.com/microsoft/typescript-go/internal/stringutil.CompareStringsCaseSensitive
+func CompareStringsCaseSensitive(a string, b string) stringutil.Comparison
+
+type Comparison = stringutil.Comparison
+
+const ComparisonEqual = stringutil.ComparisonEqual
+const ComparisonGreaterThan = stringutil.ComparisonGreaterThan
+const ComparisonLessThan = stringutil.ComparisonLessThan
+
+//go:linkname DecodeJSStringRune github.com/microsoft/typescript-go/internal/stringutil.DecodeJSStringRune
+func DecodeJSStringRune(s string) (rune, int)
+
+//go:linkname EncodeJSStringRune github.com/microsoft/typescript-go/internal/stringutil.EncodeJSStringRune
+func EncodeJSStringRune(ch rune) string
+
+//go:linkname EncodeURI github.com/microsoft/typescript-go/internal/stringutil.EncodeURI
+func EncodeURI(s string) string
+
+//go:linkname EquateStringCaseInsensitive github.com/microsoft/typescript-go/internal/stringutil.EquateStringCaseInsensitive
+func EquateStringCaseInsensitive(a string, b string) bool
+
+//go:linkname EquateStringCaseSensitive github.com/microsoft/typescript-go/internal/stringutil.EquateStringCaseSensitive
+func EquateStringCaseSensitive(a string, b string) bool
+
+//go:linkname GetStringComparer github.com/microsoft/typescript-go/internal/stringutil.GetStringComparer
+func GetStringComparer(ignoreCase bool) func(a string, b string) stringutil.Comparison
+
+//go:linkname GetStringEqualityComparer github.com/microsoft/typescript-go/internal/stringutil.GetStringEqualityComparer
+func GetStringEqualityComparer(ignoreCase bool) func(a string, b string) bool
+
+//go:linkname GuessIndentation github.com/microsoft/typescript-go/internal/stringutil.GuessIndentation
+func GuessIndentation(lines []string) int
+
+//go:linkname HasPrefix github.com/microsoft/typescript-go/internal/stringutil.HasPrefix
+func HasPrefix(s string, prefix string, caseSensitive bool) bool
+
+//go:linkname HasPrefixAndSuffixWithoutOverlap github.com/microsoft/typescript-go/internal/stringutil.HasPrefixAndSuffixWithoutOverlap
+func HasPrefixAndSuffixWithoutOverlap(s string, prefix string, suffix string, caseSensitive bool) bool
+
+//go:linkname HasSuffix github.com/microsoft/typescript-go/internal/stringutil.HasSuffix
+func HasSuffix(s string, suffix string, caseSensitive bool) bool
+
+//go:linkname IsASCIILetter github.com/microsoft/typescript-go/internal/stringutil.IsASCIILetter
+func IsASCIILetter(ch rune) bool
+
+//go:linkname IsDigit github.com/microsoft/typescript-go/internal/stringutil.IsDigit
+func IsDigit(ch rune) bool
+
+//go:linkname IsHexDigit github.com/microsoft/typescript-go/internal/stringutil.IsHexDigit
+func IsHexDigit(ch rune) bool
+
+//go:linkname IsHighSurrogate github.com/microsoft/typescript-go/internal/stringutil.IsHighSurrogate
+func IsHighSurrogate(ch rune) bool
+
+//go:linkname IsLineBreak github.com/microsoft/typescript-go/internal/stringutil.IsLineBreak
+func IsLineBreak(ch rune) bool
+
+//go:linkname IsLowSurrogate github.com/microsoft/typescript-go/internal/stringutil.IsLowSurrogate
+func IsLowSurrogate(ch rune) bool
+
+//go:linkname IsOctalDigit github.com/microsoft/typescript-go/internal/stringutil.IsOctalDigit
+func IsOctalDigit(ch rune) bool
+
+//go:linkname IsSurrogate github.com/microsoft/typescript-go/internal/stringutil.IsSurrogate
+func IsSurrogate(ch rune) bool
+
+//go:linkname IsWhiteSpaceLike github.com/microsoft/typescript-go/internal/stringutil.IsWhiteSpaceLike
+func IsWhiteSpaceLike(ch rune) bool
+
+//go:linkname IsWhiteSpaceSingleLine github.com/microsoft/typescript-go/internal/stringutil.IsWhiteSpaceSingleLine
+func IsWhiteSpaceSingleLine(ch rune) bool
+
+//go:linkname LowerFirstChar github.com/microsoft/typescript-go/internal/stringutil.LowerFirstChar
+func LowerFirstChar(str string) string
+
+//go:linkname RemoveByteOrderMark github.com/microsoft/typescript-go/internal/stringutil.RemoveByteOrderMark
+func RemoveByteOrderMark(text string) string
+
+//go:linkname SplitLines github.com/microsoft/typescript-go/internal/stringutil.SplitLines
+func SplitLines(text string) []string
+
+//go:linkname StripQuotes github.com/microsoft/typescript-go/internal/stringutil.StripQuotes
+func StripQuotes(name string) string
+
+const SurrogateLowStart = stringutil.SurrogateLowStart
+
+//go:linkname SurrogatePairToCodePoint github.com/microsoft/typescript-go/internal/stringutil.SurrogatePairToCodePoint
+func SurrogatePairToCodePoint(high rune, low rune) rune
+
+//go:linkname TruncateByRunes github.com/microsoft/typescript-go/internal/stringutil.TruncateByRunes
+func TruncateByRunes(str string, maxLength int) string
+
+//go:linkname UnquoteString github.com/microsoft/typescript-go/internal/stringutil.UnquoteString
+func UnquoteString(str string) string

package/shim-vendor/shim/transformers/go.mod

@@ -2,13 +2,13 @@ module github.com/microsoft/typescript-go/shim/transformers
 
 go 1.26
 
-require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063
 
 require (
-	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
+	github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 // indirect
 	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
 	github.com/zeebo/xxh3 v1.1.0 // indirect
-	golang.org/x/sync v0.20.0 // indirect
-	golang.org/x/sys v0.43.0 // indirect
-	golang.org/x/text v0.36.0 // indirect
+	golang.org/x/sync v0.21.0 // indirect
+	golang.org/x/sys v0.46.0 // indirect
+	golang.org/x/text v0.38.0 // indirect
 )

package/shim-vendor/shim/transformers/go.sum

@@ -1,20 +1,22 @@
-github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 h1:vymEbVwYFP/L05h5TKQxvkXoKxNvTpjxYKdF1Nlwuao=
-github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 h1:nxP4pPoyqOAgX8lYDFCfl3DyKeXErCvSvhcyzwGV9CE=
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
 github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
 github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
-github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 h1:llOMPhKDiQ+UEJiAaQuuWaJOTg5V7tNNTEf9JPWoYSY=
-github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157/go.mod h1:m8YA0PMC7ti0GW0RI05D6fEcjQeu98XVS+FWF+VDW2k=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=
+github.com/peter-evans/patience v0.3.0 h1:rX0JdJeepqdQl1Sk9c9uvorjYYzL2TfgLX1adqYm9cA=
+github.com/peter-evans/patience v0.3.0/go.mod h1:Kmxu5sY1NmBLFSStvXjX1wS9mIv7wMcP/ubucyMOAu0=
 github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
 github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
 github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
 github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
-golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
-golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
-golang.org/x/sys v0.43.0 h1:Rlag2XtaFTxp19wS8MXlJwTvoh8ArU6ezoyFsMyCTNI=
-golang.org/x/sys v0.43.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/text v0.36.0 h1:JfKh3XmcRPqZPKevfXVpI1wXPTqbkE5f7JA92a55Yxg=
-golang.org/x/text v0.36.0/go.mod h1:NIdBknypM8iqVmPiuco0Dh6P5Jcdk8lJL0CUebqK164=
+golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
+golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
+golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.38.0 h1:sXmwo9DwP3OK9EZ7PqAdaooSGozfl/3a6/xJcbzPRhE=
+golang.org/x/text v0.38.0/go.mod h1:YXZt3QhHUKYT53r2lLKFIVi6Ao1jdzrTR/KQ09qyxF4=
 gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
 gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim-vendor/shim/transformers/shim.go

@@ -9,7 +9,16 @@ package transformers
 
 import innertransformers "github.com/microsoft/typescript-go/internal/transformers"
 
-// Transformer is one stage of tsgo's emit transformer chain
-// (TransformSourceFile mutates the SourceFile AST in place within the emit
-// EmitContext).
+// Transformer is one stage of tsgo's emit transformer chain.
+// TransformSourceFile returns the visited source file, which may replace the
+// input; its visitor and factory share the stage's EmitContext.
+//
+// @evidence contracts/common.md#principled-implementation Go alias identity preserves the upstream visitor, factory and context relationship; callers receive the transformed SourceFile returned by the visitor rather than assuming in-place mutation.
+// @evidence contracts/common.md#clear-and-simple-design One native transformer stage participates in the existing chain without an additional transform protocol or duplicated visitor state.
+// @evidence contracts/common.md#prohibited-implementation-shortcuts Plugins return compiler AST nodes through the supported stage, without text-splice substitutes or monkey-patched builtin passes.
+// @evidence contracts/common.md#meaningful-documentation Native prose identifies the possible replacement result and shared context rather than promising preservation of the input node's identity.
+// @evidenceExclude contracts/performance.md#bound-retention-and-release-resources A type declaration acquires and holds no runtime resource.
+// @evidenceExclude contracts/performance.md#efficient-algorithms A type declaration chooses no processing strategy.
+// @evidenceExclude contracts/performance.md#reuse-equivalent-work A type declaration computes nothing, so there is no work to share.
+// @evidenceExclude contracts/portability.md#os-neutral-implementation This type declaration describes a data shape only; it opens no file, builds no path and branches on no platform.
 type Transformer = innertransformers.Transformer

package/shim-vendor/shim/tsoptions/command_line_raw.go

@@ -0,0 +1,44 @@
+// gen_shims:hand-maintained
+
+package tsoptions
+
+import (
+  "github.com/microsoft/typescript-go/internal/collections"
+  "github.com/microsoft/typescript-go/internal/tsoptions"
+)
+
+// CommandLineRawOptions returns the options a parsed command line spelled out,
+// wrapped in a "compilerOptions" key: the `optionsRaw` shape
+// GetParsedCommandLineOfConfigFile merges over the config it parses.
+//
+// TypeScript-Go's own command line passes exactly this beside the parsed
+// CompilerOptions. The struct alone cannot carry an option the command line
+// resets: `--declarationDir null` leaves the field at its zero value, which the
+// merge reads as "not given", so the config's own value survives. The raw map
+// records the explicit null, and the merge honors it.
+//
+// Returns nil for a nil command line or an absent, nil or differently typed
+// raw value. A present ordered map is wrapped even when it contains no options.
+// The wrapper retains the original ordered map; callers must not mutate it
+// while configuration merging reads the command line.
+//
+// @evidence contracts/common.md#principled-implementation The compilerOptions wrapper preserves the parsed ordered raw values, including explicit null, because config merging distinguishes an absent option from a supplied zero-like value.
+// @evidence contracts/common.md#clear-and-simple-design Nil and raw-shape checks precede one ordered-map wrapper, keeping representation adaptation separate from the config parser that owns merging.
+// @evidence contracts/common.md#prohibited-implementation-shortcuts compilerOptions is the compiler's merge-envelope key, not a consumer exception; the adapter preserves upstream parsing rather than patching fields or inventing reset values.
+// @evidence contracts/common.md#meaningful-documentation Native prose explains explicit-null reset semantics, nil results and shared-map ownership, keeping the example and ownership note in distinct paragraphs.
+// @evidence contracts/performance.md#bound-retention-and-release-resources The returned one-entry wrapper retains the original ordered map and its reachable raw option values for its consumers; it adds no deep copy, handle or historical cache. Callers own reference release and must avoid concurrent mutation during merging; this adapter imposes no bound on the supplied raw graph.
+// @evidence contracts/performance.md#efficient-algorithms Nil and type checks precede one insertion into a fresh ordered map, taking constant wrapper work and space independent of raw option count; the raw values are referenced without traversal or copying, while downstream config merging owns its separate option scan.
+// @evidenceExclude contracts/performance.md#reuse-equivalent-work This representation adapter owns no shared producer, request cache or validity coordinator; upstream parsing produces the supplied raw map and callers determine when that same command line remains valid for merging.
+// @evidenceExclude contracts/portability.md#os-neutral-implementation CommandLineRawOptions computes from its arguments only; it opens no file, builds no path and calls no platform or process API.
+func CommandLineRawOptions(commandLine *tsoptions.ParsedCommandLine) *collections.OrderedMap[string, any] {
+  if commandLine == nil {
+    return nil
+  }
+  raw, ok := commandLine.Raw.(*collections.OrderedMap[string, any])
+  if !ok || raw == nil {
+    return nil
+  }
+  wrapped := &collections.OrderedMap[string, any]{}
+  wrapped.Set("compilerOptions", raw)
+  return wrapped
+}

package/shim-vendor/shim/tsoptions/go.mod

@@ -2,4 +2,13 @@ module github.com/microsoft/typescript-go/shim/tsoptions
 
 go 1.26
 
-require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/zeebo/xxh3 v1.1.0 // indirect
+	golang.org/x/sync v0.21.0 // indirect
+	golang.org/x/sys v0.46.0 // indirect
+	golang.org/x/text v0.38.0 // indirect
+)

package/shim-vendor/shim/tsoptions/go.sum

@@ -0,0 +1,22 @@
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 h1:nxP4pPoyqOAgX8lYDFCfl3DyKeXErCvSvhcyzwGV9CE=
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=
+github.com/peter-evans/patience v0.3.0 h1:rX0JdJeepqdQl1Sk9c9uvorjYYzL2TfgLX1adqYm9cA=
+github.com/peter-evans/patience v0.3.0/go.mod h1:Kmxu5sY1NmBLFSStvXjX1wS9mIv7wMcP/ubucyMOAu0=
+github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
+github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
+github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
+github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
+golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
+golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.38.0 h1:sXmwo9DwP3OK9EZ7PqAdaooSGozfl/3a6/xJcbzPRhE=
+golang.org/x/text v0.38.0/go.mod h1:YXZt3QhHUKYT53r2lLKFIVi6Ao1jdzrTR/KQ09qyxF4=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim-vendor/shim/tsoptions/shim.go

@@ -133,7 +133,7 @@ func ParseConfigFileTextToJson(fileName string, path tspath.Path, jsonText strin
 type ParseConfigHost = tsoptions.ParseConfigHost
 
 //go:linkname ParseExtendedConfig github.com/microsoft/typescript-go/internal/tsoptions.ParseExtendedConfig
-func ParseExtendedConfig(fileName string, path tspath.Path, resolutionStack []string, host tsoptions.ParseConfigHost, extendedConfigCache tsoptions.ExtendedConfigCache) *tsoptions.ExtendedConfigCacheEntry
+func ParseExtendedConfig(fileName string, path tspath.Path, resolutionStack []tspath.Path, host tsoptions.ParseConfigHost, extendedConfigCache tsoptions.ExtendedConfigCache) *tsoptions.ExtendedConfigCacheEntry
 
 //go:linkname ParseJsonConfigFileContent github.com/microsoft/typescript-go/internal/tsoptions.ParseJsonConfigFileContent
 func ParseJsonConfigFileContent(json any, host tsoptions.ParseConfigHost, basePath string, existingOptions *core.CompilerOptions, configFileName string, resolutionStack []tspath.Path, extraFileExtensions []tsoptions.FileExtensionInfo, extendedConfigCache tsoptions.ExtendedConfigCache) *tsoptions.ParsedCommandLine

package/shim-vendor/shim/tspath/go.mod

@@ -2,4 +2,4 @@ module github.com/microsoft/typescript-go/shim/tspath
 
 go 1.26
 
-require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063

package/shim-vendor/shim/tspath/go.sum

@@ -0,0 +1,6 @@
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim-vendor/shim/vfs/cachedvfs/go.mod

@@ -2,4 +2,6 @@ module github.com/microsoft/typescript-go/shim/vfs/cachedvfs
 
 go 1.26
 
-require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063
+
+require github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 // indirect

package/shim-vendor/shim/vfs/cachedvfs/go.sum

@@ -0,0 +1,12 @@
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 h1:nxP4pPoyqOAgX8lYDFCfl3DyKeXErCvSvhcyzwGV9CE=
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=
+golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
+golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
+golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim-vendor/shim/vfs/decode.go

@@ -0,0 +1,26 @@
+package vfs
+
+import (
+  _ "github.com/microsoft/typescript-go/internal/vfs/osvfs"
+  _ "unsafe"
+)
+
+// DecodeBytes applies the pinned compiler filesystem's BOM and UTF-16 decoding
+// to one immutable byte string. Callers can hash the same captured bytes without
+// another filesystem read; the returned text is suitable for compiler overlays.
+// UTF-8 BOMs are removed; UTF-16 BOMs select byte order and upstream code-unit
+// decoding. Other bytes pass through unchanged without UTF-8 validation. The
+// pinned helper returns ok=true in every branch, so that flag does not certify
+// well-formed encoding or successful file acquisition.
+//
+// @evidence contracts/common.md#principled-implementation The exact pinned filesystem decoder receives the caller's captured byte string so raw hashes and decoded text can share one immutable read.
+// @evidence contracts/common.md#clear-and-simple-design One thin linkname bridge exposes upstream decoding without another filesystem abstraction or copied algorithm.
+// @evidence contracts/common.md#prohibited-implementation-shortcuts This declaration links the actual upstream helper, retaining BOM, endian and malformed-code-unit behavior rather than approximating the decoder locally.
+// @evidence contracts/common.md#meaningful-documentation Native prose states captured-input ownership, BOM selection, unchanged non-BOM bytes and the pinned ok flag's lack of encoding or file-read certification.
+// @evidenceExclude contracts/performance.md#bound-retention-and-release-resources DecodeBytes declares a signature only; the implementation owns acquisition and release of resources.
+// @evidenceExclude contracts/performance.md#efficient-algorithms DecodeBytes declares a signature only; the implementation owns the processing strategy.
+// @evidenceExclude contracts/performance.md#reuse-equivalent-work DecodeBytes declares a signature only; the implementation owns any shared work.
+// @evidenceExclude contracts/portability.md#os-neutral-implementation DecodeBytes is a signature without a body here; path and platform behavior belongs to the implementation that supplies it.
+//
+//go:linkname DecodeBytes github.com/microsoft/typescript-go/internal/vfs/internal.decodeBytes
+func DecodeBytes(s string) (contents string, ok bool)

package/shim-vendor/shim/vfs/decode_test.go

@@ -0,0 +1,42 @@
+package vfs
+
+import "testing"
+
+// TestDecodeBytesUsesCompilerFilesystemSemantics verifies the real pinned
+// decoder bridge against literal byte/text pairs, including endian, empty,
+// truncated-code-unit and surrogate boundaries.
+//
+// The bridge must call upstream code so filesystem and overlay decoding cannot
+// drift. No copied decoder or filesystem substitute runs in this test.
+//
+// 1. Supply literal byte inputs for each decoding boundary.
+// 2. Call the linked compiler decoder in the test process.
+// 3. Collect each independently specified Unicode text and success assertion.
+//
+// @evidence contracts/testing.md#behavioral-verification DecodeBytes links and calls the real pinned compiler filesystem decoder for every byte/text pair.
+// @evidence contracts/testing.md#independent-expectations Literal bytes and Unicode text specify expected decoding independently of the linked implementation.
+// @evidence contracts/testing.md#distinguishing-cases Plain newline spellings contrast UTF-8 BOM, both UTF-16 byte orders, empty inputs, odd trailing bytes, paired and unpaired surrogates.
+// @evidence contracts/testing.md#execution-ownership TestDecodeBytesUsesCompilerFilesystemSemantics is a Go source unit executed through the actual shim module dependency from the owning compiler module, without an installed consumer or native product process.
+func TestDecodeBytesUsesCompilerFilesystemSemantics(t *testing.T) {
+  for _, input := range []struct{ name, bytes, text string }{
+    {"plain", "a\r\nb\u2028c\u2029", "a\r\nb\u2028c\u2029"},
+    {"utf8", "\xef\xbb\xbfhello", "hello"},
+    {"little", "\xff\xfeh\x00i\x00", "hi"},
+    {"big", "\xfe\xff\x00h\x00i", "hi"},
+    {"empty", "", ""},
+    {"empty little", "\xff\xfe", ""},
+    {"empty big", "\xfe\xff", ""},
+    {"odd little", "\xff\xfea\x00b", "a"},
+    {"odd big", "\xfe\xff\x00ab", "a"},
+    {"surrogate little", "\xff\xfe\x3d\xd8\x00\xde", "\U0001f600"},
+    {"surrogate big", "\xfe\xff\xd8\x3d\xde\x00", "\U0001f600"},
+    {"unpaired little", "\xff\xfe\x3d\xd8", "\ufffd"},
+  } {
+    t.Run(input.name, func(t *testing.T) {
+      text, ok := DecodeBytes(input.bytes)
+      if !ok || text != input.text {
+        t.Errorf("DecodeBytes = %q, %v; want %q, true", text, ok, input.text)
+      }
+    })
+  }
+}

package/shim-vendor/shim/vfs/go.mod

@@ -2,4 +2,10 @@ module github.com/microsoft/typescript-go/shim/vfs
 
 go 1.26
 
-require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 // indirect
+	golang.org/x/sync v0.21.0 // indirect
+	golang.org/x/sys v0.46.0 // indirect
+)

package/shim-vendor/shim/vfs/go.sum

@@ -0,0 +1,12 @@
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 h1:nxP4pPoyqOAgX8lYDFCfl3DyKeXErCvSvhcyzwGV9CE=
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=
+golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
+golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
+golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim-vendor/shim/vfs/osvfs/go.mod

@@ -2,4 +2,10 @@ module github.com/microsoft/typescript-go/shim/vfs/osvfs
 
 go 1.26
 
-require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+require github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 // indirect
+	golang.org/x/sync v0.21.0 // indirect
+	golang.org/x/sys v0.46.0 // indirect
+)

package/shim-vendor/shim/vfs/osvfs/go.sum

@@ -0,0 +1,12 @@
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6 h1:nxP4pPoyqOAgX8lYDFCfl3DyKeXErCvSvhcyzwGV9CE=
+github.com/go-json-experiment/json v0.0.0-20260601182631-00ed12fed2a6/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063 h1:UUVrjTrD+7nkVvkJTjxwA5+SaZ5n1uyAffm2zX2gn+o=
+github.com/microsoft/typescript-go v0.0.0-20260610182825-7fc57c005063/go.mod h1:s3yhRRZ7nzSZaiKicku520Tj9Mvewr9y2UtrvpwOmDE=
+golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
+golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
+golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/src/BootTtscWorkerTerminationError.ts

@@ -5,12 +5,34 @@
  * same API name in the same Worker would install a new readiness bridge that
  * the stale runtime could invoke, so `bootTtsc` terminally rejects later boots
  * until the caller terminates the Worker.
+ *
+ * @evidence contracts/common.md#principled-implementation
+ *   An Error subclass carries a stable machine-readable code, API identity and
+ *   original cause so the owner can replace the Worker rather than parse prose.
+ * @evidence contracts/common.md#clear-and-simple-design
+ *   One error identity groups the terminal discriminator, API slot and cause;
+ *   Worker replacement remains the caller's responsibility, outside this value.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts
+ *   The error exposes the runtime's terminal ownership limit rather than hiding
+ *   it under retries that would reuse a stale global readiness bridge.
+ * @evidence contracts/common.md#meaningful-documentation
+ *   Separate JSDoc paragraphs explain the failure and why replacement is required;
+ *   members explain identity and cause, following the documentation skill.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources BootTtscWorkerTerminationError retains only its own fields and cause and is released with the rejection.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms BootTtscWorkerTerminationError builds one message string and chooses no processing strategy.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work BootTtscWorkerTerminationError is an error value and coordinates no shared or repeated computation.
  */
 export class BootTtscWorkerTerminationError extends Error {
+  /** Stable discriminator for Worker-replacement handling. */
   public static readonly CODE = "TTSC_WASM_WORKER_TERMINATION_REQUIRED";
 
+  /** Global API bridge whose Go runtime has already started. */
   public readonly apiName: string;
+
+  /** Instance discriminator shared with the class constant. */
   public readonly code = BootTtscWorkerTerminationError.CODE;
+
+  /** Original cancellation, startup or runtime failure. */
   public override readonly cause: unknown;
 
   public constructor(apiName: string, cause: unknown) {