openapi-typesafe 0.0.0 → 1.0.0-rc.1

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

@@ -0,0 +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 {\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 { 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      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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"}

package/dist/api/transform-context.mjs

@@ -0,0 +1,67 @@
+import * as changeCase from 'change-case';
+import { RunFooter } from '../application/transform/footer/document-footer.mjs';
+import { defaultLogger, monotonicNow } from './default-ports.mjs';
+import { ContextFooterSink } from './footer-sink.mjs';
+import { schemaCallbacks } from './schema-callbacks.mjs';
+
+function transformOptions(ctx) {
+  return {
+    additionalProperties: ctx.additionalProperties,
+    alphabetize: ctx.alphabetize,
+    arrayLength: ctx.arrayLength,
+    binaryAsBlob: ctx.binaryAsBlob,
+    conditionalEnums: ctx.conditionalEnums,
+    dedupeEnums: ctx.dedupeEnums,
+    defaultNonNullable: ctx.defaultNonNullable,
+    emptyObjectsUnknown: ctx.emptyObjectsUnknown,
+    enum: ctx.enum,
+    enumValues: ctx.enumValues,
+    excludeDeprecated: ctx.excludeDeprecated,
+    fixes: new Set(ctx.fix ?? []),
+    immutable: ctx.immutable,
+    propertiesRequiredByDefault: ctx.propertiesRequiredByDefault,
+    readWriteMarkers: ctx.readWriteMarkers,
+    generatePathParams: ctx.generatePathParams,
+    pathParamsAsTypes: ctx.pathParamsAsTypes,
+    rootTypes: ctx.rootTypes,
+    rootTypesNoSchemaPrefix: ctx.rootTypesNoSchemaPrefix,
+    rootTypesKeepCasing: ctx.rootTypesKeepCasing,
+    exportType: ctx.exportType,
+    inject: ctx.inject,
+    makePathsEnum: ctx.makePathsEnum
+  };
+}
+function runFooter(ctx) {
+  ctx.runFooter ??= new RunFooter(new ContextFooterSink(ctx.injectFooter), ctx.dedupeEnums);
+  return ctx.runFooter;
+}
+const CASING = { pascalCase: (text) => changeCase.pascalCase(text) };
+function diagnostics(ctx) {
+  const logger = ctx.logger ?? defaultLogger(ctx.silent);
+  return {
+    now: monotonicNow,
+    debug: (message, durationMs) => logger.debug(message, "ts", durationMs)
+  };
+}
+function createTransformContext(ctx) {
+  return {
+    options: transformOptions(ctx),
+    refs: { resolve: (ref) => ctx.resolve(ref) },
+    discriminators: {
+      objectAt: (ref) => ctx.discriminators.objects[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(ctx),
+    diagnostics: diagnostics(ctx),
+    casing: CASING
+  };
+}
+function schemaLocation(options) {
+  return { path: options.path, schema: options.schema };
+}
+
+export { createTransformContext, schemaLocation };
+//# sourceMappingURL=transform-context.mjs.map

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

@@ -0,0 +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 { 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      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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"}

package/dist/api/transform-schema.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const document = require('../application/transform/document/document.cjs');
+const rootTypeAliases = require('../application/transform/document/root-type-aliases.cjs');
+const documentFooter = require('../application/transform/footer/document-footer.cjs');
+const enumValuesCheck = require('../application/transform/footer/enum-values-check.cjs');
+const sharedEnumNames = require('../application/transform/footer/shared-enum-names.cjs');
+const outputFixes = require('../domain/output-fixes.cjs');
+const discriminatorEnumNames = require('./discriminator-enum-names.cjs');
+const documentDeclarations = require('./document-declarations.cjs');
+const enumValuesWarnings = require('./enum-values-warnings.cjs');
+const footerEntry = require('./footer-entry.cjs');
+const footerSink = require('./footer-sink.cjs');
+const transformContext = require('./transform-context.cjs');
+
+const OPERATIONS_NAME = "operations";
+function isOperations(entry) {
+  const name = footerEntry.isIrDeclaration(entry) ? entry.name : entry.name?.escapedText;
+  return name === OPERATIONS_NAME;
+}
+const dropMessage = () => void 0;
+const DROPPED_MESSAGES = { debug: dropMessage, warn: dropMessage, error: dropMessage };
+function sharedEnumNamesOf(document$1, ctx, recorder) {
+  const injectFooter = [];
+  const scratch = {
+    ...ctx,
+    injectFooter,
+    runFooter: new documentFooter.RunFooter(new footerSink.ContextFooterSink(injectFooter), true, recorder),
+    logger: DROPPED_MESSAGES,
+    legacyCallbackWarnings: /* @__PURE__ */ new Set()
+  };
+  const scratchContext = transformContext.createTransformContext(scratch);
+  document.documentBody(document$1, scratchContext, () => injectFooter.filter(footerEntry.isIrDeclaration));
+  return recorder.chosenNames();
+}
+function enumNameRecorderOf(ctx) {
+  if (ctx.fix?.includes(outputFixes.OutputFix.DEDUPE_ENUM_NAMES)) {
+    return new sharedEnumNames.SharedEnumNameRecorder();
+  }
+  return ctx.fix?.includes(outputFixes.OutputFix.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) {
+    return;
+  }
+  const names = sharedEnumNamesOf(document, ctx, recorder);
+  ctx.runFooter = new documentFooter.RunFooter(new footerSink.ContextFooterSink(ctx.injectFooter), true, names);
+}
+function enumValuesChecked(body, footer, ctx) {
+  if (!ctx.enumValues) {
+    return footer;
+  }
+  const checked = enumValuesCheck.checkedEnumValues(footer, body, footerEntry.isIrDeclaration);
+  for (const retype of checked.retyped) {
+    if (retype.kind === "excluded") {
+      ctx.logger?.warn(enumValuesWarnings.excludedValuesWarning(retype.name, retype.excluded));
+    }
+  }
+  return checked.footer;
+}
+function transformDocument(schema, ctx) {
+  const document$1 = schema;
+  withSharedEnumNames(document$1, ctx);
+  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 };
+}
+function transformSchema(schema, ctx) {
+  return documentDeclarations.documentDeclarations(transformDocument(schema, ctx));
+}
+
+exports.default = transformSchema;
+exports.transformDocument = transformDocument;
+//# sourceMappingURL=transform-schema.cjs.map

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

@@ -0,0 +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 { OutputFix } 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 { 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: GlobalContext,\n  recorder: EnumNameRecorder,\n): SharedEnumNames {\n  const injectFooter: FooterEntry[] = [];\n  const scratch: GlobalContext = {\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(OutputFix.DEDUPE_ENUM_NAMES)) {\n    return new SharedEnumNameRecorder();\n  }\n  return ctx.fix?.includes(OutputFix.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: GlobalContext): 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: GlobalContext,\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: GlobalContext): 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","OutputFix","SharedEnumNameRecorder","FirstSchemaNameRecorder","checkedEnumValues","excludedValuesWarning","documentClosing","renameTakenAliases","documentDeclarations"],"mappings":"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"}

package/dist/api/transform-schema.mjs

@@ -0,0 +1,75 @@
+import { documentBody, documentClosing } from '../application/transform/document/document.mjs';
+import { renameTakenAliases } from '../application/transform/document/root-type-aliases.mjs';
+import { RunFooter } from '../application/transform/footer/document-footer.mjs';
+import { checkedEnumValues } from '../application/transform/footer/enum-values-check.mjs';
+import { SharedEnumNameRecorder } from '../application/transform/footer/shared-enum-names.mjs';
+import { OutputFix } from '../domain/output-fixes.mjs';
+import { FirstSchemaNameRecorder } from './discriminator-enum-names.mjs';
+import { documentDeclarations } from './document-declarations.mjs';
+import { excludedValuesWarning } from './enum-values-warnings.mjs';
+import { isIrDeclaration } from './footer-entry.mjs';
+import { ContextFooterSink } from './footer-sink.mjs';
+import { createTransformContext } from './transform-context.mjs';
+
+const OPERATIONS_NAME = "operations";
+function isOperations(entry) {
+  const name = isIrDeclaration(entry) ? entry.name : entry.name?.escapedText;
+  return name === OPERATIONS_NAME;
+}
+const dropMessage = () => void 0;
+const DROPPED_MESSAGES = { debug: dropMessage, warn: dropMessage, error: dropMessage };
+function sharedEnumNamesOf(document, ctx, recorder) {
+  const injectFooter = [];
+  const scratch = {
+    ...ctx,
+    injectFooter,
+    runFooter: new RunFooter(new ContextFooterSink(injectFooter), true, recorder),
+    logger: DROPPED_MESSAGES,
+    legacyCallbackWarnings: /* @__PURE__ */ new Set()
+  };
+  const scratchContext = createTransformContext(scratch);
+  documentBody(document, scratchContext, () => injectFooter.filter(isIrDeclaration));
+  return recorder.chosenNames();
+}
+function enumNameRecorderOf(ctx) {
+  if (ctx.fix?.includes(OutputFix.DEDUPE_ENUM_NAMES)) {
+    return new SharedEnumNameRecorder();
+  }
+  return ctx.fix?.includes(OutputFix.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) {
+    return;
+  }
+  const names = sharedEnumNamesOf(document, ctx, recorder);
+  ctx.runFooter = new RunFooter(new ContextFooterSink(ctx.injectFooter), true, names);
+}
+function enumValuesChecked(body, footer, ctx) {
+  if (!ctx.enumValues) {
+    return footer;
+  }
+  const checked = checkedEnumValues(footer, body, isIrDeclaration);
+  for (const retype of checked.retyped) {
+    if (retype.kind === "excluded") {
+      ctx.logger?.warn(excludedValuesWarning(retype.name, retype.excluded));
+    }
+  }
+  return checked.footer;
+}
+function transformDocument(schema, ctx) {
+  const document = schema;
+  withSharedEnumNames(document, ctx);
+  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 };
+}
+function transformSchema(schema, ctx) {
+  return documentDeclarations(transformDocument(schema, ctx));
+}
+
+export { transformSchema as default, transformDocument };
+//# sourceMappingURL=transform-schema.mjs.map

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

@@ -0,0 +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 { OutputFix } 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 { 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: GlobalContext,\n  recorder: EnumNameRecorder,\n): SharedEnumNames {\n  const injectFooter: FooterEntry[] = [];\n  const scratch: GlobalContext = {\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(OutputFix.DEDUPE_ENUM_NAMES)) {\n    return new SharedEnumNameRecorder();\n  }\n  return ctx.fix?.includes(OutputFix.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: GlobalContext): 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: GlobalContext,\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: GlobalContext): 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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"}

package/dist/api/type-helpers.cjs

@@ -0,0 +1,85 @@
+'use strict';
+
+const loadTypescript = require('../adapters/type-ast-bridge/load-typescript.cjs');
+const typescriptToIr = require('../adapters/type-ast-bridge/typescript-to-ir.cjs');
+const helperTypes = require('../application/transform/helper-types.cjs');
+const literalType = require('../application/transform/literal-type.cjs');
+const refType = require('../application/transform/ref-type.cjs');
+const sharedTypes = require('../application/transform/shared-types.cjs');
+const typeCombinators = require('../application/transform/type-combinators.cjs');
+const constructors = require('../domain/ir/constructors.cjs');
+const footerEntry = require('./footer-entry.cjs');
+
+const BOOLEAN = Object.freeze(constructors.irKeyword("boolean"));
+const FALSE = Object.freeze(constructors.irBoolean(false));
+const NEVER = Object.freeze(constructors.irKeyword("never"));
+const NULL = Object.freeze(constructors.irKeyword("null"));
+const NUMBER = Object.freeze(constructors.irKeyword("number"));
+const STRING = Object.freeze(constructors.irKeyword("string"));
+const TRUE = Object.freeze(constructors.irBoolean(true));
+const UNDEFINED = Object.freeze(constructors.irKeyword("undefined"));
+const UNKNOWN = sharedTypes.UNKNOWN_TYPE;
+function isIrType(type) {
+  return typeof type.kind === "string";
+}
+function toIrType(type) {
+  return isIrType(type) ? type : typescriptToIr.fromTypeNode(loadTypescript.loadTypeScript(), type);
+}
+function tsUnion(types) {
+  return typeCombinators.unionOf(types.map(toIrType));
+}
+function tsIntersection(types) {
+  return typeCombinators.intersectionOf(types.map(toIrType));
+}
+function tsNullable(types) {
+  return typeCombinators.nullableOf(types.map(toIrType));
+}
+function tsOmit(type, keys) {
+  return typeCombinators.omitKeys(toIrType(type), keys);
+}
+function tsRecord(key, value) {
+  return constructors.irRecord(toIrType(key), toIrType(value));
+}
+function tsLiteral(value) {
+  return literalType.literalType(value);
+}
+function tsWithRequired(type, keys, injectFooter) {
+  if (keys.length === 0) {
+    return toIrType(type);
+  }
+  const { name, text } = helperTypes.HELPER_TYPES.withRequired;
+  if (!injectFooter.some((entry) => footerEntry.declaresTypeAlias(entry, name))) {
+    injectFooter.push({ kind: "rawDeclaration", name, text });
+  }
+  return typeCombinators.withRequiredKeys(toIrType(type), keys);
+}
+function isParameterObject(value) {
+  return Boolean(value && !("$ref" in value && value.$ref) && value.in);
+}
+function oapiRef(path, resolved, options = {}) {
+  return refType.refType(path, {
+    isDeep: options.deep ?? false,
+    extractProperties: options.extractProperties ?? [],
+    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null
+  });
+}
+
+exports.BOOLEAN = BOOLEAN;
+exports.FALSE = FALSE;
+exports.NEVER = NEVER;
+exports.NULL = NULL;
+exports.NUMBER = NUMBER;
+exports.STRING = STRING;
+exports.TRUE = TRUE;
+exports.UNDEFINED = UNDEFINED;
+exports.UNKNOWN = UNKNOWN;
+exports.oapiRef = oapiRef;
+exports.toIrType = toIrType;
+exports.tsIntersection = tsIntersection;
+exports.tsLiteral = tsLiteral;
+exports.tsNullable = tsNullable;
+exports.tsOmit = tsOmit;
+exports.tsRecord = tsRecord;
+exports.tsUnion = tsUnion;
+exports.tsWithRequired = tsWithRequired;
+//# sourceMappingURL=type-helpers.cjs.map

package/dist/api/type-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helpers.cjs","sources":["../../src/api/type-helpers.ts"],"sourcesContent":["import { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { fromTypeNode } from \"../adapters/type-ast-bridge/typescript-to-ir.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { literalType } from \"../application/transform/literal-type.js\";\nimport { refType } from \"../application/transform/ref-type.js\";\nimport { UNKNOWN_TYPE } from \"../application/transform/shared-types.js\";\nimport {\n  intersectionOf,\n  nullableOf,\n  omitKeys,\n  unionOf,\n  withRequiredKeys,\n} from \"../application/transform/type-combinators.js\";\nimport { irBoolean, irKeyword, irRecord } from \"../domain/ir/constructors.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport type { ParameterObject, ReferenceObject } from \"../types.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\n\n/**\n * The public type helpers (ENGINEERING_PLAN 6.2, ADR-004 decision 2). Same names and call\n * signatures as the original helpers; they return IR types. A `ts.TypeNode` argument (from user\n * code built with `ts.factory`) is read into IR by the bridge.\n */\n\n/** A helper argument: an IR type, or a TypeScript type node from user code. */\nexport type TypeInput = IrType | ts.TypeNode;\n\nexport const BOOLEAN: IrType = Object.freeze(irKeyword(\"boolean\"));\nexport const FALSE: IrType = Object.freeze(irBoolean(false));\nexport const NEVER: IrType = Object.freeze(irKeyword(\"never\"));\nexport const NULL: IrType = Object.freeze(irKeyword(\"null\"));\nexport const NUMBER: IrType = Object.freeze(irKeyword(\"number\"));\nexport const STRING: IrType = Object.freeze(irKeyword(\"string\"));\nexport const TRUE: IrType = Object.freeze(irBoolean(true));\nexport const UNDEFINED: IrType = Object.freeze(irKeyword(\"undefined\"));\n/** The shared `unknown` type; the transformers compare with it by identity, as the original did. */\nexport const UNKNOWN: IrType = UNKNOWN_TYPE;\n\n/** IR nodes have a string `kind`; TypeScript nodes have a numeric `SyntaxKind`. */\nfunction isIrType(type: TypeInput): type is IrType {\n  return typeof type.kind === \"string\";\n}\n\n/** @internal Read a helper argument into IR. */\nexport function toIrType(type: TypeInput): IrType {\n  return isIrType(type) ? type : fromTypeNode(loadTypeScript(), type);\n}\n\n/** `A | B`: `never` for no types, the type itself for one; repeated primitives are removed. */\nexport function tsUnion(types: readonly TypeInput[]): IrType {\n  return unionOf(types.map(toIrType));\n}\n\n/** `A & B`, with the same rules as `tsUnion`. */\nexport function tsIntersection(types: readonly TypeInput[]): IrType {\n  return intersectionOf(types.map(toIrType));\n}\n\n/** `A | null`, without removing repeated types. */\nexport function tsNullable(types: readonly TypeInput[]): IrType {\n  return nullableOf(types.map(toIrType));\n}\n\n/** `Omit<T, \"a\" | \"b\">`. */\nexport function tsOmit(type: TypeInput, keys: readonly string[]): IrType {\n  return omitKeys(toIrType(type), keys);\n}\n\n/** `Record<K, V>`. */\nexport function tsRecord(key: TypeInput, value: TypeInput): IrType {\n  return irRecord(toIrType(key), toIrType(value));\n}\n\n/**\n * The literal type of a JSON value: strings, numbers, booleans and `null` as literals, arrays as\n * tuples (an empty one as `never[]`), objects as object types; anything else is `unknown`.\n */\nexport function tsLiteral(value: unknown): IrType {\n  return literalType(value);\n}\n\n/**\n * `WithRequired<T, \"a\" | \"b\">`, or the type itself for no keys. Adds the `WithRequired` helper\n * type to the footer once.\n */\nexport function tsWithRequired(\n  type: TypeInput,\n  keys: readonly string[],\n  injectFooter: FooterEntry[],\n): IrType {\n  if (keys.length === 0) {\n    return toIrType(type);\n  }\n  const { name, text } = HELPER_TYPES.withRequired;\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name, text });\n  }\n  return withRequiredKeys(toIrType(type), keys);\n}\n\nexport interface OapiRefOptions {\n  /** Whether to wrap with FlattenedDeepRequired<> (default: false) */\n  deep?: boolean;\n  /** Array of property names to wrap with Extract<> when accessing */\n  extractProperties?: string[];\n}\n\nfunction isParameterObject(\n  value: ParameterObject | ReferenceObject | undefined,\n): value is ParameterObject {\n  return Boolean(value && !(\"$ref\" in value && value.$ref) && (value as ParameterObject).in);\n}\n\n/**\n * The generated type a JSON Pointer refers to, as an indexed access: `#/components/schemas/Foo`\n * → `components[\"schemas\"][\"Foo\"]`. Object `properties` are skipped, and a referenced parameter\n * is indexed by its location (`resolved`).\n */\nexport function oapiRef(\n  path: string,\n  resolved?: ParameterObject | ReferenceObject,\n  options: OapiRefOptions = {},\n): IrType {\n  return refType(path, {\n    isDeep: options.deep ?? false,\n    extractProperties: options.extractProperties ?? [],\n    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null,\n  });\n}\n"],"names":["irKeyword","irBoolean","UNKNOWN_TYPE","fromTypeNode","loadTypeScript","unionOf","intersectionOf","nullableOf","omitKeys","irRecord","literalType","HELPER_TYPES","declaresTypeAlias","withRequiredKeys","refType"],"mappings":"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"}

package/dist/api/type-helpers.mjs

@@ -0,0 +1,66 @@
+import { loadTypeScript } from '../adapters/type-ast-bridge/load-typescript.mjs';
+import { fromTypeNode } from '../adapters/type-ast-bridge/typescript-to-ir.mjs';
+import { HELPER_TYPES } from '../application/transform/helper-types.mjs';
+import { literalType } from '../application/transform/literal-type.mjs';
+import { refType } from '../application/transform/ref-type.mjs';
+import { UNKNOWN_TYPE } from '../application/transform/shared-types.mjs';
+import { intersectionOf, nullableOf, omitKeys, unionOf, withRequiredKeys } from '../application/transform/type-combinators.mjs';
+import { irKeyword, irBoolean, irRecord } from '../domain/ir/constructors.mjs';
+import { declaresTypeAlias } from './footer-entry.mjs';
+
+const BOOLEAN = Object.freeze(irKeyword("boolean"));
+const FALSE = Object.freeze(irBoolean(false));
+const NEVER = Object.freeze(irKeyword("never"));
+const NULL = Object.freeze(irKeyword("null"));
+const NUMBER = Object.freeze(irKeyword("number"));
+const STRING = Object.freeze(irKeyword("string"));
+const TRUE = Object.freeze(irBoolean(true));
+const UNDEFINED = Object.freeze(irKeyword("undefined"));
+const UNKNOWN = UNKNOWN_TYPE;
+function isIrType(type) {
+  return typeof type.kind === "string";
+}
+function toIrType(type) {
+  return isIrType(type) ? type : fromTypeNode(loadTypeScript(), type);
+}
+function tsUnion(types) {
+  return unionOf(types.map(toIrType));
+}
+function tsIntersection(types) {
+  return intersectionOf(types.map(toIrType));
+}
+function tsNullable(types) {
+  return nullableOf(types.map(toIrType));
+}
+function tsOmit(type, keys) {
+  return omitKeys(toIrType(type), keys);
+}
+function tsRecord(key, value) {
+  return irRecord(toIrType(key), toIrType(value));
+}
+function tsLiteral(value) {
+  return literalType(value);
+}
+function tsWithRequired(type, keys, injectFooter) {
+  if (keys.length === 0) {
+    return toIrType(type);
+  }
+  const { name, text } = HELPER_TYPES.withRequired;
+  if (!injectFooter.some((entry) => declaresTypeAlias(entry, name))) {
+    injectFooter.push({ kind: "rawDeclaration", name, text });
+  }
+  return withRequiredKeys(toIrType(type), keys);
+}
+function isParameterObject(value) {
+  return Boolean(value && !("$ref" in value && value.$ref) && value.in);
+}
+function oapiRef(path, resolved, options = {}) {
+  return refType(path, {
+    isDeep: options.deep ?? false,
+    extractProperties: options.extractProperties ?? [],
+    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null
+  });
+}
+
+export { BOOLEAN, FALSE, NEVER, NULL, NUMBER, STRING, TRUE, UNDEFINED, UNKNOWN, oapiRef, toIrType, tsIntersection, tsLiteral, tsNullable, tsOmit, tsRecord, tsUnion, tsWithRequired };
+//# sourceMappingURL=type-helpers.mjs.map

package/dist/api/type-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helpers.mjs","sources":["../../src/api/type-helpers.ts"],"sourcesContent":["import { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { fromTypeNode } from \"../adapters/type-ast-bridge/typescript-to-ir.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport { HELPER_TYPES } from \"../application/transform/helper-types.js\";\nimport { literalType } from \"../application/transform/literal-type.js\";\nimport { refType } from \"../application/transform/ref-type.js\";\nimport { UNKNOWN_TYPE } from \"../application/transform/shared-types.js\";\nimport {\n  intersectionOf,\n  nullableOf,\n  omitKeys,\n  unionOf,\n  withRequiredKeys,\n} from \"../application/transform/type-combinators.js\";\nimport { irBoolean, irKeyword, irRecord } from \"../domain/ir/constructors.js\";\nimport type { IrType } from \"../domain/ir/nodes.js\";\nimport type { ParameterObject, ReferenceObject } from \"../types.js\";\nimport { declaresTypeAlias, type FooterEntry } from \"./footer-entry.js\";\n\n/**\n * The public type helpers (ENGINEERING_PLAN 6.2, ADR-004 decision 2). Same names and call\n * signatures as the original helpers; they return IR types. A `ts.TypeNode` argument (from user\n * code built with `ts.factory`) is read into IR by the bridge.\n */\n\n/** A helper argument: an IR type, or a TypeScript type node from user code. */\nexport type TypeInput = IrType | ts.TypeNode;\n\nexport const BOOLEAN: IrType = Object.freeze(irKeyword(\"boolean\"));\nexport const FALSE: IrType = Object.freeze(irBoolean(false));\nexport const NEVER: IrType = Object.freeze(irKeyword(\"never\"));\nexport const NULL: IrType = Object.freeze(irKeyword(\"null\"));\nexport const NUMBER: IrType = Object.freeze(irKeyword(\"number\"));\nexport const STRING: IrType = Object.freeze(irKeyword(\"string\"));\nexport const TRUE: IrType = Object.freeze(irBoolean(true));\nexport const UNDEFINED: IrType = Object.freeze(irKeyword(\"undefined\"));\n/** The shared `unknown` type; the transformers compare with it by identity, as the original did. */\nexport const UNKNOWN: IrType = UNKNOWN_TYPE;\n\n/** IR nodes have a string `kind`; TypeScript nodes have a numeric `SyntaxKind`. */\nfunction isIrType(type: TypeInput): type is IrType {\n  return typeof type.kind === \"string\";\n}\n\n/** @internal Read a helper argument into IR. */\nexport function toIrType(type: TypeInput): IrType {\n  return isIrType(type) ? type : fromTypeNode(loadTypeScript(), type);\n}\n\n/** `A | B`: `never` for no types, the type itself for one; repeated primitives are removed. */\nexport function tsUnion(types: readonly TypeInput[]): IrType {\n  return unionOf(types.map(toIrType));\n}\n\n/** `A & B`, with the same rules as `tsUnion`. */\nexport function tsIntersection(types: readonly TypeInput[]): IrType {\n  return intersectionOf(types.map(toIrType));\n}\n\n/** `A | null`, without removing repeated types. */\nexport function tsNullable(types: readonly TypeInput[]): IrType {\n  return nullableOf(types.map(toIrType));\n}\n\n/** `Omit<T, \"a\" | \"b\">`. */\nexport function tsOmit(type: TypeInput, keys: readonly string[]): IrType {\n  return omitKeys(toIrType(type), keys);\n}\n\n/** `Record<K, V>`. */\nexport function tsRecord(key: TypeInput, value: TypeInput): IrType {\n  return irRecord(toIrType(key), toIrType(value));\n}\n\n/**\n * The literal type of a JSON value: strings, numbers, booleans and `null` as literals, arrays as\n * tuples (an empty one as `never[]`), objects as object types; anything else is `unknown`.\n */\nexport function tsLiteral(value: unknown): IrType {\n  return literalType(value);\n}\n\n/**\n * `WithRequired<T, \"a\" | \"b\">`, or the type itself for no keys. Adds the `WithRequired` helper\n * type to the footer once.\n */\nexport function tsWithRequired(\n  type: TypeInput,\n  keys: readonly string[],\n  injectFooter: FooterEntry[],\n): IrType {\n  if (keys.length === 0) {\n    return toIrType(type);\n  }\n  const { name, text } = HELPER_TYPES.withRequired;\n  if (!injectFooter.some((entry) => declaresTypeAlias(entry, name))) {\n    injectFooter.push({ kind: \"rawDeclaration\", name, text });\n  }\n  return withRequiredKeys(toIrType(type), keys);\n}\n\nexport interface OapiRefOptions {\n  /** Whether to wrap with FlattenedDeepRequired<> (default: false) */\n  deep?: boolean;\n  /** Array of property names to wrap with Extract<> when accessing */\n  extractProperties?: string[];\n}\n\nfunction isParameterObject(\n  value: ParameterObject | ReferenceObject | undefined,\n): value is ParameterObject {\n  return Boolean(value && !(\"$ref\" in value && value.$ref) && (value as ParameterObject).in);\n}\n\n/**\n * The generated type a JSON Pointer refers to, as an indexed access: `#/components/schemas/Foo`\n * → `components[\"schemas\"][\"Foo\"]`. Object `properties` are skipped, and a referenced parameter\n * is indexed by its location (`resolved`).\n */\nexport function oapiRef(\n  path: string,\n  resolved?: ParameterObject | ReferenceObject,\n  options: OapiRefOptions = {},\n): IrType {\n  return refType(path, {\n    isDeep: options.deep ?? false,\n    extractProperties: options.extractProperties ?? [],\n    parameter: isParameterObject(resolved) ? { in: resolved.in, name: resolved.name } : null,\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/api/unsupported-feature-warnings.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+const unsupportedFeatures = require('../domain/openapi/unsupported-features.cjs');
+const warnings = require('../domain/warnings.cjs');
+
+const DOCS_BASE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs";
+const SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;
+const REASONS = {
+  [unsupportedFeatures.UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: 'is an "in: querystring" parameter next to "in: query" parameters, which OpenAPI 3.2 does not allow; the query parameters keep their types and this parameter is not in the generated types'
+};
+const CODES = {
+  [unsupportedFeatures.UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: warnings.WARNING_CODES.QUERYSTRING_NEXT_TO_QUERY
+};
+function warnUnsupportedFeatures(document, logger) {
+  for (const { feature, pointer } of unsupportedFeatures.findUnsupportedFeatures(document)) {
+    const message = `${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`;
+    logger.warn(warnings.warningText(message, CODES[feature]));
+  }
+}
+
+exports.warnUnsupportedFeatures = warnUnsupportedFeatures;
+//# sourceMappingURL=unsupported-feature-warnings.cjs.map

package/dist/api/unsupported-feature-warnings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-feature-warnings.cjs","sources":["../../src/api/unsupported-feature-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport {\n  findUnsupportedFeatures,\n  UnsupportedFeature,\n} from \"../domain/openapi/unsupported-features.js\";\nimport { WARNING_CODES, type WarningCode, warningText } from \"../domain/warnings.js\";\n\nconst DOCS_BASE_URL = \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs\";\nconst SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;\n\n/** Why each feature is not in the generated types. */\nconst REASONS: Readonly<Record<UnsupportedFeature, string>> = {\n  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]:\n    'is an \"in: querystring\" parameter next to \"in: query\" parameters, which OpenAPI 3.2 does ' +\n    \"not allow; the query parameters keep their types and this parameter is not in the \" +\n    \"generated types\",\n};\n\n/** The warning code of each feature. */\nconst CODES: Readonly<Record<UnsupportedFeature, WarningCode>> = {\n  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: WARNING_CODES.QUERYSTRING_NEXT_TO_QUERY,\n};\n\n/**\n * Warn once per use of an OpenAPI 3.2 feature that the generated types leave out, so a missing\n * parameter is never silent (CODING_PRINCIPLES §8.7).\n */\nexport function warnUnsupportedFeatures(document: unknown, logger: Logger): void {\n  for (const { feature, pointer } of findUnsupportedFeatures(document)) {\n    const message = `${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`;\n    logger.warn(warningText(message, CODES[feature]));\n  }\n}\n"],"names":["UnsupportedFeature","WARNING_CODES","findUnsupportedFeatures","warningText"],"mappings":";;;;;AAOA,MAAM,aAAA,GAAgB,qEAAA;AACtB,MAAM,gBAAA,GAAmB,GAAG,aAAa,CAAA,oCAAA,CAAA;AAGzC,MAAM,OAAA,GAAwD;AAAA,EAC5D,CAACA,sCAAA,CAAmB,yBAAyB,GAC3C;AAGJ,CAAA;AAGA,MAAM,KAAA,GAA2D;AAAA,EAC/D,CAACA,sCAAA,CAAmB,yBAAyB,GAAGC,sBAAA,CAAc;AAChE,CAAA;AAMO,SAAS,uBAAA,CAAwB,UAAmB,MAAA,EAAsB;AAC/E,EAAA,KAAA,MAAW,EAAE,OAAA,EAAS,OAAA,EAAQ,IAAKC,2CAAA,CAAwB,QAAQ,CAAA,EAAG;AACpE,IAAA,MAAM,OAAA,GAAU,GAAG,OAAO,CAAA,CAAA,EAAI,QAAQ,OAAO,CAAC,SAAS,gBAAgB,CAAA,CAAA;AACvE,IAAA,MAAA,CAAO,KAAKC,oBAAA,CAAY,OAAA,EAAS,KAAA,CAAM,OAAO,CAAC,CAAC,CAAA;AAAA,EAClD;AACF;;"}

package/dist/api/unsupported-feature-warnings.mjs

@@ -0,0 +1,20 @@
+import { findUnsupportedFeatures, UnsupportedFeature } from '../domain/openapi/unsupported-features.mjs';
+import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
+
+const DOCS_BASE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs";
+const SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;
+const REASONS = {
+  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: 'is an "in: querystring" parameter next to "in: query" parameters, which OpenAPI 3.2 does not allow; the query parameters keep their types and this parameter is not in the generated types'
+};
+const CODES = {
+  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: WARNING_CODES.QUERYSTRING_NEXT_TO_QUERY
+};
+function warnUnsupportedFeatures(document, logger) {
+  for (const { feature, pointer } of findUnsupportedFeatures(document)) {
+    const message = `${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`;
+    logger.warn(warningText(message, CODES[feature]));
+  }
+}
+
+export { warnUnsupportedFeatures };
+//# sourceMappingURL=unsupported-feature-warnings.mjs.map

package/dist/api/unsupported-feature-warnings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-feature-warnings.mjs","sources":["../../src/api/unsupported-feature-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport {\n  findUnsupportedFeatures,\n  UnsupportedFeature,\n} from \"../domain/openapi/unsupported-features.js\";\nimport { WARNING_CODES, type WarningCode, warningText } from \"../domain/warnings.js\";\n\nconst DOCS_BASE_URL = \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs\";\nconst SUPPORT_DOCS_URL = `${DOCS_BASE_URL}/introduction.md#openapi-3-2-support`;\n\n/** Why each feature is not in the generated types. */\nconst REASONS: Readonly<Record<UnsupportedFeature, string>> = {\n  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]:\n    'is an \"in: querystring\" parameter next to \"in: query\" parameters, which OpenAPI 3.2 does ' +\n    \"not allow; the query parameters keep their types and this parameter is not in the \" +\n    \"generated types\",\n};\n\n/** The warning code of each feature. */\nconst CODES: Readonly<Record<UnsupportedFeature, WarningCode>> = {\n  [UnsupportedFeature.QUERYSTRING_NEXT_TO_QUERY]: WARNING_CODES.QUERYSTRING_NEXT_TO_QUERY,\n};\n\n/**\n * Warn once per use of an OpenAPI 3.2 feature that the generated types leave out, so a missing\n * parameter is never silent (CODING_PRINCIPLES §8.7).\n */\nexport function warnUnsupportedFeatures(document: unknown, logger: Logger): void {\n  for (const { feature, pointer } of findUnsupportedFeatures(document)) {\n    const message = `${pointer} ${REASONS[feature]}. See ${SUPPORT_DOCS_URL}`;\n    logger.warn(warningText(message, CODES[feature]));\n  }\n}\n"],"names":[],"mappings":";;;AAOA,MAAM,aAAA,GAAgB,qEAAA;AACtB,MAAM,gBAAA,GAAmB,GAAG,aAAa,CAAA,oCAAA,CAAA;AAGzC,MAAM,OAAA,GAAwD;AAAA,EAC5D,CAAC,kBAAA,CAAmB,yBAAyB,GAC3C;AAGJ,CAAA;AAGA,MAAM,KAAA,GAA2D;AAAA,EAC/D,CAAC,kBAAA,CAAmB,yBAAyB,GAAG,aAAA,CAAc;AAChE,CAAA;AAMO,SAAS,uBAAA,CAAwB,UAAmB,MAAA,EAAsB;AAC/E,EAAA,KAAA,MAAW,EAAE,OAAA,EAAS,OAAA,EAAQ,IAAK,uBAAA,CAAwB,QAAQ,CAAA,EAAG;AACpE,IAAA,MAAM,OAAA,GAAU,GAAG,OAAO,CAAA,CAAA,EAAI,QAAQ,OAAO,CAAC,SAAS,gBAAgB,CAAA,CAAA;AACvE,IAAA,MAAA,CAAO,KAAK,WAAA,CAAY,OAAA,EAAS,KAAA,CAAM,OAAO,CAAC,CAAC,CAAA;AAAA,EAClD;AACF;;"}