@typespec/compiler 1.18.0-dev.4 → 1.18.0-dev.5

package/dist/src/core/numeric.d.ts

@@ -1,15 +1,25 @@
+/** An immutable numeric value that preserves precision beyond JavaScript's `number` range. */
 export interface Numeric {
     /**
-     * Return the value as JavaScript number or null if it cannot be represented without loosing precision.
+     * Convert to a JavaScript number, returning null when a finite conversion loses precision.
+     * Throws on overflow to infinity. Use {@link Numeric.toString} to retain the precise value without conversion.
      */
     asNumber(): number | null;
+    /** Convert an integer to a signed bigint, or return null for a fractional value. */
     asBigInt(): bigint | null;
+    /** Format a base-10 value without exponential notation. */
     toString(): string;
+    /** Compare normalized digits and exponent; unlike ordering comparisons, this does not compare signs. */
     equals(value: Numeric): boolean;
+    /** Test strict greater-than ordering without converting to a JavaScript number. */
     gt(value: Numeric): boolean;
+    /** Test strict less-than ordering without converting to a JavaScript number. */
     lt(value: Numeric): boolean;
+    /** Test greater-than-or-equal ordering without converting to a JavaScript number. */
     gte(value: Numeric): boolean;
+    /** Test less-than-or-equal ordering without converting to a JavaScript number. */
     lte(value: Numeric): boolean;
+    /** Whether the value has no fractional component, regardless of its source notation. */
     readonly isInteger: boolean;
 }
 export declare class InvalidNumericError extends Error {

package/dist/src/core/numeric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numeric.d.ts","sourceRoot":"","sources":["../../../src/core/numeric.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,IAAI,MAAM,CAAC;IACnB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAE7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAI7B;AAcD,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,oBAAoB;CAClC;AAKD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAcpD"}
+{"version":3,"file":"numeric.d.ts","sourceRoot":"","sources":["../../../src/core/numeric.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,IAAI,MAAM,CAAC;IACnB,wGAAwG;IACxG,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,mFAAmF;IACnF,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,gFAAgF;IAChF,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,qFAAqF;IACrF,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,kFAAkF;IAClF,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAE7B,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAI7B;AAcD,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,oBAAoB;CAClC;AAKD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAcpD"}

package/dist/src/core/numeric.js.map

@@ -1 +1 @@
-{"version":3,"file":"numeric.js","sourceRoot":"","sources":["../../../src/core/numeric.ts"],"names":[],"mappings":"AA+BA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,gBAAgB,CAAC;CAClC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,eAAe,IAAI,GAAG,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,WAAmB;IACzC,IAAI,IAAI,MAAM,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG;QACV,CAAC,eAAe,CAAC,EAAE,IAAI;QACvB,SAAS;KACV,CAAC;IACF,uJAAuJ;IACvJ,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,kBAAkB,CAAqC,GAAM,EAAE,SAAY;IAClF,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,GAAU,CAAC;AACpB,CAAC;AAED,SAAS,KAAK,CAAC,QAAgB;IAC7B,IAAI,WAAW,GAAG,QAAQ,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,GAAW,CAAC,CAAC;IACrB,IAAI,CAAS,CAAC;IACd,IAAI,GAAuB,CAAC;IAC5B,IAAI,OAAO,GAAuB,SAAS,CAAC;IAC5C,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QAC3B,KAAK,GAAG,CAAC,CAAC;QACV,IAAI,GAAG,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACrD,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;QACvF,IAAI,CAAC;YACH,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACrC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;YAC1B,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,kBAAkB;QAClB,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;YAClC,KAAK,EAAE,CAAC;QACV,CAAC;QACD,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,KAAK,CAAC;QACrD,iBAAiB;QACjB,IAAI,iBAAiB,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,GAAG,kBAAkB,CAAC;YACzB,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAS,CAAC;QAEd,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,sBAAsB;YACtB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;YAClB,CAAC;YACD,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACxC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1C,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,WAAW;YACX,GAAG,GAAG,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC;YACjC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC;QAC7B,OAAO,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,GAAG,kBAAkB,EAAE,CAAC;YAChE,GAAG,EAAE,CAAC;QACR,CAAC;QAED,gIAAgI;QAChI,IAAI,KAAK,KAAK,kBAAkB,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,GAAG,GAAG,kBAAkB,CAAC;YAC7B,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;gBAC7C,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,CAAC;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACxC,WAAW,GAAG,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,0CAA0C;YACzH,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;YACxB,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACb,OAAO,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,SAAS,CAAC,KAAmB;IACpC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAE/B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,OAAO,IAAI,GAAG,GAAG,GAAG,OAAO,CAAC;AAC9B,CAAC;AACD,MAAM,MAAM,GAAG,CAAC,CAAe,EAAE,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEhF,MAAM,OAAO,GAAG,CAAC,CAAe,EAAE,CAAe,EAAc,EAAE;IAC/D,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;SAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAChB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAQ,CAAC;IAC3B,CAAC;SAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC,GAAG,GAAG,CAAQ,CAAC;IAC1B,CAAC;IAED,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACb,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAEb,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACd,EAAE,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,EAAE,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,EAAE,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAQ,CAAC;IACtC,IAAI,EAAE,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAQ,CAAC;IACrC,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,QAAQ,EAAE;QACR,OAAO,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,QAAQ,EAAE;QACR,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,CAAC;IACD,QAAQ,EAAE;QACR,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,EAAE,UAAyB,KAAc;QAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,EAAE,EAAE,UAAyB,KAAc;QACzC,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,GAAG,EAAE,UAAyB,KAAc;QAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,EAAE,EAAE,UAAyB,KAAc;QACzC,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,GAAG,EAAE,UAAyB,KAAc;QAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;CACF,CAAC;AACF,gBAAgB,CAAC,QAAQ,GAAG;IAC1B,OAAO,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC"}
+{"version":3,"file":"numeric.js","sourceRoot":"","sources":["../../../src/core/numeric.ts"],"names":[],"mappings":"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"}

package/dist/src/core/options.d.ts

@@ -1,6 +1,8 @@
 import type { EmitterOptions } from "../config/types.js";
 import type { LinterRuleSet, ParseOptions } from "./types.js";
+/** Configuration for a compilation, including source loading, diagnostics, linting, and emission. */
 export interface CompilerOptions {
+    /** Additional options made available to compiler integrations through program option lookup. */
     miscOptions?: Record<string, unknown>;
     /**
      * Default output directory used by emitters.
@@ -21,14 +23,15 @@ export interface CompilerOptions {
      */
     listFiles?: boolean;
     /**
-     * Emitter options.
-     * Key value pair where the key must be the emitter name.
+     * Emitter-specific settings keyed by the resolved library metadata name.
+     * Use the original emitter specifier only when no metadata name is available.
      */
     options?: Record<string, EmitterOptions>;
     /**
      * Suppress all `deprecated` warnings.
      */
     ignoreDeprecated?: boolean;
+    /** Skip loading the compiler's standard TypeSpec library. */
     nostdlib?: boolean;
     /**
      * Do not run emitters. Same as setting `emit: []`
@@ -40,7 +43,9 @@ export interface CompilerOptions {
      * Only runs emitters supporting this functionality
      */
     dryRun?: boolean;
+    /** Import these modules in addition to imports declared by the entry-point source. */
     additionalImports?: string[];
+    /** Promote unsuppressed warnings to errors, causing the compilation to fail. */
     warningAsError?: boolean;
     /**
      * When true, indicates that a compilation is being performed for live
@@ -51,6 +56,7 @@ export interface CompilerOptions {
      * Trace area to enable.
      */
     trace?: string[];
+    /** Parser settings applied when loading TypeSpec source files. */
     parseOptions?: ParseOptions;
     /** Ruleset to enable for linting. */
     linterRuleSet?: LinterRuleSet;

package/dist/src/core/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/core/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEzC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,qCAAqC;IACrC,aAAa,CAAC,EAAE,aAAa,CAAC;CAI/B"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/core/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,qGAAqG;AACrG,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEzC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,kEAAkE;IAClE,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,qCAAqC;IACrC,aAAa,CAAC,EAAE,aAAa,CAAC;CAI/B"}

package/dist/src/core/param-message.d.ts

@@ -1,3 +1,12 @@
 import type { CallableMessage } from "./types.js";
+/**
+ * Build a typed diagnostic-message formatter using a tagged template whose substitutions name parameters.
+ * The returned callable substitutes values from a dictionary and exposes the parameter names in `keys`.
+ * @example
+ * ```ts
+ * const message = paramMessage`Unknown type ${"name"}.`;
+ * message({ name: "Widget" }); // "Unknown type Widget."
+ * ```
+ */
 export declare function paramMessage<const T extends string[]>(strings: readonly string[], ...keys: T): CallableMessage<T>;
 //# sourceMappingURL=param-message.d.ts.map

package/dist/src/core/param-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"param-message.d.ts","sourceRoot":"","sources":["../../../src/core/param-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,EACnD,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,IAAI,EAAE,CAAC,GACT,eAAe,CAAC,CAAC,CAAC,CAcpB"}
+{"version":3,"file":"param-message.d.ts","sourceRoot":"","sources":["../../../src/core/param-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,EACnD,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,IAAI,EAAE,CAAC,GACT,eAAe,CAAC,CAAC,CAAC,CAcpB"}

package/dist/src/core/param-message.js

@@ -1,3 +1,12 @@
+/**
+ * Build a typed diagnostic-message formatter using a tagged template whose substitutions name parameters.
+ * The returned callable substitutes values from a dictionary and exposes the parameter names in `keys`.
+ * @example
+ * ```ts
+ * const message = paramMessage`Unknown type ${"name"}.`;
+ * message({ name: "Widget" }); // "Unknown type Widget."
+ * ```
+ */
 export function paramMessage(strings, ...keys) {
     const template = (dict) => {
         const result = [strings[0]];

package/dist/src/core/param-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"param-message.js","sourceRoot":"","sources":["../../../src/core/param-message.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,OAA0B,EAC1B,GAAG,IAAO;IAEV,MAAM,QAAQ,GAAG,CAAC,IAA+B,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACtB,MAAM,KAAK,GAAI,IAAY,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC;IACF,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"param-message.js","sourceRoot":"","sources":["../../../src/core/param-message.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA0B,EAC1B,GAAG,IAAO;IAEV,MAAM,QAAQ,GAAG,CAAC,IAA+B,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACtB,MAAM,KAAK,GAAI,IAAY,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC;IACF,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/core/parser.d.ts

@@ -1,11 +1,22 @@
 import type { Diagnostic, Expression, IdentifierContext, IdentifierNode, ImportStatementNode, Node, ParseOptions, PositionDetail, SourceFile, TextRange, TypeReferenceNode, TypeSpecScriptNode } from "./types.js";
+/**
+ * Parse TypeSpec source without binding or type checking it.
+ * Syntax errors are retained on the returned script as parse diagnostics and recovery nodes.
+ */
 export declare function parse(code: string | SourceFile, options?: ParseOptions): TypeSpecScriptNode;
+/** Parse a type reference outside a script, returning the reference node and syntax diagnostics. */
 export declare function parseStandaloneTypeReference(code: string | SourceFile): [TypeReferenceNode, readonly Diagnostic[]];
+/** Callback used to inspect a syntax node and optionally return a traversal result. */
 export type NodeCallback<T> = (c: Node) => T;
+/** Check for an unqualified identifier reference with no template arguments. */
 export declare function exprIsBareIdentifier(expr: Expression): expr is TypeReferenceNode & {
     target: IdentifierNode;
     arguments: [];
 };
+/**
+ * Visit a node's immediate syntactic children, including attached directives and documentation.
+ * Stops at the first truthy callback result and returns it; recurse explicitly to visit descendants.
+ */
 export declare function visitChildren<T>(node: Node, cb: NodeCallback<T>): T | undefined;
 /**
  * check whether a position belongs to a range (excluding the start and end pos)
@@ -15,6 +26,10 @@ export declare function visitChildren<T>(node: Node, cb: NodeCallback<T>): T | u
  *         if range.end is -1 means no end point found, so return true if position is greater than range.pos
  */
 export declare function positionInRange(position: number, range: TextRange): boolean;
+/**
+ * Find the innermost matching node and describe adjacent characters and trivia at a source offset.
+ * The filter distinguishes the current lookup from lookups before or after surrounding trivia.
+ */
 export declare function getNodeAtPositionDetail(script: TypeSpecScriptNode, position: number, filter?: (node: Node, flag: "cur" | "pre" | "post") => boolean): PositionDetail;
 /**
  * Resolve the node in the syntax tree that that is at the given position.
@@ -24,8 +39,12 @@ export declare function getNodeAtPositionDetail(script: TypeSpecScriptNode, posi
  */
 export declare function getNodeAtPosition(script: TypeSpecScriptNode, position: number, filter?: (node: Node) => boolean): Node | undefined;
 export declare function getNodeAtPosition<T extends Node>(script: TypeSpecScriptNode, position: number, filter: (node: Node) => node is T): T | undefined;
+/** Test whether a node or any descendant has a parse error, caching descendant-error flags on the nodes. */
 export declare function hasParseError(node: Node): number | true;
+/** Narrow a syntax node to an import statement by its syntax kind. */
 export declare function isImportStatement(node: Node): node is ImportStatementNode;
+/** Find the nearest ancestor satisfying a predicate, optionally testing the node itself first. */
 export declare function getFirstAncestor(node: Node, test: NodeCallback<boolean>, includeSelf?: boolean): Node | undefined;
+/** Classify a parent-linked identifier's syntactic role, treating member-expression chains as one context. */
 export declare function getIdentifierContext(id: IdentifierNode): IdentifierContext;
 //# sourceMappingURL=parser.d.ts.map

package/dist/src/core/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAeV,UAAU,EAmBV,UAAU,EAKV,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EAcnB,IAAI,EAQJ,YAAY,EACZ,cAAc,EAId,UAAU,EAWV,SAAS,EAGT,iBAAiB,EACjB,kBAAkB,EAOnB,MAAM,YAAY,CAAC;AAqNpB,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,GAAE,YAAiB,GAAG,kBAAkB,CAG/F;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GAAG,UAAU,GACxB,CAAC,iBAAiB,EAAE,SAAS,UAAU,EAAE,CAAC,CAI5C;AA+1FD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC;AAE7C,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,GACf,IAAI,IAAI,iBAAiB,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,EAAE,CAAA;CAAE,CAMvE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CA6P/E;AAoBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,WAEjE;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,KAAK,OAAoB,GACzE,cAAc,CAgDhB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAC/B,IAAI,GAAG,SAAS,CAAC;AACpB,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,IAAI,EAC9C,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,GAChC,CAAC,GAAG,SAAS,CAAC;AAuCjB,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,iBAOvC;AAyBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,mBAAmB,CAEzE;AAaD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,EAC3B,WAAW,GAAE,OAAe,GAC3B,IAAI,GAAG,SAAS,CAUlB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,CAsD1E"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAeV,UAAU,EAmBV,UAAU,EAKV,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EAcnB,IAAI,EAQJ,YAAY,EACZ,cAAc,EAId,UAAU,EAWV,SAAS,EAGT,iBAAiB,EACjB,kBAAkB,EAOnB,MAAM,YAAY,CAAC;AAqNpB;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,GAAE,YAAiB,GAAG,kBAAkB,CAG/F;AAED,oGAAoG;AACpG,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GAAG,UAAU,GACxB,CAAC,iBAAiB,EAAE,SAAS,UAAU,EAAE,CAAC,CAI5C;AA+1FD,uFAAuF;AACvF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC;AAE7C,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,GACf,IAAI,IAAI,iBAAiB,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,EAAE,CAAA;CAAE,CAMvE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CA6P/E;AAoBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,WAEjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,KAAK,OAAoB,GACzE,cAAc,CAgDhB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAC/B,IAAI,GAAG,SAAS,CAAC;AACpB,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,IAAI,EAC9C,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,GAChC,CAAC,GAAG,SAAS,CAAC;AAuCjB,4GAA4G;AAC5G,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,iBAOvC;AAyBD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,mBAAmB,CAEzE;AAaD,kGAAkG;AAClG,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,EAC3B,WAAW,GAAE,OAAe,GAC3B,IAAI,GAAG,SAAS,CAUlB;AAED,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,CAsD1E"}

package/dist/src/core/parser.js

@@ -134,10 +134,15 @@ var ParseMode;
     ParseMode[ParseMode["Syntax"] = 0] = "Syntax";
     ParseMode[ParseMode["Doc"] = 1] = "Doc";
 })(ParseMode || (ParseMode = {}));
+/**
+ * Parse TypeSpec source without binding or type checking it.
+ * Syntax errors are retained on the returned script as parse diagnostics and recovery nodes.
+ */
 export function parse(code, options = {}) {
     const parser = createParser(code, options);
     return parser.parseTypeSpecScript();
 }
+/** Parse a type reference outside a script, returning the reference node and syntax diagnostics. */
 export function parseStandaloneTypeReference(code) {
     const parser = createParser(code);
     const node = parser.parseStandaloneReferenceExpression();
@@ -2534,11 +2539,16 @@ function createParser(code, options = {}) {
             : undefined;
     }
 }
+/** Check for an unqualified identifier reference with no template arguments. */
 export function exprIsBareIdentifier(expr) {
     return (expr.kind === SyntaxKind.TypeReference &&
         expr.target.kind === SyntaxKind.Identifier &&
         expr.arguments.length === 0);
 }
+/**
+ * Visit a node's immediate syntactic children, including attached directives and documentation.
+ * Stops at the first truthy callback result and returns it; recurse explicitly to visit descendants.
+ */
 export function visitChildren(node, cb) {
     if (node.directives) {
         const result = visitEach(cb, node.directives);
@@ -2775,6 +2785,10 @@ function visitEach(cb, nodes) {
 export function positionInRange(position, range) {
     return range.pos >= 0 && position > range.pos && (range.end === -1 || position < range.end);
 }
+/**
+ * Find the innermost matching node and describe adjacent characters and trivia at a source offset.
+ * The filter distinguishes the current lookup from lookups before or after surrounding trivia.
+ */
 export function getNodeAtPositionDetail(script, position, filter = () => true) {
     const cur = getNodeAtPosition(script, position, (n) => filter(n, "cur"));
     const input = script.file.text;
@@ -2848,6 +2862,7 @@ export function getNodeAtPosition(script, position, filter = (node) => true) {
         return undefined;
     }
 }
+/** Test whether a node or any descendant has a parse error, caching descendant-error flags on the nodes. */
 export function hasParseError(node) {
     if (node.flags & NodeFlags.ThisNodeHasError) {
         return true;
@@ -2874,6 +2889,7 @@ function checkForDescendantErrors(node) {
         return false;
     });
 }
+/** Narrow a syntax node to an import statement by its syntax kind. */
 export function isImportStatement(node) {
     return node.kind === SyntaxKind.ImportStatement;
 }
@@ -2886,6 +2902,7 @@ function isBlocklessNamespace(node) {
     }
     return node.statements === undefined;
 }
+/** Find the nearest ancestor satisfying a predicate, optionally testing the node itself first. */
 export function getFirstAncestor(node, test, includeSelf = false) {
     if (includeSelf && test(node)) {
         return node;
@@ -2897,6 +2914,7 @@ export function getFirstAncestor(node, test, includeSelf = false) {
     }
     return undefined;
 }
+/** Classify a parent-linked identifier's syntactic role, treating member-expression chains as one context. */
 export function getIdentifierContext(id) {
     const node = getFirstAncestor(id, (n) => n.kind !== SyntaxKind.MemberExpression);
     compilerAssert(node, "Identifier with no non-member-expression ancestor.");