openapi-typesafe 0.0.0 → 1.0.0-rc.1

package/dist/application/transform/document/document.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.mjs","sources":["../../../../src/application/transform/document/document.ts"],"sourcesContent":["import { irKeyword, irObject, irRecord } from \"../../../domain/ir/constructors.js\";\nimport type {\n  IrDeclaration,\n  IrIntersectionType,\n  IrObjectType,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport type { ComponentsObject } from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport type { PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { READ_WRITE_MARKER_TYPES } from \"../helper-types.js\";\nimport type { TransformContext, TransformOptions } from \"../transform-context.js\";\nimport { componentsType } from \"./components.js\";\nimport { type DeclaredTypeLookup, declaredTypeLookup } from \"./declared-types.js\";\nimport { defsRootType } from \"./defs-root.js\";\nimport { keptDeprecatedComponents } from \"./kept-deprecated.js\";\nimport { pathMembers, pathsObjectType } from \"./paths.js\";\nimport { apiPathsEnumDeclaration } from \"./paths-enum.js\";\nimport { webhooksType } from \"./webhooks.js\";\n\n/** The root types, in output order. */\nconst ROOT_KEYS = Object.freeze([\"paths\", \"webhooks\", \"components\", \"$defs\"] as const);\ntype RootKey = (typeof ROOT_KEYS)[number];\n\nconst OPERATIONS_NAME = \"operations\";\n/** The type of a root without members: `Record<string, never>`. */\nconst EMPTY_ROOT_TYPE = irRecord(irKeyword(\"string\"), irKeyword(\"never\"));\n\n/** A root's type and the declarations that follow it (the `--root-types` aliases). */\ninterface RootResult {\n  readonly type: IrType;\n  readonly aliases: readonly IrTypeAliasDeclaration[];\n  /**\n   * The root's final type, for a root that reads the types the whole file declares (`paths`, whose\n   * overlap check follows references). `type` then only tells whether the root has members.\n   */\n  readonly withDeclaredTypes?: (lookup: DeclaredTypeLookup) => IrType;\n}\n\ntype RootTransform = (\n  node: object,\n  context: TransformContext,\n  document: DocumentObject,\n) => RootResult;\n\n/** Without `--exclude-deprecated` nothing is left out, so the scan is skipped. */\nfunction keptDeprecated(document: DocumentObject, context: TransformContext): ReadonlySet<object> {\n  return context.options.excludeDeprecated\n    ? keptDeprecatedComponents(document, context.refs)\n    : new Set();\n}\n\nconst ROOT_TRANSFORMS: Readonly<Record<RootKey, RootTransform>> = {\n  paths: (node, context) => {\n    const members = pathMembers(node as PathsObject, context);\n    return {\n      type: irObject(members.map(({ member }) => member)),\n      aliases: [],\n      withDeclaredTypes: (lookup) => pathsObjectType(members, lookup),\n    };\n  },\n  webhooks: (node, context) => ({ type: webhooksType(node as PathsObject, context), aliases: [] }),\n  components: (node, context, document) => {\n    const kept = keptDeprecated(document, context);\n    const { type, rootTypes } = componentsType(node as ComponentsObject, context, kept);\n    return { type, aliases: rootTypes };\n  },\n  $defs: (node, context) => ({\n    type: defsRootType(node as NonNullable<DocumentObject[\"$defs\"]>, context),\n    aliases: [],\n  }),\n};\n\nfunction emptyAlias(name: string): IrTypeAliasDeclaration {\n  return { kind: \"typeAlias\", name, isExported: true, type: EMPTY_ROOT_TYPE, comments: [] };\n}\n\n/** A root type that declares something: an object with members, or an intersection of them. */\ntype RootBodyType = IrObjectType | IrIntersectionType;\n\nfunction isRootBody(type: IrType): type is RootBodyType {\n  return (type.kind === \"object\" && type.members.length > 0) || type.kind === \"intersection\";\n}\n\n/**\n * A root with members: an interface, or a type alias with `--export-type`. An intersection (the\n * `paths` of overlapping `--path-params-as-types` keys) can only be a type alias.\n */\nfunction rootDeclaration(\n  name: RootKey,\n  type: RootBodyType,\n  options: TransformOptions,\n): IrDeclaration {\n  return options.exportType || type.kind === \"intersection\"\n    ? { kind: \"typeAlias\", name, isExported: true, type, comments: [] }\n    : { kind: \"interface\", name, isExported: true, members: type.members, comments: [] };\n}\n\n/**\n * The declarations of one root: its type, then its aliases. `finish` gives the root's declaration\n * again from the types the whole file declares, for a root with `withDeclaredTypes`.\n */\ninterface RootDeclarations {\n  readonly declarations: readonly IrDeclaration[];\n  readonly finish?: (lookup: DeclaredTypeLookup) => IrDeclaration;\n}\n\n/**\n * The declarations of one root. A root that is missing, or whose type has no members, is\n * `Record<string, never>`. Only an object type (or the `paths` intersection) counts as having\n * members: a callback type the IR keeps as raw text does not (ADR-004).\n */\nfunction rootDeclarations(\n  root: RootKey,\n  document: DocumentObject,\n  context: TransformContext,\n): RootDeclarations {\n  const node: unknown = document[root];\n  if (!node || typeof node !== \"object\") {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root)] };\n  }\n  const startedAt = context.diagnostics.now();\n  const { type, aliases, withDeclaredTypes } = ROOT_TRANSFORMS[root](node, context, document);\n  if (!isRootBody(type)) {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root), ...aliases] };\n  }\n  const declaration = rootDeclaration(root, type, context.options);\n  context.diagnostics.debug(`${root} done`, context.diagnostics.now() - startedAt);\n  const finish =\n    withDeclaredTypes &&\n    ((lookup: DeclaredTypeLookup) => {\n      const finished = withDeclaredTypes(lookup);\n      return isRootBody(finished) ? rootDeclaration(root, finished, context.options) : declaration;\n    });\n  return { declarations: [declaration, ...aliases], ...(finish ? { finish } : {}) };\n}\n\n/**\n * Every root's declarations in output order. A root with `finish` gets its declaration from the\n * types of the other roots and of the footer (the `operations` interface), which exist only once\n * every root is transformed.\n */\nfunction rootsDeclarations(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[],\n): IrDeclaration[] {\n  const roots = ROOT_KEYS.map((root) => rootDeclarations(root, document, context));\n  const transformed = roots.flatMap(({ declarations }) => declarations);\n  if (roots.every(({ finish }) => finish === undefined)) {\n    return transformed;\n  }\n  const lookup = declaredTypeLookup([...transformed, ...footer()]);\n  return roots.flatMap(({ declarations, finish }) => {\n    const [declaration, ...aliases] = declarations;\n    return finish === undefined || declaration === undefined\n      ? declarations\n      : [finish(lookup), ...aliases];\n  });\n}\n\n/**\n * The `inject` text as written (ADR-010, decision 4), without the blank lines around it. The\n * original reprinted it with the TypeScript printer; text without code printed nothing then.\n */\nfunction withoutBlankLinesAround(text: string): string {\n  return text.replace(/^(?:[ \\t]*\\r?\\n)+/, \"\").trimEnd();\n}\n\n/** No footer declarations: the roots' references to `operations` stay unresolved. */\nconst NO_FOOTER = (): readonly IrDeclaration[] => [];\n\n/**\n * The document's declarations before the footer: helper types, injected code, then one root type\n * per root key with the aliases that follow it. `footer` reads the footer's declarations once the\n * roots are transformed.\n */\nexport function documentBody(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[] = NO_FOOTER,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (context.options.readWriteMarkers) {\n    declarations.push({ kind: \"rawDeclaration\", text: READ_WRITE_MARKER_TYPES });\n  }\n  const inject = withoutBlankLinesAround(context.options.inject ?? \"\");\n  if (inject !== \"\") {\n    declarations.push({ kind: \"rawDeclaration\", text: inject });\n  }\n  declarations.push(...rootsDeclarations(document, context, footer));\n  return declarations;\n}\n\n/**\n * The declarations after the footer: an empty `operations` type when the footer has no\n * operations, and the `--make-paths-enum` enum.\n */\nexport function documentClosing(\n  document: DocumentObject,\n  context: TransformContext,\n  hasOperations: boolean,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (!hasOperations) {\n    declarations.push(emptyAlias(OPERATIONS_NAME));\n  }\n  if (context.options.makePathsEnum && document.paths) {\n    declarations.push(apiPathsEnumDeclaration(document.paths));\n  }\n  return declarations;\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/document/exploded-query.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+const FORM_STYLE = "form";
+function resolvedSchema(schema, refs, seen) {
+  if (typeof schema !== "object" || schema === null) {
+    return null;
+  }
+  if (!("$ref" in schema)) {
+    return schema;
+  }
+  if (seen.has(schema.$ref)) {
+    return null;
+  }
+  const target = refs.resolve(schema.$ref);
+  return target === void 0 ? null : resolvedSchema(target, refs, /* @__PURE__ */ new Set([...seen, schema.$ref]));
+}
+function nonNullTypes(schema) {
+  const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+  return types.filter((type) => type !== void 0 && type !== null && type !== "null");
+}
+function isObjectComposition(members, refs, seen) {
+  return members !== void 0 && members.length > 0 && members.every((member) => isObjectSchemaWith(member, refs, seen));
+}
+function isObjectSchemaWith(schema, refs, seen) {
+  const resolved = resolvedSchema(schema, refs, seen);
+  if (resolved === null) {
+    return false;
+  }
+  const types = nonNullTypes(resolved);
+  if (types.length > 0) {
+    return types.every((type) => type === "object");
+  }
+  return resolved.properties !== void 0 || resolved.additionalProperties !== void 0 || resolved.patternProperties !== void 0 || isObjectComposition(resolved.allOf, refs, seen) || isObjectComposition(resolved.oneOf, refs, seen) || isObjectComposition(resolved.anyOf, refs, seen);
+}
+function isObjectSchema(schema, refs) {
+  return isObjectSchemaWith(schema, refs, /* @__PURE__ */ new Set());
+}
+function isExplodedQueryObject(parameter, refs) {
+  const style = parameter.style ?? FORM_STYLE;
+  const explode = parameter.explode ?? style === FORM_STYLE;
+  return parameter.in === "query" && style === FORM_STYLE && explode && parameter.schema !== void 0 && isObjectSchema(parameter.schema, refs);
+}
+
+exports.isExplodedQueryObject = isExplodedQueryObject;
+exports.isObjectSchema = isObjectSchema;
+//# sourceMappingURL=exploded-query.cjs.map

package/dist/application/transform/document/exploded-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exploded-query.cjs","sources":["../../../../src/application/transform/document/exploded-query.ts"],"sourcesContent":["import type { ParameterObject } from \"../../../domain/openapi/parameter-object.js\";\nimport type { Schema, SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\n\n/**\n * Exploded object query parameters (OpenAPI 3.2 §4.8.12.4, upstream #2361). A query parameter has\n * `style: form` and, with it, `explode: true` by default. An object value is then sent as its own\n * `key=value` pairs, `?page=1&limit=10`: the parameter's name is not in the URL. So with the\n * `exploded-query-objects` fix, the object's properties are keys of `query`, not one key named\n * after the parameter.\n */\n\nconst FORM_STYLE = \"form\";\n\n/** Whether a `$ref` chain has been followed already, so a cycle ends. */\ntype SeenRefs = ReadonlySet<string>;\n\nfunction resolvedSchema(schema: Schema, refs: RefResolver, seen: SeenRefs): SchemaObject | null {\n  if (typeof schema !== \"object\" || schema === null) {\n    return null;\n  }\n  if (!(\"$ref\" in schema)) {\n    return schema;\n  }\n  if (seen.has(schema.$ref)) {\n    return null;\n  }\n  const target = refs.resolve(schema.$ref) as Schema | undefined;\n  return target === undefined\n    ? null\n    : resolvedSchema(target, refs, new Set([...seen, schema.$ref]));\n}\n\n/** The types of a `type` keyword other than `null`; empty when it has none. */\nfunction nonNullTypes(schema: SchemaObject): readonly unknown[] {\n  const types = Array.isArray(schema.type) ? schema.type : [schema.type];\n  return types.filter((type) => type !== undefined && type !== null && type !== \"null\");\n}\n\n/** Whether every member of a composition is an object schema; false for an empty list. */\nfunction isObjectComposition(\n  members: readonly Schema[] | undefined,\n  refs: RefResolver,\n  seen: SeenRefs,\n): boolean {\n  return (\n    members !== undefined &&\n    members.length > 0 &&\n    members.every((member) => isObjectSchemaWith(member, refs, seen))\n  );\n}\n\nfunction isObjectSchemaWith(schema: Schema, refs: RefResolver, seen: SeenRefs): boolean {\n  const resolved = resolvedSchema(schema, refs, seen);\n  if (resolved === null) {\n    return false;\n  }\n  const types = nonNullTypes(resolved);\n  if (types.length > 0) {\n    return types.every((type) => type === \"object\");\n  }\n  return (\n    resolved.properties !== undefined ||\n    resolved.additionalProperties !== undefined ||\n    resolved.patternProperties !== undefined ||\n    isObjectComposition(resolved.allOf, refs, seen) ||\n    isObjectComposition(resolved.oneOf, refs, seen) ||\n    isObjectComposition(resolved.anyOf, refs, seen)\n  );\n}\n\n/**\n * Whether the schema describes only objects: `type: object` (with `null` or not), or no `type`\n * and object keywords, or a composition of such schemas. A `$ref` is followed.\n */\nexport function isObjectSchema(schema: Schema, refs: RefResolver): boolean {\n  return isObjectSchemaWith(schema, refs, new Set());\n}\n\n/** Whether an `in: query` parameter sends its object value as the object's own keys. */\nexport function isExplodedQueryObject(parameter: ParameterObject, refs: RefResolver): boolean {\n  const style = parameter.style ?? FORM_STYLE;\n  const explode = parameter.explode ?? style === FORM_STYLE;\n  return (\n    parameter.in === \"query\" &&\n    style === FORM_STYLE &&\n    explode &&\n    parameter.schema !== undefined &&\n    isObjectSchema(parameter.schema, refs)\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/document/exploded-query.mjs

@@ -0,0 +1,43 @@
+const FORM_STYLE = "form";
+function resolvedSchema(schema, refs, seen) {
+  if (typeof schema !== "object" || schema === null) {
+    return null;
+  }
+  if (!("$ref" in schema)) {
+    return schema;
+  }
+  if (seen.has(schema.$ref)) {
+    return null;
+  }
+  const target = refs.resolve(schema.$ref);
+  return target === void 0 ? null : resolvedSchema(target, refs, /* @__PURE__ */ new Set([...seen, schema.$ref]));
+}
+function nonNullTypes(schema) {
+  const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+  return types.filter((type) => type !== void 0 && type !== null && type !== "null");
+}
+function isObjectComposition(members, refs, seen) {
+  return members !== void 0 && members.length > 0 && members.every((member) => isObjectSchemaWith(member, refs, seen));
+}
+function isObjectSchemaWith(schema, refs, seen) {
+  const resolved = resolvedSchema(schema, refs, seen);
+  if (resolved === null) {
+    return false;
+  }
+  const types = nonNullTypes(resolved);
+  if (types.length > 0) {
+    return types.every((type) => type === "object");
+  }
+  return resolved.properties !== void 0 || resolved.additionalProperties !== void 0 || resolved.patternProperties !== void 0 || isObjectComposition(resolved.allOf, refs, seen) || isObjectComposition(resolved.oneOf, refs, seen) || isObjectComposition(resolved.anyOf, refs, seen);
+}
+function isObjectSchema(schema, refs) {
+  return isObjectSchemaWith(schema, refs, /* @__PURE__ */ new Set());
+}
+function isExplodedQueryObject(parameter, refs) {
+  const style = parameter.style ?? FORM_STYLE;
+  const explode = parameter.explode ?? style === FORM_STYLE;
+  return parameter.in === "query" && style === FORM_STYLE && explode && parameter.schema !== void 0 && isObjectSchema(parameter.schema, refs);
+}
+
+export { isExplodedQueryObject, isObjectSchema };
+//# sourceMappingURL=exploded-query.mjs.map

package/dist/application/transform/document/exploded-query.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exploded-query.mjs","sources":["../../../../src/application/transform/document/exploded-query.ts"],"sourcesContent":["import type { ParameterObject } from \"../../../domain/openapi/parameter-object.js\";\nimport type { Schema, SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\n\n/**\n * Exploded object query parameters (OpenAPI 3.2 §4.8.12.4, upstream #2361). A query parameter has\n * `style: form` and, with it, `explode: true` by default. An object value is then sent as its own\n * `key=value` pairs, `?page=1&limit=10`: the parameter's name is not in the URL. So with the\n * `exploded-query-objects` fix, the object's properties are keys of `query`, not one key named\n * after the parameter.\n */\n\nconst FORM_STYLE = \"form\";\n\n/** Whether a `$ref` chain has been followed already, so a cycle ends. */\ntype SeenRefs = ReadonlySet<string>;\n\nfunction resolvedSchema(schema: Schema, refs: RefResolver, seen: SeenRefs): SchemaObject | null {\n  if (typeof schema !== \"object\" || schema === null) {\n    return null;\n  }\n  if (!(\"$ref\" in schema)) {\n    return schema;\n  }\n  if (seen.has(schema.$ref)) {\n    return null;\n  }\n  const target = refs.resolve(schema.$ref) as Schema | undefined;\n  return target === undefined\n    ? null\n    : resolvedSchema(target, refs, new Set([...seen, schema.$ref]));\n}\n\n/** The types of a `type` keyword other than `null`; empty when it has none. */\nfunction nonNullTypes(schema: SchemaObject): readonly unknown[] {\n  const types = Array.isArray(schema.type) ? schema.type : [schema.type];\n  return types.filter((type) => type !== undefined && type !== null && type !== \"null\");\n}\n\n/** Whether every member of a composition is an object schema; false for an empty list. */\nfunction isObjectComposition(\n  members: readonly Schema[] | undefined,\n  refs: RefResolver,\n  seen: SeenRefs,\n): boolean {\n  return (\n    members !== undefined &&\n    members.length > 0 &&\n    members.every((member) => isObjectSchemaWith(member, refs, seen))\n  );\n}\n\nfunction isObjectSchemaWith(schema: Schema, refs: RefResolver, seen: SeenRefs): boolean {\n  const resolved = resolvedSchema(schema, refs, seen);\n  if (resolved === null) {\n    return false;\n  }\n  const types = nonNullTypes(resolved);\n  if (types.length > 0) {\n    return types.every((type) => type === \"object\");\n  }\n  return (\n    resolved.properties !== undefined ||\n    resolved.additionalProperties !== undefined ||\n    resolved.patternProperties !== undefined ||\n    isObjectComposition(resolved.allOf, refs, seen) ||\n    isObjectComposition(resolved.oneOf, refs, seen) ||\n    isObjectComposition(resolved.anyOf, refs, seen)\n  );\n}\n\n/**\n * Whether the schema describes only objects: `type: object` (with `null` or not), or no `type`\n * and object keywords, or a composition of such schemas. A `$ref` is followed.\n */\nexport function isObjectSchema(schema: Schema, refs: RefResolver): boolean {\n  return isObjectSchemaWith(schema, refs, new Set());\n}\n\n/** Whether an `in: query` parameter sends its object value as the object's own keys. */\nexport function isExplodedQueryObject(parameter: ParameterObject, refs: RefResolver): boolean {\n  const style = parameter.style ?? FORM_STYLE;\n  const explode = parameter.explode ?? style === FORM_STYLE;\n  return (\n    parameter.in === \"query\" &&\n    style === FORM_STYLE &&\n    explode &&\n    parameter.schema !== undefined &&\n    isObjectSchema(parameter.schema, refs)\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/document/global-type-references.cjs

@@ -0,0 +1,63 @@
+'use strict';
+
+const GLOBAL_TYPE_NAMES = /* @__PURE__ */ new Set([
+  "Array",
+  "Blob",
+  "Exclude",
+  "Extract",
+  "NonNullable",
+  "Omit",
+  "Partial",
+  "Pick",
+  "Readonly",
+  "ReadonlyArray",
+  "Record",
+  "Required"
+]);
+const GENERIC_USE = /\b([A-Z][A-Za-z]*)\s*</g;
+const SKIPPED_KEYS = /* @__PURE__ */ new Set(["origin", "comments"]);
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function addTextUses(text, used) {
+  for (const match of text.matchAll(GENERIC_USE)) {
+    const name = match[1] ?? "";
+    if (GLOBAL_TYPE_NAMES.has(name)) {
+      used.add(name);
+    }
+  }
+}
+function addNodeUses(node, used) {
+  if (node.kind === "reference" && typeof node.name === "string") {
+    if (GLOBAL_TYPE_NAMES.has(node.name)) {
+      used.add(node.name);
+    }
+  } else if ((node.kind === "raw" || node.kind === "rawDeclaration") && typeof node.text === "string") {
+    addTextUses(node.text, used);
+  }
+}
+function visit(value, used) {
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      visit(item, used);
+    }
+    return;
+  }
+  if (!isObject(value)) {
+    return;
+  }
+  addNodeUses(value, used);
+  for (const [key, child] of Object.entries(value)) {
+    if (!SKIPPED_KEYS.has(key)) {
+      visit(child, used);
+    }
+  }
+}
+function globalTypeReferences(declarations) {
+  const used = /* @__PURE__ */ new Set();
+  visit(declarations, used);
+  return used;
+}
+
+exports.globalTypeReferences = globalTypeReferences;
+//# sourceMappingURL=global-type-references.cjs.map

package/dist/application/transform/document/global-type-references.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-type-references.cjs","sources":["../../../../src/application/transform/document/global-type-references.ts"],"sourcesContent":["import type { IrDeclaration } from \"../../../domain/ir/nodes.js\";\n\n/**\n * The TypeScript global types that generated code can refer to: in references (`Record<string,\n * never>`, `Omit<…>`, the `Blob` of `--binary-as-blob`) and in the text of footer helpers\n * (`Exclude<…>`, `Readonly<…>`). A module declaration of the same name shadows the global: every\n * use of it then fails to compile, or silently names the module's type (`Blob`).\n */\nconst GLOBAL_TYPE_NAMES: ReadonlySet<string> = new Set([\n  \"Array\",\n  \"Blob\",\n  \"Exclude\",\n  \"Extract\",\n  \"NonNullable\",\n  \"Omit\",\n  \"Partial\",\n  \"Pick\",\n  \"Readonly\",\n  \"ReadonlyArray\",\n  \"Record\",\n  \"Required\",\n]);\n\nconst GENERIC_USE = /\\b([A-Z][A-Za-z]*)\\s*</g;\n\n/** `origin` holds the outside node a raw type was printed from; it is not part of the output. */\nconst SKIPPED_KEYS: ReadonlySet<string> = new Set([\"origin\", \"comments\"]);\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction addTextUses(text: string, used: Set<string>): void {\n  for (const match of text.matchAll(GENERIC_USE)) {\n    const name = match[1] ?? \"\";\n    if (GLOBAL_TYPE_NAMES.has(name)) {\n      used.add(name);\n    }\n  }\n}\n\nfunction addNodeUses(node: Readonly<Record<string, unknown>>, used: Set<string>): void {\n  if (node.kind === \"reference\" && typeof node.name === \"string\") {\n    if (GLOBAL_TYPE_NAMES.has(node.name)) {\n      used.add(node.name);\n    }\n  } else if (\n    (node.kind === \"raw\" || node.kind === \"rawDeclaration\") &&\n    typeof node.text === \"string\"\n  ) {\n    addTextUses(node.text, used);\n  }\n}\n\nfunction visit(value: unknown, used: Set<string>): void {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      visit(item, used);\n    }\n    return;\n  }\n  if (!isObject(value)) {\n    return;\n  }\n  addNodeUses(value, used);\n  for (const [key, child] of Object.entries(value)) {\n    if (!SKIPPED_KEYS.has(key)) {\n      visit(child, used);\n    }\n  }\n}\n\n/** The TypeScript global type names that the declarations refer to. */\nexport function globalTypeReferences(declarations: readonly IrDeclaration[]): Set<string> {\n  const used = new Set<string>();\n  visit(declarations, used);\n  return used;\n}\n"],"names":[],"mappings":";;AAQA,MAAM,iBAAA,uBAA6C,GAAA,CAAI;AAAA,EACrD,OAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,aAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA;AAAA,EACA,eAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAC,CAAA;AAED,MAAM,WAAA,GAAc,yBAAA;AAGpB,MAAM,+BAAoC,IAAI,GAAA,CAAI,CAAC,QAAA,EAAU,UAAU,CAAC,CAAA;AAExE,SAAS,SAAS,KAAA,EAA4D;AAC5E,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAEA,SAAS,WAAA,CAAY,MAAc,IAAA,EAAyB;AAC1D,EAAA,KAAA,MAAW,KAAA,IAAS,IAAA,CAAK,QAAA,CAAS,WAAW,CAAA,EAAG;AAC9C,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AACzB,IAAA,IAAI,iBAAA,CAAkB,GAAA,CAAI,IAAI,CAAA,EAAG;AAC/B,MAAA,IAAA,CAAK,IAAI,IAAI,CAAA;AAAA,IACf;AAAA,EACF;AACF;AAEA,SAAS,WAAA,CAAY,MAAyC,IAAA,EAAyB;AACrF,EAAA,IAAI,KAAK,IAAA,KAAS,WAAA,IAAe,OAAO,IAAA,CAAK,SAAS,QAAA,EAAU;AAC9D,IAAA,IAAI,iBAAA,CAAkB,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA,EAAG;AACpC,MAAA,IAAA,CAAK,GAAA,CAAI,KAAK,IAAI,CAAA;AAAA,IACpB;AAAA,EACF,CAAA,MAAA,IAAA,CACG,IAAA,CAAK,IAAA,KAAS,KAAA,IAAS,IAAA,CAAK,SAAS,gBAAA,KACtC,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,EACrB;AACA,IAAA,WAAA,CAAY,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,EAC7B;AACF;AAEA,SAAS,KAAA,CAAM,OAAgB,IAAA,EAAyB;AACtD,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,KAAA,CAAM,MAAM,IAAI,CAAA;AAAA,IAClB;AACA,IAAA;AAAA,EACF;AACA,EAAA,IAAI,CAAC,QAAA,CAAS,KAAK,CAAA,EAAG;AACpB,IAAA;AAAA,EACF;AACA,EAAA,WAAA,CAAY,OAAO,IAAI,CAAA;AACvB,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAChD,IAAA,IAAI,CAAC,YAAA,CAAa,GAAA,CAAI,GAAG,CAAA,EAAG;AAC1B,MAAA,KAAA,CAAM,OAAO,IAAI,CAAA;AAAA,IACnB;AAAA,EACF;AACF;AAGO,SAAS,qBAAqB,YAAA,EAAqD;AACxF,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,KAAA,CAAM,cAAc,IAAI,CAAA;AACxB,EAAA,OAAO,IAAA;AACT;;"}

package/dist/application/transform/document/global-type-references.mjs

@@ -0,0 +1,61 @@
+const GLOBAL_TYPE_NAMES = /* @__PURE__ */ new Set([
+  "Array",
+  "Blob",
+  "Exclude",
+  "Extract",
+  "NonNullable",
+  "Omit",
+  "Partial",
+  "Pick",
+  "Readonly",
+  "ReadonlyArray",
+  "Record",
+  "Required"
+]);
+const GENERIC_USE = /\b([A-Z][A-Za-z]*)\s*</g;
+const SKIPPED_KEYS = /* @__PURE__ */ new Set(["origin", "comments"]);
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function addTextUses(text, used) {
+  for (const match of text.matchAll(GENERIC_USE)) {
+    const name = match[1] ?? "";
+    if (GLOBAL_TYPE_NAMES.has(name)) {
+      used.add(name);
+    }
+  }
+}
+function addNodeUses(node, used) {
+  if (node.kind === "reference" && typeof node.name === "string") {
+    if (GLOBAL_TYPE_NAMES.has(node.name)) {
+      used.add(node.name);
+    }
+  } else if ((node.kind === "raw" || node.kind === "rawDeclaration") && typeof node.text === "string") {
+    addTextUses(node.text, used);
+  }
+}
+function visit(value, used) {
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      visit(item, used);
+    }
+    return;
+  }
+  if (!isObject(value)) {
+    return;
+  }
+  addNodeUses(value, used);
+  for (const [key, child] of Object.entries(value)) {
+    if (!SKIPPED_KEYS.has(key)) {
+      visit(child, used);
+    }
+  }
+}
+function globalTypeReferences(declarations) {
+  const used = /* @__PURE__ */ new Set();
+  visit(declarations, used);
+  return used;
+}
+
+export { globalTypeReferences };
+//# sourceMappingURL=global-type-references.mjs.map

package/dist/application/transform/document/global-type-references.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-type-references.mjs","sources":["../../../../src/application/transform/document/global-type-references.ts"],"sourcesContent":["import type { IrDeclaration } from \"../../../domain/ir/nodes.js\";\n\n/**\n * The TypeScript global types that generated code can refer to: in references (`Record<string,\n * never>`, `Omit<…>`, the `Blob` of `--binary-as-blob`) and in the text of footer helpers\n * (`Exclude<…>`, `Readonly<…>`). A module declaration of the same name shadows the global: every\n * use of it then fails to compile, or silently names the module's type (`Blob`).\n */\nconst GLOBAL_TYPE_NAMES: ReadonlySet<string> = new Set([\n  \"Array\",\n  \"Blob\",\n  \"Exclude\",\n  \"Extract\",\n  \"NonNullable\",\n  \"Omit\",\n  \"Partial\",\n  \"Pick\",\n  \"Readonly\",\n  \"ReadonlyArray\",\n  \"Record\",\n  \"Required\",\n]);\n\nconst GENERIC_USE = /\\b([A-Z][A-Za-z]*)\\s*</g;\n\n/** `origin` holds the outside node a raw type was printed from; it is not part of the output. */\nconst SKIPPED_KEYS: ReadonlySet<string> = new Set([\"origin\", \"comments\"]);\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction addTextUses(text: string, used: Set<string>): void {\n  for (const match of text.matchAll(GENERIC_USE)) {\n    const name = match[1] ?? \"\";\n    if (GLOBAL_TYPE_NAMES.has(name)) {\n      used.add(name);\n    }\n  }\n}\n\nfunction addNodeUses(node: Readonly<Record<string, unknown>>, used: Set<string>): void {\n  if (node.kind === \"reference\" && typeof node.name === \"string\") {\n    if (GLOBAL_TYPE_NAMES.has(node.name)) {\n      used.add(node.name);\n    }\n  } else if (\n    (node.kind === \"raw\" || node.kind === \"rawDeclaration\") &&\n    typeof node.text === \"string\"\n  ) {\n    addTextUses(node.text, used);\n  }\n}\n\nfunction visit(value: unknown, used: Set<string>): void {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      visit(item, used);\n    }\n    return;\n  }\n  if (!isObject(value)) {\n    return;\n  }\n  addNodeUses(value, used);\n  for (const [key, child] of Object.entries(value)) {\n    if (!SKIPPED_KEYS.has(key)) {\n      visit(child, used);\n    }\n  }\n}\n\n/** The TypeScript global type names that the declarations refer to. */\nexport function globalTypeReferences(declarations: readonly IrDeclaration[]): Set<string> {\n  const used = new Set<string>();\n  visit(declarations, used);\n  return used;\n}\n"],"names":[],"mappings":"AAQA,MAAM,iBAAA,uBAA6C,GAAA,CAAI;AAAA,EACrD,OAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,aAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA;AAAA,EACA,eAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAC,CAAA;AAED,MAAM,WAAA,GAAc,yBAAA;AAGpB,MAAM,+BAAoC,IAAI,GAAA,CAAI,CAAC,QAAA,EAAU,UAAU,CAAC,CAAA;AAExE,SAAS,SAAS,KAAA,EAA4D;AAC5E,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAEA,SAAS,WAAA,CAAY,MAAc,IAAA,EAAyB;AAC1D,EAAA,KAAA,MAAW,KAAA,IAAS,IAAA,CAAK,QAAA,CAAS,WAAW,CAAA,EAAG;AAC9C,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AACzB,IAAA,IAAI,iBAAA,CAAkB,GAAA,CAAI,IAAI,CAAA,EAAG;AAC/B,MAAA,IAAA,CAAK,IAAI,IAAI,CAAA;AAAA,IACf;AAAA,EACF;AACF;AAEA,SAAS,WAAA,CAAY,MAAyC,IAAA,EAAyB;AACrF,EAAA,IAAI,KAAK,IAAA,KAAS,WAAA,IAAe,OAAO,IAAA,CAAK,SAAS,QAAA,EAAU;AAC9D,IAAA,IAAI,iBAAA,CAAkB,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA,EAAG;AACpC,MAAA,IAAA,CAAK,GAAA,CAAI,KAAK,IAAI,CAAA;AAAA,IACpB;AAAA,EACF,CAAA,MAAA,IAAA,CACG,IAAA,CAAK,IAAA,KAAS,KAAA,IAAS,IAAA,CAAK,SAAS,gBAAA,KACtC,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,EACrB;AACA,IAAA,WAAA,CAAY,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,EAC7B;AACF;AAEA,SAAS,KAAA,CAAM,OAAgB,IAAA,EAAyB;AACtD,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,KAAA,CAAM,MAAM,IAAI,CAAA;AAAA,IAClB;AACA,IAAA;AAAA,EACF;AACA,EAAA,IAAI,CAAC,QAAA,CAAS,KAAK,CAAA,EAAG;AACpB,IAAA;AAAA,EACF;AACA,EAAA,WAAA,CAAY,OAAO,IAAI,CAAA;AACvB,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAChD,IAAA,IAAI,CAAC,YAAA,CAAa,GAAA,CAAI,GAAG,CAAA,EAAG;AAC1B,MAAA,KAAA,CAAM,OAAO,IAAI,CAAA;AAAA,IACnB;AAAA,EACF;AACF;AAGO,SAAS,qBAAqB,YAAA,EAAqD;AACxF,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,KAAA,CAAM,cAAc,IAAI,CAAA;AACxB,EAAA,OAAO,IAAA;AACT;;"}

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

@@ -0,0 +1,27 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const documentEntries = require('../document-entries.cjs');
+const schemaTransform = require('../schema/schema-transform.cjs');
+const sharedTypes = require('../shared-types.cjs');
+const documentMember = require('./document-member.cjs');
+const mediaType = require('./media-type.cjs');
+
+function headerType(header, location, context) {
+  if (header.schema) {
+    return schemaTransform.transformSchema(header.schema, location, context);
+  }
+  if (!header.content) {
+    return sharedTypes.UNKNOWN_TYPE;
+  }
+  const members = documentEntries.documentEntries(header.content, context.options).map(([contentType, entry]) => {
+    const path = `${location.path ?? "#"}/${jsonPointer.escapePointerSegment(contentType)}`;
+    const type = mediaType.contentEntryType(entry, { ...location, path }, context);
+    return documentMember.documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
+  });
+  return constructors.irObject(members);
+}
+
+exports.headerType = headerType;
+//# sourceMappingURL=header.cjs.map

package/dist/application/transform/document/header.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.cjs","sources":["../../../../src/application/transform/document/header.ts"],"sourcesContent":["import { irObject } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport type { HeaderObject } from \"../../../domain/openapi/header-object.js\";\nimport { escapePointerSegment } from \"../../../domain/openapi/json-pointer.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * A header's type (OpenAPI 3.1 §4.8.21): its schema, else an object with one property per media\n * type in `content`, else `unknown`.\n */\nexport function headerType(\n  header: HeaderObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (header.schema) {\n    return transformSchema(header.schema, location, context);\n  }\n  if (!header.content) {\n    return UNKNOWN_TYPE;\n  }\n  const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {\n    // Unlike other content maps, the original joins this path by hand: a missing path is `#`.\n    const path = `${location.path ?? \"#\"}/${escapePointerSegment(contentType)}`;\n    const type = contentEntryType(entry, { ...location, path }, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":["transformSchema","UNKNOWN_TYPE","documentEntries","escapePointerSegment","contentEntryType","documentMember","irObject"],"mappings":";;;;;;;;;;AAeO,SAAS,UAAA,CACd,MAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,OAAOA,+BAAA,CAAgB,MAAA,CAAO,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA;AAAA,EACzD;AACA,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,OAAOC,wBAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAA,GAAUC,+BAAA,CAAgB,MAAA,CAAO,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,WAAA,EAAa,KAAK,CAAA,KAAM;AAE7F,IAAA,MAAM,IAAA,GAAO,GAAG,QAAA,CAAS,IAAA,IAAQ,GAAG,CAAA,CAAA,EAAIC,gCAAA,CAAqB,WAAW,CAAC,CAAA,CAAA;AACzE,IAAA,MAAM,IAAA,GAAOC,2BAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AACnE,IAAA,OAAOC,6BAAA,CAAe,aAAa,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAOC,sBAAS,OAAO,CAAA;AACzB;;"}

package/dist/application/transform/document/header.mjs

@@ -0,0 +1,25 @@
+import { irObject } from '../../../domain/ir/constructors.mjs';
+import { escapePointerSegment } from '../../../domain/openapi/json-pointer.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { transformSchema } from '../schema/schema-transform.mjs';
+import { UNKNOWN_TYPE } from '../shared-types.mjs';
+import { documentMember } from './document-member.mjs';
+import { contentEntryType } from './media-type.mjs';
+
+function headerType(header, location, context) {
+  if (header.schema) {
+    return transformSchema(header.schema, location, context);
+  }
+  if (!header.content) {
+    return UNKNOWN_TYPE;
+  }
+  const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {
+    const path = `${location.path ?? "#"}/${escapePointerSegment(contentType)}`;
+    const type = contentEntryType(entry, { ...location, path }, context);
+    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
+  });
+  return irObject(members);
+}
+
+export { headerType };
+//# sourceMappingURL=header.mjs.map

package/dist/application/transform/document/header.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.mjs","sources":["../../../../src/application/transform/document/header.ts"],"sourcesContent":["import { irObject } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport type { HeaderObject } from \"../../../domain/openapi/header-object.js\";\nimport { escapePointerSegment } from \"../../../domain/openapi/json-pointer.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * A header's type (OpenAPI 3.1 §4.8.21): its schema, else an object with one property per media\n * type in `content`, else `unknown`.\n */\nexport function headerType(\n  header: HeaderObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (header.schema) {\n    return transformSchema(header.schema, location, context);\n  }\n  if (!header.content) {\n    return UNKNOWN_TYPE;\n  }\n  const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {\n    // Unlike other content maps, the original joins this path by hand: a missing path is `#`.\n    const path = `${location.path ?? \"#\"}/${escapePointerSegment(contentType)}`;\n    const type = contentEntryType(entry, { ...location, path }, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":[],"mappings":";;;;;;;;AAeO,SAAS,UAAA,CACd,MAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,OAAO,eAAA,CAAgB,MAAA,CAAO,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA;AAAA,EACzD;AACA,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,OAAO,YAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,MAAA,CAAO,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,WAAA,EAAa,KAAK,CAAA,KAAM;AAE7F,IAAA,MAAM,IAAA,GAAO,GAAG,QAAA,CAAS,IAAA,IAAQ,GAAG,CAAA,CAAA,EAAI,oBAAA,CAAqB,WAAW,CAAC,CAAA,CAAA;AACzE,IAAA,MAAM,IAAA,GAAO,iBAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AACnE,IAAA,OAAO,cAAA,CAAe,aAAa,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,SAAS,OAAO,CAAA;AACzB;;"}

package/dist/application/transform/document/kept-deprecated.cjs

@@ -0,0 +1,96 @@
+'use strict';
+
+const componentsObject = require('../../../domain/openapi/components-object.cjs');
+const documentEntries = require('../document-entries.cjs');
+
+const UNTYPED_KEYS = /* @__PURE__ */ new Set([
+  "callbacks",
+  "discriminator",
+  "example",
+  "examples",
+  "externalDocs",
+  "links",
+  "security",
+  "securitySchemes",
+  "servers",
+  "xml"
+]);
+const EXTENSION_PREFIX = "x-";
+const RESOLVED_ENTRY_KEYS = /* @__PURE__ */ new Set([
+  "properties",
+  "parameters",
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace",
+  "query"
+]);
+const COMPONENTS_PREFIX = "#/components/";
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function refOf(value) {
+  return isObject(value) && typeof value.$ref === "string" ? value.$ref : void 0;
+}
+function isDroppedEntry(value, scan) {
+  const ref = refOf(value);
+  return documentEntries.isDeprecated(value) || ref !== void 0 && documentEntries.isDeprecated(scan.refs.resolve(ref));
+}
+function visitRef(ref, scan) {
+  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : void 0;
+  if (isObject(target) && documentEntries.isDeprecated(target) && !scan.kept.has(target)) {
+    scan.kept.add(target);
+    visitContents(target, scan);
+  }
+}
+function visitEntries(value, scan) {
+  for (const entry of Array.isArray(value) ? value : Object.values(value)) {
+    if (!isDroppedEntry(entry, scan)) {
+      visit(entry, scan);
+    }
+  }
+}
+function visit(node, scan) {
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      visit(item, scan);
+    }
+  } else if (isObject(node) && !documentEntries.isDeprecated(node)) {
+    visitContents(node, scan);
+  }
+}
+function visitContents(node, scan) {
+  const ref = refOf(node);
+  if (ref !== void 0) {
+    visitRef(ref, scan);
+  }
+  for (const [key, value] of Object.entries(node)) {
+    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {
+      continue;
+    }
+    if (RESOLVED_ENTRY_KEYS.has(key)) {
+      visitEntries(key === "properties" || key === "parameters" ? value : [value], scan);
+    } else {
+      visit(value, scan);
+    }
+  }
+}
+function keptComponentEntries(components) {
+  const kinds = [...componentsObject.COMPONENT_KINDS, ...componentsObject.DECLARED_COMPONENT_KINDS];
+  return kinds.flatMap(
+    (kind) => Object.values(components?.[kind] ?? {}).filter((item) => !documentEntries.isDeprecated(item))
+  );
+}
+function keptDeprecatedComponents(document, refs) {
+  const scan = { refs, kept: /* @__PURE__ */ new Set() };
+  visit([document.paths, document.webhooks, document.$defs], scan);
+  visit(keptComponentEntries(document.components), scan);
+  return scan.kept;
+}
+
+exports.keptDeprecatedComponents = keptDeprecatedComponents;
+//# sourceMappingURL=kept-deprecated.cjs.map

package/dist/application/transform/document/kept-deprecated.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-deprecated.cjs","sources":["../../../../src/application/transform/document/kept-deprecated.ts"],"sourcesContent":["import {\n  COMPONENT_KINDS,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n} from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport { isDeprecated } from \"../document-entries.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\n\n/**\n * `--exclude-deprecated` and references (roadmap R10.3, backlog 29). A deprecated component is\n * left out, but a kept schema may still point to it (an array's `items`, say), and the output then\n * names a missing `components` key. This scan finds the deprecated components that the kept output\n * references, so they are kept too. It follows the generator's rules: a property, parameter or\n * operation whose (resolved) object is deprecated is dropped, so its `$ref` does not count. Keys\n * that are not typed are not followed, so a component they name stays out, as before.\n */\n\n/** Keys whose contents the generator does not type. */\nconst UNTYPED_KEYS: ReadonlySet<string> = new Set([\n  \"callbacks\",\n  \"discriminator\",\n  \"example\",\n  \"examples\",\n  \"externalDocs\",\n  \"links\",\n  \"security\",\n  \"securitySchemes\",\n  \"servers\",\n  \"xml\",\n]);\nconst EXTENSION_PREFIX = \"x-\";\n/** Keys whose entries the generator drops when the entry or its `$ref` target is deprecated. */\nconst RESOLVED_ENTRY_KEYS: ReadonlySet<string> = new Set([\n  \"properties\",\n  \"parameters\",\n  \"get\",\n  \"put\",\n  \"post\",\n  \"delete\",\n  \"options\",\n  \"head\",\n  \"patch\",\n  \"trace\",\n  \"query\",\n]);\nconst COMPONENTS_PREFIX = \"#/components/\";\n\ninterface Scan {\n  readonly refs: RefResolver;\n  /** The deprecated components to keep, as the document's own objects. */\n  readonly kept: Set<object>;\n}\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction refOf(value: unknown): string | undefined {\n  return isObject(value) && typeof value.$ref === \"string\" ? value.$ref : undefined;\n}\n\n/** Whether a dropped-when-deprecated entry is dropped: its own or its target's `deprecated`. */\nfunction isDroppedEntry(value: unknown, scan: Scan): boolean {\n  const ref = refOf(value);\n  return isDeprecated(value) || (ref !== undefined && isDeprecated(scan.refs.resolve(ref)));\n}\n\n/** A `$ref` to a deprecated component keeps it, and the component is scanned once. */\nfunction visitRef(ref: string, scan: Scan): void {\n  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : undefined;\n  if (isObject(target) && isDeprecated(target) && !scan.kept.has(target)) {\n    scan.kept.add(target);\n    visitContents(target, scan);\n  }\n}\n\nfunction visitEntries(value: unknown, scan: Scan): void {\n  for (const entry of Array.isArray(value) ? value : Object.values(value as object)) {\n    if (!isDroppedEntry(entry, scan)) {\n      visit(entry, scan);\n    }\n  }\n}\n\n/** A node of kept output; a deprecated object here is dropped, so it is not followed. */\nfunction visit(node: unknown, scan: Scan): void {\n  if (Array.isArray(node)) {\n    for (const item of node) {\n      visit(item, scan);\n    }\n  } else if (isObject(node) && !isDeprecated(node)) {\n    visitContents(node, scan);\n  }\n}\n\n/** The `$ref` and the typed keys of an object. */\nfunction visitContents(node: Readonly<Record<string, unknown>>, scan: Scan): void {\n  const ref = refOf(node);\n  if (ref !== undefined) {\n    visitRef(ref, scan);\n  }\n  for (const [key, value] of Object.entries(node)) {\n    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {\n      continue;\n    }\n    if (RESOLVED_ENTRY_KEYS.has(key)) {\n      visitEntries(key === \"properties\" || key === \"parameters\" ? value : [value], scan);\n    } else {\n      visit(value, scan);\n    }\n  }\n}\n\n/** The kept (not deprecated) entries of the typed component kinds. */\nfunction keptComponentEntries(components: ComponentsObject | undefined): unknown[] {\n  const kinds = [...COMPONENT_KINDS, ...DECLARED_COMPONENT_KINDS];\n  return kinds.flatMap((kind) =>\n    Object.values(components?.[kind] ?? {}).filter((item) => !isDeprecated(item)),\n  );\n}\n\n/**\n * The deprecated components that kept output references, as the objects of `document.components`\n * (the resolver returns those), so names that need escaping in a `$ref` match too.\n */\nexport function keptDeprecatedComponents(\n  document: DocumentObject,\n  refs: RefResolver,\n): ReadonlySet<object> {\n  const scan: Scan = { refs, kept: new Set() };\n  visit([document.paths, document.webhooks, document.$defs], scan);\n  visit(keptComponentEntries(document.components), scan);\n  return scan.kept;\n}\n"],"names":["isDeprecated","COMPONENT_KINDS","DECLARED_COMPONENT_KINDS"],"mappings":"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"}

package/dist/application/transform/document/kept-deprecated.mjs

@@ -0,0 +1,94 @@
+import { COMPONENT_KINDS, DECLARED_COMPONENT_KINDS } from '../../../domain/openapi/components-object.mjs';
+import { isDeprecated } from '../document-entries.mjs';
+
+const UNTYPED_KEYS = /* @__PURE__ */ new Set([
+  "callbacks",
+  "discriminator",
+  "example",
+  "examples",
+  "externalDocs",
+  "links",
+  "security",
+  "securitySchemes",
+  "servers",
+  "xml"
+]);
+const EXTENSION_PREFIX = "x-";
+const RESOLVED_ENTRY_KEYS = /* @__PURE__ */ new Set([
+  "properties",
+  "parameters",
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace",
+  "query"
+]);
+const COMPONENTS_PREFIX = "#/components/";
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function refOf(value) {
+  return isObject(value) && typeof value.$ref === "string" ? value.$ref : void 0;
+}
+function isDroppedEntry(value, scan) {
+  const ref = refOf(value);
+  return isDeprecated(value) || ref !== void 0 && isDeprecated(scan.refs.resolve(ref));
+}
+function visitRef(ref, scan) {
+  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : void 0;
+  if (isObject(target) && isDeprecated(target) && !scan.kept.has(target)) {
+    scan.kept.add(target);
+    visitContents(target, scan);
+  }
+}
+function visitEntries(value, scan) {
+  for (const entry of Array.isArray(value) ? value : Object.values(value)) {
+    if (!isDroppedEntry(entry, scan)) {
+      visit(entry, scan);
+    }
+  }
+}
+function visit(node, scan) {
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      visit(item, scan);
+    }
+  } else if (isObject(node) && !isDeprecated(node)) {
+    visitContents(node, scan);
+  }
+}
+function visitContents(node, scan) {
+  const ref = refOf(node);
+  if (ref !== void 0) {
+    visitRef(ref, scan);
+  }
+  for (const [key, value] of Object.entries(node)) {
+    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {
+      continue;
+    }
+    if (RESOLVED_ENTRY_KEYS.has(key)) {
+      visitEntries(key === "properties" || key === "parameters" ? value : [value], scan);
+    } else {
+      visit(value, scan);
+    }
+  }
+}
+function keptComponentEntries(components) {
+  const kinds = [...COMPONENT_KINDS, ...DECLARED_COMPONENT_KINDS];
+  return kinds.flatMap(
+    (kind) => Object.values(components?.[kind] ?? {}).filter((item) => !isDeprecated(item))
+  );
+}
+function keptDeprecatedComponents(document, refs) {
+  const scan = { refs, kept: /* @__PURE__ */ new Set() };
+  visit([document.paths, document.webhooks, document.$defs], scan);
+  visit(keptComponentEntries(document.components), scan);
+  return scan.kept;
+}
+
+export { keptDeprecatedComponents };
+//# sourceMappingURL=kept-deprecated.mjs.map

package/dist/application/transform/document/kept-deprecated.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-deprecated.mjs","sources":["../../../../src/application/transform/document/kept-deprecated.ts"],"sourcesContent":["import {\n  COMPONENT_KINDS,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n} from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport { isDeprecated } from \"../document-entries.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\n\n/**\n * `--exclude-deprecated` and references (roadmap R10.3, backlog 29). A deprecated component is\n * left out, but a kept schema may still point to it (an array's `items`, say), and the output then\n * names a missing `components` key. This scan finds the deprecated components that the kept output\n * references, so they are kept too. It follows the generator's rules: a property, parameter or\n * operation whose (resolved) object is deprecated is dropped, so its `$ref` does not count. Keys\n * that are not typed are not followed, so a component they name stays out, as before.\n */\n\n/** Keys whose contents the generator does not type. */\nconst UNTYPED_KEYS: ReadonlySet<string> = new Set([\n  \"callbacks\",\n  \"discriminator\",\n  \"example\",\n  \"examples\",\n  \"externalDocs\",\n  \"links\",\n  \"security\",\n  \"securitySchemes\",\n  \"servers\",\n  \"xml\",\n]);\nconst EXTENSION_PREFIX = \"x-\";\n/** Keys whose entries the generator drops when the entry or its `$ref` target is deprecated. */\nconst RESOLVED_ENTRY_KEYS: ReadonlySet<string> = new Set([\n  \"properties\",\n  \"parameters\",\n  \"get\",\n  \"put\",\n  \"post\",\n  \"delete\",\n  \"options\",\n  \"head\",\n  \"patch\",\n  \"trace\",\n  \"query\",\n]);\nconst COMPONENTS_PREFIX = \"#/components/\";\n\ninterface Scan {\n  readonly refs: RefResolver;\n  /** The deprecated components to keep, as the document's own objects. */\n  readonly kept: Set<object>;\n}\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction refOf(value: unknown): string | undefined {\n  return isObject(value) && typeof value.$ref === \"string\" ? value.$ref : undefined;\n}\n\n/** Whether a dropped-when-deprecated entry is dropped: its own or its target's `deprecated`. */\nfunction isDroppedEntry(value: unknown, scan: Scan): boolean {\n  const ref = refOf(value);\n  return isDeprecated(value) || (ref !== undefined && isDeprecated(scan.refs.resolve(ref)));\n}\n\n/** A `$ref` to a deprecated component keeps it, and the component is scanned once. */\nfunction visitRef(ref: string, scan: Scan): void {\n  const target = ref.startsWith(COMPONENTS_PREFIX) ? scan.refs.resolve(ref) : undefined;\n  if (isObject(target) && isDeprecated(target) && !scan.kept.has(target)) {\n    scan.kept.add(target);\n    visitContents(target, scan);\n  }\n}\n\nfunction visitEntries(value: unknown, scan: Scan): void {\n  for (const entry of Array.isArray(value) ? value : Object.values(value as object)) {\n    if (!isDroppedEntry(entry, scan)) {\n      visit(entry, scan);\n    }\n  }\n}\n\n/** A node of kept output; a deprecated object here is dropped, so it is not followed. */\nfunction visit(node: unknown, scan: Scan): void {\n  if (Array.isArray(node)) {\n    for (const item of node) {\n      visit(item, scan);\n    }\n  } else if (isObject(node) && !isDeprecated(node)) {\n    visitContents(node, scan);\n  }\n}\n\n/** The `$ref` and the typed keys of an object. */\nfunction visitContents(node: Readonly<Record<string, unknown>>, scan: Scan): void {\n  const ref = refOf(node);\n  if (ref !== undefined) {\n    visitRef(ref, scan);\n  }\n  for (const [key, value] of Object.entries(node)) {\n    if (UNTYPED_KEYS.has(key) || key.startsWith(EXTENSION_PREFIX) || !isObject(value)) {\n      continue;\n    }\n    if (RESOLVED_ENTRY_KEYS.has(key)) {\n      visitEntries(key === \"properties\" || key === \"parameters\" ? value : [value], scan);\n    } else {\n      visit(value, scan);\n    }\n  }\n}\n\n/** The kept (not deprecated) entries of the typed component kinds. */\nfunction keptComponentEntries(components: ComponentsObject | undefined): unknown[] {\n  const kinds = [...COMPONENT_KINDS, ...DECLARED_COMPONENT_KINDS];\n  return kinds.flatMap((kind) =>\n    Object.values(components?.[kind] ?? {}).filter((item) => !isDeprecated(item)),\n  );\n}\n\n/**\n * The deprecated components that kept output references, as the objects of `document.components`\n * (the resolver returns those), so names that need escaping in a `$ref` match too.\n */\nexport function keptDeprecatedComponents(\n  document: DocumentObject,\n  refs: RefResolver,\n): ReadonlySet<object> {\n  const scan: Scan = { refs, kept: new Set() };\n  visit([document.paths, document.webhooks, document.$defs], scan);\n  visit(keptComponentEntries(document.components), scan);\n  return scan.kept;\n}\n"],"names":[],"mappings":"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"}