openapi-typesafe 0.0.0 → 1.0.0-rc.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.mjs","sources":["../../../../src/application/transform/document/paths.ts"],"sourcesContent":["import { irIntersection, irObject, irProperty, irRaw } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { escapeTemplateText } from \"../../../domain/ir/raw-text-escapes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type {\n  ParameterObject,\n  ParameterOrReference,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport {\n  type PathItemObject,\n  type PathsObject,\n  pathItemOperations,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport type { ReferenceSchema, SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport { isCoveredPathItemRejected } from \"./path-item-conflicts.js\";\nimport {\n  coveringTemplateKeys,\n  type PathKey,\n  type PathKeyPart,\n  type PathPlaceholder,\n} from \"./path-key-overlaps.js\";\n\nconst PATH_PARAMETER_RE = /\\{[^}]+\\}/g;\n\n/** Placeholders by parameter schema type; anything else is a string placeholder. */\nconst PLACEHOLDERS: ReadonlyMap<unknown, PathPlaceholder> = new Map([\n  [\"number\", \"number\"],\n  [\"integer\", \"number\"],\n  [\"boolean\", \"boolean\"],\n]);\nconst STRING_PLACEHOLDER: PathPlaceholder = \"string\";\n\n/** `${type}`: the text of a template literal type placeholder. */\nfunction placeholderText(type: PathPlaceholder): string {\n  return `\\${${type}}`;\n}\n\nfunction resolvedParameter(\n  parameter: ParameterOrReference,\n  context: TransformContext,\n): ParameterObject | undefined {\n  return \"$ref\" in parameter && parameter.$ref\n    ? (context.refs.resolve(parameter.$ref) as ParameterObject | undefined)\n    : (parameter as ParameterObject);\n}\n\nfunction addPathParameters(\n  parameters: readonly ParameterOrReference[],\n  byName: Map<string, ParameterObject>,\n  context: TransformContext,\n): void {\n  for (const parameter of parameters) {\n    const resolved = resolvedParameter(parameter, context);\n    if (resolved && resolved.in === \"path\") {\n      byName.set(resolved.name, resolved);\n    }\n  }\n}\n\n/** Path parameters of the path item and of its operations; later definitions win. */\nfunction pathParameters(\n  pathItem: PathItemObject,\n  context: TransformContext,\n): Map<string, ParameterObject> {\n  const byName = new Map<string, ParameterObject>();\n  addPathParameters(pathItem.parameters ?? [], byName, context);\n  for (const { operation: entry } of pathItemOperations(pathItem)) {\n    const operation = (entry as ReferenceSchema).$ref\n      ? (context.refs.resolve((entry as ReferenceSchema).$ref) as OperationObject | undefined)\n      : (entry as OperationObject);\n    addPathParameters(operation?.parameters ?? [], byName, context);\n  }\n  return byName;\n}\n\n/**\n * `--path-params-as-types`: the URL as template parts, each `{name}` replaced by a placeholder for\n * its parameter's type. Null when the URL has no complete `{…}` placeholder.\n */\nfunction pathTemplateParts(\n  url: string,\n  pathItem: PathItemObject,\n  context: TransformContext,\n): PathKeyPart[] | null {\n  const matches = url.match(PATH_PARAMETER_RE);\n  if (!matches) {\n    return null;\n  }\n  const parameters = pathParameters(pathItem, context);\n  const placeholders = matches.map((match) => {\n    const schema = parameters.get(match.slice(1, -1))?.schema as SchemaObject | undefined;\n    return PLACEHOLDERS.get(schema?.type) ?? STRING_PLACEHOLDER;\n  });\n  return url.split(PATH_PARAMETER_RE).flatMap((text, index): PathKeyPart[] => {\n    const type = placeholders[index];\n    const textPart: PathKeyPart = { kind: \"text\", text };\n    return type === undefined ? [textPart] : [textPart, { kind: \"placeholder\", type }];\n  });\n}\n\n/**\n * The template literal type of the parts. The original escaped only backticks: a backslash or\n * `${` in the URL could end the literal or open a placeholder, and add code to the generated file\n * (intentional fix). So the text parts are escaped.\n */\nfunction templateText(parts: readonly PathKeyPart[]): string {\n  const text = parts\n    .map((part) =>\n      part.kind === \"text\" ? escapeTemplateText(part.text) : placeholderText(part.type),\n    )\n    .join(\"\");\n  return `\\`${text}\\``;\n}\n\n/** A path's member, its key and its path item type for the overlap check. */\ninterface PathMember {\n  readonly member: IrMember;\n  readonly key: PathKey;\n  readonly type: IrType;\n}\n\nfunction pathItemMember(\n  url: string,\n  pathItem: PathItemObject,\n  context: TransformContext,\n): PathMember {\n  const isReadonly = context.options.immutable;\n  const type = pathItemType(pathItem, { path: createRef([\"paths\", url]) }, context);\n  const parts =\n    context.options.pathParamsAsTypes && url.includes(\"{\")\n      ? pathTemplateParts(url, pathItem, context)\n      : null;\n  if (parts === null) {\n    const member = irProperty(toPropertyName(url), type, { isReadonly });\n    return { member, key: literalKey(url), type };\n  }\n  const member: IrMember = {\n    kind: \"indexSignature\",\n    parameterName: \"path\",\n    parameterType: irRaw(templateText(parts)),\n    type,\n    isReadonly,\n    comments: [],\n  };\n  return { member, key: { kind: \"template\", parts }, type };\n}\n\nfunction literalKey(url: string): PathKey {\n  return { kind: \"literal\", url };\n}\n\n/**\n * The members as one object type. When an index signature covers another key, TypeScript checks\n * the covered key's type against it. Where that check surely fails (TS2411, TS2413), each such\n * signature gets an object of its own in an intersection: an intersection does not check its parts\n * against each other, and every key has the type it had in the one object. Output that compiles\n * keeps the one object.\n */\nfunction pathsObjectType(paths: readonly PathMember[]): IrType {\n  const covering = coveringTemplateKeys(\n    paths.map(({ key }) => key),\n    (coveringIndex, coveredIndex) => {\n      const coveringPath = paths[coveringIndex];\n      const coveredPath = paths[coveredIndex];\n      return (\n        coveringPath !== undefined &&\n        coveredPath !== undefined &&\n        isCoveredPathItemRejected(coveredPath.type, coveringPath.type)\n      );\n    },\n  );\n  if (covering.size === 0) {\n    return irObject(paths.map(({ member }) => member));\n  }\n  const rest = paths.filter((_, index) => !covering.has(index)).map(({ member }) => member);\n  const own = paths\n    .filter((_, index) => covering.has(index))\n    .map(({ member }) => irObject([member]));\n  return irIntersection([irObject(rest), ...own]);\n}\n\n/** The `paths` interface body (OpenAPI 3.1 §4.8.8): one member per path, by URL. */\nexport function pathsType(paths: PathsObject, context: TransformContext): IrType {\n  const members: PathMember[] = [];\n  for (const [url, pathItem] of documentEntries(paths, context.options)) {\n    if (!pathItem || typeof pathItem !== \"object\") {\n      continue;\n    }\n    if (\"$ref\" in pathItem) {\n      const options = { isReadonly: context.options.immutable };\n      const member = documentMember(url, refType(pathItem.$ref), pathItem, options);\n      members.push({ member, key: literalKey(url), type: member.type });\n      continue;\n    }\n    const startedAt = context.diagnostics.now();\n    const path = pathItemMember(url, pathItem, context);\n    members.push(path);\n    // The original reports only paths written as properties.\n    if (path.member.kind === \"property\") {\n      context.diagnostics.debug(`Transformed path \"${url}\"`, context.diagnostics.now() - startedAt);\n    }\n  }\n  return pathsObjectType(members);\n}\n"],"names":["member"],"mappings":"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"}

package/dist/application/transform/document/request-body.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const propertyName = require('../../../domain/ir/property-name.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const documentEntries = require('../document-entries.cjs');
+const documentMember = require('./document-member.cjs');
+const mediaType = require('./media-type.cjs');
+
+const ANY_MEDIA_TYPE = "*/*";
+function contentMembers(requestBody, location, context) {
+  const entries = documentEntries.documentEntries(requestBody.content ?? {}, context.options);
+  return entries.map(([contentType, entry]) => {
+    const path = jsonPointer.createRef([location.path, "content", contentType]);
+    const type = mediaType.contentEntryType(entry, { ...location, path }, context);
+    return documentMember.documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
+  });
+}
+function requestBodyType(requestBody, location, context) {
+  const members = contentMembers(requestBody, location, context);
+  const placeholder = constructors.irProperty(propertyName.toPropertyName(ANY_MEDIA_TYPE), constructors.irKeyword("never"), {
+    isOptional: true
+  });
+  const content = constructors.irObject(members.length > 0 ? members : [placeholder]);
+  const isReadonly = context.options.immutable;
+  const itemContent = mediaType.itemContentMember(requestBody.content ?? {}, location, context, {
+    isReadonly
+  });
+  return constructors.irObject([
+    constructors.irProperty(propertyName.toPropertyName("content"), content, { isReadonly }),
+    ...itemContent ? [itemContent] : []
+  ]);
+}
+
+exports.requestBodyType = requestBodyType;
+//# sourceMappingURL=request-body.cjs.map

package/dist/application/transform/document/request-body.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-body.cjs","sources":["../../../../src/application/transform/document/request-body.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { contentEntryType, itemContentMember } from \"./media-type.js\";\n\n/** Stands in for the media types of a body that defines none: `\"*\\/*\"?: never`. */\nconst ANY_MEDIA_TYPE = \"*/*\";\n\nfunction contentMembers(\n  requestBody: RequestBodyObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrMember[] {\n  const entries = documentEntries(requestBody.content ?? {}, context.options);\n  return entries.map(([contentType, entry]) => {\n    const path = createRef([location.path, \"content\", contentType]);\n    const type = contentEntryType(entry, { ...location, path }, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n}\n\n/**\n * A request body (OpenAPI 3.2 §4.8.13): `{ content: { [mediaType]: T } }`, and `itemContent` when a\n * media type has an `itemSchema`.\n */\nexport function requestBodyType(\n  requestBody: RequestBodyObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const members = contentMembers(requestBody, location, context);\n  // The placeholder is never readonly, even with --immutable, as in the original.\n  const placeholder = irProperty(toPropertyName(ANY_MEDIA_TYPE), irKeyword(\"never\"), {\n    isOptional: true,\n  });\n  const content = irObject(members.length > 0 ? members : [placeholder]);\n  const isReadonly = context.options.immutable;\n  const itemContent = itemContentMember(requestBody.content ?? {}, location, context, {\n    isReadonly,\n  });\n  return irObject([\n    irProperty(toPropertyName(\"content\"), content, { isReadonly }),\n    ...(itemContent ? [itemContent] : []),\n  ]);\n}\n"],"names":["documentEntries","createRef","contentEntryType","documentMember","irProperty","toPropertyName","irKeyword","irObject","itemContentMember"],"mappings":";;;;;;;;;AAWA,MAAM,cAAA,GAAiB,KAAA;AAEvB,SAAS,cAAA,CACP,WAAA,EACA,QAAA,EACA,OAAA,EACY;AACZ,EAAA,MAAM,UAAUA,+BAAA,CAAgB,WAAA,CAAY,WAAW,EAAC,EAAG,QAAQ,OAAO,CAAA;AAC1E,EAAA,OAAO,QAAQ,GAAA,CAAI,CAAC,CAAC,WAAA,EAAa,KAAK,CAAA,KAAM;AAC3C,IAAA,MAAM,OAAOC,qBAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,WAAW,CAAC,CAAA;AAC9D,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;AACH;AAMO,SAAS,eAAA,CACd,WAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,OAAA,GAAU,cAAA,CAAe,WAAA,EAAa,QAAA,EAAU,OAAO,CAAA;AAE7D,EAAA,MAAM,cAAcC,uBAAA,CAAWC,2BAAA,CAAe,cAAc,CAAA,EAAGC,sBAAA,CAAU,OAAO,CAAA,EAAG;AAAA,IACjF,UAAA,EAAY;AAAA,GACb,CAAA;AACD,EAAA,MAAM,OAAA,GAAUC,sBAAS,OAAA,CAAQ,MAAA,GAAS,IAAI,OAAA,GAAU,CAAC,WAAW,CAAC,CAAA;AACrE,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,cAAcC,2BAAA,CAAkB,WAAA,CAAY,WAAW,EAAC,EAAG,UAAU,OAAA,EAAS;AAAA,IAClF;AAAA,GACD,CAAA;AACD,EAAA,OAAOD,qBAAA,CAAS;AAAA,IACdH,wBAAWC,2BAAA,CAAe,SAAS,GAAG,OAAA,EAAS,EAAE,YAAY,CAAA;AAAA,IAC7D,GAAI,WAAA,GAAc,CAAC,WAAW,IAAI;AAAC,GACpC,CAAA;AACH;;"}

package/dist/application/transform/document/request-body.mjs

@@ -0,0 +1,34 @@
+import { irProperty, irKeyword, irObject } from '../../../domain/ir/constructors.mjs';
+import { toPropertyName } from '../../../domain/ir/property-name.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { documentMember } from './document-member.mjs';
+import { itemContentMember, contentEntryType } from './media-type.mjs';
+
+const ANY_MEDIA_TYPE = "*/*";
+function contentMembers(requestBody, location, context) {
+  const entries = documentEntries(requestBody.content ?? {}, context.options);
+  return entries.map(([contentType, entry]) => {
+    const path = createRef([location.path, "content", contentType]);
+    const type = contentEntryType(entry, { ...location, path }, context);
+    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
+  });
+}
+function requestBodyType(requestBody, location, context) {
+  const members = contentMembers(requestBody, location, context);
+  const placeholder = irProperty(toPropertyName(ANY_MEDIA_TYPE), irKeyword("never"), {
+    isOptional: true
+  });
+  const content = irObject(members.length > 0 ? members : [placeholder]);
+  const isReadonly = context.options.immutable;
+  const itemContent = itemContentMember(requestBody.content ?? {}, location, context, {
+    isReadonly
+  });
+  return irObject([
+    irProperty(toPropertyName("content"), content, { isReadonly }),
+    ...itemContent ? [itemContent] : []
+  ]);
+}
+
+export { requestBodyType };
+//# sourceMappingURL=request-body.mjs.map

package/dist/application/transform/document/request-body.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-body.mjs","sources":["../../../../src/application/transform/document/request-body.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { contentEntryType, itemContentMember } from \"./media-type.js\";\n\n/** Stands in for the media types of a body that defines none: `\"*\\/*\"?: never`. */\nconst ANY_MEDIA_TYPE = \"*/*\";\n\nfunction contentMembers(\n  requestBody: RequestBodyObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrMember[] {\n  const entries = documentEntries(requestBody.content ?? {}, context.options);\n  return entries.map(([contentType, entry]) => {\n    const path = createRef([location.path, \"content\", contentType]);\n    const type = contentEntryType(entry, { ...location, path }, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n}\n\n/**\n * A request body (OpenAPI 3.2 §4.8.13): `{ content: { [mediaType]: T } }`, and `itemContent` when a\n * media type has an `itemSchema`.\n */\nexport function requestBodyType(\n  requestBody: RequestBodyObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const members = contentMembers(requestBody, location, context);\n  // The placeholder is never readonly, even with --immutable, as in the original.\n  const placeholder = irProperty(toPropertyName(ANY_MEDIA_TYPE), irKeyword(\"never\"), {\n    isOptional: true,\n  });\n  const content = irObject(members.length > 0 ? members : [placeholder]);\n  const isReadonly = context.options.immutable;\n  const itemContent = itemContentMember(requestBody.content ?? {}, location, context, {\n    isReadonly,\n  });\n  return irObject([\n    irProperty(toPropertyName(\"content\"), content, { isReadonly }),\n    ...(itemContent ? [itemContent] : []),\n  ]);\n}\n"],"names":[],"mappings":";;;;;;;AAWA,MAAM,cAAA,GAAiB,KAAA;AAEvB,SAAS,cAAA,CACP,WAAA,EACA,QAAA,EACA,OAAA,EACY;AACZ,EAAA,MAAM,UAAU,eAAA,CAAgB,WAAA,CAAY,WAAW,EAAC,EAAG,QAAQ,OAAO,CAAA;AAC1E,EAAA,OAAO,QAAQ,GAAA,CAAI,CAAC,CAAC,WAAA,EAAa,KAAK,CAAA,KAAM;AAC3C,IAAA,MAAM,OAAO,SAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,WAAW,CAAC,CAAA;AAC9D,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;AACH;AAMO,SAAS,eAAA,CACd,WAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,OAAA,GAAU,cAAA,CAAe,WAAA,EAAa,QAAA,EAAU,OAAO,CAAA;AAE7D,EAAA,MAAM,cAAc,UAAA,CAAW,cAAA,CAAe,cAAc,CAAA,EAAG,SAAA,CAAU,OAAO,CAAA,EAAG;AAAA,IACjF,UAAA,EAAY;AAAA,GACb,CAAA;AACD,EAAA,MAAM,OAAA,GAAU,SAAS,OAAA,CAAQ,MAAA,GAAS,IAAI,OAAA,GAAU,CAAC,WAAW,CAAC,CAAA;AACrE,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,cAAc,iBAAA,CAAkB,WAAA,CAAY,WAAW,EAAC,EAAG,UAAU,OAAA,EAAS;AAAA,IAClF;AAAA,GACD,CAAA;AACD,EAAA,OAAO,QAAA,CAAS;AAAA,IACd,WAAW,cAAA,CAAe,SAAS,GAAG,OAAA,EAAS,EAAE,YAAY,CAAA;AAAA,IAC7D,GAAI,WAAA,GAAc,CAAC,WAAW,IAAI;AAAC,GACpC,CAAA;AACH;;"}

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

@@ -0,0 +1,59 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const propertyName = require('../../../domain/ir/property-name.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const mediaTypeObject = require('../../../domain/openapi/media-type-object.cjs');
+const documentEntries = require('../document-entries.cjs');
+const refType = require('../ref-type.cjs');
+const sharedTypes = require('../shared-types.cjs');
+const documentMember = require('./document-member.cjs');
+const header = require('./header.cjs');
+const mediaType = require('./media-type.cjs');
+
+function headerMember(name, header$1, location, context) {
+  const isReference = "$ref" in header$1;
+  const type = isReference ? refType.refType(header$1.$ref) : header.headerType(
+    header$1,
+    { ...location, path: jsonPointer.createRef([location.path, "headers", name]) },
+    context
+  );
+  return documentMember.documentMember(name, type, header$1, {
+    isReadonly: context.options.immutable,
+    isOptional: !isReference && !header$1.required
+  });
+}
+function headersMember(response, location, context) {
+  const entries = documentEntries.documentEntries(response.headers ?? {}, context.options);
+  const members = entries.map(
+    ([name, header]) => headerMember(name, header, location, context)
+  );
+  members.push(constructors.irStringIndexSignature("name", sharedTypes.UNKNOWN_TYPE, context.options.immutable));
+  return constructors.irProperty(propertyName.toPropertyName("headers"), constructors.irObject(members));
+}
+function mediaTypeEntryType(entry, location, context) {
+  return "$ref" in entry && mediaTypeObject.isMediaTypeComponentRef(entry.$ref) ? mediaType.contentEntryType(entry, location, context) : mediaType.mediaTypeType(entry, location, context);
+}
+function contentMember(response, location, context) {
+  const entries = documentEntries.documentEntries(response.content ?? {}, context.options);
+  const members = entries.map(([contentType, entry]) => {
+    const path = jsonPointer.createRef([location.path, "content", contentType]);
+    const type = mediaTypeEntryType(entry, { ...location, path }, context);
+    return documentMember.documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
+  });
+  const name = propertyName.toPropertyName("content");
+  return members.length > 0 ? constructors.irProperty(name, constructors.irObject(members)) : constructors.irProperty(name, constructors.irKeyword("never"), { isOptional: true });
+}
+function responseType(response, location, context) {
+  const itemContent = mediaType.itemContentMember(response.content ?? {}, location, context, {
+    isReadonly: false
+  });
+  return constructors.irObject([
+    headersMember(response, location, context),
+    contentMember(response, location, context),
+    ...itemContent ? [itemContent] : []
+  ]);
+}
+
+exports.responseType = responseType;
+//# sourceMappingURL=response.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.cjs","sources":["../../../../src/application/transform/document/response.ts"],"sourcesContent":["import {\n  irKeyword,\n  irObject,\n  irProperty,\n  irStringIndexSignature,\n} from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, 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  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.js\";\nimport type { ResponseObject } from \"../../../domain/openapi/response-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { headerType } from \"./header.js\";\nimport { contentEntryType, itemContentMember, mediaTypeType } from \"./media-type.js\";\n\ntype HeaderEntry = NonNullable<ResponseObject[\"headers\"]>[string];\n\nfunction headerMember(\n  name: string,\n  header: HeaderEntry,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrPropertySignature {\n  // A referenced header counts as required: the reference does not say otherwise.\n  const isReference = \"$ref\" in header;\n  const type = isReference\n    ? refType(header.$ref)\n    : headerType(\n        header,\n        { ...location, path: createRef([location.path, \"headers\", name]) },\n        context,\n      );\n  return documentMember(name, type, header, {\n    isReadonly: context.options.immutable,\n    isOptional: !isReference && !header.required,\n  });\n}\n\n/** The listed headers, then `[name: string]: unknown`, because servers may send others. */\nfunction headersMember(\n  response: ResponseObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrPropertySignature {\n  const entries = documentEntries(response.headers ?? {}, context.options);\n  const members: IrMember[] = entries.map(([name, header]) =>\n    headerMember(name, header, location, context),\n  );\n  members.push(irStringIndexSignature(\"name\", UNKNOWN_TYPE, context.options.immutable));\n  return irProperty(toPropertyName(\"headers\"), irObject(members));\n}\n\n/**\n * One media type of a response. The original reads a `$ref` entry as a media type without a\n * schema, so it is `unknown`; a `$ref` to an OpenAPI 3.2 media type component is typed as it.\n */\nfunction mediaTypeEntryType(\n  entry: NonNullable<ResponseObject[\"content\"]>[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return \"$ref\" in entry && isMediaTypeComponentRef(entry.$ref)\n    ? contentEntryType(entry, location, context)\n    : mediaTypeType(entry as MediaTypeObject, location, context);\n}\n\n/** `content` with one member per media type, or `content?: never` when there are none. */\nfunction contentMember(\n  response: ResponseObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrPropertySignature {\n  const entries = documentEntries(response.content ?? {}, context.options);\n  const members = entries.map(([contentType, entry]) => {\n    const path = createRef([location.path, \"content\", contentType]);\n    const type = mediaTypeEntryType(entry, { ...location, path }, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n  const name = toPropertyName(\"content\");\n  return members.length > 0\n    ? irProperty(name, irObject(members))\n    : irProperty(name, irKeyword(\"never\"), { isOptional: true });\n}\n\n/**\n * A response (OpenAPI 3.2 §4.8.17): `{ headers: {…}; content: {…} }`, and `itemContent` when a\n * media type has an `itemSchema`. No member is readonly, even with --immutable, as in the original.\n */\nexport function responseType(\n  response: ResponseObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const itemContent = itemContentMember(response.content ?? {}, location, context, {\n    isReadonly: false,\n  });\n  return irObject([\n    headersMember(response, location, context),\n    contentMember(response, location, context),\n    ...(itemContent ? [itemContent] : []),\n  ]);\n}\n"],"names":["header","refType","headerType","createRef","documentMember","documentEntries","irStringIndexSignature","UNKNOWN_TYPE","irProperty","toPropertyName","irObject","isMediaTypeComponentRef","contentEntryType","mediaTypeType","irKeyword","itemContentMember"],"mappings":"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"}

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

@@ -0,0 +1,57 @@
+import { irObject, irStringIndexSignature, irProperty, irKeyword } from '../../../domain/ir/constructors.mjs';
+import { toPropertyName } from '../../../domain/ir/property-name.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { isMediaTypeComponentRef } from '../../../domain/openapi/media-type-object.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { refType } from '../ref-type.mjs';
+import { UNKNOWN_TYPE } from '../shared-types.mjs';
+import { documentMember } from './document-member.mjs';
+import { headerType } from './header.mjs';
+import { itemContentMember, contentEntryType, mediaTypeType } from './media-type.mjs';
+
+function headerMember(name, header, location, context) {
+  const isReference = "$ref" in header;
+  const type = isReference ? refType(header.$ref) : headerType(
+    header,
+    { ...location, path: createRef([location.path, "headers", name]) },
+    context
+  );
+  return documentMember(name, type, header, {
+    isReadonly: context.options.immutable,
+    isOptional: !isReference && !header.required
+  });
+}
+function headersMember(response, location, context) {
+  const entries = documentEntries(response.headers ?? {}, context.options);
+  const members = entries.map(
+    ([name, header]) => headerMember(name, header, location, context)
+  );
+  members.push(irStringIndexSignature("name", UNKNOWN_TYPE, context.options.immutable));
+  return irProperty(toPropertyName("headers"), irObject(members));
+}
+function mediaTypeEntryType(entry, location, context) {
+  return "$ref" in entry && isMediaTypeComponentRef(entry.$ref) ? contentEntryType(entry, location, context) : mediaTypeType(entry, location, context);
+}
+function contentMember(response, location, context) {
+  const entries = documentEntries(response.content ?? {}, context.options);
+  const members = entries.map(([contentType, entry]) => {
+    const path = createRef([location.path, "content", contentType]);
+    const type = mediaTypeEntryType(entry, { ...location, path }, context);
+    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });
+  });
+  const name = toPropertyName("content");
+  return members.length > 0 ? irProperty(name, irObject(members)) : irProperty(name, irKeyword("never"), { isOptional: true });
+}
+function responseType(response, location, context) {
+  const itemContent = itemContentMember(response.content ?? {}, location, context, {
+    isReadonly: false
+  });
+  return irObject([
+    headersMember(response, location, context),
+    contentMember(response, location, context),
+    ...itemContent ? [itemContent] : []
+  ]);
+}
+
+export { responseType };
+//# sourceMappingURL=response.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.mjs","sources":["../../../../src/application/transform/document/response.ts"],"sourcesContent":["import {\n  irKeyword,\n  irObject,\n  irProperty,\n  irStringIndexSignature,\n} from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, 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  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.js\";\nimport type { ResponseObject } from \"../../../domain/openapi/response-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { headerType } from \"./header.js\";\nimport { contentEntryType, itemContentMember, mediaTypeType } from \"./media-type.js\";\n\ntype HeaderEntry = NonNullable<ResponseObject[\"headers\"]>[string];\n\nfunction headerMember(\n  name: string,\n  header: HeaderEntry,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrPropertySignature {\n  // A referenced header counts as required: the reference does not say otherwise.\n  const isReference = \"$ref\" in header;\n  const type = isReference\n    ? refType(header.$ref)\n    : headerType(\n        header,\n        { ...location, path: createRef([location.path, \"headers\", name]) },\n        context,\n      );\n  return documentMember(name, type, header, {\n    isReadonly: context.options.immutable,\n    isOptional: !isReference && !header.required,\n  });\n}\n\n/** The listed headers, then `[name: string]: unknown`, because servers may send others. */\nfunction headersMember(\n  response: ResponseObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrPropertySignature {\n  const entries = documentEntries(response.headers ?? {}, context.options);\n  const members: IrMember[] = entries.map(([name, header]) =>\n    headerMember(name, header, location, context),\n  );\n  members.push(irStringIndexSignature(\"name\", UNKNOWN_TYPE, context.options.immutable));\n  return irProperty(toPropertyName(\"headers\"), irObject(members));\n}\n\n/**\n * One media type of a response. The original reads a `$ref` entry as a media type without a\n * schema, so it is `unknown`; a `$ref` to an OpenAPI 3.2 media type component is typed as it.\n */\nfunction mediaTypeEntryType(\n  entry: NonNullable<ResponseObject[\"content\"]>[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return \"$ref\" in entry && isMediaTypeComponentRef(entry.$ref)\n    ? contentEntryType(entry, location, context)\n    : mediaTypeType(entry as MediaTypeObject, location, context);\n}\n\n/** `content` with one member per media type, or `content?: never` when there are none. */\nfunction contentMember(\n  response: ResponseObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrPropertySignature {\n  const entries = documentEntries(response.content ?? {}, context.options);\n  const members = entries.map(([contentType, entry]) => {\n    const path = createRef([location.path, \"content\", contentType]);\n    const type = mediaTypeEntryType(entry, { ...location, path }, context);\n    return documentMember(contentType, type, entry, { isReadonly: context.options.immutable });\n  });\n  const name = toPropertyName(\"content\");\n  return members.length > 0\n    ? irProperty(name, irObject(members))\n    : irProperty(name, irKeyword(\"never\"), { isOptional: true });\n}\n\n/**\n * A response (OpenAPI 3.2 §4.8.17): `{ headers: {…}; content: {…} }`, and `itemContent` when a\n * media type has an `itemSchema`. No member is readonly, even with --immutable, as in the original.\n */\nexport function responseType(\n  response: ResponseObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const itemContent = itemContentMember(response.content ?? {}, location, context, {\n    isReadonly: false,\n  });\n  return irObject([\n    headersMember(response, location, context),\n    contentMember(response, location, context),\n    ...(itemContent ? [itemContent] : []),\n  ]);\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const documentEntries = require('../document-entries.cjs');
+const refType = require('../ref-type.cjs');
+const documentMember = require('./document-member.cjs');
+const response = require('./response.cjs');
+
+function responsesType(responses, location, context) {
+  const members = documentEntries.documentEntries(responses, context.options).map(([code, response$1]) => {
+    const type = "$ref" in response$1 ? refType.refType(response$1.$ref) : response.responseType(
+      response$1,
+      { ...location, path: jsonPointer.createRef([location.path, "responses", code]) },
+      context
+    );
+    return documentMember.documentMember(code, type, response$1, { isReadonly: context.options.immutable });
+  });
+  return members.length > 0 ? constructors.irObject(members) : constructors.irKeyword("never");
+}
+
+exports.responsesType = responsesType;
+//# sourceMappingURL=responses.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responses.cjs","sources":["../../../../src/application/transform/document/responses.ts"],"sourcesContent":["import { irKeyword, irObject } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { ResponsesObject } from \"../../../domain/openapi/response-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { responseType } from \"./response.js\";\n\n/** Responses by status code (OpenAPI 3.1 §4.8.16), or `never` when there are none. */\nexport function responsesType(\n  responses: ResponsesObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const members = documentEntries(responses, context.options).map(([code, response]) => {\n    const type =\n      \"$ref\" in response\n        ? refType(response.$ref)\n        : responseType(\n            response,\n            { ...location, path: createRef([location.path, \"responses\", code]) },\n            context,\n          );\n    return documentMember(code, type, response, { isReadonly: context.options.immutable });\n  });\n  return members.length > 0 ? irObject(members) : irKeyword(\"never\");\n}\n"],"names":["documentEntries","response","refType","responseType","createRef","documentMember","irObject","irKeyword"],"mappings":";;;;;;;;;AAWO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,OAAA,GAAUA,+BAAA,CAAgB,SAAA,EAAW,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,IAAA,EAAMC,UAAQ,CAAA,KAAM;AACpF,IAAA,MAAM,OACJ,MAAA,IAAUA,UAAA,GACNC,eAAA,CAAQD,UAAA,CAAS,IAAI,CAAA,GACrBE,qBAAA;AAAA,MACEF,UAAA;AAAA,MACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAMG,qBAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,WAAA,EAAa,IAAI,CAAC,CAAA,EAAE;AAAA,MACnE;AAAA,KACF;AACN,IAAA,OAAOC,6BAAA,CAAe,MAAM,IAAA,EAAMJ,UAAA,EAAU,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AAAA,EACvF,CAAC,CAAA;AACD,EAAA,OAAO,QAAQ,MAAA,GAAS,CAAA,GAAIK,sBAAS,OAAO,CAAA,GAAIC,uBAAU,OAAO,CAAA;AACnE;;"}

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

@@ -0,0 +1,21 @@
+import { irObject, irKeyword } from '../../../domain/ir/constructors.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { refType } from '../ref-type.mjs';
+import { documentMember } from './document-member.mjs';
+import { responseType } from './response.mjs';
+
+function responsesType(responses, location, context) {
+  const members = documentEntries(responses, context.options).map(([code, response]) => {
+    const type = "$ref" in response ? refType(response.$ref) : responseType(
+      response,
+      { ...location, path: createRef([location.path, "responses", code]) },
+      context
+    );
+    return documentMember(code, type, response, { isReadonly: context.options.immutable });
+  });
+  return members.length > 0 ? irObject(members) : irKeyword("never");
+}
+
+export { responsesType };
+//# sourceMappingURL=responses.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responses.mjs","sources":["../../../../src/application/transform/document/responses.ts"],"sourcesContent":["import { irKeyword, irObject } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { ResponsesObject } from \"../../../domain/openapi/response-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { responseType } from \"./response.js\";\n\n/** Responses by status code (OpenAPI 3.1 §4.8.16), or `never` when there are none. */\nexport function responsesType(\n  responses: ResponsesObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const members = documentEntries(responses, context.options).map(([code, response]) => {\n    const type =\n      \"$ref\" in response\n        ? refType(response.$ref)\n        : responseType(\n            response,\n            { ...location, path: createRef([location.path, \"responses\", code]) },\n            context,\n          );\n    return documentMember(code, type, response, { isReadonly: context.options.immutable });\n  });\n  return members.length > 0 ? irObject(members) : irKeyword(\"never\");\n}\n"],"names":[],"mappings":";;;;;;;AAWO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,SAAA,EAAW,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,IAAA,EAAM,QAAQ,CAAA,KAAM;AACpF,IAAA,MAAM,OACJ,MAAA,IAAU,QAAA,GACN,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,GACrB,YAAA;AAAA,MACE,QAAA;AAAA,MACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,SAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,WAAA,EAAa,IAAI,CAAC,CAAA,EAAE;AAAA,MACnE;AAAA,KACF;AACN,IAAA,OAAO,cAAA,CAAe,MAAM,IAAA,EAAM,QAAA,EAAU,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AAAA,EACvF,CAAC,CAAA;AACD,EAAA,OAAO,QAAQ,MAAA,GAAS,CAAA,GAAI,SAAS,OAAO,CAAA,GAAI,UAAU,OAAO,CAAA;AACnE;;"}

package/dist/application/transform/document/root-type-aliases.cjs

@@ -0,0 +1,69 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const rawTextEscapes = require('../../../domain/ir/raw-text-escapes.cjs');
+
+const REFERENCE_PREFIX = "components['";
+function rootTypeAlias(name, kind, item) {
+  return {
+    kind: "typeAlias",
+    name,
+    isExported: true,
+    // The original writes the reference as text, with single quotes, and did not escape the
+    // name: a quote in it could add code to the generated file (intentional fix).
+    type: constructors.irRaw(`${REFERENCE_PREFIX}${kind}']['${rawTextEscapes.escapeSingleQuotedText(item)}']`),
+    comments: []
+  };
+}
+function isRootTypeAlias(declaration) {
+  return declaration.kind === "typeAlias" && declaration.type.kind === "raw" && declaration.type.text.startsWith(REFERENCE_PREFIX);
+}
+function footerTypeNames(declarations) {
+  return new Set(
+    declarations.flatMap((declaration) => {
+      if (declaration.kind === "enum") {
+        return [declaration.name];
+      }
+      return declaration.kind === "rawDeclaration" && declaration.name !== void 0 ? [declaration.name] : [];
+    })
+  );
+}
+function declaredNames(declarations) {
+  return new Set(
+    declarations.flatMap(
+      (declaration) => "name" in declaration && declaration.name !== void 0 ? [declaration.name] : []
+    )
+  );
+}
+function freeName(name, taken) {
+  let candidate = `${name}_2`;
+  for (let counter = 3; taken.has(candidate); counter++) {
+    candidate = `${name}_${counter}`;
+  }
+  return candidate;
+}
+function numberDisplacedAliases(displaced, kept) {
+  const taken = new Set(kept.map((alias) => alias.name));
+  return displaced.map((alias) => {
+    const name = freeName(alias.name, taken);
+    taken.add(name);
+    return { ...alias, name };
+  });
+}
+function renameAliasesTakenByFooter(body, footer) {
+  const footerNames = footerTypeNames(footer);
+  const taken = declaredNames([...body, ...footer]);
+  return body.map((declaration) => {
+    if (!isRootTypeAlias(declaration) || !footerNames.has(declaration.name)) {
+      return declaration;
+    }
+    const name = freeName(declaration.name, taken);
+    taken.add(name);
+    return { ...declaration, name };
+  });
+}
+
+exports.numberDisplacedAliases = numberDisplacedAliases;
+exports.renameAliasesTakenByFooter = renameAliasesTakenByFooter;
+exports.rootTypeAlias = rootTypeAlias;
+//# sourceMappingURL=root-type-aliases.cjs.map

package/dist/application/transform/document/root-type-aliases.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-type-aliases.cjs","sources":["../../../../src/application/transform/document/root-type-aliases.ts"],"sourcesContent":["import { irRaw } from \"../../../domain/ir/constructors.js\";\nimport type { IrDeclaration, IrTypeAliasDeclaration } from \"../../../domain/ir/nodes.js\";\nimport { escapeSingleQuotedText } from \"../../../domain/ir/raw-text-escapes.js\";\nimport type { ComponentKind } from \"../../../domain/openapi/components-object.js\";\n\n/** The `--root-types` aliases: `export type Pet = components['schemas']['Pet'];`. */\n\nconst REFERENCE_PREFIX = \"components['\";\n\n/** The alias of one component. */\nexport function rootTypeAlias(\n  name: string,\n  kind: ComponentKind,\n  item: string,\n): IrTypeAliasDeclaration {\n  return {\n    kind: \"typeAlias\",\n    name,\n    isExported: true,\n    // The original writes the reference as text, with single quotes, and did not escape the\n    // name: a quote in it could add code to the generated file (intentional fix).\n    type: irRaw(`${REFERENCE_PREFIX}${kind}']['${escapeSingleQuotedText(item)}']`),\n    comments: [],\n  };\n}\n\nfunction isRootTypeAlias(declaration: IrDeclaration): declaration is IrTypeAliasDeclaration {\n  return (\n    declaration.kind === \"typeAlias\" &&\n    declaration.type.kind === \"raw\" &&\n    declaration.type.text.startsWith(REFERENCE_PREFIX)\n  );\n}\n\n/**\n * The type names the footer declares that an alias must not take: enums, and helper types such as\n * `WithRequired`. Value declarations (`--enum-values` arrays) live in another namespace.\n */\nfunction footerTypeNames(declarations: readonly IrDeclaration[]): Set<string> {\n  return new Set(\n    declarations.flatMap((declaration) => {\n      if (declaration.kind === \"enum\") {\n        return [declaration.name];\n      }\n      return declaration.kind === \"rawDeclaration\" && declaration.name !== undefined\n        ? [declaration.name]\n        : [];\n    }),\n  );\n}\n\nfunction declaredNames(declarations: readonly IrDeclaration[]): Set<string> {\n  return new Set(\n    declarations.flatMap((declaration) =>\n      \"name\" in declaration && declaration.name !== undefined ? [declaration.name] : [],\n    ),\n  );\n}\n\nfunction freeName(name: string, taken: ReadonlySet<string>): string {\n  let candidate = `${name}_2`;\n  for (let counter = 3; taken.has(candidate); counter++) {\n    candidate = `${name}_${counter}`;\n  }\n  return candidate;\n}\n\n/**\n * With the `root-type-numbering` fix (ADR-021, roadmap R13, backlog 30): the aliases that a later\n * schema of one exported name took the name from, numbered `Name_2`, `Name_3`, … in document order\n * with the next free number. The later schema keeps the name, so the fix only adds exports.\n */\nexport function numberDisplacedAliases(\n  displaced: readonly IrTypeAliasDeclaration[],\n  kept: readonly IrTypeAliasDeclaration[],\n): IrTypeAliasDeclaration[] {\n  const taken = new Set(kept.map((alias) => alias.name));\n  return displaced.map((alias) => {\n    const name = freeName(alias.name, taken);\n    taken.add(name);\n    return { ...alias, name };\n  });\n}\n\n/**\n * Rename each root alias whose name an enum or a helper type of the footer also declares, to the\n * next free `Name_2`, `Name_3`, … (the suffix `--root-types` uses for its own conflicts). The\n * footer keeps its names, because the generated types refer to them. Before, both were declared\n * under one name, which does not compile (enums: upstream #2099, #2341, #2206; helpers: a schema\n * named `WithRequired`, roadmap R11). Other declarations are returned unchanged.\n */\nexport function renameAliasesTakenByFooter(\n  body: readonly IrDeclaration[],\n  footer: readonly IrDeclaration[],\n): IrDeclaration[] {\n  const footerNames = footerTypeNames(footer);\n  const taken = declaredNames([...body, ...footer]);\n  return body.map((declaration) => {\n    if (!isRootTypeAlias(declaration) || !footerNames.has(declaration.name)) {\n      return declaration;\n    }\n    const name = freeName(declaration.name, taken);\n    taken.add(name);\n    return { ...declaration, name };\n  });\n}\n"],"names":["irRaw","escapeSingleQuotedText"],"mappings":"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"}

package/dist/application/transform/document/root-type-aliases.mjs

@@ -0,0 +1,65 @@
+import { irRaw } from '../../../domain/ir/constructors.mjs';
+import { escapeSingleQuotedText } from '../../../domain/ir/raw-text-escapes.mjs';
+
+const REFERENCE_PREFIX = "components['";
+function rootTypeAlias(name, kind, item) {
+  return {
+    kind: "typeAlias",
+    name,
+    isExported: true,
+    // The original writes the reference as text, with single quotes, and did not escape the
+    // name: a quote in it could add code to the generated file (intentional fix).
+    type: irRaw(`${REFERENCE_PREFIX}${kind}']['${escapeSingleQuotedText(item)}']`),
+    comments: []
+  };
+}
+function isRootTypeAlias(declaration) {
+  return declaration.kind === "typeAlias" && declaration.type.kind === "raw" && declaration.type.text.startsWith(REFERENCE_PREFIX);
+}
+function footerTypeNames(declarations) {
+  return new Set(
+    declarations.flatMap((declaration) => {
+      if (declaration.kind === "enum") {
+        return [declaration.name];
+      }
+      return declaration.kind === "rawDeclaration" && declaration.name !== void 0 ? [declaration.name] : [];
+    })
+  );
+}
+function declaredNames(declarations) {
+  return new Set(
+    declarations.flatMap(
+      (declaration) => "name" in declaration && declaration.name !== void 0 ? [declaration.name] : []
+    )
+  );
+}
+function freeName(name, taken) {
+  let candidate = `${name}_2`;
+  for (let counter = 3; taken.has(candidate); counter++) {
+    candidate = `${name}_${counter}`;
+  }
+  return candidate;
+}
+function numberDisplacedAliases(displaced, kept) {
+  const taken = new Set(kept.map((alias) => alias.name));
+  return displaced.map((alias) => {
+    const name = freeName(alias.name, taken);
+    taken.add(name);
+    return { ...alias, name };
+  });
+}
+function renameAliasesTakenByFooter(body, footer) {
+  const footerNames = footerTypeNames(footer);
+  const taken = declaredNames([...body, ...footer]);
+  return body.map((declaration) => {
+    if (!isRootTypeAlias(declaration) || !footerNames.has(declaration.name)) {
+      return declaration;
+    }
+    const name = freeName(declaration.name, taken);
+    taken.add(name);
+    return { ...declaration, name };
+  });
+}
+
+export { numberDisplacedAliases, renameAliasesTakenByFooter, rootTypeAlias };
+//# sourceMappingURL=root-type-aliases.mjs.map

package/dist/application/transform/document/root-type-aliases.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-type-aliases.mjs","sources":["../../../../src/application/transform/document/root-type-aliases.ts"],"sourcesContent":["import { irRaw } from \"../../../domain/ir/constructors.js\";\nimport type { IrDeclaration, IrTypeAliasDeclaration } from \"../../../domain/ir/nodes.js\";\nimport { escapeSingleQuotedText } from \"../../../domain/ir/raw-text-escapes.js\";\nimport type { ComponentKind } from \"../../../domain/openapi/components-object.js\";\n\n/** The `--root-types` aliases: `export type Pet = components['schemas']['Pet'];`. */\n\nconst REFERENCE_PREFIX = \"components['\";\n\n/** The alias of one component. */\nexport function rootTypeAlias(\n  name: string,\n  kind: ComponentKind,\n  item: string,\n): IrTypeAliasDeclaration {\n  return {\n    kind: \"typeAlias\",\n    name,\n    isExported: true,\n    // The original writes the reference as text, with single quotes, and did not escape the\n    // name: a quote in it could add code to the generated file (intentional fix).\n    type: irRaw(`${REFERENCE_PREFIX}${kind}']['${escapeSingleQuotedText(item)}']`),\n    comments: [],\n  };\n}\n\nfunction isRootTypeAlias(declaration: IrDeclaration): declaration is IrTypeAliasDeclaration {\n  return (\n    declaration.kind === \"typeAlias\" &&\n    declaration.type.kind === \"raw\" &&\n    declaration.type.text.startsWith(REFERENCE_PREFIX)\n  );\n}\n\n/**\n * The type names the footer declares that an alias must not take: enums, and helper types such as\n * `WithRequired`. Value declarations (`--enum-values` arrays) live in another namespace.\n */\nfunction footerTypeNames(declarations: readonly IrDeclaration[]): Set<string> {\n  return new Set(\n    declarations.flatMap((declaration) => {\n      if (declaration.kind === \"enum\") {\n        return [declaration.name];\n      }\n      return declaration.kind === \"rawDeclaration\" && declaration.name !== undefined\n        ? [declaration.name]\n        : [];\n    }),\n  );\n}\n\nfunction declaredNames(declarations: readonly IrDeclaration[]): Set<string> {\n  return new Set(\n    declarations.flatMap((declaration) =>\n      \"name\" in declaration && declaration.name !== undefined ? [declaration.name] : [],\n    ),\n  );\n}\n\nfunction freeName(name: string, taken: ReadonlySet<string>): string {\n  let candidate = `${name}_2`;\n  for (let counter = 3; taken.has(candidate); counter++) {\n    candidate = `${name}_${counter}`;\n  }\n  return candidate;\n}\n\n/**\n * With the `root-type-numbering` fix (ADR-021, roadmap R13, backlog 30): the aliases that a later\n * schema of one exported name took the name from, numbered `Name_2`, `Name_3`, … in document order\n * with the next free number. The later schema keeps the name, so the fix only adds exports.\n */\nexport function numberDisplacedAliases(\n  displaced: readonly IrTypeAliasDeclaration[],\n  kept: readonly IrTypeAliasDeclaration[],\n): IrTypeAliasDeclaration[] {\n  const taken = new Set(kept.map((alias) => alias.name));\n  return displaced.map((alias) => {\n    const name = freeName(alias.name, taken);\n    taken.add(name);\n    return { ...alias, name };\n  });\n}\n\n/**\n * Rename each root alias whose name an enum or a helper type of the footer also declares, to the\n * next free `Name_2`, `Name_3`, … (the suffix `--root-types` uses for its own conflicts). The\n * footer keeps its names, because the generated types refer to them. Before, both were declared\n * under one name, which does not compile (enums: upstream #2099, #2341, #2206; helpers: a schema\n * named `WithRequired`, roadmap R11). Other declarations are returned unchanged.\n */\nexport function renameAliasesTakenByFooter(\n  body: readonly IrDeclaration[],\n  footer: readonly IrDeclaration[],\n): IrDeclaration[] {\n  const footerNames = footerTypeNames(footer);\n  const taken = declaredNames([...body, ...footer]);\n  return body.map((declaration) => {\n    if (!isRootTypeAlias(declaration) || !footerNames.has(declaration.name)) {\n      return declaration;\n    }\n    const name = freeName(declaration.name, taken);\n    taken.add(name);\n    return { ...declaration, name };\n  });\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const propertyName = require('../../../domain/ir/property-name.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const documentEntries = require('../document-entries.cjs');
+const pathItem = require('./path-item.cjs');
+
+function webhooksType(webhooks, context) {
+  const members = documentEntries.documentEntries(webhooks, context.options).map(([name, pathItem$1]) => {
+    const location = { path: jsonPointer.createRef(["webhooks", name]) };
+    const type = pathItem.pathItemType(pathItem$1, location, context);
+    return constructors.irProperty(propertyName.toPropertyName(name), type, { isReadonly: context.options.immutable });
+  });
+  return constructors.irObject(members);
+}
+
+exports.webhooksType = webhooksType;
+//# sourceMappingURL=webhooks.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.cjs","sources":["../../../../src/application/transform/document/webhooks.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { PathItemObject, PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { pathItemType } from \"./path-item.js\";\n\n/**\n * The `webhooks` interface body (OpenAPI 3.1 §4.8.1): one path item per webhook name. Unlike\n * `paths`, a `$ref` entry is read as a path item (so every method is `never`), as in the original,\n * and members carry no JSDoc.\n */\nexport function webhooksType(webhooks: PathsObject, context: TransformContext): IrType {\n  const members = documentEntries(webhooks, context.options).map(([name, pathItem]) => {\n    const location = { path: createRef([\"webhooks\", name]) };\n    const type = pathItemType(pathItem as PathItemObject, location, context);\n    return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":["documentEntries","pathItem","createRef","pathItemType","irProperty","toPropertyName","irObject"],"mappings":";;;;;;;;AAcO,SAAS,YAAA,CAAa,UAAuB,OAAA,EAAmC;AACrF,EAAA,MAAM,OAAA,GAAUA,+BAAA,CAAgB,QAAA,EAAU,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,IAAA,EAAMC,UAAQ,CAAA,KAAM;AACnF,IAAA,MAAM,QAAA,GAAW,EAAE,IAAA,EAAMC,qBAAA,CAAU,CAAC,UAAA,EAAY,IAAI,CAAC,CAAA,EAAE;AACvD,IAAA,MAAM,IAAA,GAAOC,qBAAA,CAAaF,UAAA,EAA4B,QAAA,EAAU,OAAO,CAAA;AACvE,IAAA,OAAOG,uBAAA,CAAWC,2BAAA,CAAe,IAAI,CAAA,EAAG,IAAA,EAAM,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AAAA,EACzF,CAAC,CAAA;AACD,EAAA,OAAOC,sBAAS,OAAO,CAAA;AACzB;;"}

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

@@ -0,0 +1,17 @@
+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 { documentEntries } from '../document-entries.mjs';
+import { pathItemType } from './path-item.mjs';
+
+function webhooksType(webhooks, context) {
+  const members = documentEntries(webhooks, context.options).map(([name, pathItem]) => {
+    const location = { path: createRef(["webhooks", name]) };
+    const type = pathItemType(pathItem, location, context);
+    return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });
+  });
+  return irObject(members);
+}
+
+export { webhooksType };
+//# sourceMappingURL=webhooks.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.mjs","sources":["../../../../src/application/transform/document/webhooks.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { PathItemObject, PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { pathItemType } from \"./path-item.js\";\n\n/**\n * The `webhooks` interface body (OpenAPI 3.1 §4.8.1): one path item per webhook name. Unlike\n * `paths`, a `$ref` entry is read as a path item (so every method is `never`), as in the original,\n * and members carry no JSDoc.\n */\nexport function webhooksType(webhooks: PathsObject, context: TransformContext): IrType {\n  const members = documentEntries(webhooks, context.options).map(([name, pathItem]) => {\n    const location = { path: createRef([\"webhooks\", name]) };\n    const type = pathItemType(pathItem as PathItemObject, location, context);\n    return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":[],"mappings":";;;;;;AAcO,SAAS,YAAA,CAAa,UAAuB,OAAA,EAAmC;AACrF,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,QAAA,EAAU,OAAA,CAAQ,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,IAAA,EAAM,QAAQ,CAAA,KAAM;AACnF,IAAA,MAAM,QAAA,GAAW,EAAE,IAAA,EAAM,SAAA,CAAU,CAAC,UAAA,EAAY,IAAI,CAAC,CAAA,EAAE;AACvD,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,QAAA,EAA4B,QAAA,EAAU,OAAO,CAAA;AACvE,IAAA,OAAO,UAAA,CAAW,cAAA,CAAe,IAAI,CAAA,EAAG,IAAA,EAAM,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAA;AAAA,EACzF,CAAC,CAAA;AACD,EAAA,OAAO,SAAS,OAAO,CAAA;AACzB;;"}

package/dist/application/transform/document-entries.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+const normalize = require('../../domain/ir/normalize.cjs');
+
+function isDeprecated(value) {
+  return Boolean(value && typeof value === "object" && "deprecated" in value && value.deprecated);
+}
+const KEEPS_NONE = () => false;
+function documentEntries(record, options, isKept = KEEPS_NONE) {
+  const entries = Object.entries(record);
+  const sorted = options.alphabetize ? normalize.sortEntriesByKey(entries) : entries;
+  return options.excludeDeprecated ? sorted.filter(([, value]) => !isDeprecated(value) || isKept(value)) : sorted;
+}
+
+exports.documentEntries = documentEntries;
+exports.isDeprecated = isDeprecated;
+//# sourceMappingURL=document-entries.cjs.map

package/dist/application/transform/document-entries.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-entries.cjs","sources":["../../../src/application/transform/document-entries.ts"],"sourcesContent":["import { sortEntriesByKey } from \"../../domain/ir/normalize.js\";\nimport type { SchemaOptions } from \"./schema/schema-context.js\";\n\n/** Whether a document object has `deprecated: true` (`--exclude-deprecated` drops it). */\nexport function isDeprecated(value: unknown): boolean {\n  return Boolean(value && typeof value === \"object\" && \"deprecated\" in value && value.deprecated);\n}\n\n/** Whether a deprecated entry is still needed, so `--exclude-deprecated` keeps it. */\nexport type DeprecatedEntryFilter = (value: unknown) => boolean;\n\nconst KEEPS_NONE: DeprecatedEntryFilter = () => false;\n\n/**\n * `Object.entries` of a document map (the original `getEntries`): sorted for `--alphabetize`,\n * without deprecated entries for `--exclude-deprecated`, except those `isKept` names.\n */\nexport function documentEntries<T>(\n  record: Readonly<Record<string, T>>,\n  options: Pick<SchemaOptions, \"alphabetize\" | \"excludeDeprecated\">,\n  isKept: DeprecatedEntryFilter = KEEPS_NONE,\n): [string, T][] {\n  const entries = Object.entries(record);\n  const sorted = options.alphabetize ? sortEntriesByKey(entries) : entries;\n  return options.excludeDeprecated\n    ? sorted.filter(([, value]) => !isDeprecated(value) || isKept(value))\n    : sorted;\n}\n"],"names":["sortEntriesByKey"],"mappings":";;;;AAIO,SAAS,aAAa,KAAA,EAAyB;AACpD,EAAA,OAAO,OAAA,CAAQ,SAAS,OAAO,KAAA,KAAU,YAAY,YAAA,IAAgB,KAAA,IAAS,MAAM,UAAU,CAAA;AAChG;AAKA,MAAM,aAAoC,MAAM,KAAA;AAMzC,SAAS,eAAA,CACd,MAAA,EACA,OAAA,EACA,MAAA,GAAgC,UAAA,EACjB;AACf,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA;AACrC,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,WAAA,GAAcA,0BAAA,CAAiB,OAAO,CAAA,GAAI,OAAA;AACjE,EAAA,OAAO,QAAQ,iBAAA,GACX,MAAA,CAAO,MAAA,CAAO,CAAC,GAAG,KAAK,CAAA,KAAM,CAAC,aAAa,KAAK,CAAA,IAAK,MAAA,CAAO,KAAK,CAAC,CAAA,GAClE,MAAA;AACN;;;"}

package/dist/application/transform/document-entries.mjs

@@ -0,0 +1,14 @@
+import { sortEntriesByKey } from '../../domain/ir/normalize.mjs';
+
+function isDeprecated(value) {
+  return Boolean(value && typeof value === "object" && "deprecated" in value && value.deprecated);
+}
+const KEEPS_NONE = () => false;
+function documentEntries(record, options, isKept = KEEPS_NONE) {
+  const entries = Object.entries(record);
+  const sorted = options.alphabetize ? sortEntriesByKey(entries) : entries;
+  return options.excludeDeprecated ? sorted.filter(([, value]) => !isDeprecated(value) || isKept(value)) : sorted;
+}
+
+export { documentEntries, isDeprecated };
+//# sourceMappingURL=document-entries.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-entries.mjs","sources":["../../../src/application/transform/document-entries.ts"],"sourcesContent":["import { sortEntriesByKey } from \"../../domain/ir/normalize.js\";\nimport type { SchemaOptions } from \"./schema/schema-context.js\";\n\n/** Whether a document object has `deprecated: true` (`--exclude-deprecated` drops it). */\nexport function isDeprecated(value: unknown): boolean {\n  return Boolean(value && typeof value === \"object\" && \"deprecated\" in value && value.deprecated);\n}\n\n/** Whether a deprecated entry is still needed, so `--exclude-deprecated` keeps it. */\nexport type DeprecatedEntryFilter = (value: unknown) => boolean;\n\nconst KEEPS_NONE: DeprecatedEntryFilter = () => false;\n\n/**\n * `Object.entries` of a document map (the original `getEntries`): sorted for `--alphabetize`,\n * without deprecated entries for `--exclude-deprecated`, except those `isKept` names.\n */\nexport function documentEntries<T>(\n  record: Readonly<Record<string, T>>,\n  options: Pick<SchemaOptions, \"alphabetize\" | \"excludeDeprecated\">,\n  isKept: DeprecatedEntryFilter = KEEPS_NONE,\n): [string, T][] {\n  const entries = Object.entries(record);\n  const sorted = options.alphabetize ? sortEntriesByKey(entries) : entries;\n  return options.excludeDeprecated\n    ? sorted.filter(([, value]) => !isDeprecated(value) || isKept(value))\n    : sorted;\n}\n"],"names":[],"mappings":";;AAIO,SAAS,aAAa,KAAA,EAAyB;AACpD,EAAA,OAAO,OAAA,CAAQ,SAAS,OAAO,KAAA,KAAU,YAAY,YAAA,IAAgB,KAAA,IAAS,MAAM,UAAU,CAAA;AAChG;AAKA,MAAM,aAAoC,MAAM,KAAA;AAMzC,SAAS,eAAA,CACd,MAAA,EACA,OAAA,EACA,MAAA,GAAgC,UAAA,EACjB;AACf,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA;AACrC,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,WAAA,GAAc,gBAAA,CAAiB,OAAO,CAAA,GAAI,OAAA;AACjE,EAAA,OAAO,QAAQ,iBAAA,GACX,MAAA,CAAO,MAAA,CAAO,CAAC,GAAG,KAAK,CAAA,KAAM,CAAC,aAAa,KAAK,CAAA,IAAK,MAAA,CAAO,KAAK,CAAC,CAAA,GAClE,MAAA;AACN;;"}