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

package/dist/application/transform/document/enum-names-given-back.mjs

@@ -0,0 +1,58 @@
+import { HELPER_TYPES, READ_WRITE_MARKER_TYPES } from '../helper-types.mjs';
+import { typeNamesInText, typeNamesDeclaredBy } from './declared-type-names.mjs';
+import { ROOT_KEYS, OPERATIONS_NAME } from './document.mjs';
+import { GLOBAL_TYPE_NAMES, globalTypeReferences } from './global-type-references.mjs';
+import { API_PATHS_NAME } from './paths-enum.mjs';
+import { isRootTypeAlias } from './root-type-aliases.mjs';
+
+const NAMES_THE_OUTPUT_MAY_NEED = /* @__PURE__ */ new Set([
+  ...GLOBAL_TYPE_NAMES,
+  ...Object.values(HELPER_TYPES).map(({ name }) => name),
+  ...typeNamesInText(READ_WRITE_MARKER_TYPES),
+  API_PATHS_NAME,
+  ...ROOT_KEYS,
+  OPERATIONS_NAME
+]);
+function namesTheOutputNeeds({ body, footer, closing }) {
+  const others = [
+    ...body.filter((declaration) => !isRootTypeAlias(declaration)),
+    ...footer.filter((declaration) => declaration.kind !== "enum"),
+    ...closing
+  ];
+  return /* @__PURE__ */ new Set([
+    ...globalTypeReferences([...body, ...footer, ...closing]),
+    ...typeNamesDeclaredBy(others)
+  ]);
+}
+const SKIPPED_KEYS = /* @__PURE__ */ new Set(["origin"]);
+const ENUM_REFERENCE_RE = /^(typeof )?([^.]+)(\..*)?$/s;
+function renamedReference(name, renames) {
+  const match = ENUM_REFERENCE_RE.exec(name);
+  const renamed = match === null ? void 0 : renames.get(match[2] ?? "");
+  return renamed === void 0 ? name : `${match?.[1] ?? ""}${renamed}${match?.[3] ?? ""}`;
+}
+function isNode(value) {
+  return typeof value === "object" && value !== null;
+}
+function renamedNode(value, renames) {
+  if (Array.isArray(value)) {
+    return value.map((item) => renamedNode(item, renames));
+  }
+  if (!isNode(value)) {
+    return value;
+  }
+  const node = Object.fromEntries(
+    Object.entries(value).map(([key, child]) => [
+      key,
+      SKIPPED_KEYS.has(key) ? child : renamedNode(child, renames)
+    ])
+  );
+  const isNamed = (node.kind === "reference" || node.kind === "enum") && typeof node.name === "string";
+  return isNamed ? { ...node, name: renamedReference(node.name, renames) } : node;
+}
+function withEnumsRenamed(declarations, renames) {
+  return renames.size === 0 ? [...declarations] : renamedNode(declarations, renames);
+}
+
+export { NAMES_THE_OUTPUT_MAY_NEED, namesTheOutputNeeds, withEnumsRenamed };
+//# sourceMappingURL=enum-names-given-back.mjs.map

package/dist/application/transform/document/enum-names-given-back.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-names-given-back.mjs","sources":["../../../../src/application/transform/document/enum-names-given-back.ts"],"sourcesContent":["import type { IrDeclaration } from \"../../../domain/ir/nodes.js\";\nimport { HELPER_TYPES, READ_WRITE_MARKER_TYPES } from \"../helper-types.js\";\nimport { typeNamesDeclaredBy, typeNamesInText } from \"./declared-type-names.js\";\nimport { OPERATIONS_NAME, ROOT_KEYS } from \"./document.js\";\nimport { GLOBAL_TYPE_NAMES, globalTypeReferences } from \"./global-type-references.js\";\nimport { API_PATHS_NAME } from \"./paths-enum.js\";\nimport { isRootTypeAlias } from \"./root-type-aliases.js\";\n\n/**\n * The second step of naming `--enum` declarations (`EnumNameClaims`): once the output is known,\n * an enum that gave way to a name the output turned out not to need gets that name back.\n */\n\n/**\n * The type names the output of a document may need, besides its enums: the global types it may\n * refer to and the names the generator declares itself. An enum avoids them until the end.\n */\nexport const NAMES_THE_OUTPUT_MAY_NEED: ReadonlySet<string> = new Set([\n  ...GLOBAL_TYPE_NAMES,\n  ...Object.values(HELPER_TYPES).map(({ name }) => name),\n  ...typeNamesInText(READ_WRITE_MARKER_TYPES),\n  API_PATHS_NAME,\n  ...ROOT_KEYS,\n  OPERATIONS_NAME,\n]);\n\n/** The parts of a transformed document; the footer holds only IR declarations here. */\nexport interface DocumentParts {\n  readonly body: readonly IrDeclaration[];\n  readonly footer: readonly IrDeclaration[];\n  readonly closing: readonly IrDeclaration[];\n}\n\n/**\n * The type names the output needs besides its enums: the globals it refers to, and the names of\n * its other declarations. Root aliases give way to enums (`renameTakenAliases`), so they count\n * for nothing.\n */\nexport function namesTheOutputNeeds({ body, footer, closing }: DocumentParts): Set<string> {\n  const others = [\n    ...body.filter((declaration) => !isRootTypeAlias(declaration)),\n    ...footer.filter((declaration) => declaration.kind !== \"enum\"),\n    ...closing,\n  ];\n  return new Set([\n    ...globalTypeReferences([...body, ...footer, ...closing]),\n    ...typeNamesDeclaredBy(others),\n  ]);\n}\n\n/** `origin` holds the compiler node a raw type was printed from; it is not IR. */\nconst SKIPPED_KEYS: ReadonlySet<string> = new Set([\"origin\"]);\n\n/** The enum references the generator writes: `Name`, `Name.member` and `typeof Name`. */\nconst ENUM_REFERENCE_RE = /^(typeof )?([^.]+)(\\..*)?$/s;\n\nfunction renamedReference(name: string, renames: ReadonlyMap<string, string>): string {\n  const match = ENUM_REFERENCE_RE.exec(name);\n  const renamed = match === null ? undefined : renames.get(match[2] ?? \"\");\n  return renamed === undefined ? name : `${match?.[1] ?? \"\"}${renamed}${match?.[3] ?? \"\"}`;\n}\n\nfunction isNode(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction renamedNode(value: unknown, renames: ReadonlyMap<string, string>): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => renamedNode(item, renames));\n  }\n  if (!isNode(value)) {\n    return value;\n  }\n  const node = Object.fromEntries(\n    Object.entries(value).map(([key, child]) => [\n      key,\n      SKIPPED_KEYS.has(key) ? child : renamedNode(child, renames),\n    ]),\n  );\n  const isNamed =\n    (node.kind === \"reference\" || node.kind === \"enum\") && typeof node.name === \"string\";\n  return isNamed ? { ...node, name: renamedReference(node.name as string, renames) } : node;\n}\n\n/** The declarations with each enum in `renames` (old name to new) renamed, references too. */\nexport function withEnumsRenamed<T extends IrDeclaration>(\n  declarations: readonly T[],\n  renames: ReadonlyMap<string, string>,\n): T[] {\n  return renames.size === 0 ? [...declarations] : (renamedNode(declarations, renames) as T[]);\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,63 @@
+'use strict';
+
+const schemaTransform = require('../schema/schema-transform.cjs');
+const typeCombinators = require('../type-combinators.cjs');
+
+function refOf(value) {
+  const ref = value?.$ref;
+  return typeof ref === "string" ? ref : void 0;
+}
+function declaredSchema(schema, ref, context) {
+  let declared = { schema, path: ref };
+  const seen = /* @__PURE__ */ new Set();
+  for (let next = refOf(schema); next !== void 0 && !seen.has(next); ) {
+    seen.add(next);
+    declared = { schema: context.refs.resolve(next), path: next };
+    next = refOf(declared.schema);
+  }
+  return declared;
+}
+function declaredObjectType(entry, context) {
+  const { original, resolved } = entry;
+  const schemaRef = refOf(resolved.schema);
+  if (schemaRef !== void 0) {
+    const { schema, path } = declaredSchema(resolved.schema, schemaRef, context);
+    return schemaTransform.transformSchema(schema, { path, schema }, context);
+  }
+  const parameterRef = refOf(original);
+  return parameterRef === void 0 ? null : schemaTransform.transformSchema(resolved.schema, { path: parameterRef, schema: resolved }, context);
+}
+function isIndexSignature(member) {
+  return member.kind === "indexSignature";
+}
+function hasIndexSignature(type) {
+  switch (type.kind) {
+    case "object":
+      return type.members.some(isIndexSignature);
+    case "union":
+    case "intersection":
+      return type.types.some(hasIndexSignature);
+    default:
+      return false;
+  }
+}
+function widenedMember(member, values) {
+  const isUnknown = member.type.kind === "keyword" && member.type.keyword === "unknown";
+  return isIndexSignature(member) && !isUnknown ? { ...member, type: typeCombinators.unionOf([member.type, ...values]) } : member;
+}
+function withIndexValues(type, values) {
+  switch (type.kind) {
+    case "object":
+      return { ...type, members: type.members.map((member) => widenedMember(member, values)) };
+    case "union":
+    case "intersection":
+      return { ...type, types: type.types.map((member) => withIndexValues(member, values)) };
+    default:
+      return type;
+  }
+}
+
+exports.declaredObjectType = declaredObjectType;
+exports.hasIndexSignature = hasIndexSignature;
+exports.withIndexValues = withIndexValues;
+//# sourceMappingURL=exploded-query-values.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exploded-query-values.cjs","sources":["../../../../src/application/transform/document/exploded-query-values.ts"],"sourcesContent":["import type { IrMember, IrType } from \"../../../domain/ir/nodes.js\";\nimport type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { unionOf } from \"../type-combinators.js\";\nimport type { ResolvedEntry } from \"./parameter-entries.js\";\n\n/**\n * `exploded-query-objects` and index signatures. The keys of an exploded object are keys of\n * `query`, next to the other parameters. TypeScript checks an index signature against every key\n * of a value, so `{ page?: number } & { [key: string]: string }` admits no `page`, and no value\n * with another parameter at all. An index signature of an exploded object therefore also takes\n * the value types of the other keys of `query`: those keys carry their own values.\n */\n\nfunction refOf(value: unknown): string | undefined {\n  const ref = (value as { $ref?: unknown } | undefined)?.$ref;\n  return typeof ref === \"string\" ? ref : undefined;\n}\n\n/** A schema `$ref` chain followed to its end, with the pointer where that schema is declared. */\nfunction declaredSchema(schema: Schema | undefined, ref: string, context: TransformContext) {\n  let declared = { schema, path: ref };\n  const seen = new Set<string>();\n  for (let next = refOf(schema); next !== undefined && !seen.has(next); ) {\n    seen.add(next);\n    declared = { schema: context.refs.resolve(next) as Schema | undefined, path: next };\n    next = refOf(declared.schema);\n  }\n  return declared;\n}\n\n/**\n * The type of an exploded parameter whose own type is a reference (its `$ref`, or the `$ref` of\n * its schema), written out where its schema is declared: the index signature of a referenced type\n * cannot be changed. The location is the one `components` types it at, so the enums it declares\n * are the ones the reference names. Null when no `$ref` is involved.\n */\nexport function declaredObjectType(entry: ResolvedEntry, context: TransformContext): IrType | null {\n  const { original, resolved } = entry;\n  const schemaRef = refOf(resolved.schema);\n  if (schemaRef !== undefined) {\n    const { schema, path } = declaredSchema(resolved.schema, schemaRef, context);\n    return transformSchema(schema, { path, schema }, context);\n  }\n  const parameterRef = refOf(original);\n  return parameterRef === undefined\n    ? null\n    : transformSchema(resolved.schema, { path: parameterRef, schema: resolved }, context);\n}\n\nfunction isIndexSignature(member: IrMember): boolean {\n  return member.kind === \"indexSignature\";\n}\n\n/** Whether the type has an index signature in its objects, through unions and intersections. */\nexport function hasIndexSignature(type: IrType): boolean {\n  switch (type.kind) {\n    case \"object\":\n      return type.members.some(isIndexSignature);\n    case \"union\":\n    case \"intersection\":\n      return type.types.some(hasIndexSignature);\n    default:\n      return false;\n  }\n}\n\nfunction widenedMember(member: IrMember, values: readonly IrType[]): IrMember {\n  // `unknown` takes every value already.\n  const isUnknown = member.type.kind === \"keyword\" && member.type.keyword === \"unknown\";\n  return isIndexSignature(member) && !isUnknown\n    ? { ...member, type: unionOf([member.type, ...values]) }\n    : member;\n}\n\n/** The type with the values added to each index signature of its objects. */\nexport function withIndexValues(type: IrType, values: readonly IrType[]): IrType {\n  switch (type.kind) {\n    case \"object\":\n      return { ...type, members: type.members.map((member) => widenedMember(member, values)) };\n    case \"union\":\n    case \"intersection\":\n      return { ...type, types: type.types.map((member) => withIndexValues(member, values)) };\n    default:\n      return type;\n  }\n}\n"],"names":["transformSchema","unionOf"],"mappings":"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"}

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

@@ -0,0 +1,59 @@
+import { transformSchema } from '../schema/schema-transform.mjs';
+import { unionOf } from '../type-combinators.mjs';
+
+function refOf(value) {
+  const ref = value?.$ref;
+  return typeof ref === "string" ? ref : void 0;
+}
+function declaredSchema(schema, ref, context) {
+  let declared = { schema, path: ref };
+  const seen = /* @__PURE__ */ new Set();
+  for (let next = refOf(schema); next !== void 0 && !seen.has(next); ) {
+    seen.add(next);
+    declared = { schema: context.refs.resolve(next), path: next };
+    next = refOf(declared.schema);
+  }
+  return declared;
+}
+function declaredObjectType(entry, context) {
+  const { original, resolved } = entry;
+  const schemaRef = refOf(resolved.schema);
+  if (schemaRef !== void 0) {
+    const { schema, path } = declaredSchema(resolved.schema, schemaRef, context);
+    return transformSchema(schema, { path, schema }, context);
+  }
+  const parameterRef = refOf(original);
+  return parameterRef === void 0 ? null : transformSchema(resolved.schema, { path: parameterRef, schema: resolved }, context);
+}
+function isIndexSignature(member) {
+  return member.kind === "indexSignature";
+}
+function hasIndexSignature(type) {
+  switch (type.kind) {
+    case "object":
+      return type.members.some(isIndexSignature);
+    case "union":
+    case "intersection":
+      return type.types.some(hasIndexSignature);
+    default:
+      return false;
+  }
+}
+function widenedMember(member, values) {
+  const isUnknown = member.type.kind === "keyword" && member.type.keyword === "unknown";
+  return isIndexSignature(member) && !isUnknown ? { ...member, type: unionOf([member.type, ...values]) } : member;
+}
+function withIndexValues(type, values) {
+  switch (type.kind) {
+    case "object":
+      return { ...type, members: type.members.map((member) => widenedMember(member, values)) };
+    case "union":
+    case "intersection":
+      return { ...type, types: type.types.map((member) => withIndexValues(member, values)) };
+    default:
+      return type;
+  }
+}
+
+export { declaredObjectType, hasIndexSignature, withIndexValues };
+//# sourceMappingURL=exploded-query-values.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exploded-query-values.mjs","sources":["../../../../src/application/transform/document/exploded-query-values.ts"],"sourcesContent":["import type { IrMember, IrType } from \"../../../domain/ir/nodes.js\";\nimport type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { unionOf } from \"../type-combinators.js\";\nimport type { ResolvedEntry } from \"./parameter-entries.js\";\n\n/**\n * `exploded-query-objects` and index signatures. The keys of an exploded object are keys of\n * `query`, next to the other parameters. TypeScript checks an index signature against every key\n * of a value, so `{ page?: number } & { [key: string]: string }` admits no `page`, and no value\n * with another parameter at all. An index signature of an exploded object therefore also takes\n * the value types of the other keys of `query`: those keys carry their own values.\n */\n\nfunction refOf(value: unknown): string | undefined {\n  const ref = (value as { $ref?: unknown } | undefined)?.$ref;\n  return typeof ref === \"string\" ? ref : undefined;\n}\n\n/** A schema `$ref` chain followed to its end, with the pointer where that schema is declared. */\nfunction declaredSchema(schema: Schema | undefined, ref: string, context: TransformContext) {\n  let declared = { schema, path: ref };\n  const seen = new Set<string>();\n  for (let next = refOf(schema); next !== undefined && !seen.has(next); ) {\n    seen.add(next);\n    declared = { schema: context.refs.resolve(next) as Schema | undefined, path: next };\n    next = refOf(declared.schema);\n  }\n  return declared;\n}\n\n/**\n * The type of an exploded parameter whose own type is a reference (its `$ref`, or the `$ref` of\n * its schema), written out where its schema is declared: the index signature of a referenced type\n * cannot be changed. The location is the one `components` types it at, so the enums it declares\n * are the ones the reference names. Null when no `$ref` is involved.\n */\nexport function declaredObjectType(entry: ResolvedEntry, context: TransformContext): IrType | null {\n  const { original, resolved } = entry;\n  const schemaRef = refOf(resolved.schema);\n  if (schemaRef !== undefined) {\n    const { schema, path } = declaredSchema(resolved.schema, schemaRef, context);\n    return transformSchema(schema, { path, schema }, context);\n  }\n  const parameterRef = refOf(original);\n  return parameterRef === undefined\n    ? null\n    : transformSchema(resolved.schema, { path: parameterRef, schema: resolved }, context);\n}\n\nfunction isIndexSignature(member: IrMember): boolean {\n  return member.kind === \"indexSignature\";\n}\n\n/** Whether the type has an index signature in its objects, through unions and intersections. */\nexport function hasIndexSignature(type: IrType): boolean {\n  switch (type.kind) {\n    case \"object\":\n      return type.members.some(isIndexSignature);\n    case \"union\":\n    case \"intersection\":\n      return type.types.some(hasIndexSignature);\n    default:\n      return false;\n  }\n}\n\nfunction widenedMember(member: IrMember, values: readonly IrType[]): IrMember {\n  // `unknown` takes every value already.\n  const isUnknown = member.type.kind === \"keyword\" && member.type.keyword === \"unknown\";\n  return isIndexSignature(member) && !isUnknown\n    ? { ...member, type: unionOf([member.type, ...values]) }\n    : member;\n}\n\n/** The type with the values added to each index signature of its objects. */\nexport function withIndexValues(type: IrType, values: readonly IrType[]): IrType {\n  switch (type.kind) {\n    case \"object\":\n      return { ...type, members: type.members.map((member) => widenedMember(member, values)) };\n    case \"union\":\n    case \"intersection\":\n      return { ...type, types: type.types.map((member) => withIndexValues(member, values)) };\n    default:\n      return type;\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -59,5 +59,6 @@ function globalTypeReferences(declarations) {
   return used;
 }
 
+exports.GLOBAL_TYPE_NAMES = GLOBAL_TYPE_NAMES;
 exports.globalTypeReferences = globalTypeReferences;
 //# sourceMappingURL=global-type-references.cjs.map

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

@@ -1 +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;;"}
+{"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 */\nexport const 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":";;AAQO,MAAM,iBAAA,uBAA6C,GAAA,CAAI;AAAA,EAC5D,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;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

@@ -57,5 +57,5 @@ function globalTypeReferences(declarations) {
   return used;
 }
 
-export { globalTypeReferences };
+export { GLOBAL_TYPE_NAMES, globalTypeReferences };
 //# sourceMappingURL=global-type-references.mjs.map

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

@@ -1 +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;;"}
+{"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 */\nexport const 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":"AAQO,MAAM,iBAAA,uBAA6C,GAAA,CAAI;AAAA,EAC5D,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;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

@@ -2,11 +2,12 @@
 
 const constructors = require('../../../domain/ir/constructors.cjs');
 const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const outputFixes = require('../../../domain/output-fixes.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');
+const mediaType$1 = require('./media-type.cjs');
 
 function headerType(header, location, context) {
   if (header.schema) {
@@ -15,13 +16,20 @@ function headerType(header, location, context) {
   if (!header.content) {
     return sharedTypes.UNKNOWN_TYPE;
   }
+  if (context.options.fixes.has(outputFixes.FIX.PARAMETER_HEADER_CONTENT)) {
+    const first = Object.entries(header.content)[0];
+    return first === void 0 ? sharedTypes.UNKNOWN_TYPE : mediaType(...first, location, context);
+  }
   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);
+    const type = mediaType(contentType, entry, location, context);
     return documentMember.documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
   });
   return constructors.irObject(members);
 }
+function mediaType(contentType, entry, location, context) {
+  const path = `${location.path ?? "#"}/${jsonPointer.escapePointerSegment(contentType)}`;
+  return mediaType$1.contentEntryType(entry, { ...location, path }, context);
+}
 
 exports.headerType = headerType;
 //# sourceMappingURL=header.cjs.map

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

@@ -1 +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;;"}
+{"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 type { ContentMap } from \"../../../domain/openapi/media-type-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.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 the type of its `content`, else\n * `unknown`. `content` holds one media type whose schema describes the value; the original typed\n * it as an object with one property per media type, which the `parameter-header-content` fix\n * replaces by the media type's type, as for a parameter.\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  if (context.options.fixes.has(FIX.PARAMETER_HEADER_CONTENT)) {\n    // The first media type in document order, as for a parameter: `--alphabetize` sorts only\n    // the members it writes.\n    const first = Object.entries(header.content)[0];\n    return first === undefined ? UNKNOWN_TYPE : mediaType(...first, location, context);\n  }\n  const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {\n    const type = mediaType(contentType, entry, location, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n\n/** The type of one media type of a header, at the path the original gave it. */\nfunction mediaType(\n  contentType: string,\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // Unlike other content maps, the original joins this path by hand: a missing path is `#`.\n  const path = `${location.path ?? \"#\"}/${escapePointerSegment(contentType)}`;\n  return contentEntryType(entry, { ...location, path }, context);\n}\n"],"names":["transformSchema","UNKNOWN_TYPE","FIX","documentEntries","documentMember","irObject","escapePointerSegment","contentEntryType"],"mappings":";;;;;;;;;;;AAmBO,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,IAAI,QAAQ,OAAA,CAAQ,KAAA,CAAM,GAAA,CAAIC,eAAA,CAAI,wBAAwB,CAAA,EAAG;AAG3D,IAAA,MAAM,QAAQ,MAAA,CAAO,OAAA,CAAQ,MAAA,CAAO,OAAO,EAAE,CAAC,CAAA;AAC9C,IAAA,OAAO,UAAU,MAAA,GAAYD,wBAAA,GAAe,UAAU,GAAG,KAAA,EAAO,UAAU,OAAO,CAAA;AAAA,EACnF;AACA,EAAA,MAAM,OAAA,GAAUE,+BAAA,CAAgB,MAAA,CAAO,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,WAAA,EAAa,KAAK,CAAA,KAAM;AAC7F,IAAA,MAAM,IAAA,GAAO,SAAA,CAAU,WAAA,EAAa,KAAA,EAAO,UAAU,OAAO,CAAA;AAC5D,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;AAGA,SAAS,SAAA,CACP,WAAA,EACA,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,MAAM,IAAA,GAAO,GAAG,QAAA,CAAS,IAAA,IAAQ,GAAG,CAAA,CAAA,EAAIC,gCAAA,CAAqB,WAAW,CAAC,CAAA,CAAA;AACzE,EAAA,OAAOC,6BAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;;"}

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

@@ -1,5 +1,6 @@
 import { irObject } from '../../../domain/ir/constructors.mjs';
 import { escapePointerSegment } from '../../../domain/openapi/json-pointer.mjs';
+import { FIX } from '../../../domain/output-fixes.mjs';
 import { documentEntries } from '../document-entries.mjs';
 import { transformSchema } from '../schema/schema-transform.mjs';
 import { UNKNOWN_TYPE } from '../shared-types.mjs';
@@ -13,13 +14,20 @@ function headerType(header, location, context) {
   if (!header.content) {
     return UNKNOWN_TYPE;
   }
+  if (context.options.fixes.has(FIX.PARAMETER_HEADER_CONTENT)) {
+    const first = Object.entries(header.content)[0];
+    return first === void 0 ? UNKNOWN_TYPE : mediaType(...first, location, context);
+  }
   const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {
-    const path = `${location.path ?? "#"}/${escapePointerSegment(contentType)}`;
-    const type = contentEntryType(entry, { ...location, path }, context);
+    const type = mediaType(contentType, entry, location, context);
     return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
   });
   return irObject(members);
 }
+function mediaType(contentType, entry, location, context) {
+  const path = `${location.path ?? "#"}/${escapePointerSegment(contentType)}`;
+  return contentEntryType(entry, { ...location, path }, context);
+}
 
 export { headerType };
 //# sourceMappingURL=header.mjs.map

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

@@ -1 +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;;"}
+{"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 type { ContentMap } from \"../../../domain/openapi/media-type-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.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 the type of its `content`, else\n * `unknown`. `content` holds one media type whose schema describes the value; the original typed\n * it as an object with one property per media type, which the `parameter-header-content` fix\n * replaces by the media type's type, as for a parameter.\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  if (context.options.fixes.has(FIX.PARAMETER_HEADER_CONTENT)) {\n    // The first media type in document order, as for a parameter: `--alphabetize` sorts only\n    // the members it writes.\n    const first = Object.entries(header.content)[0];\n    return first === undefined ? UNKNOWN_TYPE : mediaType(...first, location, context);\n  }\n  const members = documentEntries(header.content, context.options).map(([contentType, entry]) => {\n    const type = mediaType(contentType, entry, location, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n\n/** The type of one media type of a header, at the path the original gave it. */\nfunction mediaType(\n  contentType: string,\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // Unlike other content maps, the original joins this path by hand: a missing path is `#`.\n  const path = `${location.path ?? \"#\"}/${escapePointerSegment(contentType)}`;\n  return contentEntryType(entry, { ...location, path }, context);\n}\n"],"names":[],"mappings":";;;;;;;;;AAmBO,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,IAAI,QAAQ,OAAA,CAAQ,KAAA,CAAM,GAAA,CAAI,GAAA,CAAI,wBAAwB,CAAA,EAAG;AAG3D,IAAA,MAAM,QAAQ,MAAA,CAAO,OAAA,CAAQ,MAAA,CAAO,OAAO,EAAE,CAAC,CAAA;AAC9C,IAAA,OAAO,UAAU,MAAA,GAAY,YAAA,GAAe,UAAU,GAAG,KAAA,EAAO,UAAU,OAAO,CAAA;AAAA,EACnF;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;AAC7F,IAAA,MAAM,IAAA,GAAO,SAAA,CAAU,WAAA,EAAa,KAAA,EAAO,UAAU,OAAO,CAAA;AAC5D,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;AAGA,SAAS,SAAA,CACP,WAAA,EACA,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,MAAM,IAAA,GAAO,GAAG,QAAA,CAAS,IAAA,IAAQ,GAAG,CAAA,CAAA,EAAI,oBAAA,CAAqB,WAAW,CAAC,CAAA,CAAA;AACzE,EAAA,OAAO,iBAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;;"}

package/dist/application/transform/document/media-type.cjs

@@ -21,11 +21,11 @@ function itemSchemaAt(entry, path, context) {
     const resolved = mediaTypeObject.isMediaTypeComponentRef(entry.$ref) ? context.refs.resolve(entry.$ref) : void 0;
     return { schema: resolved?.itemSchema, path: jsonPointer.createRef([entry.$ref, "itemSchema"]) };
   }
-  return { schema: entry.itemSchema, path: jsonPointer.createRef([path, "itemSchema"]) };
+  return { schema: entry.itemSchema, path: jsonPointer.appendPointer(path, ["itemSchema"]) };
 }
 function itemContentMember(content, location, context, flags) {
   const members = documentEntries.documentEntries(content, context.options).flatMap(([mediaType, entry]) => {
-    const contentPath = jsonPointer.createRef([location.path, "content", mediaType]);
+    const contentPath = jsonPointer.appendPointer(location.path, ["content", mediaType]);
     const item = itemSchemaAt(entry, contentPath, context);
     if (item.schema === void 0) {
       return [];

package/dist/application/transform/document/media-type.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"media-type.cjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.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\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: createRef([path, \"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = createRef([location.path, \"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":["transformSchema","UNKNOWN_TYPE","isMediaTypeComponentRef","createRef","documentEntries","documentMember","irProperty","toPropertyName","irObject"],"mappings":";;;;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAASA,+BAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAIC,wBAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACbD,+BAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAWE,uCAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AACJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAMC,qBAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAMA,sBAAU,CAAC,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAC3E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAUC,+BAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAcD,qBAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,SAAS,CAAC,CAAA;AACnE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAOH,+BAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAACK,6BAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpBC,uBAAA,CAAWC,2BAAA,CAAe,gBAAgB,CAAA,EAAGC,qBAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;;;"}
+{"version":3,"file":"media-type.cjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer, createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.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\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    // `createRef` reads the `$ref` itself as a pointer; only the constant segment is appended.\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: appendPointer(path, [\"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = appendPointer(location.path, [\"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":["transformSchema","UNKNOWN_TYPE","isMediaTypeComponentRef","createRef","appendPointer","documentEntries","documentMember","irProperty","toPropertyName","irObject"],"mappings":";;;;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAASA,+BAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAIC,wBAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACbD,+BAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAWE,uCAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AAEJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAMC,qBAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAMC,0BAAc,IAAA,EAAM,CAAC,YAAY,CAAC,CAAA,EAAE;AAC/E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAUC,+BAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAcD,yBAAA,CAAc,QAAA,CAAS,MAAM,CAAC,SAAA,EAAW,SAAS,CAAC,CAAA;AACvE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAOJ,+BAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAACM,6BAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpBC,uBAAA,CAAWC,2BAAA,CAAe,gBAAgB,CAAA,EAAGC,qBAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;;;"}

package/dist/application/transform/document/media-type.mjs

@@ -1,6 +1,6 @@
 import { irProperty, irObject } from '../../../domain/ir/constructors.mjs';
 import { toPropertyName } from '../../../domain/ir/property-name.mjs';
-import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { appendPointer, createRef } from '../../../domain/openapi/json-pointer.mjs';
 import { isMediaTypeComponentRef } from '../../../domain/openapi/media-type-object.mjs';
 import { documentEntries } from '../document-entries.mjs';
 import { transformSchema } from '../schema/schema-transform.mjs';
@@ -19,11 +19,11 @@ function itemSchemaAt(entry, path, context) {
     const resolved = isMediaTypeComponentRef(entry.$ref) ? context.refs.resolve(entry.$ref) : void 0;
     return { schema: resolved?.itemSchema, path: createRef([entry.$ref, "itemSchema"]) };
   }
-  return { schema: entry.itemSchema, path: createRef([path, "itemSchema"]) };
+  return { schema: entry.itemSchema, path: appendPointer(path, ["itemSchema"]) };
 }
 function itemContentMember(content, location, context, flags) {
   const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {
-    const contentPath = createRef([location.path, "content", mediaType]);
+    const contentPath = appendPointer(location.path, ["content", mediaType]);
     const item = itemSchemaAt(entry, contentPath, context);
     if (item.schema === void 0) {
       return [];

package/dist/application/transform/document/media-type.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"media-type.mjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.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\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: createRef([path, \"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = createRef([location.path, \"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":[],"mappings":";;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAAS,eAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAI,YAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACb,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAW,uBAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AACJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAM,SAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAM,UAAU,CAAC,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAC3E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAc,SAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,SAAS,CAAC,CAAA;AACnE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAAC,cAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpB,UAAA,CAAW,cAAA,CAAe,gBAAgB,CAAA,EAAG,QAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;"}
+{"version":3,"file":"media-type.mjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer, createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.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\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    // `createRef` reads the `$ref` itself as a pointer; only the constant segment is appended.\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: appendPointer(path, [\"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = appendPointer(location.path, [\"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":[],"mappings":";;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAAS,eAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAI,YAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACb,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAW,uBAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AAEJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAM,SAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAM,cAAc,IAAA,EAAM,CAAC,YAAY,CAAC,CAAA,EAAE;AAC/E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAc,aAAA,CAAc,QAAA,CAAS,MAAM,CAAC,SAAA,EAAW,SAAS,CAAC,CAAA;AACvE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAAC,cAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpB,UAAA,CAAW,cAAA,CAAe,gBAAgB,CAAA,EAAG,QAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;"}

package/dist/application/transform/document/operation-keys-written.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+const appendAll = require('../../../domain/append-all.cjs');
+const pathItem = require('./path-item.cjs');
+
+function operationKeysWritten(document) {
+  const keys = /* @__PURE__ */ new Set();
+  const seen = /* @__PURE__ */ new WeakSet();
+  const pending = [document];
+  while (pending.length > 0) {
+    const value = pending.pop();
+    if (typeof value !== "object" || value === null || seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+    const { operationId } = value;
+    if (typeof operationId === "string") {
+      keys.add(pathItem.operationKeyOf(operationId));
+    }
+    appendAll.appendAll(pending, Object.values(value));
+  }
+  return keys;
+}
+
+exports.operationKeysWritten = operationKeysWritten;
+//# sourceMappingURL=operation-keys-written.cjs.map

package/dist/application/transform/document/operation-keys-written.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-keys-written.cjs","sources":["../../../../src/application/transform/document/operation-keys-written.ts"],"sourcesContent":["import { appendAll } from \"../../../domain/append-all.js\";\nimport { operationKeyOf } from \"./path-item.js\";\n\n/**\n * Every `operations` key that an `operationId` in the document asks for, so that a repeated ID\n * never gets a number another operation has as its own ID (`OperationKeys`). Operations can sit\n * in `paths`, `webhooks`, `components.pathItems` and callbacks, so the whole document is read. A\n * Link Object's `operationId` is read too; an extra name only makes a number skip it.\n */\nexport function operationKeysWritten(document: object): Set<string> {\n  const keys = new Set<string>();\n  const seen = new WeakSet<object>();\n  const pending: unknown[] = [document];\n  while (pending.length > 0) {\n    const value = pending.pop();\n    if (typeof value !== \"object\" || value === null || seen.has(value)) {\n      continue;\n    }\n    seen.add(value);\n    const { operationId } = value as { operationId?: unknown };\n    if (typeof operationId === \"string\") {\n      keys.add(operationKeyOf(operationId));\n    }\n    appendAll(pending, Object.values(value));\n  }\n  return keys;\n}\n"],"names":["operationKeyOf","appendAll"],"mappings":";;;;;AASO,SAAS,qBAAqB,QAAA,EAA+B;AAClE,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,IAAA,uBAAW,OAAA,EAAgB;AACjC,EAAA,MAAM,OAAA,GAAqB,CAAC,QAAQ,CAAA;AACpC,EAAA,OAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AACzB,IAAA,MAAM,KAAA,GAAQ,QAAQ,GAAA,EAAI;AAC1B,IAAA,IAAI,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,EAAG;AAClE,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAI,KAAK,CAAA;AACd,IAAA,MAAM,EAAE,aAAY,GAAI,KAAA;AACxB,IAAA,IAAI,OAAO,gBAAgB,QAAA,EAAU;AACnC,MAAA,IAAA,CAAK,GAAA,CAAIA,uBAAA,CAAe,WAAW,CAAC,CAAA;AAAA,IACtC;AACA,IAAAC,mBAAA,CAAU,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,IAAA;AACT;;"}

package/dist/application/transform/document/operation-keys-written.mjs

@@ -0,0 +1,24 @@
+import { appendAll } from '../../../domain/append-all.mjs';
+import { operationKeyOf } from './path-item.mjs';
+
+function operationKeysWritten(document) {
+  const keys = /* @__PURE__ */ new Set();
+  const seen = /* @__PURE__ */ new WeakSet();
+  const pending = [document];
+  while (pending.length > 0) {
+    const value = pending.pop();
+    if (typeof value !== "object" || value === null || seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+    const { operationId } = value;
+    if (typeof operationId === "string") {
+      keys.add(operationKeyOf(operationId));
+    }
+    appendAll(pending, Object.values(value));
+  }
+  return keys;
+}
+
+export { operationKeysWritten };
+//# sourceMappingURL=operation-keys-written.mjs.map

package/dist/application/transform/document/operation-keys-written.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-keys-written.mjs","sources":["../../../../src/application/transform/document/operation-keys-written.ts"],"sourcesContent":["import { appendAll } from \"../../../domain/append-all.js\";\nimport { operationKeyOf } from \"./path-item.js\";\n\n/**\n * Every `operations` key that an `operationId` in the document asks for, so that a repeated ID\n * never gets a number another operation has as its own ID (`OperationKeys`). Operations can sit\n * in `paths`, `webhooks`, `components.pathItems` and callbacks, so the whole document is read. A\n * Link Object's `operationId` is read too; an extra name only makes a number skip it.\n */\nexport function operationKeysWritten(document: object): Set<string> {\n  const keys = new Set<string>();\n  const seen = new WeakSet<object>();\n  const pending: unknown[] = [document];\n  while (pending.length > 0) {\n    const value = pending.pop();\n    if (typeof value !== \"object\" || value === null || seen.has(value)) {\n      continue;\n    }\n    seen.add(value);\n    const { operationId } = value as { operationId?: unknown };\n    if (typeof operationId === \"string\") {\n      keys.add(operationKeyOf(operationId));\n    }\n    appendAll(pending, Object.values(value));\n  }\n  return keys;\n}\n"],"names":[],"mappings":";;;AASO,SAAS,qBAAqB,QAAA,EAA+B;AAClE,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,IAAA,uBAAW,OAAA,EAAgB;AACjC,EAAA,MAAM,OAAA,GAAqB,CAAC,QAAQ,CAAA;AACpC,EAAA,OAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AACzB,IAAA,MAAM,KAAA,GAAQ,QAAQ,GAAA,EAAI;AAC1B,IAAA,IAAI,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,EAAG;AAClE,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAI,KAAK,CAAA;AACd,IAAA,MAAM,EAAE,aAAY,GAAI,KAAA;AACxB,IAAA,IAAI,OAAO,gBAAgB,QAAA,EAAU;AACnC,MAAA,IAAA,CAAK,GAAA,CAAI,cAAA,CAAe,WAAW,CAAC,CAAA;AAAA,IACtC;AACA,IAAA,SAAA,CAAU,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,IAAA;AACT;;"}

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

@@ -21,7 +21,7 @@ function requestBodyMember(operation, location, context) {
   const isReference = "$ref" in body;
   const type = isReference ? refType.refType(body.$ref) : requestBody.requestBodyType(
     body,
-    { ...location, path: jsonPointer.createRef([location.path, "requestBody"]) },
+    { ...location, path: jsonPointer.appendPointer(location.path, ["requestBody"]) },
     context
   );
   const resolved = isReference ? context.refs.resolve(body.$ref) : body;

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

@@ -1 +1 @@
-{"version":3,"file":"operation.cjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: createRef([location.path, \"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":["irProperty","toPropertyName","irKeyword","refType","requestBodyType","createRef","documentMember","parameters","parametersMember","responses","responsesType"],"mappings":";;;;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAOA,wBAAWC,2BAAA,CAAe,aAAa,CAAA,EAAGC,sBAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACTC,eAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjBC,2BAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAMC,qBAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,aAAa,CAAC,CAAA,EAAE;AAAA,IAC/D;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAOC,6BAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAMC,eAAaC,2BAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAMC,cAAYC,uBAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACLH,YAAA;AAAA,IACA,WAAA;AAAA,IACAP,uBAAA,CAAWC,2BAAA,CAAe,WAAW,CAAA,EAAGQ,WAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}
+{"version":3,"file":"operation.cjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: appendPointer(location.path, [\"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":["irProperty","toPropertyName","irKeyword","refType","requestBodyType","appendPointer","documentMember","parameters","parametersMember","responses","responsesType"],"mappings":";;;;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAOA,wBAAWC,2BAAA,CAAe,aAAa,CAAA,EAAGC,sBAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACTC,eAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjBC,2BAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAMC,yBAAA,CAAc,SAAS,IAAA,EAAM,CAAC,aAAa,CAAC,CAAA,EAAE;AAAA,IACnE;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAOC,6BAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAMC,eAAaC,2BAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAMC,cAAYC,uBAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACLH,YAAA;AAAA,IACA,WAAA;AAAA,IACAP,uBAAA,CAAWC,2BAAA,CAAe,WAAW,CAAA,EAAGQ,WAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}