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

package/dist/application/transform/document/media-type.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"media-type.mjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: createRef([path, \"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = createRef([location.path, \"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":[],"mappings":";;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAAS,eAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAI,YAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACb,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAW,uBAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AACJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAM,SAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAM,UAAU,CAAC,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAC3E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAc,SAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,SAAS,CAAC,CAAA;AACnE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAAC,cAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpB,UAAA,CAAW,cAAA,CAAe,gBAAgB,CAAA,EAAG,QAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;"}
+{"version":3,"file":"media-type.mjs","sources":["../../../../src/application/transform/document/media-type.ts"],"sourcesContent":["import { irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer, createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ContentMap,\n  isMediaTypeComponentRef,\n  type MediaTypeObject,\n} from \"../../../domain/openapi/media-type-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { UNKNOWN_TYPE } from \"../shared-types.js\";\nimport { documentMember } from \"./document-member.js\";\n\n/** The sibling of `content` that holds item types (ADR-020). */\nconst ITEM_CONTENT_KEY = \"itemContent\";\n\n/** A media type's schema, or `unknown` when it has none (OpenAPI 3.1 §4.8.14). */\nexport function mediaTypeType(\n  mediaType: MediaTypeObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  return mediaType.schema ? transformSchema(mediaType.schema, location, context) : UNKNOWN_TYPE;\n}\n\n/** A `content` entry: a `$ref` is transformed like a schema `$ref`, the rest as a media type. */\nexport function contentEntryType(\n  entry: ContentMap[string],\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  // `in` throws for a null entry, as in the original.\n  return \"$ref\" in entry\n    ? transformSchema(entry, location, context)\n    : mediaTypeType(entry, location, context);\n}\n\n/** The `itemSchema` of a `content` entry and where it is, following a `$ref` to a component. */\nfunction itemSchemaAt(\n  entry: ContentMap[string],\n  path: string,\n  context: SchemaContext,\n): { readonly schema: MediaTypeObject[\"itemSchema\"]; readonly path: string } {\n  if (\"$ref\" in entry) {\n    // Other `$ref`s in `content` keep their pre-3.2 output, so only media type components count.\n    const resolved = isMediaTypeComponentRef(entry.$ref)\n      ? (context.refs.resolve(entry.$ref) as MediaTypeObject | undefined)\n      : undefined;\n    // `createRef` reads the `$ref` itself as a pointer; only the constant segment is appended.\n    return { schema: resolved?.itemSchema, path: createRef([entry.$ref, \"itemSchema\"]) };\n  }\n  return { schema: entry.itemSchema, path: appendPointer(path, [\"itemSchema\"]) };\n}\n\n/**\n * `itemContent`: the type of one item of each media type with an `itemSchema` (OpenAPI 3.2), next\n * to `content`, which keeps the type of the complete body. Null when no media type has one.\n */\nexport function itemContentMember(\n  content: ContentMap,\n  location: SchemaLocation,\n  context: SchemaContext,\n  flags: { readonly isReadonly: boolean },\n): IrPropertySignature | null {\n  const members = documentEntries(content, context.options).flatMap(([mediaType, entry]) => {\n    const contentPath = appendPointer(location.path, [\"content\", mediaType]);\n    const item = itemSchemaAt(entry, contentPath, context);\n    if (item.schema === undefined) {\n      return [];\n    }\n    const type = transformSchema(item.schema, { ...location, path: item.path }, context);\n    return [documentMember(mediaType, type, entry, { isReadonly: context.options.immutable })];\n  });\n  return members.length > 0\n    ? irProperty(toPropertyName(ITEM_CONTENT_KEY), irObject(members), flags)\n    : null;\n}\n"],"names":[],"mappings":";;;;;;;;;AAgBA,MAAM,gBAAA,GAAmB,aAAA;AAGlB,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,OAAO,UAAU,MAAA,GAAS,eAAA,CAAgB,UAAU,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,GAAI,YAAA;AACnF;AAGO,SAAS,gBAAA,CACd,KAAA,EACA,QAAA,EACA,OAAA,EACQ;AAER,EAAA,OAAO,MAAA,IAAU,KAAA,GACb,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA,GACxC,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,OAAO,CAAA;AAC5C;AAGA,SAAS,YAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2E;AAC3E,EAAA,IAAI,UAAU,KAAA,EAAO;AAEnB,IAAA,MAAM,QAAA,GAAW,uBAAA,CAAwB,KAAA,CAAM,IAAI,CAAA,GAC9C,QAAQ,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA,GAChC,MAAA;AAEJ,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAA,EAAY,IAAA,EAAM,SAAA,CAAU,CAAC,KAAA,CAAM,IAAA,EAAM,YAAY,CAAC,CAAA,EAAE;AAAA,EACrF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAY,IAAA,EAAM,cAAc,IAAA,EAAM,CAAC,YAAY,CAAC,CAAA,EAAE;AAC/E;AAMO,SAAS,iBAAA,CACd,OAAA,EACA,QAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AACxF,IAAA,MAAM,cAAc,aAAA,CAAc,QAAA,CAAS,MAAM,CAAC,SAAA,EAAW,SAAS,CAAC,CAAA;AACvE,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,KAAA,EAAO,WAAA,EAAa,OAAO,CAAA;AACrD,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO,EAAC;AAAA,IACV;AACA,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,IAAA,CAAK,MAAA,EAAQ,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,EAAG,OAAO,CAAA;AACnF,IAAA,OAAO,CAAC,cAAA,CAAe,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,CAAC,CAAA;AAAA,EAC3F,CAAC,CAAA;AACD,EAAA,OAAO,OAAA,CAAQ,MAAA,GAAS,CAAA,GACpB,UAAA,CAAW,cAAA,CAAe,gBAAgB,CAAA,EAAG,QAAA,CAAS,OAAO,CAAA,EAAG,KAAK,CAAA,GACrE,IAAA;AACN;;"}

package/dist/application/transform/document/operation-keys-written.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+const appendAll = require('../../../domain/append-all.cjs');
+const pathItem = require('./path-item.cjs');
+
+function operationKeysWritten(document) {
+  const keys = /* @__PURE__ */ new Set();
+  const seen = /* @__PURE__ */ new WeakSet();
+  const pending = [document];
+  while (pending.length > 0) {
+    const value = pending.pop();
+    if (typeof value !== "object" || value === null || seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+    const { operationId } = value;
+    if (typeof operationId === "string") {
+      keys.add(pathItem.operationKeyOf(operationId));
+    }
+    appendAll.appendAll(pending, Object.values(value));
+  }
+  return keys;
+}
+
+exports.operationKeysWritten = operationKeysWritten;
+//# sourceMappingURL=operation-keys-written.cjs.map

package/dist/application/transform/document/operation-keys-written.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-keys-written.cjs","sources":["../../../../src/application/transform/document/operation-keys-written.ts"],"sourcesContent":["import { appendAll } from \"../../../domain/append-all.js\";\nimport { operationKeyOf } from \"./path-item.js\";\n\n/**\n * Every `operations` key that an `operationId` in the document asks for, so that a repeated ID\n * never gets a number another operation has as its own ID (`OperationKeys`). Operations can sit\n * in `paths`, `webhooks`, `components.pathItems` and callbacks, so the whole document is read. A\n * Link Object's `operationId` is read too; an extra name only makes a number skip it.\n */\nexport function operationKeysWritten(document: object): Set<string> {\n  const keys = new Set<string>();\n  const seen = new WeakSet<object>();\n  const pending: unknown[] = [document];\n  while (pending.length > 0) {\n    const value = pending.pop();\n    if (typeof value !== \"object\" || value === null || seen.has(value)) {\n      continue;\n    }\n    seen.add(value);\n    const { operationId } = value as { operationId?: unknown };\n    if (typeof operationId === \"string\") {\n      keys.add(operationKeyOf(operationId));\n    }\n    appendAll(pending, Object.values(value));\n  }\n  return keys;\n}\n"],"names":["operationKeyOf","appendAll"],"mappings":";;;;;AASO,SAAS,qBAAqB,QAAA,EAA+B;AAClE,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,IAAA,uBAAW,OAAA,EAAgB;AACjC,EAAA,MAAM,OAAA,GAAqB,CAAC,QAAQ,CAAA;AACpC,EAAA,OAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AACzB,IAAA,MAAM,KAAA,GAAQ,QAAQ,GAAA,EAAI;AAC1B,IAAA,IAAI,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,EAAG;AAClE,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAI,KAAK,CAAA;AACd,IAAA,MAAM,EAAE,aAAY,GAAI,KAAA;AACxB,IAAA,IAAI,OAAO,gBAAgB,QAAA,EAAU;AACnC,MAAA,IAAA,CAAK,GAAA,CAAIA,uBAAA,CAAe,WAAW,CAAC,CAAA;AAAA,IACtC;AACA,IAAAC,mBAAA,CAAU,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,IAAA;AACT;;"}

package/dist/application/transform/document/operation-keys-written.mjs

@@ -0,0 +1,24 @@
+import { appendAll } from '../../../domain/append-all.mjs';
+import { operationKeyOf } from './path-item.mjs';
+
+function operationKeysWritten(document) {
+  const keys = /* @__PURE__ */ new Set();
+  const seen = /* @__PURE__ */ new WeakSet();
+  const pending = [document];
+  while (pending.length > 0) {
+    const value = pending.pop();
+    if (typeof value !== "object" || value === null || seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+    const { operationId } = value;
+    if (typeof operationId === "string") {
+      keys.add(operationKeyOf(operationId));
+    }
+    appendAll(pending, Object.values(value));
+  }
+  return keys;
+}
+
+export { operationKeysWritten };
+//# sourceMappingURL=operation-keys-written.mjs.map

package/dist/application/transform/document/operation-keys-written.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-keys-written.mjs","sources":["../../../../src/application/transform/document/operation-keys-written.ts"],"sourcesContent":["import { appendAll } from \"../../../domain/append-all.js\";\nimport { operationKeyOf } from \"./path-item.js\";\n\n/**\n * Every `operations` key that an `operationId` in the document asks for, so that a repeated ID\n * never gets a number another operation has as its own ID (`OperationKeys`). Operations can sit\n * in `paths`, `webhooks`, `components.pathItems` and callbacks, so the whole document is read. A\n * Link Object's `operationId` is read too; an extra name only makes a number skip it.\n */\nexport function operationKeysWritten(document: object): Set<string> {\n  const keys = new Set<string>();\n  const seen = new WeakSet<object>();\n  const pending: unknown[] = [document];\n  while (pending.length > 0) {\n    const value = pending.pop();\n    if (typeof value !== \"object\" || value === null || seen.has(value)) {\n      continue;\n    }\n    seen.add(value);\n    const { operationId } = value as { operationId?: unknown };\n    if (typeof operationId === \"string\") {\n      keys.add(operationKeyOf(operationId));\n    }\n    appendAll(pending, Object.values(value));\n  }\n  return keys;\n}\n"],"names":[],"mappings":";;;AASO,SAAS,qBAAqB,QAAA,EAA+B;AAClE,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,IAAA,uBAAW,OAAA,EAAgB;AACjC,EAAA,MAAM,OAAA,GAAqB,CAAC,QAAQ,CAAA;AACpC,EAAA,OAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AACzB,IAAA,MAAM,KAAA,GAAQ,QAAQ,GAAA,EAAI;AAC1B,IAAA,IAAI,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,EAAG;AAClE,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAI,KAAK,CAAA;AACd,IAAA,MAAM,EAAE,aAAY,GAAI,KAAA;AACxB,IAAA,IAAI,OAAO,gBAAgB,QAAA,EAAU;AACnC,MAAA,IAAA,CAAK,GAAA,CAAI,cAAA,CAAe,WAAW,CAAC,CAAA;AAAA,IACtC;AACA,IAAA,SAAA,CAAU,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,IAAA;AACT;;"}

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

@@ -21,7 +21,7 @@ function requestBodyMember(operation, location, context) {
   const isReference = "$ref" in body;
   const type = isReference ? refType.refType(body.$ref) : requestBody.requestBodyType(
     body,
-    { ...location, path: jsonPointer.createRef([location.path, "requestBody"]) },
+    { ...location, path: jsonPointer.appendPointer(location.path, ["requestBody"]) },
     context
   );
   const resolved = isReference ? context.refs.resolve(body.$ref) : body;

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

@@ -1 +1 @@
-{"version":3,"file":"operation.cjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: createRef([location.path, \"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":["irProperty","toPropertyName","irKeyword","refType","requestBodyType","createRef","documentMember","parameters","parametersMember","responses","responsesType"],"mappings":";;;;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAOA,wBAAWC,2BAAA,CAAe,aAAa,CAAA,EAAGC,sBAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACTC,eAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjBC,2BAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAMC,qBAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,aAAa,CAAC,CAAA,EAAE;AAAA,IAC/D;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAOC,6BAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAMC,eAAaC,2BAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAMC,cAAYC,uBAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACLH,YAAA;AAAA,IACA,WAAA;AAAA,IACAP,uBAAA,CAAWC,2BAAA,CAAe,WAAW,CAAA,EAAGQ,WAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}
+{"version":3,"file":"operation.cjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: appendPointer(location.path, [\"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":["irProperty","toPropertyName","irKeyword","refType","requestBodyType","appendPointer","documentMember","parameters","parametersMember","responses","responsesType"],"mappings":";;;;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAOA,wBAAWC,2BAAA,CAAe,aAAa,CAAA,EAAGC,sBAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACTC,eAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjBC,2BAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAMC,yBAAA,CAAc,SAAS,IAAA,EAAM,CAAC,aAAa,CAAC,CAAA,EAAE;AAAA,IACnE;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAOC,6BAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAMC,eAAaC,2BAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAMC,cAAYC,uBAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACLH,YAAA;AAAA,IACA,WAAA;AAAA,IACAP,uBAAA,CAAWC,2BAAA,CAAe,WAAW,CAAA,EAAGQ,WAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}

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

@@ -1,6 +1,6 @@
 import { irProperty, irKeyword } from '../../../domain/ir/constructors.mjs';
 import { toPropertyName } from '../../../domain/ir/property-name.mjs';
-import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { appendPointer } from '../../../domain/openapi/json-pointer.mjs';
 import { refType } from '../ref-type.mjs';
 import { documentMember } from './document-member.mjs';
 import { parametersMember } from './parameters.mjs';
@@ -19,7 +19,7 @@ function requestBodyMember(operation, location, context) {
   const isReference = "$ref" in body;
   const type = isReference ? refType(body.$ref) : requestBodyType(
     body,
-    { ...location, path: createRef([location.path, "requestBody"]) },
+    { ...location, path: appendPointer(location.path, ["requestBody"]) },
     context
   );
   const resolved = isReference ? context.refs.resolve(body.$ref) : body;

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

@@ -1 +1 @@
-{"version":3,"file":"operation.mjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: createRef([location.path, \"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":[],"mappings":";;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAO,WAAW,cAAA,CAAe,aAAa,CAAA,EAAG,SAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACT,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjB,eAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,SAAA,CAAU,CAAC,QAAA,CAAS,IAAA,EAAM,aAAa,CAAC,CAAA,EAAE;AAAA,IAC/D;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAO,cAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAM,aAAa,gBAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAM,YAAY,aAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IACA,WAAA;AAAA,IACA,UAAA,CAAW,cAAA,CAAe,WAAW,CAAA,EAAG,SAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}
+{"version":3,"file":"operation.mjs","sources":["../../../../src/application/transform/document/operation.ts"],"sourcesContent":["import { irKeyword, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertySignature } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type { RequestBodyObject } from \"../../../domain/openapi/request-body-object.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { parametersMember } from \"./parameters.js\";\nimport { requestBodyType } from \"./request-body.js\";\nimport { responsesType } from \"./responses.js\";\n\n/** `requestBody`, optional unless the resolved body is required; `requestBody?: never` if none. */\nfunction requestBodyMember(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const isReadonly = context.options.immutable;\n  const body = operation.requestBody;\n  if (!body) {\n    return irProperty(toPropertyName(\"requestBody\"), irKeyword(\"never\"), {\n      isOptional: true,\n      isReadonly,\n    });\n  }\n  const isReference = \"$ref\" in body;\n  const type = isReference\n    ? refType(body.$ref)\n    : requestBodyType(\n        body,\n        { ...location, path: appendPointer(location.path, [\"requestBody\"]) },\n        context,\n      );\n  const resolved = isReference\n    ? (context.refs.resolve(body.$ref) as RequestBodyObject | undefined)\n    : body;\n  return documentMember(\"requestBody\", type, body, {\n    isReadonly,\n    isOptional: !resolved?.required,\n  });\n}\n\n/**\n * The members of an operation (OpenAPI 3.1 §4.8.10): `parameters`, `requestBody` and `responses`.\n * `location.path` is the operation's pointer.\n */\nexport function operationMembers(\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature[] {\n  // Built in document order: each part may add footer declarations (enums), in this order.\n  const parameters = parametersMember(operation.parameters ?? [], location, context);\n  const requestBody = requestBodyMember(operation, location, context);\n  const responses = responsesType(operation.responses ?? {}, location, context);\n  return [\n    parameters,\n    requestBody,\n    irProperty(toPropertyName(\"responses\"), responses, { isReadonly: context.options.immutable }),\n  ];\n}\n"],"names":[],"mappings":";;;;;;;;;AAeA,SAAS,iBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACqB;AACrB,EAAA,MAAM,UAAA,GAAa,QAAQ,OAAA,CAAQ,SAAA;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,WAAA;AACvB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAO,WAAW,cAAA,CAAe,aAAa,CAAA,EAAG,SAAA,CAAU,OAAO,CAAA,EAAG;AAAA,MACnE,UAAA,EAAY,IAAA;AAAA,MACZ;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,cAAc,MAAA,IAAU,IAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,WAAA,GACT,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GACjB,eAAA;AAAA,IACE,IAAA;AAAA,IACA,EAAE,GAAG,QAAA,EAAU,IAAA,EAAM,aAAA,CAAc,SAAS,IAAA,EAAM,CAAC,aAAa,CAAC,CAAA,EAAE;AAAA,IACnE;AAAA,GACF;AACJ,EAAA,MAAM,WAAW,WAAA,GACZ,OAAA,CAAQ,KAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA,GAC/B,IAAA;AACJ,EAAA,OAAO,cAAA,CAAe,aAAA,EAAe,IAAA,EAAM,IAAA,EAAM;AAAA,IAC/C,UAAA;AAAA,IACA,UAAA,EAAY,CAAC,QAAA,EAAU;AAAA,GACxB,CAAA;AACH;AAMO,SAAS,gBAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACuB;AAEvB,EAAA,MAAM,aAAa,gBAAA,CAAiB,SAAA,CAAU,cAAc,EAAC,EAAG,UAAU,OAAO,CAAA;AACjF,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAClE,EAAA,MAAM,YAAY,aAAA,CAAc,SAAA,CAAU,aAAa,EAAC,EAAG,UAAU,OAAO,CAAA;AAC5E,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IACA,WAAA;AAAA,IACA,UAAA,CAAW,cAAA,CAAe,WAAW,CAAA,EAAG,SAAA,EAAW,EAAE,UAAA,EAAY,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW;AAAA,GAC9F;AACF;;"}

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

@@ -0,0 +1,34 @@
+'use strict';
+
+function resolveParameter(parameter, refs) {
+  return "$ref" in parameter ? refs.resolve(parameter.$ref) : parameter;
+}
+function isDeprecatedParameter(parameter) {
+  const schema = parameter?.schema;
+  return Boolean(parameter?.deprecated || schema?.deprecated);
+}
+function parameterEntries(parameters, context) {
+  const entries = parameters.map((original) => ({
+    original,
+    resolved: resolveParameter(original, context.refs)
+  }));
+  if (context.options.alphabetize) {
+    entries.sort(
+      (left, right) => (left.resolved?.name ?? "").localeCompare(right.resolved?.name ?? "")
+    );
+  }
+  return context.options.excludeDeprecated ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved)) : entries;
+}
+function mergedParameters(pathItem, operation, refs) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const parameter of [...pathItem.parameters ?? [], ...operation.parameters ?? []]) {
+    const resolved = resolveParameter(parameter, refs);
+    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);
+  }
+  return [...byKey.values()];
+}
+
+exports.mergedParameters = mergedParameters;
+exports.parameterEntries = parameterEntries;
+exports.resolveParameter = resolveParameter;
+//# sourceMappingURL=parameter-entries.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-entries.cjs","sources":["../../../../src/application/transform/document/parameter-entries.ts"],"sourcesContent":["import type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type {\n  ParameterObject,\n  ParameterOrReference,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { PathItemObject } from \"../../../domain/openapi/path-item-object.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\n\n/** A parameter as written in the document, and the object its `$ref` points to. */\nexport interface ParameterEntry {\n  readonly original: ParameterOrReference;\n  readonly resolved: ParameterObject | undefined;\n}\n\n/** An entry whose `$ref` resolved, so its location and name are known. */\nexport type ResolvedEntry = ParameterEntry & { readonly resolved: ParameterObject };\n\n/** The parameter object itself, or the one its `$ref` points to. */\nexport function resolveParameter(\n  parameter: ParameterOrReference,\n  refs: RefResolver,\n): ParameterObject | undefined {\n  return \"$ref\" in parameter\n    ? (refs.resolve(parameter.$ref) as ParameterObject | undefined)\n    : parameter;\n}\n\nfunction isDeprecatedParameter(parameter: ParameterObject | undefined): boolean {\n  const schema = parameter?.schema as SchemaObject | undefined;\n  return Boolean(parameter?.deprecated || schema?.deprecated);\n}\n\n/** Resolved parameters, sorted for `--alphabetize`, without deprecated ones if excluded. */\nexport function parameterEntries(\n  parameters: readonly ParameterOrReference[],\n  context: TransformContext,\n): ParameterEntry[] {\n  const entries = parameters.map((original) => ({\n    original,\n    resolved: resolveParameter(original, context.refs),\n  }));\n  if (context.options.alphabetize) {\n    // Unlike map keys, the original sorts parameters with the default locale's `localeCompare`.\n    entries.sort((left, right) =>\n      (left.resolved?.name ?? \"\").localeCompare(right.resolved?.name ?? \"\"),\n    );\n  }\n  return context.options.excludeDeprecated\n    ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved))\n    : entries;\n}\n\n/**\n * Path item parameters followed by the operation's, keyed by location and name, so an operation\n * parameter replaces the path item parameter it redefines (upstream issue #1798).\n */\nexport function mergedParameters(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  refs: RefResolver,\n): ParameterOrReference[] {\n  const byKey = new Map<string, ParameterOrReference>();\n  for (const parameter of [...(pathItem.parameters ?? []), ...(operation.parameters ?? [])]) {\n    const resolved = resolveParameter(parameter, refs);\n    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);\n  }\n  return [...byKey.values()];\n}\n"],"names":[],"mappings":";;AAoBO,SAAS,gBAAA,CACd,WACA,IAAA,EAC6B;AAC7B,EAAA,OAAO,UAAU,SAAA,GACZ,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,IAAI,CAAA,GAC5B,SAAA;AACN;AAEA,SAAS,sBAAsB,SAAA,EAAiD;AAC9E,EAAA,MAAM,SAAS,SAAA,EAAW,MAAA;AAC1B,EAAA,OAAO,OAAA,CAAQ,SAAA,EAAW,UAAA,IAAc,MAAA,EAAQ,UAAU,CAAA;AAC5D;AAGO,SAAS,gBAAA,CACd,YACA,OAAA,EACkB;AAClB,EAAA,MAAM,OAAA,GAAU,UAAA,CAAW,GAAA,CAAI,CAAC,QAAA,MAAc;AAAA,IAC5C,QAAA;AAAA,IACA,QAAA,EAAU,gBAAA,CAAiB,QAAA,EAAU,OAAA,CAAQ,IAAI;AAAA,GACnD,CAAE,CAAA;AACF,EAAA,IAAI,OAAA,CAAQ,QAAQ,WAAA,EAAa;AAE/B,IAAA,OAAA,CAAQ,IAAA;AAAA,MAAK,CAAC,IAAA,EAAM,KAAA,KAAA,CACjB,IAAA,CAAK,QAAA,EAAU,IAAA,IAAQ,EAAA,EAAI,aAAA,CAAc,KAAA,CAAM,QAAA,EAAU,IAAA,IAAQ,EAAE;AAAA,KACtE;AAAA,EACF;AACA,EAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,iBAAA,GACnB,OAAA,CAAQ,MAAA,CAAO,CAAC,EAAE,QAAA,EAAS,KAAM,CAAC,qBAAA,CAAsB,QAAQ,CAAC,CAAA,GACjE,OAAA;AACN;AAMO,SAAS,gBAAA,CACd,QAAA,EACA,SAAA,EACA,IAAA,EACwB;AACxB,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAkC;AACpD,EAAA,KAAA,MAAW,SAAA,IAAa,CAAC,GAAI,QAAA,CAAS,UAAA,IAAc,EAAC,EAAI,GAAI,SAAA,CAAU,UAAA,IAAc,EAAG,CAAA,EAAG;AACzF,IAAA,MAAM,QAAA,GAAW,gBAAA,CAAiB,SAAA,EAAW,IAAI,CAAA;AACjD,IAAA,KAAA,CAAM,GAAA,CAAI,GAAG,QAAA,EAAU,EAAE,IAAI,QAAA,EAAU,IAAI,IAAI,SAAS,CAAA;AAAA,EAC1D;AACA,EAAA,OAAO,CAAC,GAAG,KAAA,CAAM,MAAA,EAAQ,CAAA;AAC3B;;;;"}

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

@@ -0,0 +1,30 @@
+function resolveParameter(parameter, refs) {
+  return "$ref" in parameter ? refs.resolve(parameter.$ref) : parameter;
+}
+function isDeprecatedParameter(parameter) {
+  const schema = parameter?.schema;
+  return Boolean(parameter?.deprecated || schema?.deprecated);
+}
+function parameterEntries(parameters, context) {
+  const entries = parameters.map((original) => ({
+    original,
+    resolved: resolveParameter(original, context.refs)
+  }));
+  if (context.options.alphabetize) {
+    entries.sort(
+      (left, right) => (left.resolved?.name ?? "").localeCompare(right.resolved?.name ?? "")
+    );
+  }
+  return context.options.excludeDeprecated ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved)) : entries;
+}
+function mergedParameters(pathItem, operation, refs) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const parameter of [...pathItem.parameters ?? [], ...operation.parameters ?? []]) {
+    const resolved = resolveParameter(parameter, refs);
+    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);
+  }
+  return [...byKey.values()];
+}
+
+export { mergedParameters, parameterEntries, resolveParameter };
+//# sourceMappingURL=parameter-entries.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-entries.mjs","sources":["../../../../src/application/transform/document/parameter-entries.ts"],"sourcesContent":["import type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type {\n  ParameterObject,\n  ParameterOrReference,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { PathItemObject } from \"../../../domain/openapi/path-item-object.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\n\n/** A parameter as written in the document, and the object its `$ref` points to. */\nexport interface ParameterEntry {\n  readonly original: ParameterOrReference;\n  readonly resolved: ParameterObject | undefined;\n}\n\n/** An entry whose `$ref` resolved, so its location and name are known. */\nexport type ResolvedEntry = ParameterEntry & { readonly resolved: ParameterObject };\n\n/** The parameter object itself, or the one its `$ref` points to. */\nexport function resolveParameter(\n  parameter: ParameterOrReference,\n  refs: RefResolver,\n): ParameterObject | undefined {\n  return \"$ref\" in parameter\n    ? (refs.resolve(parameter.$ref) as ParameterObject | undefined)\n    : parameter;\n}\n\nfunction isDeprecatedParameter(parameter: ParameterObject | undefined): boolean {\n  const schema = parameter?.schema as SchemaObject | undefined;\n  return Boolean(parameter?.deprecated || schema?.deprecated);\n}\n\n/** Resolved parameters, sorted for `--alphabetize`, without deprecated ones if excluded. */\nexport function parameterEntries(\n  parameters: readonly ParameterOrReference[],\n  context: TransformContext,\n): ParameterEntry[] {\n  const entries = parameters.map((original) => ({\n    original,\n    resolved: resolveParameter(original, context.refs),\n  }));\n  if (context.options.alphabetize) {\n    // Unlike map keys, the original sorts parameters with the default locale's `localeCompare`.\n    entries.sort((left, right) =>\n      (left.resolved?.name ?? \"\").localeCompare(right.resolved?.name ?? \"\"),\n    );\n  }\n  return context.options.excludeDeprecated\n    ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved))\n    : entries;\n}\n\n/**\n * Path item parameters followed by the operation's, keyed by location and name, so an operation\n * parameter replaces the path item parameter it redefines (upstream issue #1798).\n */\nexport function mergedParameters(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  refs: RefResolver,\n): ParameterOrReference[] {\n  const byKey = new Map<string, ParameterOrReference>();\n  for (const parameter of [...(pathItem.parameters ?? []), ...(operation.parameters ?? [])]) {\n    const resolved = resolveParameter(parameter, refs);\n    byKey.set(`${resolved?.in}-${resolved?.name}`, parameter);\n  }\n  return [...byKey.values()];\n}\n"],"names":[],"mappings":"AAoBO,SAAS,gBAAA,CACd,WACA,IAAA,EAC6B;AAC7B,EAAA,OAAO,UAAU,SAAA,GACZ,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,IAAI,CAAA,GAC5B,SAAA;AACN;AAEA,SAAS,sBAAsB,SAAA,EAAiD;AAC9E,EAAA,MAAM,SAAS,SAAA,EAAW,MAAA;AAC1B,EAAA,OAAO,OAAA,CAAQ,SAAA,EAAW,UAAA,IAAc,MAAA,EAAQ,UAAU,CAAA;AAC5D;AAGO,SAAS,gBAAA,CACd,YACA,OAAA,EACkB;AAClB,EAAA,MAAM,OAAA,GAAU,UAAA,CAAW,GAAA,CAAI,CAAC,QAAA,MAAc;AAAA,IAC5C,QAAA;AAAA,IACA,QAAA,EAAU,gBAAA,CAAiB,QAAA,EAAU,OAAA,CAAQ,IAAI;AAAA,GACnD,CAAE,CAAA;AACF,EAAA,IAAI,OAAA,CAAQ,QAAQ,WAAA,EAAa;AAE/B,IAAA,OAAA,CAAQ,IAAA;AAAA,MAAK,CAAC,IAAA,EAAM,KAAA,KAAA,CACjB,IAAA,CAAK,QAAA,EAAU,IAAA,IAAQ,EAAA,EAAI,aAAA,CAAc,KAAA,CAAM,QAAA,EAAU,IAAA,IAAQ,EAAE;AAAA,KACtE;AAAA,EACF;AACA,EAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,iBAAA,GACnB,OAAA,CAAQ,MAAA,CAAO,CAAC,EAAE,QAAA,EAAS,KAAM,CAAC,qBAAA,CAAsB,QAAQ,CAAC,CAAA,GACjE,OAAA;AACN;AAMO,SAAS,gBAAA,CACd,QAAA,EACA,SAAA,EACA,IAAA,EACwB;AACxB,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAkC;AACpD,EAAA,KAAA,MAAW,SAAA,IAAa,CAAC,GAAI,QAAA,CAAS,UAAA,IAAc,EAAC,EAAI,GAAI,SAAA,CAAU,UAAA,IAAc,EAAG,CAAA,EAAG;AACzF,IAAA,MAAM,QAAA,GAAW,gBAAA,CAAiB,SAAA,EAAW,IAAI,CAAA;AACjD,IAAA,KAAA,CAAM,GAAA,CAAI,GAAG,QAAA,EAAU,EAAE,IAAI,QAAA,EAAU,IAAI,IAAI,SAAS,CAAA;AAAA,EAC1D;AACA,EAAA,OAAO,CAAC,GAAG,KAAA,CAAM,MAAA,EAAQ,CAAA;AAC3B;;"}

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

@@ -3,20 +3,28 @@
 const constructors = require('../../../domain/ir/constructors.cjs');
 const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
 const parameterObject = require('../../../domain/openapi/parameter-object.cjs');
+const outputFixes = require('../../../domain/output-fixes.cjs');
 const schemaTransform = require('../schema/schema-transform.cjs');
 const mediaType = require('./media-type.cjs');
 
-function querystringType(parameter, location, context) {
+function contentParameterType(parameter, location, context) {
   const [mediaType$1, entry] = Object.entries(parameter.content ?? {})[0] ?? [];
   if (mediaType$1 === void 0 || entry === void 0) {
     return constructors.irKeyword("string");
   }
-  const path = jsonPointer.createRef([location.path, "content", mediaType$1]);
+  const path = jsonPointer.appendPointer(location.path, ["content", mediaType$1]);
   return mediaType.contentEntryType(entry, { ...location, path }, context);
 }
-function parameterType(parameter, location, context) {
+function isTypedByContent(parameter, context) {
   if (parameter.in === parameterObject.QUERYSTRING_LOCATION) {
-    return querystringType(parameter, location, context);
+    return true;
+  }
+  const hasContent = parameter.schema === void 0 && parameter.content !== void 0;
+  return hasContent && context.options.fixes.has(outputFixes.FIX.PARAMETER_CONTENT);
+}
+function parameterType(parameter, location, context) {
+  if (isTypedByContent(parameter, context)) {
+    return contentParameterType(parameter, location, context);
   }
   return parameter.schema ? schemaTransform.transformSchema(parameter.schema, location, context) : constructors.irKeyword("string");
 }

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

@@ -1 +1 @@
-{"version":3,"file":"parameter.cjs","sources":["../../../../src/application/transform/document/parameter.ts"],"sourcesContent":["import { irKeyword } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ParameterObject,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * An `in: querystring` parameter (OpenAPI 3.2): the whole query string, typed by the schema of its\n * one `content` media type (ADR-020). Without one it is `string`, the query string as text.\n */\nfunction querystringType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];\n  if (mediaType === undefined || entry === undefined) {\n    return irKeyword(\"string\");\n  }\n  const path = createRef([location.path, \"content\", mediaType]);\n  return contentEntryType(entry, { ...location, path }, context);\n}\n\n/**\n * A parameter's type (OpenAPI 3.2 §4.8.12). Without a schema it is `string`, not `unknown`:\n * query, path, header and cookie values all arrive as text. `content` is read only for\n * `in: querystring`; other parameters with `content` keep their pre-3.2 type.\n */\nexport function parameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (parameter.in === QUERYSTRING_LOCATION) {\n    return querystringType(parameter, location, context);\n  }\n  return parameter.schema\n    ? transformSchema(parameter.schema, location, context)\n    : irKeyword(\"string\");\n}\n"],"names":["mediaType","irKeyword","createRef","contentEntryType","QUERYSTRING_LOCATION","transformSchema"],"mappings":";;;;;;;;AAeA,SAAS,eAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,CAACA,WAAA,EAAW,KAAK,CAAA,GAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,IAAW,EAAE,CAAA,CAAE,CAAC,KAAK,EAAC;AAC1E,EAAA,IAAIA,WAAA,KAAc,MAAA,IAAa,KAAA,KAAU,MAAA,EAAW;AAClD,IAAA,OAAOC,uBAAU,QAAQ,CAAA;AAAA,EAC3B;AACA,EAAA,MAAM,OAAOC,qBAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAWF,WAAS,CAAC,CAAA;AAC5D,EAAA,OAAOG,2BAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;AAOO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,SAAA,CAAU,OAAOC,oCAAA,EAAsB;AACzC,IAAA,OAAO,eAAA,CAAgB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAAA,EACrD;AACA,EAAA,OAAO,SAAA,CAAU,SACbC,+BAAA,CAAgB,SAAA,CAAU,QAAQ,QAAA,EAAU,OAAO,CAAA,GACnDJ,sBAAA,CAAU,QAAQ,CAAA;AACxB;;"}
+{"version":3,"file":"parameter.cjs","sources":["../../../../src/application/transform/document/parameter.ts"],"sourcesContent":["import { irKeyword } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { appendPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ParameterObject,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * A parameter typed by the schema of its one `content` media type. An `in: querystring` parameter\n * (OpenAPI 3.2) is the whole query string (ADR-020); without a media type it is `string`, the\n * query string as text. With the `parameter-content` fix, any other parameter with `content`\n * (OpenAPI 3.0 and later, for a JSON value in a query parameter) is typed the same way.\n */\nfunction contentParameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];\n  if (mediaType === undefined || entry === undefined) {\n    return irKeyword(\"string\");\n  }\n  const path = appendPointer(location.path, [\"content\", mediaType]);\n  return contentEntryType(entry, { ...location, path }, context);\n}\n\nfunction isTypedByContent(parameter: ParameterObject, context: SchemaContext): boolean {\n  if (parameter.in === QUERYSTRING_LOCATION) {\n    return true;\n  }\n  const hasContent = parameter.schema === undefined && parameter.content !== undefined;\n  return hasContent && context.options.fixes.has(FIX.PARAMETER_CONTENT);\n}\n\n/**\n * A parameter's type (OpenAPI 3.2 §4.8.12). Without a schema it is `string`, not `unknown`:\n * query, path, header and cookie values all arrive as text. `content` is read for\n * `in: querystring`, and with the `parameter-content` fix for every parameter; without the fix\n * other parameters with `content` keep the original's `string`.\n */\nexport function parameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (isTypedByContent(parameter, context)) {\n    return contentParameterType(parameter, location, context);\n  }\n  return parameter.schema\n    ? transformSchema(parameter.schema, location, context)\n    : irKeyword(\"string\");\n}\n"],"names":["mediaType","irKeyword","appendPointer","contentEntryType","QUERYSTRING_LOCATION","FIX","transformSchema"],"mappings":";;;;;;;;;AAkBA,SAAS,oBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,CAACA,WAAA,EAAW,KAAK,CAAA,GAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,IAAW,EAAE,CAAA,CAAE,CAAC,KAAK,EAAC;AAC1E,EAAA,IAAIA,WAAA,KAAc,MAAA,IAAa,KAAA,KAAU,MAAA,EAAW;AAClD,IAAA,OAAOC,uBAAU,QAAQ,CAAA;AAAA,EAC3B;AACA,EAAA,MAAM,OAAOC,yBAAA,CAAc,QAAA,CAAS,MAAM,CAAC,SAAA,EAAWF,WAAS,CAAC,CAAA;AAChE,EAAA,OAAOG,2BAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;AAEA,SAAS,gBAAA,CAAiB,WAA4B,OAAA,EAAiC;AACrF,EAAA,IAAI,SAAA,CAAU,OAAOC,oCAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAA,GAAa,SAAA,CAAU,MAAA,KAAW,MAAA,IAAa,UAAU,OAAA,KAAY,MAAA;AAC3E,EAAA,OAAO,cAAc,OAAA,CAAQ,OAAA,CAAQ,KAAA,CAAM,GAAA,CAAIC,gBAAI,iBAAiB,CAAA;AACtE;AAQO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,gBAAA,CAAiB,SAAA,EAAW,OAAO,CAAA,EAAG;AACxC,IAAA,OAAO,oBAAA,CAAqB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAAA,EAC1D;AACA,EAAA,OAAO,SAAA,CAAU,SACbC,+BAAA,CAAgB,SAAA,CAAU,QAAQ,QAAA,EAAU,OAAO,CAAA,GACnDL,sBAAA,CAAU,QAAQ,CAAA;AACxB;;"}

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

@@ -1,20 +1,28 @@
 import { irKeyword } from '../../../domain/ir/constructors.mjs';
-import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { appendPointer } from '../../../domain/openapi/json-pointer.mjs';
 import { QUERYSTRING_LOCATION } from '../../../domain/openapi/parameter-object.mjs';
+import { FIX } from '../../../domain/output-fixes.mjs';
 import { transformSchema } from '../schema/schema-transform.mjs';
 import { contentEntryType } from './media-type.mjs';
 
-function querystringType(parameter, location, context) {
+function contentParameterType(parameter, location, context) {
   const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];
   if (mediaType === void 0 || entry === void 0) {
     return irKeyword("string");
   }
-  const path = createRef([location.path, "content", mediaType]);
+  const path = appendPointer(location.path, ["content", mediaType]);
   return contentEntryType(entry, { ...location, path }, context);
 }
-function parameterType(parameter, location, context) {
+function isTypedByContent(parameter, context) {
   if (parameter.in === QUERYSTRING_LOCATION) {
-    return querystringType(parameter, location, context);
+    return true;
+  }
+  const hasContent = parameter.schema === void 0 && parameter.content !== void 0;
+  return hasContent && context.options.fixes.has(FIX.PARAMETER_CONTENT);
+}
+function parameterType(parameter, location, context) {
+  if (isTypedByContent(parameter, context)) {
+    return contentParameterType(parameter, location, context);
   }
   return parameter.schema ? transformSchema(parameter.schema, location, context) : irKeyword("string");
 }

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

@@ -1 +1 @@
-{"version":3,"file":"parameter.mjs","sources":["../../../../src/application/transform/document/parameter.ts"],"sourcesContent":["import { irKeyword } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ParameterObject,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * An `in: querystring` parameter (OpenAPI 3.2): the whole query string, typed by the schema of its\n * one `content` media type (ADR-020). Without one it is `string`, the query string as text.\n */\nfunction querystringType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];\n  if (mediaType === undefined || entry === undefined) {\n    return irKeyword(\"string\");\n  }\n  const path = createRef([location.path, \"content\", mediaType]);\n  return contentEntryType(entry, { ...location, path }, context);\n}\n\n/**\n * A parameter's type (OpenAPI 3.2 §4.8.12). Without a schema it is `string`, not `unknown`:\n * query, path, header and cookie values all arrive as text. `content` is read only for\n * `in: querystring`; other parameters with `content` keep their pre-3.2 type.\n */\nexport function parameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (parameter.in === QUERYSTRING_LOCATION) {\n    return querystringType(parameter, location, context);\n  }\n  return parameter.schema\n    ? transformSchema(parameter.schema, location, context)\n    : irKeyword(\"string\");\n}\n"],"names":[],"mappings":";;;;;;AAeA,SAAS,eAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,CAAC,SAAA,EAAW,KAAK,CAAA,GAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,IAAW,EAAE,CAAA,CAAE,CAAC,KAAK,EAAC;AAC1E,EAAA,IAAI,SAAA,KAAc,MAAA,IAAa,KAAA,KAAU,MAAA,EAAW;AAClD,IAAA,OAAO,UAAU,QAAQ,CAAA;AAAA,EAC3B;AACA,EAAA,MAAM,OAAO,SAAA,CAAU,CAAC,SAAS,IAAA,EAAM,SAAA,EAAW,SAAS,CAAC,CAAA;AAC5D,EAAA,OAAO,iBAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;AAOO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,SAAA,CAAU,OAAO,oBAAA,EAAsB;AACzC,IAAA,OAAO,eAAA,CAAgB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAAA,EACrD;AACA,EAAA,OAAO,SAAA,CAAU,SACb,eAAA,CAAgB,SAAA,CAAU,QAAQ,QAAA,EAAU,OAAO,CAAA,GACnD,SAAA,CAAU,QAAQ,CAAA;AACxB;;"}
+{"version":3,"file":"parameter.mjs","sources":["../../../../src/application/transform/document/parameter.ts"],"sourcesContent":["import { irKeyword } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { appendPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  type ParameterObject,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport type { SchemaContext, SchemaLocation } from \"../schema/schema-context.js\";\nimport { transformSchema } from \"../schema/schema-transform.js\";\nimport { contentEntryType } from \"./media-type.js\";\n\n/**\n * A parameter typed by the schema of its one `content` media type. An `in: querystring` parameter\n * (OpenAPI 3.2) is the whole query string (ADR-020); without a media type it is `string`, the\n * query string as text. With the `parameter-content` fix, any other parameter with `content`\n * (OpenAPI 3.0 and later, for a JSON value in a query parameter) is typed the same way.\n */\nfunction contentParameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  const [mediaType, entry] = Object.entries(parameter.content ?? {})[0] ?? [];\n  if (mediaType === undefined || entry === undefined) {\n    return irKeyword(\"string\");\n  }\n  const path = appendPointer(location.path, [\"content\", mediaType]);\n  return contentEntryType(entry, { ...location, path }, context);\n}\n\nfunction isTypedByContent(parameter: ParameterObject, context: SchemaContext): boolean {\n  if (parameter.in === QUERYSTRING_LOCATION) {\n    return true;\n  }\n  const hasContent = parameter.schema === undefined && parameter.content !== undefined;\n  return hasContent && context.options.fixes.has(FIX.PARAMETER_CONTENT);\n}\n\n/**\n * A parameter's type (OpenAPI 3.2 §4.8.12). Without a schema it is `string`, not `unknown`:\n * query, path, header and cookie values all arrive as text. `content` is read for\n * `in: querystring`, and with the `parameter-content` fix for every parameter; without the fix\n * other parameters with `content` keep the original's `string`.\n */\nexport function parameterType(\n  parameter: ParameterObject,\n  location: SchemaLocation,\n  context: SchemaContext,\n): IrType {\n  if (isTypedByContent(parameter, context)) {\n    return contentParameterType(parameter, location, context);\n  }\n  return parameter.schema\n    ? transformSchema(parameter.schema, location, context)\n    : irKeyword(\"string\");\n}\n"],"names":[],"mappings":";;;;;;;AAkBA,SAAS,oBAAA,CACP,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM,CAAC,SAAA,EAAW,KAAK,CAAA,GAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,CAAU,OAAA,IAAW,EAAE,CAAA,CAAE,CAAC,KAAK,EAAC;AAC1E,EAAA,IAAI,SAAA,KAAc,MAAA,IAAa,KAAA,KAAU,MAAA,EAAW;AAClD,IAAA,OAAO,UAAU,QAAQ,CAAA;AAAA,EAC3B;AACA,EAAA,MAAM,OAAO,aAAA,CAAc,QAAA,CAAS,MAAM,CAAC,SAAA,EAAW,SAAS,CAAC,CAAA;AAChE,EAAA,OAAO,iBAAiB,KAAA,EAAO,EAAE,GAAG,QAAA,EAAU,IAAA,IAAQ,OAAO,CAAA;AAC/D;AAEA,SAAS,gBAAA,CAAiB,WAA4B,OAAA,EAAiC;AACrF,EAAA,IAAI,SAAA,CAAU,OAAO,oBAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAA,GAAa,SAAA,CAAU,MAAA,KAAW,MAAA,IAAa,UAAU,OAAA,KAAY,MAAA;AAC3E,EAAA,OAAO,cAAc,OAAA,CAAQ,OAAA,CAAQ,KAAA,CAAM,GAAA,CAAI,IAAI,iBAAiB,CAAA;AACtE;AAQO,SAAS,aAAA,CACd,SAAA,EACA,QAAA,EACA,OAAA,EACQ;AACR,EAAA,IAAI,gBAAA,CAAiB,SAAA,EAAW,OAAO,CAAA,EAAG;AACxC,IAAA,OAAO,oBAAA,CAAqB,SAAA,EAAW,QAAA,EAAU,OAAO,CAAA;AAAA,EAC1D;AACA,EAAA,OAAO,SAAA,CAAU,SACb,eAAA,CAAgB,SAAA,CAAU,QAAQ,QAAA,EAAU,OAAO,CAAA,GACnD,SAAA,CAAU,QAAQ,CAAA;AACxB;;"}

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

@@ -5,15 +5,13 @@ const propertyName = require('../../../domain/ir/property-name.cjs');
 const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
 const parameterObject = require('../../../domain/openapi/parameter-object.cjs');
 const outputFixes = require('../../../domain/output-fixes.cjs');
-const refType = require('../ref-type.cjs');
 const schemaComment = require('../schema-comment.cjs');
 const explodedQuery = require('./exploded-query.cjs');
 const parameter = require('./parameter.cjs');
+const parameterEntries = require('./parameter-entries.cjs');
+const referencedParameter = require('./referenced-parameter.cjs');
 
 const PATH_TEMPLATE_RE = /\{([^{}]+)\}/g;
-function resolveParameter(parameter, context) {
-  return "$ref" in parameter ? context.refs.resolve(parameter.$ref) : parameter;
-}
 function pathTemplateParameters(path) {
   return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({
     name: match.slice(1, -1),
@@ -29,7 +27,7 @@ function withPathTemplateParameters(parameters, location, context) {
   }
   for (const parameter of pathTemplateParameters(location.path)) {
     const isDefined = result.some((candidate) => {
-      const resolved = resolveParameter(candidate, context);
+      const resolved = parameterEntries.resolveParameter(candidate, context.refs);
       return resolved?.in === "path" && resolved.name === parameter.name;
     });
     if (!isDefined) {
@@ -38,33 +36,12 @@ function withPathTemplateParameters(parameters, location, context) {
   }
   return result;
 }
-function isDeprecatedParameter(parameter) {
-  const schema = parameter?.schema;
-  return Boolean(parameter?.deprecated || schema?.deprecated);
-}
-function parameterEntries(parameters, context) {
-  const entries = parameters.map((original) => ({
-    original,
-    resolved: resolveParameter(original, context)
-  }));
-  if (context.options.alphabetize) {
-    entries.sort(
-      (left, right) => (left.resolved?.name ?? "").localeCompare(right.resolved?.name ?? "")
-    );
-  }
-  return context.options.excludeDeprecated ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved)) : entries;
-}
 function parameterName(name) {
   return typeof name === "string" || typeof name === "number" ? propertyName.toPropertyName(name) : { kind: "string", value: String(name) };
 }
-function referencedParameterType(ref, resolved) {
-  const isParameter = !resolved.$ref;
-  const parameter = isParameter ? { in: resolved.in, name: resolved.name } : null;
-  return refType.refType(ref, { parameter });
-}
 function entryType({ original, resolved }, location, context) {
-  const path = jsonPointer.createRef([location.path, "parameters", resolved.in, resolved.name]);
-  return "$ref" in original ? referencedParameterType(original.$ref, resolved) : parameter.parameterType(resolved, { ...location, path }, context);
+  const path = jsonPointer.appendPointer(location.path, ["parameters", resolved.in, resolved.name]);
+  return "$ref" in original ? referencedParameter.referencedParameterType(original.$ref, resolved, context) : parameter.parameterType(resolved, { ...location, path }, context);
 }
 function parameterMember(entry, location, context) {
   const { resolved } = entry;
@@ -129,7 +106,7 @@ function locationMember(parameterIn, entries, location, context) {
   });
 }
 function parametersMember(parameters, location, context) {
-  const entries = parameterEntries(
+  const entries = parameterEntries.parameterEntries(
     withPathTemplateParameters(parameters, location, context),
     context
   );

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

@@ -1 +1 @@
-{"version":3,"file":"parameters.cjs","sources":["../../../../src/application/transform/document/parameters.ts"],"sourcesContent":["import {\n  irIntersection,\n  irKeyword,\n  irObject,\n  irProperty,\n  irReference,\n} from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertyName, IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  PARAMETER_LOCATIONS,\n  type ParameterLocation,\n  type ParameterObject,\n  type ParameterOrReference,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport type { SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { isExplodedQueryObject } from \"./exploded-query.js\";\nimport { parameterType } from \"./parameter.js\";\n\n/** `[^{}]` keeps the scan linear: `[^}]` retried from every `{` of a long run of them. */\nconst PATH_TEMPLATE_RE = /\\{([^{}]+)\\}/g;\n\n/** A parameter as written in the document, and the object its `$ref` points to. */\ninterface ParameterEntry {\n  readonly original: ParameterOrReference;\n  readonly resolved: ParameterObject | undefined;\n}\n\n/** An entry whose `$ref` resolved, so its location and name are known. */\ntype ResolvedEntry = ParameterEntry & { readonly resolved: ParameterObject };\n\nfunction resolveParameter(\n  parameter: ParameterOrReference,\n  context: TransformContext,\n): ParameterObject | undefined {\n  return \"$ref\" in parameter\n    ? (context.refs.resolve(parameter.$ref) as ParameterObject | undefined)\n    : parameter;\n}\n\n/** Required string parameters for every `{name}` in a path template. */\nfunction pathTemplateParameters(path: string): ParameterObject[] {\n  return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({\n    name: match.slice(1, -1),\n    in: \"path\",\n    required: true,\n    schema: { type: \"string\" },\n  }));\n}\n\n/** `--generate-path-params`: add the path template parameters the list does not define. */\nfunction withPathTemplateParameters(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): ParameterOrReference[] {\n  const result = [...parameters];\n  if (!context.options.generatePathParams || !location.path) {\n    return result;\n  }\n  for (const parameter of pathTemplateParameters(location.path)) {\n    const isDefined = result.some((candidate) => {\n      const resolved = resolveParameter(candidate, context);\n      return resolved?.in === \"path\" && resolved.name === parameter.name;\n    });\n    if (!isDefined) {\n      result.push(parameter);\n    }\n  }\n  return result;\n}\n\nfunction isDeprecatedParameter(parameter: ParameterObject | undefined): boolean {\n  const schema = parameter?.schema as SchemaObject | undefined;\n  return Boolean(parameter?.deprecated || schema?.deprecated);\n}\n\n/** Resolved parameters, sorted for `--alphabetize`, without deprecated ones if excluded. */\nfunction parameterEntries(\n  parameters: readonly ParameterOrReference[],\n  context: TransformContext,\n): ParameterEntry[] {\n  const entries = parameters.map((original) => ({\n    original,\n    resolved: resolveParameter(original, context),\n  }));\n  if (context.options.alphabetize) {\n    // Unlike map keys, the original sorts parameters with the default locale's `localeCompare`.\n    entries.sort((left, right) =>\n      (left.resolved?.name ?? \"\").localeCompare(right.resolved?.name ?? \"\"),\n    );\n  }\n  return context.options.excludeDeprecated\n    ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved))\n    : entries;\n}\n\n/** The original quotes a name that is not text (a missing name prints as `\"undefined\"`). */\nfunction parameterName(name: unknown): IrPropertyName {\n  return typeof name === \"string\" || typeof name === \"number\"\n    ? toPropertyName(name)\n    : { kind: \"string\", value: String(name) };\n}\n\nfunction referencedParameterType(ref: string, resolved: ParameterObject): IrType {\n  // A `$ref` that resolves to another `$ref` is not a parameter object yet: index it as a path.\n  const isParameter = !(resolved as { $ref?: unknown }).$ref;\n  const parameter = isParameter ? { in: resolved.in, name: resolved.name } : null;\n  return refType(ref, { parameter });\n}\n\nfunction entryType(\n  { original, resolved }: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const path = createRef([location.path, \"parameters\", resolved.in, resolved.name]);\n  return \"$ref\" in original\n    ? referencedParameterType(original.$ref, resolved)\n    : parameterType(resolved, { ...location, path }, context);\n}\n\nfunction parameterMember(\n  entry: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const { resolved } = entry;\n  const property = irProperty(parameterName(resolved.name), entryType(entry, location, context), {\n    isOptional: resolved.in !== \"path\" && !resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, resolved);\n}\n\n/**\n * The `query` member typed by an `in: querystring` parameter (OpenAPI 3.2, ADR-020): the parameter\n * is the whole query string. Null when there is none, or when `in: query` parameters sit next to\n * it, which 3.2 does not allow; those keep their types, and a warning names the parameter.\n */\nfunction querystringMember(\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const querystring = entries.find(\n    (entry): entry is ResolvedEntry => entry.resolved?.in === QUERYSTRING_LOCATION,\n  );\n  if (!querystring || entries.some((entry) => entry.resolved?.in === \"query\")) {\n    return null;\n  }\n  const property = irProperty(toPropertyName(\"query\"), entryType(querystring, location, context), {\n    isOptional: !querystring.resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, querystring.resolved);\n}\n\n/** With `exploded-query-objects`, whether the parameter's object keys are keys of `query`. */\nfunction isExplodedEntry(entry: ResolvedEntry, context: TransformContext): boolean {\n  return (\n    context.options.fixes.has(FIX.EXPLODED_QUERY_OBJECTS) &&\n    isExplodedQueryObject(entry.resolved, context.refs)\n  );\n}\n\n/**\n * An exploded object parameter's part of `query`: its object type. A parameter that may be left\n * out sends none of its keys then, so they are optional: `Partial<…>`.\n */\nfunction explodedPart(\n  entry: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const type = entryType(entry, location, context);\n  return entry.resolved.required ? type : irReference(\"Partial\", [type]);\n}\n\n/** A location's parameters as members, and the object types of its exploded parameters. */\ninterface LocationParts {\n  readonly members: readonly IrPropertySignature[];\n  readonly exploded: readonly IrType[];\n  readonly isOptional: boolean;\n}\n\n/** Each parameter in document order, so the declarations they add keep their order. */\nfunction locationParts(\n  entries: readonly ResolvedEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): LocationParts {\n  const members: IrPropertySignature[] = [];\n  const exploded: IrType[] = [];\n  let isOptional = true;\n  for (const entry of entries) {\n    if (isExplodedEntry(entry, context)) {\n      exploded.push(explodedPart(entry, location, context));\n      isOptional &&= !entry.resolved.required;\n      continue;\n    }\n    const member = parameterMember(entry, location, context);\n    members.push(member);\n    isOptional &&= member.isOptional;\n  }\n  return { members, exploded, isOptional };\n}\n\n/** The members' object, intersected with the exploded parameters' types; `never` for none. */\nfunction locationType({ members, exploded }: LocationParts): IrType {\n  const types = [...(members.length > 0 ? [irObject(members)] : []), ...exploded];\n  const [first] = types;\n  if (first === undefined) {\n    return irKeyword(\"never\");\n  }\n  return types.length === 1 ? first : irIntersection(types);\n}\n\n/** One location's parameters; optional when all of them are, and `never` when there are none. */\nfunction locationMember(\n  parameterIn: ParameterLocation,\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const located = entries.filter(\n    (entry): entry is ResolvedEntry => entry.resolved?.in === parameterIn,\n  );\n  const parts = locationParts(located, location, context);\n  return irProperty(toPropertyName(parameterIn), locationType(parts), {\n    isOptional: parts.isOptional,\n    isReadonly: context.options.immutable,\n  });\n}\n\n/**\n * The `parameters` property of an operation or path item: one member per location, each an object\n * of that location's parameters. `location.path` is the path template for\n * `--generate-path-params`.\n */\nexport function parametersMember(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const entries = parameterEntries(\n    withPathTemplateParameters(parameters, location, context),\n    context,\n  );\n  const querystring = querystringMember(entries, location, context);\n  const members = PARAMETER_LOCATIONS.map((parameterIn) =>\n    parameterIn === \"query\" && querystring\n      ? querystring\n      : locationMember(parameterIn, entries, location, context),\n  );\n  return irProperty(toPropertyName(\"parameters\"), irObject(members), {\n    isReadonly: context.options.immutable,\n  });\n}\n"],"names":["toPropertyName","refType","createRef","parameterType","irProperty","withSchemaComment","QUERYSTRING_LOCATION","FIX","isExplodedQueryObject","irReference","irObject","irKeyword","irIntersection","PARAMETER_LOCATIONS"],"mappings":"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"}
+{"version":3,"file":"parameters.cjs","sources":["../../../../src/application/transform/document/parameters.ts"],"sourcesContent":["import {\n  irIntersection,\n  irKeyword,\n  irObject,\n  irProperty,\n  irReference,\n} from \"../../../domain/ir/constructors.js\";\nimport type { IrPropertyName, IrPropertySignature, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { appendPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport {\n  PARAMETER_LOCATIONS,\n  type ParameterLocation,\n  type ParameterObject,\n  type ParameterOrReference,\n  QUERYSTRING_LOCATION,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport { FIX } from \"../../../domain/output-fixes.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport { withSchemaComment } from \"../schema-comment.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { isExplodedQueryObject } from \"./exploded-query.js\";\nimport { parameterType } from \"./parameter.js\";\nimport {\n  type ParameterEntry,\n  parameterEntries,\n  type ResolvedEntry,\n  resolveParameter,\n} from \"./parameter-entries.js\";\nimport { referencedParameterType } from \"./referenced-parameter.js\";\n\n/** `[^{}]` keeps the scan linear: `[^}]` retried from every `{` of a long run of them. */\nconst PATH_TEMPLATE_RE = /\\{([^{}]+)\\}/g;\n\n/** Required string parameters for every `{name}` in a path template. */\nfunction pathTemplateParameters(path: string): ParameterObject[] {\n  return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({\n    name: match.slice(1, -1),\n    in: \"path\",\n    required: true,\n    schema: { type: \"string\" },\n  }));\n}\n\n/** `--generate-path-params`: add the path template parameters the list does not define. */\nfunction withPathTemplateParameters(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): ParameterOrReference[] {\n  const result = [...parameters];\n  if (!context.options.generatePathParams || !location.path) {\n    return result;\n  }\n  for (const parameter of pathTemplateParameters(location.path)) {\n    const isDefined = result.some((candidate) => {\n      const resolved = resolveParameter(candidate, context.refs);\n      return resolved?.in === \"path\" && resolved.name === parameter.name;\n    });\n    if (!isDefined) {\n      result.push(parameter);\n    }\n  }\n  return result;\n}\n\n/** The original quotes a name that is not text (a missing name prints as `\"undefined\"`). */\nfunction parameterName(name: unknown): IrPropertyName {\n  return typeof name === \"string\" || typeof name === \"number\"\n    ? toPropertyName(name)\n    : { kind: \"string\", value: String(name) };\n}\n\nfunction entryType(\n  { original, resolved }: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const path = appendPointer(location.path, [\"parameters\", resolved.in, resolved.name]);\n  return \"$ref\" in original\n    ? referencedParameterType(original.$ref, resolved, context)\n    : parameterType(resolved, { ...location, path }, context);\n}\n\nfunction parameterMember(\n  entry: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const { resolved } = entry;\n  const property = irProperty(parameterName(resolved.name), entryType(entry, location, context), {\n    isOptional: resolved.in !== \"path\" && !resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, resolved);\n}\n\n/**\n * The `query` member typed by an `in: querystring` parameter (OpenAPI 3.2, ADR-020): the parameter\n * is the whole query string. Null when there is none, or when `in: query` parameters sit next to\n * it, which 3.2 does not allow; those keep their types, and a warning names the parameter.\n */\nfunction querystringMember(\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const querystring = entries.find(\n    (entry): entry is ResolvedEntry => entry.resolved?.in === QUERYSTRING_LOCATION,\n  );\n  if (!querystring || entries.some((entry) => entry.resolved?.in === \"query\")) {\n    return null;\n  }\n  const property = irProperty(toPropertyName(\"query\"), entryType(querystring, location, context), {\n    isOptional: !querystring.resolved.required,\n    isReadonly: context.options.immutable,\n  });\n  return withSchemaComment(property, querystring.resolved);\n}\n\n/** With `exploded-query-objects`, whether the parameter's object keys are keys of `query`. */\nfunction isExplodedEntry(entry: ResolvedEntry, context: TransformContext): boolean {\n  return (\n    context.options.fixes.has(FIX.EXPLODED_QUERY_OBJECTS) &&\n    isExplodedQueryObject(entry.resolved, context.refs)\n  );\n}\n\n/**\n * An exploded object parameter's part of `query`: its object type. A parameter that may be left\n * out sends none of its keys then, so they are optional: `Partial<…>`.\n */\nfunction explodedPart(\n  entry: ResolvedEntry,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const type = entryType(entry, location, context);\n  return entry.resolved.required ? type : irReference(\"Partial\", [type]);\n}\n\n/** A location's parameters as members, and the object types of its exploded parameters. */\ninterface LocationParts {\n  readonly members: readonly IrPropertySignature[];\n  readonly exploded: readonly IrType[];\n  readonly isOptional: boolean;\n}\n\n/** Each parameter in document order, so the declarations they add keep their order. */\nfunction locationParts(\n  entries: readonly ResolvedEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): LocationParts {\n  const members: IrPropertySignature[] = [];\n  const exploded: IrType[] = [];\n  let isOptional = true;\n  for (const entry of entries) {\n    if (isExplodedEntry(entry, context)) {\n      exploded.push(explodedPart(entry, location, context));\n      isOptional &&= !entry.resolved.required;\n      continue;\n    }\n    const member = parameterMember(entry, location, context);\n    members.push(member);\n    isOptional &&= member.isOptional;\n  }\n  return { members, exploded, isOptional };\n}\n\n/** The members' object, intersected with the exploded parameters' types; `never` for none. */\nfunction locationType({ members, exploded }: LocationParts): IrType {\n  const types = [...(members.length > 0 ? [irObject(members)] : []), ...exploded];\n  const [first] = types;\n  if (first === undefined) {\n    return irKeyword(\"never\");\n  }\n  return types.length === 1 ? first : irIntersection(types);\n}\n\n/** One location's parameters; optional when all of them are, and `never` when there are none. */\nfunction locationMember(\n  parameterIn: ParameterLocation,\n  entries: readonly ParameterEntry[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const located = entries.filter(\n    (entry): entry is ResolvedEntry => entry.resolved?.in === parameterIn,\n  );\n  const parts = locationParts(located, location, context);\n  return irProperty(toPropertyName(parameterIn), locationType(parts), {\n    isOptional: parts.isOptional,\n    isReadonly: context.options.immutable,\n  });\n}\n\n/**\n * The `parameters` property of an operation or path item: one member per location, each an object\n * of that location's parameters. `location.path` is the path template for\n * `--generate-path-params`.\n */\nexport function parametersMember(\n  parameters: readonly ParameterOrReference[],\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const entries = parameterEntries(\n    withPathTemplateParameters(parameters, location, context),\n    context,\n  );\n  const querystring = querystringMember(entries, location, context);\n  const members = PARAMETER_LOCATIONS.map((parameterIn) =>\n    parameterIn === \"query\" && querystring\n      ? querystring\n      : locationMember(parameterIn, entries, location, context),\n  );\n  return irProperty(toPropertyName(\"parameters\"), irObject(members), {\n    isReadonly: context.options.immutable,\n  });\n}\n"],"names":["resolveParameter","toPropertyName","appendPointer","referencedParameterType","parameterType","irProperty","withSchemaComment","QUERYSTRING_LOCATION","FIX","isExplodedQueryObject","irReference","irObject","irKeyword","irIntersection","parameterEntries","PARAMETER_LOCATIONS"],"mappings":"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"}

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

@@ -1,17 +1,15 @@
 import { irProperty, irObject, irKeyword, irIntersection, irReference } from '../../../domain/ir/constructors.mjs';
 import { toPropertyName } from '../../../domain/ir/property-name.mjs';
-import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { appendPointer } from '../../../domain/openapi/json-pointer.mjs';
 import { PARAMETER_LOCATIONS, QUERYSTRING_LOCATION } from '../../../domain/openapi/parameter-object.mjs';
 import { FIX } from '../../../domain/output-fixes.mjs';
-import { refType } from '../ref-type.mjs';
 import { withSchemaComment } from '../schema-comment.mjs';
 import { isExplodedQueryObject } from './exploded-query.mjs';
 import { parameterType } from './parameter.mjs';
+import { parameterEntries, resolveParameter } from './parameter-entries.mjs';
+import { referencedParameterType } from './referenced-parameter.mjs';
 
 const PATH_TEMPLATE_RE = /\{([^{}]+)\}/g;
-function resolveParameter(parameter, context) {
-  return "$ref" in parameter ? context.refs.resolve(parameter.$ref) : parameter;
-}
 function pathTemplateParameters(path) {
   return (path.match(PATH_TEMPLATE_RE) ?? []).map((match) => ({
     name: match.slice(1, -1),
@@ -27,7 +25,7 @@ function withPathTemplateParameters(parameters, location, context) {
   }
   for (const parameter of pathTemplateParameters(location.path)) {
     const isDefined = result.some((candidate) => {
-      const resolved = resolveParameter(candidate, context);
+      const resolved = resolveParameter(candidate, context.refs);
       return resolved?.in === "path" && resolved.name === parameter.name;
     });
     if (!isDefined) {
@@ -36,33 +34,12 @@ function withPathTemplateParameters(parameters, location, context) {
   }
   return result;
 }
-function isDeprecatedParameter(parameter) {
-  const schema = parameter?.schema;
-  return Boolean(parameter?.deprecated || schema?.deprecated);
-}
-function parameterEntries(parameters, context) {
-  const entries = parameters.map((original) => ({
-    original,
-    resolved: resolveParameter(original, context)
-  }));
-  if (context.options.alphabetize) {
-    entries.sort(
-      (left, right) => (left.resolved?.name ?? "").localeCompare(right.resolved?.name ?? "")
-    );
-  }
-  return context.options.excludeDeprecated ? entries.filter(({ resolved }) => !isDeprecatedParameter(resolved)) : entries;
-}
 function parameterName(name) {
   return typeof name === "string" || typeof name === "number" ? toPropertyName(name) : { kind: "string", value: String(name) };
 }
-function referencedParameterType(ref, resolved) {
-  const isParameter = !resolved.$ref;
-  const parameter = isParameter ? { in: resolved.in, name: resolved.name } : null;
-  return refType(ref, { parameter });
-}
 function entryType({ original, resolved }, location, context) {
-  const path = createRef([location.path, "parameters", resolved.in, resolved.name]);
-  return "$ref" in original ? referencedParameterType(original.$ref, resolved) : parameterType(resolved, { ...location, path }, context);
+  const path = appendPointer(location.path, ["parameters", resolved.in, resolved.name]);
+  return "$ref" in original ? referencedParameterType(original.$ref, resolved, context) : parameterType(resolved, { ...location, path }, context);
 }
 function parameterMember(entry, location, context) {
   const { resolved } = entry;