openapi-typesafe 0.0.0 → 1.0.0-rc.1

package/dist/application/transform/schema/enum-rule.cjs

@@ -0,0 +1,163 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const outputFixes = require('../../../domain/output-fixes.cjs');
+const literalType = require('../literal-type.cjs');
+const refType = require('../ref-type.cjs');
+const typeCombinators = require('../type-combinators.cjs');
+
+const COMPONENT_SCHEMAS_PREFIX = "components/schemas";
+const UNION_KEYWORDS = /* @__PURE__ */ new Set(["anyOf", "oneOf"]);
+const INDEX_RE = /^\d+$/;
+function hasAdditionalProperties(schema) {
+  return "additionalProperties" in schema && Boolean(schema.additionalProperties);
+}
+function nameFromPath(path) {
+  return jsonPointer.parseRefPointer(path ?? "").join("/").replace(COMPONENT_SCHEMAS_PREFIX, "");
+}
+const COMPONENT_SCHEMA_RE = /^#\/components\/schemas\/[^/]+$/;
+function hasEnumMetadata(schema) {
+  return [
+    schema["x-enum-varnames"],
+    schema["x-enumNames"],
+    schema["x-enum-descriptions"],
+    schema["x-enumDescriptions"]
+  ].some(Array.isArray);
+}
+function tsEnumEntries(schema, options) {
+  const entries = (schema.enum ?? []).map((value, index) => [value, index]);
+  return options.fixes.has(outputFixes.OutputFix.NULLABLE_ENUMS) ? entries.filter(([value]) => value !== null) : entries;
+}
+function isTsEnum(schema, options) {
+  if (!options.enum || !schema.enum) {
+    return false;
+  }
+  const entries = tsEnumEntries(schema, options);
+  const isOnlyNull = entries.length === 0 && schema.enum.length > 0;
+  const isSupported = !isOnlyNull && entries.every(([value]) => ["string", "number"].includes(typeof value));
+  return isSupported && (!options.conditionalEnums || hasEnumMetadata(schema));
+}
+function enumMetadata(schema, entries) {
+  return entries.map(([, index]) => ({
+    name: schema["x-enum-varnames"]?.[index] ?? schema["x-enumNames"]?.[index],
+    description: schema["x-enum-descriptions"]?.[index] ?? schema["x-enumDescriptions"]?.[index]
+  }));
+}
+function isNullAllowed(schema) {
+  const { type } = schema;
+  const isTypeNullable = type === void 0 || Array.isArray(type) && type.includes("null") || Boolean(schema.nullable);
+  return (schema.enum ?? []).includes(null) && isTypeNullable;
+}
+function withOtherStrings(type, schema) {
+  if (!hasAdditionalProperties(schema) || schema.type !== "string") {
+    return type;
+  }
+  return typeCombinators.unionOf([type, typeCombinators.intersectionOf([constructors.irKeyword("string"), constructors.irObject([])])]);
+}
+function enumRequest(schema, path, options) {
+  const entries = tsEnumEntries(schema, options);
+  return {
+    name: nameFromPath(path),
+    isComponentSchema: COMPONENT_SCHEMA_RE.test(path ?? ""),
+    values: entries.map(([value]) => value),
+    metadata: enumMetadata(schema, entries)
+  };
+}
+function enumMemberType(enumName, member) {
+  return member.startsWith('"') ? constructors.irIndexedAccess(constructors.irReference(`typeof ${enumName}`), constructors.irString(JSON.parse(member), "escaped")) : constructors.irReference(`${enumName}.${member}`);
+}
+function ownerEnumMembersType(key, values, request) {
+  const { options, discriminators, footer } = request.context;
+  const parent = options.fixes.has(
+    outputFixes.OutputFix.DISCRIMINATOR_VALUES
+  ) ? discriminators.enumParentOf(key) : void 0;
+  if (parent === void 0 || !isTsEnum(parent.schema, options)) {
+    return null;
+  }
+  const reference = { ...enumRequest(parent.schema, parent.path, options), isOwnerReference: true };
+  const name = footer.addEnum(reference);
+  const members = footer.enumMembers(name);
+  const names = values.map((value) => members.get(value));
+  if (names.length === 0 || names.some((member) => member === void 0)) {
+    return null;
+  }
+  return typeCombinators.unionOf(names.map((member) => enumMemberType(name, member)));
+}
+function tsEnumType(schema, request) {
+  const { options, footer } = request.context;
+  const values = tsEnumEntries(schema, options).map(([value]) => value);
+  const type = ownerEnumMembersType(schema, values, request) ?? withOtherStrings(
+    constructors.irReference(footer.addEnum(enumRequest(schema, request.location.path, options))),
+    schema
+  );
+  return options.fixes.has(outputFixes.OutputFix.NULLABLE_ENUMS) && isNullAllowed(schema) ? typeCombinators.unionOf([type, constructors.irKeyword("null")]) : type;
+}
+function isUnionPosition(pointer, index) {
+  const next = pointer[index + 1];
+  return UNION_KEYWORDS.has(pointer[index]) && next !== void 0 && INDEX_RE.test(next);
+}
+const PARAMETERS = "parameters";
+function pathItemParametersIndex(pointer) {
+  if (pointer[0] === "paths" || pointer[0] === "webhooks") {
+    return 2;
+  }
+  return pointer[0] === "components" && pointer[1] === "pathItems" ? 3 : null;
+}
+function withSingleParametersSegment(pointer) {
+  const index = pathItemParametersIndex(pointer);
+  const isRepeated = index !== null && pointer[index] === PARAMETERS && pointer[index + 1] === PARAMETERS;
+  return isRepeated ? [...pointer.slice(0, index), ...pointer.slice(index + 1)] : pointer;
+}
+function enumValuesPointer(path) {
+  const pointer = withSingleParametersSegment(jsonPointer.parseRefPointer(path ?? ""));
+  const kept = [];
+  let firstVariantStart = null;
+  for (let index = 0; index < pointer.length; index++) {
+    if (isUnionPosition(pointer, index)) {
+      firstVariantStart ??= index + 2;
+      index++;
+      continue;
+    }
+    kept.push(pointer[index]);
+  }
+  const extract = firstVariantStart === null ? [] : pointer.slice(firstVariantStart).filter((segment) => !UNION_KEYWORDS.has(segment) && !INDEX_RE.test(segment));
+  return { ref: jsonPointer.createRef(kept), extract };
+}
+function addEnumValues(schema, request) {
+  const { ref, extract } = enumValuesPointer(request.location.path);
+  const valuesType = refType.refType(ref, { isDeep: true, extractProperties: extract });
+  request.context.footer.addEnumValues({
+    name: `${nameFromPath(request.location.path)}Values`,
+    // A record value (`additionalProperties`) is reached by indexing with `string`.
+    type: request.isFromAdditionalProperties ? constructors.irIndexedAccess(valuesType, constructors.irReference("string")) : valuesType,
+    values: schema.enum ?? []
+  });
+}
+function literalEnumType(schema, request) {
+  const values = schema.enum ?? [];
+  const isNullable = Array.isArray(schema.type) && schema.type.includes("null") || Boolean(schema.nullable);
+  const literals = [...values.map(literalType.literalType), ...isNullable ? [constructors.irKeyword("null")] : []];
+  const type = withOtherStrings(typeCombinators.unionOf(literals), schema);
+  const isListable = values.every(
+    (value) => typeof value === "string" || typeof value === "number"
+  );
+  if (request.context.options.enumValues && isListable) {
+    addEnumValues(schema, request);
+  }
+  return type;
+}
+const enumRule = {
+  name: "enum",
+  matches(schema) {
+    const isCandidate = Array.isArray(schema.enum) && schema.type !== "object" && !("properties" in schema);
+    return isCandidate && (!hasAdditionalProperties(schema) || schema.type === "string");
+  },
+  transform(schema, request) {
+    return isTsEnum(schema, request.context.options) ? tsEnumType(schema, request) : literalEnumType(schema, request);
+  }
+};
+
+exports.enumRule = enumRule;
+exports.ownerEnumMembersType = ownerEnumMembersType;
+//# sourceMappingURL=enum-rule.cjs.map

package/dist/application/transform/schema/enum-rule.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-rule.cjs","sources":["../../../../src/application/transform/schema/enum-rule.ts"],"sourcesContent":["import {\n  irIndexedAccess,\n  irKeyword,\n  irObject,\n  irReference,\n  irString,\n} from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef, parseRefPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { OutputFix } from \"../../../domain/output-fixes.js\";\nimport { literalType } from \"../literal-type.js\";\nimport { refType } from \"../ref-type.js\";\nimport { intersectionOf, unionOf } from \"../type-combinators.js\";\nimport type {\n  DiscriminatorEnumParent,\n  EnumDeclarationRequest,\n  EnumMemberMetadata,\n  SchemaOptions,\n} from \"./schema-context.js\";\nimport type { SchemaRequest, SchemaRule } from \"./schema-rule.js\";\n\n/** Removed from generated names, so `#/components/schemas/Status` gives `Status`. */\nconst COMPONENT_SCHEMAS_PREFIX = \"components/schemas\";\nconst UNION_KEYWORDS: ReadonlySet<string> = new Set([\"anyOf\", \"oneOf\"]);\nconst INDEX_RE = /^\\d+$/;\n\nfunction hasAdditionalProperties(schema: SchemaObject): boolean {\n  return \"additionalProperties\" in schema && Boolean(schema.additionalProperties);\n}\n\n/** A name from the schema's pointer: `#/components/schemas/Pet/status` → `/Pet/status`. */\nfunction nameFromPath(path: string | undefined): string {\n  return parseRefPointer(path ?? \"\")\n    .join(\"/\")\n    .replace(COMPONENT_SCHEMAS_PREFIX, \"\");\n}\n\n/** `#/components/schemas/Name`, and no deeper pointer. */\nconst COMPONENT_SCHEMA_RE = /^#\\/components\\/schemas\\/[^/]+$/;\n\nfunction hasEnumMetadata(schema: SchemaObject): boolean {\n  return [\n    schema[\"x-enum-varnames\"],\n    schema[\"x-enumNames\"],\n    schema[\"x-enum-descriptions\"],\n    schema[\"x-enumDescriptions\"],\n  ].some(Array.isArray);\n}\n\n/**\n * The values a TypeScript enum declares, with their positions in `enum`. With the\n * `nullable-enums` fix a `null` value is left out (upstream #1872): an enum member cannot be\n * `null`, so the type adds it as `| null` instead (`tsEnumType`).\n */\nfunction tsEnumEntries(schema: SchemaObject, options: SchemaOptions): [unknown, number][] {\n  const entries = (schema.enum ?? []).map((value, index): [unknown, number] => [value, index]);\n  return options.fixes.has(OutputFix.NULLABLE_ENUMS)\n    ? entries.filter(([value]) => value !== null)\n    : entries;\n}\n\n/**\n * `--enum`: string and number enums become TypeScript enums. The original meant to allow `null`\n * too, but tested `typeof value` against `null`, so an enum containing null stays a union; the\n * `nullable-enums` fix declares its other values.\n */\nfunction isTsEnum(schema: SchemaObject, options: SchemaOptions): boolean {\n  if (!options.enum || !schema.enum) {\n    return false;\n  }\n  const entries = tsEnumEntries(schema, options);\n  // An empty `enum` stays an empty TypeScript enum, as the original made it; an enum of only\n  // `null` has no member left once the fix drops `null`, so it stays a union.\n  const isOnlyNull = entries.length === 0 && schema.enum.length > 0;\n  const isSupported =\n    !isOnlyNull && entries.every(([value]) => [\"string\", \"number\"].includes(typeof value));\n  // `--conditional-enums` converts only enums that carry x-enum-* metadata.\n  return isSupported && (!options.conditionalEnums || hasEnumMetadata(schema));\n}\n\nfunction enumMetadata(\n  schema: SchemaObject,\n  entries: readonly [unknown, number][],\n): EnumMemberMetadata[] {\n  return entries.map(([, index]) => ({\n    name: schema[\"x-enum-varnames\"]?.[index] ?? schema[\"x-enumNames\"]?.[index],\n    description: schema[\"x-enum-descriptions\"]?.[index] ?? schema[\"x-enumDescriptions\"]?.[index],\n  }));\n}\n\n/**\n * Whether `null` is a valid value: it is in `enum` and the schema's type admits it (`type`\n * absent or listing `\"null\"`, or OpenAPI 3.0 `nullable: true`). Both keywords must pass.\n */\nfunction isNullAllowed(schema: SchemaObject): boolean {\n  const { type } = schema;\n  const isTypeNullable =\n    type === undefined ||\n    (Array.isArray(type) && type.includes(\"null\")) ||\n    Boolean(schema.nullable);\n  return (schema.enum ?? []).includes(null) && isTypeNullable;\n}\n\n/**\n * `additionalProperties: true` on a string enum keeps other strings allowed but still offers the\n * listed values in editors: `\"a\" | \"b\" | (string & {})`.\n */\nfunction withOtherStrings(type: IrType, schema: SchemaObject): IrType {\n  if (!hasAdditionalProperties(schema) || schema.type !== \"string\") {\n    return type;\n  }\n  return unionOf([type, intersectionOf([irKeyword(\"string\"), irObject([])])]);\n}\n\n/** The enum declaration of `schema` typed at `path`; its values are strings and numbers. */\nfunction enumRequest(\n  schema: SchemaObject,\n  path: string | undefined,\n  options: SchemaOptions,\n): EnumDeclarationRequest {\n  const entries = tsEnumEntries(schema, options);\n  return {\n    name: nameFromPath(path),\n    isComponentSchema: COMPONENT_SCHEMA_RE.test(path ?? \"\"),\n    values: entries.map(([value]) => value as string | number),\n    metadata: enumMetadata(schema, entries),\n  };\n}\n\n/** One member's type; a quoted member cannot follow a dot, `typeof E[\"+\"]` is the same type. */\nfunction enumMemberType(enumName: string, member: string): IrType {\n  return member.startsWith('\"')\n    ? irIndexedAccess(irReference(`typeof ${enumName}`), irString(JSON.parse(member), \"escaped\"))\n    : irReference(`${enumName}.${member}`);\n}\n\n/**\n * The `discriminator-values` fix: a member's discriminator value is typed with members of\n * the owner's enum (`PetType.Cat`), so the member is one of the owner's type (#1700). `key` is the\n * enum the scan added or the inherited discriminator object. Null when the fix is off, or the\n * owner's property is no TypeScript enum with every value.\n */\nexport function ownerEnumMembersType(\n  key: object,\n  values: readonly unknown[],\n  request: SchemaRequest,\n): IrType | null {\n  const { options, discriminators, footer } = request.context;\n  const parent: DiscriminatorEnumParent | undefined = options.fixes.has(\n    OutputFix.DISCRIMINATOR_VALUES,\n  )\n    ? discriminators.enumParentOf(key)\n    : undefined;\n  if (parent === undefined || !isTsEnum(parent.schema, options)) {\n    return null;\n  }\n  const reference = { ...enumRequest(parent.schema, parent.path, options), isOwnerReference: true };\n  const name = footer.addEnum(reference);\n  const members = footer.enumMembers(name);\n  const names = values.map((value) => members.get(value as string | number));\n  if (names.length === 0 || names.some((member) => member === undefined)) {\n    return null;\n  }\n  return unionOf(names.map((member) => enumMemberType(name, member as string)));\n}\n\nfunction tsEnumType(schema: SchemaObject, request: SchemaRequest): IrType {\n  const { options, footer } = request.context;\n  // `isTsEnum` admits only strings and numbers, and the fix leaves `null` out of the members.\n  const values = tsEnumEntries(schema, options).map(([value]) => value);\n  const type =\n    ownerEnumMembersType(schema, values, request) ??\n    withOtherStrings(\n      irReference(footer.addEnum(enumRequest(schema, request.location.path, options))),\n      schema,\n    );\n  return options.fixes.has(OutputFix.NULLABLE_ENUMS) && isNullAllowed(schema)\n    ? unionOf([type, irKeyword(\"null\")])\n    : type;\n}\n\nfunction isUnionPosition(pointer: readonly string[], index: number): boolean {\n  const next = pointer[index + 1];\n  return UNION_KEYWORDS.has(pointer[index] as string) && next !== undefined && INDEX_RE.test(next);\n}\n\nconst PARAMETERS = \"parameters\";\n\n/** Where the `parameters` of a path item sit in its pointer: `paths/<key>/…`, `components/…`. */\nfunction pathItemParametersIndex(pointer: readonly string[]): number | null {\n  if (pointer[0] === \"paths\" || pointer[0] === \"webhooks\") {\n    return 2;\n  }\n  return pointer[0] === \"components\" && pointer[1] === \"pathItems\" ? 3 : null;\n}\n\n/**\n * The location of a path item parameter repeats `parameters` (`paths/~1a/parameters/parameters/\n * path/id`), which keeps the generated names as they were. The generated type has the segment\n * once: `paths[\"/a\"][\"parameters\"][\"path\"][\"id\"]`.\n */\nfunction withSingleParametersSegment(pointer: readonly string[]): readonly string[] {\n  const index = pathItemParametersIndex(pointer);\n  const isRepeated =\n    index !== null && pointer[index] === PARAMETERS && pointer[index + 1] === PARAMETERS;\n  return isRepeated ? [...pointer.slice(0, index), ...pointer.slice(index + 1)] : pointer;\n}\n\n/**\n * The pointer of `--enum-values` arrays without union positions (`anyOf/0`), so names stay\n * stable. Every property after the first union position is narrowed with `Extract`: a no-op where\n * all variants have it, and the needed narrowing where only some do.\n */\nfunction enumValuesPointer(path: string | undefined): { ref: string; extract: string[] } {\n  const pointer = withSingleParametersSegment(parseRefPointer(path ?? \"\"));\n  const kept: string[] = [];\n  let firstVariantStart: number | null = null;\n  for (let index = 0; index < pointer.length; index++) {\n    if (isUnionPosition(pointer, index)) {\n      firstVariantStart ??= index + 2;\n      index++;\n      continue;\n    }\n    kept.push(pointer[index] as string);\n  }\n  const extract =\n    firstVariantStart === null\n      ? []\n      : pointer\n          .slice(firstVariantStart)\n          .filter((segment) => !UNION_KEYWORDS.has(segment) && !INDEX_RE.test(segment));\n  return { ref: createRef(kept), extract };\n}\n\nfunction addEnumValues(schema: SchemaObject, request: SchemaRequest): void {\n  const { ref, extract } = enumValuesPointer(request.location.path);\n  const valuesType = refType(ref, { isDeep: true, extractProperties: extract });\n  request.context.footer.addEnumValues({\n    name: `${nameFromPath(request.location.path)}Values`,\n    // A record value (`additionalProperties`) is reached by indexing with `string`.\n    type: request.isFromAdditionalProperties\n      ? irIndexedAccess(valuesType, irReference(\"string\"))\n      : valuesType,\n    values: (schema.enum ?? []) as (string | number)[],\n  });\n}\n\nfunction literalEnumType(schema: SchemaObject, request: SchemaRequest): IrType {\n  const values = schema.enum ?? [];\n  const isNullable =\n    (Array.isArray(schema.type) && schema.type.includes(\"null\")) || Boolean(schema.nullable);\n  const literals = [...values.map(literalType), ...(isNullable ? [irKeyword(\"null\")] : [])];\n  const type = withOtherStrings(unionOf(literals), schema);\n  const isListable = values.every(\n    (value) => typeof value === \"string\" || typeof value === \"number\",\n  );\n  if (request.context.options.enumValues && isListable) {\n    addEnumValues(schema, request);\n  }\n  return type;\n}\n\n/**\n * `enum` on anything but an object (object enums are handled as `oneOf`). With\n * `additionalProperties`, only string enums are handled here; others fall through to composition.\n */\nexport const enumRule: SchemaRule = {\n  name: \"enum\",\n  matches(schema) {\n    const isCandidate =\n      Array.isArray(schema.enum) && schema.type !== \"object\" && !(\"properties\" in schema);\n    return isCandidate && (!hasAdditionalProperties(schema) || schema.type === \"string\");\n  },\n  transform(schema, request) {\n    return isTsEnum(schema, request.context.options)\n      ? tsEnumType(schema, request)\n      : literalEnumType(schema, request);\n  },\n};\n"],"names":["parseRefPointer","OutputFix","unionOf","intersectionOf","irKeyword","irObject","irIndexedAccess","irReference","irString","createRef","refType","literalType"],"mappings":"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"}

package/dist/application/transform/schema/enum-rule.mjs

@@ -0,0 +1,160 @@
+import { irReference, irKeyword, irIndexedAccess, irString, irObject } from '../../../domain/ir/constructors.mjs';
+import { parseRefPointer, createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { OutputFix } from '../../../domain/output-fixes.mjs';
+import { literalType } from '../literal-type.mjs';
+import { refType } from '../ref-type.mjs';
+import { unionOf, intersectionOf } from '../type-combinators.mjs';
+
+const COMPONENT_SCHEMAS_PREFIX = "components/schemas";
+const UNION_KEYWORDS = /* @__PURE__ */ new Set(["anyOf", "oneOf"]);
+const INDEX_RE = /^\d+$/;
+function hasAdditionalProperties(schema) {
+  return "additionalProperties" in schema && Boolean(schema.additionalProperties);
+}
+function nameFromPath(path) {
+  return parseRefPointer(path ?? "").join("/").replace(COMPONENT_SCHEMAS_PREFIX, "");
+}
+const COMPONENT_SCHEMA_RE = /^#\/components\/schemas\/[^/]+$/;
+function hasEnumMetadata(schema) {
+  return [
+    schema["x-enum-varnames"],
+    schema["x-enumNames"],
+    schema["x-enum-descriptions"],
+    schema["x-enumDescriptions"]
+  ].some(Array.isArray);
+}
+function tsEnumEntries(schema, options) {
+  const entries = (schema.enum ?? []).map((value, index) => [value, index]);
+  return options.fixes.has(OutputFix.NULLABLE_ENUMS) ? entries.filter(([value]) => value !== null) : entries;
+}
+function isTsEnum(schema, options) {
+  if (!options.enum || !schema.enum) {
+    return false;
+  }
+  const entries = tsEnumEntries(schema, options);
+  const isOnlyNull = entries.length === 0 && schema.enum.length > 0;
+  const isSupported = !isOnlyNull && entries.every(([value]) => ["string", "number"].includes(typeof value));
+  return isSupported && (!options.conditionalEnums || hasEnumMetadata(schema));
+}
+function enumMetadata(schema, entries) {
+  return entries.map(([, index]) => ({
+    name: schema["x-enum-varnames"]?.[index] ?? schema["x-enumNames"]?.[index],
+    description: schema["x-enum-descriptions"]?.[index] ?? schema["x-enumDescriptions"]?.[index]
+  }));
+}
+function isNullAllowed(schema) {
+  const { type } = schema;
+  const isTypeNullable = type === void 0 || Array.isArray(type) && type.includes("null") || Boolean(schema.nullable);
+  return (schema.enum ?? []).includes(null) && isTypeNullable;
+}
+function withOtherStrings(type, schema) {
+  if (!hasAdditionalProperties(schema) || schema.type !== "string") {
+    return type;
+  }
+  return unionOf([type, intersectionOf([irKeyword("string"), irObject([])])]);
+}
+function enumRequest(schema, path, options) {
+  const entries = tsEnumEntries(schema, options);
+  return {
+    name: nameFromPath(path),
+    isComponentSchema: COMPONENT_SCHEMA_RE.test(path ?? ""),
+    values: entries.map(([value]) => value),
+    metadata: enumMetadata(schema, entries)
+  };
+}
+function enumMemberType(enumName, member) {
+  return member.startsWith('"') ? irIndexedAccess(irReference(`typeof ${enumName}`), irString(JSON.parse(member), "escaped")) : irReference(`${enumName}.${member}`);
+}
+function ownerEnumMembersType(key, values, request) {
+  const { options, discriminators, footer } = request.context;
+  const parent = options.fixes.has(
+    OutputFix.DISCRIMINATOR_VALUES
+  ) ? discriminators.enumParentOf(key) : void 0;
+  if (parent === void 0 || !isTsEnum(parent.schema, options)) {
+    return null;
+  }
+  const reference = { ...enumRequest(parent.schema, parent.path, options), isOwnerReference: true };
+  const name = footer.addEnum(reference);
+  const members = footer.enumMembers(name);
+  const names = values.map((value) => members.get(value));
+  if (names.length === 0 || names.some((member) => member === void 0)) {
+    return null;
+  }
+  return unionOf(names.map((member) => enumMemberType(name, member)));
+}
+function tsEnumType(schema, request) {
+  const { options, footer } = request.context;
+  const values = tsEnumEntries(schema, options).map(([value]) => value);
+  const type = ownerEnumMembersType(schema, values, request) ?? withOtherStrings(
+    irReference(footer.addEnum(enumRequest(schema, request.location.path, options))),
+    schema
+  );
+  return options.fixes.has(OutputFix.NULLABLE_ENUMS) && isNullAllowed(schema) ? unionOf([type, irKeyword("null")]) : type;
+}
+function isUnionPosition(pointer, index) {
+  const next = pointer[index + 1];
+  return UNION_KEYWORDS.has(pointer[index]) && next !== void 0 && INDEX_RE.test(next);
+}
+const PARAMETERS = "parameters";
+function pathItemParametersIndex(pointer) {
+  if (pointer[0] === "paths" || pointer[0] === "webhooks") {
+    return 2;
+  }
+  return pointer[0] === "components" && pointer[1] === "pathItems" ? 3 : null;
+}
+function withSingleParametersSegment(pointer) {
+  const index = pathItemParametersIndex(pointer);
+  const isRepeated = index !== null && pointer[index] === PARAMETERS && pointer[index + 1] === PARAMETERS;
+  return isRepeated ? [...pointer.slice(0, index), ...pointer.slice(index + 1)] : pointer;
+}
+function enumValuesPointer(path) {
+  const pointer = withSingleParametersSegment(parseRefPointer(path ?? ""));
+  const kept = [];
+  let firstVariantStart = null;
+  for (let index = 0; index < pointer.length; index++) {
+    if (isUnionPosition(pointer, index)) {
+      firstVariantStart ??= index + 2;
+      index++;
+      continue;
+    }
+    kept.push(pointer[index]);
+  }
+  const extract = firstVariantStart === null ? [] : pointer.slice(firstVariantStart).filter((segment) => !UNION_KEYWORDS.has(segment) && !INDEX_RE.test(segment));
+  return { ref: createRef(kept), extract };
+}
+function addEnumValues(schema, request) {
+  const { ref, extract } = enumValuesPointer(request.location.path);
+  const valuesType = refType(ref, { isDeep: true, extractProperties: extract });
+  request.context.footer.addEnumValues({
+    name: `${nameFromPath(request.location.path)}Values`,
+    // A record value (`additionalProperties`) is reached by indexing with `string`.
+    type: request.isFromAdditionalProperties ? irIndexedAccess(valuesType, irReference("string")) : valuesType,
+    values: schema.enum ?? []
+  });
+}
+function literalEnumType(schema, request) {
+  const values = schema.enum ?? [];
+  const isNullable = Array.isArray(schema.type) && schema.type.includes("null") || Boolean(schema.nullable);
+  const literals = [...values.map(literalType), ...isNullable ? [irKeyword("null")] : []];
+  const type = withOtherStrings(unionOf(literals), schema);
+  const isListable = values.every(
+    (value) => typeof value === "string" || typeof value === "number"
+  );
+  if (request.context.options.enumValues && isListable) {
+    addEnumValues(schema, request);
+  }
+  return type;
+}
+const enumRule = {
+  name: "enum",
+  matches(schema) {
+    const isCandidate = Array.isArray(schema.enum) && schema.type !== "object" && !("properties" in schema);
+    return isCandidate && (!hasAdditionalProperties(schema) || schema.type === "string");
+  },
+  transform(schema, request) {
+    return isTsEnum(schema, request.context.options) ? tsEnumType(schema, request) : literalEnumType(schema, request);
+  }
+};
+
+export { enumRule, ownerEnumMembersType };
+//# sourceMappingURL=enum-rule.mjs.map

package/dist/application/transform/schema/enum-rule.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-rule.mjs","sources":["../../../../src/application/transform/schema/enum-rule.ts"],"sourcesContent":["import {\n  irIndexedAccess,\n  irKeyword,\n  irObject,\n  irReference,\n  irString,\n} from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef, parseRefPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { OutputFix } from \"../../../domain/output-fixes.js\";\nimport { literalType } from \"../literal-type.js\";\nimport { refType } from \"../ref-type.js\";\nimport { intersectionOf, unionOf } from \"../type-combinators.js\";\nimport type {\n  DiscriminatorEnumParent,\n  EnumDeclarationRequest,\n  EnumMemberMetadata,\n  SchemaOptions,\n} from \"./schema-context.js\";\nimport type { SchemaRequest, SchemaRule } from \"./schema-rule.js\";\n\n/** Removed from generated names, so `#/components/schemas/Status` gives `Status`. */\nconst COMPONENT_SCHEMAS_PREFIX = \"components/schemas\";\nconst UNION_KEYWORDS: ReadonlySet<string> = new Set([\"anyOf\", \"oneOf\"]);\nconst INDEX_RE = /^\\d+$/;\n\nfunction hasAdditionalProperties(schema: SchemaObject): boolean {\n  return \"additionalProperties\" in schema && Boolean(schema.additionalProperties);\n}\n\n/** A name from the schema's pointer: `#/components/schemas/Pet/status` → `/Pet/status`. */\nfunction nameFromPath(path: string | undefined): string {\n  return parseRefPointer(path ?? \"\")\n    .join(\"/\")\n    .replace(COMPONENT_SCHEMAS_PREFIX, \"\");\n}\n\n/** `#/components/schemas/Name`, and no deeper pointer. */\nconst COMPONENT_SCHEMA_RE = /^#\\/components\\/schemas\\/[^/]+$/;\n\nfunction hasEnumMetadata(schema: SchemaObject): boolean {\n  return [\n    schema[\"x-enum-varnames\"],\n    schema[\"x-enumNames\"],\n    schema[\"x-enum-descriptions\"],\n    schema[\"x-enumDescriptions\"],\n  ].some(Array.isArray);\n}\n\n/**\n * The values a TypeScript enum declares, with their positions in `enum`. With the\n * `nullable-enums` fix a `null` value is left out (upstream #1872): an enum member cannot be\n * `null`, so the type adds it as `| null` instead (`tsEnumType`).\n */\nfunction tsEnumEntries(schema: SchemaObject, options: SchemaOptions): [unknown, number][] {\n  const entries = (schema.enum ?? []).map((value, index): [unknown, number] => [value, index]);\n  return options.fixes.has(OutputFix.NULLABLE_ENUMS)\n    ? entries.filter(([value]) => value !== null)\n    : entries;\n}\n\n/**\n * `--enum`: string and number enums become TypeScript enums. The original meant to allow `null`\n * too, but tested `typeof value` against `null`, so an enum containing null stays a union; the\n * `nullable-enums` fix declares its other values.\n */\nfunction isTsEnum(schema: SchemaObject, options: SchemaOptions): boolean {\n  if (!options.enum || !schema.enum) {\n    return false;\n  }\n  const entries = tsEnumEntries(schema, options);\n  // An empty `enum` stays an empty TypeScript enum, as the original made it; an enum of only\n  // `null` has no member left once the fix drops `null`, so it stays a union.\n  const isOnlyNull = entries.length === 0 && schema.enum.length > 0;\n  const isSupported =\n    !isOnlyNull && entries.every(([value]) => [\"string\", \"number\"].includes(typeof value));\n  // `--conditional-enums` converts only enums that carry x-enum-* metadata.\n  return isSupported && (!options.conditionalEnums || hasEnumMetadata(schema));\n}\n\nfunction enumMetadata(\n  schema: SchemaObject,\n  entries: readonly [unknown, number][],\n): EnumMemberMetadata[] {\n  return entries.map(([, index]) => ({\n    name: schema[\"x-enum-varnames\"]?.[index] ?? schema[\"x-enumNames\"]?.[index],\n    description: schema[\"x-enum-descriptions\"]?.[index] ?? schema[\"x-enumDescriptions\"]?.[index],\n  }));\n}\n\n/**\n * Whether `null` is a valid value: it is in `enum` and the schema's type admits it (`type`\n * absent or listing `\"null\"`, or OpenAPI 3.0 `nullable: true`). Both keywords must pass.\n */\nfunction isNullAllowed(schema: SchemaObject): boolean {\n  const { type } = schema;\n  const isTypeNullable =\n    type === undefined ||\n    (Array.isArray(type) && type.includes(\"null\")) ||\n    Boolean(schema.nullable);\n  return (schema.enum ?? []).includes(null) && isTypeNullable;\n}\n\n/**\n * `additionalProperties: true` on a string enum keeps other strings allowed but still offers the\n * listed values in editors: `\"a\" | \"b\" | (string & {})`.\n */\nfunction withOtherStrings(type: IrType, schema: SchemaObject): IrType {\n  if (!hasAdditionalProperties(schema) || schema.type !== \"string\") {\n    return type;\n  }\n  return unionOf([type, intersectionOf([irKeyword(\"string\"), irObject([])])]);\n}\n\n/** The enum declaration of `schema` typed at `path`; its values are strings and numbers. */\nfunction enumRequest(\n  schema: SchemaObject,\n  path: string | undefined,\n  options: SchemaOptions,\n): EnumDeclarationRequest {\n  const entries = tsEnumEntries(schema, options);\n  return {\n    name: nameFromPath(path),\n    isComponentSchema: COMPONENT_SCHEMA_RE.test(path ?? \"\"),\n    values: entries.map(([value]) => value as string | number),\n    metadata: enumMetadata(schema, entries),\n  };\n}\n\n/** One member's type; a quoted member cannot follow a dot, `typeof E[\"+\"]` is the same type. */\nfunction enumMemberType(enumName: string, member: string): IrType {\n  return member.startsWith('\"')\n    ? irIndexedAccess(irReference(`typeof ${enumName}`), irString(JSON.parse(member), \"escaped\"))\n    : irReference(`${enumName}.${member}`);\n}\n\n/**\n * The `discriminator-values` fix: a member's discriminator value is typed with members of\n * the owner's enum (`PetType.Cat`), so the member is one of the owner's type (#1700). `key` is the\n * enum the scan added or the inherited discriminator object. Null when the fix is off, or the\n * owner's property is no TypeScript enum with every value.\n */\nexport function ownerEnumMembersType(\n  key: object,\n  values: readonly unknown[],\n  request: SchemaRequest,\n): IrType | null {\n  const { options, discriminators, footer } = request.context;\n  const parent: DiscriminatorEnumParent | undefined = options.fixes.has(\n    OutputFix.DISCRIMINATOR_VALUES,\n  )\n    ? discriminators.enumParentOf(key)\n    : undefined;\n  if (parent === undefined || !isTsEnum(parent.schema, options)) {\n    return null;\n  }\n  const reference = { ...enumRequest(parent.schema, parent.path, options), isOwnerReference: true };\n  const name = footer.addEnum(reference);\n  const members = footer.enumMembers(name);\n  const names = values.map((value) => members.get(value as string | number));\n  if (names.length === 0 || names.some((member) => member === undefined)) {\n    return null;\n  }\n  return unionOf(names.map((member) => enumMemberType(name, member as string)));\n}\n\nfunction tsEnumType(schema: SchemaObject, request: SchemaRequest): IrType {\n  const { options, footer } = request.context;\n  // `isTsEnum` admits only strings and numbers, and the fix leaves `null` out of the members.\n  const values = tsEnumEntries(schema, options).map(([value]) => value);\n  const type =\n    ownerEnumMembersType(schema, values, request) ??\n    withOtherStrings(\n      irReference(footer.addEnum(enumRequest(schema, request.location.path, options))),\n      schema,\n    );\n  return options.fixes.has(OutputFix.NULLABLE_ENUMS) && isNullAllowed(schema)\n    ? unionOf([type, irKeyword(\"null\")])\n    : type;\n}\n\nfunction isUnionPosition(pointer: readonly string[], index: number): boolean {\n  const next = pointer[index + 1];\n  return UNION_KEYWORDS.has(pointer[index] as string) && next !== undefined && INDEX_RE.test(next);\n}\n\nconst PARAMETERS = \"parameters\";\n\n/** Where the `parameters` of a path item sit in its pointer: `paths/<key>/…`, `components/…`. */\nfunction pathItemParametersIndex(pointer: readonly string[]): number | null {\n  if (pointer[0] === \"paths\" || pointer[0] === \"webhooks\") {\n    return 2;\n  }\n  return pointer[0] === \"components\" && pointer[1] === \"pathItems\" ? 3 : null;\n}\n\n/**\n * The location of a path item parameter repeats `parameters` (`paths/~1a/parameters/parameters/\n * path/id`), which keeps the generated names as they were. The generated type has the segment\n * once: `paths[\"/a\"][\"parameters\"][\"path\"][\"id\"]`.\n */\nfunction withSingleParametersSegment(pointer: readonly string[]): readonly string[] {\n  const index = pathItemParametersIndex(pointer);\n  const isRepeated =\n    index !== null && pointer[index] === PARAMETERS && pointer[index + 1] === PARAMETERS;\n  return isRepeated ? [...pointer.slice(0, index), ...pointer.slice(index + 1)] : pointer;\n}\n\n/**\n * The pointer of `--enum-values` arrays without union positions (`anyOf/0`), so names stay\n * stable. Every property after the first union position is narrowed with `Extract`: a no-op where\n * all variants have it, and the needed narrowing where only some do.\n */\nfunction enumValuesPointer(path: string | undefined): { ref: string; extract: string[] } {\n  const pointer = withSingleParametersSegment(parseRefPointer(path ?? \"\"));\n  const kept: string[] = [];\n  let firstVariantStart: number | null = null;\n  for (let index = 0; index < pointer.length; index++) {\n    if (isUnionPosition(pointer, index)) {\n      firstVariantStart ??= index + 2;\n      index++;\n      continue;\n    }\n    kept.push(pointer[index] as string);\n  }\n  const extract =\n    firstVariantStart === null\n      ? []\n      : pointer\n          .slice(firstVariantStart)\n          .filter((segment) => !UNION_KEYWORDS.has(segment) && !INDEX_RE.test(segment));\n  return { ref: createRef(kept), extract };\n}\n\nfunction addEnumValues(schema: SchemaObject, request: SchemaRequest): void {\n  const { ref, extract } = enumValuesPointer(request.location.path);\n  const valuesType = refType(ref, { isDeep: true, extractProperties: extract });\n  request.context.footer.addEnumValues({\n    name: `${nameFromPath(request.location.path)}Values`,\n    // A record value (`additionalProperties`) is reached by indexing with `string`.\n    type: request.isFromAdditionalProperties\n      ? irIndexedAccess(valuesType, irReference(\"string\"))\n      : valuesType,\n    values: (schema.enum ?? []) as (string | number)[],\n  });\n}\n\nfunction literalEnumType(schema: SchemaObject, request: SchemaRequest): IrType {\n  const values = schema.enum ?? [];\n  const isNullable =\n    (Array.isArray(schema.type) && schema.type.includes(\"null\")) || Boolean(schema.nullable);\n  const literals = [...values.map(literalType), ...(isNullable ? [irKeyword(\"null\")] : [])];\n  const type = withOtherStrings(unionOf(literals), schema);\n  const isListable = values.every(\n    (value) => typeof value === \"string\" || typeof value === \"number\",\n  );\n  if (request.context.options.enumValues && isListable) {\n    addEnumValues(schema, request);\n  }\n  return type;\n}\n\n/**\n * `enum` on anything but an object (object enums are handled as `oneOf`). With\n * `additionalProperties`, only string enums are handled here; others fall through to composition.\n */\nexport const enumRule: SchemaRule = {\n  name: \"enum\",\n  matches(schema) {\n    const isCandidate =\n      Array.isArray(schema.enum) && schema.type !== \"object\" && !(\"properties\" in schema);\n    return isCandidate && (!hasAdditionalProperties(schema) || schema.type === \"string\");\n  },\n  transform(schema, request) {\n    return isTsEnum(schema, request.context.options)\n      ? tsEnumType(schema, request)\n      : literalEnumType(schema, request);\n  },\n};\n"],"names":[],"mappings":"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"}

package/dist/application/transform/schema/inherited-discriminator.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const discriminatedUnion = require('../../../domain/openapi/discriminated-union.cjs');
+const discriminatorProperty = require('./discriminator-property.cjs');
+const enumRule = require('./enum-rule.cjs');
+
+function isInheritedUnion(path, request) {
+  const resolve = (ref) => request.context.refs.resolve(ref);
+  const union = discriminatedUnion.unionAt(path, resolve);
+  return union !== void 0 && discriminatedUnion.unionReaches(union, path, resolve);
+}
+function inheritedDiscriminator(schema, request) {
+  const { path } = request.location;
+  if (!schema.allOf && !schema.anyOf || path === void 0) {
+    return void 0;
+  }
+  const { discriminators } = request.context;
+  const isAdded = !schema.discriminator && !discriminators.isHandled(path);
+  const discriminator = isAdded ? discriminators.objectAt(path) : void 0;
+  return discriminator && !isInheritedUnion(path, request) ? { discriminator, path } : void 0;
+}
+function discriminatorMember({ discriminator, path }, request) {
+  const valueType = (value) => enumRule.ownerEnumMembersType(discriminator, [value], request);
+  return discriminatorProperty.discriminatorProperty(discriminator, path, request.context.options.immutable, valueType);
+}
+
+exports.discriminatorMember = discriminatorMember;
+exports.inheritedDiscriminator = inheritedDiscriminator;
+//# sourceMappingURL=inherited-discriminator.cjs.map

package/dist/application/transform/schema/inherited-discriminator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inherited-discriminator.cjs","sources":["../../../../src/application/transform/schema/inherited-discriminator.ts"],"sourcesContent":["import type { IrMember } from \"../../../domain/ir/nodes.js\";\nimport { unionAt, unionReaches } from \"../../../domain/openapi/discriminated-union.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { discriminatorProperty } from \"./discriminator-property.js\";\nimport { ownerEnumMembersType } from \"./enum-rule.js\";\nimport type { Discriminator } from \"./schema-context.js\";\nimport type { SchemaRequest } from \"./schema-rule.js\";\n\n/**\n * Whether the schema at `path` is a union that its own members inherit from (upstream #1665).\n * Each member sets the discriminator value, so a value of the union's own would make every member\n * `never`. The union's own keywords, which its members get, are typed at the same path.\n */\nfunction isInheritedUnion(path: string, request: SchemaRequest): boolean {\n  const resolve = (ref: string) => request.context.refs.resolve(ref);\n  const union = unionAt(path, resolve);\n  return union !== undefined && unionReaches(union, path, resolve);\n}\n\n/** A discriminator a parent's mapping implies for the schema at `path`. */\nexport interface InheritedDiscriminator {\n  readonly discriminator: Discriminator;\n  readonly path: string;\n}\n\n/**\n * The discriminator a parent's mapping implies for this schema, if it adds a property. A schema\n * with no path (a caller's own schema) is no component, so no mapping names it.\n */\nexport function inheritedDiscriminator(\n  schema: SchemaObject,\n  request: SchemaRequest,\n): InheritedDiscriminator | undefined {\n  const { path } = request.location;\n  if ((!schema.allOf && !schema.anyOf) || path === undefined) {\n    return undefined;\n  }\n  const { discriminators } = request.context;\n  // A schema does not get the discriminator it defines for its children, nor one added already.\n  const isAdded = !schema.discriminator && !discriminators.isHandled(path);\n  const discriminator = isAdded ? discriminators.objectAt(path) : undefined;\n  return discriminator && !isInheritedUnion(path, request) ? { discriminator, path } : undefined;\n}\n\n/** The property of an inherited discriminator, typed as the schema's value. */\nexport function discriminatorMember(\n  { discriminator, path }: InheritedDiscriminator,\n  request: SchemaRequest,\n): IrMember {\n  // With `discriminator-values`, the value is a member of the owner's enum (#1700).\n  const valueType = (value: string | undefined) =>\n    ownerEnumMembersType(discriminator, [value], request);\n  return discriminatorProperty(discriminator, path, request.context.options.immutable, valueType);\n}\n"],"names":["unionAt","unionReaches","ownerEnumMembersType","discriminatorProperty"],"mappings":";;;;;;AAaA,SAAS,gBAAA,CAAiB,MAAc,OAAA,EAAiC;AACvE,EAAA,MAAM,UAAU,CAAC,GAAA,KAAgB,QAAQ,OAAA,CAAQ,IAAA,CAAK,QAAQ,GAAG,CAAA;AACjE,EAAA,MAAM,KAAA,GAAQA,0BAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AACnC,EAAA,OAAO,KAAA,KAAU,MAAA,IAAaC,+BAAA,CAAa,KAAA,EAAO,MAAM,OAAO,CAAA;AACjE;AAYO,SAAS,sBAAA,CACd,QACA,OAAA,EACoC;AACpC,EAAA,MAAM,EAAE,IAAA,EAAK,GAAI,OAAA,CAAQ,QAAA;AACzB,EAAA,IAAK,CAAC,MAAA,CAAO,KAAA,IAAS,CAAC,MAAA,CAAO,KAAA,IAAU,SAAS,MAAA,EAAW;AAC1D,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,MAAM,EAAE,cAAA,EAAe,GAAI,OAAA,CAAQ,OAAA;AAEnC,EAAA,MAAM,UAAU,CAAC,MAAA,CAAO,iBAAiB,CAAC,cAAA,CAAe,UAAU,IAAI,CAAA;AACvE,EAAA,MAAM,aAAA,GAAgB,OAAA,GAAU,cAAA,CAAe,QAAA,CAAS,IAAI,CAAA,GAAI,MAAA;AAChE,EAAA,OAAO,aAAA,IAAiB,CAAC,gBAAA,CAAiB,IAAA,EAAM,OAAO,CAAA,GAAI,EAAE,aAAA,EAAe,IAAA,EAAK,GAAI,MAAA;AACvF;AAGO,SAAS,mBAAA,CACd,EAAE,aAAA,EAAe,IAAA,IACjB,OAAA,EACU;AAEV,EAAA,MAAM,SAAA,GAAY,CAAC,KAAA,KACjBC,6BAAA,CAAqB,eAAe,CAAC,KAAK,GAAG,OAAO,CAAA;AACtD,EAAA,OAAOC,4CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,OAAA,CAAQ,OAAA,CAAQ,WAAW,SAAS,CAAA;AAChG;;;"}

package/dist/application/transform/schema/inherited-discriminator.mjs

@@ -0,0 +1,26 @@
+import { unionAt, unionReaches } from '../../../domain/openapi/discriminated-union.mjs';
+import { discriminatorProperty } from './discriminator-property.mjs';
+import { ownerEnumMembersType } from './enum-rule.mjs';
+
+function isInheritedUnion(path, request) {
+  const resolve = (ref) => request.context.refs.resolve(ref);
+  const union = unionAt(path, resolve);
+  return union !== void 0 && unionReaches(union, path, resolve);
+}
+function inheritedDiscriminator(schema, request) {
+  const { path } = request.location;
+  if (!schema.allOf && !schema.anyOf || path === void 0) {
+    return void 0;
+  }
+  const { discriminators } = request.context;
+  const isAdded = !schema.discriminator && !discriminators.isHandled(path);
+  const discriminator = isAdded ? discriminators.objectAt(path) : void 0;
+  return discriminator && !isInheritedUnion(path, request) ? { discriminator, path } : void 0;
+}
+function discriminatorMember({ discriminator, path }, request) {
+  const valueType = (value) => ownerEnumMembersType(discriminator, [value], request);
+  return discriminatorProperty(discriminator, path, request.context.options.immutable, valueType);
+}
+
+export { discriminatorMember, inheritedDiscriminator };
+//# sourceMappingURL=inherited-discriminator.mjs.map

package/dist/application/transform/schema/inherited-discriminator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inherited-discriminator.mjs","sources":["../../../../src/application/transform/schema/inherited-discriminator.ts"],"sourcesContent":["import type { IrMember } from \"../../../domain/ir/nodes.js\";\nimport { unionAt, unionReaches } from \"../../../domain/openapi/discriminated-union.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { discriminatorProperty } from \"./discriminator-property.js\";\nimport { ownerEnumMembersType } from \"./enum-rule.js\";\nimport type { Discriminator } from \"./schema-context.js\";\nimport type { SchemaRequest } from \"./schema-rule.js\";\n\n/**\n * Whether the schema at `path` is a union that its own members inherit from (upstream #1665).\n * Each member sets the discriminator value, so a value of the union's own would make every member\n * `never`. The union's own keywords, which its members get, are typed at the same path.\n */\nfunction isInheritedUnion(path: string, request: SchemaRequest): boolean {\n  const resolve = (ref: string) => request.context.refs.resolve(ref);\n  const union = unionAt(path, resolve);\n  return union !== undefined && unionReaches(union, path, resolve);\n}\n\n/** A discriminator a parent's mapping implies for the schema at `path`. */\nexport interface InheritedDiscriminator {\n  readonly discriminator: Discriminator;\n  readonly path: string;\n}\n\n/**\n * The discriminator a parent's mapping implies for this schema, if it adds a property. A schema\n * with no path (a caller's own schema) is no component, so no mapping names it.\n */\nexport function inheritedDiscriminator(\n  schema: SchemaObject,\n  request: SchemaRequest,\n): InheritedDiscriminator | undefined {\n  const { path } = request.location;\n  if ((!schema.allOf && !schema.anyOf) || path === undefined) {\n    return undefined;\n  }\n  const { discriminators } = request.context;\n  // A schema does not get the discriminator it defines for its children, nor one added already.\n  const isAdded = !schema.discriminator && !discriminators.isHandled(path);\n  const discriminator = isAdded ? discriminators.objectAt(path) : undefined;\n  return discriminator && !isInheritedUnion(path, request) ? { discriminator, path } : undefined;\n}\n\n/** The property of an inherited discriminator, typed as the schema's value. */\nexport function discriminatorMember(\n  { discriminator, path }: InheritedDiscriminator,\n  request: SchemaRequest,\n): IrMember {\n  // With `discriminator-values`, the value is a member of the owner's enum (#1700).\n  const valueType = (value: string | undefined) =>\n    ownerEnumMembersType(discriminator, [value], request);\n  return discriminatorProperty(discriminator, path, request.context.options.immutable, valueType);\n}\n"],"names":[],"mappings":";;;;AAaA,SAAS,gBAAA,CAAiB,MAAc,OAAA,EAAiC;AACvE,EAAA,MAAM,UAAU,CAAC,GAAA,KAAgB,QAAQ,OAAA,CAAQ,IAAA,CAAK,QAAQ,GAAG,CAAA;AACjE,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AACnC,EAAA,OAAO,KAAA,KAAU,MAAA,IAAa,YAAA,CAAa,KAAA,EAAO,MAAM,OAAO,CAAA;AACjE;AAYO,SAAS,sBAAA,CACd,QACA,OAAA,EACoC;AACpC,EAAA,MAAM,EAAE,IAAA,EAAK,GAAI,OAAA,CAAQ,QAAA;AACzB,EAAA,IAAK,CAAC,MAAA,CAAO,KAAA,IAAS,CAAC,MAAA,CAAO,KAAA,IAAU,SAAS,MAAA,EAAW;AAC1D,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,MAAM,EAAE,cAAA,EAAe,GAAI,OAAA,CAAQ,OAAA;AAEnC,EAAA,MAAM,UAAU,CAAC,MAAA,CAAO,iBAAiB,CAAC,cAAA,CAAe,UAAU,IAAI,CAAA;AACvE,EAAA,MAAM,aAAA,GAAgB,OAAA,GAAU,cAAA,CAAe,QAAA,CAAS,IAAI,CAAA,GAAI,MAAA;AAChE,EAAA,OAAO,aAAA,IAAiB,CAAC,gBAAA,CAAiB,IAAA,EAAM,OAAO,CAAA,GAAI,EAAE,aAAA,EAAe,IAAA,EAAK,GAAI,MAAA;AACvF;AAGO,SAAS,mBAAA,CACd,EAAE,aAAA,EAAe,IAAA,IACjB,OAAA,EACU;AAEV,EAAA,MAAM,SAAA,GAAY,CAAC,KAAA,KACjB,oBAAA,CAAqB,eAAe,CAAC,KAAK,GAAG,OAAO,CAAA;AACtD,EAAA,OAAO,sBAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,OAAA,CAAQ,OAAA,CAAQ,WAAW,SAAS,CAAA;AAChG;;"}