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

package/dist/application/transform/ref-pointer/original-index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"original-index.cjs","sources":["../../../../src/application/transform/ref-pointer/original-index.ts"],"sourcesContent":["import type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { followRefs, generatedMember, isJsonObject } from \"./generated-shape.js\";\nimport {\n  isOptionalHeader,\n  isOptionalRequestBody,\n  isParameterList,\n  isTypedAsSchema,\n  leadingNode,\n  leadingSegmentsOf,\n  type RefPointer,\n  startsInSchema,\n} from \"./pointer-walk.js\";\n\n/**\n * Whether the type the original wrote for a `$ref` (`refType`: every segment indexed by name,\n * `properties` skipped) surely fails to compile. It walks the document as TypeScript walks the\n * generated types and answers true only where TypeScript reports an error for sure; where the\n * answer depends on a shape it does not model, it answers false, so that output stays as it was.\n */\n\ntype Step = \"fails\" | \"compiles\" | \"continue\";\n\ninterface OriginalWalk {\n  readonly node: unknown;\n  readonly isSchema: boolean;\n}\n\ninterface WalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\nfunction schemaStep(walk: OriginalWalk, segment: string, isLast: boolean, input: WalkInput) {\n  if (segment === \"properties\") {\n    return { step: \"continue\" as Step, walk };\n  }\n  const member = generatedMember(walk.node, segment, input.options, input.refs);\n  if (member.kind === \"missing\") {\n    return { step: \"fails\" as Step, walk };\n  }\n  if (member.kind === \"opaque\") {\n    return { step: \"compiles\" as Step, walk };\n  }\n  const isAbsentValue = member.kind === \"index\" && member.node === undefined;\n  const isUnsafe = member.kind === \"property\" ? member.isOptional : isAbsentValue;\n  return {\n    step: (isUnsafe && !isLast ? \"fails\" : \"continue\") as Step,\n    walk: { ...walk, node: member.node },\n  };\n}\n\nfunction containerStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(walk.node, input.refs)) ||\n    isOptionalHeader(input.pointer, index, walk.node);\n  if (isOptional && !isLast) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const child = isJsonObject(walk.node) ? followRefs(walk.node[segment], input.refs) : undefined;\n  return {\n    step: (child === undefined ? \"compiles\" : \"continue\") as Step,\n    walk: { ...walk, node: child },\n  };\n}\n\n/** True when the original type of the `$ref` does not compile for sure. */\nexport function originalIndexFails(input: WalkInput): boolean {\n  const { segments } = input.pointer;\n  let walk: OriginalWalk = {\n    node: leadingNode(input.pointer, input.refs),\n    isSchema: startsInSchema(input.pointer),\n  };\n  for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {\n    const segment = segments[index] as string;\n    const isLast = index === segments.length - 1;\n    if (!walk.isSchema && isParameterList(input.pointer, index)) {\n      return true;\n    }\n    if (!walk.isSchema && isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {\n      // The container's type is its schema's type: the segment indexes that type.\n      walk = { node: followRefs(walk.node.schema, input.refs), isSchema: true };\n    }\n    const result = walk.isSchema\n      ? schemaStep(walk, segment, isLast, input)\n      : containerStep(walk, index, input);\n    if (result.step !== \"continue\") {\n      return result.step === \"fails\";\n    }\n    walk = result.walk;\n  }\n  return false;\n}\n"],"names":["generatedMember","isOptionalRequestBody","isOptionalHeader","isJsonObject","followRefs","leadingNode","startsInSchema","leadingSegmentsOf","isParameterList","isTypedAsSchema"],"mappings":"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"}
+{"version":3,"file":"original-index.cjs","sources":["../../../../src/application/transform/ref-pointer/original-index.ts"],"sourcesContent":["import type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { generatedMember } from \"./generated-shape.js\";\nimport { childLocation, followLocated, isJsonObject } from \"./located-node.js\";\nimport {\n  type ContentForm,\n  headerParameterContentForm,\n  isExcludedOperation,\n  isOptionalHeader,\n  isOptionalRequestBody,\n  isParameterList,\n  isTypedAsSchema,\n  leadingLocated,\n  leadingSegmentsOf,\n  type RefPointer,\n  startsInSchema,\n} from \"./pointer-walk.js\";\n\n/**\n * Whether the type the original wrote for a `$ref` (`refType`: every segment indexed by name,\n * `properties` skipped) surely fails to compile. It walks the document as TypeScript walks the\n * generated types and answers true only where TypeScript reports an error for sure; where the\n * answer depends on a shape it does not model, it answers false, so that output stays as it was.\n */\n\ntype Step = \"fails\" | \"compiles\" | \"continue\";\n\ninterface OriginalWalk {\n  readonly node: unknown;\n  /** The node's JSON Pointer (`LocatedNode`). */\n  readonly location: string | undefined;\n  readonly isSchema: boolean;\n}\n\ninterface WalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\nfunction schemaStep(walk: OriginalWalk, segment: string, isLast: boolean, input: WalkInput) {\n  if (segment === \"properties\") {\n    return { step: \"continue\" as Step, walk };\n  }\n  const member = generatedMember(walk, segment, input.options, input.refs);\n  if (member.kind === \"missing\") {\n    return { step: \"fails\" as Step, walk };\n  }\n  if (member.kind === \"opaque\") {\n    return { step: \"compiles\" as Step, walk };\n  }\n  const isAbsentValue = member.kind === \"index\" && member.node === undefined;\n  const isUnsafe =\n    member.kind === \"property\" ? member.isOptional || member.isMarked : isAbsentValue;\n  return {\n    step: (isUnsafe && !isLast ? \"fails\" : \"continue\") as Step,\n    walk: { ...walk, node: member.node, location: member.location },\n  };\n}\n\nfunction containerStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  if (isExcludedOperation(input.pointer, index, walk.node, input)) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(walk.node, input.refs)) ||\n    isOptionalHeader(input.pointer, index, walk.node);\n  if (isOptional && !isLast) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const child = followLocated(\n    {\n      node: isJsonObject(walk.node) ? walk.node[segment] : undefined,\n      location: childLocation(walk.location, segment),\n    },\n    input.refs,\n  );\n  return {\n    step: (child.node === undefined ? \"compiles\" : \"continue\") as Step,\n    walk: { ...walk, ...child },\n  };\n}\n\n/** The schema of the first media type of a `content` map, `$ref`s followed. */\nfunction firstMediaTypeSchema(walk: OriginalWalk, refs: RefResolver): OriginalWalk | null {\n  const content = isJsonObject(walk.node) ? walk.node.content : undefined;\n  if (!isJsonObject(content)) {\n    return null;\n  }\n  const [mediaType] = Object.keys(content);\n  if (mediaType === undefined) {\n    return null;\n  }\n  const location = childLocation(childLocation(walk.location, \"content\"), mediaType);\n  const entry = followLocated({ node: content[mediaType], location }, refs);\n  return ownSchema({ ...entry, isSchema: false }, refs);\n}\n\n/** The schema a header or parameter is typed by, `$ref`s followed. */\nfunction ownSchema(walk: OriginalWalk, refs: RefResolver): OriginalWalk {\n  const schema = isJsonObject(walk.node) ? walk.node.schema : undefined;\n  const location = childLocation(walk.location, \"schema\");\n  return { ...followLocated({ node: schema, location }, refs), isSchema: true };\n}\n\n/** The schema whose type a header or parameter is, when not its media type members. */\nfunction contentSchema(\n  walk: OriginalWalk,\n  form: Exclude<ContentForm, \"media-type-members\">,\n  refs: RefResolver,\n): OriginalWalk | null {\n  switch (form) {\n    case \"first-media-type\":\n      return firstMediaTypeSchema(walk, refs);\n    case \"schema\":\n      return ownSchema(walk, refs);\n    case \"string\":\n      return null;\n  }\n}\n\n/**\n * The original indexes the `content` of a header or parameter by name. The media type members\n * have no `content` unless a media type is named so, and `string` and `unknown` (no media type)\n * have none; the schema of the first media type, or the `schema` next to `content`, is walked on.\n */\nfunction contentStep(walk: OriginalWalk, form: ContentForm, isLast: boolean, input: WalkInput) {\n  const content = isJsonObject(walk.node) ? walk.node.content : undefined;\n  if (form === \"media-type-members\") {\n    const hasMember = isJsonObject(content) && Object.hasOwn(content, \"content\");\n    return { step: (hasMember ? \"compiles\" : \"fails\") as Step, walk };\n  }\n  const schema = contentSchema(walk, form, input.refs);\n  return schema === null\n    ? { step: \"fails\" as Step, walk }\n    : schemaStep(schema, \"content\", isLast, input);\n}\n\n/**\n * A step outside a schema: a header's or parameter's `content`, a schema's container, or another.\n */\nfunction documentStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  const form = headerParameterContentForm(input.pointer, index, walk.node, input.options);\n  if (form !== null) {\n    return contentStep(walk, form, isLast, input);\n  }\n  if (isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {\n    // The container's type is its schema's type: the segment indexes that type.\n    return schemaStep(ownSchema(walk, input.refs), segment, isLast, input);\n  }\n  return containerStep(walk, index, input);\n}\n\n/** True when the original type of the `$ref` does not compile for sure. */\nexport function originalIndexFails(input: WalkInput): boolean {\n  const { segments } = input.pointer;\n  let walk: OriginalWalk = {\n    ...leadingLocated(input.pointer, input.refs),\n    isSchema: startsInSchema(input.pointer),\n  };\n  for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {\n    if (!walk.isSchema && isParameterList(input.pointer, index)) {\n      return true;\n    }\n    const isLast = index === segments.length - 1;\n    const result = walk.isSchema\n      ? schemaStep(walk, segments[index] as string, isLast, input)\n      : documentStep(walk, index, input);\n    if (result.step !== \"continue\") {\n      return result.step === \"fails\";\n    }\n    walk = result.walk;\n  }\n  return false;\n}\n"],"names":["generatedMember","isExcludedOperation","isOptionalRequestBody","isOptionalHeader","followLocated","isJsonObject","childLocation","headerParameterContentForm","isTypedAsSchema","leadingLocated","startsInSchema","leadingSegmentsOf","isParameterList"],"mappings":"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"}

package/dist/application/transform/ref-pointer/original-index.mjs

@@ -1,11 +1,12 @@
-import { isJsonObject, followRefs, generatedMember } from './generated-shape.mjs';
-import { startsInSchema, leadingNode, leadingSegmentsOf, isParameterList, isTypedAsSchema, isOptionalRequestBody, isOptionalHeader } from './pointer-walk.mjs';
+import { generatedMember } from './generated-shape.mjs';
+import { isJsonObject, childLocation, followLocated } from './located-node.mjs';
+import { startsInSchema, leadingLocated, leadingSegmentsOf, isParameterList, headerParameterContentForm, isTypedAsSchema, isExcludedOperation, isOptionalRequestBody, isOptionalHeader } from './pointer-walk.mjs';
 
 function schemaStep(walk, segment, isLast, input) {
   if (segment === "properties") {
     return { step: "continue", walk };
   }
-  const member = generatedMember(walk.node, segment, input.options, input.refs);
+  const member = generatedMember(walk, segment, input.options, input.refs);
   if (member.kind === "missing") {
     return { step: "fails", walk };
   }
@@ -13,41 +14,95 @@ function schemaStep(walk, segment, isLast, input) {
     return { step: "compiles", walk };
   }
   const isAbsentValue = member.kind === "index" && member.node === void 0;
-  const isUnsafe = member.kind === "property" ? member.isOptional : isAbsentValue;
+  const isUnsafe = member.kind === "property" ? member.isOptional || member.isMarked : isAbsentValue;
   return {
     step: isUnsafe && !isLast ? "fails" : "continue",
-    walk: { ...walk, node: member.node }
+    walk: { ...walk, node: member.node, location: member.location }
   };
 }
 function containerStep(walk, index, input) {
   const segment = input.pointer.segments[index];
   const isLast = index === input.pointer.segments.length - 1;
+  if (isExcludedOperation(input.pointer, index, walk.node, input)) {
+    return { step: "fails", walk };
+  }
   const isOptional = segment === "requestBody" && isOptionalRequestBody(walk.node, input.refs) || isOptionalHeader(input.pointer, index, walk.node);
   if (isOptional && !isLast) {
     return { step: "fails", walk };
   }
-  const child = isJsonObject(walk.node) ? followRefs(walk.node[segment], input.refs) : void 0;
+  const child = followLocated(
+    {
+      node: isJsonObject(walk.node) ? walk.node[segment] : void 0,
+      location: childLocation(walk.location, segment)
+    },
+    input.refs
+  );
   return {
-    step: child === void 0 ? "compiles" : "continue",
-    walk: { ...walk, node: child }
+    step: child.node === void 0 ? "compiles" : "continue",
+    walk: { ...walk, ...child }
   };
 }
+function firstMediaTypeSchema(walk, refs) {
+  const content = isJsonObject(walk.node) ? walk.node.content : void 0;
+  if (!isJsonObject(content)) {
+    return null;
+  }
+  const [mediaType] = Object.keys(content);
+  if (mediaType === void 0) {
+    return null;
+  }
+  const location = childLocation(childLocation(walk.location, "content"), mediaType);
+  const entry = followLocated({ node: content[mediaType], location }, refs);
+  return ownSchema({ ...entry}, refs);
+}
+function ownSchema(walk, refs) {
+  const schema = isJsonObject(walk.node) ? walk.node.schema : void 0;
+  const location = childLocation(walk.location, "schema");
+  return { ...followLocated({ node: schema, location }, refs), isSchema: true };
+}
+function contentSchema(walk, form, refs) {
+  switch (form) {
+    case "first-media-type":
+      return firstMediaTypeSchema(walk, refs);
+    case "schema":
+      return ownSchema(walk, refs);
+    case "string":
+      return null;
+  }
+}
+function contentStep(walk, form, isLast, input) {
+  const content = isJsonObject(walk.node) ? walk.node.content : void 0;
+  if (form === "media-type-members") {
+    const hasMember = isJsonObject(content) && Object.hasOwn(content, "content");
+    return { step: hasMember ? "compiles" : "fails", walk };
+  }
+  const schema = contentSchema(walk, form, input.refs);
+  return schema === null ? { step: "fails", walk } : schemaStep(schema, "content", isLast, input);
+}
+function documentStep(walk, index, input) {
+  const segment = input.pointer.segments[index];
+  const isLast = index === input.pointer.segments.length - 1;
+  const form = headerParameterContentForm(input.pointer, index, walk.node, input.options);
+  if (form !== null) {
+    return contentStep(walk, form, isLast, input);
+  }
+  if (isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {
+    return schemaStep(ownSchema(walk, input.refs), segment, isLast, input);
+  }
+  return containerStep(walk, index, input);
+}
 function originalIndexFails(input) {
   const { segments } = input.pointer;
   let walk = {
-    node: leadingNode(input.pointer, input.refs),
+    ...leadingLocated(input.pointer, input.refs),
     isSchema: startsInSchema(input.pointer)
   };
   for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {
-    const segment = segments[index];
-    const isLast = index === segments.length - 1;
     if (!walk.isSchema && isParameterList(input.pointer, index)) {
       return true;
     }
-    if (!walk.isSchema && isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {
-      walk = { node: followRefs(walk.node.schema, input.refs), isSchema: true };
-    }
-    const result = walk.isSchema ? schemaStep(walk, segment, isLast, input) : containerStep(walk, index, input);
+    const isLast = index === segments.length - 1;
+    const result = walk.isSchema ? schemaStep(walk, segments[index], isLast, input) : documentStep(walk, index, input);
     if (result.step !== "continue") {
       return result.step === "fails";
     }

package/dist/application/transform/ref-pointer/original-index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"original-index.mjs","sources":["../../../../src/application/transform/ref-pointer/original-index.ts"],"sourcesContent":["import type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { followRefs, generatedMember, isJsonObject } from \"./generated-shape.js\";\nimport {\n  isOptionalHeader,\n  isOptionalRequestBody,\n  isParameterList,\n  isTypedAsSchema,\n  leadingNode,\n  leadingSegmentsOf,\n  type RefPointer,\n  startsInSchema,\n} from \"./pointer-walk.js\";\n\n/**\n * Whether the type the original wrote for a `$ref` (`refType`: every segment indexed by name,\n * `properties` skipped) surely fails to compile. It walks the document as TypeScript walks the\n * generated types and answers true only where TypeScript reports an error for sure; where the\n * answer depends on a shape it does not model, it answers false, so that output stays as it was.\n */\n\ntype Step = \"fails\" | \"compiles\" | \"continue\";\n\ninterface OriginalWalk {\n  readonly node: unknown;\n  readonly isSchema: boolean;\n}\n\ninterface WalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\nfunction schemaStep(walk: OriginalWalk, segment: string, isLast: boolean, input: WalkInput) {\n  if (segment === \"properties\") {\n    return { step: \"continue\" as Step, walk };\n  }\n  const member = generatedMember(walk.node, segment, input.options, input.refs);\n  if (member.kind === \"missing\") {\n    return { step: \"fails\" as Step, walk };\n  }\n  if (member.kind === \"opaque\") {\n    return { step: \"compiles\" as Step, walk };\n  }\n  const isAbsentValue = member.kind === \"index\" && member.node === undefined;\n  const isUnsafe = member.kind === \"property\" ? member.isOptional : isAbsentValue;\n  return {\n    step: (isUnsafe && !isLast ? \"fails\" : \"continue\") as Step,\n    walk: { ...walk, node: member.node },\n  };\n}\n\nfunction containerStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(walk.node, input.refs)) ||\n    isOptionalHeader(input.pointer, index, walk.node);\n  if (isOptional && !isLast) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const child = isJsonObject(walk.node) ? followRefs(walk.node[segment], input.refs) : undefined;\n  return {\n    step: (child === undefined ? \"compiles\" : \"continue\") as Step,\n    walk: { ...walk, node: child },\n  };\n}\n\n/** True when the original type of the `$ref` does not compile for sure. */\nexport function originalIndexFails(input: WalkInput): boolean {\n  const { segments } = input.pointer;\n  let walk: OriginalWalk = {\n    node: leadingNode(input.pointer, input.refs),\n    isSchema: startsInSchema(input.pointer),\n  };\n  for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {\n    const segment = segments[index] as string;\n    const isLast = index === segments.length - 1;\n    if (!walk.isSchema && isParameterList(input.pointer, index)) {\n      return true;\n    }\n    if (!walk.isSchema && isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {\n      // The container's type is its schema's type: the segment indexes that type.\n      walk = { node: followRefs(walk.node.schema, input.refs), isSchema: true };\n    }\n    const result = walk.isSchema\n      ? schemaStep(walk, segment, isLast, input)\n      : containerStep(walk, index, input);\n    if (result.step !== \"continue\") {\n      return result.step === \"fails\";\n    }\n    walk = result.walk;\n  }\n  return false;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"original-index.mjs","sources":["../../../../src/application/transform/ref-pointer/original-index.ts"],"sourcesContent":["import type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { generatedMember } from \"./generated-shape.js\";\nimport { childLocation, followLocated, isJsonObject } from \"./located-node.js\";\nimport {\n  type ContentForm,\n  headerParameterContentForm,\n  isExcludedOperation,\n  isOptionalHeader,\n  isOptionalRequestBody,\n  isParameterList,\n  isTypedAsSchema,\n  leadingLocated,\n  leadingSegmentsOf,\n  type RefPointer,\n  startsInSchema,\n} from \"./pointer-walk.js\";\n\n/**\n * Whether the type the original wrote for a `$ref` (`refType`: every segment indexed by name,\n * `properties` skipped) surely fails to compile. It walks the document as TypeScript walks the\n * generated types and answers true only where TypeScript reports an error for sure; where the\n * answer depends on a shape it does not model, it answers false, so that output stays as it was.\n */\n\ntype Step = \"fails\" | \"compiles\" | \"continue\";\n\ninterface OriginalWalk {\n  readonly node: unknown;\n  /** The node's JSON Pointer (`LocatedNode`). */\n  readonly location: string | undefined;\n  readonly isSchema: boolean;\n}\n\ninterface WalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\nfunction schemaStep(walk: OriginalWalk, segment: string, isLast: boolean, input: WalkInput) {\n  if (segment === \"properties\") {\n    return { step: \"continue\" as Step, walk };\n  }\n  const member = generatedMember(walk, segment, input.options, input.refs);\n  if (member.kind === \"missing\") {\n    return { step: \"fails\" as Step, walk };\n  }\n  if (member.kind === \"opaque\") {\n    return { step: \"compiles\" as Step, walk };\n  }\n  const isAbsentValue = member.kind === \"index\" && member.node === undefined;\n  const isUnsafe =\n    member.kind === \"property\" ? member.isOptional || member.isMarked : isAbsentValue;\n  return {\n    step: (isUnsafe && !isLast ? \"fails\" : \"continue\") as Step,\n    walk: { ...walk, node: member.node, location: member.location },\n  };\n}\n\nfunction containerStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  if (isExcludedOperation(input.pointer, index, walk.node, input)) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(walk.node, input.refs)) ||\n    isOptionalHeader(input.pointer, index, walk.node);\n  if (isOptional && !isLast) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const child = followLocated(\n    {\n      node: isJsonObject(walk.node) ? walk.node[segment] : undefined,\n      location: childLocation(walk.location, segment),\n    },\n    input.refs,\n  );\n  return {\n    step: (child.node === undefined ? \"compiles\" : \"continue\") as Step,\n    walk: { ...walk, ...child },\n  };\n}\n\n/** The schema of the first media type of a `content` map, `$ref`s followed. */\nfunction firstMediaTypeSchema(walk: OriginalWalk, refs: RefResolver): OriginalWalk | null {\n  const content = isJsonObject(walk.node) ? walk.node.content : undefined;\n  if (!isJsonObject(content)) {\n    return null;\n  }\n  const [mediaType] = Object.keys(content);\n  if (mediaType === undefined) {\n    return null;\n  }\n  const location = childLocation(childLocation(walk.location, \"content\"), mediaType);\n  const entry = followLocated({ node: content[mediaType], location }, refs);\n  return ownSchema({ ...entry, isSchema: false }, refs);\n}\n\n/** The schema a header or parameter is typed by, `$ref`s followed. */\nfunction ownSchema(walk: OriginalWalk, refs: RefResolver): OriginalWalk {\n  const schema = isJsonObject(walk.node) ? walk.node.schema : undefined;\n  const location = childLocation(walk.location, \"schema\");\n  return { ...followLocated({ node: schema, location }, refs), isSchema: true };\n}\n\n/** The schema whose type a header or parameter is, when not its media type members. */\nfunction contentSchema(\n  walk: OriginalWalk,\n  form: Exclude<ContentForm, \"media-type-members\">,\n  refs: RefResolver,\n): OriginalWalk | null {\n  switch (form) {\n    case \"first-media-type\":\n      return firstMediaTypeSchema(walk, refs);\n    case \"schema\":\n      return ownSchema(walk, refs);\n    case \"string\":\n      return null;\n  }\n}\n\n/**\n * The original indexes the `content` of a header or parameter by name. The media type members\n * have no `content` unless a media type is named so, and `string` and `unknown` (no media type)\n * have none; the schema of the first media type, or the `schema` next to `content`, is walked on.\n */\nfunction contentStep(walk: OriginalWalk, form: ContentForm, isLast: boolean, input: WalkInput) {\n  const content = isJsonObject(walk.node) ? walk.node.content : undefined;\n  if (form === \"media-type-members\") {\n    const hasMember = isJsonObject(content) && Object.hasOwn(content, \"content\");\n    return { step: (hasMember ? \"compiles\" : \"fails\") as Step, walk };\n  }\n  const schema = contentSchema(walk, form, input.refs);\n  return schema === null\n    ? { step: \"fails\" as Step, walk }\n    : schemaStep(schema, \"content\", isLast, input);\n}\n\n/**\n * A step outside a schema: a header's or parameter's `content`, a schema's container, or another.\n */\nfunction documentStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  const form = headerParameterContentForm(input.pointer, index, walk.node, input.options);\n  if (form !== null) {\n    return contentStep(walk, form, isLast, input);\n  }\n  if (isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {\n    // The container's type is its schema's type: the segment indexes that type.\n    return schemaStep(ownSchema(walk, input.refs), segment, isLast, input);\n  }\n  return containerStep(walk, index, input);\n}\n\n/** True when the original type of the `$ref` does not compile for sure. */\nexport function originalIndexFails(input: WalkInput): boolean {\n  const { segments } = input.pointer;\n  let walk: OriginalWalk = {\n    ...leadingLocated(input.pointer, input.refs),\n    isSchema: startsInSchema(input.pointer),\n  };\n  for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {\n    if (!walk.isSchema && isParameterList(input.pointer, index)) {\n      return true;\n    }\n    const isLast = index === segments.length - 1;\n    const result = walk.isSchema\n      ? schemaStep(walk, segments[index] as string, isLast, input)\n      : documentStep(walk, index, input);\n    if (result.step !== \"continue\") {\n      return result.step === \"fails\";\n    }\n    walk = result.walk;\n  }\n  return false;\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-type.cjs

@@ -4,8 +4,8 @@ const constructors = require('../../../domain/ir/constructors.cjs');
 const outputFixes = require('../../../domain/output-fixes.cjs');
 const refType = require('../ref-type.cjs');
 const generatedLocation = require('./generated-location.cjs');
-const generatedShape = require('./generated-shape.cjs');
 const inlineCycles = require('./inline-cycles.cjs');
+const locatedNode = require('./located-node.cjs');
 const originalIndex = require('./original-index.cjs');
 const pointerWalk = require('./pointer-walk.cjs');
 const typedWalk = require('./typed-walk.cjs');
@@ -19,7 +19,7 @@ function pointerOf(ref) {
 }
 function targetType(ref, pointer, request, seen) {
   const target = pointerWalk.pointerNode(pointer, request.context.refs);
-  if (generatedShape.isJsonObject(target) && typeof target.$ref === "string") {
+  if (locatedNode.isJsonObject(target) && typeof target.$ref === "string") {
     return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);
   }
   if (target === void 0 || inlineCycles.hasInlineCycle(ref, request.context.options, request.context.refs)) {

package/dist/application/transform/ref-pointer/pointer-type.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-type.cjs","sources":["../../../../src/application/transform/ref-pointer/pointer-type.ts"],"sourcesContent":["import { irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { InvalidRefError, refType } from \"../ref-type.js\";\nimport type { SchemaRequest } from \"../schema/schema-rule.js\";\nimport { generatedLocationOf } from \"./generated-location.js\";\nimport { isJsonObject } from \"./generated-shape.js\";\nimport { hasInlineCycle } from \"./inline-cycles.js\";\nimport { originalIndexFails } from \"./original-index.js\";\nimport { leadingSegmentsOf, pointerNode, type RefPointer, refPointerOf } from \"./pointer-walk.js\";\nimport { typedWalk } from \"./typed-walk.js\";\n\n/**\n * The type of a schema `$ref` (ADR-026). The original indexed every segment of the pointer by\n * name (`refType`), also schema keywords the generated types do not have (`[\"schema\"]`,\n * `[\"items\"]`, `[\"allOf\"][\"0\"]`), and did not look through optional or nullable values. Where that\n * type does not compile, the `$ref` now gets the type of what it points at; where it compiles\n * (through an index signature), it stays, and the `ref-pointers` fix gives the right type there.\n */\n\nfunction pointerOf(ref: string): RefPointer {\n  const pointer = refPointerOf(ref);\n  if (pointer === null) {\n    throw new InvalidRefError(ref);\n  }\n  return pointer;\n}\n\n/** The target of a pointer that crosses a segment with no type: its `$ref`, or its own type. */\nfunction targetType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const target = pointerNode(pointer, request.context.refs);\n  if (isJsonObject(target) && typeof target.$ref === \"string\") {\n    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);\n  }\n  if (target === undefined || hasInlineCycle(ref, request.context.options, request.context.refs)) {\n    return null;\n  }\n  // Typed where the generator types the node, so it shares the node's enum (`--enum`).\n  const location = generatedLocationOf(ref, request.context.refs);\n  return request.transformNested(\n    target as never,\n    { path: location.path, schema: target },\n    location.isFromAdditionalProperties,\n  );\n}\n\nfunction correctedType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer, options, refs });\n  return result.kind === \"typed\" ? result.walk.type : targetType(ref, pointer, request, seen);\n}\n\nfunction isCorrected(pointer: RefPointer, request: SchemaRequest): boolean {\n  const { options, refs } = request.context;\n  return options.fixes.has(FIX.REF_POINTERS) || originalIndexFails({ pointer, options, refs });\n}\n\n/** The type of a schema `$ref`. Throws InvalidRefError when the `$ref` has no pointer. */\nexport function schemaRefType(\n  ref: string,\n  request: SchemaRequest,\n  seen: readonly string[] = [],\n): IrType {\n  const pointer = pointerOf(ref);\n  if (pointer.segments.length <= leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {\n    return refType(ref);\n  }\n  return correctedType(ref, pointer, request, seen) ?? refType(ref);\n}\n\n/**\n * The type of a `$ref` that `WithRequired` takes. A `$ref` to an optional or nullable value has\n * no keys (`keyof (T | undefined)` is `never`), so it is wrapped in `NonNullable` (TS2344).\n */\nexport function requirableRefType(ref: string, type: IrType, request: SchemaRequest): IrType {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer: pointerOf(ref), options, refs });\n  const isAbsent = result.kind === \"typed\" && result.walk.presence === \"absent\";\n  return isAbsent ? irReference(\"NonNullable\", [type]) : type;\n}\n"],"names":["refPointerOf","InvalidRefError","pointerNode","isJsonObject","hasInlineCycle","generatedLocationOf","typedWalk","FIX","originalIndexFails","leadingSegmentsOf","refType","irReference"],"mappings":"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"}
+{"version":3,"file":"pointer-type.cjs","sources":["../../../../src/application/transform/ref-pointer/pointer-type.ts"],"sourcesContent":["import { irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { InvalidRefError, refType } from \"../ref-type.js\";\nimport type { SchemaRequest } from \"../schema/schema-rule.js\";\nimport { generatedLocationOf } from \"./generated-location.js\";\nimport { hasInlineCycle } from \"./inline-cycles.js\";\nimport { isJsonObject } from \"./located-node.js\";\nimport { originalIndexFails } from \"./original-index.js\";\nimport { leadingSegmentsOf, pointerNode, type RefPointer, refPointerOf } from \"./pointer-walk.js\";\nimport { typedWalk } from \"./typed-walk.js\";\n\n/**\n * The type of a schema `$ref` (ADR-026). The original indexed every segment of the pointer by\n * name (`refType`), also schema keywords the generated types do not have (`[\"schema\"]`,\n * `[\"items\"]`, `[\"allOf\"][\"0\"]`), and did not look through optional or nullable values. Where that\n * type does not compile, the `$ref` now gets the type of what it points at; where it compiles\n * (through an index signature), it stays, and the `ref-pointers` fix gives the right type there.\n */\n\nfunction pointerOf(ref: string): RefPointer {\n  const pointer = refPointerOf(ref);\n  if (pointer === null) {\n    throw new InvalidRefError(ref);\n  }\n  return pointer;\n}\n\n/** The target of a pointer that crosses a segment with no type: its `$ref`, or its own type. */\nfunction targetType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const target = pointerNode(pointer, request.context.refs);\n  if (isJsonObject(target) && typeof target.$ref === \"string\") {\n    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);\n  }\n  if (target === undefined || hasInlineCycle(ref, request.context.options, request.context.refs)) {\n    return null;\n  }\n  // Typed where the generator types the node, so it shares the node's enum (`--enum`).\n  const location = generatedLocationOf(ref, request.context.refs);\n  return request.transformNested(\n    target as never,\n    { path: location.path, schema: target },\n    location.isFromAdditionalProperties,\n  );\n}\n\nfunction correctedType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer, options, refs });\n  return result.kind === \"typed\" ? result.walk.type : targetType(ref, pointer, request, seen);\n}\n\nfunction isCorrected(pointer: RefPointer, request: SchemaRequest): boolean {\n  const { options, refs } = request.context;\n  return options.fixes.has(FIX.REF_POINTERS) || originalIndexFails({ pointer, options, refs });\n}\n\n/** The type of a schema `$ref`. Throws InvalidRefError when the `$ref` has no pointer. */\nexport function schemaRefType(\n  ref: string,\n  request: SchemaRequest,\n  seen: readonly string[] = [],\n): IrType {\n  const pointer = pointerOf(ref);\n  if (pointer.segments.length <= leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {\n    return refType(ref);\n  }\n  return correctedType(ref, pointer, request, seen) ?? refType(ref);\n}\n\n/**\n * The type of a `$ref` that `WithRequired` takes. A `$ref` to an optional or nullable value has\n * no keys (`keyof (T | undefined)` is `never`), so it is wrapped in `NonNullable` (TS2344).\n */\nexport function requirableRefType(ref: string, type: IrType, request: SchemaRequest): IrType {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer: pointerOf(ref), options, refs });\n  const isAbsent = result.kind === \"typed\" && result.walk.presence === \"absent\";\n  return isAbsent ? irReference(\"NonNullable\", [type]) : type;\n}\n"],"names":["refPointerOf","InvalidRefError","pointerNode","isJsonObject","hasInlineCycle","generatedLocationOf","typedWalk","FIX","originalIndexFails","leadingSegmentsOf","refType","irReference"],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-type.mjs

@@ -2,8 +2,8 @@ import { irReference } from '../../../domain/ir/constructors.mjs';
 import { FIX } from '../../../domain/output-fixes.mjs';
 import { refType, InvalidRefError } from '../ref-type.mjs';
 import { generatedLocationOf } from './generated-location.mjs';
-import { isJsonObject } from './generated-shape.mjs';
 import { hasInlineCycle } from './inline-cycles.mjs';
+import { isJsonObject } from './located-node.mjs';
 import { originalIndexFails } from './original-index.mjs';
 import { leadingSegmentsOf, refPointerOf, pointerNode } from './pointer-walk.mjs';
 import { typedWalk } from './typed-walk.mjs';

package/dist/application/transform/ref-pointer/pointer-type.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-type.mjs","sources":["../../../../src/application/transform/ref-pointer/pointer-type.ts"],"sourcesContent":["import { irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { InvalidRefError, refType } from \"../ref-type.js\";\nimport type { SchemaRequest } from \"../schema/schema-rule.js\";\nimport { generatedLocationOf } from \"./generated-location.js\";\nimport { isJsonObject } from \"./generated-shape.js\";\nimport { hasInlineCycle } from \"./inline-cycles.js\";\nimport { originalIndexFails } from \"./original-index.js\";\nimport { leadingSegmentsOf, pointerNode, type RefPointer, refPointerOf } from \"./pointer-walk.js\";\nimport { typedWalk } from \"./typed-walk.js\";\n\n/**\n * The type of a schema `$ref` (ADR-026). The original indexed every segment of the pointer by\n * name (`refType`), also schema keywords the generated types do not have (`[\"schema\"]`,\n * `[\"items\"]`, `[\"allOf\"][\"0\"]`), and did not look through optional or nullable values. Where that\n * type does not compile, the `$ref` now gets the type of what it points at; where it compiles\n * (through an index signature), it stays, and the `ref-pointers` fix gives the right type there.\n */\n\nfunction pointerOf(ref: string): RefPointer {\n  const pointer = refPointerOf(ref);\n  if (pointer === null) {\n    throw new InvalidRefError(ref);\n  }\n  return pointer;\n}\n\n/** The target of a pointer that crosses a segment with no type: its `$ref`, or its own type. */\nfunction targetType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const target = pointerNode(pointer, request.context.refs);\n  if (isJsonObject(target) && typeof target.$ref === \"string\") {\n    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);\n  }\n  if (target === undefined || hasInlineCycle(ref, request.context.options, request.context.refs)) {\n    return null;\n  }\n  // Typed where the generator types the node, so it shares the node's enum (`--enum`).\n  const location = generatedLocationOf(ref, request.context.refs);\n  return request.transformNested(\n    target as never,\n    { path: location.path, schema: target },\n    location.isFromAdditionalProperties,\n  );\n}\n\nfunction correctedType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer, options, refs });\n  return result.kind === \"typed\" ? result.walk.type : targetType(ref, pointer, request, seen);\n}\n\nfunction isCorrected(pointer: RefPointer, request: SchemaRequest): boolean {\n  const { options, refs } = request.context;\n  return options.fixes.has(FIX.REF_POINTERS) || originalIndexFails({ pointer, options, refs });\n}\n\n/** The type of a schema `$ref`. Throws InvalidRefError when the `$ref` has no pointer. */\nexport function schemaRefType(\n  ref: string,\n  request: SchemaRequest,\n  seen: readonly string[] = [],\n): IrType {\n  const pointer = pointerOf(ref);\n  if (pointer.segments.length <= leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {\n    return refType(ref);\n  }\n  return correctedType(ref, pointer, request, seen) ?? refType(ref);\n}\n\n/**\n * The type of a `$ref` that `WithRequired` takes. A `$ref` to an optional or nullable value has\n * no keys (`keyof (T | undefined)` is `never`), so it is wrapped in `NonNullable` (TS2344).\n */\nexport function requirableRefType(ref: string, type: IrType, request: SchemaRequest): IrType {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer: pointerOf(ref), options, refs });\n  const isAbsent = result.kind === \"typed\" && result.walk.presence === \"absent\";\n  return isAbsent ? irReference(\"NonNullable\", [type]) : type;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"pointer-type.mjs","sources":["../../../../src/application/transform/ref-pointer/pointer-type.ts"],"sourcesContent":["import { irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { InvalidRefError, refType } from \"../ref-type.js\";\nimport type { SchemaRequest } from \"../schema/schema-rule.js\";\nimport { generatedLocationOf } from \"./generated-location.js\";\nimport { hasInlineCycle } from \"./inline-cycles.js\";\nimport { isJsonObject } from \"./located-node.js\";\nimport { originalIndexFails } from \"./original-index.js\";\nimport { leadingSegmentsOf, pointerNode, type RefPointer, refPointerOf } from \"./pointer-walk.js\";\nimport { typedWalk } from \"./typed-walk.js\";\n\n/**\n * The type of a schema `$ref` (ADR-026). The original indexed every segment of the pointer by\n * name (`refType`), also schema keywords the generated types do not have (`[\"schema\"]`,\n * `[\"items\"]`, `[\"allOf\"][\"0\"]`), and did not look through optional or nullable values. Where that\n * type does not compile, the `$ref` now gets the type of what it points at; where it compiles\n * (through an index signature), it stays, and the `ref-pointers` fix gives the right type there.\n */\n\nfunction pointerOf(ref: string): RefPointer {\n  const pointer = refPointerOf(ref);\n  if (pointer === null) {\n    throw new InvalidRefError(ref);\n  }\n  return pointer;\n}\n\n/** The target of a pointer that crosses a segment with no type: its `$ref`, or its own type. */\nfunction targetType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const target = pointerNode(pointer, request.context.refs);\n  if (isJsonObject(target) && typeof target.$ref === \"string\") {\n    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);\n  }\n  if (target === undefined || hasInlineCycle(ref, request.context.options, request.context.refs)) {\n    return null;\n  }\n  // Typed where the generator types the node, so it shares the node's enum (`--enum`).\n  const location = generatedLocationOf(ref, request.context.refs);\n  return request.transformNested(\n    target as never,\n    { path: location.path, schema: target },\n    location.isFromAdditionalProperties,\n  );\n}\n\nfunction correctedType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer, options, refs });\n  return result.kind === \"typed\" ? result.walk.type : targetType(ref, pointer, request, seen);\n}\n\nfunction isCorrected(pointer: RefPointer, request: SchemaRequest): boolean {\n  const { options, refs } = request.context;\n  return options.fixes.has(FIX.REF_POINTERS) || originalIndexFails({ pointer, options, refs });\n}\n\n/** The type of a schema `$ref`. Throws InvalidRefError when the `$ref` has no pointer. */\nexport function schemaRefType(\n  ref: string,\n  request: SchemaRequest,\n  seen: readonly string[] = [],\n): IrType {\n  const pointer = pointerOf(ref);\n  if (pointer.segments.length <= leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {\n    return refType(ref);\n  }\n  return correctedType(ref, pointer, request, seen) ?? refType(ref);\n}\n\n/**\n * The type of a `$ref` that `WithRequired` takes. A `$ref` to an optional or nullable value has\n * no keys (`keyof (T | undefined)` is `never`), so it is wrapped in `NonNullable` (TS2344).\n */\nexport function requirableRefType(ref: string, type: IrType, request: SchemaRequest): IrType {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer: pointerOf(ref), options, refs });\n  const isAbsent = result.kind === \"typed\" && result.walk.presence === \"absent\";\n  return isAbsent ? irReference(\"NonNullable\", [type]) : type;\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-walk.cjs

@@ -1,7 +1,10 @@
 'use strict';
 
+const documentPlaces = require('../../../domain/openapi/document-places.cjs');
 const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
-const generatedShape = require('./generated-shape.cjs');
+const parameterObject = require('../../../domain/openapi/parameter-object.cjs');
+const outputFixes = require('../../../domain/output-fixes.cjs');
+const locatedNode = require('./located-node.cjs');
 
 const NAMED_ROOTS = /* @__PURE__ */ new Set(["paths", "webhooks"]);
 function leadingSegmentsOf(pointer) {
@@ -11,18 +14,23 @@ function refPointerOf(ref) {
   const [rootSegment, ...segments] = jsonPointer.parseRefPointer(ref);
   return rootSegment === void 0 ? null : { rootSegment, segments };
 }
-function leadingNode(pointer, refs) {
-  let node = refs.resolve(`#/${pointer.rootSegment}`);
+function leadingLocated(pointer, refs) {
+  let located = {
+    node: refs.resolve(`#/${pointer.rootSegment}`),
+    location: locatedNode.childLocation(jsonPointer.ROOT_POINTER, pointer.rootSegment)
+  };
   for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {
-    node = generatedShape.isJsonObject(node) ? generatedShape.followRefs(node[segment], refs) : void 0;
+    const { node, location } = located;
+    const child = locatedNode.isJsonObject(node) ? node[segment] : void 0;
+    located = locatedNode.followLocated({ node: child, location: locatedNode.childLocation(location, segment) }, refs);
   }
-  return node;
+  return located;
 }
 function pointerNode(pointer, refs) {
   let node = refs.resolve(`#/${pointer.rootSegment}`);
   pointer.segments.forEach((segment, index) => {
-    const child = generatedShape.isJsonObject(node) || Array.isArray(node) ? node[segment] : void 0;
-    node = index === pointer.segments.length - 1 ? child : generatedShape.followRefs(child, refs);
+    const child = locatedNode.isJsonObject(node) || Array.isArray(node) ? node[segment] : void 0;
+    node = index === pointer.segments.length - 1 ? child : locatedNode.followRefs(child, refs);
   });
   return node;
 }
@@ -34,31 +42,64 @@ function isTypedAsSchema(pointer, index) {
   const isComponentParameter = pointer.rootSegment === "components" && index === 2 && owner === "parameters";
   return owner === "content" || owner === "headers" || isComponentParameter;
 }
+function headerParameterContentForm(pointer, index, owner, options) {
+  const isHeader = pointer.segments[index - 2] === "headers";
+  const isComponentParameter = pointer.rootSegment === "components" && index === 2 && pointer.segments[0] === "parameters";
+  const isOwnContent = pointer.segments[index] === "content" && (isHeader || isComponentParameter);
+  if (!isOwnContent || !locatedNode.isJsonObject(owner)) {
+    return null;
+  }
+  const isFixed = options.fixes.has(outputFixes.FIX.PARAMETER_HEADER_CONTENT);
+  if (isHeader) {
+    if (owner.schema) {
+      return "schema";
+    }
+    return isFixed ? "first-media-type" : "media-type-members";
+  }
+  if (owner.in === parameterObject.QUERYSTRING_LOCATION) {
+    return "first-media-type";
+  }
+  if (owner.schema !== void 0) {
+    return "schema";
+  }
+  return isFixed ? "first-media-type" : "string";
+}
 function isParameterList(pointer, index) {
   const next = pointer.segments[index + 1] ?? "";
   return pointer.segments[index] === "parameters" && /^\d+$/.test(next);
 }
 function isOptionalHeader(pointer, index, headers) {
   const isComponentHeader = pointer.rootSegment === "components" && index === 1;
-  if (pointer.segments[index - 1] !== "headers" || isComponentHeader || !generatedShape.isJsonObject(headers)) {
+  if (pointer.segments[index - 1] !== "headers" || isComponentHeader || !locatedNode.isJsonObject(headers)) {
     return false;
   }
   const header = headers[pointer.segments[index]];
-  return generatedShape.isJsonObject(header) && header.$ref === void 0 && header.required !== true;
+  return locatedNode.isJsonObject(header) && header.$ref === void 0 && header.required !== true;
+}
+function isExcludedOperation(pointer, index, pathItem, input) {
+  const segments = [pointer.rootSegment, ...pointer.segments.slice(0, index + 1)];
+  if (!input.options.excludeDeprecated || documentPlaces.placeOf(segments) !== "operation") {
+    return false;
+  }
+  const segment = pointer.segments[index];
+  const operation = locatedNode.isJsonObject(pathItem) ? locatedNode.followRefs(pathItem[segment], input.refs) : void 0;
+  return locatedNode.isJsonObject(operation) && Boolean(operation.deprecated);
 }
 function isOptionalRequestBody(container, refs) {
-  if (!generatedShape.isJsonObject(container) || container.requestBody === void 0) {
+  if (!locatedNode.isJsonObject(container) || container.requestBody === void 0) {
     return false;
   }
-  const body = generatedShape.followRefs(container.requestBody, refs);
-  return !(generatedShape.isJsonObject(body) && body.required === true);
+  const body = locatedNode.followRefs(container.requestBody, refs);
+  return !(locatedNode.isJsonObject(body) && body.required === true);
 }
 
+exports.headerParameterContentForm = headerParameterContentForm;
+exports.isExcludedOperation = isExcludedOperation;
 exports.isOptionalHeader = isOptionalHeader;
 exports.isOptionalRequestBody = isOptionalRequestBody;
 exports.isParameterList = isParameterList;
 exports.isTypedAsSchema = isTypedAsSchema;
-exports.leadingNode = leadingNode;
+exports.leadingLocated = leadingLocated;
 exports.leadingSegmentsOf = leadingSegmentsOf;
 exports.pointerNode = pointerNode;
 exports.refPointerOf = refPointerOf;

package/dist/application/transform/ref-pointer/pointer-walk.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-walk.cjs","sources":["../../../../src/application/transform/ref-pointer/pointer-walk.ts"],"sourcesContent":["import { parseRefPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\nimport { followRefs, isJsonObject } from \"./generated-shape.js\";\n\n/** The parts of a `$ref` pointer that both the original and the new types walk. */\n\nexport interface RefPointer {\n  readonly rootSegment: string;\n  /** The segments after the root: `#/components/schemas/A` gives `[\"schemas\", \"A\"]`. */\n  readonly segments: readonly string[];\n}\n\n/** Roots whose generated type is keyed by one segment: the path or webhook name. */\nconst NAMED_ROOTS: ReadonlySet<string> = new Set([\"paths\", \"webhooks\"]);\n\n/**\n * How many segments after the root index the generated root type directly: one for `paths` and\n * `webhooks` (`paths[\"/a\"]`, so the path item's own `parameters/0` is walked), two otherwise\n * (`components[\"schemas\"][\"A\"]`).\n */\nexport function leadingSegmentsOf(pointer: RefPointer): number {\n  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;\n}\n\nexport function refPointerOf(ref: string): RefPointer | null {\n  const [rootSegment, ...segments] = parseRefPointer(ref);\n  return rootSegment === undefined ? null : { rootSegment, segments };\n}\n\n/** The document node at the end of the leading segments, `$ref`s followed. */\nexport function leadingNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {\n    node = isJsonObject(node) ? followRefs(node[segment], refs) : undefined;\n  }\n  return node;\n}\n\n/** The node at the whole pointer, without following a `$ref` at its end. */\nexport function pointerNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  pointer.segments.forEach((segment, index) => {\n    const child = isJsonObject(node) || Array.isArray(node) ? (node as never)[segment] : undefined;\n    node = index === pointer.segments.length - 1 ? child : followRefs(child, refs);\n  });\n  return node;\n}\n\n/** Whether the leading segments name a component schema, so the walk starts inside a schema. */\nexport function startsInSchema(pointer: RefPointer): boolean {\n  return pointer.rootSegment === \"components\" && pointer.segments[0] === \"schemas\";\n}\n\n/**\n * Whether the container at `index` is typed as its `schema`: a media type\n * (`content/<media type>`), a header (`headers/<name>`) or a component parameter.\n */\nexport function isTypedAsSchema(pointer: RefPointer, index: number): boolean {\n  const owner = pointer.segments[index - 2];\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && owner === \"parameters\";\n  return owner === \"content\" || owner === \"headers\" || isComponentParameter;\n}\n\n/**\n * Whether the segment at `index` is an operation's or path item's `parameters` list, indexed by\n * position next. The generated type groups parameters by `in` (`query`, `path`), so it has no\n * member `0`.\n */\nexport function isParameterList(pointer: RefPointer, index: number): boolean {\n  const next = pointer.segments[index + 1] ?? \"\";\n  return pointer.segments[index] === \"parameters\" && /^\\d+$/.test(next);\n}\n\n/**\n * Whether the segment at `index` names a response header that is an optional member: one the\n * response lists without `required: true`. A `$ref` header counts as required, as the generated\n * type has it; a component header (`components/headers/<name>`) is a member of its own.\n */\nexport function isOptionalHeader(pointer: RefPointer, index: number, headers: unknown): boolean {\n  const isComponentHeader = pointer.rootSegment === \"components\" && index === 1;\n  if (pointer.segments[index - 1] !== \"headers\" || isComponentHeader || !isJsonObject(headers)) {\n    return false;\n  }\n  const header = headers[pointer.segments[index] as string];\n  return isJsonObject(header) && header.$ref === undefined && header.required !== true;\n}\n\n/** A `requestBody` the operation does not mark `required` is an optional member. */\nexport function isOptionalRequestBody(container: unknown, refs: RefResolver): boolean {\n  if (!isJsonObject(container) || container.requestBody === undefined) {\n    return false;\n  }\n  const body = followRefs(container.requestBody, refs);\n  return !(isJsonObject(body) && body.required === true);\n}\n"],"names":["parseRefPointer","isJsonObject","followRefs"],"mappings":"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"}
+{"version":3,"file":"pointer-walk.cjs","sources":["../../../../src/application/transform/ref-pointer/pointer-walk.ts"],"sourcesContent":["import { placeOf } from \"../../../domain/openapi/document-places.js\";\nimport { parseRefPointer, ROOT_POINTER } from \"../../../domain/openapi/json-pointer.js\";\nimport { QUERYSTRING_LOCATION } from \"../../../domain/openapi/parameter-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport {\n  childLocation,\n  followLocated,\n  followRefs,\n  isJsonObject,\n  type LocatedNode,\n} from \"./located-node.js\";\n\n/** The parts of a `$ref` pointer that both the original and the new types walk. */\n\nexport interface RefPointer {\n  readonly rootSegment: string;\n  /** The segments after the root: `#/components/schemas/A` gives `[\"schemas\", \"A\"]`. */\n  readonly segments: readonly string[];\n}\n\n/** Roots whose generated type is keyed by one segment: the path or webhook name. */\nconst NAMED_ROOTS: ReadonlySet<string> = new Set([\"paths\", \"webhooks\"]);\n\n/**\n * How many segments after the root index the generated root type directly: one for `paths` and\n * `webhooks` (`paths[\"/a\"]`, so the path item's own `parameters/0` is walked), two otherwise\n * (`components[\"schemas\"][\"A\"]`).\n */\nexport function leadingSegmentsOf(pointer: RefPointer): number {\n  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;\n}\n\nexport function refPointerOf(ref: string): RefPointer | null {\n  const [rootSegment, ...segments] = parseRefPointer(ref);\n  return rootSegment === undefined ? null : { rootSegment, segments };\n}\n\n/** The document node at the end of the leading segments, `$ref`s followed, with its location. */\nexport function leadingLocated(pointer: RefPointer, refs: RefResolver): LocatedNode {\n  let located: LocatedNode = {\n    node: refs.resolve(`#/${pointer.rootSegment}`),\n    location: childLocation(ROOT_POINTER, pointer.rootSegment),\n  };\n  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {\n    const { node, location } = located;\n    const child = isJsonObject(node) ? node[segment] : undefined;\n    located = followLocated({ node: child, location: childLocation(location, segment) }, refs);\n  }\n  return located;\n}\n\n/** The node at the whole pointer, without following a `$ref` at its end. */\nexport function pointerNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  pointer.segments.forEach((segment, index) => {\n    const child = isJsonObject(node) || Array.isArray(node) ? (node as never)[segment] : undefined;\n    node = index === pointer.segments.length - 1 ? child : followRefs(child, refs);\n  });\n  return node;\n}\n\n/** Whether the leading segments name a component schema, so the walk starts inside a schema. */\nexport function startsInSchema(pointer: RefPointer): boolean {\n  return pointer.rootSegment === \"components\" && pointer.segments[0] === \"schemas\";\n}\n\n/**\n * Whether the container at `index` is typed as its `schema`: a media type\n * (`content/<media type>`), a header (`headers/<name>`) or a component parameter.\n */\nexport function isTypedAsSchema(pointer: RefPointer, index: number): boolean {\n  const owner = pointer.segments[index - 2];\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && owner === \"parameters\";\n  return owner === \"content\" || owner === \"headers\" || isComponentParameter;\n}\n\n/**\n * How the generated type of a header or component parameter holds its `content` (header.ts,\n * parameter.ts): one member per media type, the type of the first media type, `string` (a\n * parameter without the `parameter-header-content` fix), or not at all (a `schema` wins).\n */\nexport type ContentForm = \"media-type-members\" | \"first-media-type\" | \"string\" | \"schema\";\n\n/**\n * The form of the `content` at `index` when it belongs to a header or a component parameter; null\n * for any other segment. An `in: querystring` parameter is typed by its `content` even next to a\n * `schema`.\n */\nexport function headerParameterContentForm(\n  pointer: RefPointer,\n  index: number,\n  owner: unknown,\n  options: SchemaOptions,\n): ContentForm | null {\n  const isHeader = pointer.segments[index - 2] === \"headers\";\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && pointer.segments[0] === \"parameters\";\n  const isOwnContent = pointer.segments[index] === \"content\" && (isHeader || isComponentParameter);\n  if (!isOwnContent || !isJsonObject(owner)) {\n    return null;\n  }\n  const isFixed = options.fixes.has(FIX.PARAMETER_HEADER_CONTENT);\n  if (isHeader) {\n    if (owner.schema) {\n      return \"schema\";\n    }\n    return isFixed ? \"first-media-type\" : \"media-type-members\";\n  }\n  if (owner.in === QUERYSTRING_LOCATION) {\n    return \"first-media-type\";\n  }\n  if (owner.schema !== undefined) {\n    return \"schema\";\n  }\n  return isFixed ? \"first-media-type\" : \"string\";\n}\n\n/**\n * Whether the segment at `index` is an operation's or path item's `parameters` list, indexed by\n * position next. The generated type groups parameters by `in` (`query`, `path`), so it has no\n * member `0`.\n */\nexport function isParameterList(pointer: RefPointer, index: number): boolean {\n  const next = pointer.segments[index + 1] ?? \"\";\n  return pointer.segments[index] === \"parameters\" && /^\\d+$/.test(next);\n}\n\n/**\n * Whether the segment at `index` names a response header that is an optional member: one the\n * response lists without `required: true`. A `$ref` header counts as required, as the generated\n * type has it; a component header (`components/headers/<name>`) is a member of its own.\n */\nexport function isOptionalHeader(pointer: RefPointer, index: number, headers: unknown): boolean {\n  const isComponentHeader = pointer.rootSegment === \"components\" && index === 1;\n  if (pointer.segments[index - 1] !== \"headers\" || isComponentHeader || !isJsonObject(headers)) {\n    return false;\n  }\n  const header = headers[pointer.segments[index] as string];\n  return isJsonObject(header) && header.$ref === undefined && header.required !== true;\n}\n\n/**\n * Whether the segment at `index` names an operation that `--exclude-deprecated` leaves out: the\n * path item types it `never`, which has no member to index (`isIncludedOperation`).\n */\nexport function isExcludedOperation(\n  pointer: RefPointer,\n  index: number,\n  pathItem: unknown,\n  input: { readonly options: SchemaOptions; readonly refs: RefResolver },\n): boolean {\n  const segments = [pointer.rootSegment, ...pointer.segments.slice(0, index + 1)];\n  if (!input.options.excludeDeprecated || placeOf(segments) !== \"operation\") {\n    return false;\n  }\n  const segment = pointer.segments[index] as string;\n  const operation = isJsonObject(pathItem) ? followRefs(pathItem[segment], input.refs) : undefined;\n  return isJsonObject(operation) && Boolean(operation.deprecated);\n}\n\n/** A `requestBody` the operation does not mark `required` is an optional member. */\nexport function isOptionalRequestBody(container: unknown, refs: RefResolver): boolean {\n  if (!isJsonObject(container) || container.requestBody === undefined) {\n    return false;\n  }\n  const body = followRefs(container.requestBody, refs);\n  return !(isJsonObject(body) && body.required === true);\n}\n"],"names":["parseRefPointer","childLocation","ROOT_POINTER","isJsonObject","followLocated","followRefs","FIX","QUERYSTRING_LOCATION","placeOf"],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-walk.mjs

@@ -1,5 +1,8 @@
-import { parseRefPointer } from '../../../domain/openapi/json-pointer.mjs';
-import { isJsonObject, followRefs } from './generated-shape.mjs';
+import { placeOf } from '../../../domain/openapi/document-places.mjs';
+import { parseRefPointer, ROOT_POINTER } from '../../../domain/openapi/json-pointer.mjs';
+import { QUERYSTRING_LOCATION } from '../../../domain/openapi/parameter-object.mjs';
+import { FIX } from '../../../domain/output-fixes.mjs';
+import { childLocation, isJsonObject, followLocated, followRefs } from './located-node.mjs';
 
 const NAMED_ROOTS = /* @__PURE__ */ new Set(["paths", "webhooks"]);
 function leadingSegmentsOf(pointer) {
@@ -9,12 +12,17 @@ function refPointerOf(ref) {
   const [rootSegment, ...segments] = parseRefPointer(ref);
   return rootSegment === void 0 ? null : { rootSegment, segments };
 }
-function leadingNode(pointer, refs) {
-  let node = refs.resolve(`#/${pointer.rootSegment}`);
+function leadingLocated(pointer, refs) {
+  let located = {
+    node: refs.resolve(`#/${pointer.rootSegment}`),
+    location: childLocation(ROOT_POINTER, pointer.rootSegment)
+  };
   for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {
-    node = isJsonObject(node) ? followRefs(node[segment], refs) : void 0;
+    const { node, location } = located;
+    const child = isJsonObject(node) ? node[segment] : void 0;
+    located = followLocated({ node: child, location: childLocation(location, segment) }, refs);
   }
-  return node;
+  return located;
 }
 function pointerNode(pointer, refs) {
   let node = refs.resolve(`#/${pointer.rootSegment}`);
@@ -32,6 +40,28 @@ function isTypedAsSchema(pointer, index) {
   const isComponentParameter = pointer.rootSegment === "components" && index === 2 && owner === "parameters";
   return owner === "content" || owner === "headers" || isComponentParameter;
 }
+function headerParameterContentForm(pointer, index, owner, options) {
+  const isHeader = pointer.segments[index - 2] === "headers";
+  const isComponentParameter = pointer.rootSegment === "components" && index === 2 && pointer.segments[0] === "parameters";
+  const isOwnContent = pointer.segments[index] === "content" && (isHeader || isComponentParameter);
+  if (!isOwnContent || !isJsonObject(owner)) {
+    return null;
+  }
+  const isFixed = options.fixes.has(FIX.PARAMETER_HEADER_CONTENT);
+  if (isHeader) {
+    if (owner.schema) {
+      return "schema";
+    }
+    return isFixed ? "first-media-type" : "media-type-members";
+  }
+  if (owner.in === QUERYSTRING_LOCATION) {
+    return "first-media-type";
+  }
+  if (owner.schema !== void 0) {
+    return "schema";
+  }
+  return isFixed ? "first-media-type" : "string";
+}
 function isParameterList(pointer, index) {
   const next = pointer.segments[index + 1] ?? "";
   return pointer.segments[index] === "parameters" && /^\d+$/.test(next);
@@ -44,6 +74,15 @@ function isOptionalHeader(pointer, index, headers) {
   const header = headers[pointer.segments[index]];
   return isJsonObject(header) && header.$ref === void 0 && header.required !== true;
 }
+function isExcludedOperation(pointer, index, pathItem, input) {
+  const segments = [pointer.rootSegment, ...pointer.segments.slice(0, index + 1)];
+  if (!input.options.excludeDeprecated || placeOf(segments) !== "operation") {
+    return false;
+  }
+  const segment = pointer.segments[index];
+  const operation = isJsonObject(pathItem) ? followRefs(pathItem[segment], input.refs) : void 0;
+  return isJsonObject(operation) && Boolean(operation.deprecated);
+}
 function isOptionalRequestBody(container, refs) {
   if (!isJsonObject(container) || container.requestBody === void 0) {
     return false;
@@ -52,5 +91,5 @@ function isOptionalRequestBody(container, refs) {
   return !(isJsonObject(body) && body.required === true);
 }
 
-export { isOptionalHeader, isOptionalRequestBody, isParameterList, isTypedAsSchema, leadingNode, leadingSegmentsOf, pointerNode, refPointerOf, startsInSchema };
+export { headerParameterContentForm, isExcludedOperation, isOptionalHeader, isOptionalRequestBody, isParameterList, isTypedAsSchema, leadingLocated, leadingSegmentsOf, pointerNode, refPointerOf, startsInSchema };
 //# sourceMappingURL=pointer-walk.mjs.map

package/dist/application/transform/ref-pointer/pointer-walk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-walk.mjs","sources":["../../../../src/application/transform/ref-pointer/pointer-walk.ts"],"sourcesContent":["import { parseRefPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\nimport { followRefs, isJsonObject } from \"./generated-shape.js\";\n\n/** The parts of a `$ref` pointer that both the original and the new types walk. */\n\nexport interface RefPointer {\n  readonly rootSegment: string;\n  /** The segments after the root: `#/components/schemas/A` gives `[\"schemas\", \"A\"]`. */\n  readonly segments: readonly string[];\n}\n\n/** Roots whose generated type is keyed by one segment: the path or webhook name. */\nconst NAMED_ROOTS: ReadonlySet<string> = new Set([\"paths\", \"webhooks\"]);\n\n/**\n * How many segments after the root index the generated root type directly: one for `paths` and\n * `webhooks` (`paths[\"/a\"]`, so the path item's own `parameters/0` is walked), two otherwise\n * (`components[\"schemas\"][\"A\"]`).\n */\nexport function leadingSegmentsOf(pointer: RefPointer): number {\n  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;\n}\n\nexport function refPointerOf(ref: string): RefPointer | null {\n  const [rootSegment, ...segments] = parseRefPointer(ref);\n  return rootSegment === undefined ? null : { rootSegment, segments };\n}\n\n/** The document node at the end of the leading segments, `$ref`s followed. */\nexport function leadingNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {\n    node = isJsonObject(node) ? followRefs(node[segment], refs) : undefined;\n  }\n  return node;\n}\n\n/** The node at the whole pointer, without following a `$ref` at its end. */\nexport function pointerNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  pointer.segments.forEach((segment, index) => {\n    const child = isJsonObject(node) || Array.isArray(node) ? (node as never)[segment] : undefined;\n    node = index === pointer.segments.length - 1 ? child : followRefs(child, refs);\n  });\n  return node;\n}\n\n/** Whether the leading segments name a component schema, so the walk starts inside a schema. */\nexport function startsInSchema(pointer: RefPointer): boolean {\n  return pointer.rootSegment === \"components\" && pointer.segments[0] === \"schemas\";\n}\n\n/**\n * Whether the container at `index` is typed as its `schema`: a media type\n * (`content/<media type>`), a header (`headers/<name>`) or a component parameter.\n */\nexport function isTypedAsSchema(pointer: RefPointer, index: number): boolean {\n  const owner = pointer.segments[index - 2];\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && owner === \"parameters\";\n  return owner === \"content\" || owner === \"headers\" || isComponentParameter;\n}\n\n/**\n * Whether the segment at `index` is an operation's or path item's `parameters` list, indexed by\n * position next. The generated type groups parameters by `in` (`query`, `path`), so it has no\n * member `0`.\n */\nexport function isParameterList(pointer: RefPointer, index: number): boolean {\n  const next = pointer.segments[index + 1] ?? \"\";\n  return pointer.segments[index] === \"parameters\" && /^\\d+$/.test(next);\n}\n\n/**\n * Whether the segment at `index` names a response header that is an optional member: one the\n * response lists without `required: true`. A `$ref` header counts as required, as the generated\n * type has it; a component header (`components/headers/<name>`) is a member of its own.\n */\nexport function isOptionalHeader(pointer: RefPointer, index: number, headers: unknown): boolean {\n  const isComponentHeader = pointer.rootSegment === \"components\" && index === 1;\n  if (pointer.segments[index - 1] !== \"headers\" || isComponentHeader || !isJsonObject(headers)) {\n    return false;\n  }\n  const header = headers[pointer.segments[index] as string];\n  return isJsonObject(header) && header.$ref === undefined && header.required !== true;\n}\n\n/** A `requestBody` the operation does not mark `required` is an optional member. */\nexport function isOptionalRequestBody(container: unknown, refs: RefResolver): boolean {\n  if (!isJsonObject(container) || container.requestBody === undefined) {\n    return false;\n  }\n  const body = followRefs(container.requestBody, refs);\n  return !(isJsonObject(body) && body.required === true);\n}\n"],"names":[],"mappings":";;;AAaA,MAAM,8BAAmC,IAAI,GAAA,CAAI,CAAC,OAAA,EAAS,UAAU,CAAC,CAAA;AAO/D,SAAS,kBAAkB,OAAA,EAA6B;AAC7D,EAAA,OAAO,WAAA,CAAY,GAAA,CAAI,OAAA,CAAQ,WAAW,IAAI,CAAA,GAAI,CAAA;AACpD;AAEO,SAAS,aAAa,GAAA,EAAgC;AAC3D,EAAA,MAAM,CAAC,WAAA,EAAa,GAAG,QAAQ,CAAA,GAAI,gBAAgB,GAAG,CAAA;AACtD,EAAA,OAAO,WAAA,KAAgB,MAAA,GAAY,IAAA,GAAO,EAAE,aAAa,QAAA,EAAS;AACpE;AAGO,SAAS,WAAA,CAAY,SAAqB,IAAA,EAA4B;AAC3E,EAAA,IAAI,OAAO,IAAA,CAAK,OAAA,CAAQ,CAAA,EAAA,EAAK,OAAA,CAAQ,WAAW,CAAA,CAAE,CAAA;AAClD,EAAA,KAAA,MAAW,OAAA,IAAW,QAAQ,QAAA,CAAS,KAAA,CAAM,GAAG,iBAAA,CAAkB,OAAO,CAAC,CAAA,EAAG;AAC3E,IAAA,IAAA,GAAO,YAAA,CAAa,IAAI,CAAA,GAAI,UAAA,CAAW,KAAK,OAAO,CAAA,EAAG,IAAI,CAAA,GAAI,MAAA;AAAA,EAChE;AACA,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,WAAA,CAAY,SAAqB,IAAA,EAA4B;AAC3E,EAAA,IAAI,OAAO,IAAA,CAAK,OAAA,CAAQ,CAAA,EAAA,EAAK,OAAA,CAAQ,WAAW,CAAA,CAAE,CAAA;AAClD,EAAA,OAAA,CAAQ,QAAA,CAAS,OAAA,CAAQ,CAAC,OAAA,EAAS,KAAA,KAAU;AAC3C,IAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,IAAI,CAAA,IAAK,KAAA,CAAM,QAAQ,IAAI,CAAA,GAAK,IAAA,CAAe,OAAO,CAAA,GAAI,MAAA;AACrF,IAAA,IAAA,GAAO,KAAA,KAAU,QAAQ,QAAA,CAAS,MAAA,GAAS,IAAI,KAAA,GAAQ,UAAA,CAAW,OAAO,IAAI,CAAA;AAAA,EAC/E,CAAC,CAAA;AACD,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,eAAe,OAAA,EAA8B;AAC3D,EAAA,OAAO,QAAQ,WAAA,KAAgB,YAAA,IAAgB,OAAA,CAAQ,QAAA,CAAS,CAAC,CAAA,KAAM,SAAA;AACzE;AAMO,SAAS,eAAA,CAAgB,SAAqB,KAAA,EAAwB;AAC3E,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,QAAA,CAAS,KAAA,GAAQ,CAAC,CAAA;AACxC,EAAA,MAAM,uBACJ,OAAA,CAAQ,WAAA,KAAgB,YAAA,IAAgB,KAAA,KAAU,KAAK,KAAA,KAAU,YAAA;AACnE,EAAA,OAAO,KAAA,KAAU,SAAA,IAAa,KAAA,KAAU,SAAA,IAAa,oBAAA;AACvD;AAOO,SAAS,eAAA,CAAgB,SAAqB,KAAA,EAAwB;AAC3E,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,QAAA,CAAS,KAAA,GAAQ,CAAC,CAAA,IAAK,EAAA;AAC5C,EAAA,OAAO,QAAQ,QAAA,CAAS,KAAK,MAAM,YAAA,IAAgB,OAAA,CAAQ,KAAK,IAAI,CAAA;AACtE;AAOO,SAAS,gBAAA,CAAiB,OAAA,EAAqB,KAAA,EAAe,OAAA,EAA2B;AAC9F,EAAA,MAAM,iBAAA,GAAoB,OAAA,CAAQ,WAAA,KAAgB,YAAA,IAAgB,KAAA,KAAU,CAAA;AAC5E,EAAA,IAAI,OAAA,CAAQ,QAAA,CAAS,KAAA,GAAQ,CAAC,CAAA,KAAM,aAAa,iBAAA,IAAqB,CAAC,YAAA,CAAa,OAAO,CAAA,EAAG;AAC5F,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,OAAA,CAAQ,QAAA,CAAS,KAAK,CAAW,CAAA;AACxD,EAAA,OAAO,aAAa,MAAM,CAAA,IAAK,OAAO,IAAA,KAAS,MAAA,IAAa,OAAO,QAAA,KAAa,IAAA;AAClF;AAGO,SAAS,qBAAA,CAAsB,WAAoB,IAAA,EAA4B;AACpF,EAAA,IAAI,CAAC,YAAA,CAAa,SAAS,CAAA,IAAK,SAAA,CAAU,gBAAgB,MAAA,EAAW;AACnE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,IAAA,GAAO,UAAA,CAAW,SAAA,CAAU,WAAA,EAAa,IAAI,CAAA;AACnD,EAAA,OAAO,EAAE,YAAA,CAAa,IAAI,CAAA,IAAK,KAAK,QAAA,KAAa,IAAA,CAAA;AACnD;;"}
+{"version":3,"file":"pointer-walk.mjs","sources":["../../../../src/application/transform/ref-pointer/pointer-walk.ts"],"sourcesContent":["import { placeOf } from \"../../../domain/openapi/document-places.js\";\nimport { parseRefPointer, ROOT_POINTER } from \"../../../domain/openapi/json-pointer.js\";\nimport { QUERYSTRING_LOCATION } from \"../../../domain/openapi/parameter-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport {\n  childLocation,\n  followLocated,\n  followRefs,\n  isJsonObject,\n  type LocatedNode,\n} from \"./located-node.js\";\n\n/** The parts of a `$ref` pointer that both the original and the new types walk. */\n\nexport interface RefPointer {\n  readonly rootSegment: string;\n  /** The segments after the root: `#/components/schemas/A` gives `[\"schemas\", \"A\"]`. */\n  readonly segments: readonly string[];\n}\n\n/** Roots whose generated type is keyed by one segment: the path or webhook name. */\nconst NAMED_ROOTS: ReadonlySet<string> = new Set([\"paths\", \"webhooks\"]);\n\n/**\n * How many segments after the root index the generated root type directly: one for `paths` and\n * `webhooks` (`paths[\"/a\"]`, so the path item's own `parameters/0` is walked), two otherwise\n * (`components[\"schemas\"][\"A\"]`).\n */\nexport function leadingSegmentsOf(pointer: RefPointer): number {\n  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;\n}\n\nexport function refPointerOf(ref: string): RefPointer | null {\n  const [rootSegment, ...segments] = parseRefPointer(ref);\n  return rootSegment === undefined ? null : { rootSegment, segments };\n}\n\n/** The document node at the end of the leading segments, `$ref`s followed, with its location. */\nexport function leadingLocated(pointer: RefPointer, refs: RefResolver): LocatedNode {\n  let located: LocatedNode = {\n    node: refs.resolve(`#/${pointer.rootSegment}`),\n    location: childLocation(ROOT_POINTER, pointer.rootSegment),\n  };\n  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {\n    const { node, location } = located;\n    const child = isJsonObject(node) ? node[segment] : undefined;\n    located = followLocated({ node: child, location: childLocation(location, segment) }, refs);\n  }\n  return located;\n}\n\n/** The node at the whole pointer, without following a `$ref` at its end. */\nexport function pointerNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  pointer.segments.forEach((segment, index) => {\n    const child = isJsonObject(node) || Array.isArray(node) ? (node as never)[segment] : undefined;\n    node = index === pointer.segments.length - 1 ? child : followRefs(child, refs);\n  });\n  return node;\n}\n\n/** Whether the leading segments name a component schema, so the walk starts inside a schema. */\nexport function startsInSchema(pointer: RefPointer): boolean {\n  return pointer.rootSegment === \"components\" && pointer.segments[0] === \"schemas\";\n}\n\n/**\n * Whether the container at `index` is typed as its `schema`: a media type\n * (`content/<media type>`), a header (`headers/<name>`) or a component parameter.\n */\nexport function isTypedAsSchema(pointer: RefPointer, index: number): boolean {\n  const owner = pointer.segments[index - 2];\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && owner === \"parameters\";\n  return owner === \"content\" || owner === \"headers\" || isComponentParameter;\n}\n\n/**\n * How the generated type of a header or component parameter holds its `content` (header.ts,\n * parameter.ts): one member per media type, the type of the first media type, `string` (a\n * parameter without the `parameter-header-content` fix), or not at all (a `schema` wins).\n */\nexport type ContentForm = \"media-type-members\" | \"first-media-type\" | \"string\" | \"schema\";\n\n/**\n * The form of the `content` at `index` when it belongs to a header or a component parameter; null\n * for any other segment. An `in: querystring` parameter is typed by its `content` even next to a\n * `schema`.\n */\nexport function headerParameterContentForm(\n  pointer: RefPointer,\n  index: number,\n  owner: unknown,\n  options: SchemaOptions,\n): ContentForm | null {\n  const isHeader = pointer.segments[index - 2] === \"headers\";\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && pointer.segments[0] === \"parameters\";\n  const isOwnContent = pointer.segments[index] === \"content\" && (isHeader || isComponentParameter);\n  if (!isOwnContent || !isJsonObject(owner)) {\n    return null;\n  }\n  const isFixed = options.fixes.has(FIX.PARAMETER_HEADER_CONTENT);\n  if (isHeader) {\n    if (owner.schema) {\n      return \"schema\";\n    }\n    return isFixed ? \"first-media-type\" : \"media-type-members\";\n  }\n  if (owner.in === QUERYSTRING_LOCATION) {\n    return \"first-media-type\";\n  }\n  if (owner.schema !== undefined) {\n    return \"schema\";\n  }\n  return isFixed ? \"first-media-type\" : \"string\";\n}\n\n/**\n * Whether the segment at `index` is an operation's or path item's `parameters` list, indexed by\n * position next. The generated type groups parameters by `in` (`query`, `path`), so it has no\n * member `0`.\n */\nexport function isParameterList(pointer: RefPointer, index: number): boolean {\n  const next = pointer.segments[index + 1] ?? \"\";\n  return pointer.segments[index] === \"parameters\" && /^\\d+$/.test(next);\n}\n\n/**\n * Whether the segment at `index` names a response header that is an optional member: one the\n * response lists without `required: true`. A `$ref` header counts as required, as the generated\n * type has it; a component header (`components/headers/<name>`) is a member of its own.\n */\nexport function isOptionalHeader(pointer: RefPointer, index: number, headers: unknown): boolean {\n  const isComponentHeader = pointer.rootSegment === \"components\" && index === 1;\n  if (pointer.segments[index - 1] !== \"headers\" || isComponentHeader || !isJsonObject(headers)) {\n    return false;\n  }\n  const header = headers[pointer.segments[index] as string];\n  return isJsonObject(header) && header.$ref === undefined && header.required !== true;\n}\n\n/**\n * Whether the segment at `index` names an operation that `--exclude-deprecated` leaves out: the\n * path item types it `never`, which has no member to index (`isIncludedOperation`).\n */\nexport function isExcludedOperation(\n  pointer: RefPointer,\n  index: number,\n  pathItem: unknown,\n  input: { readonly options: SchemaOptions; readonly refs: RefResolver },\n): boolean {\n  const segments = [pointer.rootSegment, ...pointer.segments.slice(0, index + 1)];\n  if (!input.options.excludeDeprecated || placeOf(segments) !== \"operation\") {\n    return false;\n  }\n  const segment = pointer.segments[index] as string;\n  const operation = isJsonObject(pathItem) ? followRefs(pathItem[segment], input.refs) : undefined;\n  return isJsonObject(operation) && Boolean(operation.deprecated);\n}\n\n/** A `requestBody` the operation does not mark `required` is an optional member. */\nexport function isOptionalRequestBody(container: unknown, refs: RefResolver): boolean {\n  if (!isJsonObject(container) || container.requestBody === undefined) {\n    return false;\n  }\n  const body = followRefs(container.requestBody, refs);\n  return !(isJsonObject(body) && body.required === true);\n}\n"],"names":[],"mappings":";;;;;;AAsBA,MAAM,8BAAmC,IAAI,GAAA,CAAI,CAAC,OAAA,EAAS,UAAU,CAAC,CAAA;AAO/D,SAAS,kBAAkB,OAAA,EAA6B;AAC7D,EAAA,OAAO,WAAA,CAAY,GAAA,CAAI,OAAA,CAAQ,WAAW,IAAI,CAAA,GAAI,CAAA;AACpD;AAEO,SAAS,aAAa,GAAA,EAAgC;AAC3D,EAAA,MAAM,CAAC,WAAA,EAAa,GAAG,QAAQ,CAAA,GAAI,gBAAgB,GAAG,CAAA;AACtD,EAAA,OAAO,WAAA,KAAgB,MAAA,GAAY,IAAA,GAAO,EAAE,aAAa,QAAA,EAAS;AACpE;AAGO,SAAS,cAAA,CAAe,SAAqB,IAAA,EAAgC;AAClF,EAAA,IAAI,OAAA,GAAuB;AAAA,IACzB,MAAM,IAAA,CAAK,OAAA,CAAQ,CAAA,EAAA,EAAK,OAAA,CAAQ,WAAW,CAAA,CAAE,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA,CAAc,YAAA,EAAc,OAAA,CAAQ,WAAW;AAAA,GAC3D;AACA,EAAA,KAAA,MAAW,OAAA,IAAW,QAAQ,QAAA,CAAS,KAAA,CAAM,GAAG,iBAAA,CAAkB,OAAO,CAAC,CAAA,EAAG;AAC3E,IAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAS,GAAI,OAAA;AAC3B,IAAA,MAAM,QAAQ,YAAA,CAAa,IAAI,CAAA,GAAI,IAAA,CAAK,OAAO,CAAA,GAAI,MAAA;AACnD,IAAA,OAAA,GAAU,aAAA,CAAc,EAAE,IAAA,EAAM,KAAA,EAAO,QAAA,EAAU,cAAc,QAAA,EAAU,OAAO,CAAA,EAAE,EAAG,IAAI,CAAA;AAAA,EAC3F;AACA,EAAA,OAAO,OAAA;AACT;AAGO,SAAS,WAAA,CAAY,SAAqB,IAAA,EAA4B;AAC3E,EAAA,IAAI,OAAO,IAAA,CAAK,OAAA,CAAQ,CAAA,EAAA,EAAK,OAAA,CAAQ,WAAW,CAAA,CAAE,CAAA;AAClD,EAAA,OAAA,CAAQ,QAAA,CAAS,OAAA,CAAQ,CAAC,OAAA,EAAS,KAAA,KAAU;AAC3C,IAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,IAAI,CAAA,IAAK,KAAA,CAAM,QAAQ,IAAI,CAAA,GAAK,IAAA,CAAe,OAAO,CAAA,GAAI,MAAA;AACrF,IAAA,IAAA,GAAO,KAAA,KAAU,QAAQ,QAAA,CAAS,MAAA,GAAS,IAAI,KAAA,GAAQ,UAAA,CAAW,OAAO,IAAI,CAAA;AAAA,EAC/E,CAAC,CAAA;AACD,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,eAAe,OAAA,EAA8B;AAC3D,EAAA,OAAO,QAAQ,WAAA,KAAgB,YAAA,IAAgB,OAAA,CAAQ,QAAA,CAAS,CAAC,CAAA,KAAM,SAAA;AACzE;AAMO,SAAS,eAAA,CAAgB,SAAqB,KAAA,EAAwB;AAC3E,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,QAAA,CAAS,KAAA,GAAQ,CAAC,CAAA;AACxC,EAAA,MAAM,uBACJ,OAAA,CAAQ,WAAA,KAAgB,YAAA,IAAgB,KAAA,KAAU,KAAK,KAAA,KAAU,YAAA;AACnE,EAAA,OAAO,KAAA,KAAU,SAAA,IAAa,KAAA,KAAU,SAAA,IAAa,oBAAA;AACvD;AAcO,SAAS,0BAAA,CACd,OAAA,EACA,KAAA,EACA,KAAA,EACA,OAAA,EACoB;AACpB,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,QAAA,CAAS,KAAA,GAAQ,CAAC,CAAA,KAAM,SAAA;AACjD,EAAA,MAAM,oBAAA,GACJ,QAAQ,WAAA,KAAgB,YAAA,IAAgB,UAAU,CAAA,IAAK,OAAA,CAAQ,QAAA,CAAS,CAAC,CAAA,KAAM,YAAA;AACjF,EAAA,MAAM,eAAe,OAAA,CAAQ,QAAA,CAAS,KAAK,CAAA,KAAM,cAAc,QAAA,IAAY,oBAAA,CAAA;AAC3E,EAAA,IAAI,CAAC,YAAA,IAAgB,CAAC,YAAA,CAAa,KAAK,CAAA,EAAG;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,KAAA,CAAM,GAAA,CAAI,IAAI,wBAAwB,CAAA;AAC9D,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,IAAI,MAAM,MAAA,EAAQ;AAChB,MAAA,OAAO,QAAA;AAAA,IACT;AACA,IAAA,OAAO,UAAU,kBAAA,GAAqB,oBAAA;AAAA,EACxC;AACA,EAAA,IAAI,KAAA,CAAM,OAAO,oBAAA,EAAsB;AACrC,IAAA,OAAO,kBAAA;AAAA,EACT;AACA,EAAA,IAAI,KAAA,CAAM,WAAW,MAAA,EAAW;AAC9B,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAO,UAAU,kBAAA,GAAqB,QAAA;AACxC;AAOO,SAAS,eAAA,CAAgB,SAAqB,KAAA,EAAwB;AAC3E,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,QAAA,CAAS,KAAA,GAAQ,CAAC,CAAA,IAAK,EAAA;AAC5C,EAAA,OAAO,QAAQ,QAAA,CAAS,KAAK,MAAM,YAAA,IAAgB,OAAA,CAAQ,KAAK,IAAI,CAAA;AACtE;AAOO,SAAS,gBAAA,CAAiB,OAAA,EAAqB,KAAA,EAAe,OAAA,EAA2B;AAC9F,EAAA,MAAM,iBAAA,GAAoB,OAAA,CAAQ,WAAA,KAAgB,YAAA,IAAgB,KAAA,KAAU,CAAA;AAC5E,EAAA,IAAI,OAAA,CAAQ,QAAA,CAAS,KAAA,GAAQ,CAAC,CAAA,KAAM,aAAa,iBAAA,IAAqB,CAAC,YAAA,CAAa,OAAO,CAAA,EAAG;AAC5F,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,OAAA,CAAQ,QAAA,CAAS,KAAK,CAAW,CAAA;AACxD,EAAA,OAAO,aAAa,MAAM,CAAA,IAAK,OAAO,IAAA,KAAS,MAAA,IAAa,OAAO,QAAA,KAAa,IAAA;AAClF;AAMO,SAAS,mBAAA,CACd,OAAA,EACA,KAAA,EACA,QAAA,EACA,KAAA,EACS;AACT,EAAA,MAAM,QAAA,GAAW,CAAC,OAAA,CAAQ,WAAA,EAAa,GAAG,OAAA,CAAQ,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,KAAA,GAAQ,CAAC,CAAC,CAAA;AAC9E,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,qBAAqB,OAAA,CAAQ,QAAQ,MAAM,WAAA,EAAa;AACzE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,QAAA,CAAS,KAAK,CAAA;AACtC,EAAA,MAAM,SAAA,GAAY,YAAA,CAAa,QAAQ,CAAA,GAAI,UAAA,CAAW,SAAS,OAAO,CAAA,EAAG,KAAA,CAAM,IAAI,CAAA,GAAI,MAAA;AACvF,EAAA,OAAO,YAAA,CAAa,SAAS,CAAA,IAAK,OAAA,CAAQ,UAAU,UAAU,CAAA;AAChE;AAGO,SAAS,qBAAA,CAAsB,WAAoB,IAAA,EAA4B;AACpF,EAAA,IAAI,CAAC,YAAA,CAAa,SAAS,CAAA,IAAK,SAAA,CAAU,gBAAgB,MAAA,EAAW;AACnE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,IAAA,GAAO,UAAA,CAAW,SAAA,CAAU,WAAA,EAAa,IAAI,CAAA;AACnD,EAAA,OAAO,EAAE,YAAA,CAAa,IAAI,CAAA,IAAK,KAAK,QAAA,KAAa,IAAA,CAAA;AACnD;;"}