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

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

@@ -1 +1 @@
-{"version":3,"file":"components.cjs","sources":["../../../../src/application/transform/document/components.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport {\n  hasIdentifierStart,\n  isReservedTypeName,\n  withIdentifierParts,\n} from \"../../../domain/ir/identifier-text.js\";\nimport type {\n  IrPropertySignature,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport {\n  COMPONENT_KINDS,\n  type ComponentKind,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n  isEnumSchema,\n  singularizeComponentKind,\n} from \"../../../domain/openapi/components-object.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { type DeprecatedEntryFilter, documentEntries } from \"../document-entries.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { schemaCommentOptionsOf, withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { headerType } from \"./header.js\";\nimport { contentEntryType } from \"./media-type.js\";\nimport { parameterType } from \"./parameter.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responseType } from \"./response.js\";\nimport { rootTypeAlias } from \"./root-type-aliases.js\";\n\ntype ComponentTransform = (\n  item: never,\n  location: SchemaLocation,\n  context: TransformContext,\n) => IrType;\n\nconst COMPONENT_TRANSFORMS: Readonly<Record<ComponentKind, ComponentTransform>> = {\n  schemas: transformSchema,\n  responses: responseType,\n  parameters: parameterType,\n  requestBodies: requestBodyType,\n  headers: headerType,\n  pathItems: pathItemType,\n  mediaTypes: contentEntryType,\n};\n\n/** The `components` type and the `--root-types` aliases. */\nexport interface ComponentsResult {\n  readonly type: IrType;\n  readonly rootTypes: readonly IrTypeAliasDeclaration[];\n}\n\n/** One component; the `transform` callback may replace its type, as for nested schemas. */\nfunction componentMember(\n  kind: ComponentKind,\n  name: string,\n  item: unknown,\n  context: TransformContext,\n): IrPropertySignature {\n  const location = { path: createRef([\"components\", kind, name]), schema: item };\n  const type = COMPONENT_TRANSFORMS[kind](item as never, location, context);\n  const custom = context.callbacks.transform(item, location);\n  const property = irProperty(toPropertyName(name), custom?.type ?? type, {\n    isOptional: custom?.isOptional ?? false,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, item, schemaCommentOptionsOf(context.options.fixes));\n}\n\n/**\n * The root alias name: `SchemaPet`, `ResponseNotFound`, … A taken name gets `_2`, `_3`, … The\n * original checks for conflicts before it removes the schema prefix, and so does this; for a clash\n * of exported names see `addRootAlias`.\n *\n * The original could build a name that is no identifier, so the generated file did not parse\n * (research/legacy-bugs.md, item 16): a kept casing keeps spaces and symbols, which become `_`;\n * and a name without the prefix can start with a digit, so it keeps the prefix (`Schema1`). A\n * kept casing without the prefix can also give a reserved name (`void`, `class`), which keeps the\n * prefix too (`Schemavoid`).\n */\nfunction rootTypeName(\n  kind: ComponentKind,\n  name: string,\n  aliases: Readonly<Record<string, IrTypeAliasDeclaration>>,\n  context: TransformContext,\n): string {\n  const { options, casing } = context;\n  const prefix = casing.pascalCase(singularizeComponentKind(kind));\n  const isSchema = kind === \"schemas\";\n  const base = withIdentifierParts(\n    options.rootTypesKeepCasing && isSchema ? name : casing.pascalCase(name),\n  );\n  const exportedName = (alias: string): string => {\n    const unprefixed = alias.replace(prefix, \"\");\n    const isUnprefixed = options.rootTypesNoSchemaPrefix && isSchema;\n    const isTypeName = hasIdentifierStart(unprefixed) && !isReservedTypeName(unprefixed);\n    return isUnprefixed && isTypeName ? unprefixed : alias;\n  };\n  let alias = `${prefix}${base}`;\n  for (let counter = 2; aliases[alias] !== undefined; counter++) {\n    alias = `${prefix}${base}_${counter}`;\n  }\n  return exportedName(alias);\n}\n\n/**\n * Add a root alias. When its exported name is taken (two schemas of one PascalCase name without\n * the prefix), the later schema takes the name, as in the original. Without the\n * `root-type-numbering` fix the earlier one then has no alias: that output is valid, so a number\n * for it would change it (backlog 30). With the fix the earlier alias is kept aside and follows\n * the others under the same name; `renameTakenAliases` numbers it once every name is known.\n */\nfunction addRootAlias(request: ComponentsRequest, alias: IrTypeAliasDeclaration): void {\n  const { aliases, displaced } = request;\n  const previous = aliases[alias.name];\n  if (previous !== undefined && displaced !== null) {\n    displaced.push(previous);\n  }\n  aliases[alias.name] = alias;\n}\n\n/** `--root-types` skips enum schemas under `--enum`: the enum itself is exported. */\nfunction hasRootType(kind: ComponentKind, item: unknown, context: TransformContext): boolean {\n  const { options } = context;\n  return options.rootTypes && !(options.enum && kind === \"schemas\" && isEnumSchema(item));\n}\n\n/** The components of one run, and the deprecated ones that kept output still references. */\ninterface ComponentsRequest {\n  readonly components: ComponentsObject;\n  readonly isKept: DeprecatedEntryFilter;\n  readonly aliases: Record<string, IrTypeAliasDeclaration>;\n  /** With the `root-type-numbering` fix: the aliases a later schema took the name of, in order. */\n  readonly displaced: IrTypeAliasDeclaration[] | null;\n}\n\nfunction kindMember(\n  kind: ComponentKind,\n  request: ComponentsRequest,\n  context: TransformContext,\n): IrPropertySignature {\n  const { components, isKept, aliases } = request;\n  const startedAt = context.diagnostics.now();\n  const items: IrPropertySignature[] = [];\n  for (const [name, item] of documentEntries(components[kind] ?? {}, context.options, isKept)) {\n    items.push(componentMember(kind, name, item, context));\n    if (hasRootType(kind, item, context)) {\n      addRootAlias(request, rootTypeAlias(rootTypeName(kind, name, aliases, context), kind, name));\n    }\n  }\n  const type = items.length > 0 ? irObject(items) : irKeyword(\"never\");\n  context.diagnostics.debug(\n    `Transformed components → ${kind}`,\n    context.diagnostics.now() - startedAt,\n  );\n  return irProperty(toPropertyName(kind), type);\n}\n\n/**\n * The `components` interface body (OpenAPI 3.1 §4.8.7), one member per component kind. With\n * `--exclude-deprecated`, `kept` holds the deprecated components that kept output references\n * (`keptDeprecatedComponents`); they stay, so no reference names a missing key.\n */\nexport function componentsType(\n  components: ComponentsObject,\n  context: TransformContext,\n  kept: ReadonlySet<object> = new Set(),\n): ComponentsResult {\n  // A plain object, as in the original: its key order (integer-like names first) is the\n  // output order.\n  const aliases: Record<string, IrTypeAliasDeclaration> = {};\n  const displaced = context.options.fixes.has(FIX.ROOT_TYPE_NUMBERING) ? [] : null;\n  const isKept = (item: unknown) => kept.has(item as object);\n  const request = { components, isKept, aliases, displaced };\n  const declaredKinds = DECLARED_COMPONENT_KINDS.filter((kind) => components[kind] !== undefined);\n  const members = [...COMPONENT_KINDS, ...declaredKinds].map((kind) =>\n    kindMember(kind, request, context),\n  );\n  const rootTypes = Object.values(aliases);\n  return {\n    type: irObject(members),\n    rootTypes: [...rootTypes, ...(displaced ?? [])],\n  };\n}\n"],"names":["transformSchema","responseType","parameterType","requestBodyType","headerType","pathItemType","contentEntryType","createRef","irProperty","toPropertyName","withSchemaComment","schemaCommentOptionsOf","singularizeComponentKind","withIdentifierParts","alias","hasIdentifierStart","isReservedTypeName","isEnumSchema","documentEntries","rootTypeAlias","irObject","irKeyword","FIX","DECLARED_COMPONENT_KINDS","COMPONENT_KINDS"],"mappings":"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"}
+{"version":3,"file":"components.cjs","sources":["../../../../src/application/transform/document/components.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport {\n  hasIdentifierStart,\n  isReservedTypeName,\n  withIdentifierParts,\n} from \"../../../domain/ir/identifier-text.js\";\nimport type {\n  IrPropertySignature,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport {\n  COMPONENT_KINDS,\n  type ComponentKind,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n  isEnumSchema,\n  singularizeComponentKind,\n} from \"../../../domain/openapi/components-object.js\";\nimport { appendPointer, ROOT_POINTER } from \"../../../domain/openapi/json-pointer.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { type DeprecatedEntryFilter, documentEntries } from \"../document-entries.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { schemaCommentOptionsOf, withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { headerType } from \"./header.js\";\nimport { contentEntryType } from \"./media-type.js\";\nimport { parameterType } from \"./parameter.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responseType } from \"./response.js\";\nimport { rootTypeAlias } from \"./root-type-aliases.js\";\n\ntype ComponentTransform = (\n  item: never,\n  location: SchemaLocation,\n  context: TransformContext,\n) => IrType;\n\nconst COMPONENT_TRANSFORMS: Readonly<Record<ComponentKind, ComponentTransform>> = {\n  schemas: transformSchema,\n  responses: responseType,\n  parameters: parameterType,\n  requestBodies: requestBodyType,\n  headers: headerType,\n  pathItems: pathItemType,\n  mediaTypes: contentEntryType,\n};\n\n/** The `components` type and the `--root-types` aliases. */\nexport interface ComponentsResult {\n  readonly type: IrType;\n  readonly rootTypes: readonly IrTypeAliasDeclaration[];\n}\n\n/** One component; the `transform` callback may replace its type, as for nested schemas. */\nfunction componentMember(\n  kind: ComponentKind,\n  name: string,\n  item: unknown,\n  context: TransformContext,\n): IrPropertySignature {\n  const location = { path: appendPointer(ROOT_POINTER, [\"components\", kind, name]), schema: item };\n  const type = COMPONENT_TRANSFORMS[kind](item as never, location, context);\n  const custom = context.callbacks.transform(item, location);\n  const property = irProperty(toPropertyName(name), custom?.type ?? type, {\n    isOptional: custom?.isOptional ?? false,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, item, schemaCommentOptionsOf(context.options.fixes));\n}\n\n/**\n * The root alias name: `SchemaPet`, `ResponseNotFound`, … A taken name gets `_2`, `_3`, … The\n * original checks for conflicts before it removes the schema prefix, and so does this; for a clash\n * of exported names see `addRootAlias`.\n *\n * The original could build a name that is no identifier, so the generated file did not parse\n * (research/legacy-bugs.md, item 16): a kept casing keeps spaces and symbols, which become `_`;\n * and a name without the prefix can start with a digit, so it keeps the prefix (`Schema1`). A\n * kept casing without the prefix can also give a reserved name (`void`, `class`), which keeps the\n * prefix too (`Schemavoid`).\n */\nfunction rootTypeName(\n  kind: ComponentKind,\n  name: string,\n  aliases: Readonly<Record<string, IrTypeAliasDeclaration>>,\n  context: TransformContext,\n): string {\n  const { options, casing } = context;\n  const prefix = casing.pascalCase(singularizeComponentKind(kind));\n  const isSchema = kind === \"schemas\";\n  const base = withIdentifierParts(\n    options.rootTypesKeepCasing && isSchema ? name : casing.pascalCase(name),\n  );\n  const exportedName = (alias: string): string => {\n    const unprefixed = alias.replace(prefix, \"\");\n    const isUnprefixed = options.rootTypesNoSchemaPrefix && isSchema;\n    const isTypeName = hasIdentifierStart(unprefixed) && !isReservedTypeName(unprefixed);\n    return isUnprefixed && isTypeName ? unprefixed : alias;\n  };\n  let alias = `${prefix}${base}`;\n  for (let counter = 2; aliases[alias] !== undefined; counter++) {\n    alias = `${prefix}${base}_${counter}`;\n  }\n  return exportedName(alias);\n}\n\n/**\n * Add a root alias. When its exported name is taken (two schemas of one PascalCase name without\n * the prefix), the later schema takes the name, as in the original. Without the\n * `root-type-numbering` fix the earlier one then has no alias: that output is valid, so a number\n * for it would change it (backlog 30). With the fix the earlier alias is kept aside and follows\n * the others under the same name; `renameTakenAliases` numbers it once every name is known.\n */\nfunction addRootAlias(request: ComponentsRequest, alias: IrTypeAliasDeclaration): void {\n  const { aliases, displaced } = request;\n  const previous = aliases[alias.name];\n  if (previous !== undefined && displaced !== null) {\n    displaced.push(previous);\n  }\n  aliases[alias.name] = alias;\n}\n\n/** `--root-types` skips enum schemas under `--enum`: the enum itself is exported. */\nfunction hasRootType(kind: ComponentKind, item: unknown, context: TransformContext): boolean {\n  const { options } = context;\n  return options.rootTypes && !(options.enum && kind === \"schemas\" && isEnumSchema(item));\n}\n\n/** The components of one run, and the deprecated ones that kept output still references. */\ninterface ComponentsRequest {\n  readonly components: ComponentsObject;\n  readonly isKept: DeprecatedEntryFilter;\n  readonly aliases: Record<string, IrTypeAliasDeclaration>;\n  /** With the `root-type-numbering` fix: the aliases a later schema took the name of, in order. */\n  readonly displaced: IrTypeAliasDeclaration[] | null;\n}\n\nfunction kindMember(\n  kind: ComponentKind,\n  request: ComponentsRequest,\n  context: TransformContext,\n): IrPropertySignature {\n  const { components, isKept, aliases } = request;\n  const startedAt = context.diagnostics.now();\n  const items: IrPropertySignature[] = [];\n  for (const [name, item] of documentEntries(components[kind] ?? {}, context.options, isKept)) {\n    items.push(componentMember(kind, name, item, context));\n    if (hasRootType(kind, item, context)) {\n      addRootAlias(request, rootTypeAlias(rootTypeName(kind, name, aliases, context), kind, name));\n    }\n  }\n  const type = items.length > 0 ? irObject(items) : irKeyword(\"never\");\n  context.diagnostics.debug(\n    `Transformed components → ${kind}`,\n    context.diagnostics.now() - startedAt,\n  );\n  return irProperty(toPropertyName(kind), type);\n}\n\n/**\n * The `components` interface body (OpenAPI 3.1 §4.8.7), one member per component kind. With\n * `--exclude-deprecated`, `kept` holds the deprecated components that kept output references\n * (`keptDeprecatedComponents`); they stay, so no reference names a missing key.\n */\nexport function componentsType(\n  components: ComponentsObject,\n  context: TransformContext,\n  kept: ReadonlySet<object> = new Set(),\n): ComponentsResult {\n  // A plain object, as in the original: its key order (integer-like names first) is the\n  // output order.\n  const aliases: Record<string, IrTypeAliasDeclaration> = {};\n  const displaced = context.options.fixes.has(FIX.ROOT_TYPE_NUMBERING) ? [] : null;\n  const isKept = (item: unknown) => kept.has(item as object);\n  const request = { components, isKept, aliases, displaced };\n  const declaredKinds = DECLARED_COMPONENT_KINDS.filter((kind) => components[kind] !== undefined);\n  const members = [...COMPONENT_KINDS, ...declaredKinds].map((kind) =>\n    kindMember(kind, request, context),\n  );\n  const rootTypes = Object.values(aliases);\n  return {\n    type: irObject(members),\n    rootTypes: [...rootTypes, ...(displaced ?? [])],\n  };\n}\n"],"names":["transformSchema","responseType","parameterType","requestBodyType","headerType","pathItemType","contentEntryType","appendPointer","ROOT_POINTER","irProperty","toPropertyName","withSchemaComment","schemaCommentOptionsOf","singularizeComponentKind","withIdentifierParts","alias","hasIdentifierStart","isReservedTypeName","isEnumSchema","documentEntries","rootTypeAlias","irObject","irKeyword","FIX","DECLARED_COMPONENT_KINDS","COMPONENT_KINDS"],"mappings":";;;;;;;;;;;;;;;;;;;AAyCA,MAAM,oBAAA,GAA4E;AAAA,EAChF,OAAA,EAASA,+BAAA;AAAA,EACT,SAAA,EAAWC,qBAAA;AAAA,EACX,UAAA,EAAYC,uBAAA;AAAA,EACZ,aAAA,EAAeC,2BAAA;AAAA,EACf,OAAA,EAASC,iBAAA;AAAA,EACT,SAAA,EAAWC,qBAAA;AAAA,EACX,UAAA,EAAYC;AACd,CAAA;AASA,SAAS,eAAA,CACP,IAAA,EACA,IAAA,EACA,IAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,QAAA,GAAW,EAAE,IAAA,EAAMC,yBAAA,CAAcC,wBAAA,EAAc,CAAC,YAAA,EAAc,IAAA,EAAM,IAAI,CAAC,CAAA,EAAG,MAAA,EAAQ,IAAA,EAAK;AAC/F,EAAA,MAAM,OAAO,oBAAA,CAAqB,IAAI,CAAA,CAAE,IAAA,EAAe,UAAU,OAAO,CAAA;AACxE,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,SAAA,CAAU,SAAA,CAAU,MAAM,QAAQ,CAAA;AACzD,EAAA,MAAM,WAAWC,uBAAA,CAAWC,2BAAA,CAAe,IAAI,CAAA,EAAG,MAAA,EAAQ,QAAQ,IAAA,EAAM;AAAA,IACtE,UAAA,EAAY,QAAQ,UAAA,IAAc,KAAA;AAAA,IAClC,UAAA,EAAY,QAAQ,OAAA,CAAQ;AAAA,GAC7B,CAAA;AACD,EAAA,OAAOC,gCAAkB,QAAA,EAAU,IAAA,EAAMC,qCAAuB,OAAA,CAAQ,OAAA,CAAQ,KAAK,CAAC,CAAA;AACxF;AAaA,SAAS,YAAA,CACP,IAAA,EACA,IAAA,EACA,OAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,EAAE,OAAA,EAAS,MAAA,EAAO,GAAI,OAAA;AAC5B,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,UAAA,CAAWC,yCAAA,CAAyB,IAAI,CAAC,CAAA;AAC/D,EAAA,MAAM,WAAW,IAAA,KAAS,SAAA;AAC1B,EAAA,MAAM,IAAA,GAAOC,kCAAA;AAAA,IACX,QAAQ,mBAAA,IAAuB,QAAA,GAAW,IAAA,GAAO,MAAA,CAAO,WAAW,IAAI;AAAA,GACzE;AACA,EAAA,MAAM,YAAA,GAAe,CAACC,MAAAA,KAA0B;AAC9C,IAAA,MAAM,UAAA,GAAaA,MAAAA,CAAM,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AAC3C,IAAA,MAAM,YAAA,GAAe,QAAQ,uBAAA,IAA2B,QAAA;AACxD,IAAA,MAAM,aAAaC,iCAAA,CAAmB,UAAU,CAAA,IAAK,CAACC,kCAAmB,UAAU,CAAA;AACnF,IAAA,OAAO,YAAA,IAAgB,aAAa,UAAA,GAAaF,MAAAA;AAAA,EACnD,CAAA;AACA,EAAA,IAAI,KAAA,GAAQ,CAAA,EAAG,MAAM,CAAA,EAAG,IAAI,CAAA,CAAA;AAC5B,EAAA,KAAA,IAAS,UAAU,CAAA,EAAG,OAAA,CAAQ,KAAK,CAAA,KAAM,QAAW,OAAA,EAAA,EAAW;AAC7D,IAAA,KAAA,GAAQ,CAAA,EAAG,MAAM,CAAA,EAAG,IAAI,IAAI,OAAO,CAAA,CAAA;AAAA,EACrC;AACA,EAAA,OAAO,aAAa,KAAK,CAAA;AAC3B;AASA,SAAS,YAAA,CAAa,SAA4B,KAAA,EAAqC;AACrF,EAAA,MAAM,EAAE,OAAA,EAAS,SAAA,EAAU,GAAI,OAAA;AAC/B,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA;AACnC,EAAA,IAAI,QAAA,KAAa,MAAA,IAAa,SAAA,KAAc,IAAA,EAAM;AAChD,IAAA,SAAA,CAAU,KAAK,QAAQ,CAAA;AAAA,EACzB;AACA,EAAA,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAAI,KAAA;AACxB;AAGA,SAAS,WAAA,CAAY,IAAA,EAAqB,IAAA,EAAe,OAAA,EAAoC;AAC3F,EAAA,MAAM,EAAE,SAAQ,GAAI,OAAA;AACpB,EAAA,OAAO,OAAA,CAAQ,aAAa,EAAE,OAAA,CAAQ,QAAQ,IAAA,KAAS,SAAA,IAAaG,8BAAa,IAAI,CAAA,CAAA;AACvF;AAWA,SAAS,UAAA,CACP,IAAA,EACA,OAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,EAAE,UAAA,EAAY,MAAA,EAAQ,OAAA,EAAQ,GAAI,OAAA;AACxC,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,WAAA,CAAY,GAAA,EAAI;AAC1C,EAAA,MAAM,QAA+B,EAAC;AACtC,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,IAAI,CAAA,IAAKC,+BAAA,CAAgB,UAAA,CAAW,IAAI,CAAA,IAAK,EAAC,EAAG,OAAA,CAAQ,OAAA,EAAS,MAAM,CAAA,EAAG;AAC3F,IAAA,KAAA,CAAM,KAAK,eAAA,CAAgB,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,OAAO,CAAC,CAAA;AACrD,IAAA,IAAI,WAAA,CAAY,IAAA,EAAM,IAAA,EAAM,OAAO,CAAA,EAAG;AACpC,MAAA,YAAA,CAAa,OAAA,EAASC,6BAAA,CAAc,YAAA,CAAa,IAAA,EAAM,IAAA,EAAM,SAAS,OAAO,CAAA,EAAG,IAAA,EAAM,IAAI,CAAC,CAAA;AAAA,IAC7F;AAAA,EACF;AACA,EAAA,MAAM,IAAA,GAAO,MAAM,MAAA,GAAS,CAAA,GAAIC,sBAAS,KAAK,CAAA,GAAIC,uBAAU,OAAO,CAAA;AACnE,EAAA,OAAA,CAAQ,WAAA,CAAY,KAAA;AAAA,IAClB,iCAA4B,IAAI,CAAA,CAAA;AAAA,IAChC,OAAA,CAAQ,WAAA,CAAY,GAAA,EAAI,GAAI;AAAA,GAC9B;AACA,EAAA,OAAOb,uBAAA,CAAWC,2BAAA,CAAe,IAAI,CAAA,EAAG,IAAI,CAAA;AAC9C;AAOO,SAAS,eACd,UAAA,EACA,OAAA,EACA,IAAA,mBAA4B,IAAI,KAAI,EAClB;AAGlB,EAAA,MAAM,UAAkD,EAAC;AACzD,EAAA,MAAM,SAAA,GAAY,QAAQ,OAAA,CAAQ,KAAA,CAAM,IAAIa,eAAA,CAAI,mBAAmB,CAAA,GAAI,EAAC,GAAI,IAAA;AAC5E,EAAA,MAAM,MAAA,GAAS,CAAC,IAAA,KAAkB,IAAA,CAAK,IAAI,IAAc,CAAA;AACzD,EAAA,MAAM,OAAA,GAAU,EAAE,UAAA,EAAY,MAAA,EAAQ,SAAS,SAAA,EAAU;AACzD,EAAA,MAAM,aAAA,GAAgBC,0CAAyB,MAAA,CAAO,CAAC,SAAS,UAAA,CAAW,IAAI,MAAM,MAAS,CAAA;AAC9F,EAAA,MAAM,UAAU,CAAC,GAAGC,gCAAA,EAAiB,GAAG,aAAa,CAAA,CAAE,GAAA;AAAA,IAAI,CAAC,IAAA,KAC1D,UAAA,CAAW,IAAA,EAAM,SAAS,OAAO;AAAA,GACnC;AACA,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,MAAA,CAAO,OAAO,CAAA;AACvC,EAAA,OAAO;AAAA,IACL,IAAA,EAAMJ,sBAAS,OAAO,CAAA;AAAA,IACtB,WAAW,CAAC,GAAG,WAAW,GAAI,SAAA,IAAa,EAAG;AAAA,GAChD;AACF;;"}

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

@@ -2,7 +2,7 @@ import { irObject, irProperty, irKeyword } from '../../../domain/ir/constructors
 import { withIdentifierParts, hasIdentifierStart, isReservedTypeName } from '../../../domain/ir/identifier-text.mjs';
 import { toPropertyName } from '../../../domain/ir/property-name.mjs';
 import { DECLARED_COMPONENT_KINDS, COMPONENT_KINDS, isEnumSchema, singularizeComponentKind } from '../../../domain/openapi/components-object.mjs';
-import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { appendPointer, ROOT_POINTER } 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';
@@ -25,7 +25,7 @@ const COMPONENT_TRANSFORMS = {
   mediaTypes: contentEntryType
 };
 function componentMember(kind, name, item, context) {
-  const location = { path: createRef(["components", kind, name]), schema: item };
+  const location = { path: appendPointer(ROOT_POINTER, ["components", kind, name]), schema: item };
   const type = COMPONENT_TRANSFORMS[kind](item, location, context);
   const custom = context.callbacks.transform(item, location);
   const property = irProperty(toPropertyName(name), custom?.type ?? type, {

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

@@ -1 +1 @@
-{"version":3,"file":"components.mjs","sources":["../../../../src/application/transform/document/components.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport {\n  hasIdentifierStart,\n  isReservedTypeName,\n  withIdentifierParts,\n} from \"../../../domain/ir/identifier-text.js\";\nimport type {\n  IrPropertySignature,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport {\n  COMPONENT_KINDS,\n  type ComponentKind,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n  isEnumSchema,\n  singularizeComponentKind,\n} from \"../../../domain/openapi/components-object.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { type DeprecatedEntryFilter, documentEntries } from \"../document-entries.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { schemaCommentOptionsOf, withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { headerType } from \"./header.js\";\nimport { contentEntryType } from \"./media-type.js\";\nimport { parameterType } from \"./parameter.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responseType } from \"./response.js\";\nimport { rootTypeAlias } from \"./root-type-aliases.js\";\n\ntype ComponentTransform = (\n  item: never,\n  location: SchemaLocation,\n  context: TransformContext,\n) => IrType;\n\nconst COMPONENT_TRANSFORMS: Readonly<Record<ComponentKind, ComponentTransform>> = {\n  schemas: transformSchema,\n  responses: responseType,\n  parameters: parameterType,\n  requestBodies: requestBodyType,\n  headers: headerType,\n  pathItems: pathItemType,\n  mediaTypes: contentEntryType,\n};\n\n/** The `components` type and the `--root-types` aliases. */\nexport interface ComponentsResult {\n  readonly type: IrType;\n  readonly rootTypes: readonly IrTypeAliasDeclaration[];\n}\n\n/** One component; the `transform` callback may replace its type, as for nested schemas. */\nfunction componentMember(\n  kind: ComponentKind,\n  name: string,\n  item: unknown,\n  context: TransformContext,\n): IrPropertySignature {\n  const location = { path: createRef([\"components\", kind, name]), schema: item };\n  const type = COMPONENT_TRANSFORMS[kind](item as never, location, context);\n  const custom = context.callbacks.transform(item, location);\n  const property = irProperty(toPropertyName(name), custom?.type ?? type, {\n    isOptional: custom?.isOptional ?? false,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, item, schemaCommentOptionsOf(context.options.fixes));\n}\n\n/**\n * The root alias name: `SchemaPet`, `ResponseNotFound`, … A taken name gets `_2`, `_3`, … The\n * original checks for conflicts before it removes the schema prefix, and so does this; for a clash\n * of exported names see `addRootAlias`.\n *\n * The original could build a name that is no identifier, so the generated file did not parse\n * (research/legacy-bugs.md, item 16): a kept casing keeps spaces and symbols, which become `_`;\n * and a name without the prefix can start with a digit, so it keeps the prefix (`Schema1`). A\n * kept casing without the prefix can also give a reserved name (`void`, `class`), which keeps the\n * prefix too (`Schemavoid`).\n */\nfunction rootTypeName(\n  kind: ComponentKind,\n  name: string,\n  aliases: Readonly<Record<string, IrTypeAliasDeclaration>>,\n  context: TransformContext,\n): string {\n  const { options, casing } = context;\n  const prefix = casing.pascalCase(singularizeComponentKind(kind));\n  const isSchema = kind === \"schemas\";\n  const base = withIdentifierParts(\n    options.rootTypesKeepCasing && isSchema ? name : casing.pascalCase(name),\n  );\n  const exportedName = (alias: string): string => {\n    const unprefixed = alias.replace(prefix, \"\");\n    const isUnprefixed = options.rootTypesNoSchemaPrefix && isSchema;\n    const isTypeName = hasIdentifierStart(unprefixed) && !isReservedTypeName(unprefixed);\n    return isUnprefixed && isTypeName ? unprefixed : alias;\n  };\n  let alias = `${prefix}${base}`;\n  for (let counter = 2; aliases[alias] !== undefined; counter++) {\n    alias = `${prefix}${base}_${counter}`;\n  }\n  return exportedName(alias);\n}\n\n/**\n * Add a root alias. When its exported name is taken (two schemas of one PascalCase name without\n * the prefix), the later schema takes the name, as in the original. Without the\n * `root-type-numbering` fix the earlier one then has no alias: that output is valid, so a number\n * for it would change it (backlog 30). With the fix the earlier alias is kept aside and follows\n * the others under the same name; `renameTakenAliases` numbers it once every name is known.\n */\nfunction addRootAlias(request: ComponentsRequest, alias: IrTypeAliasDeclaration): void {\n  const { aliases, displaced } = request;\n  const previous = aliases[alias.name];\n  if (previous !== undefined && displaced !== null) {\n    displaced.push(previous);\n  }\n  aliases[alias.name] = alias;\n}\n\n/** `--root-types` skips enum schemas under `--enum`: the enum itself is exported. */\nfunction hasRootType(kind: ComponentKind, item: unknown, context: TransformContext): boolean {\n  const { options } = context;\n  return options.rootTypes && !(options.enum && kind === \"schemas\" && isEnumSchema(item));\n}\n\n/** The components of one run, and the deprecated ones that kept output still references. */\ninterface ComponentsRequest {\n  readonly components: ComponentsObject;\n  readonly isKept: DeprecatedEntryFilter;\n  readonly aliases: Record<string, IrTypeAliasDeclaration>;\n  /** With the `root-type-numbering` fix: the aliases a later schema took the name of, in order. */\n  readonly displaced: IrTypeAliasDeclaration[] | null;\n}\n\nfunction kindMember(\n  kind: ComponentKind,\n  request: ComponentsRequest,\n  context: TransformContext,\n): IrPropertySignature {\n  const { components, isKept, aliases } = request;\n  const startedAt = context.diagnostics.now();\n  const items: IrPropertySignature[] = [];\n  for (const [name, item] of documentEntries(components[kind] ?? {}, context.options, isKept)) {\n    items.push(componentMember(kind, name, item, context));\n    if (hasRootType(kind, item, context)) {\n      addRootAlias(request, rootTypeAlias(rootTypeName(kind, name, aliases, context), kind, name));\n    }\n  }\n  const type = items.length > 0 ? irObject(items) : irKeyword(\"never\");\n  context.diagnostics.debug(\n    `Transformed components → ${kind}`,\n    context.diagnostics.now() - startedAt,\n  );\n  return irProperty(toPropertyName(kind), type);\n}\n\n/**\n * The `components` interface body (OpenAPI 3.1 §4.8.7), one member per component kind. With\n * `--exclude-deprecated`, `kept` holds the deprecated components that kept output references\n * (`keptDeprecatedComponents`); they stay, so no reference names a missing key.\n */\nexport function componentsType(\n  components: ComponentsObject,\n  context: TransformContext,\n  kept: ReadonlySet<object> = new Set(),\n): ComponentsResult {\n  // A plain object, as in the original: its key order (integer-like names first) is the\n  // output order.\n  const aliases: Record<string, IrTypeAliasDeclaration> = {};\n  const displaced = context.options.fixes.has(FIX.ROOT_TYPE_NUMBERING) ? [] : null;\n  const isKept = (item: unknown) => kept.has(item as object);\n  const request = { components, isKept, aliases, displaced };\n  const declaredKinds = DECLARED_COMPONENT_KINDS.filter((kind) => components[kind] !== undefined);\n  const members = [...COMPONENT_KINDS, ...declaredKinds].map((kind) =>\n    kindMember(kind, request, context),\n  );\n  const rootTypes = Object.values(aliases);\n  return {\n    type: irObject(members),\n    rootTypes: [...rootTypes, ...(displaced ?? [])],\n  };\n}\n"],"names":["alias"],"mappings":"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"}
+{"version":3,"file":"components.mjs","sources":["../../../../src/application/transform/document/components.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport {\n  hasIdentifierStart,\n  isReservedTypeName,\n  withIdentifierParts,\n} from \"../../../domain/ir/identifier-text.js\";\nimport type {\n  IrPropertySignature,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport {\n  COMPONENT_KINDS,\n  type ComponentKind,\n  type ComponentsObject,\n  DECLARED_COMPONENT_KINDS,\n  isEnumSchema,\n  singularizeComponentKind,\n} from \"../../../domain/openapi/components-object.js\";\nimport { appendPointer, ROOT_POINTER } from \"../../../domain/openapi/json-pointer.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { type DeprecatedEntryFilter, documentEntries } from \"../document-entries.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { schemaCommentOptionsOf, withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { headerType } from \"./header.js\";\nimport { contentEntryType } from \"./media-type.js\";\nimport { parameterType } from \"./parameter.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responseType } from \"./response.js\";\nimport { rootTypeAlias } from \"./root-type-aliases.js\";\n\ntype ComponentTransform = (\n  item: never,\n  location: SchemaLocation,\n  context: TransformContext,\n) => IrType;\n\nconst COMPONENT_TRANSFORMS: Readonly<Record<ComponentKind, ComponentTransform>> = {\n  schemas: transformSchema,\n  responses: responseType,\n  parameters: parameterType,\n  requestBodies: requestBodyType,\n  headers: headerType,\n  pathItems: pathItemType,\n  mediaTypes: contentEntryType,\n};\n\n/** The `components` type and the `--root-types` aliases. */\nexport interface ComponentsResult {\n  readonly type: IrType;\n  readonly rootTypes: readonly IrTypeAliasDeclaration[];\n}\n\n/** One component; the `transform` callback may replace its type, as for nested schemas. */\nfunction componentMember(\n  kind: ComponentKind,\n  name: string,\n  item: unknown,\n  context: TransformContext,\n): IrPropertySignature {\n  const location = { path: appendPointer(ROOT_POINTER, [\"components\", kind, name]), schema: item };\n  const type = COMPONENT_TRANSFORMS[kind](item as never, location, context);\n  const custom = context.callbacks.transform(item, location);\n  const property = irProperty(toPropertyName(name), custom?.type ?? type, {\n    isOptional: custom?.isOptional ?? false,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, item, schemaCommentOptionsOf(context.options.fixes));\n}\n\n/**\n * The root alias name: `SchemaPet`, `ResponseNotFound`, … A taken name gets `_2`, `_3`, … The\n * original checks for conflicts before it removes the schema prefix, and so does this; for a clash\n * of exported names see `addRootAlias`.\n *\n * The original could build a name that is no identifier, so the generated file did not parse\n * (research/legacy-bugs.md, item 16): a kept casing keeps spaces and symbols, which become `_`;\n * and a name without the prefix can start with a digit, so it keeps the prefix (`Schema1`). A\n * kept casing without the prefix can also give a reserved name (`void`, `class`), which keeps the\n * prefix too (`Schemavoid`).\n */\nfunction rootTypeName(\n  kind: ComponentKind,\n  name: string,\n  aliases: Readonly<Record<string, IrTypeAliasDeclaration>>,\n  context: TransformContext,\n): string {\n  const { options, casing } = context;\n  const prefix = casing.pascalCase(singularizeComponentKind(kind));\n  const isSchema = kind === \"schemas\";\n  const base = withIdentifierParts(\n    options.rootTypesKeepCasing && isSchema ? name : casing.pascalCase(name),\n  );\n  const exportedName = (alias: string): string => {\n    const unprefixed = alias.replace(prefix, \"\");\n    const isUnprefixed = options.rootTypesNoSchemaPrefix && isSchema;\n    const isTypeName = hasIdentifierStart(unprefixed) && !isReservedTypeName(unprefixed);\n    return isUnprefixed && isTypeName ? unprefixed : alias;\n  };\n  let alias = `${prefix}${base}`;\n  for (let counter = 2; aliases[alias] !== undefined; counter++) {\n    alias = `${prefix}${base}_${counter}`;\n  }\n  return exportedName(alias);\n}\n\n/**\n * Add a root alias. When its exported name is taken (two schemas of one PascalCase name without\n * the prefix), the later schema takes the name, as in the original. Without the\n * `root-type-numbering` fix the earlier one then has no alias: that output is valid, so a number\n * for it would change it (backlog 30). With the fix the earlier alias is kept aside and follows\n * the others under the same name; `renameTakenAliases` numbers it once every name is known.\n */\nfunction addRootAlias(request: ComponentsRequest, alias: IrTypeAliasDeclaration): void {\n  const { aliases, displaced } = request;\n  const previous = aliases[alias.name];\n  if (previous !== undefined && displaced !== null) {\n    displaced.push(previous);\n  }\n  aliases[alias.name] = alias;\n}\n\n/** `--root-types` skips enum schemas under `--enum`: the enum itself is exported. */\nfunction hasRootType(kind: ComponentKind, item: unknown, context: TransformContext): boolean {\n  const { options } = context;\n  return options.rootTypes && !(options.enum && kind === \"schemas\" && isEnumSchema(item));\n}\n\n/** The components of one run, and the deprecated ones that kept output still references. */\ninterface ComponentsRequest {\n  readonly components: ComponentsObject;\n  readonly isKept: DeprecatedEntryFilter;\n  readonly aliases: Record<string, IrTypeAliasDeclaration>;\n  /** With the `root-type-numbering` fix: the aliases a later schema took the name of, in order. */\n  readonly displaced: IrTypeAliasDeclaration[] | null;\n}\n\nfunction kindMember(\n  kind: ComponentKind,\n  request: ComponentsRequest,\n  context: TransformContext,\n): IrPropertySignature {\n  const { components, isKept, aliases } = request;\n  const startedAt = context.diagnostics.now();\n  const items: IrPropertySignature[] = [];\n  for (const [name, item] of documentEntries(components[kind] ?? {}, context.options, isKept)) {\n    items.push(componentMember(kind, name, item, context));\n    if (hasRootType(kind, item, context)) {\n      addRootAlias(request, rootTypeAlias(rootTypeName(kind, name, aliases, context), kind, name));\n    }\n  }\n  const type = items.length > 0 ? irObject(items) : irKeyword(\"never\");\n  context.diagnostics.debug(\n    `Transformed components → ${kind}`,\n    context.diagnostics.now() - startedAt,\n  );\n  return irProperty(toPropertyName(kind), type);\n}\n\n/**\n * The `components` interface body (OpenAPI 3.1 §4.8.7), one member per component kind. With\n * `--exclude-deprecated`, `kept` holds the deprecated components that kept output references\n * (`keptDeprecatedComponents`); they stay, so no reference names a missing key.\n */\nexport function componentsType(\n  components: ComponentsObject,\n  context: TransformContext,\n  kept: ReadonlySet<object> = new Set(),\n): ComponentsResult {\n  // A plain object, as in the original: its key order (integer-like names first) is the\n  // output order.\n  const aliases: Record<string, IrTypeAliasDeclaration> = {};\n  const displaced = context.options.fixes.has(FIX.ROOT_TYPE_NUMBERING) ? [] : null;\n  const isKept = (item: unknown) => kept.has(item as object);\n  const request = { components, isKept, aliases, displaced };\n  const declaredKinds = DECLARED_COMPONENT_KINDS.filter((kind) => components[kind] !== undefined);\n  const members = [...COMPONENT_KINDS, ...declaredKinds].map((kind) =>\n    kindMember(kind, request, context),\n  );\n  const rootTypes = Object.values(aliases);\n  return {\n    type: irObject(members),\n    rootTypes: [...rootTypes, ...(displaced ?? [])],\n  };\n}\n"],"names":["alias"],"mappings":"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"}

package/dist/application/transform/document/declared-type-names.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+const RAW_TYPE_DECLARATION_RE = /^(?:export\s+)?(?:declare\s+)?(?:type|interface|enum|const\s+enum|class)\s+([A-Za-z_$][\w$]*)/gm;
+function typeNamesInText(text) {
+  return [...text.matchAll(RAW_TYPE_DECLARATION_RE)].map((match) => match[1] ?? "");
+}
+function typeNamesOf(declaration) {
+  switch (declaration.kind) {
+    case "rawDeclaration":
+      return declaration.name === void 0 ? typeNamesInText(declaration.text) : [declaration.name];
+    case "constArray":
+      return [];
+    default:
+      return [declaration.name];
+  }
+}
+function typeNamesDeclaredBy(declarations) {
+  return new Set(declarations.flatMap(typeNamesOf));
+}
+
+exports.typeNamesDeclaredBy = typeNamesDeclaredBy;
+exports.typeNamesInText = typeNamesInText;
+//# sourceMappingURL=declared-type-names.cjs.map

package/dist/application/transform/document/declared-type-names.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-type-names.cjs","sources":["../../../../src/application/transform/document/declared-type-names.ts"],"sourcesContent":["import type { IrDeclaration } from \"../../../domain/ir/nodes.js\";\n\n/**\n * The type names that declarations of the output take. Two declarations of one type name do not\n * compile (TS2300, TS2567), or merge into one type without an error (two enums, two interfaces).\n */\n\n/**\n * A declaration at the start of a line of raw text: the helper types, the `--read-write-markers`\n * types, `inject` text and footer nodes from user code. A `const` lives in the value namespace.\n */\nconst RAW_TYPE_DECLARATION_RE =\n  /^(?:export\\s+)?(?:declare\\s+)?(?:type|interface|enum|const\\s+enum|class)\\s+([A-Za-z_$][\\w$]*)/gm;\n\n/** The type names that raw declaration text declares. */\nexport function typeNamesInText(text: string): string[] {\n  return [...text.matchAll(RAW_TYPE_DECLARATION_RE)].map((match) => match[1] ?? \"\");\n}\n\nfunction typeNamesOf(declaration: IrDeclaration): readonly string[] {\n  switch (declaration.kind) {\n    case \"rawDeclaration\":\n      return declaration.name === undefined\n        ? typeNamesInText(declaration.text)\n        : [declaration.name];\n    case \"constArray\":\n      return [];\n    default:\n      return [declaration.name];\n  }\n}\n\n/** Every type name the declarations take; `--enum-values` arrays are values, so they take none. */\nexport function typeNamesDeclaredBy(declarations: readonly IrDeclaration[]): Set<string> {\n  return new Set(declarations.flatMap(typeNamesOf));\n}\n"],"names":[],"mappings":";;AAWA,MAAM,uBAAA,GACJ,iGAAA;AAGK,SAAS,gBAAgB,IAAA,EAAwB;AACtD,EAAA,OAAO,CAAC,GAAG,IAAA,CAAK,QAAA,CAAS,uBAAuB,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,KAAA,KAAU,KAAA,CAAM,CAAC,KAAK,EAAE,CAAA;AAClF;AAEA,SAAS,YAAY,WAAA,EAA+C;AAClE,EAAA,QAAQ,YAAY,IAAA;AAAM,IACxB,KAAK,gBAAA;AACH,MAAA,OAAO,WAAA,CAAY,SAAS,MAAA,GACxB,eAAA,CAAgB,YAAY,IAAI,CAAA,GAChC,CAAC,WAAA,CAAY,IAAI,CAAA;AAAA,IACvB,KAAK,YAAA;AACH,MAAA,OAAO,EAAC;AAAA,IACV;AACE,MAAA,OAAO,CAAC,YAAY,IAAI,CAAA;AAAA;AAE9B;AAGO,SAAS,oBAAoB,YAAA,EAAqD;AACvF,EAAA,OAAO,IAAI,GAAA,CAAI,YAAA,CAAa,OAAA,CAAQ,WAAW,CAAC,CAAA;AAClD;;;"}

package/dist/application/transform/document/declared-type-names.mjs

@@ -0,0 +1,20 @@
+const RAW_TYPE_DECLARATION_RE = /^(?:export\s+)?(?:declare\s+)?(?:type|interface|enum|const\s+enum|class)\s+([A-Za-z_$][\w$]*)/gm;
+function typeNamesInText(text) {
+  return [...text.matchAll(RAW_TYPE_DECLARATION_RE)].map((match) => match[1] ?? "");
+}
+function typeNamesOf(declaration) {
+  switch (declaration.kind) {
+    case "rawDeclaration":
+      return declaration.name === void 0 ? typeNamesInText(declaration.text) : [declaration.name];
+    case "constArray":
+      return [];
+    default:
+      return [declaration.name];
+  }
+}
+function typeNamesDeclaredBy(declarations) {
+  return new Set(declarations.flatMap(typeNamesOf));
+}
+
+export { typeNamesDeclaredBy, typeNamesInText };
+//# sourceMappingURL=declared-type-names.mjs.map

package/dist/application/transform/document/declared-type-names.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-type-names.mjs","sources":["../../../../src/application/transform/document/declared-type-names.ts"],"sourcesContent":["import type { IrDeclaration } from \"../../../domain/ir/nodes.js\";\n\n/**\n * The type names that declarations of the output take. Two declarations of one type name do not\n * compile (TS2300, TS2567), or merge into one type without an error (two enums, two interfaces).\n */\n\n/**\n * A declaration at the start of a line of raw text: the helper types, the `--read-write-markers`\n * types, `inject` text and footer nodes from user code. A `const` lives in the value namespace.\n */\nconst RAW_TYPE_DECLARATION_RE =\n  /^(?:export\\s+)?(?:declare\\s+)?(?:type|interface|enum|const\\s+enum|class)\\s+([A-Za-z_$][\\w$]*)/gm;\n\n/** The type names that raw declaration text declares. */\nexport function typeNamesInText(text: string): string[] {\n  return [...text.matchAll(RAW_TYPE_DECLARATION_RE)].map((match) => match[1] ?? \"\");\n}\n\nfunction typeNamesOf(declaration: IrDeclaration): readonly string[] {\n  switch (declaration.kind) {\n    case \"rawDeclaration\":\n      return declaration.name === undefined\n        ? typeNamesInText(declaration.text)\n        : [declaration.name];\n    case \"constArray\":\n      return [];\n    default:\n      return [declaration.name];\n  }\n}\n\n/** Every type name the declarations take; `--enum-values` arrays are values, so they take none. */\nexport function typeNamesDeclaredBy(declarations: readonly IrDeclaration[]): Set<string> {\n  return new Set(declarations.flatMap(typeNamesOf));\n}\n"],"names":[],"mappings":"AAWA,MAAM,uBAAA,GACJ,iGAAA;AAGK,SAAS,gBAAgB,IAAA,EAAwB;AACtD,EAAA,OAAO,CAAC,GAAG,IAAA,CAAK,QAAA,CAAS,uBAAuB,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,KAAA,KAAU,KAAA,CAAM,CAAC,KAAK,EAAE,CAAA;AAClF;AAEA,SAAS,YAAY,WAAA,EAA+C;AAClE,EAAA,QAAQ,YAAY,IAAA;AAAM,IACxB,KAAK,gBAAA;AACH,MAAA,OAAO,WAAA,CAAY,SAAS,MAAA,GACxB,eAAA,CAAgB,YAAY,IAAI,CAAA,GAChC,CAAC,WAAA,CAAY,IAAI,CAAA;AAAA,IACvB,KAAK,YAAA;AACH,MAAA,OAAO,EAAC;AAAA,IACV;AACE,MAAA,OAAO,CAAC,YAAY,IAAI,CAAA;AAAA;AAE9B;AAGO,SAAS,oBAAoB,YAAA,EAAqD;AACvF,EAAA,OAAO,IAAI,GAAA,CAAI,YAAA,CAAa,OAAA,CAAQ,WAAW,CAAC,CAAA;AAClD;;"}

package/dist/application/transform/document/defs-root.cjs

@@ -7,7 +7,7 @@ const schemaTransform = require('../schema/schema-transform.cjs');
 
 function defsRootType(defs, context) {
   const members = Object.entries(defs).map(([name, schema]) => {
-    const location = { path: jsonPointer.createRef(["$defs", name]), schema };
+    const location = { path: jsonPointer.appendPointer(jsonPointer.ROOT_POINTER, ["$defs", name]), schema };
     const type = schemaTransform.transformSchema(schema, location, context);
     return constructors.irProperty(propertyName.toPropertyName(name), type, { isReadonly: context.options.immutable });
   });

package/dist/application/transform/document/defs-root.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"defs-root.cjs","sources":["../../../../src/application/transform/document/defs-root.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrObjectType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport type { TransformContext } from \"../transform-context.js\";\n\n/**\n * The root `$defs` type: one required member per named subschema, so `#/$defs/<name>` refs\n * (`$defs[\"<name>\"]`) resolve. The original transformed the whole `$defs` map as one schema,\n * which gave `Record<string, never>` and made every such ref `never` (research/legacy-bugs.md,\n * item 18).\n */\nexport function defsRootType(\n  defs: Readonly<Record<string, Schema>>,\n  context: TransformContext,\n): IrObjectType {\n  const members = Object.entries(defs).map(([name, schema]) => {\n    const location = { path: createRef([\"$defs\", name]), schema };\n    const type = transformSchema(schema, location, context);\n    return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":["createRef","transformSchema","irProperty","toPropertyName","irObject"],"mappings":";;;;;;;AAcO,SAAS,YAAA,CACd,MACA,OAAA,EACc;AACd,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,CAAE,IAAI,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AAC3D,IAAA,MAAM,QAAA,GAAW,EAAE,IAAA,EAAMA,qBAAA,CAAU,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA,EAAG,MAAA,EAAO;AAC5D,IAAA,MAAM,IAAA,GAAOC,+BAAA,CAAgB,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA;AACtD,IAAA,OAAOC,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;;"}
+{"version":3,"file":"defs-root.cjs","sources":["../../../../src/application/transform/document/defs-root.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrObjectType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer, ROOT_POINTER } from \"../../../domain/openapi/json-pointer.js\";\nimport type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport type { TransformContext } from \"../transform-context.js\";\n\n/**\n * The root `$defs` type: one required member per named subschema, so `#/$defs/<name>` refs\n * (`$defs[\"<name>\"]`) resolve. The original transformed the whole `$defs` map as one schema,\n * which gave `Record<string, never>` and made every such ref `never` (research/legacy-bugs.md,\n * item 18).\n */\nexport function defsRootType(\n  defs: Readonly<Record<string, Schema>>,\n  context: TransformContext,\n): IrObjectType {\n  const members = Object.entries(defs).map(([name, schema]) => {\n    const location = { path: appendPointer(ROOT_POINTER, [\"$defs\", name]), schema };\n    const type = transformSchema(schema, location, context);\n    return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":["appendPointer","ROOT_POINTER","transformSchema","irProperty","toPropertyName","irObject"],"mappings":";;;;;;;AAcO,SAAS,YAAA,CACd,MACA,OAAA,EACc;AACd,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,CAAE,IAAI,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AAC3D,IAAA,MAAM,QAAA,GAAW,EAAE,IAAA,EAAMA,yBAAA,CAAcC,wBAAA,EAAc,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA,EAAG,MAAA,EAAO;AAC9E,IAAA,MAAM,IAAA,GAAOC,+BAAA,CAAgB,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA;AACtD,IAAA,OAAOC,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/defs-root.mjs

@@ -1,11 +1,11 @@
 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, ROOT_POINTER } from '../../../domain/openapi/json-pointer.mjs';
 import { transformSchema } from '../schema/schema-transform.mjs';
 
 function defsRootType(defs, context) {
   const members = Object.entries(defs).map(([name, schema]) => {
-    const location = { path: createRef(["$defs", name]), schema };
+    const location = { path: appendPointer(ROOT_POINTER, ["$defs", name]), schema };
     const type = transformSchema(schema, location, context);
     return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });
   });

package/dist/application/transform/document/defs-root.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"defs-root.mjs","sources":["../../../../src/application/transform/document/defs-root.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrObjectType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport type { TransformContext } from \"../transform-context.js\";\n\n/**\n * The root `$defs` type: one required member per named subschema, so `#/$defs/<name>` refs\n * (`$defs[\"<name>\"]`) resolve. The original transformed the whole `$defs` map as one schema,\n * which gave `Record<string, never>` and made every such ref `never` (research/legacy-bugs.md,\n * item 18).\n */\nexport function defsRootType(\n  defs: Readonly<Record<string, Schema>>,\n  context: TransformContext,\n): IrObjectType {\n  const members = Object.entries(defs).map(([name, schema]) => {\n    const location = { path: createRef([\"$defs\", name]), schema };\n    const type = transformSchema(schema, location, context);\n    return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":[],"mappings":";;;;;AAcO,SAAS,YAAA,CACd,MACA,OAAA,EACc;AACd,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,CAAE,IAAI,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AAC3D,IAAA,MAAM,QAAA,GAAW,EAAE,IAAA,EAAM,SAAA,CAAU,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA,EAAG,MAAA,EAAO;AAC5D,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA;AACtD,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;;"}
+{"version":3,"file":"defs-root.mjs","sources":["../../../../src/application/transform/document/defs-root.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrObjectType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer, ROOT_POINTER } from \"../../../domain/openapi/json-pointer.js\";\nimport type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport type { TransformContext } from \"../transform-context.js\";\n\n/**\n * The root `$defs` type: one required member per named subschema, so `#/$defs/<name>` refs\n * (`$defs[\"<name>\"]`) resolve. The original transformed the whole `$defs` map as one schema,\n * which gave `Record<string, never>` and made every such ref `never` (research/legacy-bugs.md,\n * item 18).\n */\nexport function defsRootType(\n  defs: Readonly<Record<string, Schema>>,\n  context: TransformContext,\n): IrObjectType {\n  const members = Object.entries(defs).map(([name, schema]) => {\n    const location = { path: appendPointer(ROOT_POINTER, [\"$defs\", name]), schema };\n    const type = transformSchema(schema, location, context);\n    return irProperty(toPropertyName(name), type, { isReadonly: context.options.immutable });\n  });\n  return irObject(members);\n}\n"],"names":[],"mappings":";;;;;AAcO,SAAS,YAAA,CACd,MACA,OAAA,EACc;AACd,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,CAAE,IAAI,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AAC3D,IAAA,MAAM,QAAA,GAAW,EAAE,IAAA,EAAM,aAAA,CAAc,YAAA,EAAc,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA,EAAG,MAAA,EAAO;AAC9E,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA;AACtD,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/document.cjs

@@ -1,11 +1,13 @@
 'use strict';
 
+const appendAll = require('../../../domain/append-all.cjs');
 const constructors = require('../../../domain/ir/constructors.cjs');
 const helperTypes = require('../helper-types.cjs');
 const components = require('./components.cjs');
 const declaredTypes = require('./declared-types.cjs');
 const defsRoot = require('./defs-root.cjs');
 const keptDeprecated$1 = require('./kept-deprecated.cjs');
+const pathItem = require('./path-item.cjs');
 const paths = require('./paths.cjs');
 const pathsEnum = require('./paths-enum.cjs');
 const webhooks = require('./webhooks.cjs');
@@ -90,7 +92,7 @@ function documentBody(document, context, footer = NO_FOOTER) {
   if (inject !== "") {
     declarations.push({ kind: "rawDeclaration", text: inject });
   }
-  declarations.push(...rootsDeclarations(document, context, footer));
+  appendAll.appendAll(declarations, rootsDeclarations(document, context, footer));
   return declarations;
 }
 function documentClosing(document, context, hasOperations) {
@@ -99,11 +101,14 @@ function documentClosing(document, context, hasOperations) {
     declarations.push(emptyAlias(OPERATIONS_NAME));
   }
   if (context.options.makePathsEnum && document.paths) {
-    declarations.push(pathsEnum.apiPathsEnumDeclaration(document.paths));
+    const isIncluded = (operation) => pathItem.isIncludedOperation(operation, context);
+    declarations.push(pathsEnum.apiPathsEnumDeclaration(document.paths, isIncluded));
   }
   return declarations;
 }
 
+exports.OPERATIONS_NAME = OPERATIONS_NAME;
+exports.ROOT_KEYS = ROOT_KEYS;
 exports.documentBody = documentBody;
 exports.documentClosing = documentClosing;
 //# sourceMappingURL=document.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"document.cjs","sources":["../../../../src/application/transform/document/document.ts"],"sourcesContent":["import { irKeyword, irObject, irRecord } from \"../../../domain/ir/constructors.js\";\nimport type {\n  IrDeclaration,\n  IrIntersectionType,\n  IrObjectType,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport type { ComponentsObject } from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport type { PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { READ_WRITE_MARKER_TYPES } from \"../helper-types.js\";\nimport type { TransformContext, TransformOptions } from \"../transform-context.js\";\nimport { componentsType } from \"./components.js\";\nimport { type DeclaredTypeLookup, declaredTypeLookup } from \"./declared-types.js\";\nimport { defsRootType } from \"./defs-root.js\";\nimport { keptDeprecatedComponents } from \"./kept-deprecated.js\";\nimport { pathMembers, pathsObjectType } from \"./paths.js\";\nimport { apiPathsEnumDeclaration } from \"./paths-enum.js\";\nimport { webhooksType } from \"./webhooks.js\";\n\n/** The root types, in output order. */\nconst ROOT_KEYS = Object.freeze([\"paths\", \"webhooks\", \"components\", \"$defs\"] as const);\ntype RootKey = (typeof ROOT_KEYS)[number];\n\nconst OPERATIONS_NAME = \"operations\";\n/** The type of a root without members: `Record<string, never>`. */\nconst EMPTY_ROOT_TYPE = irRecord(irKeyword(\"string\"), irKeyword(\"never\"));\n\n/** A root's type and the declarations that follow it (the `--root-types` aliases). */\ninterface RootResult {\n  readonly type: IrType;\n  readonly aliases: readonly IrTypeAliasDeclaration[];\n  /**\n   * The root's final type, for a root that reads the types the whole file declares (`paths`, whose\n   * overlap check follows references). `type` then only tells whether the root has members.\n   */\n  readonly withDeclaredTypes?: (lookup: DeclaredTypeLookup) => IrType;\n}\n\ntype RootTransform = (\n  node: object,\n  context: TransformContext,\n  document: DocumentObject,\n) => RootResult;\n\n/** Without `--exclude-deprecated` nothing is left out, so the scan is skipped. */\nfunction keptDeprecated(document: DocumentObject, context: TransformContext): ReadonlySet<object> {\n  return context.options.excludeDeprecated\n    ? keptDeprecatedComponents(document, context.refs)\n    : new Set();\n}\n\nconst ROOT_TRANSFORMS: Readonly<Record<RootKey, RootTransform>> = {\n  paths: (node, context) => {\n    const members = pathMembers(node as PathsObject, context);\n    return {\n      type: irObject(members.map(({ member }) => member)),\n      aliases: [],\n      withDeclaredTypes: (lookup) => pathsObjectType(members, lookup),\n    };\n  },\n  webhooks: (node, context) => ({ type: webhooksType(node as PathsObject, context), aliases: [] }),\n  components: (node, context, document) => {\n    const kept = keptDeprecated(document, context);\n    const { type, rootTypes } = componentsType(node as ComponentsObject, context, kept);\n    return { type, aliases: rootTypes };\n  },\n  $defs: (node, context) => ({\n    type: defsRootType(node as NonNullable<DocumentObject[\"$defs\"]>, context),\n    aliases: [],\n  }),\n};\n\nfunction emptyAlias(name: string): IrTypeAliasDeclaration {\n  return { kind: \"typeAlias\", name, isExported: true, type: EMPTY_ROOT_TYPE, comments: [] };\n}\n\n/** A root type that declares something: an object with members, or an intersection of them. */\ntype RootBodyType = IrObjectType | IrIntersectionType;\n\nfunction isRootBody(type: IrType): type is RootBodyType {\n  return (type.kind === \"object\" && type.members.length > 0) || type.kind === \"intersection\";\n}\n\n/**\n * A root with members: an interface, or a type alias with `--export-type`. An intersection (the\n * `paths` of overlapping `--path-params-as-types` keys) can only be a type alias.\n */\nfunction rootDeclaration(\n  name: RootKey,\n  type: RootBodyType,\n  options: TransformOptions,\n): IrDeclaration {\n  return options.exportType || type.kind === \"intersection\"\n    ? { kind: \"typeAlias\", name, isExported: true, type, comments: [] }\n    : { kind: \"interface\", name, isExported: true, members: type.members, comments: [] };\n}\n\n/**\n * The declarations of one root: its type, then its aliases. `finish` gives the root's declaration\n * again from the types the whole file declares, for a root with `withDeclaredTypes`.\n */\ninterface RootDeclarations {\n  readonly declarations: readonly IrDeclaration[];\n  readonly finish?: (lookup: DeclaredTypeLookup) => IrDeclaration;\n}\n\n/**\n * The declarations of one root. A root that is missing, or whose type has no members, is\n * `Record<string, never>`. Only an object type (or the `paths` intersection) counts as having\n * members: a callback type the IR keeps as raw text does not (ADR-004).\n */\nfunction rootDeclarations(\n  root: RootKey,\n  document: DocumentObject,\n  context: TransformContext,\n): RootDeclarations {\n  const node: unknown = document[root];\n  if (!node || typeof node !== \"object\") {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root)] };\n  }\n  const startedAt = context.diagnostics.now();\n  const { type, aliases, withDeclaredTypes } = ROOT_TRANSFORMS[root](node, context, document);\n  if (!isRootBody(type)) {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root), ...aliases] };\n  }\n  const declaration = rootDeclaration(root, type, context.options);\n  context.diagnostics.debug(`${root} done`, context.diagnostics.now() - startedAt);\n  const finish =\n    withDeclaredTypes &&\n    ((lookup: DeclaredTypeLookup) => {\n      const finished = withDeclaredTypes(lookup);\n      return isRootBody(finished) ? rootDeclaration(root, finished, context.options) : declaration;\n    });\n  return { declarations: [declaration, ...aliases], ...(finish ? { finish } : {}) };\n}\n\n/**\n * Every root's declarations in output order. A root with `finish` gets its declaration from the\n * types of the other roots and of the footer (the `operations` interface), which exist only once\n * every root is transformed.\n */\nfunction rootsDeclarations(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[],\n): IrDeclaration[] {\n  const roots = ROOT_KEYS.map((root) => rootDeclarations(root, document, context));\n  const transformed = roots.flatMap(({ declarations }) => declarations);\n  if (roots.every(({ finish }) => finish === undefined)) {\n    return transformed;\n  }\n  const lookup = declaredTypeLookup([...transformed, ...footer()]);\n  return roots.flatMap(({ declarations, finish }) => {\n    const [declaration, ...aliases] = declarations;\n    return finish === undefined || declaration === undefined\n      ? declarations\n      : [finish(lookup), ...aliases];\n  });\n}\n\n/**\n * The `inject` text as written (ADR-010, decision 4), without the blank lines around it. The\n * original reprinted it with the TypeScript printer; text without code printed nothing then.\n */\nfunction withoutBlankLinesAround(text: string): string {\n  return text.replace(/^(?:[ \\t]*\\r?\\n)+/, \"\").trimEnd();\n}\n\n/** No footer declarations: the roots' references to `operations` stay unresolved. */\nconst NO_FOOTER = (): readonly IrDeclaration[] => [];\n\n/**\n * The document's declarations before the footer: helper types, injected code, then one root type\n * per root key with the aliases that follow it. `footer` reads the footer's declarations once the\n * roots are transformed.\n */\nexport function documentBody(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[] = NO_FOOTER,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (context.options.readWriteMarkers) {\n    declarations.push({ kind: \"rawDeclaration\", text: READ_WRITE_MARKER_TYPES });\n  }\n  const inject = withoutBlankLinesAround(context.options.inject ?? \"\");\n  if (inject !== \"\") {\n    declarations.push({ kind: \"rawDeclaration\", text: inject });\n  }\n  declarations.push(...rootsDeclarations(document, context, footer));\n  return declarations;\n}\n\n/**\n * The declarations after the footer: an empty `operations` type when the footer has no\n * operations, and the `--make-paths-enum` enum.\n */\nexport function documentClosing(\n  document: DocumentObject,\n  context: TransformContext,\n  hasOperations: boolean,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (!hasOperations) {\n    declarations.push(emptyAlias(OPERATIONS_NAME));\n  }\n  if (context.options.makePathsEnum && document.paths) {\n    declarations.push(apiPathsEnumDeclaration(document.paths));\n  }\n  return declarations;\n}\n"],"names":["irRecord","irKeyword","keptDeprecatedComponents","pathMembers","irObject","pathsObjectType","webhooksType","componentsType","defsRootType","declaredTypeLookup","READ_WRITE_MARKER_TYPES","apiPathsEnumDeclaration"],"mappings":"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"}
+{"version":3,"file":"document.cjs","sources":["../../../../src/application/transform/document/document.ts"],"sourcesContent":["import { appendAll } from \"../../../domain/append-all.js\";\nimport { irKeyword, irObject, irRecord } from \"../../../domain/ir/constructors.js\";\nimport type {\n  IrDeclaration,\n  IrIntersectionType,\n  IrObjectType,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport type { ComponentsObject } from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport type { OperationEntry, PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { READ_WRITE_MARKER_TYPES } from \"../helper-types.js\";\nimport type { TransformContext, TransformOptions } from \"../transform-context.js\";\nimport { componentsType } from \"./components.js\";\nimport { type DeclaredTypeLookup, declaredTypeLookup } from \"./declared-types.js\";\nimport { defsRootType } from \"./defs-root.js\";\nimport { keptDeprecatedComponents } from \"./kept-deprecated.js\";\nimport { isIncludedOperation } from \"./path-item.js\";\nimport { pathMembers, pathsObjectType } from \"./paths.js\";\nimport { apiPathsEnumDeclaration } from \"./paths-enum.js\";\nimport { webhooksType } from \"./webhooks.js\";\n\n/** The root types, in output order. */\nexport const ROOT_KEYS = Object.freeze([\"paths\", \"webhooks\", \"components\", \"$defs\"] as const);\ntype RootKey = (typeof ROOT_KEYS)[number];\n\nexport const OPERATIONS_NAME = \"operations\";\n/** The type of a root without members: `Record<string, never>`. */\nconst EMPTY_ROOT_TYPE = irRecord(irKeyword(\"string\"), irKeyword(\"never\"));\n\n/** A root's type and the declarations that follow it (the `--root-types` aliases). */\ninterface RootResult {\n  readonly type: IrType;\n  readonly aliases: readonly IrTypeAliasDeclaration[];\n  /**\n   * The root's final type, for a root that reads the types the whole file declares (`paths`, whose\n   * overlap check follows references). `type` then only tells whether the root has members.\n   */\n  readonly withDeclaredTypes?: (lookup: DeclaredTypeLookup) => IrType;\n}\n\ntype RootTransform = (\n  node: object,\n  context: TransformContext,\n  document: DocumentObject,\n) => RootResult;\n\n/** Without `--exclude-deprecated` nothing is left out, so the scan is skipped. */\nfunction keptDeprecated(document: DocumentObject, context: TransformContext): ReadonlySet<object> {\n  return context.options.excludeDeprecated\n    ? keptDeprecatedComponents(document, context.refs)\n    : new Set();\n}\n\nconst ROOT_TRANSFORMS: Readonly<Record<RootKey, RootTransform>> = {\n  paths: (node, context) => {\n    const members = pathMembers(node as PathsObject, context);\n    return {\n      type: irObject(members.map(({ member }) => member)),\n      aliases: [],\n      withDeclaredTypes: (lookup) => pathsObjectType(members, lookup),\n    };\n  },\n  webhooks: (node, context) => ({ type: webhooksType(node as PathsObject, context), aliases: [] }),\n  components: (node, context, document) => {\n    const kept = keptDeprecated(document, context);\n    const { type, rootTypes } = componentsType(node as ComponentsObject, context, kept);\n    return { type, aliases: rootTypes };\n  },\n  $defs: (node, context) => ({\n    type: defsRootType(node as NonNullable<DocumentObject[\"$defs\"]>, context),\n    aliases: [],\n  }),\n};\n\nfunction emptyAlias(name: string): IrTypeAliasDeclaration {\n  return { kind: \"typeAlias\", name, isExported: true, type: EMPTY_ROOT_TYPE, comments: [] };\n}\n\n/** A root type that declares something: an object with members, or an intersection of them. */\ntype RootBodyType = IrObjectType | IrIntersectionType;\n\nfunction isRootBody(type: IrType): type is RootBodyType {\n  return (type.kind === \"object\" && type.members.length > 0) || type.kind === \"intersection\";\n}\n\n/**\n * A root with members: an interface, or a type alias with `--export-type`. An intersection (the\n * `paths` of overlapping `--path-params-as-types` keys) can only be a type alias.\n */\nfunction rootDeclaration(\n  name: RootKey,\n  type: RootBodyType,\n  options: TransformOptions,\n): IrDeclaration {\n  return options.exportType || type.kind === \"intersection\"\n    ? { kind: \"typeAlias\", name, isExported: true, type, comments: [] }\n    : { kind: \"interface\", name, isExported: true, members: type.members, comments: [] };\n}\n\n/**\n * The declarations of one root: its type, then its aliases. `finish` gives the root's declaration\n * again from the types the whole file declares, for a root with `withDeclaredTypes`.\n */\ninterface RootDeclarations {\n  readonly declarations: readonly IrDeclaration[];\n  readonly finish?: (lookup: DeclaredTypeLookup) => IrDeclaration;\n}\n\n/**\n * The declarations of one root. A root that is missing, or whose type has no members, is\n * `Record<string, never>`. Only an object type (or the `paths` intersection) counts as having\n * members: a callback type the IR keeps as raw text does not (ADR-004).\n */\nfunction rootDeclarations(\n  root: RootKey,\n  document: DocumentObject,\n  context: TransformContext,\n): RootDeclarations {\n  const node: unknown = document[root];\n  if (!node || typeof node !== \"object\") {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root)] };\n  }\n  const startedAt = context.diagnostics.now();\n  const { type, aliases, withDeclaredTypes } = ROOT_TRANSFORMS[root](node, context, document);\n  if (!isRootBody(type)) {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root), ...aliases] };\n  }\n  const declaration = rootDeclaration(root, type, context.options);\n  context.diagnostics.debug(`${root} done`, context.diagnostics.now() - startedAt);\n  const finish =\n    withDeclaredTypes &&\n    ((lookup: DeclaredTypeLookup) => {\n      const finished = withDeclaredTypes(lookup);\n      return isRootBody(finished) ? rootDeclaration(root, finished, context.options) : declaration;\n    });\n  return { declarations: [declaration, ...aliases], ...(finish ? { finish } : {}) };\n}\n\n/**\n * Every root's declarations in output order. A root with `finish` gets its declaration from the\n * types of the other roots and of the footer (the `operations` interface), which exist only once\n * every root is transformed.\n */\nfunction rootsDeclarations(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[],\n): IrDeclaration[] {\n  const roots = ROOT_KEYS.map((root) => rootDeclarations(root, document, context));\n  const transformed = roots.flatMap(({ declarations }) => declarations);\n  if (roots.every(({ finish }) => finish === undefined)) {\n    return transformed;\n  }\n  const lookup = declaredTypeLookup([...transformed, ...footer()]);\n  return roots.flatMap(({ declarations, finish }) => {\n    const [declaration, ...aliases] = declarations;\n    return finish === undefined || declaration === undefined\n      ? declarations\n      : [finish(lookup), ...aliases];\n  });\n}\n\n/**\n * The `inject` text as written (ADR-010, decision 4), without the blank lines around it. The\n * original reprinted it with the TypeScript printer; text without code printed nothing then.\n */\nfunction withoutBlankLinesAround(text: string): string {\n  return text.replace(/^(?:[ \\t]*\\r?\\n)+/, \"\").trimEnd();\n}\n\n/** No footer declarations: the roots' references to `operations` stay unresolved. */\nconst NO_FOOTER = (): readonly IrDeclaration[] => [];\n\n/**\n * The document's declarations before the footer: helper types, injected code, then one root type\n * per root key with the aliases that follow it. `footer` reads the footer's declarations once the\n * roots are transformed.\n */\nexport function documentBody(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[] = NO_FOOTER,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (context.options.readWriteMarkers) {\n    declarations.push({ kind: \"rawDeclaration\", text: READ_WRITE_MARKER_TYPES });\n  }\n  const inject = withoutBlankLinesAround(context.options.inject ?? \"\");\n  if (inject !== \"\") {\n    declarations.push({ kind: \"rawDeclaration\", text: inject });\n  }\n  appendAll(declarations, rootsDeclarations(document, context, footer));\n  return declarations;\n}\n\n/**\n * The declarations after the footer: an empty `operations` type when the footer has no\n * operations, and the `--make-paths-enum` enum.\n */\nexport function documentClosing(\n  document: DocumentObject,\n  context: TransformContext,\n  hasOperations: boolean,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (!hasOperations) {\n    declarations.push(emptyAlias(OPERATIONS_NAME));\n  }\n  if (context.options.makePathsEnum && document.paths) {\n    const isIncluded = (operation: OperationEntry) => isIncludedOperation(operation, context);\n    declarations.push(apiPathsEnumDeclaration(document.paths, isIncluded));\n  }\n  return declarations;\n}\n"],"names":["irRecord","irKeyword","keptDeprecatedComponents","pathMembers","irObject","pathsObjectType","webhooksType","componentsType","defsRootType","declaredTypeLookup","READ_WRITE_MARKER_TYPES","appendAll","isIncludedOperation","apiPathsEnumDeclaration"],"mappings":";;;;;;;;;;;;;;AAwBO,MAAM,SAAA,GAAY,OAAO,MAAA,CAAO,CAAC,SAAS,UAAA,EAAY,YAAA,EAAc,OAAO,CAAU;AAGrF,MAAM,eAAA,GAAkB;AAE/B,MAAM,kBAAkBA,qBAAA,CAASC,sBAAA,CAAU,QAAQ,CAAA,EAAGA,sBAAA,CAAU,OAAO,CAAC,CAAA;AAoBxE,SAAS,cAAA,CAAe,UAA0B,OAAA,EAAgD;AAChG,EAAA,OAAO,OAAA,CAAQ,QAAQ,iBAAA,GACnBC,yCAAA,CAAyB,UAAU,OAAA,CAAQ,IAAI,CAAA,mBAC/C,IAAI,GAAA,EAAI;AACd;AAEA,MAAM,eAAA,GAA4D;AAAA,EAChE,KAAA,EAAO,CAAC,IAAA,EAAM,OAAA,KAAY;AACxB,IAAA,MAAM,OAAA,GAAUC,iBAAA,CAAY,IAAA,EAAqB,OAAO,CAAA;AACxD,IAAA,OAAO;AAAA,MACL,IAAA,EAAMC,sBAAS,OAAA,CAAQ,GAAA,CAAI,CAAC,EAAE,MAAA,EAAO,KAAM,MAAM,CAAC,CAAA;AAAA,MAClD,SAAS,EAAC;AAAA,MACV,iBAAA,EAAmB,CAAC,MAAA,KAAWC,qBAAA,CAAgB,SAAS,MAAM;AAAA,KAChE;AAAA,EACF,CAAA;AAAA,EACA,QAAA,EAAU,CAAC,IAAA,EAAM,OAAA,MAAa,EAAE,IAAA,EAAMC,qBAAA,CAAa,IAAA,EAAqB,OAAO,CAAA,EAAG,OAAA,EAAS,EAAC,EAAE,CAAA;AAAA,EAC9F,UAAA,EAAY,CAAC,IAAA,EAAM,OAAA,EAAS,QAAA,KAAa;AACvC,IAAA,MAAM,IAAA,GAAO,cAAA,CAAe,QAAA,EAAU,OAAO,CAAA;AAC7C,IAAA,MAAM,EAAE,IAAA,EAAM,SAAA,KAAcC,yBAAA,CAAe,IAAA,EAA0B,SAAS,IAAI,CAAA;AAClF,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,SAAA,EAAU;AAAA,EACpC,CAAA;AAAA,EACA,KAAA,EAAO,CAAC,IAAA,EAAM,OAAA,MAAa;AAAA,IACzB,IAAA,EAAMC,qBAAA,CAAa,IAAA,EAA8C,OAAO,CAAA;AAAA,IACxE,SAAS;AAAC,GACZ;AACF,CAAA;AAEA,SAAS,WAAW,IAAA,EAAsC;AACxD,EAAA,OAAO,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,UAAA,EAAY,MAAM,IAAA,EAAM,eAAA,EAAiB,QAAA,EAAU,EAAC,EAAE;AAC1F;AAKA,SAAS,WAAW,IAAA,EAAoC;AACtD,EAAA,OAAQ,IAAA,CAAK,SAAS,QAAA,IAAY,IAAA,CAAK,QAAQ,MAAA,GAAS,CAAA,IAAM,KAAK,IAAA,KAAS,cAAA;AAC9E;AAMA,SAAS,eAAA,CACP,IAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAO,OAAA,CAAQ,UAAA,IAAc,IAAA,CAAK,IAAA,KAAS,cAAA,GACvC,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,EAAC,EAAE,GAChE,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,OAAA,EAAS,IAAA,CAAK,OAAA,EAAS,QAAA,EAAU,EAAC,EAAE;AACvF;AAgBA,SAAS,gBAAA,CACP,IAAA,EACA,QAAA,EACA,OAAA,EACkB;AAClB,EAAA,MAAM,IAAA,GAAgB,SAAS,IAAI,CAAA;AACnC,EAAA,IAAI,CAAC,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,EAAU;AACrC,IAAA,OAAA,CAAQ,WAAA,CAAY,KAAA,CAAM,CAAA,EAAG,IAAI,mBAAmB,CAAC,CAAA;AACrD,IAAA,OAAO,EAAE,YAAA,EAAc,CAAC,UAAA,CAAW,IAAI,CAAC,CAAA,EAAE;AAAA,EAC5C;AACA,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,WAAA,CAAY,GAAA,EAAI;AAC1C,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,iBAAA,EAAkB,GAAI,gBAAgB,IAAI,CAAA,CAAE,IAAA,EAAM,OAAA,EAAS,QAAQ,CAAA;AAC1F,EAAA,IAAI,CAAC,UAAA,CAAW,IAAI,CAAA,EAAG;AACrB,IAAA,OAAA,CAAQ,WAAA,CAAY,KAAA,CAAM,CAAA,EAAG,IAAI,mBAAmB,CAAC,CAAA;AACrD,IAAA,OAAO,EAAE,cAAc,CAAC,UAAA,CAAW,IAAI,CAAA,EAAG,GAAG,OAAO,CAAA,EAAE;AAAA,EACxD;AACA,EAAA,MAAM,WAAA,GAAc,eAAA,CAAgB,IAAA,EAAM,IAAA,EAAM,QAAQ,OAAO,CAAA;AAC/D,EAAA,OAAA,CAAQ,WAAA,CAAY,MAAM,CAAA,EAAG,IAAI,SAAS,OAAA,CAAQ,WAAA,CAAY,GAAA,EAAI,GAAI,SAAS,CAAA;AAC/E,EAAA,MAAM,MAAA,GACJ,iBAAA,KACC,CAAC,MAAA,KAA+B;AAC/B,IAAA,MAAM,QAAA,GAAW,kBAAkB,MAAM,CAAA;AACzC,IAAA,OAAO,UAAA,CAAW,QAAQ,CAAA,GAAI,eAAA,CAAgB,MAAM,QAAA,EAAU,OAAA,CAAQ,OAAO,CAAA,GAAI,WAAA;AAAA,EACnF,CAAA,CAAA;AACF,EAAA,OAAO,EAAE,YAAA,EAAc,CAAC,WAAA,EAAa,GAAG,OAAO,CAAA,EAAG,GAAI,MAAA,GAAS,EAAE,MAAA,EAAO,GAAI,EAAC,EAAG;AAClF;AAOA,SAAS,iBAAA,CACP,QAAA,EACA,OAAA,EACA,MAAA,EACiB;AACjB,EAAA,MAAM,KAAA,GAAQ,UAAU,GAAA,CAAI,CAAC,SAAS,gBAAA,CAAiB,IAAA,EAAM,QAAA,EAAU,OAAO,CAAC,CAAA;AAC/E,EAAA,MAAM,cAAc,KAAA,CAAM,OAAA,CAAQ,CAAC,EAAE,YAAA,OAAmB,YAAY,CAAA;AACpE,EAAA,IAAI,KAAA,CAAM,MAAM,CAAC,EAAE,QAAO,KAAM,MAAA,KAAW,MAAS,CAAA,EAAG;AACrD,IAAA,OAAO,WAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAASC,iCAAmB,CAAC,GAAG,aAAa,GAAG,MAAA,EAAQ,CAAC,CAAA;AAC/D,EAAA,OAAO,MAAM,OAAA,CAAQ,CAAC,EAAE,YAAA,EAAc,QAAO,KAAM;AACjD,IAAA,MAAM,CAAC,WAAA,EAAa,GAAG,OAAO,CAAA,GAAI,YAAA;AAClC,IAAA,OAAO,MAAA,KAAW,MAAA,IAAa,WAAA,KAAgB,MAAA,GAC3C,YAAA,GACA,CAAC,MAAA,CAAO,MAAM,CAAA,EAAG,GAAG,OAAO,CAAA;AAAA,EACjC,CAAC,CAAA;AACH;AAMA,SAAS,wBAAwB,IAAA,EAAsB;AACrD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,mBAAA,EAAqB,EAAE,EAAE,OAAA,EAAQ;AACvD;AAGA,MAAM,SAAA,GAAY,MAAgC,EAAC;AAO5C,SAAS,YAAA,CACd,QAAA,EACA,OAAA,EACA,MAAA,GAAyC,SAAA,EACxB;AACjB,EAAA,MAAM,eAAgC,EAAC;AACvC,EAAA,IAAI,OAAA,CAAQ,QAAQ,gBAAA,EAAkB;AACpC,IAAA,YAAA,CAAa,KAAK,EAAE,IAAA,EAAM,gBAAA,EAAkB,IAAA,EAAMC,qCAAyB,CAAA;AAAA,EAC7E;AACA,EAAA,MAAM,MAAA,GAAS,uBAAA,CAAwB,OAAA,CAAQ,OAAA,CAAQ,UAAU,EAAE,CAAA;AACnE,EAAA,IAAI,WAAW,EAAA,EAAI;AACjB,IAAA,YAAA,CAAa,KAAK,EAAE,IAAA,EAAM,gBAAA,EAAkB,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC5D;AACA,EAAAC,mBAAA,CAAU,YAAA,EAAc,iBAAA,CAAkB,QAAA,EAAU,OAAA,EAAS,MAAM,CAAC,CAAA;AACpE,EAAA,OAAO,YAAA;AACT;AAMO,SAAS,eAAA,CACd,QAAA,EACA,OAAA,EACA,aAAA,EACiB;AACjB,EAAA,MAAM,eAAgC,EAAC;AACvC,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,YAAA,CAAa,IAAA,CAAK,UAAA,CAAW,eAAe,CAAC,CAAA;AAAA,EAC/C;AACA,EAAA,IAAI,OAAA,CAAQ,OAAA,CAAQ,aAAA,IAAiB,QAAA,CAAS,KAAA,EAAO;AACnD,IAAA,MAAM,UAAA,GAAa,CAAC,SAAA,KAA8BC,4BAAA,CAAoB,WAAW,OAAO,CAAA;AACxF,IAAA,YAAA,CAAa,IAAA,CAAKC,iCAAA,CAAwB,QAAA,CAAS,KAAA,EAAO,UAAU,CAAC,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,YAAA;AACT;;;;;"}

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

@@ -1,9 +1,11 @@
+import { appendAll } from '../../../domain/append-all.mjs';
 import { irRecord, irObject, irKeyword } from '../../../domain/ir/constructors.mjs';
 import { READ_WRITE_MARKER_TYPES } from '../helper-types.mjs';
 import { componentsType } from './components.mjs';
 import { declaredTypeLookup } from './declared-types.mjs';
 import { defsRootType } from './defs-root.mjs';
 import { keptDeprecatedComponents } from './kept-deprecated.mjs';
+import { isIncludedOperation } from './path-item.mjs';
 import { pathMembers, pathsObjectType } from './paths.mjs';
 import { apiPathsEnumDeclaration } from './paths-enum.mjs';
 import { webhooksType } from './webhooks.mjs';
@@ -88,7 +90,7 @@ function documentBody(document, context, footer = NO_FOOTER) {
   if (inject !== "") {
     declarations.push({ kind: "rawDeclaration", text: inject });
   }
-  declarations.push(...rootsDeclarations(document, context, footer));
+  appendAll(declarations, rootsDeclarations(document, context, footer));
   return declarations;
 }
 function documentClosing(document, context, hasOperations) {
@@ -97,10 +99,11 @@ function documentClosing(document, context, hasOperations) {
     declarations.push(emptyAlias(OPERATIONS_NAME));
   }
   if (context.options.makePathsEnum && document.paths) {
-    declarations.push(apiPathsEnumDeclaration(document.paths));
+    const isIncluded = (operation) => isIncludedOperation(operation, context);
+    declarations.push(apiPathsEnumDeclaration(document.paths, isIncluded));
   }
   return declarations;
 }
 
-export { documentBody, documentClosing };
+export { OPERATIONS_NAME, ROOT_KEYS, documentBody, documentClosing };
 //# sourceMappingURL=document.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"document.mjs","sources":["../../../../src/application/transform/document/document.ts"],"sourcesContent":["import { irKeyword, irObject, irRecord } from \"../../../domain/ir/constructors.js\";\nimport type {\n  IrDeclaration,\n  IrIntersectionType,\n  IrObjectType,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport type { ComponentsObject } from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport type { PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { READ_WRITE_MARKER_TYPES } from \"../helper-types.js\";\nimport type { TransformContext, TransformOptions } from \"../transform-context.js\";\nimport { componentsType } from \"./components.js\";\nimport { type DeclaredTypeLookup, declaredTypeLookup } from \"./declared-types.js\";\nimport { defsRootType } from \"./defs-root.js\";\nimport { keptDeprecatedComponents } from \"./kept-deprecated.js\";\nimport { pathMembers, pathsObjectType } from \"./paths.js\";\nimport { apiPathsEnumDeclaration } from \"./paths-enum.js\";\nimport { webhooksType } from \"./webhooks.js\";\n\n/** The root types, in output order. */\nconst ROOT_KEYS = Object.freeze([\"paths\", \"webhooks\", \"components\", \"$defs\"] as const);\ntype RootKey = (typeof ROOT_KEYS)[number];\n\nconst OPERATIONS_NAME = \"operations\";\n/** The type of a root without members: `Record<string, never>`. */\nconst EMPTY_ROOT_TYPE = irRecord(irKeyword(\"string\"), irKeyword(\"never\"));\n\n/** A root's type and the declarations that follow it (the `--root-types` aliases). */\ninterface RootResult {\n  readonly type: IrType;\n  readonly aliases: readonly IrTypeAliasDeclaration[];\n  /**\n   * The root's final type, for a root that reads the types the whole file declares (`paths`, whose\n   * overlap check follows references). `type` then only tells whether the root has members.\n   */\n  readonly withDeclaredTypes?: (lookup: DeclaredTypeLookup) => IrType;\n}\n\ntype RootTransform = (\n  node: object,\n  context: TransformContext,\n  document: DocumentObject,\n) => RootResult;\n\n/** Without `--exclude-deprecated` nothing is left out, so the scan is skipped. */\nfunction keptDeprecated(document: DocumentObject, context: TransformContext): ReadonlySet<object> {\n  return context.options.excludeDeprecated\n    ? keptDeprecatedComponents(document, context.refs)\n    : new Set();\n}\n\nconst ROOT_TRANSFORMS: Readonly<Record<RootKey, RootTransform>> = {\n  paths: (node, context) => {\n    const members = pathMembers(node as PathsObject, context);\n    return {\n      type: irObject(members.map(({ member }) => member)),\n      aliases: [],\n      withDeclaredTypes: (lookup) => pathsObjectType(members, lookup),\n    };\n  },\n  webhooks: (node, context) => ({ type: webhooksType(node as PathsObject, context), aliases: [] }),\n  components: (node, context, document) => {\n    const kept = keptDeprecated(document, context);\n    const { type, rootTypes } = componentsType(node as ComponentsObject, context, kept);\n    return { type, aliases: rootTypes };\n  },\n  $defs: (node, context) => ({\n    type: defsRootType(node as NonNullable<DocumentObject[\"$defs\"]>, context),\n    aliases: [],\n  }),\n};\n\nfunction emptyAlias(name: string): IrTypeAliasDeclaration {\n  return { kind: \"typeAlias\", name, isExported: true, type: EMPTY_ROOT_TYPE, comments: [] };\n}\n\n/** A root type that declares something: an object with members, or an intersection of them. */\ntype RootBodyType = IrObjectType | IrIntersectionType;\n\nfunction isRootBody(type: IrType): type is RootBodyType {\n  return (type.kind === \"object\" && type.members.length > 0) || type.kind === \"intersection\";\n}\n\n/**\n * A root with members: an interface, or a type alias with `--export-type`. An intersection (the\n * `paths` of overlapping `--path-params-as-types` keys) can only be a type alias.\n */\nfunction rootDeclaration(\n  name: RootKey,\n  type: RootBodyType,\n  options: TransformOptions,\n): IrDeclaration {\n  return options.exportType || type.kind === \"intersection\"\n    ? { kind: \"typeAlias\", name, isExported: true, type, comments: [] }\n    : { kind: \"interface\", name, isExported: true, members: type.members, comments: [] };\n}\n\n/**\n * The declarations of one root: its type, then its aliases. `finish` gives the root's declaration\n * again from the types the whole file declares, for a root with `withDeclaredTypes`.\n */\ninterface RootDeclarations {\n  readonly declarations: readonly IrDeclaration[];\n  readonly finish?: (lookup: DeclaredTypeLookup) => IrDeclaration;\n}\n\n/**\n * The declarations of one root. A root that is missing, or whose type has no members, is\n * `Record<string, never>`. Only an object type (or the `paths` intersection) counts as having\n * members: a callback type the IR keeps as raw text does not (ADR-004).\n */\nfunction rootDeclarations(\n  root: RootKey,\n  document: DocumentObject,\n  context: TransformContext,\n): RootDeclarations {\n  const node: unknown = document[root];\n  if (!node || typeof node !== \"object\") {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root)] };\n  }\n  const startedAt = context.diagnostics.now();\n  const { type, aliases, withDeclaredTypes } = ROOT_TRANSFORMS[root](node, context, document);\n  if (!isRootBody(type)) {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root), ...aliases] };\n  }\n  const declaration = rootDeclaration(root, type, context.options);\n  context.diagnostics.debug(`${root} done`, context.diagnostics.now() - startedAt);\n  const finish =\n    withDeclaredTypes &&\n    ((lookup: DeclaredTypeLookup) => {\n      const finished = withDeclaredTypes(lookup);\n      return isRootBody(finished) ? rootDeclaration(root, finished, context.options) : declaration;\n    });\n  return { declarations: [declaration, ...aliases], ...(finish ? { finish } : {}) };\n}\n\n/**\n * Every root's declarations in output order. A root with `finish` gets its declaration from the\n * types of the other roots and of the footer (the `operations` interface), which exist only once\n * every root is transformed.\n */\nfunction rootsDeclarations(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[],\n): IrDeclaration[] {\n  const roots = ROOT_KEYS.map((root) => rootDeclarations(root, document, context));\n  const transformed = roots.flatMap(({ declarations }) => declarations);\n  if (roots.every(({ finish }) => finish === undefined)) {\n    return transformed;\n  }\n  const lookup = declaredTypeLookup([...transformed, ...footer()]);\n  return roots.flatMap(({ declarations, finish }) => {\n    const [declaration, ...aliases] = declarations;\n    return finish === undefined || declaration === undefined\n      ? declarations\n      : [finish(lookup), ...aliases];\n  });\n}\n\n/**\n * The `inject` text as written (ADR-010, decision 4), without the blank lines around it. The\n * original reprinted it with the TypeScript printer; text without code printed nothing then.\n */\nfunction withoutBlankLinesAround(text: string): string {\n  return text.replace(/^(?:[ \\t]*\\r?\\n)+/, \"\").trimEnd();\n}\n\n/** No footer declarations: the roots' references to `operations` stay unresolved. */\nconst NO_FOOTER = (): readonly IrDeclaration[] => [];\n\n/**\n * The document's declarations before the footer: helper types, injected code, then one root type\n * per root key with the aliases that follow it. `footer` reads the footer's declarations once the\n * roots are transformed.\n */\nexport function documentBody(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[] = NO_FOOTER,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (context.options.readWriteMarkers) {\n    declarations.push({ kind: \"rawDeclaration\", text: READ_WRITE_MARKER_TYPES });\n  }\n  const inject = withoutBlankLinesAround(context.options.inject ?? \"\");\n  if (inject !== \"\") {\n    declarations.push({ kind: \"rawDeclaration\", text: inject });\n  }\n  declarations.push(...rootsDeclarations(document, context, footer));\n  return declarations;\n}\n\n/**\n * The declarations after the footer: an empty `operations` type when the footer has no\n * operations, and the `--make-paths-enum` enum.\n */\nexport function documentClosing(\n  document: DocumentObject,\n  context: TransformContext,\n  hasOperations: boolean,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (!hasOperations) {\n    declarations.push(emptyAlias(OPERATIONS_NAME));\n  }\n  if (context.options.makePathsEnum && document.paths) {\n    declarations.push(apiPathsEnumDeclaration(document.paths));\n  }\n  return declarations;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"document.mjs","sources":["../../../../src/application/transform/document/document.ts"],"sourcesContent":["import { appendAll } from \"../../../domain/append-all.js\";\nimport { irKeyword, irObject, irRecord } from \"../../../domain/ir/constructors.js\";\nimport type {\n  IrDeclaration,\n  IrIntersectionType,\n  IrObjectType,\n  IrType,\n  IrTypeAliasDeclaration,\n} from \"../../../domain/ir/nodes.js\";\nimport type { ComponentsObject } from \"../../../domain/openapi/components-object.js\";\nimport type { DocumentObject } from \"../../../domain/openapi/document-object.js\";\nimport type { OperationEntry, PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { READ_WRITE_MARKER_TYPES } from \"../helper-types.js\";\nimport type { TransformContext, TransformOptions } from \"../transform-context.js\";\nimport { componentsType } from \"./components.js\";\nimport { type DeclaredTypeLookup, declaredTypeLookup } from \"./declared-types.js\";\nimport { defsRootType } from \"./defs-root.js\";\nimport { keptDeprecatedComponents } from \"./kept-deprecated.js\";\nimport { isIncludedOperation } from \"./path-item.js\";\nimport { pathMembers, pathsObjectType } from \"./paths.js\";\nimport { apiPathsEnumDeclaration } from \"./paths-enum.js\";\nimport { webhooksType } from \"./webhooks.js\";\n\n/** The root types, in output order. */\nexport const ROOT_KEYS = Object.freeze([\"paths\", \"webhooks\", \"components\", \"$defs\"] as const);\ntype RootKey = (typeof ROOT_KEYS)[number];\n\nexport const OPERATIONS_NAME = \"operations\";\n/** The type of a root without members: `Record<string, never>`. */\nconst EMPTY_ROOT_TYPE = irRecord(irKeyword(\"string\"), irKeyword(\"never\"));\n\n/** A root's type and the declarations that follow it (the `--root-types` aliases). */\ninterface RootResult {\n  readonly type: IrType;\n  readonly aliases: readonly IrTypeAliasDeclaration[];\n  /**\n   * The root's final type, for a root that reads the types the whole file declares (`paths`, whose\n   * overlap check follows references). `type` then only tells whether the root has members.\n   */\n  readonly withDeclaredTypes?: (lookup: DeclaredTypeLookup) => IrType;\n}\n\ntype RootTransform = (\n  node: object,\n  context: TransformContext,\n  document: DocumentObject,\n) => RootResult;\n\n/** Without `--exclude-deprecated` nothing is left out, so the scan is skipped. */\nfunction keptDeprecated(document: DocumentObject, context: TransformContext): ReadonlySet<object> {\n  return context.options.excludeDeprecated\n    ? keptDeprecatedComponents(document, context.refs)\n    : new Set();\n}\n\nconst ROOT_TRANSFORMS: Readonly<Record<RootKey, RootTransform>> = {\n  paths: (node, context) => {\n    const members = pathMembers(node as PathsObject, context);\n    return {\n      type: irObject(members.map(({ member }) => member)),\n      aliases: [],\n      withDeclaredTypes: (lookup) => pathsObjectType(members, lookup),\n    };\n  },\n  webhooks: (node, context) => ({ type: webhooksType(node as PathsObject, context), aliases: [] }),\n  components: (node, context, document) => {\n    const kept = keptDeprecated(document, context);\n    const { type, rootTypes } = componentsType(node as ComponentsObject, context, kept);\n    return { type, aliases: rootTypes };\n  },\n  $defs: (node, context) => ({\n    type: defsRootType(node as NonNullable<DocumentObject[\"$defs\"]>, context),\n    aliases: [],\n  }),\n};\n\nfunction emptyAlias(name: string): IrTypeAliasDeclaration {\n  return { kind: \"typeAlias\", name, isExported: true, type: EMPTY_ROOT_TYPE, comments: [] };\n}\n\n/** A root type that declares something: an object with members, or an intersection of them. */\ntype RootBodyType = IrObjectType | IrIntersectionType;\n\nfunction isRootBody(type: IrType): type is RootBodyType {\n  return (type.kind === \"object\" && type.members.length > 0) || type.kind === \"intersection\";\n}\n\n/**\n * A root with members: an interface, or a type alias with `--export-type`. An intersection (the\n * `paths` of overlapping `--path-params-as-types` keys) can only be a type alias.\n */\nfunction rootDeclaration(\n  name: RootKey,\n  type: RootBodyType,\n  options: TransformOptions,\n): IrDeclaration {\n  return options.exportType || type.kind === \"intersection\"\n    ? { kind: \"typeAlias\", name, isExported: true, type, comments: [] }\n    : { kind: \"interface\", name, isExported: true, members: type.members, comments: [] };\n}\n\n/**\n * The declarations of one root: its type, then its aliases. `finish` gives the root's declaration\n * again from the types the whole file declares, for a root with `withDeclaredTypes`.\n */\ninterface RootDeclarations {\n  readonly declarations: readonly IrDeclaration[];\n  readonly finish?: (lookup: DeclaredTypeLookup) => IrDeclaration;\n}\n\n/**\n * The declarations of one root. A root that is missing, or whose type has no members, is\n * `Record<string, never>`. Only an object type (or the `paths` intersection) counts as having\n * members: a callback type the IR keeps as raw text does not (ADR-004).\n */\nfunction rootDeclarations(\n  root: RootKey,\n  document: DocumentObject,\n  context: TransformContext,\n): RootDeclarations {\n  const node: unknown = document[root];\n  if (!node || typeof node !== \"object\") {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root)] };\n  }\n  const startedAt = context.diagnostics.now();\n  const { type, aliases, withDeclaredTypes } = ROOT_TRANSFORMS[root](node, context, document);\n  if (!isRootBody(type)) {\n    context.diagnostics.debug(`${root} done (skipped)`, 0);\n    return { declarations: [emptyAlias(root), ...aliases] };\n  }\n  const declaration = rootDeclaration(root, type, context.options);\n  context.diagnostics.debug(`${root} done`, context.diagnostics.now() - startedAt);\n  const finish =\n    withDeclaredTypes &&\n    ((lookup: DeclaredTypeLookup) => {\n      const finished = withDeclaredTypes(lookup);\n      return isRootBody(finished) ? rootDeclaration(root, finished, context.options) : declaration;\n    });\n  return { declarations: [declaration, ...aliases], ...(finish ? { finish } : {}) };\n}\n\n/**\n * Every root's declarations in output order. A root with `finish` gets its declaration from the\n * types of the other roots and of the footer (the `operations` interface), which exist only once\n * every root is transformed.\n */\nfunction rootsDeclarations(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[],\n): IrDeclaration[] {\n  const roots = ROOT_KEYS.map((root) => rootDeclarations(root, document, context));\n  const transformed = roots.flatMap(({ declarations }) => declarations);\n  if (roots.every(({ finish }) => finish === undefined)) {\n    return transformed;\n  }\n  const lookup = declaredTypeLookup([...transformed, ...footer()]);\n  return roots.flatMap(({ declarations, finish }) => {\n    const [declaration, ...aliases] = declarations;\n    return finish === undefined || declaration === undefined\n      ? declarations\n      : [finish(lookup), ...aliases];\n  });\n}\n\n/**\n * The `inject` text as written (ADR-010, decision 4), without the blank lines around it. The\n * original reprinted it with the TypeScript printer; text without code printed nothing then.\n */\nfunction withoutBlankLinesAround(text: string): string {\n  return text.replace(/^(?:[ \\t]*\\r?\\n)+/, \"\").trimEnd();\n}\n\n/** No footer declarations: the roots' references to `operations` stay unresolved. */\nconst NO_FOOTER = (): readonly IrDeclaration[] => [];\n\n/**\n * The document's declarations before the footer: helper types, injected code, then one root type\n * per root key with the aliases that follow it. `footer` reads the footer's declarations once the\n * roots are transformed.\n */\nexport function documentBody(\n  document: DocumentObject,\n  context: TransformContext,\n  footer: () => readonly IrDeclaration[] = NO_FOOTER,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (context.options.readWriteMarkers) {\n    declarations.push({ kind: \"rawDeclaration\", text: READ_WRITE_MARKER_TYPES });\n  }\n  const inject = withoutBlankLinesAround(context.options.inject ?? \"\");\n  if (inject !== \"\") {\n    declarations.push({ kind: \"rawDeclaration\", text: inject });\n  }\n  appendAll(declarations, rootsDeclarations(document, context, footer));\n  return declarations;\n}\n\n/**\n * The declarations after the footer: an empty `operations` type when the footer has no\n * operations, and the `--make-paths-enum` enum.\n */\nexport function documentClosing(\n  document: DocumentObject,\n  context: TransformContext,\n  hasOperations: boolean,\n): IrDeclaration[] {\n  const declarations: IrDeclaration[] = [];\n  if (!hasOperations) {\n    declarations.push(emptyAlias(OPERATIONS_NAME));\n  }\n  if (context.options.makePathsEnum && document.paths) {\n    const isIncluded = (operation: OperationEntry) => isIncludedOperation(operation, context);\n    declarations.push(apiPathsEnumDeclaration(document.paths, isIncluded));\n  }\n  return declarations;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAwBO,MAAM,SAAA,GAAY,OAAO,MAAA,CAAO,CAAC,SAAS,UAAA,EAAY,YAAA,EAAc,OAAO,CAAU;AAGrF,MAAM,eAAA,GAAkB;AAE/B,MAAM,kBAAkB,QAAA,CAAS,SAAA,CAAU,QAAQ,CAAA,EAAG,SAAA,CAAU,OAAO,CAAC,CAAA;AAoBxE,SAAS,cAAA,CAAe,UAA0B,OAAA,EAAgD;AAChG,EAAA,OAAO,OAAA,CAAQ,QAAQ,iBAAA,GACnB,wBAAA,CAAyB,UAAU,OAAA,CAAQ,IAAI,CAAA,mBAC/C,IAAI,GAAA,EAAI;AACd;AAEA,MAAM,eAAA,GAA4D;AAAA,EAChE,KAAA,EAAO,CAAC,IAAA,EAAM,OAAA,KAAY;AACxB,IAAA,MAAM,OAAA,GAAU,WAAA,CAAY,IAAA,EAAqB,OAAO,CAAA;AACxD,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,SAAS,OAAA,CAAQ,GAAA,CAAI,CAAC,EAAE,MAAA,EAAO,KAAM,MAAM,CAAC,CAAA;AAAA,MAClD,SAAS,EAAC;AAAA,MACV,iBAAA,EAAmB,CAAC,MAAA,KAAW,eAAA,CAAgB,SAAS,MAAM;AAAA,KAChE;AAAA,EACF,CAAA;AAAA,EACA,QAAA,EAAU,CAAC,IAAA,EAAM,OAAA,MAAa,EAAE,IAAA,EAAM,YAAA,CAAa,IAAA,EAAqB,OAAO,CAAA,EAAG,OAAA,EAAS,EAAC,EAAE,CAAA;AAAA,EAC9F,UAAA,EAAY,CAAC,IAAA,EAAM,OAAA,EAAS,QAAA,KAAa;AACvC,IAAA,MAAM,IAAA,GAAO,cAAA,CAAe,QAAA,EAAU,OAAO,CAAA;AAC7C,IAAA,MAAM,EAAE,IAAA,EAAM,SAAA,KAAc,cAAA,CAAe,IAAA,EAA0B,SAAS,IAAI,CAAA;AAClF,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,SAAA,EAAU;AAAA,EACpC,CAAA;AAAA,EACA,KAAA,EAAO,CAAC,IAAA,EAAM,OAAA,MAAa;AAAA,IACzB,IAAA,EAAM,YAAA,CAAa,IAAA,EAA8C,OAAO,CAAA;AAAA,IACxE,SAAS;AAAC,GACZ;AACF,CAAA;AAEA,SAAS,WAAW,IAAA,EAAsC;AACxD,EAAA,OAAO,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,UAAA,EAAY,MAAM,IAAA,EAAM,eAAA,EAAiB,QAAA,EAAU,EAAC,EAAE;AAC1F;AAKA,SAAS,WAAW,IAAA,EAAoC;AACtD,EAAA,OAAQ,IAAA,CAAK,SAAS,QAAA,IAAY,IAAA,CAAK,QAAQ,MAAA,GAAS,CAAA,IAAM,KAAK,IAAA,KAAS,cAAA;AAC9E;AAMA,SAAS,eAAA,CACP,IAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAO,OAAA,CAAQ,UAAA,IAAc,IAAA,CAAK,IAAA,KAAS,cAAA,GACvC,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,EAAC,EAAE,GAChE,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,OAAA,EAAS,IAAA,CAAK,OAAA,EAAS,QAAA,EAAU,EAAC,EAAE;AACvF;AAgBA,SAAS,gBAAA,CACP,IAAA,EACA,QAAA,EACA,OAAA,EACkB;AAClB,EAAA,MAAM,IAAA,GAAgB,SAAS,IAAI,CAAA;AACnC,EAAA,IAAI,CAAC,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,EAAU;AACrC,IAAA,OAAA,CAAQ,WAAA,CAAY,KAAA,CAAM,CAAA,EAAG,IAAI,mBAAmB,CAAC,CAAA;AACrD,IAAA,OAAO,EAAE,YAAA,EAAc,CAAC,UAAA,CAAW,IAAI,CAAC,CAAA,EAAE;AAAA,EAC5C;AACA,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,WAAA,CAAY,GAAA,EAAI;AAC1C,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,iBAAA,EAAkB,GAAI,gBAAgB,IAAI,CAAA,CAAE,IAAA,EAAM,OAAA,EAAS,QAAQ,CAAA;AAC1F,EAAA,IAAI,CAAC,UAAA,CAAW,IAAI,CAAA,EAAG;AACrB,IAAA,OAAA,CAAQ,WAAA,CAAY,KAAA,CAAM,CAAA,EAAG,IAAI,mBAAmB,CAAC,CAAA;AACrD,IAAA,OAAO,EAAE,cAAc,CAAC,UAAA,CAAW,IAAI,CAAA,EAAG,GAAG,OAAO,CAAA,EAAE;AAAA,EACxD;AACA,EAAA,MAAM,WAAA,GAAc,eAAA,CAAgB,IAAA,EAAM,IAAA,EAAM,QAAQ,OAAO,CAAA;AAC/D,EAAA,OAAA,CAAQ,WAAA,CAAY,MAAM,CAAA,EAAG,IAAI,SAAS,OAAA,CAAQ,WAAA,CAAY,GAAA,EAAI,GAAI,SAAS,CAAA;AAC/E,EAAA,MAAM,MAAA,GACJ,iBAAA,KACC,CAAC,MAAA,KAA+B;AAC/B,IAAA,MAAM,QAAA,GAAW,kBAAkB,MAAM,CAAA;AACzC,IAAA,OAAO,UAAA,CAAW,QAAQ,CAAA,GAAI,eAAA,CAAgB,MAAM,QAAA,EAAU,OAAA,CAAQ,OAAO,CAAA,GAAI,WAAA;AAAA,EACnF,CAAA,CAAA;AACF,EAAA,OAAO,EAAE,YAAA,EAAc,CAAC,WAAA,EAAa,GAAG,OAAO,CAAA,EAAG,GAAI,MAAA,GAAS,EAAE,MAAA,EAAO,GAAI,EAAC,EAAG;AAClF;AAOA,SAAS,iBAAA,CACP,QAAA,EACA,OAAA,EACA,MAAA,EACiB;AACjB,EAAA,MAAM,KAAA,GAAQ,UAAU,GAAA,CAAI,CAAC,SAAS,gBAAA,CAAiB,IAAA,EAAM,QAAA,EAAU,OAAO,CAAC,CAAA;AAC/E,EAAA,MAAM,cAAc,KAAA,CAAM,OAAA,CAAQ,CAAC,EAAE,YAAA,OAAmB,YAAY,CAAA;AACpE,EAAA,IAAI,KAAA,CAAM,MAAM,CAAC,EAAE,QAAO,KAAM,MAAA,KAAW,MAAS,CAAA,EAAG;AACrD,IAAA,OAAO,WAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,mBAAmB,CAAC,GAAG,aAAa,GAAG,MAAA,EAAQ,CAAC,CAAA;AAC/D,EAAA,OAAO,MAAM,OAAA,CAAQ,CAAC,EAAE,YAAA,EAAc,QAAO,KAAM;AACjD,IAAA,MAAM,CAAC,WAAA,EAAa,GAAG,OAAO,CAAA,GAAI,YAAA;AAClC,IAAA,OAAO,MAAA,KAAW,MAAA,IAAa,WAAA,KAAgB,MAAA,GAC3C,YAAA,GACA,CAAC,MAAA,CAAO,MAAM,CAAA,EAAG,GAAG,OAAO,CAAA;AAAA,EACjC,CAAC,CAAA;AACH;AAMA,SAAS,wBAAwB,IAAA,EAAsB;AACrD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,mBAAA,EAAqB,EAAE,EAAE,OAAA,EAAQ;AACvD;AAGA,MAAM,SAAA,GAAY,MAAgC,EAAC;AAO5C,SAAS,YAAA,CACd,QAAA,EACA,OAAA,EACA,MAAA,GAAyC,SAAA,EACxB;AACjB,EAAA,MAAM,eAAgC,EAAC;AACvC,EAAA,IAAI,OAAA,CAAQ,QAAQ,gBAAA,EAAkB;AACpC,IAAA,YAAA,CAAa,KAAK,EAAE,IAAA,EAAM,gBAAA,EAAkB,IAAA,EAAM,yBAAyB,CAAA;AAAA,EAC7E;AACA,EAAA,MAAM,MAAA,GAAS,uBAAA,CAAwB,OAAA,CAAQ,OAAA,CAAQ,UAAU,EAAE,CAAA;AACnE,EAAA,IAAI,WAAW,EAAA,EAAI;AACjB,IAAA,YAAA,CAAa,KAAK,EAAE,IAAA,EAAM,gBAAA,EAAkB,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC5D;AACA,EAAA,SAAA,CAAU,YAAA,EAAc,iBAAA,CAAkB,QAAA,EAAU,OAAA,EAAS,MAAM,CAAC,CAAA;AACpE,EAAA,OAAO,YAAA;AACT;AAMO,SAAS,eAAA,CACd,QAAA,EACA,OAAA,EACA,aAAA,EACiB;AACjB,EAAA,MAAM,eAAgC,EAAC;AACvC,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,YAAA,CAAa,IAAA,CAAK,UAAA,CAAW,eAAe,CAAC,CAAA;AAAA,EAC/C;AACA,EAAA,IAAI,OAAA,CAAQ,OAAA,CAAQ,aAAA,IAAiB,QAAA,CAAS,KAAA,EAAO;AACnD,IAAA,MAAM,UAAA,GAAa,CAAC,SAAA,KAA8B,mBAAA,CAAoB,WAAW,OAAO,CAAA;AACxF,IAAA,YAAA,CAAa,IAAA,CAAK,uBAAA,CAAwB,QAAA,CAAS,KAAA,EAAO,UAAU,CAAC,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,YAAA;AACT;;"}

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

@@ -0,0 +1,62 @@
+'use strict';
+
+const helperTypes = require('../helper-types.cjs');
+const declaredTypeNames = require('./declared-type-names.cjs');
+const document = require('./document.cjs');
+const globalTypeReferences = require('./global-type-references.cjs');
+const pathsEnum = require('./paths-enum.cjs');
+const rootTypeAliases = require('./root-type-aliases.cjs');
+
+const NAMES_THE_OUTPUT_MAY_NEED = /* @__PURE__ */ new Set([
+  ...globalTypeReferences.GLOBAL_TYPE_NAMES,
+  ...Object.values(helperTypes.HELPER_TYPES).map(({ name }) => name),
+  ...declaredTypeNames.typeNamesInText(helperTypes.READ_WRITE_MARKER_TYPES),
+  pathsEnum.API_PATHS_NAME,
+  ...document.ROOT_KEYS,
+  document.OPERATIONS_NAME
+]);
+function namesTheOutputNeeds({ body, footer, closing }) {
+  const others = [
+    ...body.filter((declaration) => !rootTypeAliases.isRootTypeAlias(declaration)),
+    ...footer.filter((declaration) => declaration.kind !== "enum"),
+    ...closing
+  ];
+  return /* @__PURE__ */ new Set([
+    ...globalTypeReferences.globalTypeReferences([...body, ...footer, ...closing]),
+    ...declaredTypeNames.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);
+}
+
+exports.NAMES_THE_OUTPUT_MAY_NEED = NAMES_THE_OUTPUT_MAY_NEED;
+exports.namesTheOutputNeeds = namesTheOutputNeeds;
+exports.withEnumsRenamed = withEnumsRenamed;
+//# sourceMappingURL=enum-names-given-back.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enum-names-given-back.cjs","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":["GLOBAL_TYPE_NAMES","HELPER_TYPES","typeNamesInText","READ_WRITE_MARKER_TYPES","API_PATHS_NAME","ROOT_KEYS","OPERATIONS_NAME","isRootTypeAlias","globalTypeReferences","typeNamesDeclaredBy"],"mappings":";;;;;;;;;AAiBO,MAAM,yBAAA,uBAAqD,GAAA,CAAI;AAAA,EACpE,GAAGA,sCAAA;AAAA,EACH,GAAG,MAAA,CAAO,MAAA,CAAOC,wBAAY,CAAA,CAAE,IAAI,CAAC,EAAE,IAAA,EAAK,KAAM,IAAI,CAAA;AAAA,EACrD,GAAGC,kCAAgBC,mCAAuB,CAAA;AAAA,EAC1CC,wBAAA;AAAA,EACA,GAAGC,kBAAA;AAAA,EACHC;AACF,CAAC;AAcM,SAAS,mBAAA,CAAoB,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAQ,EAA+B;AACzF,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,GAAG,KAAK,MAAA,CAAO,CAAC,gBAAgB,CAACC,+BAAA,CAAgB,WAAW,CAAC,CAAA;AAAA,IAC7D,GAAG,MAAA,CAAO,MAAA,CAAO,CAAC,WAAA,KAAgB,WAAA,CAAY,SAAS,MAAM,CAAA;AAAA,IAC7D,GAAG;AAAA,GACL;AACA,EAAA,2BAAW,GAAA,CAAI;AAAA,IACb,GAAGC,0CAAqB,CAAC,GAAG,MAAM,GAAG,MAAA,EAAQ,GAAG,OAAO,CAAC,CAAA;AAAA,IACxD,GAAGC,sCAAoB,MAAM;AAAA,GAC9B,CAAA;AACH;AAGA,MAAM,YAAA,mBAAoC,IAAI,GAAA,CAAI,CAAC,QAAQ,CAAC,CAAA;AAG5D,MAAM,iBAAA,GAAoB,6BAAA;AAE1B,SAAS,gBAAA,CAAiB,MAAc,OAAA,EAA8C;AACpF,EAAA,MAAM,KAAA,GAAQ,iBAAA,CAAkB,IAAA,CAAK,IAAI,CAAA;AACzC,EAAA,MAAM,OAAA,GAAU,UAAU,IAAA,GAAO,MAAA,GAAY,QAAQ,GAAA,CAAI,KAAA,CAAM,CAAC,CAAA,IAAK,EAAE,CAAA;AACvE,EAAA,OAAO,OAAA,KAAY,MAAA,GAAY,IAAA,GAAO,CAAA,EAAG,QAAQ,CAAC,CAAA,IAAK,EAAE,CAAA,EAAG,OAAO,CAAA,EAAG,KAAA,GAAQ,CAAC,KAAK,EAAE,CAAA,CAAA;AACxF;AAEA,SAAS,OAAO,KAAA,EAA4D;AAC1E,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAEA,SAAS,WAAA,CAAY,OAAgB,OAAA,EAA+C;AAClF,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,IAAA,OAAO,MAAM,GAAA,CAAI,CAAC,SAAS,WAAA,CAAY,IAAA,EAAM,OAAO,CAAC,CAAA;AAAA,EACvD;AACA,EAAA,IAAI,CAAC,MAAA,CAAO,KAAK,CAAA,EAAG;AAClB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAO,MAAA,CAAO,WAAA;AAAA,IAClB,MAAA,CAAO,QAAQ,KAAK,CAAA,CAAE,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AAAA,MAC1C,GAAA;AAAA,MACA,aAAa,GAAA,CAAI,GAAG,IAAI,KAAA,GAAQ,WAAA,CAAY,OAAO,OAAO;AAAA,KAC3D;AAAA,GACH;AACA,EAAA,MAAM,OAAA,GAAA,CACH,KAAK,IAAA,KAAS,WAAA,IAAe,KAAK,IAAA,KAAS,MAAA,KAAW,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA;AAC9E,EAAA,OAAO,OAAA,GAAU,EAAE,GAAG,IAAA,EAAM,IAAA,EAAM,iBAAiB,IAAA,CAAK,IAAA,EAAgB,OAAO,CAAA,EAAE,GAAI,IAAA;AACvF;AAGO,SAAS,gBAAA,CACd,cACA,OAAA,EACK;AACL,EAAA,OAAO,OAAA,CAAQ,SAAS,CAAA,GAAI,CAAC,GAAG,YAAY,CAAA,GAAK,WAAA,CAAY,YAAA,EAAc,OAAO,CAAA;AACpF;;;;"}