openapi-typesafe 1.0.0-rc.3 → 1.0.0-rc.5

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

@@ -1 +1 @@
-{"version":3,"file":"transform-context.mjs","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":[],"mappings":"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"}
+{"version":3,"file":"transform-context.mjs","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 { canonicalRef } from \"../domain/openapi/json-pointer.js\";\nimport { SCHEMA_DIALECTS } from \"../domain/openapi/schema-dialect.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    schemaDialect: ctx.schemaDialect ?? SCHEMA_DIALECTS.OPENAPI_3_0,\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      // The scan keys pointers canonically; a caller may pass a `$ref` as the document writes it.\n      objectAt: (ref) => ctx.discriminators.objects[canonicalRef(ref)],\n      isHandled: (ref) => ctx.discriminators.refsHandled.includes(canonicalRef(ref)),\n      otherPropertiesAt: (ref) => ctx.discriminators.otherProperties?.[canonicalRef(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":[],"mappings":"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"}

package/dist/api/transform-schema.cjs

@@ -3,10 +3,16 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const document = require('../application/transform/document/document.cjs');
+const enumNamesGivenBack = require('../application/transform/document/enum-names-given-back.cjs');
+const operationKeysWritten = require('../application/transform/document/operation-keys-written.cjs');
+const pathTemplateRefs = require('../application/transform/document/path-template-refs.cjs');
 const rootTypeAliases = require('../application/transform/document/root-type-aliases.cjs');
 const documentFooter = require('../application/transform/footer/document-footer.cjs');
+const enumNameClaims = require('../application/transform/footer/enum-name-claims.cjs');
 const enumValuesCheck = require('../application/transform/footer/enum-values-check.cjs');
+const operationKeys = require('../application/transform/footer/operation-keys.cjs');
 const sharedEnumNames = require('../application/transform/footer/shared-enum-names.cjs');
+const schemaDialect = require('../domain/openapi/schema-dialect.cjs');
 const outputFixes = require('../domain/output-fixes.cjs');
 const discriminatorEnumNames = require('./discriminator-enum-names.cjs');
 const documentDeclarations = require('./document-declarations.cjs');
@@ -41,13 +47,28 @@ function enumNameRecorderOf(ctx) {
   }
   return ctx.fix?.includes(outputFixes.FIX.DISCRIMINATOR_VALUES) ? new discriminatorEnumNames.FirstSchemaNameRecorder() : null;
 }
-function withSharedEnumNames(document, ctx) {
-  const recorder = ctx.runFooter === void 0 ? enumNameRecorderOf(ctx) : null;
-  if (recorder === null || !ctx.enum || !ctx.dedupeEnums) {
+function withRunFooter(document, ctx, names) {
+  if (ctx.runFooter !== void 0) {
     return;
   }
-  const names = sharedEnumNamesOf(document, ctx, recorder);
-  ctx.runFooter = new documentFooter.RunFooter(new footerSink.ContextFooterSink(ctx.injectFooter), true, names);
+  const recorder = enumNameRecorderOf(ctx);
+  const shared = recorder === null || !ctx.enum || !ctx.dedupeEnums ? null : sharedEnumNamesOf(document, ctx, recorder);
+  const sink = new footerSink.ContextFooterSink(ctx.injectFooter);
+  ctx.runFooter = shared === null ? new documentFooter.RunFooter(sink, ctx.dedupeEnums, sharedEnumNames.FIRST_SCHEMA_NAMES, names) : new documentFooter.RunFooter(sink, true, shared, names);
+}
+function withEnumNamesGivenBack(parts, names) {
+  const footer = parts.footer.filter(footerEntry.isIrDeclaration);
+  const renames = names.enums.givenBack(enumNamesGivenBack.namesTheOutputNeeds({ ...parts, footer }));
+  if (renames.size === 0) {
+    return parts;
+  }
+  return {
+    body: enumNamesGivenBack.withEnumsRenamed(parts.body, renames),
+    footer: parts.footer.map(
+      (entry) => footerEntry.isIrDeclaration(entry) ? enumNamesGivenBack.withEnumsRenamed([entry], renames)[0] ?? entry : entry
+    ),
+    closing: enumNamesGivenBack.withEnumsRenamed(parts.closing, renames)
+  };
 }
 function enumValuesChecked(body, footer, ctx) {
   if (!ctx.enumValues) {
@@ -61,15 +82,31 @@ function enumValuesChecked(body, footer, ctx) {
   }
   return checked.footer;
 }
+function withTemplateRefs({ body, footer, closing }, keys) {
+  return {
+    body: pathTemplateRefs.withTemplatePathRefs(body, keys),
+    footer: footer.map(
+      (entry) => footerEntry.isIrDeclaration(entry) ? pathTemplateRefs.withTemplatePathRefs([entry], keys)[0] ?? entry : entry
+    ),
+    closing: pathTemplateRefs.withTemplatePathRefs(closing, keys)
+  };
+}
 function transformDocument(schema, ctx) {
   const document$1 = schema;
-  withSharedEnumNames(document$1, ctx);
+  ctx.schemaDialect = schemaDialect.schemaDialectOf(document$1.openapi);
+  const names = {
+    enums: new enumNameClaims.EnumNameClaims(enumNamesGivenBack.NAMES_THE_OUTPUT_MAY_NEED),
+    operations: new operationKeys.OperationKeys(operationKeysWritten.operationKeysWritten(document$1))
+  };
+  withRunFooter(document$1, ctx, names);
   const context = transformContext.createTransformContext(ctx);
   const rawBody = document.documentBody(document$1, context, () => ctx.injectFooter.filter(footerEntry.isIrDeclaration));
-  const footer = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);
-  const closing = document.documentClosing(document$1, context, footer.some(isOperations));
-  const body = rootTypeAliases.renameTakenAliases(rawBody, footer.filter(footerEntry.isIrDeclaration), closing);
-  return { body, footer, closing };
+  const rawFooter = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);
+  const rawClosing = document.documentClosing(document$1, context, rawFooter.some(isOperations));
+  const parts = { body: rawBody, footer: rawFooter, closing: rawClosing };
+  const { body, footer, closing } = withEnumNamesGivenBack(parts, names);
+  const named = { body: rootTypeAliases.renameTakenAliases(body, footer.filter(footerEntry.isIrDeclaration), closing), footer };
+  return withTemplateRefs({ ...named, closing }, pathTemplateRefs.unmatchedTemplateKeys(document$1.paths, context));
 }
 function transformSchema(schema, ctx) {
   return documentDeclarations.documentDeclarations(transformDocument(schema, ctx));

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

@@ -1 +1 @@
-{"version":3,"file":"transform-schema.cjs","sources":["../../src/api/transform-schema.ts"],"sourcesContent":["import type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { documentBody, documentClosing } from \"../application/transform/document/document.js\";\nimport { renameTakenAliases } from \"../application/transform/document/root-type-aliases.js\";\nimport { RunFooter } from \"../application/transform/footer/document-footer.js\";\nimport { checkedEnumValues } from \"../application/transform/footer/enum-values-check.js\";\nimport {\n  SharedEnumNameRecorder,\n  type SharedEnumNames,\n} from \"../application/transform/footer/shared-enum-names.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { DocumentObject } from \"../domain/openapi/document-object.js\";\nimport { FIX } from \"../domain/output-fixes.js\";\nimport type { GlobalContext, OpenAPI3 } from \"../types.js\";\nimport { FirstSchemaNameRecorder } from \"./discriminator-enum-names.js\";\nimport { documentDeclarations, type TransformedDocument } from \"./document-declarations.js\";\nimport { excludedValuesWarning } from \"./enum-values-warnings.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\nimport { ContextFooterSink } from \"./footer-sink.js\";\nimport type { RunContext } from \"./run-context.js\";\nimport { createTransformContext } from \"./transform-context.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/** Whether a footer entry is named `operations` (any declaration kind, as in the original). */\nfunction isOperations(entry: FooterEntry): boolean {\n  const name = isIrDeclaration(entry)\n    ? (entry as { name?: string }).name\n    : (entry as Partial<ts.InterfaceDeclaration>).name?.escapedText;\n  return name === OPERATIONS_NAME;\n}\n\n/** Drops a message: the first pass must not repeat the run's warnings or debug lines. */\nconst dropMessage = (): void => undefined;\nconst DROPPED_MESSAGES = { debug: dropMessage, warn: dropMessage, error: dropMessage };\n\n/** A shared enum name recorder of a first pass, and the names it gives the second. */\ninterface EnumNameRecorder extends SharedEnumNames {\n  chosenNames(): SharedEnumNames;\n}\n\n/**\n * The names of shared enums, known only at the end: a first pass transforms the document into a\n * scratch footer that `recorder` watches; its output is dropped. User callbacks run in both\n * passes. The `dedupe-enum-names` fix (ADR-021, upstream #1683) names an enum by all of its\n * schemas; `discriminator-values` keeps the first declaring schema's name\n * (`FirstSchemaNameRecorder`).\n */\nfunction sharedEnumNamesOf(\n  document: DocumentObject,\n  ctx: RunContext,\n  recorder: EnumNameRecorder,\n): SharedEnumNames {\n  const injectFooter: FooterEntry[] = [];\n  const scratch: RunContext = {\n    ...ctx,\n    injectFooter,\n    runFooter: new RunFooter(new ContextFooterSink(injectFooter), true, recorder),\n    logger: DROPPED_MESSAGES,\n    legacyCallbackWarnings: new Set(),\n  };\n  const scratchContext = createTransformContext(scratch);\n  documentBody(document, scratchContext, () => injectFooter.filter(isIrDeclaration));\n  return recorder.chosenNames();\n}\n\n/** The recorder of the run's fixes, or null where the first schema's name needs no first pass. */\nfunction enumNameRecorderOf(ctx: GlobalContext): EnumNameRecorder | null {\n  if (ctx.fix?.includes(FIX.DEDUPE_ENUM_NAMES)) {\n    return new SharedEnumNameRecorder();\n  }\n  return ctx.fix?.includes(FIX.DISCRIMINATOR_VALUES) ? new FirstSchemaNameRecorder() : null;\n}\n\n/** With a naming fix, `--enum` and `--dedupe-enums`, the run's footer names shared enums. */\nfunction withSharedEnumNames(document: DocumentObject, ctx: RunContext): void {\n  const recorder = ctx.runFooter === undefined ? enumNameRecorderOf(ctx) : null;\n  if (recorder === null || !ctx.enum || !ctx.dedupeEnums) {\n    return;\n  }\n  const names = sharedEnumNamesOf(document, ctx, recorder);\n  ctx.runFooter = new RunFooter(new ContextFooterSink(ctx.injectFooter), true, names);\n}\n\n/**\n * With `--enum-values`, arrays whose location type does not hold their values are typed by their\n * values (ADR-027); a location that excludes listed values is a contradiction of the document.\n */\nfunction enumValuesChecked(\n  body: readonly IrDeclaration[],\n  footer: FooterEntry[],\n  ctx: RunContext,\n): FooterEntry[] {\n  if (!ctx.enumValues) {\n    return footer;\n  }\n  const checked = checkedEnumValues(footer, body, isIrDeclaration);\n  for (const retype of checked.retyped) {\n    if (retype.kind === \"excluded\") {\n      ctx.logger?.warn(excludedValuesWarning(retype.name, retype.excluded));\n    }\n  }\n  return checked.footer;\n}\n\n/** @internal Root types, the footer, then the closing declarations (Phase 5, step 6). */\nexport function transformDocument(schema: OpenAPI3, ctx: RunContext): TransformedDocument {\n  const document = schema as DocumentObject;\n  withSharedEnumNames(document, ctx);\n  const context = createTransformContext(ctx);\n  // documentBody registers the enums in the footer, so the footer is read after it.\n  const rawBody = documentBody(document, context, () => ctx.injectFooter.filter(isIrDeclaration));\n  const footer = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);\n  const closing = documentClosing(document, context, footer.some(isOperations));\n  const body = renameTakenAliases(rawBody, footer.filter(isIrDeclaration), closing);\n  return { body, footer, closing };\n}\n\n/**\n * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same\n * for a loaded document.\n */\nexport default function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclaration[] {\n  return documentDeclarations(transformDocument(schema, ctx));\n}\n"],"names":["isIrDeclaration","document","RunFooter","ContextFooterSink","createTransformContext","documentBody","FIX","SharedEnumNameRecorder","FirstSchemaNameRecorder","checkedEnumValues","excludedValuesWarning","documentClosing","renameTakenAliases","documentDeclarations"],"mappings":"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"}
+{"version":3,"file":"transform-schema.cjs","sources":["../../src/api/transform-schema.ts"],"sourcesContent":["import type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { documentBody, documentClosing } from \"../application/transform/document/document.js\";\nimport {\n  NAMES_THE_OUTPUT_MAY_NEED,\n  namesTheOutputNeeds,\n  withEnumsRenamed,\n} from \"../application/transform/document/enum-names-given-back.js\";\nimport { operationKeysWritten } from \"../application/transform/document/operation-keys-written.js\";\nimport {\n  unmatchedTemplateKeys,\n  withTemplatePathRefs,\n} from \"../application/transform/document/path-template-refs.js\";\nimport { renameTakenAliases } from \"../application/transform/document/root-type-aliases.js\";\nimport { RunFooter, type RunFooterNames } from \"../application/transform/footer/document-footer.js\";\nimport { EnumNameClaims } from \"../application/transform/footer/enum-name-claims.js\";\nimport { checkedEnumValues } from \"../application/transform/footer/enum-values-check.js\";\nimport { OperationKeys } from \"../application/transform/footer/operation-keys.js\";\nimport {\n  FIRST_SCHEMA_NAMES,\n  SharedEnumNameRecorder,\n  type SharedEnumNames,\n} from \"../application/transform/footer/shared-enum-names.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { DocumentObject } from \"../domain/openapi/document-object.js\";\nimport { schemaDialectOf } from \"../domain/openapi/schema-dialect.js\";\nimport { FIX } from \"../domain/output-fixes.js\";\nimport type { GlobalContext, OpenAPI3 } from \"../types.js\";\nimport { FirstSchemaNameRecorder } from \"./discriminator-enum-names.js\";\nimport { documentDeclarations, type TransformedDocument } from \"./document-declarations.js\";\nimport { excludedValuesWarning } from \"./enum-values-warnings.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\nimport { ContextFooterSink } from \"./footer-sink.js\";\nimport type { RunContext } from \"./run-context.js\";\nimport { createTransformContext } from \"./transform-context.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/** Whether a footer entry is named `operations` (any declaration kind, as in the original). */\nfunction isOperations(entry: FooterEntry): boolean {\n  const name = isIrDeclaration(entry)\n    ? (entry as { name?: string }).name\n    : (entry as Partial<ts.InterfaceDeclaration>).name?.escapedText;\n  return name === OPERATIONS_NAME;\n}\n\n/** Drops a message: the first pass must not repeat the run's warnings or debug lines. */\nconst dropMessage = (): void => undefined;\nconst DROPPED_MESSAGES = { debug: dropMessage, warn: dropMessage, error: dropMessage };\n\n/** A shared enum name recorder of a first pass, and the names it gives the second. */\ninterface EnumNameRecorder extends SharedEnumNames {\n  chosenNames(): SharedEnumNames;\n}\n\n/**\n * The names of shared enums, known only at the end: a first pass transforms the document into a\n * scratch footer that `recorder` watches; its output is dropped. User callbacks run in both\n * passes. The `dedupe-enum-names` fix (ADR-021, upstream #1683) names an enum by all of its\n * schemas; `discriminator-values` keeps the first declaring schema's name\n * (`FirstSchemaNameRecorder`).\n */\nfunction sharedEnumNamesOf(\n  document: DocumentObject,\n  ctx: RunContext,\n  recorder: EnumNameRecorder,\n): SharedEnumNames {\n  const injectFooter: FooterEntry[] = [];\n  const scratch: RunContext = {\n    ...ctx,\n    injectFooter,\n    runFooter: new RunFooter(new ContextFooterSink(injectFooter), true, recorder),\n    logger: DROPPED_MESSAGES,\n    legacyCallbackWarnings: new Set(),\n  };\n  const scratchContext = createTransformContext(scratch);\n  documentBody(document, scratchContext, () => injectFooter.filter(isIrDeclaration));\n  return recorder.chosenNames();\n}\n\n/** The recorder of the run's fixes, or null where the first schema's name needs no first pass. */\nfunction enumNameRecorderOf(ctx: GlobalContext): EnumNameRecorder | null {\n  if (ctx.fix?.includes(FIX.DEDUPE_ENUM_NAMES)) {\n    return new SharedEnumNameRecorder();\n  }\n  return ctx.fix?.includes(FIX.DISCRIMINATOR_VALUES) ? new FirstSchemaNameRecorder() : null;\n}\n\n/**\n * The run's footer: with a naming fix, `--enum` and `--dedupe-enums` it names shared enums. A\n * footer that a call before created on the context is kept.\n */\nfunction withRunFooter(document: DocumentObject, ctx: RunContext, names: RunFooterNames): void {\n  if (ctx.runFooter !== undefined) {\n    return;\n  }\n  const recorder = enumNameRecorderOf(ctx);\n  const shared =\n    recorder === null || !ctx.enum || !ctx.dedupeEnums\n      ? null\n      : sharedEnumNamesOf(document, ctx, recorder);\n  const sink = new ContextFooterSink(ctx.injectFooter);\n  ctx.runFooter =\n    shared === null\n      ? new RunFooter(sink, ctx.dedupeEnums, FIRST_SCHEMA_NAMES, names)\n      : new RunFooter(sink, true, shared, names);\n}\n\n/**\n * The document with the enums renamed that gave way to a name the output turned out not to need\n * (`EnumNameClaims`): they get that name back, as before.\n */\nfunction withEnumNamesGivenBack(\n  parts: TransformedDocument,\n  names: RunFooterNames,\n): TransformedDocument {\n  const footer = parts.footer.filter(isIrDeclaration);\n  const renames = names.enums.givenBack(namesTheOutputNeeds({ ...parts, footer }));\n  if (renames.size === 0) {\n    return parts;\n  }\n  return {\n    body: withEnumsRenamed(parts.body, renames),\n    footer: parts.footer.map((entry) =>\n      isIrDeclaration(entry) ? (withEnumsRenamed([entry], renames)[0] ?? entry) : entry,\n    ),\n    closing: withEnumsRenamed(parts.closing, renames),\n  };\n}\n\n/**\n * With `--enum-values`, arrays whose location type does not hold their values are typed by their\n * values (ADR-027); a location that excludes listed values is a contradiction of the document.\n */\nfunction enumValuesChecked(\n  body: readonly IrDeclaration[],\n  footer: FooterEntry[],\n  ctx: RunContext,\n): FooterEntry[] {\n  if (!ctx.enumValues) {\n    return footer;\n  }\n  const checked = checkedEnumValues(footer, body, isIrDeclaration);\n  for (const retype of checked.retyped) {\n    if (retype.kind === \"excluded\") {\n      ctx.logger?.warn(excludedValuesWarning(retype.name, retype.excluded));\n    }\n  }\n  return checked.footer;\n}\n\n/** The document with its references into templated paths indexed by their templates. */\nfunction withTemplateRefs(\n  { body, footer, closing }: TransformedDocument,\n  keys: ReadonlyMap<string, string>,\n): TransformedDocument {\n  return {\n    body: withTemplatePathRefs(body, keys),\n    footer: footer.map((entry) =>\n      isIrDeclaration(entry) ? (withTemplatePathRefs([entry], keys)[0] ?? entry) : entry,\n    ),\n    closing: withTemplatePathRefs(closing, keys),\n  };\n}\n\n/** @internal Root types, the footer, then the closing declarations (Phase 5, step 6). */\nexport function transformDocument(schema: OpenAPI3, ctx: RunContext): TransformedDocument {\n  const document = schema as DocumentObject;\n  ctx.schemaDialect = schemaDialectOf(document.openapi);\n  const names: RunFooterNames = {\n    enums: new EnumNameClaims(NAMES_THE_OUTPUT_MAY_NEED),\n    operations: new OperationKeys(operationKeysWritten(document)),\n  };\n  withRunFooter(document, ctx, names);\n  const context = createTransformContext(ctx);\n  // documentBody registers the enums in the footer, so the footer is read after it.\n  const rawBody = documentBody(document, context, () => ctx.injectFooter.filter(isIrDeclaration));\n  const rawFooter = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);\n  const rawClosing = documentClosing(document, context, rawFooter.some(isOperations));\n  const parts = { body: rawBody, footer: rawFooter, closing: rawClosing };\n  const { body, footer, closing } = withEnumNamesGivenBack(parts, names);\n  const named = { body: renameTakenAliases(body, footer.filter(isIrDeclaration), closing), footer };\n  return withTemplateRefs({ ...named, closing }, unmatchedTemplateKeys(document.paths, context));\n}\n\n/**\n * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same\n * for a loaded document.\n */\nexport default function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclaration[] {\n  return documentDeclarations(transformDocument(schema, ctx));\n}\n"],"names":["isIrDeclaration","document","RunFooter","ContextFooterSink","createTransformContext","documentBody","FIX","SharedEnumNameRecorder","FirstSchemaNameRecorder","FIRST_SCHEMA_NAMES","namesTheOutputNeeds","withEnumsRenamed","checkedEnumValues","excludedValuesWarning","withTemplatePathRefs","schemaDialectOf","EnumNameClaims","NAMES_THE_OUTPUT_MAY_NEED","OperationKeys","operationKeysWritten","documentClosing","renameTakenAliases","unmatchedTemplateKeys","documentDeclarations"],"mappings":"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"}

package/dist/api/transform-schema.mjs

@@ -1,8 +1,14 @@
 import { documentBody, documentClosing } from '../application/transform/document/document.mjs';
+import { NAMES_THE_OUTPUT_MAY_NEED, namesTheOutputNeeds, withEnumsRenamed } from '../application/transform/document/enum-names-given-back.mjs';
+import { operationKeysWritten } from '../application/transform/document/operation-keys-written.mjs';
+import { unmatchedTemplateKeys, withTemplatePathRefs } from '../application/transform/document/path-template-refs.mjs';
 import { renameTakenAliases } from '../application/transform/document/root-type-aliases.mjs';
 import { RunFooter } from '../application/transform/footer/document-footer.mjs';
+import { EnumNameClaims } from '../application/transform/footer/enum-name-claims.mjs';
 import { checkedEnumValues } from '../application/transform/footer/enum-values-check.mjs';
-import { SharedEnumNameRecorder } from '../application/transform/footer/shared-enum-names.mjs';
+import { OperationKeys } from '../application/transform/footer/operation-keys.mjs';
+import { FIRST_SCHEMA_NAMES, SharedEnumNameRecorder } from '../application/transform/footer/shared-enum-names.mjs';
+import { schemaDialectOf } from '../domain/openapi/schema-dialect.mjs';
 import { FIX } from '../domain/output-fixes.mjs';
 import { FirstSchemaNameRecorder } from './discriminator-enum-names.mjs';
 import { documentDeclarations } from './document-declarations.mjs';
@@ -37,13 +43,28 @@ function enumNameRecorderOf(ctx) {
   }
   return ctx.fix?.includes(FIX.DISCRIMINATOR_VALUES) ? new FirstSchemaNameRecorder() : null;
 }
-function withSharedEnumNames(document, ctx) {
-  const recorder = ctx.runFooter === void 0 ? enumNameRecorderOf(ctx) : null;
-  if (recorder === null || !ctx.enum || !ctx.dedupeEnums) {
+function withRunFooter(document, ctx, names) {
+  if (ctx.runFooter !== void 0) {
     return;
   }
-  const names = sharedEnumNamesOf(document, ctx, recorder);
-  ctx.runFooter = new RunFooter(new ContextFooterSink(ctx.injectFooter), true, names);
+  const recorder = enumNameRecorderOf(ctx);
+  const shared = recorder === null || !ctx.enum || !ctx.dedupeEnums ? null : sharedEnumNamesOf(document, ctx, recorder);
+  const sink = new ContextFooterSink(ctx.injectFooter);
+  ctx.runFooter = shared === null ? new RunFooter(sink, ctx.dedupeEnums, FIRST_SCHEMA_NAMES, names) : new RunFooter(sink, true, shared, names);
+}
+function withEnumNamesGivenBack(parts, names) {
+  const footer = parts.footer.filter(isIrDeclaration);
+  const renames = names.enums.givenBack(namesTheOutputNeeds({ ...parts, footer }));
+  if (renames.size === 0) {
+    return parts;
+  }
+  return {
+    body: withEnumsRenamed(parts.body, renames),
+    footer: parts.footer.map(
+      (entry) => isIrDeclaration(entry) ? withEnumsRenamed([entry], renames)[0] ?? entry : entry
+    ),
+    closing: withEnumsRenamed(parts.closing, renames)
+  };
 }
 function enumValuesChecked(body, footer, ctx) {
   if (!ctx.enumValues) {
@@ -57,15 +78,31 @@ function enumValuesChecked(body, footer, ctx) {
   }
   return checked.footer;
 }
+function withTemplateRefs({ body, footer, closing }, keys) {
+  return {
+    body: withTemplatePathRefs(body, keys),
+    footer: footer.map(
+      (entry) => isIrDeclaration(entry) ? withTemplatePathRefs([entry], keys)[0] ?? entry : entry
+    ),
+    closing: withTemplatePathRefs(closing, keys)
+  };
+}
 function transformDocument(schema, ctx) {
   const document = schema;
-  withSharedEnumNames(document, ctx);
+  ctx.schemaDialect = schemaDialectOf(document.openapi);
+  const names = {
+    enums: new EnumNameClaims(NAMES_THE_OUTPUT_MAY_NEED),
+    operations: new OperationKeys(operationKeysWritten(document))
+  };
+  withRunFooter(document, ctx, names);
   const context = createTransformContext(ctx);
   const rawBody = documentBody(document, context, () => ctx.injectFooter.filter(isIrDeclaration));
-  const footer = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);
-  const closing = documentClosing(document, context, footer.some(isOperations));
-  const body = renameTakenAliases(rawBody, footer.filter(isIrDeclaration), closing);
-  return { body, footer, closing };
+  const rawFooter = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);
+  const rawClosing = documentClosing(document, context, rawFooter.some(isOperations));
+  const parts = { body: rawBody, footer: rawFooter, closing: rawClosing };
+  const { body, footer, closing } = withEnumNamesGivenBack(parts, names);
+  const named = { body: renameTakenAliases(body, footer.filter(isIrDeclaration), closing), footer };
+  return withTemplateRefs({ ...named, closing }, unmatchedTemplateKeys(document.paths, context));
 }
 function transformSchema(schema, ctx) {
   return documentDeclarations(transformDocument(schema, ctx));

package/dist/api/transform-schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transform-schema.mjs","sources":["../../src/api/transform-schema.ts"],"sourcesContent":["import type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { documentBody, documentClosing } from \"../application/transform/document/document.js\";\nimport { renameTakenAliases } from \"../application/transform/document/root-type-aliases.js\";\nimport { RunFooter } from \"../application/transform/footer/document-footer.js\";\nimport { checkedEnumValues } from \"../application/transform/footer/enum-values-check.js\";\nimport {\n  SharedEnumNameRecorder,\n  type SharedEnumNames,\n} from \"../application/transform/footer/shared-enum-names.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { DocumentObject } from \"../domain/openapi/document-object.js\";\nimport { FIX } from \"../domain/output-fixes.js\";\nimport type { GlobalContext, OpenAPI3 } from \"../types.js\";\nimport { FirstSchemaNameRecorder } from \"./discriminator-enum-names.js\";\nimport { documentDeclarations, type TransformedDocument } from \"./document-declarations.js\";\nimport { excludedValuesWarning } from \"./enum-values-warnings.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\nimport { ContextFooterSink } from \"./footer-sink.js\";\nimport type { RunContext } from \"./run-context.js\";\nimport { createTransformContext } from \"./transform-context.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/** Whether a footer entry is named `operations` (any declaration kind, as in the original). */\nfunction isOperations(entry: FooterEntry): boolean {\n  const name = isIrDeclaration(entry)\n    ? (entry as { name?: string }).name\n    : (entry as Partial<ts.InterfaceDeclaration>).name?.escapedText;\n  return name === OPERATIONS_NAME;\n}\n\n/** Drops a message: the first pass must not repeat the run's warnings or debug lines. */\nconst dropMessage = (): void => undefined;\nconst DROPPED_MESSAGES = { debug: dropMessage, warn: dropMessage, error: dropMessage };\n\n/** A shared enum name recorder of a first pass, and the names it gives the second. */\ninterface EnumNameRecorder extends SharedEnumNames {\n  chosenNames(): SharedEnumNames;\n}\n\n/**\n * The names of shared enums, known only at the end: a first pass transforms the document into a\n * scratch footer that `recorder` watches; its output is dropped. User callbacks run in both\n * passes. The `dedupe-enum-names` fix (ADR-021, upstream #1683) names an enum by all of its\n * schemas; `discriminator-values` keeps the first declaring schema's name\n * (`FirstSchemaNameRecorder`).\n */\nfunction sharedEnumNamesOf(\n  document: DocumentObject,\n  ctx: RunContext,\n  recorder: EnumNameRecorder,\n): SharedEnumNames {\n  const injectFooter: FooterEntry[] = [];\n  const scratch: RunContext = {\n    ...ctx,\n    injectFooter,\n    runFooter: new RunFooter(new ContextFooterSink(injectFooter), true, recorder),\n    logger: DROPPED_MESSAGES,\n    legacyCallbackWarnings: new Set(),\n  };\n  const scratchContext = createTransformContext(scratch);\n  documentBody(document, scratchContext, () => injectFooter.filter(isIrDeclaration));\n  return recorder.chosenNames();\n}\n\n/** The recorder of the run's fixes, or null where the first schema's name needs no first pass. */\nfunction enumNameRecorderOf(ctx: GlobalContext): EnumNameRecorder | null {\n  if (ctx.fix?.includes(FIX.DEDUPE_ENUM_NAMES)) {\n    return new SharedEnumNameRecorder();\n  }\n  return ctx.fix?.includes(FIX.DISCRIMINATOR_VALUES) ? new FirstSchemaNameRecorder() : null;\n}\n\n/** With a naming fix, `--enum` and `--dedupe-enums`, the run's footer names shared enums. */\nfunction withSharedEnumNames(document: DocumentObject, ctx: RunContext): void {\n  const recorder = ctx.runFooter === undefined ? enumNameRecorderOf(ctx) : null;\n  if (recorder === null || !ctx.enum || !ctx.dedupeEnums) {\n    return;\n  }\n  const names = sharedEnumNamesOf(document, ctx, recorder);\n  ctx.runFooter = new RunFooter(new ContextFooterSink(ctx.injectFooter), true, names);\n}\n\n/**\n * With `--enum-values`, arrays whose location type does not hold their values are typed by their\n * values (ADR-027); a location that excludes listed values is a contradiction of the document.\n */\nfunction enumValuesChecked(\n  body: readonly IrDeclaration[],\n  footer: FooterEntry[],\n  ctx: RunContext,\n): FooterEntry[] {\n  if (!ctx.enumValues) {\n    return footer;\n  }\n  const checked = checkedEnumValues(footer, body, isIrDeclaration);\n  for (const retype of checked.retyped) {\n    if (retype.kind === \"excluded\") {\n      ctx.logger?.warn(excludedValuesWarning(retype.name, retype.excluded));\n    }\n  }\n  return checked.footer;\n}\n\n/** @internal Root types, the footer, then the closing declarations (Phase 5, step 6). */\nexport function transformDocument(schema: OpenAPI3, ctx: RunContext): TransformedDocument {\n  const document = schema as DocumentObject;\n  withSharedEnumNames(document, ctx);\n  const context = createTransformContext(ctx);\n  // documentBody registers the enums in the footer, so the footer is read after it.\n  const rawBody = documentBody(document, context, () => ctx.injectFooter.filter(isIrDeclaration));\n  const footer = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);\n  const closing = documentClosing(document, context, footer.some(isOperations));\n  const body = renameTakenAliases(rawBody, footer.filter(isIrDeclaration), closing);\n  return { body, footer, closing };\n}\n\n/**\n * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same\n * for a loaded document.\n */\nexport default function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclaration[] {\n  return documentDeclarations(transformDocument(schema, ctx));\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"transform-schema.mjs","sources":["../../src/api/transform-schema.ts"],"sourcesContent":["import type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { documentBody, documentClosing } from \"../application/transform/document/document.js\";\nimport {\n  NAMES_THE_OUTPUT_MAY_NEED,\n  namesTheOutputNeeds,\n  withEnumsRenamed,\n} from \"../application/transform/document/enum-names-given-back.js\";\nimport { operationKeysWritten } from \"../application/transform/document/operation-keys-written.js\";\nimport {\n  unmatchedTemplateKeys,\n  withTemplatePathRefs,\n} from \"../application/transform/document/path-template-refs.js\";\nimport { renameTakenAliases } from \"../application/transform/document/root-type-aliases.js\";\nimport { RunFooter, type RunFooterNames } from \"../application/transform/footer/document-footer.js\";\nimport { EnumNameClaims } from \"../application/transform/footer/enum-name-claims.js\";\nimport { checkedEnumValues } from \"../application/transform/footer/enum-values-check.js\";\nimport { OperationKeys } from \"../application/transform/footer/operation-keys.js\";\nimport {\n  FIRST_SCHEMA_NAMES,\n  SharedEnumNameRecorder,\n  type SharedEnumNames,\n} from \"../application/transform/footer/shared-enum-names.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { DocumentObject } from \"../domain/openapi/document-object.js\";\nimport { schemaDialectOf } from \"../domain/openapi/schema-dialect.js\";\nimport { FIX } from \"../domain/output-fixes.js\";\nimport type { GlobalContext, OpenAPI3 } from \"../types.js\";\nimport { FirstSchemaNameRecorder } from \"./discriminator-enum-names.js\";\nimport { documentDeclarations, type TransformedDocument } from \"./document-declarations.js\";\nimport { excludedValuesWarning } from \"./enum-values-warnings.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\nimport { ContextFooterSink } from \"./footer-sink.js\";\nimport type { RunContext } from \"./run-context.js\";\nimport { createTransformContext } from \"./transform-context.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/** Whether a footer entry is named `operations` (any declaration kind, as in the original). */\nfunction isOperations(entry: FooterEntry): boolean {\n  const name = isIrDeclaration(entry)\n    ? (entry as { name?: string }).name\n    : (entry as Partial<ts.InterfaceDeclaration>).name?.escapedText;\n  return name === OPERATIONS_NAME;\n}\n\n/** Drops a message: the first pass must not repeat the run's warnings or debug lines. */\nconst dropMessage = (): void => undefined;\nconst DROPPED_MESSAGES = { debug: dropMessage, warn: dropMessage, error: dropMessage };\n\n/** A shared enum name recorder of a first pass, and the names it gives the second. */\ninterface EnumNameRecorder extends SharedEnumNames {\n  chosenNames(): SharedEnumNames;\n}\n\n/**\n * The names of shared enums, known only at the end: a first pass transforms the document into a\n * scratch footer that `recorder` watches; its output is dropped. User callbacks run in both\n * passes. The `dedupe-enum-names` fix (ADR-021, upstream #1683) names an enum by all of its\n * schemas; `discriminator-values` keeps the first declaring schema's name\n * (`FirstSchemaNameRecorder`).\n */\nfunction sharedEnumNamesOf(\n  document: DocumentObject,\n  ctx: RunContext,\n  recorder: EnumNameRecorder,\n): SharedEnumNames {\n  const injectFooter: FooterEntry[] = [];\n  const scratch: RunContext = {\n    ...ctx,\n    injectFooter,\n    runFooter: new RunFooter(new ContextFooterSink(injectFooter), true, recorder),\n    logger: DROPPED_MESSAGES,\n    legacyCallbackWarnings: new Set(),\n  };\n  const scratchContext = createTransformContext(scratch);\n  documentBody(document, scratchContext, () => injectFooter.filter(isIrDeclaration));\n  return recorder.chosenNames();\n}\n\n/** The recorder of the run's fixes, or null where the first schema's name needs no first pass. */\nfunction enumNameRecorderOf(ctx: GlobalContext): EnumNameRecorder | null {\n  if (ctx.fix?.includes(FIX.DEDUPE_ENUM_NAMES)) {\n    return new SharedEnumNameRecorder();\n  }\n  return ctx.fix?.includes(FIX.DISCRIMINATOR_VALUES) ? new FirstSchemaNameRecorder() : null;\n}\n\n/**\n * The run's footer: with a naming fix, `--enum` and `--dedupe-enums` it names shared enums. A\n * footer that a call before created on the context is kept.\n */\nfunction withRunFooter(document: DocumentObject, ctx: RunContext, names: RunFooterNames): void {\n  if (ctx.runFooter !== undefined) {\n    return;\n  }\n  const recorder = enumNameRecorderOf(ctx);\n  const shared =\n    recorder === null || !ctx.enum || !ctx.dedupeEnums\n      ? null\n      : sharedEnumNamesOf(document, ctx, recorder);\n  const sink = new ContextFooterSink(ctx.injectFooter);\n  ctx.runFooter =\n    shared === null\n      ? new RunFooter(sink, ctx.dedupeEnums, FIRST_SCHEMA_NAMES, names)\n      : new RunFooter(sink, true, shared, names);\n}\n\n/**\n * The document with the enums renamed that gave way to a name the output turned out not to need\n * (`EnumNameClaims`): they get that name back, as before.\n */\nfunction withEnumNamesGivenBack(\n  parts: TransformedDocument,\n  names: RunFooterNames,\n): TransformedDocument {\n  const footer = parts.footer.filter(isIrDeclaration);\n  const renames = names.enums.givenBack(namesTheOutputNeeds({ ...parts, footer }));\n  if (renames.size === 0) {\n    return parts;\n  }\n  return {\n    body: withEnumsRenamed(parts.body, renames),\n    footer: parts.footer.map((entry) =>\n      isIrDeclaration(entry) ? (withEnumsRenamed([entry], renames)[0] ?? entry) : entry,\n    ),\n    closing: withEnumsRenamed(parts.closing, renames),\n  };\n}\n\n/**\n * With `--enum-values`, arrays whose location type does not hold their values are typed by their\n * values (ADR-027); a location that excludes listed values is a contradiction of the document.\n */\nfunction enumValuesChecked(\n  body: readonly IrDeclaration[],\n  footer: FooterEntry[],\n  ctx: RunContext,\n): FooterEntry[] {\n  if (!ctx.enumValues) {\n    return footer;\n  }\n  const checked = checkedEnumValues(footer, body, isIrDeclaration);\n  for (const retype of checked.retyped) {\n    if (retype.kind === \"excluded\") {\n      ctx.logger?.warn(excludedValuesWarning(retype.name, retype.excluded));\n    }\n  }\n  return checked.footer;\n}\n\n/** The document with its references into templated paths indexed by their templates. */\nfunction withTemplateRefs(\n  { body, footer, closing }: TransformedDocument,\n  keys: ReadonlyMap<string, string>,\n): TransformedDocument {\n  return {\n    body: withTemplatePathRefs(body, keys),\n    footer: footer.map((entry) =>\n      isIrDeclaration(entry) ? (withTemplatePathRefs([entry], keys)[0] ?? entry) : entry,\n    ),\n    closing: withTemplatePathRefs(closing, keys),\n  };\n}\n\n/** @internal Root types, the footer, then the closing declarations (Phase 5, step 6). */\nexport function transformDocument(schema: OpenAPI3, ctx: RunContext): TransformedDocument {\n  const document = schema as DocumentObject;\n  ctx.schemaDialect = schemaDialectOf(document.openapi);\n  const names: RunFooterNames = {\n    enums: new EnumNameClaims(NAMES_THE_OUTPUT_MAY_NEED),\n    operations: new OperationKeys(operationKeysWritten(document)),\n  };\n  withRunFooter(document, ctx, names);\n  const context = createTransformContext(ctx);\n  // documentBody registers the enums in the footer, so the footer is read after it.\n  const rawBody = documentBody(document, context, () => ctx.injectFooter.filter(isIrDeclaration));\n  const rawFooter = enumValuesChecked(rawBody, [...ctx.injectFooter], ctx);\n  const rawClosing = documentClosing(document, context, rawFooter.some(isOperations));\n  const parts = { body: rawBody, footer: rawFooter, closing: rawClosing };\n  const { body, footer, closing } = withEnumNamesGivenBack(parts, names);\n  const named = { body: renameTakenAliases(body, footer.filter(isIrDeclaration), closing), footer };\n  return withTemplateRefs({ ...named, closing }, unmatchedTemplateKeys(document.paths, context));\n}\n\n/**\n * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same\n * for a loaded document.\n */\nexport default function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclaration[] {\n  return documentDeclarations(transformDocument(schema, ctx));\n}\n"],"names":[],"mappings":"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"}

package/dist/application/print/text-writer.cjs

@@ -9,7 +9,12 @@ function isLineBreak(code) {
 }
 class TextWriter {
   #options;
-  #output = "";
+  /**
+   * The written parts, joined once at the end. A string built with `+=` is kept by V8 as a tree
+   * of its parts, several times the size of the text, for as long as the text is kept (until the
+   * CLI writes it); `join` gives one flat string.
+   */
+  #parts = [];
   #indent = 0;
   #isAtLineStart = true;
   constructor(options) {
@@ -22,7 +27,9 @@ class TextWriter {
     return this.#options;
   }
   get text() {
-    return this.#output;
+    const text = this.#parts.join("");
+    this.#parts = [text];
+    return text;
   }
   increaseIndent() {
     this.#indent++;
@@ -40,7 +47,7 @@ class TextWriter {
   }
   /** Write text exactly as given. */
   rawWrite(text) {
-    this.#output += text;
+    this.#parts.push(text);
     this.#updateLineStart(text);
   }
   /** End the current line; does nothing when nothing has been written on it yet. */

package/dist/application/print/text-writer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"text-writer.cjs","sources":["../../../src/application/print/text-writer.ts"],"sourcesContent":["import type { PrintOptions } from \"./print-options.js\";\n\nconst LINE_FEED = 0x0a;\nconst CARRIAGE_RETURN = 0x0d;\nconst LINE_SEPARATOR = 0x2028;\nconst PARAGRAPH_SEPARATOR = 0x2029;\n\n/** Line breaks as the TypeScript scanner defines them (`isLineBreak`). */\nexport function isLineBreak(code: number): boolean {\n  return (\n    code === LINE_FEED ||\n    code === CARRIAGE_RETURN ||\n    code === LINE_SEPARATOR ||\n    code === PARAGRAPH_SEPARATOR\n  );\n}\n\n/**\n * Output buffer with indentation, modeled on the TypeScript printer's text writer: `write` indents\n * text that starts a line, `rawWrite` never does, and `writeLine` does nothing at the start of a\n * line. Matching these rules is what makes comment re-indentation byte-identical to the original.\n */\nexport class TextWriter {\n  readonly #options: PrintOptions;\n  #output = \"\";\n  #indent = 0;\n  #isAtLineStart = true;\n\n  constructor(options: PrintOptions) {\n    this.#options = options;\n  }\n\n  get indent(): number {\n    return this.#indent;\n  }\n\n  get options(): PrintOptions {\n    return this.#options;\n  }\n\n  get text(): string {\n    return this.#output;\n  }\n\n  increaseIndent(): void {\n    this.#indent++;\n  }\n\n  decreaseIndent(): void {\n    this.#indent--;\n  }\n\n  /** Write text, indenting it first when it starts a line. */\n  write(text: string): void {\n    if (text.length === 0) {\n      return;\n    }\n    const prefix = this.#isAtLineStart ? this.indentString(this.#indent) : \"\";\n    this.rawWrite(prefix + text);\n  }\n\n  /** Write text exactly as given. */\n  rawWrite(text: string): void {\n    this.#output += text;\n    this.#updateLineStart(text);\n  }\n\n  /** End the current line; does nothing when nothing has been written on it yet. */\n  writeLine(): void {\n    if (!this.#isAtLineStart) {\n      this.rawWrite(this.#options.newLine);\n    }\n  }\n\n  indentString(level: number): string {\n    return \" \".repeat(level * this.#options.indentSize);\n  }\n\n  // Like TypeScript: any write leaves the writer mid-line unless the text ends with a line break.\n  #updateLineStart(text: string): void {\n    this.#isAtLineStart = text.length > 0 && isLineBreak(text.charCodeAt(text.length - 1));\n  }\n}\n"],"names":[],"mappings":";;AAEA,MAAM,SAAA,GAAY,EAAA;AAClB,MAAM,eAAA,GAAkB,EAAA;AACxB,MAAM,cAAA,GAAiB,IAAA;AACvB,MAAM,mBAAA,GAAsB,IAAA;AAGrB,SAAS,YAAY,IAAA,EAAuB;AACjD,EAAA,OACE,SAAS,SAAA,IACT,IAAA,KAAS,eAAA,IACT,IAAA,KAAS,kBACT,IAAA,KAAS,mBAAA;AAEb;AAOO,MAAM,UAAA,CAAW;AAAA,EACb,QAAA;AAAA,EACT,OAAA,GAAU,EAAA;AAAA,EACV,OAAA,GAAU,CAAA;AAAA,EACV,cAAA,GAAiB,IAAA;AAAA,EAEjB,YAAY,OAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAAA,EAClB;AAAA,EAEA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,IAAI,OAAA,GAAwB;AAC1B,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA;AAAA,EAGA,MAAM,IAAA,EAAoB;AACxB,IAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACrB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAS,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,IAAA,CAAK,OAAO,CAAA,GAAI,EAAA;AACvE,IAAA,IAAA,CAAK,QAAA,CAAS,SAAS,IAAI,CAAA;AAAA,EAC7B;AAAA;AAAA,EAGA,SAAS,IAAA,EAAoB;AAC3B,IAAA,IAAA,CAAK,OAAA,IAAW,IAAA;AAChB,IAAA,IAAA,CAAK,iBAAiB,IAAI,CAAA;AAAA,EAC5B;AAAA;AAAA,EAGA,SAAA,GAAkB;AAChB,IAAA,IAAI,CAAC,KAAK,cAAA,EAAgB;AACxB,MAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA;AAAA,IACrC;AAAA,EACF;AAAA,EAEA,aAAa,KAAA,EAAuB;AAClC,IAAA,OAAO,GAAA,CAAI,MAAA,CAAO,KAAA,GAAQ,IAAA,CAAK,SAAS,UAAU,CAAA;AAAA,EACpD;AAAA;AAAA,EAGA,iBAAiB,IAAA,EAAoB;AACnC,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA,CAAK,MAAA,GAAS,CAAA,IAAK,WAAA,CAAY,KAAK,UAAA,CAAW,IAAA,CAAK,MAAA,GAAS,CAAC,CAAC,CAAA;AAAA,EACvF;AACF;;;"}
+{"version":3,"file":"text-writer.cjs","sources":["../../../src/application/print/text-writer.ts"],"sourcesContent":["import type { PrintOptions } from \"./print-options.js\";\n\nconst LINE_FEED = 0x0a;\nconst CARRIAGE_RETURN = 0x0d;\nconst LINE_SEPARATOR = 0x2028;\nconst PARAGRAPH_SEPARATOR = 0x2029;\n\n/** Line breaks as the TypeScript scanner defines them (`isLineBreak`). */\nexport function isLineBreak(code: number): boolean {\n  return (\n    code === LINE_FEED ||\n    code === CARRIAGE_RETURN ||\n    code === LINE_SEPARATOR ||\n    code === PARAGRAPH_SEPARATOR\n  );\n}\n\n/**\n * Output buffer with indentation, modeled on the TypeScript printer's text writer: `write` indents\n * text that starts a line, `rawWrite` never does, and `writeLine` does nothing at the start of a\n * line. Matching these rules is what makes comment re-indentation byte-identical to the original.\n */\nexport class TextWriter {\n  readonly #options: PrintOptions;\n  /**\n   * The written parts, joined once at the end. A string built with `+=` is kept by V8 as a tree\n   * of its parts, several times the size of the text, for as long as the text is kept (until the\n   * CLI writes it); `join` gives one flat string.\n   */\n  #parts: string[] = [];\n  #indent = 0;\n  #isAtLineStart = true;\n\n  constructor(options: PrintOptions) {\n    this.#options = options;\n  }\n\n  get indent(): number {\n    return this.#indent;\n  }\n\n  get options(): PrintOptions {\n    return this.#options;\n  }\n\n  get text(): string {\n    const text = this.#parts.join(\"\");\n    this.#parts = [text];\n    return text;\n  }\n\n  increaseIndent(): void {\n    this.#indent++;\n  }\n\n  decreaseIndent(): void {\n    this.#indent--;\n  }\n\n  /** Write text, indenting it first when it starts a line. */\n  write(text: string): void {\n    if (text.length === 0) {\n      return;\n    }\n    const prefix = this.#isAtLineStart ? this.indentString(this.#indent) : \"\";\n    this.rawWrite(prefix + text);\n  }\n\n  /** Write text exactly as given. */\n  rawWrite(text: string): void {\n    this.#parts.push(text);\n    this.#updateLineStart(text);\n  }\n\n  /** End the current line; does nothing when nothing has been written on it yet. */\n  writeLine(): void {\n    if (!this.#isAtLineStart) {\n      this.rawWrite(this.#options.newLine);\n    }\n  }\n\n  indentString(level: number): string {\n    return \" \".repeat(level * this.#options.indentSize);\n  }\n\n  // Like TypeScript: any write leaves the writer mid-line unless the text ends with a line break.\n  #updateLineStart(text: string): void {\n    this.#isAtLineStart = text.length > 0 && isLineBreak(text.charCodeAt(text.length - 1));\n  }\n}\n"],"names":[],"mappings":";;AAEA,MAAM,SAAA,GAAY,EAAA;AAClB,MAAM,eAAA,GAAkB,EAAA;AACxB,MAAM,cAAA,GAAiB,IAAA;AACvB,MAAM,mBAAA,GAAsB,IAAA;AAGrB,SAAS,YAAY,IAAA,EAAuB;AACjD,EAAA,OACE,SAAS,SAAA,IACT,IAAA,KAAS,eAAA,IACT,IAAA,KAAS,kBACT,IAAA,KAAS,mBAAA;AAEb;AAOO,MAAM,UAAA,CAAW;AAAA,EACb,QAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,SAAmB,EAAC;AAAA,EACpB,OAAA,GAAU,CAAA;AAAA,EACV,cAAA,GAAiB,IAAA;AAAA,EAEjB,YAAY,OAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAAA,EAClB;AAAA,EAEA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,IAAI,OAAA,GAAwB;AAC1B,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,EAAE,CAAA;AAChC,IAAA,IAAA,CAAK,MAAA,GAAS,CAAC,IAAI,CAAA;AACnB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA;AAAA,EAGA,MAAM,IAAA,EAAoB;AACxB,IAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACrB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAS,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,IAAA,CAAK,OAAO,CAAA,GAAI,EAAA;AACvE,IAAA,IAAA,CAAK,QAAA,CAAS,SAAS,IAAI,CAAA;AAAA,EAC7B;AAAA;AAAA,EAGA,SAAS,IAAA,EAAoB;AAC3B,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,IAAI,CAAA;AACrB,IAAA,IAAA,CAAK,iBAAiB,IAAI,CAAA;AAAA,EAC5B;AAAA;AAAA,EAGA,SAAA,GAAkB;AAChB,IAAA,IAAI,CAAC,KAAK,cAAA,EAAgB;AACxB,MAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA;AAAA,IACrC;AAAA,EACF;AAAA,EAEA,aAAa,KAAA,EAAuB;AAClC,IAAA,OAAO,GAAA,CAAI,MAAA,CAAO,KAAA,GAAQ,IAAA,CAAK,SAAS,UAAU,CAAA;AAAA,EACpD;AAAA;AAAA,EAGA,iBAAiB,IAAA,EAAoB;AACnC,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA,CAAK,MAAA,GAAS,CAAA,IAAK,WAAA,CAAY,KAAK,UAAA,CAAW,IAAA,CAAK,MAAA,GAAS,CAAC,CAAC,CAAA;AAAA,EACvF;AACF;;;"}

package/dist/application/print/text-writer.mjs

@@ -7,7 +7,12 @@ function isLineBreak(code) {
 }
 class TextWriter {
   #options;
-  #output = "";
+  /**
+   * The written parts, joined once at the end. A string built with `+=` is kept by V8 as a tree
+   * of its parts, several times the size of the text, for as long as the text is kept (until the
+   * CLI writes it); `join` gives one flat string.
+   */
+  #parts = [];
   #indent = 0;
   #isAtLineStart = true;
   constructor(options) {
@@ -20,7 +25,9 @@ class TextWriter {
     return this.#options;
   }
   get text() {
-    return this.#output;
+    const text = this.#parts.join("");
+    this.#parts = [text];
+    return text;
   }
   increaseIndent() {
     this.#indent++;
@@ -38,7 +45,7 @@ class TextWriter {
   }
   /** Write text exactly as given. */
   rawWrite(text) {
-    this.#output += text;
+    this.#parts.push(text);
     this.#updateLineStart(text);
   }
   /** End the current line; does nothing when nothing has been written on it yet. */

package/dist/application/print/text-writer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"text-writer.mjs","sources":["../../../src/application/print/text-writer.ts"],"sourcesContent":["import type { PrintOptions } from \"./print-options.js\";\n\nconst LINE_FEED = 0x0a;\nconst CARRIAGE_RETURN = 0x0d;\nconst LINE_SEPARATOR = 0x2028;\nconst PARAGRAPH_SEPARATOR = 0x2029;\n\n/** Line breaks as the TypeScript scanner defines them (`isLineBreak`). */\nexport function isLineBreak(code: number): boolean {\n  return (\n    code === LINE_FEED ||\n    code === CARRIAGE_RETURN ||\n    code === LINE_SEPARATOR ||\n    code === PARAGRAPH_SEPARATOR\n  );\n}\n\n/**\n * Output buffer with indentation, modeled on the TypeScript printer's text writer: `write` indents\n * text that starts a line, `rawWrite` never does, and `writeLine` does nothing at the start of a\n * line. Matching these rules is what makes comment re-indentation byte-identical to the original.\n */\nexport class TextWriter {\n  readonly #options: PrintOptions;\n  #output = \"\";\n  #indent = 0;\n  #isAtLineStart = true;\n\n  constructor(options: PrintOptions) {\n    this.#options = options;\n  }\n\n  get indent(): number {\n    return this.#indent;\n  }\n\n  get options(): PrintOptions {\n    return this.#options;\n  }\n\n  get text(): string {\n    return this.#output;\n  }\n\n  increaseIndent(): void {\n    this.#indent++;\n  }\n\n  decreaseIndent(): void {\n    this.#indent--;\n  }\n\n  /** Write text, indenting it first when it starts a line. */\n  write(text: string): void {\n    if (text.length === 0) {\n      return;\n    }\n    const prefix = this.#isAtLineStart ? this.indentString(this.#indent) : \"\";\n    this.rawWrite(prefix + text);\n  }\n\n  /** Write text exactly as given. */\n  rawWrite(text: string): void {\n    this.#output += text;\n    this.#updateLineStart(text);\n  }\n\n  /** End the current line; does nothing when nothing has been written on it yet. */\n  writeLine(): void {\n    if (!this.#isAtLineStart) {\n      this.rawWrite(this.#options.newLine);\n    }\n  }\n\n  indentString(level: number): string {\n    return \" \".repeat(level * this.#options.indentSize);\n  }\n\n  // Like TypeScript: any write leaves the writer mid-line unless the text ends with a line break.\n  #updateLineStart(text: string): void {\n    this.#isAtLineStart = text.length > 0 && isLineBreak(text.charCodeAt(text.length - 1));\n  }\n}\n"],"names":[],"mappings":"AAEA,MAAM,SAAA,GAAY,EAAA;AAClB,MAAM,eAAA,GAAkB,EAAA;AACxB,MAAM,cAAA,GAAiB,IAAA;AACvB,MAAM,mBAAA,GAAsB,IAAA;AAGrB,SAAS,YAAY,IAAA,EAAuB;AACjD,EAAA,OACE,SAAS,SAAA,IACT,IAAA,KAAS,eAAA,IACT,IAAA,KAAS,kBACT,IAAA,KAAS,mBAAA;AAEb;AAOO,MAAM,UAAA,CAAW;AAAA,EACb,QAAA;AAAA,EACT,OAAA,GAAU,EAAA;AAAA,EACV,OAAA,GAAU,CAAA;AAAA,EACV,cAAA,GAAiB,IAAA;AAAA,EAEjB,YAAY,OAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAAA,EAClB;AAAA,EAEA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,IAAI,OAAA,GAAwB;AAC1B,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA;AAAA,EAGA,MAAM,IAAA,EAAoB;AACxB,IAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACrB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAS,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,IAAA,CAAK,OAAO,CAAA,GAAI,EAAA;AACvE,IAAA,IAAA,CAAK,QAAA,CAAS,SAAS,IAAI,CAAA;AAAA,EAC7B;AAAA;AAAA,EAGA,SAAS,IAAA,EAAoB;AAC3B,IAAA,IAAA,CAAK,OAAA,IAAW,IAAA;AAChB,IAAA,IAAA,CAAK,iBAAiB,IAAI,CAAA;AAAA,EAC5B;AAAA;AAAA,EAGA,SAAA,GAAkB;AAChB,IAAA,IAAI,CAAC,KAAK,cAAA,EAAgB;AACxB,MAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA;AAAA,IACrC;AAAA,EACF;AAAA,EAEA,aAAa,KAAA,EAAuB;AAClC,IAAA,OAAO,GAAA,CAAI,MAAA,CAAO,KAAA,GAAQ,IAAA,CAAK,SAAS,UAAU,CAAA;AAAA,EACpD;AAAA;AAAA,EAGA,iBAAiB,IAAA,EAAoB;AACnC,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA,CAAK,MAAA,GAAS,CAAA,IAAK,WAAA,CAAY,KAAK,UAAA,CAAW,IAAA,CAAK,MAAA,GAAS,CAAC,CAAC,CAAA;AAAA,EACvF;AACF;;"}
+{"version":3,"file":"text-writer.mjs","sources":["../../../src/application/print/text-writer.ts"],"sourcesContent":["import type { PrintOptions } from \"./print-options.js\";\n\nconst LINE_FEED = 0x0a;\nconst CARRIAGE_RETURN = 0x0d;\nconst LINE_SEPARATOR = 0x2028;\nconst PARAGRAPH_SEPARATOR = 0x2029;\n\n/** Line breaks as the TypeScript scanner defines them (`isLineBreak`). */\nexport function isLineBreak(code: number): boolean {\n  return (\n    code === LINE_FEED ||\n    code === CARRIAGE_RETURN ||\n    code === LINE_SEPARATOR ||\n    code === PARAGRAPH_SEPARATOR\n  );\n}\n\n/**\n * Output buffer with indentation, modeled on the TypeScript printer's text writer: `write` indents\n * text that starts a line, `rawWrite` never does, and `writeLine` does nothing at the start of a\n * line. Matching these rules is what makes comment re-indentation byte-identical to the original.\n */\nexport class TextWriter {\n  readonly #options: PrintOptions;\n  /**\n   * The written parts, joined once at the end. A string built with `+=` is kept by V8 as a tree\n   * of its parts, several times the size of the text, for as long as the text is kept (until the\n   * CLI writes it); `join` gives one flat string.\n   */\n  #parts: string[] = [];\n  #indent = 0;\n  #isAtLineStart = true;\n\n  constructor(options: PrintOptions) {\n    this.#options = options;\n  }\n\n  get indent(): number {\n    return this.#indent;\n  }\n\n  get options(): PrintOptions {\n    return this.#options;\n  }\n\n  get text(): string {\n    const text = this.#parts.join(\"\");\n    this.#parts = [text];\n    return text;\n  }\n\n  increaseIndent(): void {\n    this.#indent++;\n  }\n\n  decreaseIndent(): void {\n    this.#indent--;\n  }\n\n  /** Write text, indenting it first when it starts a line. */\n  write(text: string): void {\n    if (text.length === 0) {\n      return;\n    }\n    const prefix = this.#isAtLineStart ? this.indentString(this.#indent) : \"\";\n    this.rawWrite(prefix + text);\n  }\n\n  /** Write text exactly as given. */\n  rawWrite(text: string): void {\n    this.#parts.push(text);\n    this.#updateLineStart(text);\n  }\n\n  /** End the current line; does nothing when nothing has been written on it yet. */\n  writeLine(): void {\n    if (!this.#isAtLineStart) {\n      this.rawWrite(this.#options.newLine);\n    }\n  }\n\n  indentString(level: number): string {\n    return \" \".repeat(level * this.#options.indentSize);\n  }\n\n  // Like TypeScript: any write leaves the writer mid-line unless the text ends with a line break.\n  #updateLineStart(text: string): void {\n    this.#isAtLineStart = text.length > 0 && isLineBreak(text.charCodeAt(text.length - 1));\n  }\n}\n"],"names":[],"mappings":"AAEA,MAAM,SAAA,GAAY,EAAA;AAClB,MAAM,eAAA,GAAkB,EAAA;AACxB,MAAM,cAAA,GAAiB,IAAA;AACvB,MAAM,mBAAA,GAAsB,IAAA;AAGrB,SAAS,YAAY,IAAA,EAAuB;AACjD,EAAA,OACE,SAAS,SAAA,IACT,IAAA,KAAS,eAAA,IACT,IAAA,KAAS,kBACT,IAAA,KAAS,mBAAA;AAEb;AAOO,MAAM,UAAA,CAAW;AAAA,EACb,QAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,SAAmB,EAAC;AAAA,EACpB,OAAA,GAAU,CAAA;AAAA,EACV,cAAA,GAAiB,IAAA;AAAA,EAEjB,YAAY,OAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAAA,EAClB;AAAA,EAEA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,IAAI,OAAA,GAAwB;AAC1B,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,EAAE,CAAA;AAChC,IAAA,IAAA,CAAK,MAAA,GAAS,CAAC,IAAI,CAAA;AACnB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA,EAEA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,OAAA,EAAA;AAAA,EACP;AAAA;AAAA,EAGA,MAAM,IAAA,EAAoB;AACxB,IAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACrB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAS,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,IAAA,CAAK,OAAO,CAAA,GAAI,EAAA;AACvE,IAAA,IAAA,CAAK,QAAA,CAAS,SAAS,IAAI,CAAA;AAAA,EAC7B;AAAA;AAAA,EAGA,SAAS,IAAA,EAAoB;AAC3B,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,IAAI,CAAA;AACrB,IAAA,IAAA,CAAK,iBAAiB,IAAI,CAAA;AAAA,EAC5B;AAAA;AAAA,EAGA,SAAA,GAAkB;AAChB,IAAA,IAAI,CAAC,KAAK,cAAA,EAAgB;AACxB,MAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA;AAAA,IACrC;AAAA,EACF;AAAA,EAEA,aAAa,KAAA,EAAuB;AAClC,IAAA,OAAO,GAAA,CAAI,MAAA,CAAO,KAAA,GAAQ,IAAA,CAAK,SAAS,UAAU,CAAA;AAAA,EACpD;AAAA;AAAA,EAGA,iBAAiB,IAAA,EAAoB;AACnC,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA,CAAK,MAAA,GAAS,CAAA,IAAK,WAAA,CAAY,KAAK,UAAA,CAAW,IAAA,CAAK,MAAA,GAAS,CAAC,CAAC,CAAA;AAAA,EACvF;AACF;;"}

package/dist/application/stack-overflow.cjs

@@ -7,9 +7,10 @@ function isStackOverflowError(error) {
   return error instanceof RangeError && STACK_OVERFLOW_MESSAGE.test(error.message);
 }
 function schemaTooDeepError(step, cause) {
+  const wide = step === "load" ? ", and so does an object with more than about 100,000 keys" : "";
   return new errors.OpenAPITypesafeError({
     code: errors.ERROR_CODES.SCHEMA_TOO_DEEP,
-    message: `The schema is nested too deeply to ${step}: the call stack ran out. Both inline schemas and chains of $ref (each schema referring to the next) count; shorten the deepest.`,
+    message: `The schema is nested too deeply to ${step}: the call stack ran out. Both inline schemas and chains of $ref (each schema referring to the next) count${wide}; shorten the deepest.`,
     details: { step },
     cause
   });

package/dist/application/stack-overflow.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"stack-overflow.cjs","sources":["../../src/application/stack-overflow.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../domain/errors.js\";\n\n/**\n * Deeply nested schemas (ENGINEERING_PLAN 8.5). Loading, bundling, transforming and printing walk\n * schemas recursively, and Redocly follows each `$ref` inside the walk. On the default Node.js\n * stack, about 550 levels of inline schemas or a chain of about 900 `$ref`s (each schema refers to\n * the next) run out of call stack. Real documents stay far below: every YAML or JSON file goes\n * through the YAML parser, which stops at 100 levels, and the whole corpus passes. The overflow is\n * reported as a typed error instead of a `RangeError` with a stack trace.\n */\n\n/** The step that ran out of call stack; named in the message and the details. */\nexport type DeepSchemaStep = \"load\" | \"transform\" | \"print\";\n\n/** V8 and JavaScriptCore (Node.js, Deno, Bun) throw a `RangeError` with this message. */\nconst STACK_OVERFLOW_MESSAGE = /maximum call stack size exceeded/i;\n\n/** Whether a thrown value is a call stack overflow. */\nexport function isStackOverflowError(error: unknown): boolean {\n  return error instanceof RangeError && STACK_OVERFLOW_MESSAGE.test(error.message);\n}\n\n/** The typed error for a document nested too deeply for the call stack. */\nexport function schemaTooDeepError(step: DeepSchemaStep, cause: unknown): OpenAPITypesafeError {\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_TOO_DEEP,\n    message:\n      `The schema is nested too deeply to ${step}: the call stack ran out. Both inline ` +\n      \"schemas and chains of $ref (each schema referring to the next) count; shorten the deepest.\",\n    details: { step },\n    cause,\n  });\n}\n\n/** Run a step and report a stack overflow in it as SCHEMA_TOO_DEEP; other errors pass through. */\nexport function withStackOverflowReported<T>(step: DeepSchemaStep, run: () => T): T {\n  try {\n    return run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n\n/** The asynchronous form of `withStackOverflowReported`. */\nexport async function withStackOverflowReportedAsync<T>(\n  step: DeepSchemaStep,\n  run: () => Promise<T>,\n): Promise<T> {\n  try {\n    return await run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES"],"mappings":";;;;AAeA,MAAM,sBAAA,GAAyB,mCAAA;AAGxB,SAAS,qBAAqB,KAAA,EAAyB;AAC5D,EAAA,OAAO,KAAA,YAAiB,UAAA,IAAc,sBAAA,CAAuB,IAAA,CAAK,MAAM,OAAO,CAAA;AACjF;AAGO,SAAS,kBAAA,CAAmB,MAAsB,KAAA,EAAsC;AAC7F,EAAA,OAAO,IAAIA,2BAAA,CAAqB;AAAA,IAC9B,MAAMC,kBAAA,CAAY,eAAA;AAAA,IAClB,OAAA,EACE,sCAAsC,IAAI,CAAA,gIAAA,CAAA;AAAA,IAE5C,OAAA,EAAS,EAAE,IAAA,EAAK;AAAA,IAChB;AAAA,GACD,CAAA;AACH;AAGO,SAAS,yBAAA,CAA6B,MAAsB,GAAA,EAAiB;AAClF,EAAA,IAAI;AACF,IAAA,OAAO,GAAA,EAAI;AAAA,EACb,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;AAGA,eAAsB,8BAAA,CACpB,MACA,GAAA,EACY;AACZ,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,GAAA,EAAI;AAAA,EACnB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;;;;;"}
+{"version":3,"file":"stack-overflow.cjs","sources":["../../src/application/stack-overflow.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../domain/errors.js\";\n\n/**\n * Deeply nested schemas (ENGINEERING_PLAN 8.5). Loading, bundling, transforming and printing walk\n * schemas recursively, and Redocly follows each `$ref` inside the walk. On the default Node.js\n * stack, about 550 levels of inline schemas or a chain of about 900 `$ref`s (each schema refers to\n * the next) run out of call stack. Redocly's walk also passes the keys of an object to one call as\n * arguments, so a single object with more than about 100,000 keys runs out of it while loading.\n * Real documents stay far below: every YAML or JSON file goes through the YAML parser, which stops\n * at 100 levels, and the whole corpus passes. The overflow is reported as a typed error instead of\n * a `RangeError` with a stack trace.\n */\n\n/** The step that ran out of call stack; named in the message and the details. */\nexport type DeepSchemaStep = \"load\" | \"transform\" | \"print\";\n\n/** V8 and JavaScriptCore (Node.js, Deno, Bun) throw a `RangeError` with this message. */\nconst STACK_OVERFLOW_MESSAGE = /maximum call stack size exceeded/i;\n\n/** Whether a thrown value is a call stack overflow. */\nexport function isStackOverflowError(error: unknown): boolean {\n  return error instanceof RangeError && STACK_OVERFLOW_MESSAGE.test(error.message);\n}\n\n/** The typed error for a document nested too deeply, or too wide, for the call stack. */\nexport function schemaTooDeepError(step: DeepSchemaStep, cause: unknown): OpenAPITypesafeError {\n  const wide = step === \"load\" ? \", and so does an object with more than about 100,000 keys\" : \"\";\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_TOO_DEEP,\n    message:\n      `The schema is nested too deeply to ${step}: the call stack ran out. Both inline ` +\n      `schemas and chains of $ref (each schema referring to the next) count${wide}; shorten ` +\n      \"the deepest.\",\n    details: { step },\n    cause,\n  });\n}\n\n/** Run a step and report a stack overflow in it as SCHEMA_TOO_DEEP; other errors pass through. */\nexport function withStackOverflowReported<T>(step: DeepSchemaStep, run: () => T): T {\n  try {\n    return run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n\n/** The asynchronous form of `withStackOverflowReported`. */\nexport async function withStackOverflowReportedAsync<T>(\n  step: DeepSchemaStep,\n  run: () => Promise<T>,\n): Promise<T> {\n  try {\n    return await run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES"],"mappings":";;;;AAiBA,MAAM,sBAAA,GAAyB,mCAAA;AAGxB,SAAS,qBAAqB,KAAA,EAAyB;AAC5D,EAAA,OAAO,KAAA,YAAiB,UAAA,IAAc,sBAAA,CAAuB,IAAA,CAAK,MAAM,OAAO,CAAA;AACjF;AAGO,SAAS,kBAAA,CAAmB,MAAsB,KAAA,EAAsC;AAC7F,EAAA,MAAM,IAAA,GAAO,IAAA,KAAS,MAAA,GAAS,2DAAA,GAA8D,EAAA;AAC7F,EAAA,OAAO,IAAIA,2BAAA,CAAqB;AAAA,IAC9B,MAAMC,kBAAA,CAAY,eAAA;AAAA,IAClB,OAAA,EACE,CAAA,mCAAA,EAAsC,IAAI,CAAA,0GAAA,EAC6B,IAAI,CAAA,sBAAA,CAAA;AAAA,IAE7E,OAAA,EAAS,EAAE,IAAA,EAAK;AAAA,IAChB;AAAA,GACD,CAAA;AACH;AAGO,SAAS,yBAAA,CAA6B,MAAsB,GAAA,EAAiB;AAClF,EAAA,IAAI;AACF,IAAA,OAAO,GAAA,EAAI;AAAA,EACb,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;AAGA,eAAsB,8BAAA,CACpB,MACA,GAAA,EACY;AACZ,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,GAAA,EAAI;AAAA,EACnB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;;;;;"}

package/dist/application/stack-overflow.mjs

@@ -5,9 +5,10 @@ function isStackOverflowError(error) {
   return error instanceof RangeError && STACK_OVERFLOW_MESSAGE.test(error.message);
 }
 function schemaTooDeepError(step, cause) {
+  const wide = step === "load" ? ", and so does an object with more than about 100,000 keys" : "";
   return new OpenAPITypesafeError({
     code: ERROR_CODES.SCHEMA_TOO_DEEP,
-    message: `The schema is nested too deeply to ${step}: the call stack ran out. Both inline schemas and chains of $ref (each schema referring to the next) count; shorten the deepest.`,
+    message: `The schema is nested too deeply to ${step}: the call stack ran out. Both inline schemas and chains of $ref (each schema referring to the next) count${wide}; shorten the deepest.`,
     details: { step },
     cause
   });

package/dist/application/stack-overflow.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stack-overflow.mjs","sources":["../../src/application/stack-overflow.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../domain/errors.js\";\n\n/**\n * Deeply nested schemas (ENGINEERING_PLAN 8.5). Loading, bundling, transforming and printing walk\n * schemas recursively, and Redocly follows each `$ref` inside the walk. On the default Node.js\n * stack, about 550 levels of inline schemas or a chain of about 900 `$ref`s (each schema refers to\n * the next) run out of call stack. Real documents stay far below: every YAML or JSON file goes\n * through the YAML parser, which stops at 100 levels, and the whole corpus passes. The overflow is\n * reported as a typed error instead of a `RangeError` with a stack trace.\n */\n\n/** The step that ran out of call stack; named in the message and the details. */\nexport type DeepSchemaStep = \"load\" | \"transform\" | \"print\";\n\n/** V8 and JavaScriptCore (Node.js, Deno, Bun) throw a `RangeError` with this message. */\nconst STACK_OVERFLOW_MESSAGE = /maximum call stack size exceeded/i;\n\n/** Whether a thrown value is a call stack overflow. */\nexport function isStackOverflowError(error: unknown): boolean {\n  return error instanceof RangeError && STACK_OVERFLOW_MESSAGE.test(error.message);\n}\n\n/** The typed error for a document nested too deeply for the call stack. */\nexport function schemaTooDeepError(step: DeepSchemaStep, cause: unknown): OpenAPITypesafeError {\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_TOO_DEEP,\n    message:\n      `The schema is nested too deeply to ${step}: the call stack ran out. Both inline ` +\n      \"schemas and chains of $ref (each schema referring to the next) count; shorten the deepest.\",\n    details: { step },\n    cause,\n  });\n}\n\n/** Run a step and report a stack overflow in it as SCHEMA_TOO_DEEP; other errors pass through. */\nexport function withStackOverflowReported<T>(step: DeepSchemaStep, run: () => T): T {\n  try {\n    return run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n\n/** The asynchronous form of `withStackOverflowReported`. */\nexport async function withStackOverflowReportedAsync<T>(\n  step: DeepSchemaStep,\n  run: () => Promise<T>,\n): Promise<T> {\n  try {\n    return await run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n"],"names":[],"mappings":";;AAeA,MAAM,sBAAA,GAAyB,mCAAA;AAGxB,SAAS,qBAAqB,KAAA,EAAyB;AAC5D,EAAA,OAAO,KAAA,YAAiB,UAAA,IAAc,sBAAA,CAAuB,IAAA,CAAK,MAAM,OAAO,CAAA;AACjF;AAGO,SAAS,kBAAA,CAAmB,MAAsB,KAAA,EAAsC;AAC7F,EAAA,OAAO,IAAI,oBAAA,CAAqB;AAAA,IAC9B,MAAM,WAAA,CAAY,eAAA;AAAA,IAClB,OAAA,EACE,sCAAsC,IAAI,CAAA,gIAAA,CAAA;AAAA,IAE5C,OAAA,EAAS,EAAE,IAAA,EAAK;AAAA,IAChB;AAAA,GACD,CAAA;AACH;AAGO,SAAS,yBAAA,CAA6B,MAAsB,GAAA,EAAiB;AAClF,EAAA,IAAI;AACF,IAAA,OAAO,GAAA,EAAI;AAAA,EACb,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;AAGA,eAAsB,8BAAA,CACpB,MACA,GAAA,EACY;AACZ,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,GAAA,EAAI;AAAA,EACnB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;;"}
+{"version":3,"file":"stack-overflow.mjs","sources":["../../src/application/stack-overflow.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../domain/errors.js\";\n\n/**\n * Deeply nested schemas (ENGINEERING_PLAN 8.5). Loading, bundling, transforming and printing walk\n * schemas recursively, and Redocly follows each `$ref` inside the walk. On the default Node.js\n * stack, about 550 levels of inline schemas or a chain of about 900 `$ref`s (each schema refers to\n * the next) run out of call stack. Redocly's walk also passes the keys of an object to one call as\n * arguments, so a single object with more than about 100,000 keys runs out of it while loading.\n * Real documents stay far below: every YAML or JSON file goes through the YAML parser, which stops\n * at 100 levels, and the whole corpus passes. The overflow is reported as a typed error instead of\n * a `RangeError` with a stack trace.\n */\n\n/** The step that ran out of call stack; named in the message and the details. */\nexport type DeepSchemaStep = \"load\" | \"transform\" | \"print\";\n\n/** V8 and JavaScriptCore (Node.js, Deno, Bun) throw a `RangeError` with this message. */\nconst STACK_OVERFLOW_MESSAGE = /maximum call stack size exceeded/i;\n\n/** Whether a thrown value is a call stack overflow. */\nexport function isStackOverflowError(error: unknown): boolean {\n  return error instanceof RangeError && STACK_OVERFLOW_MESSAGE.test(error.message);\n}\n\n/** The typed error for a document nested too deeply, or too wide, for the call stack. */\nexport function schemaTooDeepError(step: DeepSchemaStep, cause: unknown): OpenAPITypesafeError {\n  const wide = step === \"load\" ? \", and so does an object with more than about 100,000 keys\" : \"\";\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_TOO_DEEP,\n    message:\n      `The schema is nested too deeply to ${step}: the call stack ran out. Both inline ` +\n      `schemas and chains of $ref (each schema referring to the next) count${wide}; shorten ` +\n      \"the deepest.\",\n    details: { step },\n    cause,\n  });\n}\n\n/** Run a step and report a stack overflow in it as SCHEMA_TOO_DEEP; other errors pass through. */\nexport function withStackOverflowReported<T>(step: DeepSchemaStep, run: () => T): T {\n  try {\n    return run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n\n/** The asynchronous form of `withStackOverflowReported`. */\nexport async function withStackOverflowReportedAsync<T>(\n  step: DeepSchemaStep,\n  run: () => Promise<T>,\n): Promise<T> {\n  try {\n    return await run();\n  } catch (error) {\n    throw isStackOverflowError(error) ? schemaTooDeepError(step, error) : error;\n  }\n}\n"],"names":[],"mappings":";;AAiBA,MAAM,sBAAA,GAAyB,mCAAA;AAGxB,SAAS,qBAAqB,KAAA,EAAyB;AAC5D,EAAA,OAAO,KAAA,YAAiB,UAAA,IAAc,sBAAA,CAAuB,IAAA,CAAK,MAAM,OAAO,CAAA;AACjF;AAGO,SAAS,kBAAA,CAAmB,MAAsB,KAAA,EAAsC;AAC7F,EAAA,MAAM,IAAA,GAAO,IAAA,KAAS,MAAA,GAAS,2DAAA,GAA8D,EAAA;AAC7F,EAAA,OAAO,IAAI,oBAAA,CAAqB;AAAA,IAC9B,MAAM,WAAA,CAAY,eAAA;AAAA,IAClB,OAAA,EACE,CAAA,mCAAA,EAAsC,IAAI,CAAA,0GAAA,EAC6B,IAAI,CAAA,sBAAA,CAAA;AAAA,IAE7E,OAAA,EAAS,EAAE,IAAA,EAAK;AAAA,IAChB;AAAA,GACD,CAAA;AACH;AAGO,SAAS,yBAAA,CAA6B,MAAsB,GAAA,EAAiB;AAClF,EAAA,IAAI;AACF,IAAA,OAAO,GAAA,EAAI;AAAA,EACb,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;AAGA,eAAsB,8BAAA,CACpB,MACA,GAAA,EACY;AACZ,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,GAAA,EAAI;AAAA,EACnB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,qBAAqB,KAAK,CAAA,GAAI,kBAAA,CAAmB,IAAA,EAAM,KAAK,CAAA,GAAI,KAAA;AAAA,EACxE;AACF;;"}

package/dist/application/transform/declared-value-types.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+const constructors = require('../../domain/ir/constructors.cjs');
+const helperTypes = require('./helper-types.cjs');
+
+function memberValueTypes(member) {
+  if (member.kind === "indexSignature") {
+    return [member.type];
+  }
+  return member.isOptional ? [member.type, constructors.irKeyword("undefined")] : [member.type];
+}
+function declaredValueTypes(type, footer) {
+  switch (type.kind) {
+    case "object":
+      return type.members.flatMap(memberValueTypes);
+    case "union":
+    case "intersection":
+      return type.types.flatMap((member) => declaredValueTypes(member, footer));
+    case "reference":
+    case "indexedAccess":
+    case "raw":
+      footer.requirePropertyValues();
+      return [constructors.irReference(helperTypes.HELPER_TYPES.propertyValues.name, [type])];
+    case "keyword":
+    case "stringLiteral":
+    case "numberLiteral":
+    case "booleanLiteral":
+    case "array":
+    case "tuple":
+    case "readonly":
+      return [];
+  }
+}
+
+exports.declaredValueTypes = declaredValueTypes;
+//# sourceMappingURL=declared-value-types.cjs.map

package/dist/application/transform/declared-value-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-value-types.cjs","sources":["../../../src/application/transform/declared-value-types.ts"],"sourcesContent":["import { irKeyword, irReference } from \"../../domain/ir/constructors.js\";\nimport type { IrMember, IrType } from \"../../domain/ir/nodes.js\";\nimport { HELPER_TYPES } from \"./helper-types.js\";\nimport type { FooterDeclarations } from \"./schema/schema-context.js\";\n\n/** The footer part that declares the `PropertyValues` helper type. */\nexport type PropertyValuesFooter = Pick<FooterDeclarations, \"requirePropertyValues\">;\n\nfunction memberValueTypes(member: IrMember): IrType[] {\n  if (member.kind === \"indexSignature\") {\n    return [member.type];\n  }\n  return member.isOptional ? [member.type, irKeyword(\"undefined\")] : [member.type];\n}\n\n/**\n * The value types a key of the type can have, read from its IR: the members of object types,\n * through unions and intersections. A reference (a `$ref`, `Omit`, `WithRequired`) or a raw\n * type is read with `PropertyValues`. Primitives, literals and arrays declare no keys.\n */\nexport function declaredValueTypes(type: IrType, footer: PropertyValuesFooter): IrType[] {\n  switch (type.kind) {\n    case \"object\":\n      return type.members.flatMap(memberValueTypes);\n    case \"union\":\n    case \"intersection\":\n      return type.types.flatMap((member) => declaredValueTypes(member, footer));\n    case \"reference\":\n    case \"indexedAccess\":\n    case \"raw\":\n      footer.requirePropertyValues();\n      return [irReference(HELPER_TYPES.propertyValues.name, [type])];\n    case \"keyword\":\n    case \"stringLiteral\":\n    case \"numberLiteral\":\n    case \"booleanLiteral\":\n    case \"array\":\n    case \"tuple\":\n    case \"readonly\":\n      return [];\n  }\n}\n"],"names":["irKeyword","irReference","HELPER_TYPES"],"mappings":";;;;;AAQA,SAAS,iBAAiB,MAAA,EAA4B;AACpD,EAAA,IAAI,MAAA,CAAO,SAAS,gBAAA,EAAkB;AACpC,IAAA,OAAO,CAAC,OAAO,IAAI,CAAA;AAAA,EACrB;AACA,EAAA,OAAO,MAAA,CAAO,UAAA,GAAa,CAAC,MAAA,CAAO,IAAA,EAAMA,sBAAA,CAAU,WAAW,CAAC,CAAA,GAAI,CAAC,MAAA,CAAO,IAAI,CAAA;AACjF;AAOO,SAAS,kBAAA,CAAmB,MAAc,MAAA,EAAwC;AACvF,EAAA,QAAQ,KAAK,IAAA;AAAM,IACjB,KAAK,QAAA;AACH,MAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,gBAAgB,CAAA;AAAA,IAC9C,KAAK,OAAA;AAAA,IACL,KAAK,cAAA;AACH,MAAA,OAAO,IAAA,CAAK,MAAM,OAAA,CAAQ,CAAC,WAAW,kBAAA,CAAmB,MAAA,EAAQ,MAAM,CAAC,CAAA;AAAA,IAC1E,KAAK,WAAA;AAAA,IACL,KAAK,eAAA;AAAA,IACL,KAAK,KAAA;AACH,MAAA,MAAA,CAAO,qBAAA,EAAsB;AAC7B,MAAA,OAAO,CAACC,yBAAYC,wBAAA,CAAa,cAAA,CAAe,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;AAAA,IAC/D,KAAK,SAAA;AAAA,IACL,KAAK,eAAA;AAAA,IACL,KAAK,eAAA;AAAA,IACL,KAAK,gBAAA;AAAA,IACL,KAAK,OAAA;AAAA,IACL,KAAK,OAAA;AAAA,IACL,KAAK,UAAA;AACH,MAAA,OAAO,EAAC;AAAA;AAEd;;"}

package/dist/application/transform/declared-value-types.mjs

@@ -0,0 +1,34 @@
+import { irReference, irKeyword } from '../../domain/ir/constructors.mjs';
+import { HELPER_TYPES } from './helper-types.mjs';
+
+function memberValueTypes(member) {
+  if (member.kind === "indexSignature") {
+    return [member.type];
+  }
+  return member.isOptional ? [member.type, irKeyword("undefined")] : [member.type];
+}
+function declaredValueTypes(type, footer) {
+  switch (type.kind) {
+    case "object":
+      return type.members.flatMap(memberValueTypes);
+    case "union":
+    case "intersection":
+      return type.types.flatMap((member) => declaredValueTypes(member, footer));
+    case "reference":
+    case "indexedAccess":
+    case "raw":
+      footer.requirePropertyValues();
+      return [irReference(HELPER_TYPES.propertyValues.name, [type])];
+    case "keyword":
+    case "stringLiteral":
+    case "numberLiteral":
+    case "booleanLiteral":
+    case "array":
+    case "tuple":
+    case "readonly":
+      return [];
+  }
+}
+
+export { declaredValueTypes };
+//# sourceMappingURL=declared-value-types.mjs.map

package/dist/application/transform/declared-value-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-value-types.mjs","sources":["../../../src/application/transform/declared-value-types.ts"],"sourcesContent":["import { irKeyword, irReference } from \"../../domain/ir/constructors.js\";\nimport type { IrMember, IrType } from \"../../domain/ir/nodes.js\";\nimport { HELPER_TYPES } from \"./helper-types.js\";\nimport type { FooterDeclarations } from \"./schema/schema-context.js\";\n\n/** The footer part that declares the `PropertyValues` helper type. */\nexport type PropertyValuesFooter = Pick<FooterDeclarations, \"requirePropertyValues\">;\n\nfunction memberValueTypes(member: IrMember): IrType[] {\n  if (member.kind === \"indexSignature\") {\n    return [member.type];\n  }\n  return member.isOptional ? [member.type, irKeyword(\"undefined\")] : [member.type];\n}\n\n/**\n * The value types a key of the type can have, read from its IR: the members of object types,\n * through unions and intersections. A reference (a `$ref`, `Omit`, `WithRequired`) or a raw\n * type is read with `PropertyValues`. Primitives, literals and arrays declare no keys.\n */\nexport function declaredValueTypes(type: IrType, footer: PropertyValuesFooter): IrType[] {\n  switch (type.kind) {\n    case \"object\":\n      return type.members.flatMap(memberValueTypes);\n    case \"union\":\n    case \"intersection\":\n      return type.types.flatMap((member) => declaredValueTypes(member, footer));\n    case \"reference\":\n    case \"indexedAccess\":\n    case \"raw\":\n      footer.requirePropertyValues();\n      return [irReference(HELPER_TYPES.propertyValues.name, [type])];\n    case \"keyword\":\n    case \"stringLiteral\":\n    case \"numberLiteral\":\n    case \"booleanLiteral\":\n    case \"array\":\n    case \"tuple\":\n    case \"readonly\":\n      return [];\n  }\n}\n"],"names":[],"mappings":";;;AAQA,SAAS,iBAAiB,MAAA,EAA4B;AACpD,EAAA,IAAI,MAAA,CAAO,SAAS,gBAAA,EAAkB;AACpC,IAAA,OAAO,CAAC,OAAO,IAAI,CAAA;AAAA,EACrB;AACA,EAAA,OAAO,MAAA,CAAO,UAAA,GAAa,CAAC,MAAA,CAAO,IAAA,EAAM,SAAA,CAAU,WAAW,CAAC,CAAA,GAAI,CAAC,MAAA,CAAO,IAAI,CAAA;AACjF;AAOO,SAAS,kBAAA,CAAmB,MAAc,MAAA,EAAwC;AACvF,EAAA,QAAQ,KAAK,IAAA;AAAM,IACjB,KAAK,QAAA;AACH,MAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,gBAAgB,CAAA;AAAA,IAC9C,KAAK,OAAA;AAAA,IACL,KAAK,cAAA;AACH,MAAA,OAAO,IAAA,CAAK,MAAM,OAAA,CAAQ,CAAC,WAAW,kBAAA,CAAmB,MAAA,EAAQ,MAAM,CAAC,CAAA;AAAA,IAC1E,KAAK,WAAA;AAAA,IACL,KAAK,eAAA;AAAA,IACL,KAAK,KAAA;AACH,MAAA,MAAA,CAAO,qBAAA,EAAsB;AAC7B,MAAA,OAAO,CAAC,YAAY,YAAA,CAAa,cAAA,CAAe,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;AAAA,IAC/D,KAAK,SAAA;AAAA,IACL,KAAK,eAAA;AAAA,IACL,KAAK,eAAA;AAAA,IACL,KAAK,gBAAA;AAAA,IACL,KAAK,OAAA;AAAA,IACL,KAAK,OAAA;AAAA,IACL,KAAK,UAAA;AACH,MAAA,OAAO,EAAC;AAAA;AAEd;;"}

package/dist/application/transform/document/components.cjs

@@ -27,7 +27,7 @@ const COMPONENT_TRANSFORMS = {
   mediaTypes: mediaType.contentEntryType
 };
 function componentMember(kind, name, item, context) {
-  const location = { path: jsonPointer.createRef(["components", kind, name]), schema: item };
+  const location = { path: jsonPointer.appendPointer(jsonPointer.ROOT_POINTER, ["components", kind, name]), schema: item };
   const type = COMPONENT_TRANSFORMS[kind](item, location, context);
   const custom = context.callbacks.transform(item, location);
   const property = constructors.irProperty(propertyName.toPropertyName(name), custom?.type ?? type, {