openapi-typesafe 1.0.0-rc.0 → 1.0.0-rc.2

package/dist/api/footer-sink.mjs

@@ -5,6 +5,12 @@ import { declaresTypeAlias, isIrDeclaration } from './footer-entry.mjs';
 const OPERATIONS_NAME = "operations";
 class ContextFooterSink {
   footer;
+  /**
+   * The IR `operations` entry this sink wrote last, with its members array that only this sink
+   * holds. Adding to it in place keeps a run linear: copying the members on every operation was
+   * quadratic (about 0.4 s on Microsoft Graph beta).
+   */
+  owned = null;
   constructor(footer) {
     this.footer = footer;
   }
@@ -20,6 +26,11 @@ class ContextFooterSink {
    * the member in place, as in the original.
    */
   addOperation(build) {
+    const owned = this.currentOwnedOperations();
+    if (owned !== null) {
+      owned.members.push(build());
+      return;
+    }
     const existing = this.findOperations();
     if (existing !== null && !isIrDeclaration(existing.entry)) {
       const ts = loadTypeScript();
@@ -30,9 +41,21 @@ class ContextFooterSink {
       return;
     }
     const index = existing?.index ?? this.footer.push(emptyOperations()) - 1;
-    const member = build();
+    this.takeOwnership(index).members.push(build());
+  }
+  /** The owned entry, unless user code replaced or moved it in the footer since. */
+  currentOwnedOperations() {
+    const owned = this.owned;
+    return owned !== null && this.footer[owned.index] === owned.entry ? owned : null;
+  }
+  /** Replace the IR entry at `index` with a copy whose members array only this sink holds. */
+  takeOwnership(index) {
     const operations = this.footer[index];
-    this.footer[index] = { ...operations, members: [...operations.members, member] };
+    const members = [...operations.members];
+    const entry = { ...operations, members };
+    this.footer[index] = entry;
+    this.owned = { entry, members, index };
+    return this.owned;
   }
   /** The first `operations` interface: the generator's (IR) or a user's (TypeScript). */
   findOperations() {

package/dist/api/footer-sink.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"footer-sink.mjs","sources":["../../src/api/footer-sink.ts"],"sourcesContent":["import { appendMember, asInterfaceNamed } from \"../adapters/type-ast-bridge/footer-nodes.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { FooterSink } from \"../application/transform/footer/document-footer.js\";\nimport type {\n  IrDeclaration,\n  IrInterfaceDeclaration,\n  IrPropertySignature,\n} from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/**\n * The footer of a run is its `ctx.injectFooter` list. The generator adds IR declarations; user\n * code may add IR declarations or TypeScript nodes (ENGINEERING_PLAN 6.2).\n */\nexport class ContextFooterSink implements FooterSink {\n  private readonly footer: FooterEntry[];\n\n  constructor(footer: FooterEntry[]) {\n    this.footer = footer;\n  }\n\n  hasTypeAlias(name: string): boolean {\n    return this.footer.some((entry) => declaresTypeAlias(entry, name));\n  }\n\n  add(declaration: IrDeclaration): void {\n    this.footer.push(declaration);\n  }\n\n  /**\n   * Add a member to the `operations` interface, declared first (exported) when missing, so it\n   * comes before any declaration `build` adds. A user's TypeScript `operations` interface gets\n   * the member in place, as in the original.\n   */\n  addOperation(build: () => IrPropertySignature): void {\n    const existing = this.findOperations();\n    if (existing !== null && !isIrDeclaration(existing.entry)) {\n      const ts = loadTypeScript();\n      const node = asInterfaceNamed(ts, existing.entry, OPERATIONS_NAME);\n      if (node) {\n        appendMember(ts, node, build());\n      }\n      return;\n    }\n    const index = existing?.index ?? this.footer.push(emptyOperations()) - 1;\n    const member = build();\n    const operations = this.footer[index] as IrInterfaceDeclaration;\n    this.footer[index] = { ...operations, members: [...operations.members, member] };\n  }\n\n  /** The first `operations` interface: the generator's (IR) or a user's (TypeScript). */\n  private findOperations(): { entry: FooterEntry; index: number } | null {\n    const index = this.footer.findIndex((entry) =>\n      isIrDeclaration(entry)\n        ? entry.kind === \"interface\" && entry.name === OPERATIONS_NAME\n        : asInterfaceNamed(loadTypeScript(), entry, OPERATIONS_NAME) !== null,\n    );\n    const entry = this.footer[index];\n    return entry === undefined ? null : { entry, index };\n  }\n}\n\nfunction emptyOperations(): IrInterfaceDeclaration {\n  return { kind: \"interface\", name: OPERATIONS_NAME, isExported: true, members: [], comments: [] };\n}\n"],"names":["entry"],"mappings":";;;;AAUA,MAAM,eAAA,GAAkB,YAAA;AAMjB,MAAM,iBAAA,CAAwC;AAAA,EAClC,MAAA;AAAA,EAEjB,YAAY,MAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA,EAEA,aAAa,IAAA,EAAuB;AAClC,IAAA,OAAO,IAAA,CAAK,OAAO,IAAA,CAAK,CAAC,UAAU,iBAAA,CAAkB,KAAA,EAAO,IAAI,CAAC,CAAA;AAAA,EACnE;AAAA,EAEA,IAAI,WAAA,EAAkC;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,WAAW,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,KAAA,EAAwC;AACnD,IAAA,MAAM,QAAA,GAAW,KAAK,cAAA,EAAe;AACrC,IAAA,IAAI,aAAa,IAAA,IAAQ,CAAC,eAAA,CAAgB,QAAA,CAAS,KAAK,CAAA,EAAG;AACzD,MAAA,MAAM,KAAK,cAAA,EAAe;AAC1B,MAAA,MAAM,IAAA,GAAO,gBAAA,CAAiB,EAAA,EAAI,QAAA,CAAS,OAAO,eAAe,CAAA;AACjE,MAAA,IAAI,IAAA,EAAM;AACR,QAAA,YAAA,CAAa,EAAA,EAAI,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,MAChC;AACA,MAAA;AAAA,IACF;AACA,IAAA,MAAM,KAAA,GAAQ,UAAU,KAAA,IAAS,IAAA,CAAK,OAAO,IAAA,CAAK,eAAA,EAAiB,CAAA,GAAI,CAAA;AACvE,IAAA,MAAM,SAAS,KAAA,EAAM;AACrB,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA,GAAI,EAAE,GAAG,UAAA,EAAY,OAAA,EAAS,CAAC,GAAG,UAAA,CAAW,OAAA,EAAS,MAAM,CAAA,EAAE;AAAA,EACjF;AAAA;AAAA,EAGQ,cAAA,GAA+D;AACrE,IAAA,MAAM,KAAA,GAAQ,KAAK,MAAA,CAAO,SAAA;AAAA,MAAU,CAACA,MAAAA,KACnC,eAAA,CAAgBA,MAAK,CAAA,GACjBA,OAAM,IAAA,KAAS,WAAA,IAAeA,MAAAA,CAAM,IAAA,KAAS,kBAC7C,gBAAA,CAAiB,cAAA,EAAe,EAAGA,MAAAA,EAAO,eAAe,CAAA,KAAM;AAAA,KACrE;AACA,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AAC/B,IAAA,OAAO,KAAA,KAAU,MAAA,GAAY,IAAA,GAAO,EAAE,OAAO,KAAA,EAAM;AAAA,EACrD;AACF;AAEA,SAAS,eAAA,GAA0C;AACjD,EAAA,OAAO,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,eAAA,EAAiB,UAAA,EAAY,IAAA,EAAM,OAAA,EAAS,EAAC,EAAG,QAAA,EAAU,EAAC,EAAE;AACjG;;"}
+{"version":3,"file":"footer-sink.mjs","sources":["../../src/api/footer-sink.ts"],"sourcesContent":["import { appendMember, asInterfaceNamed } from \"../adapters/type-ast-bridge/footer-nodes.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { FooterSink } from \"../application/transform/footer/document-footer.js\";\nimport type {\n  IrDeclaration,\n  IrInterfaceDeclaration,\n  IrMember,\n  IrPropertySignature,\n} from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/**\n * The footer of a run is its `ctx.injectFooter` list. The generator adds IR declarations; user\n * code may add IR declarations or TypeScript nodes (ENGINEERING_PLAN 6.2).\n */\nexport class ContextFooterSink implements FooterSink {\n  private readonly footer: FooterEntry[];\n  /**\n   * The IR `operations` entry this sink wrote last, with its members array that only this sink\n   * holds. Adding to it in place keeps a run linear: copying the members on every operation was\n   * quadratic (about 0.4 s on Microsoft Graph beta).\n   */\n  private owned: OwnedOperations | null = null;\n\n  constructor(footer: FooterEntry[]) {\n    this.footer = footer;\n  }\n\n  hasTypeAlias(name: string): boolean {\n    return this.footer.some((entry) => declaresTypeAlias(entry, name));\n  }\n\n  add(declaration: IrDeclaration): void {\n    this.footer.push(declaration);\n  }\n\n  /**\n   * Add a member to the `operations` interface, declared first (exported) when missing, so it\n   * comes before any declaration `build` adds. A user's TypeScript `operations` interface gets\n   * the member in place, as in the original.\n   */\n  addOperation(build: () => IrPropertySignature): void {\n    const owned = this.currentOwnedOperations();\n    if (owned !== null) {\n      owned.members.push(build());\n      return;\n    }\n    const existing = this.findOperations();\n    if (existing !== null && !isIrDeclaration(existing.entry)) {\n      const ts = loadTypeScript();\n      const node = asInterfaceNamed(ts, existing.entry, OPERATIONS_NAME);\n      if (node) {\n        appendMember(ts, node, build());\n      }\n      return;\n    }\n    const index = existing?.index ?? this.footer.push(emptyOperations()) - 1;\n    this.takeOwnership(index).members.push(build());\n  }\n\n  /** The owned entry, unless user code replaced or moved it in the footer since. */\n  private currentOwnedOperations(): OwnedOperations | null {\n    const owned = this.owned;\n    return owned !== null && this.footer[owned.index] === owned.entry ? owned : null;\n  }\n\n  /** Replace the IR entry at `index` with a copy whose members array only this sink holds. */\n  private takeOwnership(index: number): OwnedOperations {\n    const operations = this.footer[index] as IrInterfaceDeclaration;\n    const members: IrMember[] = [...operations.members];\n    const entry: IrInterfaceDeclaration = { ...operations, members };\n    this.footer[index] = entry;\n    this.owned = { entry, members, index };\n    return this.owned;\n  }\n\n  /** The first `operations` interface: the generator's (IR) or a user's (TypeScript). */\n  private findOperations(): { entry: FooterEntry; index: number } | null {\n    const index = this.footer.findIndex((entry) =>\n      isIrDeclaration(entry)\n        ? entry.kind === \"interface\" && entry.name === OPERATIONS_NAME\n        : asInterfaceNamed(loadTypeScript(), entry, OPERATIONS_NAME) !== null,\n    );\n    const entry = this.footer[index];\n    return entry === undefined ? null : { entry, index };\n  }\n}\n\ninterface OwnedOperations {\n  readonly entry: IrInterfaceDeclaration;\n  readonly members: IrMember[];\n  readonly index: number;\n}\n\nfunction emptyOperations(): IrInterfaceDeclaration {\n  return { kind: \"interface\", name: OPERATIONS_NAME, isExported: true, members: [], comments: [] };\n}\n"],"names":["entry"],"mappings":"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"}

package/dist/api/legacy-callback-warning.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+const warnings = require('../domain/warnings.cjs');
 const defaultPorts = require('./default-ports.cjs');
 
 const IR_CALLBACKS_GUIDE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks";
@@ -17,7 +18,9 @@ function warnLegacyCallback(ctx, name) {
     return;
   }
   ctx.legacyCallbackWarnings.add(name);
-  (ctx.logger ?? defaultPorts.defaultLogger(ctx.silent)).warn(message(name));
+  (ctx.logger ?? defaultPorts.defaultLogger(ctx.silent)).warn(
+    warnings.warningText(message(name), warnings.WARNING_CODES.LEGACY_CALLBACK_DEPRECATED)
+  );
 }
 
 exports.IR_CALLBACKS_GUIDE_URL = IR_CALLBACKS_GUIDE_URL;

package/dist/api/legacy-callback-warning.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-callback-warning.cjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import type { GlobalContext, LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/** Warn once per run and callback; `silent` runs record the use but print nothing. */\nexport function warnLegacyCallback(ctx: GlobalContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.logger ?? defaultLogger(ctx.silent)).warn(message(name));\n}\n"],"names":["defaultLogger"],"mappings":";;;;AAIO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAGO,SAAS,kBAAA,CAAmB,KAAoB,IAAA,EAAgC;AACrF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,UAAUA,0BAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA,CAAK,OAAA,CAAQ,IAAI,CAAC,CAAA;AAC9D;;;"}
+{"version":3,"file":"legacy-callback-warning.cjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\nimport type { RunContext } from \"./run-context.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/** Warn once per run and callback; `silent` runs record the use but print nothing. */\nexport function warnLegacyCallback(ctx: RunContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.logger ?? defaultLogger(ctx.silent)).warn(\n    warningText(message(name), WARNING_CODES.LEGACY_CALLBACK_DEPRECATED),\n  );\n}\n"],"names":["defaultLogger","warningText","WARNING_CODES"],"mappings":";;;;;AAMO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAGO,SAAS,kBAAA,CAAmB,KAAiB,IAAA,EAAgC;AAClF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,MAAA,IAAUA,0BAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA;AAAA,IACxCC,oBAAA,CAAY,OAAA,CAAQ,IAAI,CAAA,EAAGC,uBAAc,0BAA0B;AAAA,GACrE;AACF;;;"}

package/dist/api/legacy-callback-warning.mjs

@@ -1,3 +1,4 @@
+import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
 import { defaultLogger } from './default-ports.mjs';
 
 const IR_CALLBACKS_GUIDE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks";
@@ -15,7 +16,9 @@ function warnLegacyCallback(ctx, name) {
     return;
   }
   ctx.legacyCallbackWarnings.add(name);
-  (ctx.logger ?? defaultLogger(ctx.silent)).warn(message(name));
+  (ctx.logger ?? defaultLogger(ctx.silent)).warn(
+    warningText(message(name), WARNING_CODES.LEGACY_CALLBACK_DEPRECATED)
+  );
 }
 
 export { IR_CALLBACKS_GUIDE_URL, warnLegacyCallback };

package/dist/api/legacy-callback-warning.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-callback-warning.mjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import type { GlobalContext, LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/** Warn once per run and callback; `silent` runs record the use but print nothing. */\nexport function warnLegacyCallback(ctx: GlobalContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.logger ?? defaultLogger(ctx.silent)).warn(message(name));\n}\n"],"names":[],"mappings":";;AAIO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAGO,SAAS,kBAAA,CAAmB,KAAoB,IAAA,EAAgC;AACrF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,UAAU,aAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA,CAAK,OAAA,CAAQ,IAAI,CAAC,CAAA;AAC9D;;"}
+{"version":3,"file":"legacy-callback-warning.mjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\nimport type { RunContext } from \"./run-context.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/** Warn once per run and callback; `silent` runs record the use but print nothing. */\nexport function warnLegacyCallback(ctx: RunContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.logger ?? defaultLogger(ctx.silent)).warn(\n    warningText(message(name), WARNING_CODES.LEGACY_CALLBACK_DEPRECATED),\n  );\n}\n"],"names":[],"mappings":";;;AAMO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAGO,SAAS,kBAAA,CAAmB,KAAiB,IAAA,EAAgC;AAClF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,MAAA,IAAU,aAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA;AAAA,IACxC,WAAA,CAAY,OAAA,CAAQ,IAAI,CAAA,EAAG,cAAc,0BAA0B;AAAA,GACrE;AACF;;"}

package/dist/api/legacy-ts-helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-ts-helpers.cjs","sources":["../../src/api/legacy-ts-helpers.ts"],"sourcesContent":["import { toTypeNode, toValueExpression } from \"../adapters/type-ast-bridge/ir-to-typescript.js\";\nimport { lazyNode } from \"../adapters/type-ast-bridge/lazy-node.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport {\n  enumMemberDescription,\n  quotedMemberName,\n} from \"../application/transform/footer/enum-naming.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { schemaComment } from \"../application/transform/schema-comment.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\nimport type { TypeInput } from \"./type-helpers.js\";\n\n/**\n * The original's helpers that build TypeScript compiler nodes, kept for 1.x and deprecated\n * (ADR-004, decision 9). They load TypeScript on first use through the bridge; the generator\n * itself does not use them.\n */\n\nexport const JS_PROPERTY_INDEX_RE = /^[A-Za-z_$][A-Za-z_$0-9]*$/;\nexport const JS_ENUM_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+(.)?/g;\nexport const JS_PROPERTY_INDEX_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+/g;\nexport const SPECIAL_CHARACTER_MAP: Record<string, string> = {\n  \"+\": \"Plus\",\n  // Add more mappings as needed\n};\n\n/**\n * The `?` token. Created on first use, so importing the package needs no TypeScript.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport const QUESTION_TOKEN: ts.QuestionToken = lazyNode(() => {\n  const ts = loadTypeScript();\n  return ts.factory.createToken(ts.SyntaxKind.QuestionToken);\n});\n\nexport interface AnnotatedSchemaObject {\n  const?: unknown; // jsdoc without value\n  default?: unknown; // jsdoc with value\n  deprecated?: boolean; // jsdoc without value\n  description?: string; // jsdoc with value\n  enum?: unknown[]; // jsdoc without value\n  example?: string; // jsdoc with value\n  examples?: unknown;\n  format?: string; // not jsdoc\n  nullable?: boolean; // Node information\n  summary?: string; // not jsdoc\n  title?: string; // not jsdoc\n  type?: string | string[]; // Type of node\n}\n\n/**\n * Add the schema's JSDoc comment to a TypeScript property signature.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function addJSDocComment(\n  schemaObject: AnnotatedSchemaObject,\n  node: ts.PropertySignature,\n): void {\n  const ts = loadTypeScript();\n  const comment = schemaComment(schemaObject);\n  if (comment) {\n    ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, comment.text, true);\n  }\n}\n\n/** A type argument of the deprecated helpers as TypeScript; IR from type helpers is converted. */\nfunction legacyTypeNode(type: TypeInput): ts.TypeNode {\n  const ts = loadTypeScript();\n  return typeof type.kind === \"string\" ? toTypeNode(ts, type as IrType) : (type as ts.TypeNode);\n}\n\n/** Add a helper type alias to the footer once, as a named raw declaration (like the generator). */\nfunction requireHelper(injectFooter: FooterEntry[], helper: { name: string; text: string }): void {\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, helper.name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name: helper.name, text: helper.text });\n  }\n}\n\n/**\n * Deduplicate simple primitive types from an array of nodes\n * Note: won’t deduplicate complex types like objects\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsDedupe(types: TypeInput[]): ts.TypeNode[] {\n  const encounteredTypes = new Set<number>();\n  const filteredTypes: ts.TypeNode[] = [];\n  for (const t of types.map(legacyTypeNode)) {\n    // only mark for deduplication if this is not a const (\"text\" means it is a const)\n    if (!(\"text\" in ((t as ts.LiteralTypeNode).literal ?? t))) {\n      const { kind } = (t as ts.LiteralTypeNode).literal ?? t;\n      if (encounteredTypes.has(kind)) {\n        continue;\n      }\n      if (tsIsPrimitive(t)) {\n        encounteredTypes.add(kind);\n      }\n    }\n    filteredTypes.push(t);\n  }\n  return filteredTypes;\n}\n\n/** @deprecated The generator keeps its own enum registry per run; kept for 1.x (ADR-004). */\nexport const enumCache = new Map<string, ts.EnumDeclaration>();\n\n/**\n * Create a TS enum (with sanitized name and members)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnum(\n  name: string,\n  members: (string | number)[],\n  metadata?: { name?: string; description?: string | null }[],\n  options?: { export?: boolean; shouldCache?: boolean },\n) {\n  const ts = loadTypeScript();\n  let enumName = sanitizeMemberName(name);\n  enumName = `${enumName.charAt(0).toUpperCase()}${enumName.substring(1)}`;\n  let key = \"\";\n  if (options?.shouldCache) {\n    key = `${members\n      .slice(0)\n      .sort()\n      .map((v, i) => {\n        return `${metadata?.[i]?.name ?? String(v)}:${metadata?.[i]?.description || \"\"}`;\n      })\n      .join(\",\")}`;\n    if (enumCache.has(key)) {\n      return enumCache.get(key) as ts.EnumDeclaration;\n    }\n  }\n  const enumDeclaration = ts.factory.createEnumDeclaration(\n    /* modifiers */ options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    /* name      */ enumName,\n    /* members   */ members.map((value, i) => tsEnumMember(value, metadata?.[i])),\n  );\n  options?.shouldCache && enumCache.set(key, enumDeclaration);\n  return enumDeclaration;\n}\n\n/**\n * Create an exported TS array literal expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsArrayLiteralExpression(\n  name: string,\n  elementType: TypeInput,\n  values: (string | number)[],\n  options?: { export?: boolean; readonly?: boolean; injectFooter?: FooterEntry[] },\n) {\n  const ts = loadTypeScript();\n  let variableName = sanitizeMemberName(name);\n  variableName = `${variableName.charAt(0).toLowerCase()}${variableName.substring(1)}`;\n\n  if (options?.injectFooter) {\n    requireHelper(options.injectFooter, HELPER_TYPES.flattenedDeepRequired);\n  }\n\n  const arrayType = options?.readonly\n    ? tsReadonlyArray(elementType, options.injectFooter)\n    : ts.factory.createArrayTypeNode(legacyTypeNode(elementType));\n\n  return ts.factory.createVariableStatement(\n    options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    ts.factory.createVariableDeclarationList(\n      [\n        ts.factory.createVariableDeclaration(\n          variableName,\n          undefined,\n          arrayType,\n          ts.factory.createArrayLiteralExpression(\n            values.map((value) => toValueExpression(ts, value)),\n          ),\n        ),\n      ],\n      ts.NodeFlags.Const,\n    ),\n  );\n}\n\nfunction sanitizeMemberName(name: string) {\n  let sanitizedName = name.replace(JS_ENUM_INVALID_CHARS_RE, (c) => {\n    // The pattern matches at least one character, so `last` is always a character.\n    const last = c.at(-1) ?? \"\";\n    return JS_PROPERTY_INDEX_INVALID_CHARS_RE.test(last) ? \"\" : last.toUpperCase();\n  });\n  if (Number(name[0]) >= 0) {\n    sanitizedName = `Value${name}`;\n  }\n  return sanitizedName;\n}\n\n/** An enum member name: a valid identifier as is; anything else prefixed, replaced or quoted. */\nfunction enumMemberName(value: string | number, explicitName: string | undefined): string {\n  let name = explicitName ?? String(value);\n  if (JS_PROPERTY_INDEX_RE.test(name)) {\n    return name;\n  }\n  if (Number(name[0]) >= 0) {\n    // A decimal point is not valid in a name; keep the digits readable.\n    name = `Value${name}`.replace(\".\", \"_\");\n  } else if (name[0] === \"-\") {\n    name = `ValueMinus${name.slice(1)}`;\n  }\n  const invalidCharMatch = name.match(JS_PROPERTY_INDEX_INVALID_CHARS_RE);\n  if (!invalidCharMatch) {\n    return name === \"\" ? quotedMemberName(name) : name;\n  }\n  if (invalidCharMatch[0] === name) {\n    return quotedMemberName(name);\n  }\n  return name.replace(JS_PROPERTY_INDEX_INVALID_CHARS_RE, (s) =>\n    s in SPECIAL_CHARACTER_MAP ? (SPECIAL_CHARACTER_MAP[s] as string) : \"_\",\n  );\n}\n\n/**\n * Sanitize TS enum member expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnumMember(\n  value: string | number,\n  metadata: { name?: string; description?: string | null } = {},\n) {\n  const ts = loadTypeScript();\n  const name = enumMemberName(value, metadata.name);\n  const member = ts.factory.createEnumMember(name, toValueExpression(ts, value));\n  const trimmedDescription = enumMemberDescription(metadata.description);\n  if (trimmedDescription === \"\") {\n    return member;\n  }\n\n  return ts.addSyntheticLeadingComment(\n    member,\n    ts.SyntaxKind.SingleLineCommentTrivia,\n    ` ${trimmedDescription}`,\n    true,\n  );\n}\n\n/**\n * Is this a primitive type (string, number, boolean, null, undefined)?\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsIsPrimitive(input: TypeInput): boolean {\n  const ts = loadTypeScript();\n  if (!input) {\n    return true;\n  }\n  const type = legacyTypeNode(input);\n  return (\n    ts.SyntaxKind[type.kind] === \"BooleanKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NeverKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NullKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NumberKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"StringKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"UndefinedKeyword\" ||\n    (\"literal\" in type && tsIsPrimitive(type.literal as ts.TypeLiteralNode))\n  );\n}\n\n/**\n * Modifiers (readonly)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsModifiers(modifiers: { readonly?: boolean; export?: boolean }): ts.Modifier[] {\n  const ts = loadTypeScript();\n  const typeMods: ts.Modifier[] = [];\n  if (modifiers.export) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ExportKeyword));\n  }\n  if (modifiers.readonly) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ReadonlyKeyword));\n  }\n  return typeMods;\n}\n\n/**\n * Create a valid property index\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsPropertyIndex(index: string | number) {\n  const ts = loadTypeScript();\n  if (\n    (typeof index === \"number\" && !(index < 0)) ||\n    (typeof index === \"string\" && String(Number(index)) === index && index[0] !== \"-\")\n  ) {\n    return ts.factory.createNumericLiteral(index);\n  }\n  return typeof index === \"string\" && JS_PROPERTY_INDEX_RE.test(index)\n    ? ts.factory.createIdentifier(index)\n    : ts.factory.createStringLiteral(String(index));\n}\n\n/**\n * Enhanced ReadonlyArray.\n * eg: type Foo = ReadonlyArray<T>; type Bar = ReadonlyArray<T[]>\n * Foo and Bar are both of type `readonly T[]`\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsReadonlyArray(type: TypeInput, injectFooter?: FooterEntry[]): ts.TypeNode {\n  const ts = loadTypeScript();\n  if (injectFooter) {\n    requireHelper(injectFooter, HELPER_TYPES.readonlyArray);\n  }\n  return ts.factory.createTypeReferenceNode(ts.factory.createIdentifier(\"ReadonlyArray\"), [\n    legacyTypeNode(type),\n  ]);\n}\n"],"names":["lazyNode","loadTypeScript","schemaComment","toTypeNode","declaresTypeAlias","HELPER_TYPES","toValueExpression","quotedMemberName","enumMemberDescription"],"mappings":"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"}
+{"version":3,"file":"legacy-ts-helpers.cjs","sources":["../../src/api/legacy-ts-helpers.ts"],"sourcesContent":["import { toTypeNode, toValueExpression } from \"../adapters/type-ast-bridge/ir-to-typescript.js\";\nimport { lazyNode } from \"../adapters/type-ast-bridge/lazy-node.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport {\n  enumMemberDescription,\n  quotedMemberName,\n} from \"../application/transform/footer/enum-naming.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { schemaComment } from \"../application/transform/schema-comment.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\nimport type { TypeInput } from \"./type-helpers.js\";\n\n/**\n * The original's helpers that build TypeScript compiler nodes, kept for 1.x and deprecated\n * (ADR-004, decision 9). They load TypeScript on first use through the bridge; the generator\n * itself does not use them.\n */\n\nexport const JS_PROPERTY_INDEX_RE = /^[A-Za-z_$][A-Za-z_$0-9]*$/;\nexport const JS_ENUM_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+(.)?/g;\nexport const JS_PROPERTY_INDEX_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+/g;\nexport const SPECIAL_CHARACTER_MAP: Record<string, string> = {\n  \"+\": \"Plus\",\n  // Add more mappings as needed\n};\n\n/**\n * The `?` token. Created on first use, so importing the package needs no TypeScript.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport const QUESTION_TOKEN: ts.QuestionToken = lazyNode(() => {\n  const ts = loadTypeScript();\n  return ts.factory.createToken(ts.SyntaxKind.QuestionToken);\n});\n\nexport interface AnnotatedSchemaObject {\n  const?: unknown; // jsdoc without value\n  default?: unknown; // jsdoc with value\n  deprecated?: boolean; // jsdoc without value\n  description?: string; // jsdoc with value\n  enum?: unknown[]; // jsdoc without value\n  example?: string; // jsdoc with value\n  examples?: unknown;\n  format?: string; // not jsdoc\n  nullable?: boolean; // Node information\n  summary?: string; // not jsdoc\n  title?: string; // not jsdoc\n  type?: string | string[]; // Type of node\n}\n\n/**\n * Add the schema's JSDoc comment to a TypeScript property signature.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function addJSDocComment(\n  schemaObject: AnnotatedSchemaObject,\n  node: ts.PropertySignature,\n): void {\n  const ts = loadTypeScript();\n  const comment = schemaComment(schemaObject);\n  if (comment) {\n    ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, comment.text, true);\n  }\n}\n\n/** A type argument of the deprecated helpers as TypeScript; IR from type helpers is converted. */\nfunction legacyTypeNode(type: TypeInput): ts.TypeNode {\n  const ts = loadTypeScript();\n  return typeof type.kind === \"string\" ? toTypeNode(ts, type as IrType) : (type as ts.TypeNode);\n}\n\n/** Add a helper type alias to the footer once, as a named raw declaration (like the generator). */\nfunction requireHelper(injectFooter: FooterEntry[], helper: { name: string; text: string }): void {\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, helper.name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name: helper.name, text: helper.text });\n  }\n}\n\n/**\n * Deduplicate simple primitive types from an array of nodes\n * Note: won’t deduplicate complex types like objects\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsDedupe(types: TypeInput[]): ts.TypeNode[] {\n  const encounteredTypes = new Set<number>();\n  const filteredTypes: ts.TypeNode[] = [];\n  for (const t of types.map(legacyTypeNode)) {\n    // only mark for deduplication if this is not a const (\"text\" means it is a const)\n    if (!(\"text\" in ((t as ts.LiteralTypeNode).literal ?? t))) {\n      const { kind } = (t as ts.LiteralTypeNode).literal ?? t;\n      if (encounteredTypes.has(kind)) {\n        continue;\n      }\n      if (tsIsPrimitive(t)) {\n        encounteredTypes.add(kind);\n      }\n    }\n    filteredTypes.push(t);\n  }\n  return filteredTypes;\n}\n\n/** @deprecated The generator keeps its own enum registry per run; kept for 1.x (ADR-004). */\nexport const enumCache: Map<string, ts.EnumDeclaration> = new Map();\n\n/**\n * Create a TS enum (with sanitized name and members)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnum(\n  name: string,\n  members: (string | number)[],\n  metadata?: { name?: string; description?: string | null }[],\n  options?: { export?: boolean; shouldCache?: boolean },\n): ts.EnumDeclaration {\n  const ts = loadTypeScript();\n  let enumName = sanitizeMemberName(name);\n  enumName = `${enumName.charAt(0).toUpperCase()}${enumName.substring(1)}`;\n  let key = \"\";\n  if (options?.shouldCache) {\n    key = `${members\n      .slice(0)\n      .sort()\n      .map((v, i) => {\n        return `${metadata?.[i]?.name ?? String(v)}:${metadata?.[i]?.description || \"\"}`;\n      })\n      .join(\",\")}`;\n    if (enumCache.has(key)) {\n      return enumCache.get(key) as ts.EnumDeclaration;\n    }\n  }\n  const enumDeclaration = ts.factory.createEnumDeclaration(\n    /* modifiers */ options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    /* name      */ enumName,\n    /* members   */ members.map((value, i) => tsEnumMember(value, metadata?.[i])),\n  );\n  options?.shouldCache && enumCache.set(key, enumDeclaration);\n  return enumDeclaration;\n}\n\n/**\n * Create an exported TS array literal expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsArrayLiteralExpression(\n  name: string,\n  elementType: TypeInput,\n  values: (string | number)[],\n  options?: { export?: boolean; readonly?: boolean; injectFooter?: FooterEntry[] },\n): ts.VariableStatement {\n  const ts = loadTypeScript();\n  let variableName = sanitizeMemberName(name);\n  variableName = `${variableName.charAt(0).toLowerCase()}${variableName.substring(1)}`;\n\n  if (options?.injectFooter) {\n    requireHelper(options.injectFooter, HELPER_TYPES.flattenedDeepRequired);\n  }\n\n  const arrayType = options?.readonly\n    ? tsReadonlyArray(elementType, options.injectFooter)\n    : ts.factory.createArrayTypeNode(legacyTypeNode(elementType));\n\n  return ts.factory.createVariableStatement(\n    options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    ts.factory.createVariableDeclarationList(\n      [\n        ts.factory.createVariableDeclaration(\n          variableName,\n          undefined,\n          arrayType,\n          ts.factory.createArrayLiteralExpression(\n            values.map((value) => toValueExpression(ts, value)),\n          ),\n        ),\n      ],\n      ts.NodeFlags.Const,\n    ),\n  );\n}\n\nfunction sanitizeMemberName(name: string) {\n  let sanitizedName = name.replace(JS_ENUM_INVALID_CHARS_RE, (c) => {\n    // The pattern matches at least one character, so `last` is always a character.\n    const last = c.at(-1) ?? \"\";\n    return JS_PROPERTY_INDEX_INVALID_CHARS_RE.test(last) ? \"\" : last.toUpperCase();\n  });\n  if (Number(name[0]) >= 0) {\n    sanitizedName = `Value${name}`;\n  }\n  return sanitizedName;\n}\n\n/** An enum member name: a valid identifier as is; anything else prefixed, replaced or quoted. */\nfunction enumMemberName(value: string | number, explicitName: string | undefined): string {\n  let name = explicitName ?? String(value);\n  if (JS_PROPERTY_INDEX_RE.test(name)) {\n    return name;\n  }\n  if (Number(name[0]) >= 0) {\n    // A decimal point is not valid in a name; keep the digits readable.\n    name = `Value${name}`.replace(\".\", \"_\");\n  } else if (name[0] === \"-\") {\n    name = `ValueMinus${name.slice(1)}`;\n  }\n  const invalidCharMatch = name.match(JS_PROPERTY_INDEX_INVALID_CHARS_RE);\n  if (!invalidCharMatch) {\n    return name === \"\" ? quotedMemberName(name) : name;\n  }\n  if (invalidCharMatch[0] === name) {\n    return quotedMemberName(name);\n  }\n  return name.replace(JS_PROPERTY_INDEX_INVALID_CHARS_RE, (s) =>\n    s in SPECIAL_CHARACTER_MAP ? (SPECIAL_CHARACTER_MAP[s] as string) : \"_\",\n  );\n}\n\n/**\n * Sanitize TS enum member expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnumMember(\n  value: string | number,\n  metadata: { name?: string; description?: string | null } = {},\n): ts.EnumMember {\n  const ts = loadTypeScript();\n  const name = enumMemberName(value, metadata.name);\n  const member = ts.factory.createEnumMember(name, toValueExpression(ts, value));\n  const trimmedDescription = enumMemberDescription(metadata.description);\n  if (trimmedDescription === \"\") {\n    return member;\n  }\n\n  return ts.addSyntheticLeadingComment(\n    member,\n    ts.SyntaxKind.SingleLineCommentTrivia,\n    ` ${trimmedDescription}`,\n    true,\n  );\n}\n\n/**\n * Is this a primitive type (string, number, boolean, null, undefined)?\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsIsPrimitive(input: TypeInput): boolean {\n  const ts = loadTypeScript();\n  if (!input) {\n    return true;\n  }\n  const type = legacyTypeNode(input);\n  return (\n    ts.SyntaxKind[type.kind] === \"BooleanKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NeverKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NullKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NumberKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"StringKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"UndefinedKeyword\" ||\n    (\"literal\" in type && tsIsPrimitive(type.literal as ts.TypeLiteralNode))\n  );\n}\n\n/**\n * Modifiers (readonly)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsModifiers(modifiers: { readonly?: boolean; export?: boolean }): ts.Modifier[] {\n  const ts = loadTypeScript();\n  const typeMods: ts.Modifier[] = [];\n  if (modifiers.export) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ExportKeyword));\n  }\n  if (modifiers.readonly) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ReadonlyKeyword));\n  }\n  return typeMods;\n}\n\n/**\n * Create a valid property index\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsPropertyIndex(\n  index: string | number,\n): ts.Identifier | ts.NumericLiteral | ts.StringLiteral {\n  const ts = loadTypeScript();\n  if (\n    (typeof index === \"number\" && !(index < 0)) ||\n    (typeof index === \"string\" && String(Number(index)) === index && index[0] !== \"-\")\n  ) {\n    return ts.factory.createNumericLiteral(index);\n  }\n  return typeof index === \"string\" && JS_PROPERTY_INDEX_RE.test(index)\n    ? ts.factory.createIdentifier(index)\n    : ts.factory.createStringLiteral(String(index));\n}\n\n/**\n * Enhanced ReadonlyArray.\n * eg: type Foo = ReadonlyArray<T>; type Bar = ReadonlyArray<T[]>\n * Foo and Bar are both of type `readonly T[]`\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsReadonlyArray(type: TypeInput, injectFooter?: FooterEntry[]): ts.TypeNode {\n  const ts = loadTypeScript();\n  if (injectFooter) {\n    requireHelper(injectFooter, HELPER_TYPES.readonlyArray);\n  }\n  return ts.factory.createTypeReferenceNode(ts.factory.createIdentifier(\"ReadonlyArray\"), [\n    legacyTypeNode(type),\n  ]);\n}\n"],"names":["lazyNode","loadTypeScript","schemaComment","toTypeNode","declaresTypeAlias","HELPER_TYPES","toValueExpression","quotedMemberName","enumMemberDescription"],"mappings":";;;;;;;;;;AAoBO,MAAM,oBAAA,GAAuB;AAC7B,MAAM,wBAAA,GAA2B;AACjC,MAAM,kCAAA,GAAqC;AAC3C,MAAM,qBAAA,GAAgD;AAAA,EAC3D,GAAA,EAAK;AAAA;AAEP;AAMO,MAAM,cAAA,GAAmCA,kBAAS,MAAM;AAC7D,EAAA,MAAM,KAAKC,6BAAA,EAAe;AAC1B,EAAA,OAAO,EAAA,CAAG,OAAA,CAAQ,WAAA,CAAY,EAAA,CAAG,WAAW,aAAa,CAAA;AAC3D,CAAC;AAqBM,SAAS,eAAA,CACd,cACA,IAAA,EACM;AACN,EAAA,MAAM,KAAKA,6BAAA,EAAe;AAC1B,EAAA,MAAM,OAAA,GAAUC,4BAAc,YAAY,CAAA;AAC1C,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,EAAA,CAAG,2BAA2B,IAAA,EAAM,EAAA,CAAG,WAAW,sBAAA,EAAwB,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,EAC9F;AACF;AAGA,SAAS,eAAe,IAAA,EAA8B;AACpD,EAAA,MAAM,KAAKD,6BAAA,EAAe;AAC1B,EAAA,OAAO,OAAO,IAAA,CAAK,IAAA,KAAS,WAAWE,yBAAA,CAAW,EAAA,EAAI,IAAc,CAAA,GAAK,IAAA;AAC3E;AAGA,SAAS,aAAA,CAAc,cAA6B,MAAA,EAA8C;AAChG,EAAA,IAAI,CAAC,YAAA,CAAa,IAAA,CAAK,CAAC,KAAA,KAAUC,8BAAkB,KAAA,EAAO,MAAA,CAAO,IAAI,CAAC,CAAA,EAAG;AACxE,IAAA,YAAA,CAAa,IAAA,CAAK,EAAE,IAAA,EAAM,gBAAA,EAAkB,IAAA,EAAM,OAAO,IAAA,EAAM,IAAA,EAAM,MAAA,CAAO,IAAA,EAAM,CAAA;AAAA,EACpF;AACF;AAOO,SAAS,SAAS,KAAA,EAAmC;AAC1D,EAAA,MAAM,gBAAA,uBAAuB,GAAA,EAAY;AACzC,EAAA,MAAM,gBAA+B,EAAC;AACtC,EAAA,KAAA,MAAW,CAAA,IAAK,KAAA,CAAM,GAAA,CAAI,cAAc,CAAA,EAAG;AAEzC,IAAA,IAAI,EAAE,MAAA,KAAY,CAAA,CAAyB,OAAA,IAAW,CAAA,CAAA,CAAA,EAAK;AACzD,MAAA,MAAM,EAAE,IAAA,EAAK,GAAK,CAAA,CAAyB,OAAA,IAAW,CAAA;AACtD,MAAA,IAAI,gBAAA,CAAiB,GAAA,CAAI,IAAI,CAAA,EAAG;AAC9B,QAAA;AAAA,MACF;AACA,MAAA,IAAI,aAAA,CAAc,CAAC,CAAA,EAAG;AACpB,QAAA,gBAAA,CAAiB,IAAI,IAAI,CAAA;AAAA,MAC3B;AAAA,IACF;AACA,IAAA,aAAA,CAAc,KAAK,CAAC,CAAA;AAAA,EACtB;AACA,EAAA,OAAO,aAAA;AACT;AAGO,MAAM,SAAA,uBAAiD,GAAA;AAMvD,SAAS,MAAA,CACd,IAAA,EACA,OAAA,EACA,QAAA,EACA,OAAA,EACoB;AACpB,EAAA,MAAM,KAAKH,6BAAA,EAAe;AAC1B,EAAA,IAAI,QAAA,GAAW,mBAAmB,IAAI,CAAA;AACtC,EAAA,QAAA,GAAW,CAAA,EAAG,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,CAAE,WAAA,EAAa,CAAA,EAAG,QAAA,CAAS,SAAA,CAAU,CAAC,CAAC,CAAA,CAAA;AACtE,EAAA,IAAI,GAAA,GAAM,EAAA;AACV,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,GAAA,GAAM,CAAA,EAAG,OAAA,CACN,KAAA,CAAM,CAAC,CAAA,CACP,MAAK,CACL,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,KAAM;AACb,MAAA,OAAO,CAAA,EAAG,QAAA,GAAW,CAAC,CAAA,EAAG,IAAA,IAAQ,MAAA,CAAO,CAAC,CAAC,CAAA,CAAA,EAAI,QAAA,GAAW,CAAC,CAAA,EAAG,eAAe,EAAE,CAAA,CAAA;AAAA,IAChF,CAAC,CAAA,CACA,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA;AACZ,IAAA,IAAI,SAAA,CAAU,GAAA,CAAI,GAAG,CAAA,EAAG;AACtB,MAAA,OAAO,SAAA,CAAU,IAAI,GAAG,CAAA;AAAA,IAC1B;AAAA,EACF;AACA,EAAA,MAAM,eAAA,GAAkB,GAAG,OAAA,CAAQ,qBAAA;AAAA;AAAA,IACjB,OAAA,GAAU,YAAY,EAAE,MAAA,EAAQ,QAAQ,MAAA,IAAU,KAAA,EAAO,CAAA,GAAI,MAAA;AAAA;AAAA,IAC7D,QAAA;AAAA;AAAA,IACA,OAAA,CAAQ,GAAA,CAAI,CAAC,KAAA,EAAO,CAAA,KAAM,aAAa,KAAA,EAAO,QAAA,GAAW,CAAC,CAAC,CAAC;AAAA,GAC9E;AACA,EAAA,OAAA,EAAS,WAAA,IAAe,SAAA,CAAU,GAAA,CAAI,GAAA,EAAK,eAAe,CAAA;AAC1D,EAAA,OAAO,eAAA;AACT;AAMO,SAAS,wBAAA,CACd,IAAA,EACA,WAAA,EACA,MAAA,EACA,OAAA,EACsB;AACtB,EAAA,MAAM,KAAKA,6BAAA,EAAe;AAC1B,EAAA,IAAI,YAAA,GAAe,mBAAmB,IAAI,CAAA;AAC1C,EAAA,YAAA,GAAe,CAAA,EAAG,YAAA,CAAa,MAAA,CAAO,CAAC,CAAA,CAAE,WAAA,EAAa,CAAA,EAAG,YAAA,CAAa,SAAA,CAAU,CAAC,CAAC,CAAA,CAAA;AAElF,EAAA,IAAI,SAAS,YAAA,EAAc;AACzB,IAAA,aAAA,CAAc,OAAA,CAAQ,YAAA,EAAcI,wBAAA,CAAa,qBAAqB,CAAA;AAAA,EACxE;AAEA,EAAA,MAAM,SAAA,GAAY,OAAA,EAAS,QAAA,GACvB,eAAA,CAAgB,WAAA,EAAa,OAAA,CAAQ,YAAY,CAAA,GACjD,EAAA,CAAG,OAAA,CAAQ,mBAAA,CAAoB,cAAA,CAAe,WAAW,CAAC,CAAA;AAE9D,EAAA,OAAO,GAAG,OAAA,CAAQ,uBAAA;AAAA,IAChB,OAAA,GAAU,YAAY,EAAE,MAAA,EAAQ,QAAQ,MAAA,IAAU,KAAA,EAAO,CAAA,GAAI,MAAA;AAAA,IAC7D,GAAG,OAAA,CAAQ,6BAAA;AAAA,MACT;AAAA,QACE,GAAG,OAAA,CAAQ,yBAAA;AAAA,UACT,YAAA;AAAA,UACA,MAAA;AAAA,UACA,SAAA;AAAA,UACA,GAAG,OAAA,CAAQ,4BAAA;AAAA,YACT,OAAO,GAAA,CAAI,CAAC,UAAUC,gCAAA,CAAkB,EAAA,EAAI,KAAK,CAAC;AAAA;AACpD;AACF,OACF;AAAA,MACA,GAAG,SAAA,CAAU;AAAA;AACf,GACF;AACF;AAEA,SAAS,mBAAmB,IAAA,EAAc;AACxC,EAAA,IAAI,aAAA,GAAgB,IAAA,CAAK,OAAA,CAAQ,wBAAA,EAA0B,CAAC,CAAA,KAAM;AAEhE,IAAA,MAAM,IAAA,GAAO,CAAA,CAAE,EAAA,CAAG,EAAE,CAAA,IAAK,EAAA;AACzB,IAAA,OAAO,mCAAmC,IAAA,CAAK,IAAI,CAAA,GAAI,EAAA,GAAK,KAAK,WAAA,EAAY;AAAA,EAC/E,CAAC,CAAA;AACD,EAAA,IAAI,MAAA,CAAO,IAAA,CAAK,CAAC,CAAC,KAAK,CAAA,EAAG;AACxB,IAAA,aAAA,GAAgB,QAAQ,IAAI,CAAA,CAAA;AAAA,EAC9B;AACA,EAAA,OAAO,aAAA;AACT;AAGA,SAAS,cAAA,CAAe,OAAwB,YAAA,EAA0C;AACxF,EAAA,IAAI,IAAA,GAAO,YAAA,IAAgB,MAAA,CAAO,KAAK,CAAA;AACvC,EAAA,IAAI,oBAAA,CAAqB,IAAA,CAAK,IAAI,CAAA,EAAG;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,IAAA,CAAK,CAAC,CAAC,KAAK,CAAA,EAAG;AAExB,IAAA,IAAA,GAAO,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAA,CAAG,OAAA,CAAQ,KAAK,GAAG,CAAA;AAAA,EACxC,CAAA,MAAA,IAAW,IAAA,CAAK,CAAC,CAAA,KAAM,GAAA,EAAK;AAC1B,IAAA,IAAA,GAAO,CAAA,UAAA,EAAa,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAAA,EACnC;AACA,EAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,KAAA,CAAM,kCAAkC,CAAA;AACtE,EAAA,IAAI,CAAC,gBAAA,EAAkB;AACrB,IAAA,OAAO,IAAA,KAAS,EAAA,GAAKC,2BAAA,CAAiB,IAAI,CAAA,GAAI,IAAA;AAAA,EAChD;AACA,EAAA,IAAI,gBAAA,CAAiB,CAAC,CAAA,KAAM,IAAA,EAAM;AAChC,IAAA,OAAOA,4BAAiB,IAAI,CAAA;AAAA,EAC9B;AACA,EAAA,OAAO,IAAA,CAAK,OAAA;AAAA,IAAQ,kCAAA;AAAA,IAAoC,CAAC,CAAA,KACvD,CAAA,IAAK,qBAAA,GAAyB,qBAAA,CAAsB,CAAC,CAAA,GAAe;AAAA,GACtE;AACF;AAMO,SAAS,YAAA,CACd,KAAA,EACA,QAAA,GAA2D,EAAC,EAC7C;AACf,EAAA,MAAM,KAAKN,6BAAA,EAAe;AAC1B,EAAA,MAAM,IAAA,GAAO,cAAA,CAAe,KAAA,EAAO,QAAA,CAAS,IAAI,CAAA;AAChD,EAAA,MAAM,MAAA,GAAS,GAAG,OAAA,CAAQ,gBAAA,CAAiB,MAAMK,gCAAA,CAAkB,EAAA,EAAI,KAAK,CAAC,CAAA;AAC7E,EAAA,MAAM,kBAAA,GAAqBE,gCAAA,CAAsB,QAAA,CAAS,WAAW,CAAA;AACrE,EAAA,IAAI,uBAAuB,EAAA,EAAI;AAC7B,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAO,EAAA,CAAG,0BAAA;AAAA,IACR,MAAA;AAAA,IACA,GAAG,UAAA,CAAW,uBAAA;AAAA,IACd,IAAI,kBAAkB,CAAA,CAAA;AAAA,IACtB;AAAA,GACF;AACF;AAMO,SAAS,cAAc,KAAA,EAA2B;AACvD,EAAA,MAAM,KAAKP,6BAAA,EAAe;AAC1B,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,IAAA,GAAO,eAAe,KAAK,CAAA;AACjC,EAAA,OACE,GAAG,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,KAAM,gBAAA,IAC7B,GAAG,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,KAAM,kBAC7B,EAAA,CAAG,UAAA,CAAW,KAAK,IAAI,CAAA,KAAM,iBAC7B,EAAA,CAAG,UAAA,CAAW,IAAA,CAAK,IAAI,MAAM,eAAA,IAC7B,EAAA,CAAG,WAAW,IAAA,CAAK,IAAI,MAAM,eAAA,IAC7B,EAAA,CAAG,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,KAAM,kBAAA,IAC5B,aAAa,IAAA,IAAQ,aAAA,CAAc,KAAK,OAA6B,CAAA;AAE1E;AAMO,SAAS,YAAY,SAAA,EAAoE;AAC9F,EAAA,MAAM,KAAKA,6BAAA,EAAe;AAC1B,EAAA,MAAM,WAA0B,EAAC;AACjC,EAAA,IAAI,UAAU,MAAA,EAAQ;AACpB,IAAA,QAAA,CAAS,KAAK,EAAA,CAAG,OAAA,CAAQ,eAAe,EAAA,CAAG,UAAA,CAAW,aAAa,CAAC,CAAA;AAAA,EACtE;AACA,EAAA,IAAI,UAAU,QAAA,EAAU;AACtB,IAAA,QAAA,CAAS,KAAK,EAAA,CAAG,OAAA,CAAQ,eAAe,EAAA,CAAG,UAAA,CAAW,eAAe,CAAC,CAAA;AAAA,EACxE;AACA,EAAA,OAAO,QAAA;AACT;AAMO,SAAS,gBACd,KAAA,EACsD;AACtD,EAAA,MAAM,KAAKA,6BAAA,EAAe;AAC1B,EAAA,IACG,OAAO,KAAA,KAAU,QAAA,IAAY,EAAE,KAAA,GAAQ,CAAA,CAAA,IACvC,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAA,KAAM,SAAS,KAAA,CAAM,CAAC,MAAM,GAAA,EAC9E;AACA,IAAA,OAAO,EAAA,CAAG,OAAA,CAAQ,oBAAA,CAAqB,KAAK,CAAA;AAAA,EAC9C;AACA,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,oBAAA,CAAqB,IAAA,CAAK,KAAK,CAAA,GAC/D,EAAA,CAAG,OAAA,CAAQ,gBAAA,CAAiB,KAAK,CAAA,GACjC,EAAA,CAAG,QAAQ,mBAAA,CAAoB,MAAA,CAAO,KAAK,CAAC,CAAA;AAClD;AAQO,SAAS,eAAA,CAAgB,MAAiB,YAAA,EAA2C;AAC1F,EAAA,MAAM,KAAKA,6BAAA,EAAe;AAC1B,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,aAAA,CAAc,YAAA,EAAcI,yBAAa,aAAa,CAAA;AAAA,EACxD;AACA,EAAA,OAAO,GAAG,OAAA,CAAQ,uBAAA,CAAwB,GAAG,OAAA,CAAQ,gBAAA,CAAiB,eAAe,CAAA,EAAG;AAAA,IACtF,eAAe,IAAI;AAAA,GACpB,CAAA;AACH;;;;;;;;;;;;;;;;"}

package/dist/api/legacy-ts-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-ts-helpers.mjs","sources":["../../src/api/legacy-ts-helpers.ts"],"sourcesContent":["import { toTypeNode, toValueExpression } from \"../adapters/type-ast-bridge/ir-to-typescript.js\";\nimport { lazyNode } from \"../adapters/type-ast-bridge/lazy-node.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport {\n  enumMemberDescription,\n  quotedMemberName,\n} from \"../application/transform/footer/enum-naming.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { schemaComment } from \"../application/transform/schema-comment.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\nimport type { TypeInput } from \"./type-helpers.js\";\n\n/**\n * The original's helpers that build TypeScript compiler nodes, kept for 1.x and deprecated\n * (ADR-004, decision 9). They load TypeScript on first use through the bridge; the generator\n * itself does not use them.\n */\n\nexport const JS_PROPERTY_INDEX_RE = /^[A-Za-z_$][A-Za-z_$0-9]*$/;\nexport const JS_ENUM_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+(.)?/g;\nexport const JS_PROPERTY_INDEX_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+/g;\nexport const SPECIAL_CHARACTER_MAP: Record<string, string> = {\n  \"+\": \"Plus\",\n  // Add more mappings as needed\n};\n\n/**\n * The `?` token. Created on first use, so importing the package needs no TypeScript.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport const QUESTION_TOKEN: ts.QuestionToken = lazyNode(() => {\n  const ts = loadTypeScript();\n  return ts.factory.createToken(ts.SyntaxKind.QuestionToken);\n});\n\nexport interface AnnotatedSchemaObject {\n  const?: unknown; // jsdoc without value\n  default?: unknown; // jsdoc with value\n  deprecated?: boolean; // jsdoc without value\n  description?: string; // jsdoc with value\n  enum?: unknown[]; // jsdoc without value\n  example?: string; // jsdoc with value\n  examples?: unknown;\n  format?: string; // not jsdoc\n  nullable?: boolean; // Node information\n  summary?: string; // not jsdoc\n  title?: string; // not jsdoc\n  type?: string | string[]; // Type of node\n}\n\n/**\n * Add the schema's JSDoc comment to a TypeScript property signature.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function addJSDocComment(\n  schemaObject: AnnotatedSchemaObject,\n  node: ts.PropertySignature,\n): void {\n  const ts = loadTypeScript();\n  const comment = schemaComment(schemaObject);\n  if (comment) {\n    ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, comment.text, true);\n  }\n}\n\n/** A type argument of the deprecated helpers as TypeScript; IR from type helpers is converted. */\nfunction legacyTypeNode(type: TypeInput): ts.TypeNode {\n  const ts = loadTypeScript();\n  return typeof type.kind === \"string\" ? toTypeNode(ts, type as IrType) : (type as ts.TypeNode);\n}\n\n/** Add a helper type alias to the footer once, as a named raw declaration (like the generator). */\nfunction requireHelper(injectFooter: FooterEntry[], helper: { name: string; text: string }): void {\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, helper.name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name: helper.name, text: helper.text });\n  }\n}\n\n/**\n * Deduplicate simple primitive types from an array of nodes\n * Note: won’t deduplicate complex types like objects\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsDedupe(types: TypeInput[]): ts.TypeNode[] {\n  const encounteredTypes = new Set<number>();\n  const filteredTypes: ts.TypeNode[] = [];\n  for (const t of types.map(legacyTypeNode)) {\n    // only mark for deduplication if this is not a const (\"text\" means it is a const)\n    if (!(\"text\" in ((t as ts.LiteralTypeNode).literal ?? t))) {\n      const { kind } = (t as ts.LiteralTypeNode).literal ?? t;\n      if (encounteredTypes.has(kind)) {\n        continue;\n      }\n      if (tsIsPrimitive(t)) {\n        encounteredTypes.add(kind);\n      }\n    }\n    filteredTypes.push(t);\n  }\n  return filteredTypes;\n}\n\n/** @deprecated The generator keeps its own enum registry per run; kept for 1.x (ADR-004). */\nexport const enumCache = new Map<string, ts.EnumDeclaration>();\n\n/**\n * Create a TS enum (with sanitized name and members)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnum(\n  name: string,\n  members: (string | number)[],\n  metadata?: { name?: string; description?: string | null }[],\n  options?: { export?: boolean; shouldCache?: boolean },\n) {\n  const ts = loadTypeScript();\n  let enumName = sanitizeMemberName(name);\n  enumName = `${enumName.charAt(0).toUpperCase()}${enumName.substring(1)}`;\n  let key = \"\";\n  if (options?.shouldCache) {\n    key = `${members\n      .slice(0)\n      .sort()\n      .map((v, i) => {\n        return `${metadata?.[i]?.name ?? String(v)}:${metadata?.[i]?.description || \"\"}`;\n      })\n      .join(\",\")}`;\n    if (enumCache.has(key)) {\n      return enumCache.get(key) as ts.EnumDeclaration;\n    }\n  }\n  const enumDeclaration = ts.factory.createEnumDeclaration(\n    /* modifiers */ options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    /* name      */ enumName,\n    /* members   */ members.map((value, i) => tsEnumMember(value, metadata?.[i])),\n  );\n  options?.shouldCache && enumCache.set(key, enumDeclaration);\n  return enumDeclaration;\n}\n\n/**\n * Create an exported TS array literal expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsArrayLiteralExpression(\n  name: string,\n  elementType: TypeInput,\n  values: (string | number)[],\n  options?: { export?: boolean; readonly?: boolean; injectFooter?: FooterEntry[] },\n) {\n  const ts = loadTypeScript();\n  let variableName = sanitizeMemberName(name);\n  variableName = `${variableName.charAt(0).toLowerCase()}${variableName.substring(1)}`;\n\n  if (options?.injectFooter) {\n    requireHelper(options.injectFooter, HELPER_TYPES.flattenedDeepRequired);\n  }\n\n  const arrayType = options?.readonly\n    ? tsReadonlyArray(elementType, options.injectFooter)\n    : ts.factory.createArrayTypeNode(legacyTypeNode(elementType));\n\n  return ts.factory.createVariableStatement(\n    options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    ts.factory.createVariableDeclarationList(\n      [\n        ts.factory.createVariableDeclaration(\n          variableName,\n          undefined,\n          arrayType,\n          ts.factory.createArrayLiteralExpression(\n            values.map((value) => toValueExpression(ts, value)),\n          ),\n        ),\n      ],\n      ts.NodeFlags.Const,\n    ),\n  );\n}\n\nfunction sanitizeMemberName(name: string) {\n  let sanitizedName = name.replace(JS_ENUM_INVALID_CHARS_RE, (c) => {\n    // The pattern matches at least one character, so `last` is always a character.\n    const last = c.at(-1) ?? \"\";\n    return JS_PROPERTY_INDEX_INVALID_CHARS_RE.test(last) ? \"\" : last.toUpperCase();\n  });\n  if (Number(name[0]) >= 0) {\n    sanitizedName = `Value${name}`;\n  }\n  return sanitizedName;\n}\n\n/** An enum member name: a valid identifier as is; anything else prefixed, replaced or quoted. */\nfunction enumMemberName(value: string | number, explicitName: string | undefined): string {\n  let name = explicitName ?? String(value);\n  if (JS_PROPERTY_INDEX_RE.test(name)) {\n    return name;\n  }\n  if (Number(name[0]) >= 0) {\n    // A decimal point is not valid in a name; keep the digits readable.\n    name = `Value${name}`.replace(\".\", \"_\");\n  } else if (name[0] === \"-\") {\n    name = `ValueMinus${name.slice(1)}`;\n  }\n  const invalidCharMatch = name.match(JS_PROPERTY_INDEX_INVALID_CHARS_RE);\n  if (!invalidCharMatch) {\n    return name === \"\" ? quotedMemberName(name) : name;\n  }\n  if (invalidCharMatch[0] === name) {\n    return quotedMemberName(name);\n  }\n  return name.replace(JS_PROPERTY_INDEX_INVALID_CHARS_RE, (s) =>\n    s in SPECIAL_CHARACTER_MAP ? (SPECIAL_CHARACTER_MAP[s] as string) : \"_\",\n  );\n}\n\n/**\n * Sanitize TS enum member expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnumMember(\n  value: string | number,\n  metadata: { name?: string; description?: string | null } = {},\n) {\n  const ts = loadTypeScript();\n  const name = enumMemberName(value, metadata.name);\n  const member = ts.factory.createEnumMember(name, toValueExpression(ts, value));\n  const trimmedDescription = enumMemberDescription(metadata.description);\n  if (trimmedDescription === \"\") {\n    return member;\n  }\n\n  return ts.addSyntheticLeadingComment(\n    member,\n    ts.SyntaxKind.SingleLineCommentTrivia,\n    ` ${trimmedDescription}`,\n    true,\n  );\n}\n\n/**\n * Is this a primitive type (string, number, boolean, null, undefined)?\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsIsPrimitive(input: TypeInput): boolean {\n  const ts = loadTypeScript();\n  if (!input) {\n    return true;\n  }\n  const type = legacyTypeNode(input);\n  return (\n    ts.SyntaxKind[type.kind] === \"BooleanKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NeverKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NullKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NumberKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"StringKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"UndefinedKeyword\" ||\n    (\"literal\" in type && tsIsPrimitive(type.literal as ts.TypeLiteralNode))\n  );\n}\n\n/**\n * Modifiers (readonly)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsModifiers(modifiers: { readonly?: boolean; export?: boolean }): ts.Modifier[] {\n  const ts = loadTypeScript();\n  const typeMods: ts.Modifier[] = [];\n  if (modifiers.export) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ExportKeyword));\n  }\n  if (modifiers.readonly) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ReadonlyKeyword));\n  }\n  return typeMods;\n}\n\n/**\n * Create a valid property index\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsPropertyIndex(index: string | number) {\n  const ts = loadTypeScript();\n  if (\n    (typeof index === \"number\" && !(index < 0)) ||\n    (typeof index === \"string\" && String(Number(index)) === index && index[0] !== \"-\")\n  ) {\n    return ts.factory.createNumericLiteral(index);\n  }\n  return typeof index === \"string\" && JS_PROPERTY_INDEX_RE.test(index)\n    ? ts.factory.createIdentifier(index)\n    : ts.factory.createStringLiteral(String(index));\n}\n\n/**\n * Enhanced ReadonlyArray.\n * eg: type Foo = ReadonlyArray<T>; type Bar = ReadonlyArray<T[]>\n * Foo and Bar are both of type `readonly T[]`\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsReadonlyArray(type: TypeInput, injectFooter?: FooterEntry[]): ts.TypeNode {\n  const ts = loadTypeScript();\n  if (injectFooter) {\n    requireHelper(injectFooter, HELPER_TYPES.readonlyArray);\n  }\n  return ts.factory.createTypeReferenceNode(ts.factory.createIdentifier(\"ReadonlyArray\"), [\n    legacyTypeNode(type),\n  ]);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"legacy-ts-helpers.mjs","sources":["../../src/api/legacy-ts-helpers.ts"],"sourcesContent":["import { toTypeNode, toValueExpression } from \"../adapters/type-ast-bridge/ir-to-typescript.js\";\nimport { lazyNode } from \"../adapters/type-ast-bridge/lazy-node.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport {\n  enumMemberDescription,\n  quotedMemberName,\n} from \"../application/transform/footer/enum-naming.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { schemaComment } from \"../application/transform/schema-comment.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\nimport type { TypeInput } from \"./type-helpers.js\";\n\n/**\n * The original's helpers that build TypeScript compiler nodes, kept for 1.x and deprecated\n * (ADR-004, decision 9). They load TypeScript on first use through the bridge; the generator\n * itself does not use them.\n */\n\nexport const JS_PROPERTY_INDEX_RE = /^[A-Za-z_$][A-Za-z_$0-9]*$/;\nexport const JS_ENUM_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+(.)?/g;\nexport const JS_PROPERTY_INDEX_INVALID_CHARS_RE = /[^A-Za-z_$0-9]+/g;\nexport const SPECIAL_CHARACTER_MAP: Record<string, string> = {\n  \"+\": \"Plus\",\n  // Add more mappings as needed\n};\n\n/**\n * The `?` token. Created on first use, so importing the package needs no TypeScript.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport const QUESTION_TOKEN: ts.QuestionToken = lazyNode(() => {\n  const ts = loadTypeScript();\n  return ts.factory.createToken(ts.SyntaxKind.QuestionToken);\n});\n\nexport interface AnnotatedSchemaObject {\n  const?: unknown; // jsdoc without value\n  default?: unknown; // jsdoc with value\n  deprecated?: boolean; // jsdoc without value\n  description?: string; // jsdoc with value\n  enum?: unknown[]; // jsdoc without value\n  example?: string; // jsdoc with value\n  examples?: unknown;\n  format?: string; // not jsdoc\n  nullable?: boolean; // Node information\n  summary?: string; // not jsdoc\n  title?: string; // not jsdoc\n  type?: string | string[]; // Type of node\n}\n\n/**\n * Add the schema's JSDoc comment to a TypeScript property signature.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function addJSDocComment(\n  schemaObject: AnnotatedSchemaObject,\n  node: ts.PropertySignature,\n): void {\n  const ts = loadTypeScript();\n  const comment = schemaComment(schemaObject);\n  if (comment) {\n    ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, comment.text, true);\n  }\n}\n\n/** A type argument of the deprecated helpers as TypeScript; IR from type helpers is converted. */\nfunction legacyTypeNode(type: TypeInput): ts.TypeNode {\n  const ts = loadTypeScript();\n  return typeof type.kind === \"string\" ? toTypeNode(ts, type as IrType) : (type as ts.TypeNode);\n}\n\n/** Add a helper type alias to the footer once, as a named raw declaration (like the generator). */\nfunction requireHelper(injectFooter: FooterEntry[], helper: { name: string; text: string }): void {\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, helper.name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name: helper.name, text: helper.text });\n  }\n}\n\n/**\n * Deduplicate simple primitive types from an array of nodes\n * Note: won’t deduplicate complex types like objects\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsDedupe(types: TypeInput[]): ts.TypeNode[] {\n  const encounteredTypes = new Set<number>();\n  const filteredTypes: ts.TypeNode[] = [];\n  for (const t of types.map(legacyTypeNode)) {\n    // only mark for deduplication if this is not a const (\"text\" means it is a const)\n    if (!(\"text\" in ((t as ts.LiteralTypeNode).literal ?? t))) {\n      const { kind } = (t as ts.LiteralTypeNode).literal ?? t;\n      if (encounteredTypes.has(kind)) {\n        continue;\n      }\n      if (tsIsPrimitive(t)) {\n        encounteredTypes.add(kind);\n      }\n    }\n    filteredTypes.push(t);\n  }\n  return filteredTypes;\n}\n\n/** @deprecated The generator keeps its own enum registry per run; kept for 1.x (ADR-004). */\nexport const enumCache: Map<string, ts.EnumDeclaration> = new Map();\n\n/**\n * Create a TS enum (with sanitized name and members)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnum(\n  name: string,\n  members: (string | number)[],\n  metadata?: { name?: string; description?: string | null }[],\n  options?: { export?: boolean; shouldCache?: boolean },\n): ts.EnumDeclaration {\n  const ts = loadTypeScript();\n  let enumName = sanitizeMemberName(name);\n  enumName = `${enumName.charAt(0).toUpperCase()}${enumName.substring(1)}`;\n  let key = \"\";\n  if (options?.shouldCache) {\n    key = `${members\n      .slice(0)\n      .sort()\n      .map((v, i) => {\n        return `${metadata?.[i]?.name ?? String(v)}:${metadata?.[i]?.description || \"\"}`;\n      })\n      .join(\",\")}`;\n    if (enumCache.has(key)) {\n      return enumCache.get(key) as ts.EnumDeclaration;\n    }\n  }\n  const enumDeclaration = ts.factory.createEnumDeclaration(\n    /* modifiers */ options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    /* name      */ enumName,\n    /* members   */ members.map((value, i) => tsEnumMember(value, metadata?.[i])),\n  );\n  options?.shouldCache && enumCache.set(key, enumDeclaration);\n  return enumDeclaration;\n}\n\n/**\n * Create an exported TS array literal expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsArrayLiteralExpression(\n  name: string,\n  elementType: TypeInput,\n  values: (string | number)[],\n  options?: { export?: boolean; readonly?: boolean; injectFooter?: FooterEntry[] },\n): ts.VariableStatement {\n  const ts = loadTypeScript();\n  let variableName = sanitizeMemberName(name);\n  variableName = `${variableName.charAt(0).toLowerCase()}${variableName.substring(1)}`;\n\n  if (options?.injectFooter) {\n    requireHelper(options.injectFooter, HELPER_TYPES.flattenedDeepRequired);\n  }\n\n  const arrayType = options?.readonly\n    ? tsReadonlyArray(elementType, options.injectFooter)\n    : ts.factory.createArrayTypeNode(legacyTypeNode(elementType));\n\n  return ts.factory.createVariableStatement(\n    options ? tsModifiers({ export: options.export ?? false }) : undefined,\n    ts.factory.createVariableDeclarationList(\n      [\n        ts.factory.createVariableDeclaration(\n          variableName,\n          undefined,\n          arrayType,\n          ts.factory.createArrayLiteralExpression(\n            values.map((value) => toValueExpression(ts, value)),\n          ),\n        ),\n      ],\n      ts.NodeFlags.Const,\n    ),\n  );\n}\n\nfunction sanitizeMemberName(name: string) {\n  let sanitizedName = name.replace(JS_ENUM_INVALID_CHARS_RE, (c) => {\n    // The pattern matches at least one character, so `last` is always a character.\n    const last = c.at(-1) ?? \"\";\n    return JS_PROPERTY_INDEX_INVALID_CHARS_RE.test(last) ? \"\" : last.toUpperCase();\n  });\n  if (Number(name[0]) >= 0) {\n    sanitizedName = `Value${name}`;\n  }\n  return sanitizedName;\n}\n\n/** An enum member name: a valid identifier as is; anything else prefixed, replaced or quoted. */\nfunction enumMemberName(value: string | number, explicitName: string | undefined): string {\n  let name = explicitName ?? String(value);\n  if (JS_PROPERTY_INDEX_RE.test(name)) {\n    return name;\n  }\n  if (Number(name[0]) >= 0) {\n    // A decimal point is not valid in a name; keep the digits readable.\n    name = `Value${name}`.replace(\".\", \"_\");\n  } else if (name[0] === \"-\") {\n    name = `ValueMinus${name.slice(1)}`;\n  }\n  const invalidCharMatch = name.match(JS_PROPERTY_INDEX_INVALID_CHARS_RE);\n  if (!invalidCharMatch) {\n    return name === \"\" ? quotedMemberName(name) : name;\n  }\n  if (invalidCharMatch[0] === name) {\n    return quotedMemberName(name);\n  }\n  return name.replace(JS_PROPERTY_INDEX_INVALID_CHARS_RE, (s) =>\n    s in SPECIAL_CHARACTER_MAP ? (SPECIAL_CHARACTER_MAP[s] as string) : \"_\",\n  );\n}\n\n/**\n * Sanitize TS enum member expression\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsEnumMember(\n  value: string | number,\n  metadata: { name?: string; description?: string | null } = {},\n): ts.EnumMember {\n  const ts = loadTypeScript();\n  const name = enumMemberName(value, metadata.name);\n  const member = ts.factory.createEnumMember(name, toValueExpression(ts, value));\n  const trimmedDescription = enumMemberDescription(metadata.description);\n  if (trimmedDescription === \"\") {\n    return member;\n  }\n\n  return ts.addSyntheticLeadingComment(\n    member,\n    ts.SyntaxKind.SingleLineCommentTrivia,\n    ` ${trimmedDescription}`,\n    true,\n  );\n}\n\n/**\n * Is this a primitive type (string, number, boolean, null, undefined)?\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsIsPrimitive(input: TypeInput): boolean {\n  const ts = loadTypeScript();\n  if (!input) {\n    return true;\n  }\n  const type = legacyTypeNode(input);\n  return (\n    ts.SyntaxKind[type.kind] === \"BooleanKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NeverKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NullKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"NumberKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"StringKeyword\" ||\n    ts.SyntaxKind[type.kind] === \"UndefinedKeyword\" ||\n    (\"literal\" in type && tsIsPrimitive(type.literal as ts.TypeLiteralNode))\n  );\n}\n\n/**\n * Modifiers (readonly)\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsModifiers(modifiers: { readonly?: boolean; export?: boolean }): ts.Modifier[] {\n  const ts = loadTypeScript();\n  const typeMods: ts.Modifier[] = [];\n  if (modifiers.export) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ExportKeyword));\n  }\n  if (modifiers.readonly) {\n    typeMods.push(ts.factory.createModifier(ts.SyntaxKind.ReadonlyKeyword));\n  }\n  return typeMods;\n}\n\n/**\n * Create a valid property index\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsPropertyIndex(\n  index: string | number,\n): ts.Identifier | ts.NumericLiteral | ts.StringLiteral {\n  const ts = loadTypeScript();\n  if (\n    (typeof index === \"number\" && !(index < 0)) ||\n    (typeof index === \"string\" && String(Number(index)) === index && index[0] !== \"-\")\n  ) {\n    return ts.factory.createNumericLiteral(index);\n  }\n  return typeof index === \"string\" && JS_PROPERTY_INDEX_RE.test(index)\n    ? ts.factory.createIdentifier(index)\n    : ts.factory.createStringLiteral(String(index));\n}\n\n/**\n * Enhanced ReadonlyArray.\n * eg: type Foo = ReadonlyArray<T>; type Bar = ReadonlyArray<T[]>\n * Foo and Bar are both of type `readonly T[]`\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function tsReadonlyArray(type: TypeInput, injectFooter?: FooterEntry[]): ts.TypeNode {\n  const ts = loadTypeScript();\n  if (injectFooter) {\n    requireHelper(injectFooter, HELPER_TYPES.readonlyArray);\n  }\n  return ts.factory.createTypeReferenceNode(ts.factory.createIdentifier(\"ReadonlyArray\"), [\n    legacyTypeNode(type),\n  ]);\n}\n"],"names":[],"mappings":"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"}

package/dist/api/legacy-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-utils.cjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/** Create a $ref pointer (even from other $refs) */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: any,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["terminalSupportsColor","colors","discriminatorProperty","createDomainRef","defaultLogger","formatDuration","resolveDocumentRef","walkDocument"],"mappings":";;;;;;;;;;;;;AAiBA,IAAI,CAACA,oCAAsB,EAAG;AAC5B,EAAAC,eAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAIA;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAOC,2CAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAGO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOC,sBAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAAC,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAAA,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAWC,6BAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAOC,+BAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAAC,yBAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAAH,0BAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;;;;;;;;;;"}
+{"version":3,"file":"legacy-utils.cjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/** Create a $ref pointer (even from other $refs) */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: unknown,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["terminalSupportsColor","colors","discriminatorProperty","createDomainRef","defaultLogger","formatDuration","resolveDocumentRef","walkDocument"],"mappings":";;;;;;;;;;;;;AAiBA,IAAI,CAACA,oCAAsB,EAAG;AAC5B,EAAAC,eAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAIA;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAOC,2CAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAGO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOC,sBAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAAC,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAAA,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAWC,6BAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAOC,+BAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAAC,yBAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAAH,0BAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;;;;;;;;;;"}

package/dist/api/legacy-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-utils.mjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/** Create a $ref pointer (even from other $refs) */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: any,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["createDomainRef"],"mappings":";;;;;;;AAiBA,IAAI,CAAC,uBAAsB,EAAG;AAC5B,EAAA,MAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAI;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAO,qBAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAGO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOA,YAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAW,cAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAA,YAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAA,aAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;"}
+{"version":3,"file":"legacy-utils.mjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/** Create a $ref pointer (even from other $refs) */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: unknown,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["createDomainRef"],"mappings":";;;;;;;AAiBA,IAAI,CAAC,uBAAsB,EAAG;AAC5B,EAAA,MAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAI;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAO,qBAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAGO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOA,YAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAW,cAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAA,YAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAA,aAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;"}

package/dist/api/openapi-ts.cjs

@@ -26,7 +26,8 @@ async function defaultGeneratorPorts(options) {
     redoc,
     logger,
     now: defaultPorts.monotonicNow,
-    remoteRefTimeoutMs: defaultPorts.REMOTE_REF_TIMEOUT_MS
+    remoteRefTimeoutMs: defaultPorts.REMOTE_REF_TIMEOUT_MS,
+    remoteDocumentLimits: defaultPorts.DEFAULT_REMOTE_DOCUMENT_LIMITS
   });
   return { loader, logger, redoc, now: defaultPorts.monotonicNow };
 }

package/dist/api/openapi-ts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-ts.cjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  const { schema, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const result = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return result;\n}\n\n/** The default ports: the terminal logger, the given or default Redocly config, Redocly loading. */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n  });\n  return { loader, logger, redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":["createDocumentRun","withStackOverflowReported","transformSchema","defaultLogger","defaultRedoclyConfig","createRedoclySchemaLoader","monotonicNow","REMOTE_REF_TIMEOUT_MS"],"mappings":";;;;;;;;;;AAmBA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,QAAQ,GAAA,EAAI,GAAI,MAAMA,6BAAA,CAAkB,MAAA,EAAQ,SAAS,KAAK,CAAA;AACtE,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,SAASC,uCAAA,CAA0B,WAAA,EAAa,MAAMC,uBAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AACxF,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,MAAA;AACT;AAGA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAASC,0BAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAMC,iCAAA,EAAqB;AAC7D,EAAA,MAAM,SAASC,6CAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAKC,yBAAA;AAAA,IACL,kBAAA,EAAoBC;AAAA,GACrB,CAAA;AACD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAKD,yBAAA,EAAa;AACpD;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;;;"}
+{"version":3,"file":"openapi-ts.cjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  const { schema, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const result = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return result;\n}\n\n/** The default ports: the terminal logger, the given or default Redocly config, Redocly loading. */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n    remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  });\n  return { loader, logger, redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":["createDocumentRun","withStackOverflowReported","transformSchema","defaultLogger","defaultRedoclyConfig","createRedoclySchemaLoader","monotonicNow","REMOTE_REF_TIMEOUT_MS","DEFAULT_REMOTE_DOCUMENT_LIMITS"],"mappings":";;;;;;;;;;AAoBA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,QAAQ,GAAA,EAAI,GAAI,MAAMA,6BAAA,CAAkB,MAAA,EAAQ,SAAS,KAAK,CAAA;AACtE,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,SAASC,uCAAA,CAA0B,WAAA,EAAa,MAAMC,uBAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AACxF,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,MAAA;AACT;AAGA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAASC,0BAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAMC,iCAAA,EAAqB;AAC7D,EAAA,MAAM,SAASC,6CAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAKC,yBAAA;AAAA,IACL,kBAAA,EAAoBC,kCAAA;AAAA,IACpB,oBAAA,EAAsBC;AAAA,GACvB,CAAA;AACD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAKF,yBAAA,EAAa;AACpD;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;;;"}

package/dist/api/openapi-ts.mjs

@@ -1,6 +1,6 @@
 import { createRedoclySchemaLoader } from '../adapters/redocly-loader/redocly-schema-loader.mjs';
 import { withStackOverflowReported } from '../application/stack-overflow.mjs';
-import { defaultLogger, defaultRedoclyConfig, monotonicNow, REMOTE_REF_TIMEOUT_MS } from './default-ports.mjs';
+import { defaultLogger, defaultRedoclyConfig, monotonicNow, DEFAULT_REMOTE_DOCUMENT_LIMITS, REMOTE_REF_TIMEOUT_MS } from './default-ports.mjs';
 import { createDocumentRun } from './document-run.mjs';
 import transformSchema from './transform-schema.mjs';
 
@@ -22,7 +22,8 @@ async function defaultGeneratorPorts(options) {
     redoc,
     logger,
     now: monotonicNow,
-    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS
+    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,
+    remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS
   });
   return { loader, logger, redoc, now: monotonicNow };
 }

package/dist/api/openapi-ts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-ts.mjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  const { schema, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const result = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return result;\n}\n\n/** The default ports: the terminal logger, the given or default Redocly config, Redocly loading. */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n  });\n  return { loader, logger, redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":[],"mappings":";;;;;;AAmBA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,QAAQ,GAAA,EAAI,GAAI,MAAM,iBAAA,CAAkB,MAAA,EAAQ,SAAS,KAAK,CAAA;AACtE,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,SAAS,yBAAA,CAA0B,WAAA,EAAa,MAAM,eAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AACxF,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,MAAA;AACT;AAGA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAAS,aAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAM,oBAAA,EAAqB;AAC7D,EAAA,MAAM,SAAS,yBAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAK,YAAA;AAAA,IACL,kBAAA,EAAoB;AAAA,GACrB,CAAA;AACD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAK,YAAA,EAAa;AACpD;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;"}
+{"version":3,"file":"openapi-ts.mjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  const { schema, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const result = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return result;\n}\n\n/** The default ports: the terminal logger, the given or default Redocly config, Redocly loading. */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n    remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  });\n  return { loader, logger, redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":[],"mappings":";;;;;;AAoBA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,QAAQ,GAAA,EAAI,GAAI,MAAM,iBAAA,CAAkB,MAAA,EAAQ,SAAS,KAAK,CAAA;AACtE,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,SAAS,yBAAA,CAA0B,WAAA,EAAa,MAAM,eAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AACxF,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,MAAA;AACT;AAGA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAAS,aAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAM,oBAAA,EAAqB;AAC7D,EAAA,MAAM,SAAS,yBAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAK,YAAA;AAAA,IACL,kBAAA,EAAoB,qBAAA;AAAA,IACpB,oBAAA,EAAsB;AAAA,GACvB,CAAA;AACD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAK,YAAA,EAAa;AACpD;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;"}

package/dist/api/path-template-warnings.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+const pathTemplates = require('../domain/openapi/path-templates.cjs');
+const warnings = require('../domain/warnings.cjs');
+
+const DOCS_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes";
+const SPEC_RULE = "OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical";
+function quotedList(urls) {
+  const quoted = urls.map((url) => `"${url}"`);
+  const last = quoted.pop();
+  return quoted.length === 0 ? last ?? "" : `${quoted.join(", ")} and ${last}`;
+}
+function warnIdenticalPathTemplates(document, logger) {
+  for (const urls of pathTemplates.findIdenticalPathTemplates(document)) {
+    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;
+    logger.warn(warnings.warningText(`${message}. See ${DOCS_URL}`, warnings.WARNING_CODES.PATH_TEMPLATES_IDENTICAL));
+  }
+}
+
+exports.warnIdenticalPathTemplates = warnIdenticalPathTemplates;
+//# sourceMappingURL=path-template-warnings.cjs.map

package/dist/api/path-template-warnings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-warnings.cjs","sources":["../../src/api/path-template-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport { findIdenticalPathTemplates } from \"../domain/openapi/path-templates.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\n\nconst DOCS_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes\";\nconst SPEC_RULE =\n  \"OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but \" +\n  \"different templated names MUST NOT exist as they are identical\";\n\n/** `\"/a\"`, `\"/a\" and \"/b\"`, `\"/a\", \"/b\" and \"/c\"`. */\nfunction quotedList(urls: readonly string[]): string {\n  const quoted = urls.map((url) => `\"${url}\"`);\n  const last = quoted.pop();\n  return quoted.length === 0 ? (last ?? \"\") : `${quoted.join(\", \")} and ${last}`;\n}\n\n/**\n * Warn once per group of paths that differ only in parameter names, which the spec forbids: a URL\n * cannot tell them apart, and `--path-params-as-types` gives them the same key type.\n */\nexport function warnIdenticalPathTemplates(document: unknown, logger: Logger): void {\n  for (const urls of findIdenticalPathTemplates(document)) {\n    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;\n    logger.warn(warningText(`${message}. See ${DOCS_URL}`, WARNING_CODES.PATH_TEMPLATES_IDENTICAL));\n  }\n}\n"],"names":["findIdenticalPathTemplates","warningText","WARNING_CODES"],"mappings":";;;;;AAIA,MAAM,QAAA,GACJ,8FAAA;AACF,MAAM,SAAA,GACJ,wJAAA;AAIF,SAAS,WAAW,IAAA,EAAiC;AACnD,EAAA,MAAM,SAAS,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,CAAG,CAAA;AAC3C,EAAA,MAAM,IAAA,GAAO,OAAO,GAAA,EAAI;AACxB,EAAA,OAAO,MAAA,CAAO,MAAA,KAAW,CAAA,GAAK,IAAA,IAAQ,EAAA,GAAM,CAAA,EAAG,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAA;AAC9E;AAMO,SAAS,0BAAA,CAA2B,UAAmB,MAAA,EAAsB;AAClF,EAAA,KAAA,MAAW,IAAA,IAAQA,wCAAA,CAA2B,QAAQ,CAAA,EAAG;AACvD,IAAA,MAAM,UAAU,CAAA,MAAA,EAAS,UAAA,CAAW,IAAI,CAAC,0CAA0C,SAAS,CAAA,CAAA;AAC5F,IAAA,MAAA,CAAO,IAAA,CAAKC,qBAAY,CAAA,EAAG,OAAO,SAAS,QAAQ,CAAA,CAAA,EAAIC,sBAAA,CAAc,wBAAwB,CAAC,CAAA;AAAA,EAChG;AACF;;"}

package/dist/api/path-template-warnings.mjs

@@ -0,0 +1,19 @@
+import { findIdenticalPathTemplates } from '../domain/openapi/path-templates.mjs';
+import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
+
+const DOCS_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes";
+const SPEC_RULE = "OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical";
+function quotedList(urls) {
+  const quoted = urls.map((url) => `"${url}"`);
+  const last = quoted.pop();
+  return quoted.length === 0 ? last ?? "" : `${quoted.join(", ")} and ${last}`;
+}
+function warnIdenticalPathTemplates(document, logger) {
+  for (const urls of findIdenticalPathTemplates(document)) {
+    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;
+    logger.warn(warningText(`${message}. See ${DOCS_URL}`, WARNING_CODES.PATH_TEMPLATES_IDENTICAL));
+  }
+}
+
+export { warnIdenticalPathTemplates };
+//# sourceMappingURL=path-template-warnings.mjs.map

package/dist/api/path-template-warnings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-warnings.mjs","sources":["../../src/api/path-template-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport { findIdenticalPathTemplates } from \"../domain/openapi/path-templates.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\n\nconst DOCS_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes\";\nconst SPEC_RULE =\n  \"OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but \" +\n  \"different templated names MUST NOT exist as they are identical\";\n\n/** `\"/a\"`, `\"/a\" and \"/b\"`, `\"/a\", \"/b\" and \"/c\"`. */\nfunction quotedList(urls: readonly string[]): string {\n  const quoted = urls.map((url) => `\"${url}\"`);\n  const last = quoted.pop();\n  return quoted.length === 0 ? (last ?? \"\") : `${quoted.join(\", \")} and ${last}`;\n}\n\n/**\n * Warn once per group of paths that differ only in parameter names, which the spec forbids: a URL\n * cannot tell them apart, and `--path-params-as-types` gives them the same key type.\n */\nexport function warnIdenticalPathTemplates(document: unknown, logger: Logger): void {\n  for (const urls of findIdenticalPathTemplates(document)) {\n    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;\n    logger.warn(warningText(`${message}. See ${DOCS_URL}`, WARNING_CODES.PATH_TEMPLATES_IDENTICAL));\n  }\n}\n"],"names":[],"mappings":";;;AAIA,MAAM,QAAA,GACJ,8FAAA;AACF,MAAM,SAAA,GACJ,wJAAA;AAIF,SAAS,WAAW,IAAA,EAAiC;AACnD,EAAA,MAAM,SAAS,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,CAAG,CAAA;AAC3C,EAAA,MAAM,IAAA,GAAO,OAAO,GAAA,EAAI;AACxB,EAAA,OAAO,MAAA,CAAO,MAAA,KAAW,CAAA,GAAK,IAAA,IAAQ,EAAA,GAAM,CAAA,EAAG,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAA;AAC9E;AAMO,SAAS,0BAAA,CAA2B,UAAmB,MAAA,EAAsB;AAClF,EAAA,KAAA,MAAW,IAAA,IAAQ,0BAAA,CAA2B,QAAQ,CAAA,EAAG;AACvD,IAAA,MAAM,UAAU,CAAA,MAAA,EAAS,UAAA,CAAW,IAAI,CAAC,0CAA0C,SAAS,CAAA,CAAA;AAC5F,IAAA,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,EAAG,OAAO,SAAS,QAAQ,CAAA,CAAA,EAAI,aAAA,CAAc,wBAAwB,CAAC,CAAA;AAAA,EAChG;AACF;;"}

package/dist/api/transform-context.cjs

@@ -25,7 +25,7 @@ function transformOptions(ctx) {
     additionalProperties: ctx.additionalProperties,
     alphabetize: ctx.alphabetize,
     arrayLength: ctx.arrayLength,
-    binaryAsBlob: ctx.binaryAsBlob,
+    binaryAsBlob: ctx.binaryAsBlob ?? false,
     conditionalEnums: ctx.conditionalEnums,
     dedupeEnums: ctx.dedupeEnums,
     defaultNonNullable: ctx.defaultNonNullable,
@@ -65,7 +65,9 @@ function createTransformContext(ctx) {
     refs: { resolve: (ref) => ctx.resolve(ref) },
     discriminators: {
       objectAt: (ref) => ctx.discriminators.objects[ref],
-      isHandled: (ref) => ctx.discriminators.refsHandled.includes(ref)
+      isHandled: (ref) => ctx.discriminators.refsHandled.includes(ref),
+      otherPropertiesAt: (ref) => ctx.discriminators.otherProperties?.[ref] ?? [],
+      enumParentOf: (schema) => ctx.discriminators.enumParents?.get(schema)
     },
     footer: runFooter(ctx),
     callbacks: schemaCallbacks.schemaCallbacks(ctx),

package/dist/api/transform-context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transform-context.cjs","sources":["../../src/api/transform-context.ts"],"sourcesContent":["import * as changeCase from \"change-case\";\nimport { RunFooter } from \"../application/transform/footer/document-footer.js\";\nimport type { SchemaLocation } from \"../application/transform/schema/schema-context.js\";\nimport type {\n  DocumentFooter,\n  NameCasing,\n  TransformContext,\n  TransformDiagnostics,\n  TransformOptions,\n} from \"../application/transform/transform-context.js\";\nimport type { GlobalContext, TransformNodeOptions } from \"../types.js\";\nimport { defaultLogger, monotonicNow } from \"./default-ports.js\";\nimport { ContextFooterSink } from \"./footer-sink.js\";\nimport { schemaCallbacks } from \"./schema-callbacks.js\";\n\n/**\n * Builds the ported transformers' context from the original `GlobalContext`: options, refs,\n * discriminators, the run footer and the user callbacks (see `schema-callbacks.ts`).\n */\n\nfunction transformOptions(ctx: GlobalContext): TransformOptions {\n  return {\n    additionalProperties: ctx.additionalProperties,\n    alphabetize: ctx.alphabetize,\n    arrayLength: ctx.arrayLength,\n    binaryAsBlob: ctx.binaryAsBlob,\n    conditionalEnums: ctx.conditionalEnums,\n    dedupeEnums: ctx.dedupeEnums,\n    defaultNonNullable: ctx.defaultNonNullable,\n    emptyObjectsUnknown: ctx.emptyObjectsUnknown,\n    enum: ctx.enum,\n    enumValues: ctx.enumValues,\n    excludeDeprecated: ctx.excludeDeprecated,\n    fixes: new Set(ctx.fix ?? []),\n    immutable: ctx.immutable,\n    propertiesRequiredByDefault: ctx.propertiesRequiredByDefault,\n    readWriteMarkers: ctx.readWriteMarkers,\n    generatePathParams: ctx.generatePathParams,\n    pathParamsAsTypes: ctx.pathParamsAsTypes,\n    rootTypes: ctx.rootTypes,\n    rootTypesNoSchemaPrefix: ctx.rootTypesNoSchemaPrefix,\n    rootTypesKeepCasing: ctx.rootTypesKeepCasing,\n    exportType: ctx.exportType,\n    inject: ctx.inject,\n    makePathsEnum: ctx.makePathsEnum,\n  };\n}\n\n/** One footer per run: it holds the enum registry, so it lives on the run's context. */\nfunction runFooter(ctx: GlobalContext): DocumentFooter {\n  ctx.runFooter ??= new RunFooter(new ContextFooterSink(ctx.injectFooter), ctx.dedupeEnums);\n  return ctx.runFooter;\n}\n\nconst CASING: NameCasing = { pascalCase: (text) => changeCase.pascalCase(text) };\n\n/**\n * A monotonic clock and the run's logger (the default one for a user's own context), \"ts\" group.\n */\nfunction diagnostics(ctx: GlobalContext): TransformDiagnostics {\n  const logger = ctx.logger ?? defaultLogger(ctx.silent);\n  return {\n    now: monotonicNow,\n    debug: (message, durationMs) => logger.debug(message, \"ts\", durationMs),\n  };\n}\n\n/** The ported transformers' context for one call from a legacy transformer. */\nexport function createTransformContext(ctx: GlobalContext): TransformContext {\n  return {\n    options: transformOptions(ctx),\n    refs: { resolve: (ref) => ctx.resolve(ref) },\n    discriminators: {\n      objectAt: (ref) => ctx.discriminators.objects[ref],\n      isHandled: (ref) => ctx.discriminators.refsHandled.includes(ref),\n    },\n    footer: runFooter(ctx),\n    callbacks: schemaCallbacks(ctx),\n    diagnostics: diagnostics(ctx),\n    casing: CASING,\n  };\n}\n\n/** The transformer's location for the original options object. */\nexport function schemaLocation(options: TransformNodeOptions): SchemaLocation {\n  return { path: options.path, schema: options.schema };\n}\n"],"names":["RunFooter","ContextFooterSink","changeCase","defaultLogger","monotonicNow","schemaCallbacks"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,SAAS,iBAAiB,GAAA,EAAsC;AAC9D,EAAA,OAAO;AAAA,IACL,sBAAsB,GAAA,CAAI,oBAAA;AAAA,IAC1B,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,cAAc,GAAA,CAAI,YAAA;AAAA,IAClB,kBAAkB,GAAA,CAAI,gBAAA;AAAA,IACtB,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,oBAAoB,GAAA,CAAI,kBAAA;AAAA,IACxB,qBAAqB,GAAA,CAAI,mBAAA;AAAA,IACzB,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,YAAY,GAAA,CAAI,UAAA;AAAA,IAChB,mBAAmB,GAAA,CAAI,iBAAA;AAAA,IACvB,OAAO,IAAI,GAAA,CAAI,GAAA,CAAI,GAAA,IAAO,EAAE,CAAA;AAAA,IAC5B,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,6BAA6B,GAAA,CAAI,2BAAA;AAAA,IACjC,kBAAkB,GAAA,CAAI,gBAAA;AAAA,IACtB,oBAAoB,GAAA,CAAI,kBAAA;AAAA,IACxB,mBAAmB,GAAA,CAAI,iBAAA;AAAA,IACvB,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,yBAAyB,GAAA,CAAI,uBAAA;AAAA,IAC7B,qBAAqB,GAAA,CAAI,mBAAA;AAAA,IACzB,YAAY,GAAA,CAAI,UAAA;AAAA,IAChB,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,eAAe,GAAA,CAAI;AAAA,GACrB;AACF;AAGA,SAAS,UAAU,GAAA,EAAoC;AACrD,EAAA,GAAA,CAAI,SAAA,KAAc,IAAIA,wBAAA,CAAU,IAAIC,6BAAkB,GAAA,CAAI,YAAY,CAAA,EAAG,GAAA,CAAI,WAAW,CAAA;AACxF,EAAA,OAAO,GAAA,CAAI,SAAA;AACb;AAEA,MAAM,MAAA,GAAqB,EAAE,UAAA,EAAY,CAAC,SAASC,qBAAA,CAAW,UAAA,CAAW,IAAI,CAAA,EAAE;AAK/E,SAAS,YAAY,GAAA,EAA0C;AAC7D,EAAA,MAAM,MAAA,GAAS,GAAA,CAAI,MAAA,IAAUC,0BAAA,CAAc,IAAI,MAAM,CAAA;AACrD,EAAA,OAAO;AAAA,IACL,GAAA,EAAKC,yBAAA;AAAA,IACL,KAAA,EAAO,CAAC,OAAA,EAAS,UAAA,KAAe,OAAO,KAAA,CAAM,OAAA,EAAS,MAAM,UAAU;AAAA,GACxE;AACF;AAGO,SAAS,uBAAuB,GAAA,EAAsC;AAC3E,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,iBAAiB,GAAG,CAAA;AAAA,IAC7B,IAAA,EAAM,EAAE,OAAA,EAAS,CAAC,QAAQ,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA,EAAE;AAAA,IAC3C,cAAA,EAAgB;AAAA,MACd,UAAU,CAAC,GAAA,KAAQ,GAAA,CAAI,cAAA,CAAe,QAAQ,GAAG,CAAA;AAAA,MACjD,WAAW,CAAC,GAAA,KAAQ,IAAI,cAAA,CAAe,WAAA,CAAY,SAAS,GAAG;AAAA,KACjE;AAAA,IACA,MAAA,EAAQ,UAAU,GAAG,CAAA;AAAA,IACrB,SAAA,EAAWC,gCAAgB,GAAG,CAAA;AAAA,IAC9B,WAAA,EAAa,YAAY,GAAG,CAAA;AAAA,IAC5B,MAAA,EAAQ;AAAA,GACV;AACF;AAGO,SAAS,eAAe,OAAA,EAA+C;AAC5E,EAAA,OAAO,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAM,MAAA,EAAQ,QAAQ,MAAA,EAAO;AACtD;;;"}
+{"version":3,"file":"transform-context.cjs","sources":["../../src/api/transform-context.ts"],"sourcesContent":["import * as changeCase from \"change-case\";\nimport { RunFooter } from \"../application/transform/footer/document-footer.js\";\nimport type {\n  DiscriminatorEnumParent,\n  SchemaLocation,\n} from \"../application/transform/schema/schema-context.js\";\nimport type {\n  DocumentFooter,\n  NameCasing,\n  TransformContext,\n  TransformDiagnostics,\n  TransformOptions,\n} from \"../application/transform/transform-context.js\";\nimport type { TransformNodeOptions } from \"../types.js\";\nimport { defaultLogger, monotonicNow } from \"./default-ports.js\";\nimport { ContextFooterSink } from \"./footer-sink.js\";\nimport type { RunContext } from \"./run-context.js\";\nimport { schemaCallbacks } from \"./schema-callbacks.js\";\n\n/**\n * Builds the ported transformers' context from the original `GlobalContext` (in a run, a\n * `RunContext`): options, refs, discriminators, the run footer and the user callbacks (see\n * `schema-callbacks.ts`).\n */\n\nfunction transformOptions(ctx: RunContext): TransformOptions {\n  return {\n    additionalProperties: ctx.additionalProperties,\n    alphabetize: ctx.alphabetize,\n    arrayLength: ctx.arrayLength,\n    binaryAsBlob: ctx.binaryAsBlob ?? false,\n    conditionalEnums: ctx.conditionalEnums,\n    dedupeEnums: ctx.dedupeEnums,\n    defaultNonNullable: ctx.defaultNonNullable,\n    emptyObjectsUnknown: ctx.emptyObjectsUnknown,\n    enum: ctx.enum,\n    enumValues: ctx.enumValues,\n    excludeDeprecated: ctx.excludeDeprecated,\n    fixes: new Set(ctx.fix ?? []),\n    immutable: ctx.immutable,\n    propertiesRequiredByDefault: ctx.propertiesRequiredByDefault,\n    readWriteMarkers: ctx.readWriteMarkers,\n    generatePathParams: ctx.generatePathParams,\n    pathParamsAsTypes: ctx.pathParamsAsTypes,\n    rootTypes: ctx.rootTypes,\n    rootTypesNoSchemaPrefix: ctx.rootTypesNoSchemaPrefix,\n    rootTypesKeepCasing: ctx.rootTypesKeepCasing,\n    exportType: ctx.exportType,\n    inject: ctx.inject,\n    makePathsEnum: ctx.makePathsEnum,\n  };\n}\n\n/** One footer per run: it holds the enum registry, so it lives on the run's context. */\nfunction runFooter(ctx: RunContext): DocumentFooter {\n  ctx.runFooter ??= new RunFooter(new ContextFooterSink(ctx.injectFooter), ctx.dedupeEnums);\n  return ctx.runFooter;\n}\n\nconst CASING: NameCasing = { pascalCase: (text) => changeCase.pascalCase(text) };\n\n/**\n * A monotonic clock and the run's logger (the default one for a user's own context), \"ts\" group.\n */\nfunction diagnostics(ctx: RunContext): TransformDiagnostics {\n  const logger = ctx.logger ?? defaultLogger(ctx.silent);\n  return {\n    now: monotonicNow,\n    debug: (message, durationMs) => logger.debug(message, \"ts\", durationMs),\n  };\n}\n\n/** The ported transformers' context for one call from a legacy transformer. */\nexport function createTransformContext(ctx: RunContext): TransformContext {\n  return {\n    options: transformOptions(ctx),\n    refs: { resolve: (ref) => ctx.resolve(ref) },\n    discriminators: {\n      objectAt: (ref) => ctx.discriminators.objects[ref],\n      isHandled: (ref) => ctx.discriminators.refsHandled.includes(ref),\n      otherPropertiesAt: (ref) => ctx.discriminators.otherProperties?.[ref] ?? [],\n      enumParentOf: (schema) =>\n        ctx.discriminators.enumParents?.get(schema) as DiscriminatorEnumParent | undefined,\n    },\n    footer: runFooter(ctx),\n    callbacks: schemaCallbacks(ctx),\n    diagnostics: diagnostics(ctx),\n    casing: CASING,\n  };\n}\n\n/** The transformer's location for the original options object. */\nexport function schemaLocation(options: TransformNodeOptions): SchemaLocation {\n  return { path: options.path, schema: options.schema };\n}\n"],"names":["RunFooter","ContextFooterSink","changeCase","defaultLogger","monotonicNow","schemaCallbacks"],"mappings":"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"}