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

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":"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"}
+{"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;;"}

package/dist/application/transform/ref-pointer/property-shape.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+const accessFlags = require('../schema/access-flags.cjs');
+const inputLocation = require('../schema/input-location.cjs');
+const locatedNode = require('./located-node.cjs');
+
+function isNullableSchema(node) {
+  if (!locatedNode.isJsonObject(node)) {
+    return false;
+  }
+  return node.nullable === true || Array.isArray(node.type) && node.type.includes("null");
+}
+function isOptionalProperty(owner, key, options) {
+  const { node } = owner;
+  const required = Array.isArray(node.required) ? node.required : void 0;
+  const property = node.properties[key];
+  const hasDefault = locatedNode.isJsonObject(property) && property.default !== void 0;
+  const isDefaultRequired = hasDefault && options.defaultNonNullable && !inputLocation.isInputLocation(owner.location, options.fixes);
+  const isRequired = required?.includes(key) === true || required === void 0 && options.propertiesRequiredByDefault || isDefaultRequired;
+  return !isRequired;
+}
+function isExcludedProperty(property, options, refs) {
+  const resolved = locatedNode.followRefs(property, refs);
+  return options.excludeDeprecated && locatedNode.isJsonObject(resolved) && Boolean(resolved.deprecated);
+}
+function isMarkedProperty(value, options, refs) {
+  if (!options.readWriteMarkers || !locatedNode.isJsonObject(value)) {
+    return false;
+  }
+  const flags = accessFlags.propertyAccessFlags(value, { options, refs });
+  return flags.isReadOnly !== flags.isWriteOnly;
+}
+function schemaPresence(schema, refs) {
+  return isNullableSchema(locatedNode.followRefs(schema, refs)) ? "absent" : "present";
+}
+function propertyPresence(schema, key, options, refs) {
+  const owner = locatedNode.followLocated(schema, refs);
+  const { node } = owner;
+  const properties = locatedNode.isJsonObject(node) && locatedNode.isJsonObject(node.properties) ? node.properties : {};
+  if (!locatedNode.isJsonObject(node) || !Object.hasOwn(properties, key)) {
+    return "unknown";
+  }
+  return isOptionalProperty({ ...owner, node }, key, options) ? "absent" : schemaPresence(properties[key], refs);
+}
+
+exports.isExcludedProperty = isExcludedProperty;
+exports.isMarkedProperty = isMarkedProperty;
+exports.isNullableSchema = isNullableSchema;
+exports.isOptionalProperty = isOptionalProperty;
+exports.propertyPresence = propertyPresence;
+exports.schemaPresence = schemaPresence;
+//# sourceMappingURL=property-shape.cjs.map

package/dist/application/transform/ref-pointer/property-shape.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-shape.cjs","sources":["../../../../src/application/transform/ref-pointer/property-shape.ts"],"sourcesContent":["import type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { propertyAccessFlags } from \"../schema/access-flags.js\";\nimport { isInputLocation } from \"../schema/input-location.js\";\nimport type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport {\n  followLocated,\n  followRefs,\n  isJsonObject,\n  type JsonObject,\n  type LocatedNode,\n} from \"./located-node.js\";\n\n/**\n * What the generated type of an object schema makes of one of its properties: optional, left\n * out, wrapped in a read or write marker, or a value that may be `undefined` or `null`.\n */\n\n/** `nullable: true` or a `type` list with `null`: the generated type includes `null`. */\nexport function isNullableSchema(node: unknown): boolean {\n  if (!isJsonObject(node)) {\n    return false;\n  }\n  return node.nullable === true || (Array.isArray(node.type) && node.type.includes(\"null\"));\n}\n\n/**\n * Whether the generated type has the property as optional, as `objectType` decides: a `default`\n * makes a property required except in an input location, where the client may leave it out.\n */\nexport function isOptionalProperty(\n  owner: LocatedNode & { node: JsonObject },\n  key: string,\n  options: SchemaOptions,\n): boolean {\n  const { node } = owner;\n  const required = Array.isArray(node.required) ? node.required : undefined;\n  const property = (node.properties as JsonObject)[key];\n  const hasDefault = isJsonObject(property) && property.default !== undefined;\n  const isDefaultRequired =\n    hasDefault && options.defaultNonNullable && !isInputLocation(owner.location, options.fixes);\n  const isRequired =\n    required?.includes(key) === true ||\n    (required === undefined && options.propertiesRequiredByDefault) ||\n    isDefaultRequired;\n  return !isRequired;\n}\n\n/**\n * Whether `--exclude-deprecated` leaves the property out: its object, or the one its `$ref`\n * names, is deprecated (`objectType`). The key is then not in the generated type at all.\n */\nexport function isExcludedProperty(\n  property: unknown,\n  options: SchemaOptions,\n  refs: RefResolver,\n): boolean {\n  const resolved = followRefs(property, refs);\n  return options.excludeDeprecated && isJsonObject(resolved) && Boolean(resolved.deprecated);\n}\n\n/**\n * Whether `--read-write-markers` wraps the type of a property or `$defs` member: one that is only\n * `readOnly` or only `writeOnly` is `$Read<T>` or `$Write<T>` (object-type.ts).\n */\nexport function isMarkedProperty(value: unknown, options: SchemaOptions, refs: RefResolver) {\n  if (!options.readWriteMarkers || !isJsonObject(value)) {\n    return false;\n  }\n  const flags = propertyAccessFlags(value as Schema, { options, refs });\n  return flags.isReadOnly !== flags.isWriteOnly;\n}\n\n/** Whether a value is there: `present`, `absent` (may be `undefined` or `null`) or `unknown`. */\nexport type Presence = \"present\" | \"absent\" | \"unknown\";\n\n/** The presence of a value of `schema` itself: `absent` when its type includes `null`. */\nexport function schemaPresence(schema: unknown, refs: RefResolver): Presence {\n  return isNullableSchema(followRefs(schema, refs)) ? \"absent\" : \"present\";\n}\n\n/** The presence of property `key` of `schema`: optional or nullable is `absent`. */\nexport function propertyPresence(\n  schema: LocatedNode,\n  key: string,\n  options: SchemaOptions,\n  refs: RefResolver,\n): Presence {\n  const owner = followLocated(schema, refs);\n  const { node } = owner;\n  const properties = isJsonObject(node) && isJsonObject(node.properties) ? node.properties : {};\n  if (!isJsonObject(node) || !Object.hasOwn(properties, key)) {\n    return \"unknown\";\n  }\n  return isOptionalProperty({ ...owner, node }, key, options)\n    ? \"absent\"\n    : schemaPresence(properties[key], refs);\n}\n"],"names":["isJsonObject","isInputLocation","followRefs","propertyAccessFlags","followLocated"],"mappings":";;;;;;AAkBO,SAAS,iBAAiB,IAAA,EAAwB;AACvD,EAAA,IAAI,CAACA,wBAAA,CAAa,IAAI,CAAA,EAAG;AACvB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA,CAAK,QAAA,KAAa,IAAA,IAAS,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,IAAK,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA;AACzF;AAMO,SAAS,kBAAA,CACd,KAAA,EACA,GAAA,EACA,OAAA,EACS;AACT,EAAA,MAAM,EAAE,MAAK,GAAI,KAAA;AACjB,EAAA,MAAM,WAAW,KAAA,CAAM,OAAA,CAAQ,KAAK,QAAQ,CAAA,GAAI,KAAK,QAAA,GAAW,MAAA;AAChE,EAAA,MAAM,QAAA,GAAY,IAAA,CAAK,UAAA,CAA0B,GAAG,CAAA;AACpD,EAAA,MAAM,UAAA,GAAaA,wBAAA,CAAa,QAAQ,CAAA,IAAK,SAAS,OAAA,KAAY,MAAA;AAClE,EAAA,MAAM,iBAAA,GACJ,cAAc,OAAA,CAAQ,kBAAA,IAAsB,CAACC,6BAAA,CAAgB,KAAA,CAAM,QAAA,EAAU,OAAA,CAAQ,KAAK,CAAA;AAC5F,EAAA,MAAM,UAAA,GACJ,UAAU,QAAA,CAAS,GAAG,MAAM,IAAA,IAC3B,QAAA,KAAa,MAAA,IAAa,OAAA,CAAQ,2BAAA,IACnC,iBAAA;AACF,EAAA,OAAO,CAAC,UAAA;AACV;AAMO,SAAS,kBAAA,CACd,QAAA,EACA,OAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,QAAA,GAAWC,sBAAA,CAAW,QAAA,EAAU,IAAI,CAAA;AAC1C,EAAA,OAAO,QAAQ,iBAAA,IAAqBF,wBAAA,CAAa,QAAQ,CAAA,IAAK,OAAA,CAAQ,SAAS,UAAU,CAAA;AAC3F;AAMO,SAAS,gBAAA,CAAiB,KAAA,EAAgB,OAAA,EAAwB,IAAA,EAAmB;AAC1F,EAAA,IAAI,CAAC,OAAA,CAAQ,gBAAA,IAAoB,CAACA,wBAAA,CAAa,KAAK,CAAA,EAAG;AACrD,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,QAAQG,+BAAA,CAAoB,KAAA,EAAiB,EAAE,OAAA,EAAS,MAAM,CAAA;AACpE,EAAA,OAAO,KAAA,CAAM,eAAe,KAAA,CAAM,WAAA;AACpC;AAMO,SAAS,cAAA,CAAe,QAAiB,IAAA,EAA6B;AAC3E,EAAA,OAAO,iBAAiBD,sBAAA,CAAW,MAAA,EAAQ,IAAI,CAAC,IAAI,QAAA,GAAW,SAAA;AACjE;AAGO,SAAS,gBAAA,CACd,MAAA,EACA,GAAA,EACA,OAAA,EACA,IAAA,EACU;AACV,EAAA,MAAM,KAAA,GAAQE,yBAAA,CAAc,MAAA,EAAQ,IAAI,CAAA;AACxC,EAAA,MAAM,EAAE,MAAK,GAAI,KAAA;AACjB,EAAA,MAAM,UAAA,GAAaJ,wBAAA,CAAa,IAAI,CAAA,IAAKA,wBAAA,CAAa,KAAK,UAAU,CAAA,GAAI,IAAA,CAAK,UAAA,GAAa,EAAC;AAC5F,EAAA,IAAI,CAACA,yBAAa,IAAI,CAAA,IAAK,CAAC,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,GAAG,CAAA,EAAG;AAC1D,IAAA,OAAO,SAAA;AAAA,EACT;AACA,EAAA,OAAO,kBAAA,CAAmB,EAAE,GAAG,KAAA,EAAO,MAAK,EAAG,GAAA,EAAK,OAAO,CAAA,GACtD,QAAA,GACA,cAAA,CAAe,UAAA,CAAW,GAAG,GAAG,IAAI,CAAA;AAC1C;;;;;;;"}

package/dist/application/transform/ref-pointer/property-shape.mjs

@@ -0,0 +1,45 @@
+import { propertyAccessFlags } from '../schema/access-flags.mjs';
+import { isInputLocation } from '../schema/input-location.mjs';
+import { followRefs, isJsonObject, followLocated } from './located-node.mjs';
+
+function isNullableSchema(node) {
+  if (!isJsonObject(node)) {
+    return false;
+  }
+  return node.nullable === true || Array.isArray(node.type) && node.type.includes("null");
+}
+function isOptionalProperty(owner, key, options) {
+  const { node } = owner;
+  const required = Array.isArray(node.required) ? node.required : void 0;
+  const property = node.properties[key];
+  const hasDefault = isJsonObject(property) && property.default !== void 0;
+  const isDefaultRequired = hasDefault && options.defaultNonNullable && !isInputLocation(owner.location, options.fixes);
+  const isRequired = required?.includes(key) === true || required === void 0 && options.propertiesRequiredByDefault || isDefaultRequired;
+  return !isRequired;
+}
+function isExcludedProperty(property, options, refs) {
+  const resolved = followRefs(property, refs);
+  return options.excludeDeprecated && isJsonObject(resolved) && Boolean(resolved.deprecated);
+}
+function isMarkedProperty(value, options, refs) {
+  if (!options.readWriteMarkers || !isJsonObject(value)) {
+    return false;
+  }
+  const flags = propertyAccessFlags(value, { options, refs });
+  return flags.isReadOnly !== flags.isWriteOnly;
+}
+function schemaPresence(schema, refs) {
+  return isNullableSchema(followRefs(schema, refs)) ? "absent" : "present";
+}
+function propertyPresence(schema, key, options, refs) {
+  const owner = followLocated(schema, refs);
+  const { node } = owner;
+  const properties = isJsonObject(node) && isJsonObject(node.properties) ? node.properties : {};
+  if (!isJsonObject(node) || !Object.hasOwn(properties, key)) {
+    return "unknown";
+  }
+  return isOptionalProperty({ ...owner, node }, key, options) ? "absent" : schemaPresence(properties[key], refs);
+}
+
+export { isExcludedProperty, isMarkedProperty, isNullableSchema, isOptionalProperty, propertyPresence, schemaPresence };
+//# sourceMappingURL=property-shape.mjs.map

package/dist/application/transform/ref-pointer/property-shape.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-shape.mjs","sources":["../../../../src/application/transform/ref-pointer/property-shape.ts"],"sourcesContent":["import type { Schema } from \"../../../domain/openapi/schema-object.js\";\nimport { propertyAccessFlags } from \"../schema/access-flags.js\";\nimport { isInputLocation } from \"../schema/input-location.js\";\nimport type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport {\n  followLocated,\n  followRefs,\n  isJsonObject,\n  type JsonObject,\n  type LocatedNode,\n} from \"./located-node.js\";\n\n/**\n * What the generated type of an object schema makes of one of its properties: optional, left\n * out, wrapped in a read or write marker, or a value that may be `undefined` or `null`.\n */\n\n/** `nullable: true` or a `type` list with `null`: the generated type includes `null`. */\nexport function isNullableSchema(node: unknown): boolean {\n  if (!isJsonObject(node)) {\n    return false;\n  }\n  return node.nullable === true || (Array.isArray(node.type) && node.type.includes(\"null\"));\n}\n\n/**\n * Whether the generated type has the property as optional, as `objectType` decides: a `default`\n * makes a property required except in an input location, where the client may leave it out.\n */\nexport function isOptionalProperty(\n  owner: LocatedNode & { node: JsonObject },\n  key: string,\n  options: SchemaOptions,\n): boolean {\n  const { node } = owner;\n  const required = Array.isArray(node.required) ? node.required : undefined;\n  const property = (node.properties as JsonObject)[key];\n  const hasDefault = isJsonObject(property) && property.default !== undefined;\n  const isDefaultRequired =\n    hasDefault && options.defaultNonNullable && !isInputLocation(owner.location, options.fixes);\n  const isRequired =\n    required?.includes(key) === true ||\n    (required === undefined && options.propertiesRequiredByDefault) ||\n    isDefaultRequired;\n  return !isRequired;\n}\n\n/**\n * Whether `--exclude-deprecated` leaves the property out: its object, or the one its `$ref`\n * names, is deprecated (`objectType`). The key is then not in the generated type at all.\n */\nexport function isExcludedProperty(\n  property: unknown,\n  options: SchemaOptions,\n  refs: RefResolver,\n): boolean {\n  const resolved = followRefs(property, refs);\n  return options.excludeDeprecated && isJsonObject(resolved) && Boolean(resolved.deprecated);\n}\n\n/**\n * Whether `--read-write-markers` wraps the type of a property or `$defs` member: one that is only\n * `readOnly` or only `writeOnly` is `$Read<T>` or `$Write<T>` (object-type.ts).\n */\nexport function isMarkedProperty(value: unknown, options: SchemaOptions, refs: RefResolver) {\n  if (!options.readWriteMarkers || !isJsonObject(value)) {\n    return false;\n  }\n  const flags = propertyAccessFlags(value as Schema, { options, refs });\n  return flags.isReadOnly !== flags.isWriteOnly;\n}\n\n/** Whether a value is there: `present`, `absent` (may be `undefined` or `null`) or `unknown`. */\nexport type Presence = \"present\" | \"absent\" | \"unknown\";\n\n/** The presence of a value of `schema` itself: `absent` when its type includes `null`. */\nexport function schemaPresence(schema: unknown, refs: RefResolver): Presence {\n  return isNullableSchema(followRefs(schema, refs)) ? \"absent\" : \"present\";\n}\n\n/** The presence of property `key` of `schema`: optional or nullable is `absent`. */\nexport function propertyPresence(\n  schema: LocatedNode,\n  key: string,\n  options: SchemaOptions,\n  refs: RefResolver,\n): Presence {\n  const owner = followLocated(schema, refs);\n  const { node } = owner;\n  const properties = isJsonObject(node) && isJsonObject(node.properties) ? node.properties : {};\n  if (!isJsonObject(node) || !Object.hasOwn(properties, key)) {\n    return \"unknown\";\n  }\n  return isOptionalProperty({ ...owner, node }, key, options)\n    ? \"absent\"\n    : schemaPresence(properties[key], refs);\n}\n"],"names":[],"mappings":";;;;AAkBO,SAAS,iBAAiB,IAAA,EAAwB;AACvD,EAAA,IAAI,CAAC,YAAA,CAAa,IAAI,CAAA,EAAG;AACvB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA,CAAK,QAAA,KAAa,IAAA,IAAS,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,IAAK,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA;AACzF;AAMO,SAAS,kBAAA,CACd,KAAA,EACA,GAAA,EACA,OAAA,EACS;AACT,EAAA,MAAM,EAAE,MAAK,GAAI,KAAA;AACjB,EAAA,MAAM,WAAW,KAAA,CAAM,OAAA,CAAQ,KAAK,QAAQ,CAAA,GAAI,KAAK,QAAA,GAAW,MAAA;AAChE,EAAA,MAAM,QAAA,GAAY,IAAA,CAAK,UAAA,CAA0B,GAAG,CAAA;AACpD,EAAA,MAAM,UAAA,GAAa,YAAA,CAAa,QAAQ,CAAA,IAAK,SAAS,OAAA,KAAY,MAAA;AAClE,EAAA,MAAM,iBAAA,GACJ,cAAc,OAAA,CAAQ,kBAAA,IAAsB,CAAC,eAAA,CAAgB,KAAA,CAAM,QAAA,EAAU,OAAA,CAAQ,KAAK,CAAA;AAC5F,EAAA,MAAM,UAAA,GACJ,UAAU,QAAA,CAAS,GAAG,MAAM,IAAA,IAC3B,QAAA,KAAa,MAAA,IAAa,OAAA,CAAQ,2BAAA,IACnC,iBAAA;AACF,EAAA,OAAO,CAAC,UAAA;AACV;AAMO,SAAS,kBAAA,CACd,QAAA,EACA,OAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,QAAA,GAAW,UAAA,CAAW,QAAA,EAAU,IAAI,CAAA;AAC1C,EAAA,OAAO,QAAQ,iBAAA,IAAqB,YAAA,CAAa,QAAQ,CAAA,IAAK,OAAA,CAAQ,SAAS,UAAU,CAAA;AAC3F;AAMO,SAAS,gBAAA,CAAiB,KAAA,EAAgB,OAAA,EAAwB,IAAA,EAAmB;AAC1F,EAAA,IAAI,CAAC,OAAA,CAAQ,gBAAA,IAAoB,CAAC,YAAA,CAAa,KAAK,CAAA,EAAG;AACrD,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,QAAQ,mBAAA,CAAoB,KAAA,EAAiB,EAAE,OAAA,EAAS,MAAM,CAAA;AACpE,EAAA,OAAO,KAAA,CAAM,eAAe,KAAA,CAAM,WAAA;AACpC;AAMO,SAAS,cAAA,CAAe,QAAiB,IAAA,EAA6B;AAC3E,EAAA,OAAO,iBAAiB,UAAA,CAAW,MAAA,EAAQ,IAAI,CAAC,IAAI,QAAA,GAAW,SAAA;AACjE;AAGO,SAAS,gBAAA,CACd,MAAA,EACA,GAAA,EACA,OAAA,EACA,IAAA,EACU;AACV,EAAA,MAAM,KAAA,GAAQ,aAAA,CAAc,MAAA,EAAQ,IAAI,CAAA;AACxC,EAAA,MAAM,EAAE,MAAK,GAAI,KAAA;AACjB,EAAA,MAAM,UAAA,GAAa,YAAA,CAAa,IAAI,CAAA,IAAK,YAAA,CAAa,KAAK,UAAU,CAAA,GAAI,IAAA,CAAK,UAAA,GAAa,EAAC;AAC5F,EAAA,IAAI,CAAC,aAAa,IAAI,CAAA,IAAK,CAAC,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,GAAG,CAAA,EAAG;AAC1D,IAAA,OAAO,SAAA;AAAA,EACT;AACA,EAAA,OAAO,kBAAA,CAAmB,EAAE,GAAG,KAAA,EAAO,MAAK,EAAG,GAAA,EAAK,OAAO,CAAA,GACtD,QAAA,GACA,cAAA,CAAe,UAAA,CAAW,GAAG,GAAG,IAAI,CAAA;AAC1C;;"}

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

@@ -3,40 +3,56 @@
 const constructors = require('../../../domain/ir/constructors.cjs');
 const refType = require('../ref-type.cjs');
 const generatedShape = require('./generated-shape.cjs');
+const locatedNode = require('./located-node.cjs');
 const pointerWalk = require('./pointer-walk.cjs');
+const propertyShape = require('./property-shape.cjs');
 
 const DEFS_KEYWORD = "$defs";
 function present(walk) {
   return walk.presence === "present" ? walk.type : constructors.irReference("NonNullable", [walk.type]);
 }
 function indexEntries(walk, key, keyword, refs) {
-  const owner = generatedShape.followRefs(walk.node, refs);
-  const child = generatedShape.isJsonObject(owner) ? owner[keyword] : void 0;
+  const owner = locatedNode.followLocated(walk, refs);
+  const child = locatedNode.isJsonObject(owner.node) ? owner.node[keyword] : void 0;
   return {
     ...walk,
     type: constructors.irIndexedAccess(present(walk), constructors.irKeyword(key)),
     node: child,
-    presence: generatedShape.schemaPresence(child, refs)
+    location: locatedNode.childLocation(owner.location, keyword),
+    presence: propertyShape.schemaPresence(child, refs)
   };
 }
 function nameStep(walk, name, isLast, input) {
-  const owner = generatedShape.followRefs(walk.node, input.refs);
-  const properties = generatedShape.isJsonObject(owner) && generatedShape.isJsonObject(owner.properties) ? owner.properties : {};
+  const owner = locatedNode.followLocated(walk, input.refs);
+  const { node } = owner;
+  const properties = locatedNode.isJsonObject(node) && locatedNode.isJsonObject(node.properties) ? node.properties : {};
+  const value = properties[name];
+  const { options, refs } = input;
+  const isMarkedOnTheWay = !isLast && propertyShape.isMarkedProperty(value, options, refs);
+  if (propertyShape.isExcludedProperty(value, options, refs) || isMarkedOnTheWay) {
+    return null;
+  }
   const type = walk.presence === "present" ? refType.indexKeyword(walk.type, name, isLast) : refType.indexBy(present(walk), name);
   return {
     ...walk,
     type,
-    node: properties[name],
+    node: value,
+    location: locatedNode.childLocation(walk.namesLocation, name),
     isName: false,
-    presence: generatedShape.propertyPresence(walk.node, name, input.options, input.refs)
+    presence: propertyShape.propertyPresence(walk, name, input.options, input.refs)
   };
 }
 function defsStep(walk, owner, isLast) {
-  const defs = generatedShape.isJsonObject(owner) && generatedShape.isJsonObject(owner[DEFS_KEYWORD]) ? owner[DEFS_KEYWORD] : {};
+  const { node } = owner;
+  const defs = locatedNode.isJsonObject(node) && locatedNode.isJsonObject(node[DEFS_KEYWORD]) ? node[DEFS_KEYWORD] : {};
+  const namesLocation = locatedNode.childLocation(owner.location, DEFS_KEYWORD);
   return {
     ...walk,
     type: refType.indexKeyword(present(walk), DEFS_KEYWORD, isLast),
+    // A node of its own, not in the document: its properties are the definitions.
     node: { properties: defs, required: Object.keys(defs) },
+    location: namesLocation,
+    namesLocation,
     isName: true,
     presence: "present"
   };
@@ -47,19 +63,19 @@ const SHAPED_KEYWORDS = /* @__PURE__ */ new Set([
   "additionalProperties"
 ]);
 function hasKeywordMember(owner, segment) {
-  if (!SHAPED_KEYWORDS.has(segment) || !generatedShape.isJsonObject(owner)) {
+  if (!SHAPED_KEYWORDS.has(segment) || !locatedNode.isJsonObject(owner)) {
     return true;
   }
   return segment === "items" ? generatedShape.isArrayShape(owner) : generatedShape.isObjectShape(owner);
 }
 function keywordStep(walk, segment, isLast, input) {
-  const owner = generatedShape.followRefs(walk.node, input.refs);
-  if (!hasKeywordMember(owner, segment)) {
+  const owner = locatedNode.followLocated(walk, input.refs);
+  if (!hasKeywordMember(owner.node, segment)) {
     return null;
   }
   switch (segment) {
     case "properties":
-      return { ...walk, isName: true };
+      return { ...walk, isName: true, namesLocation: locatedNode.childLocation(owner.location, segment) };
     case "items":
       return indexEntries(walk, "number", "items", input.refs);
     case "additionalProperties":
@@ -72,15 +88,56 @@ function keywordStep(walk, segment, isLast, input) {
 }
 function containerStep(walk, index, input) {
   const segment = input.pointer.segments[index];
-  const owner = generatedShape.followRefs(walk.node, input.refs);
+  const owner = locatedNode.followRefs(walk.node, input.refs);
   const isOptional = segment === "requestBody" && pointerWalk.isOptionalRequestBody(owner, input.refs) || pointerWalk.isOptionalHeader(input.pointer, index, owner);
   return {
     ...walk,
     type: refType.indexBy(present(walk), segment),
-    node: generatedShape.isJsonObject(owner) ? owner[segment] : void 0,
+    node: locatedNode.isJsonObject(owner) ? owner[segment] : void 0,
+    location: locatedNode.childLocation(locatedNode.followLocated(walk, input.refs).location, segment),
     presence: isOptional ? "absent" : "present"
   };
 }
+function contentStep(walk, form, isLast, refs) {
+  const isMapTyped = form === "media-type-members" || form === "first-media-type" && !isLast;
+  if (!isMapTyped) {
+    return null;
+  }
+  const owner = locatedNode.followLocated(walk, refs);
+  return {
+    ...walk,
+    node: locatedNode.isJsonObject(owner.node) ? owner.node.content : void 0,
+    location: locatedNode.childLocation(owner.location, "content"),
+    isFirstMediaType: form === "first-media-type"
+  };
+}
+function firstMediaTypeStep(walk, segment) {
+  const content = locatedNode.isJsonObject(walk.node) ? walk.node : {};
+  if (Object.keys(content)[0] !== segment) {
+    return null;
+  }
+  const location = locatedNode.childLocation(walk.location, segment);
+  return { ...walk, node: content[segment], location, isFirstMediaType: false };
+}
+function schemaStep(walk, refs) {
+  const owner = locatedNode.followLocated(walk, refs);
+  const schema = locatedNode.isJsonObject(owner.node) ? owner.node.schema : void 0;
+  const location = locatedNode.childLocation(owner.location, "schema");
+  const presence = walk.presence === "absent" ? "absent" : propertyShape.schemaPresence(schema, refs);
+  return { ...walk, node: schema, location, isSchema: true, presence };
+}
+function documentStep(walk, index, input) {
+  const owner = locatedNode.followRefs(walk.node, input.refs);
+  const form = pointerWalk.headerParameterContentForm(input.pointer, index, owner, input.options);
+  if (form !== null) {
+    const isLast = index === input.pointer.segments.length - 1;
+    return contentStep(walk, form, isLast, input.refs);
+  }
+  if (pointerWalk.isParameterList(input.pointer, index) || pointerWalk.isExcludedOperation(input.pointer, index, owner, input)) {
+    return null;
+  }
+  return containerStep(walk, index, input);
+}
 function step(walk, index, input) {
   const { segments } = input.pointer;
   const segment = segments[index];
@@ -88,17 +145,17 @@ function step(walk, index, input) {
   if (walk.isSchema) {
     return walk.isName ? nameStep(walk, segment, isLast, input) : keywordStep(walk, segment, isLast, input);
   }
+  if (walk.isFirstMediaType) {
+    return firstMediaTypeStep(walk, segment);
+  }
   if (segment === "schema" && pointerWalk.isTypedAsSchema(input.pointer, index)) {
-    const owner = generatedShape.followRefs(walk.node, input.refs);
-    const schema = generatedShape.isJsonObject(owner) ? owner.schema : void 0;
-    const presence = walk.presence === "absent" ? "absent" : generatedShape.schemaPresence(schema, input.refs);
-    return { ...walk, node: schema, isSchema: true, presence };
+    return schemaStep(walk, input.refs);
   }
-  return pointerWalk.isParameterList(input.pointer, index) ? null : containerStep(walk, index, input);
+  return documentStep(walk, index, input);
 }
 function typedWalk(input) {
   const { pointer } = input;
-  const node = pointerWalk.leadingNode(pointer, input.refs);
+  const { node, location } = pointerWalk.leadingLocated(pointer, input.refs);
   const isSchema = pointerWalk.startsInSchema(pointer);
   let walk = {
     type: refType.indexBy(
@@ -106,9 +163,10 @@ function typedWalk(input) {
       ...pointer.segments.slice(0, pointerWalk.leadingSegmentsOf(pointer))
     ),
     node,
+    location,
     isSchema,
     isName: false,
-    presence: isSchema ? generatedShape.schemaPresence(node, input.refs) : "present"
+    presence: isSchema ? propertyShape.schemaPresence(node, input.refs) : "present"
   };
   for (let index = pointerWalk.leadingSegmentsOf(pointer); index < pointer.segments.length; index++) {
     const next = step(walk, index, input);

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

@@ -1 +1 @@
-{"version":3,"file":"typed-walk.cjs","sources":["../../../../src/application/transform/ref-pointer/typed-walk.ts"],"sourcesContent":["import { irIndexedAccess, irKeyword, irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrKeyword, IrType } from \"../../../domain/ir/nodes.js\";\nimport { indexBy, indexKeyword, rootType } from \"../ref-type.js\";\nimport type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport {\n  followRefs,\n  isArrayShape,\n  isJsonObject,\n  isObjectShape,\n  type Presence,\n  propertyPresence,\n  schemaPresence,\n} 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 * The type of a `$ref` pointer as the generated types have it: the `schema` of a media type,\n * header or component parameter is its type, `items` is indexed by `number`,\n * `additionalProperties` by `string`, and a value that may be `undefined` or `null` is wrapped in\n * `NonNullable` before it is indexed. The walk stops at a segment with no type of its own\n * (`allOf/0`, `definitions/A`, operation `parameters/0`): the caller types the target itself.\n */\n\nconst DEFS_KEYWORD = \"$defs\";\n\nexport interface TypedWalk {\n  readonly type: IrType;\n  /** The document node the type stands for (not followed through a `$ref`). */\n  readonly node: unknown;\n  readonly isSchema: boolean;\n  /** The segment is a property or `$defs` name, not a keyword. */\n  readonly isName: boolean;\n  readonly presence: Presence;\n}\n\nexport interface TypedWalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\n/** The walk result: a type, or the index of the first segment that has no type. */\nexport type TypedWalkResult =\n  | { readonly kind: \"typed\"; readonly walk: TypedWalk }\n  | { readonly kind: \"untyped\"; readonly index: number };\n\nfunction present(walk: TypedWalk): IrType {\n  return walk.presence === \"present\" ? walk.type : irReference(\"NonNullable\", [walk.type]);\n}\n\nfunction indexEntries(walk: TypedWalk, key: IrKeyword, keyword: string, refs: RefResolver) {\n  const owner = followRefs(walk.node, refs);\n  const child = isJsonObject(owner) ? owner[keyword] : undefined;\n  return {\n    ...walk,\n    type: irIndexedAccess(present(walk), irKeyword(key)),\n    node: child,\n    presence: schemaPresence(child, refs),\n  };\n}\n\nfunction nameStep(walk: TypedWalk, name: string, isLast: boolean, input: TypedWalkInput) {\n  const owner = followRefs(walk.node, input.refs);\n  const properties = isJsonObject(owner) && isJsonObject(owner.properties) ? owner.properties : {};\n  const type =\n    walk.presence === \"present\"\n      ? indexKeyword(walk.type, name, isLast)\n      : indexBy(present(walk), name);\n  return {\n    ...walk,\n    type,\n    node: properties[name],\n    isName: false,\n    presence: propertyPresence(walk.node, name, input.options, input.refs),\n  };\n}\n\n/** `$defs` is optional (`NonNullable` when more follows); its members are present. */\nfunction defsStep(walk: TypedWalk, owner: unknown, isLast: boolean): TypedWalk {\n  const defs = isJsonObject(owner) && isJsonObject(owner[DEFS_KEYWORD]) ? owner[DEFS_KEYWORD] : {};\n  return {\n    ...walk,\n    type: indexKeyword(present(walk), DEFS_KEYWORD, isLast),\n    node: { properties: defs, required: Object.keys(defs) },\n    isName: true,\n    presence: \"present\",\n  };\n}\n\nconst SHAPED_KEYWORDS: ReadonlySet<string> = new Set([\n  \"properties\",\n  \"items\",\n  \"additionalProperties\",\n]);\n\n/**\n * Whether the keyword gives the owner's generated type a member: `items` only an array,\n * `properties` and `additionalProperties` only an object (`type: string` ignores them). A node\n * that is not in the document is indexed as the keyword says.\n */\nfunction hasKeywordMember(owner: unknown, segment: string): boolean {\n  if (!SHAPED_KEYWORDS.has(segment) || !isJsonObject(owner)) {\n    return true;\n  }\n  return segment === \"items\" ? isArrayShape(owner) : isObjectShape(owner);\n}\n\nfunction keywordStep(walk: TypedWalk, segment: string, isLast: boolean, input: TypedWalkInput) {\n  const owner = followRefs(walk.node, input.refs);\n  if (!hasKeywordMember(owner, segment)) {\n    return null;\n  }\n  switch (segment) {\n    case \"properties\":\n      return { ...walk, isName: true };\n    case \"items\":\n      return indexEntries(walk, \"number\", \"items\", input.refs);\n    case \"additionalProperties\":\n      return indexEntries(walk, \"string\", \"additionalProperties\", input.refs);\n    case DEFS_KEYWORD:\n      return defsStep(walk, owner, isLast);\n    default:\n      return null;\n  }\n}\n\nfunction containerStep(walk: TypedWalk, index: number, input: TypedWalkInput): TypedWalk {\n  const segment = input.pointer.segments[index] as string;\n  const owner = followRefs(walk.node, input.refs);\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(owner, input.refs)) ||\n    isOptionalHeader(input.pointer, index, owner);\n  return {\n    ...walk,\n    type: indexBy(present(walk), segment),\n    node: isJsonObject(owner) ? owner[segment] : undefined,\n    presence: isOptional ? \"absent\" : \"present\",\n  };\n}\n\nfunction step(walk: TypedWalk, index: number, input: TypedWalkInput): TypedWalk | null {\n  const { segments } = input.pointer;\n  const segment = segments[index] as string;\n  const isLast = index === segments.length - 1;\n  if (walk.isSchema) {\n    return walk.isName\n      ? nameStep(walk, segment, isLast, input)\n      : keywordStep(walk, segment, isLast, input);\n  }\n  if (segment === \"schema\" && isTypedAsSchema(input.pointer, index)) {\n    const owner = followRefs(walk.node, input.refs);\n    const schema = isJsonObject(owner) ? owner.schema : undefined;\n    // The container's type is its schema's type: an optional header stays optional.\n    const presence = walk.presence === \"absent\" ? \"absent\" : schemaPresence(schema, input.refs);\n    return { ...walk, node: schema, isSchema: true, presence };\n  }\n  return isParameterList(input.pointer, index) ? null : containerStep(walk, index, input);\n}\n\n/** Walk the whole pointer; see the module comment. */\nexport function typedWalk(input: TypedWalkInput): TypedWalkResult {\n  const { pointer } = input;\n  const node = leadingNode(pointer, input.refs);\n  const isSchema = startsInSchema(pointer);\n  let walk: TypedWalk = {\n    type: indexBy(\n      rootType(pointer.rootSegment, false),\n      ...pointer.segments.slice(0, leadingSegmentsOf(pointer)),\n    ),\n    node,\n    isSchema,\n    isName: false,\n    presence: isSchema ? schemaPresence(node, input.refs) : \"present\",\n  };\n  for (let index = leadingSegmentsOf(pointer); index < pointer.segments.length; index++) {\n    const next = step(walk, index, input);\n    if (next === null) {\n      return { kind: \"untyped\", index };\n    }\n    walk = next;\n  }\n  return { kind: \"typed\", walk };\n}\n"],"names":["irReference","followRefs","isJsonObject","irIndexedAccess","irKeyword","schemaPresence","indexKeyword","indexBy","propertyPresence","isArrayShape","isObjectShape","isOptionalRequestBody","isOptionalHeader","isTypedAsSchema","isParameterList","leadingNode","startsInSchema","rootType","leadingSegmentsOf"],"mappings":"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"}
+{"version":3,"file":"typed-walk.cjs","sources":["../../../../src/application/transform/ref-pointer/typed-walk.ts"],"sourcesContent":["import { irIndexedAccess, irKeyword, irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrKeyword, IrType } from \"../../../domain/ir/nodes.js\";\nimport { indexBy, indexKeyword, rootType } from \"../ref-type.js\";\nimport type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { isArrayShape, isObjectShape } from \"./generated-shape.js\";\nimport {\n  childLocation,\n  followLocated,\n  followRefs,\n  isJsonObject,\n  type LocatedNode,\n} 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\";\nimport {\n  isExcludedProperty,\n  isMarkedProperty,\n  type Presence,\n  propertyPresence,\n  schemaPresence,\n} from \"./property-shape.js\";\n\n/**\n * The type of a `$ref` pointer as the generated types have it: the `schema` of a media type,\n * header or component parameter is its type, `items` is indexed by `number`,\n * `additionalProperties` by `string`, and a value that may be `undefined` or `null` is wrapped in\n * `NonNullable` before it is indexed. The walk stops at a segment with no type of its own\n * (`allOf/0`, `definitions/A`, operation `parameters/0`): the caller types the target itself.\n */\n\nconst DEFS_KEYWORD = \"$defs\";\n\nexport interface TypedWalk {\n  readonly type: IrType;\n  /** The document node the type stands for (not followed through a `$ref`). */\n  readonly node: unknown;\n  /** The node's JSON Pointer, where the generator writes its type (`LocatedNode`). */\n  readonly location: string | undefined;\n  readonly isSchema: boolean;\n  /** The segment is a property or `$defs` name, not a keyword. */\n  readonly isName: boolean;\n  /** The location of the map of names (`properties` or `$defs`) when `isName`. */\n  readonly namesLocation?: string | undefined;\n  /**\n   * The node is the `content` of a header or parameter typed as its first media type, so the\n   * next segment must name that media type and adds no member.\n   */\n  readonly isFirstMediaType?: boolean;\n  readonly presence: Presence;\n}\n\nexport interface TypedWalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\n/** The walk result: a type, or the index of the first segment that has no type. */\nexport type TypedWalkResult =\n  | { readonly kind: \"typed\"; readonly walk: TypedWalk }\n  | { readonly kind: \"untyped\"; readonly index: number };\n\nfunction present(walk: TypedWalk): IrType {\n  return walk.presence === \"present\" ? walk.type : irReference(\"NonNullable\", [walk.type]);\n}\n\nfunction indexEntries(walk: TypedWalk, key: IrKeyword, keyword: string, refs: RefResolver) {\n  const owner = followLocated(walk, refs);\n  const child = isJsonObject(owner.node) ? owner.node[keyword] : undefined;\n  return {\n    ...walk,\n    type: irIndexedAccess(present(walk), irKeyword(key)),\n    node: child,\n    location: childLocation(owner.location, keyword),\n    presence: schemaPresence(child, refs),\n  };\n}\n\n/**\n * A property `--exclude-deprecated` left out has no member to index, and the `$Read<T>` or\n * `$Write<T>` of a marked property has no member but the marker's: such a pointer is typed in\n * place.\n */\nfunction nameStep(walk: TypedWalk, name: string, isLast: boolean, input: TypedWalkInput) {\n  const owner = followLocated(walk, input.refs);\n  const { node } = owner;\n  const properties = isJsonObject(node) && isJsonObject(node.properties) ? node.properties : {};\n  const value = properties[name];\n  const { options, refs } = input;\n  const isMarkedOnTheWay = !isLast && isMarkedProperty(value, options, refs);\n  if (isExcludedProperty(value, options, refs) || isMarkedOnTheWay) {\n    return null;\n  }\n  const type =\n    walk.presence === \"present\"\n      ? indexKeyword(walk.type, name, isLast)\n      : indexBy(present(walk), name);\n  return {\n    ...walk,\n    type,\n    node: value,\n    location: childLocation(walk.namesLocation, name),\n    isName: false,\n    presence: propertyPresence(walk, name, input.options, input.refs),\n  };\n}\n\n/** `$defs` is optional (`NonNullable` when more follows); its members are present. */\nfunction defsStep(walk: TypedWalk, owner: LocatedNode, isLast: boolean): TypedWalk {\n  const { node } = owner;\n  const defs = isJsonObject(node) && isJsonObject(node[DEFS_KEYWORD]) ? node[DEFS_KEYWORD] : {};\n  const namesLocation = childLocation(owner.location, DEFS_KEYWORD);\n  return {\n    ...walk,\n    type: indexKeyword(present(walk), DEFS_KEYWORD, isLast),\n    // A node of its own, not in the document: its properties are the definitions.\n    node: { properties: defs, required: Object.keys(defs) },\n    location: namesLocation,\n    namesLocation,\n    isName: true,\n    presence: \"present\",\n  };\n}\n\nconst SHAPED_KEYWORDS: ReadonlySet<string> = new Set([\n  \"properties\",\n  \"items\",\n  \"additionalProperties\",\n]);\n\n/**\n * Whether the keyword gives the owner's generated type a member: `items` only an array,\n * `properties` and `additionalProperties` only an object (`type: string` ignores them). A node\n * that is not in the document is indexed as the keyword says.\n */\nfunction hasKeywordMember(owner: unknown, segment: string): boolean {\n  if (!SHAPED_KEYWORDS.has(segment) || !isJsonObject(owner)) {\n    return true;\n  }\n  return segment === \"items\" ? isArrayShape(owner) : isObjectShape(owner);\n}\n\nfunction keywordStep(walk: TypedWalk, segment: string, isLast: boolean, input: TypedWalkInput) {\n  const owner = followLocated(walk, input.refs);\n  if (!hasKeywordMember(owner.node, segment)) {\n    return null;\n  }\n  switch (segment) {\n    case \"properties\":\n      return { ...walk, isName: true, namesLocation: childLocation(owner.location, segment) };\n    case \"items\":\n      return indexEntries(walk, \"number\", \"items\", input.refs);\n    case \"additionalProperties\":\n      return indexEntries(walk, \"string\", \"additionalProperties\", input.refs);\n    case DEFS_KEYWORD:\n      return defsStep(walk, owner, isLast);\n    default:\n      return null;\n  }\n}\n\nfunction containerStep(walk: TypedWalk, index: number, input: TypedWalkInput): TypedWalk {\n  const segment = input.pointer.segments[index] as string;\n  const owner = followRefs(walk.node, input.refs);\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(owner, input.refs)) ||\n    isOptionalHeader(input.pointer, index, owner);\n  return {\n    ...walk,\n    type: indexBy(present(walk), segment),\n    node: isJsonObject(owner) ? owner[segment] : undefined,\n    location: childLocation(followLocated(walk, input.refs).location, segment),\n    presence: isOptional ? \"absent\" : \"present\",\n  };\n}\n\n/**\n * The `content` of a header or parameter: no member of its own, since the type holds its media\n * types (or the first one's type). Untyped where the type is `string` or a `schema`'s, and as the\n * last segment of the first media type form, whose type is not the map's.\n */\nfunction contentStep(walk: TypedWalk, form: ContentForm, isLast: boolean, refs: RefResolver) {\n  const isMapTyped = form === \"media-type-members\" || (form === \"first-media-type\" && !isLast);\n  if (!isMapTyped) {\n    return null;\n  }\n  const owner = followLocated(walk, refs);\n  return {\n    ...walk,\n    node: isJsonObject(owner.node) ? owner.node.content : undefined,\n    location: childLocation(owner.location, \"content\"),\n    isFirstMediaType: form === \"first-media-type\",\n  };\n}\n\n/** The first media type of such a `content` is the type itself; another one has no type. */\nfunction firstMediaTypeStep(walk: TypedWalk, segment: string): TypedWalk | null {\n  const content = isJsonObject(walk.node) ? walk.node : {};\n  if (Object.keys(content)[0] !== segment) {\n    return null;\n  }\n  const location = childLocation(walk.location, segment);\n  return { ...walk, node: content[segment], location, isFirstMediaType: false };\n}\n\nfunction schemaStep(walk: TypedWalk, refs: RefResolver): TypedWalk {\n  const owner = followLocated(walk, refs);\n  const schema = isJsonObject(owner.node) ? owner.node.schema : undefined;\n  const location = childLocation(owner.location, \"schema\");\n  // The container's type is its schema's type: an optional header stays optional.\n  const presence = walk.presence === \"absent\" ? \"absent\" : schemaPresence(schema, refs);\n  return { ...walk, node: schema, location, isSchema: true, presence };\n}\n\nfunction documentStep(walk: TypedWalk, index: number, input: TypedWalkInput): TypedWalk | null {\n  const owner = followRefs(walk.node, input.refs);\n  const form = headerParameterContentForm(input.pointer, index, owner, input.options);\n  if (form !== null) {\n    const isLast = index === input.pointer.segments.length - 1;\n    return contentStep(walk, form, isLast, input.refs);\n  }\n  if (\n    isParameterList(input.pointer, index) ||\n    isExcludedOperation(input.pointer, index, owner, input)\n  ) {\n    return null;\n  }\n  return containerStep(walk, index, input);\n}\n\nfunction step(walk: TypedWalk, index: number, input: TypedWalkInput): TypedWalk | null {\n  const { segments } = input.pointer;\n  const segment = segments[index] as string;\n  const isLast = index === segments.length - 1;\n  if (walk.isSchema) {\n    return walk.isName\n      ? nameStep(walk, segment, isLast, input)\n      : keywordStep(walk, segment, isLast, input);\n  }\n  if (walk.isFirstMediaType) {\n    return firstMediaTypeStep(walk, segment);\n  }\n  if (segment === \"schema\" && isTypedAsSchema(input.pointer, index)) {\n    return schemaStep(walk, input.refs);\n  }\n  return documentStep(walk, index, input);\n}\n\n/** Walk the whole pointer; see the module comment. */\nexport function typedWalk(input: TypedWalkInput): TypedWalkResult {\n  const { pointer } = input;\n  const { node, location } = leadingLocated(pointer, input.refs);\n  const isSchema = startsInSchema(pointer);\n  let walk: TypedWalk = {\n    type: indexBy(\n      rootType(pointer.rootSegment, false),\n      ...pointer.segments.slice(0, leadingSegmentsOf(pointer)),\n    ),\n    node,\n    location,\n    isSchema,\n    isName: false,\n    presence: isSchema ? schemaPresence(node, input.refs) : \"present\",\n  };\n  for (let index = leadingSegmentsOf(pointer); index < pointer.segments.length; index++) {\n    const next = step(walk, index, input);\n    if (next === null) {\n      return { kind: \"untyped\", index };\n    }\n    walk = next;\n  }\n  return { kind: \"typed\", walk };\n}\n"],"names":["irReference","followLocated","isJsonObject","irIndexedAccess","irKeyword","childLocation","schemaPresence","isMarkedProperty","isExcludedProperty","indexKeyword","indexBy","propertyPresence","isArrayShape","isObjectShape","followRefs","isOptionalRequestBody","isOptionalHeader","headerParameterContentForm","isParameterList","isExcludedOperation","isTypedAsSchema","leadingLocated","startsInSchema","rootType","leadingSegmentsOf"],"mappings":"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"}