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

package/dist/domain/openapi/document-places.cjs

@@ -0,0 +1,55 @@
+'use strict';
+
+const pathItemObject = require('./path-item-object.cjs');
+
+const OPERATION_KEYS = /* @__PURE__ */ new Set([...pathItemObject.HTTP_METHODS, pathItemObject.QUERY_METHOD]);
+const FIELDS = {
+  root: {
+    paths: "namedPathItems",
+    webhooks: "namedPathItems",
+    components: "components",
+    $defs: "other"
+  },
+  components: {
+    parameters: "input",
+    requestBodies: "input",
+    pathItems: "namedPathItems",
+    callbacks: "namedCallbacks"
+  },
+  pathItem: { parameters: "input", [pathItemObject.ADDITIONAL_OPERATIONS_KEY]: "namedOperations" },
+  operation: { parameters: "input", requestBody: "input", callbacks: "namedCallbacks" }
+};
+const NAMED = {
+  namedPathItems: "pathItem",
+  namedCallbacks: "callback",
+  callback: "pathItem",
+  namedOperations: "operation"
+};
+function nextPlace(place, segment) {
+  const named = NAMED[place];
+  if (named !== void 0) {
+    return named;
+  }
+  if (place === "pathItem" && OPERATION_KEYS.has(segment)) {
+    return "operation";
+  }
+  const fields = FIELDS[place] ?? {};
+  if (Object.hasOwn(fields, segment)) {
+    return fields[segment];
+  }
+  return place === "root" ? "outside" : "other";
+}
+const TERMINAL_PLACES = /* @__PURE__ */ new Set(["outside", "input", "other"]);
+function placeOf(segments) {
+  let place = "root";
+  for (const segment of segments) {
+    place = nextPlace(place, segment);
+    if (TERMINAL_PLACES.has(place)) {
+      return place;
+    }
+  }
+  return place;
+}
+
+exports.placeOf = placeOf;
+//# sourceMappingURL=document-places.cjs.map

package/dist/domain/openapi/document-places.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-places.cjs","sources":["../../../src/domain/openapi/document-places.ts"],"sourcesContent":["import { ADDITIONAL_OPERATIONS_KEY, HTTP_METHODS, QUERY_METHOD } from \"./path-item-object.js\";\n\n/**\n * The places of an OpenAPI document that a JSON Pointer passes through, read from the document's\n * structure rather than from the words of the pointer. `named*` places and `callback` are maps\n * whose next segment is a name (a path, a component name, a callback expression). `outside` (a\n * root key that is no document key), `input` (a parameter or a request body) and `other` end the\n * walk.\n */\nexport type DocumentPlace =\n  | \"root\"\n  | \"outside\"\n  | \"components\"\n  | \"namedPathItems\"\n  | \"namedCallbacks\"\n  | \"callback\"\n  | \"pathItem\"\n  | \"namedOperations\"\n  | \"operation\"\n  | \"input\"\n  | \"other\";\n\nconst OPERATION_KEYS: ReadonlySet<string> = new Set([...HTTP_METHODS, QUERY_METHOD]);\n\n/** The place each fixed field leads to; any other field leads to `other`. */\nconst FIELDS: Readonly<Partial<Record<DocumentPlace, Readonly<Record<string, DocumentPlace>>>>> = {\n  root: {\n    paths: \"namedPathItems\",\n    webhooks: \"namedPathItems\",\n    components: \"components\",\n    $defs: \"other\",\n  },\n  components: {\n    parameters: \"input\",\n    requestBodies: \"input\",\n    pathItems: \"namedPathItems\",\n    callbacks: \"namedCallbacks\",\n  },\n  pathItem: { parameters: \"input\", [ADDITIONAL_OPERATIONS_KEY]: \"namedOperations\" },\n  operation: { parameters: \"input\", requestBody: \"input\", callbacks: \"namedCallbacks\" },\n};\n\n/** Maps whose every key leads to the same place. */\nconst NAMED: Readonly<Partial<Record<DocumentPlace, DocumentPlace>>> = {\n  namedPathItems: \"pathItem\",\n  namedCallbacks: \"callback\",\n  callback: \"pathItem\",\n  namedOperations: \"operation\",\n};\n\nfunction nextPlace(place: DocumentPlace, segment: string): DocumentPlace {\n  const named = NAMED[place];\n  if (named !== undefined) {\n    return named;\n  }\n  if (place === \"pathItem\" && OPERATION_KEYS.has(segment)) {\n    return \"operation\";\n  }\n  const fields = FIELDS[place] ?? {};\n  if (Object.hasOwn(fields, segment)) {\n    return fields[segment] as DocumentPlace;\n  }\n  return place === \"root\" ? \"outside\" : \"other\";\n}\n\nconst TERMINAL_PLACES: ReadonlySet<DocumentPlace> = new Set([\"outside\", \"input\", \"other\"]);\n\n/** The place the segments of a pointer (after `#`) lead to; the walk stops at a terminal place. */\nexport function placeOf(segments: Iterable<string>): DocumentPlace {\n  let place: DocumentPlace = \"root\";\n  for (const segment of segments) {\n    place = nextPlace(place, segment);\n    if (TERMINAL_PLACES.has(place)) {\n      return place;\n    }\n  }\n  return place;\n}\n"],"names":["HTTP_METHODS","QUERY_METHOD","ADDITIONAL_OPERATIONS_KEY"],"mappings":";;;;AAsBA,MAAM,iCAAsC,IAAI,GAAA,CAAI,CAAC,GAAGA,2BAAA,EAAcC,2BAAY,CAAC,CAAA;AAGnF,MAAM,MAAA,GAA4F;AAAA,EAChG,IAAA,EAAM;AAAA,IACJ,KAAA,EAAO,gBAAA;AAAA,IACP,QAAA,EAAU,gBAAA;AAAA,IACV,UAAA,EAAY,YAAA;AAAA,IACZ,KAAA,EAAO;AAAA,GACT;AAAA,EACA,UAAA,EAAY;AAAA,IACV,UAAA,EAAY,OAAA;AAAA,IACZ,aAAA,EAAe,OAAA;AAAA,IACf,SAAA,EAAW,gBAAA;AAAA,IACX,SAAA,EAAW;AAAA,GACb;AAAA,EACA,UAAU,EAAE,UAAA,EAAY,SAAS,CAACC,wCAAyB,GAAG,iBAAA,EAAkB;AAAA,EAChF,WAAW,EAAE,UAAA,EAAY,SAAS,WAAA,EAAa,OAAA,EAAS,WAAW,gBAAA;AACrE,CAAA;AAGA,MAAM,KAAA,GAAiE;AAAA,EACrE,cAAA,EAAgB,UAAA;AAAA,EAChB,cAAA,EAAgB,UAAA;AAAA,EAChB,QAAA,EAAU,UAAA;AAAA,EACV,eAAA,EAAiB;AACnB,CAAA;AAEA,SAAS,SAAA,CAAU,OAAsB,OAAA,EAAgC;AACvE,EAAA,MAAM,KAAA,GAAQ,MAAM,KAAK,CAAA;AACzB,EAAA,IAAI,UAAU,MAAA,EAAW;AACvB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,KAAA,KAAU,UAAA,IAAc,cAAA,CAAe,GAAA,CAAI,OAAO,CAAA,EAAG;AACvD,IAAA,OAAO,WAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,KAAK,CAAA,IAAK,EAAC;AACjC,EAAA,IAAI,MAAA,CAAO,MAAA,CAAO,MAAA,EAAQ,OAAO,CAAA,EAAG;AAClC,IAAA,OAAO,OAAO,OAAO,CAAA;AAAA,EACvB;AACA,EAAA,OAAO,KAAA,KAAU,SAAS,SAAA,GAAY,OAAA;AACxC;AAEA,MAAM,kCAA8C,IAAI,GAAA,CAAI,CAAC,SAAA,EAAW,OAAA,EAAS,OAAO,CAAC,CAAA;AAGlF,SAAS,QAAQ,QAAA,EAA2C;AACjE,EAAA,IAAI,KAAA,GAAuB,MAAA;AAC3B,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,KAAA,GAAQ,SAAA,CAAU,OAAO,OAAO,CAAA;AAChC,IAAA,IAAI,eAAA,CAAgB,GAAA,CAAI,KAAK,CAAA,EAAG;AAC9B,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;;"}

package/dist/domain/openapi/document-places.mjs

@@ -0,0 +1,53 @@
+import { HTTP_METHODS, QUERY_METHOD, ADDITIONAL_OPERATIONS_KEY } from './path-item-object.mjs';
+
+const OPERATION_KEYS = /* @__PURE__ */ new Set([...HTTP_METHODS, QUERY_METHOD]);
+const FIELDS = {
+  root: {
+    paths: "namedPathItems",
+    webhooks: "namedPathItems",
+    components: "components",
+    $defs: "other"
+  },
+  components: {
+    parameters: "input",
+    requestBodies: "input",
+    pathItems: "namedPathItems",
+    callbacks: "namedCallbacks"
+  },
+  pathItem: { parameters: "input", [ADDITIONAL_OPERATIONS_KEY]: "namedOperations" },
+  operation: { parameters: "input", requestBody: "input", callbacks: "namedCallbacks" }
+};
+const NAMED = {
+  namedPathItems: "pathItem",
+  namedCallbacks: "callback",
+  callback: "pathItem",
+  namedOperations: "operation"
+};
+function nextPlace(place, segment) {
+  const named = NAMED[place];
+  if (named !== void 0) {
+    return named;
+  }
+  if (place === "pathItem" && OPERATION_KEYS.has(segment)) {
+    return "operation";
+  }
+  const fields = FIELDS[place] ?? {};
+  if (Object.hasOwn(fields, segment)) {
+    return fields[segment];
+  }
+  return place === "root" ? "outside" : "other";
+}
+const TERMINAL_PLACES = /* @__PURE__ */ new Set(["outside", "input", "other"]);
+function placeOf(segments) {
+  let place = "root";
+  for (const segment of segments) {
+    place = nextPlace(place, segment);
+    if (TERMINAL_PLACES.has(place)) {
+      return place;
+    }
+  }
+  return place;
+}
+
+export { placeOf };
+//# sourceMappingURL=document-places.mjs.map

package/dist/domain/openapi/document-places.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-places.mjs","sources":["../../../src/domain/openapi/document-places.ts"],"sourcesContent":["import { ADDITIONAL_OPERATIONS_KEY, HTTP_METHODS, QUERY_METHOD } from \"./path-item-object.js\";\n\n/**\n * The places of an OpenAPI document that a JSON Pointer passes through, read from the document's\n * structure rather than from the words of the pointer. `named*` places and `callback` are maps\n * whose next segment is a name (a path, a component name, a callback expression). `outside` (a\n * root key that is no document key), `input` (a parameter or a request body) and `other` end the\n * walk.\n */\nexport type DocumentPlace =\n  | \"root\"\n  | \"outside\"\n  | \"components\"\n  | \"namedPathItems\"\n  | \"namedCallbacks\"\n  | \"callback\"\n  | \"pathItem\"\n  | \"namedOperations\"\n  | \"operation\"\n  | \"input\"\n  | \"other\";\n\nconst OPERATION_KEYS: ReadonlySet<string> = new Set([...HTTP_METHODS, QUERY_METHOD]);\n\n/** The place each fixed field leads to; any other field leads to `other`. */\nconst FIELDS: Readonly<Partial<Record<DocumentPlace, Readonly<Record<string, DocumentPlace>>>>> = {\n  root: {\n    paths: \"namedPathItems\",\n    webhooks: \"namedPathItems\",\n    components: \"components\",\n    $defs: \"other\",\n  },\n  components: {\n    parameters: \"input\",\n    requestBodies: \"input\",\n    pathItems: \"namedPathItems\",\n    callbacks: \"namedCallbacks\",\n  },\n  pathItem: { parameters: \"input\", [ADDITIONAL_OPERATIONS_KEY]: \"namedOperations\" },\n  operation: { parameters: \"input\", requestBody: \"input\", callbacks: \"namedCallbacks\" },\n};\n\n/** Maps whose every key leads to the same place. */\nconst NAMED: Readonly<Partial<Record<DocumentPlace, DocumentPlace>>> = {\n  namedPathItems: \"pathItem\",\n  namedCallbacks: \"callback\",\n  callback: \"pathItem\",\n  namedOperations: \"operation\",\n};\n\nfunction nextPlace(place: DocumentPlace, segment: string): DocumentPlace {\n  const named = NAMED[place];\n  if (named !== undefined) {\n    return named;\n  }\n  if (place === \"pathItem\" && OPERATION_KEYS.has(segment)) {\n    return \"operation\";\n  }\n  const fields = FIELDS[place] ?? {};\n  if (Object.hasOwn(fields, segment)) {\n    return fields[segment] as DocumentPlace;\n  }\n  return place === \"root\" ? \"outside\" : \"other\";\n}\n\nconst TERMINAL_PLACES: ReadonlySet<DocumentPlace> = new Set([\"outside\", \"input\", \"other\"]);\n\n/** The place the segments of a pointer (after `#`) lead to; the walk stops at a terminal place. */\nexport function placeOf(segments: Iterable<string>): DocumentPlace {\n  let place: DocumentPlace = \"root\";\n  for (const segment of segments) {\n    place = nextPlace(place, segment);\n    if (TERMINAL_PLACES.has(place)) {\n      return place;\n    }\n  }\n  return place;\n}\n"],"names":[],"mappings":";;AAsBA,MAAM,iCAAsC,IAAI,GAAA,CAAI,CAAC,GAAG,YAAA,EAAc,YAAY,CAAC,CAAA;AAGnF,MAAM,MAAA,GAA4F;AAAA,EAChG,IAAA,EAAM;AAAA,IACJ,KAAA,EAAO,gBAAA;AAAA,IACP,QAAA,EAAU,gBAAA;AAAA,IACV,UAAA,EAAY,YAAA;AAAA,IACZ,KAAA,EAAO;AAAA,GACT;AAAA,EACA,UAAA,EAAY;AAAA,IACV,UAAA,EAAY,OAAA;AAAA,IACZ,aAAA,EAAe,OAAA;AAAA,IACf,SAAA,EAAW,gBAAA;AAAA,IACX,SAAA,EAAW;AAAA,GACb;AAAA,EACA,UAAU,EAAE,UAAA,EAAY,SAAS,CAAC,yBAAyB,GAAG,iBAAA,EAAkB;AAAA,EAChF,WAAW,EAAE,UAAA,EAAY,SAAS,WAAA,EAAa,OAAA,EAAS,WAAW,gBAAA;AACrE,CAAA;AAGA,MAAM,KAAA,GAAiE;AAAA,EACrE,cAAA,EAAgB,UAAA;AAAA,EAChB,cAAA,EAAgB,UAAA;AAAA,EAChB,QAAA,EAAU,UAAA;AAAA,EACV,eAAA,EAAiB;AACnB,CAAA;AAEA,SAAS,SAAA,CAAU,OAAsB,OAAA,EAAgC;AACvE,EAAA,MAAM,KAAA,GAAQ,MAAM,KAAK,CAAA;AACzB,EAAA,IAAI,UAAU,MAAA,EAAW;AACvB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,KAAA,KAAU,UAAA,IAAc,cAAA,CAAe,GAAA,CAAI,OAAO,CAAA,EAAG;AACvD,IAAA,OAAO,WAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,KAAK,CAAA,IAAK,EAAC;AACjC,EAAA,IAAI,MAAA,CAAO,MAAA,CAAO,MAAA,EAAQ,OAAO,CAAA,EAAG;AAClC,IAAA,OAAO,OAAO,OAAO,CAAA;AAAA,EACvB;AACA,EAAA,OAAO,KAAA,KAAU,SAAS,SAAA,GAAY,OAAA;AACxC;AAEA,MAAM,kCAA8C,IAAI,GAAA,CAAI,CAAC,SAAA,EAAW,OAAA,EAAS,OAAO,CAAC,CAAA;AAGlF,SAAS,QAAQ,QAAA,EAA2C;AACjE,EAAA,IAAI,KAAA,GAAuB,MAAA;AAC3B,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,KAAA,GAAQ,SAAA,CAAU,OAAO,OAAO,CAAA;AAChC,IAAA,IAAI,eAAA,CAAgB,GAAA,CAAI,KAAK,CAAA,EAAG;AAC9B,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;;"}

package/dist/domain/output-fixes.cjs

@@ -17,6 +17,11 @@ const FIX = {
   ARRAY_LENGTH_TUPLES: "array-length-tuples",
   /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
   DEDUPE_ENUM_NAMES: "dedupe-enum-names",
+  /**
+   * `--default-non-nullable` finds parameters and request bodies by the document's structure, not
+   * by the words `parameters` and `requestBody` anywhere in a schema's location.
+   */
+  DEFAULT_INPUT_LOCATIONS: "default-input-locations",
   /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
   DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required",
   /**
@@ -29,8 +34,8 @@ const FIX = {
   EXPLODED_QUERY_OBJECTS: "exploded-query-objects",
   /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
   NULLABLE_ENUMS: "nullable-enums",
-  /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
-  PARAMETER_CONTENT: "parameter-content",
+  /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */
+  PARAMETER_HEADER_CONTENT: "parameter-header-content",
   /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
   PATH_PARAM_TYPE_NAMES: "path-param-type-names",
   /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -90,6 +95,7 @@ const NO_SCHEMA_PREFIX = {
 const REQUIREMENTS = {
   [FIX.ARRAY_LENGTH_TUPLES]: [{ option: "arrayLength", flag: "--array-length" }],
   [FIX.DEDUPE_ENUM_NAMES]: [ENUM, { option: "dedupeEnums", flag: "--dedupe-enums" }],
+  [FIX.DEFAULT_INPUT_LOCATIONS]: [{ option: "defaultNonNullable", flag: "--default-non-nullable" }],
   [FIX.NULLABLE_ENUMS]: [ENUM],
   [FIX.PATH_PARAM_TYPE_NAMES]: [{ option: "pathParamsAsTypes", flag: "--path-params-as-types" }],
   [FIX.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX]

package/dist/domain/output-fixes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"output-fixes.cjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default. The object names the fixes for this package's code; the public API is the `OutputFix`\n * union and the `OUTPUT_FIXES` list (ADR-021, amendment 1).\n */\nexport const FIX = {\n  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */\n  ALLOF_DISCRIMINATED_UNION: \"allof-discriminated-union\",\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */\n  ANYOF_ONEOF_DESCRIPTIONS: \"anyof-oneof-descriptions\",\n  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */\n  ANYOF_ONEOF_REQUIRED: \"anyof-oneof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */\n  DEDUPE_ENUM_NAMES: \"dedupe-enum-names\",\n  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */\n  DISCRIMINATOR_MEMBER_REQUIRED: \"discriminator-member-required\",\n  /**\n   * The value a discriminator member gets: one enum of every discriminator's values, a mapping\n   * before the schema name, a schema's own mapping before an inherited one, none where the member\n   * declares it, and with `--enum` a member of the owner's enum.\n   */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */\n  EXPLODED_QUERY_OBJECTS: \"exploded-query-objects\",\n  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */\n  NULLABLE_ENUMS: \"nullable-enums\",\n  /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */\n  PARAMETER_CONTENT: \"parameter-content\",\n  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */\n  PATH_PARAM_TYPE_NAMES: \"path-param-type-names\",\n  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */\n  PREFIX_ITEMS: \"prefix-items\",\n  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */\n  READ_WRITE_REFS: \"read-write-refs\",\n  /**\n   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it\n   * points at, also where the original type compiles through an index signature.\n   */\n  REF_POINTERS: \"ref-pointers\",\n  /**\n   * OpenAPI 3.1 and 3.2: keywords next to a `$ref` (`required`, `properties`) apply too, so the\n   * type is the reference intersected with them. OpenAPI 3.0 ignores them, as its spec says.\n   */\n  REF_SIBLINGS: \"ref-siblings\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\n/** The name of one opt-in output fix. */\nexport type OutputFix = (typeof FIX)[keyof typeof FIX];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(FIX);\n\n/** The name that turns on every fix of the installed version. */\nconst ALL_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `\"all\"`. */\nexport type OutputFixName = OutputFix | typeof ALL_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/**\n * The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value, and for a `fix`\n * option that is no list (`fix: \"all\"` from JavaScript), which must not be read letter by letter.\n */\nexport function outputFixNamesOf(values: unknown): readonly OutputFixName[] {\n  if (!Array.isArray(values)) {\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message:\n        'The fix option must be a list of fix names, such as [\"all\"]. ' +\n        `Got ${JSON.stringify(values)}.`,\n      details: { unknown: [values], known: [...KNOWN_NAMES] },\n    });\n  }\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option:\n    | \"arrayLength\"\n    | \"dedupeEnums\"\n    | \"enum\"\n    | \"pathParamsAsTypes\"\n    | \"rootTypes\"\n    | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst ENUM = { option: \"enum\", flag: \"--enum\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [FIX.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [FIX.DEDUPE_ENUM_NAMES]: [ENUM, { option: \"dedupeEnums\", flag: \"--dedupe-enums\" }],\n  [FIX.NULLABLE_ENUMS]: [ENUM],\n  [FIX.PATH_PARAM_TYPE_NAMES]: [{ option: \"pathParamsAsTypes\", flag: \"--path-params-as-types\" }],\n  [FIX.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES"],"mappings":";;;;AAQO,MAAM,GAAA,GAAM;AAAA;AAAA,EAEjB,yBAAA,EAA2B,2BAAA;AAAA;AAAA,EAE3B,cAAA,EAAgB,gBAAA;AAAA;AAAA,EAEhB,wBAAA,EAA0B,0BAAA;AAAA;AAAA,EAE1B,oBAAA,EAAsB,sBAAA;AAAA;AAAA,EAEtB,gBAAA,EAAkB,kBAAA;AAAA;AAAA,EAElB,mBAAA,EAAqB,qBAAA;AAAA;AAAA,EAErB,iBAAA,EAAmB,mBAAA;AAAA;AAAA,EAEnB,6BAAA,EAA+B,+BAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM/B,oBAAA,EAAsB,sBAAA;AAAA;AAAA,EAEtB,sBAAA,EAAwB,wBAAA;AAAA;AAAA,EAExB,cAAA,EAAgB,gBAAA;AAAA;AAAA,EAEhB,iBAAA,EAAmB,mBAAA;AAAA;AAAA,EAEnB,qBAAA,EAAuB,uBAAA;AAAA;AAAA,EAEvB,YAAA,EAAc,cAAA;AAAA;AAAA,EAEd,eAAA,EAAiB,iBAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKjB,YAAA,EAAc,cAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKd,YAAA,EAAc,cAAA;AAAA;AAAA,EAEd,mBAAA,EAAqB,qBAAA;AAAA;AAAA,EAErB,sBAAA,EAAwB;AAC1B;AAKO,MAAM,YAAA,GAAqC,MAAA,CAAO,MAAA,CAAO,GAAG;AAGnE,MAAM,SAAA,GAAY,KAAA;AAKlB,MAAM,8BAAmC,IAAI,GAAA,CAAY,CAAC,GAAG,YAAA,EAAc,SAAS,CAAC,CAAA;AAErF,SAAS,gBAAgB,KAAA,EAAwC;AAC/D,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,WAAA,CAAY,IAAI,KAAK,CAAA;AAC3D;AAMO,SAAS,iBAAiB,MAAA,EAA2C;AAC1E,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC1B,IAAA,MAAM,IAAIA,2BAAA,CAAqB;AAAA,MAC7B,MAAMC,kBAAA,CAAY,kBAAA;AAAA,MAClB,OAAA,EACE,CAAA,iEAAA,EACO,IAAA,CAAK,SAAA,CAAU,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,MAC/B,OAAA,EAAS,EAAE,OAAA,EAAS,CAAC,MAAM,GAAG,KAAA,EAAO,CAAC,GAAG,WAAW,CAAA;AAAE,KACvD,CAAA;AAAA,EACH;AACA,EAAA,MAAM,OAAA,GAAU,OAAO,MAAA,CAAO,CAAC,UAAU,CAAC,eAAA,CAAgB,KAAK,CAAC,CAAA;AAChE,EAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACtB,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,CAAC,KAAA,KAAU,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA;AACrE,IAAA,MAAM,QAAQ,CAAC,GAAG,WAAW,CAAA,CAAE,KAAK,IAAI,CAAA;AACxC,IAAA,MAAM,IAAID,2BAAA,CAAqB;AAAA,MAC7B,MAAMC,kBAAA,CAAY,kBAAA;AAAA,MAClB,OAAA,EAAS,CAAA,YAAA,EAAe,KAAK,CAAA,eAAA,EAAkB,KAAK,CAAA,CAAA,CAAA;AAAA,MACpD,SAAS,EAAE,OAAA,EAAS,OAAO,CAAC,GAAG,WAAW,CAAA;AAAE,KAC7C,CAAA;AAAA,EACH;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,mBAAmB,KAAA,EAAyD;AAC1F,EAAA,OAAO,IAAI,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,CAAC,IAAA,KAAU,IAAA,KAAS,SAAA,GAAY,YAAA,GAAe,CAAC,IAAI,CAAE,CAAC,CAAA;AACtF;AAcA,MAAM,UAAA,GAAa,EAAE,MAAA,EAAQ,WAAA,EAAa,MAAM,cAAA,EAAe;AAC/D,MAAM,IAAA,GAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,MAAM,QAAA,EAAS;AAC9C,MAAM,gBAAA,GAAmB;AAAA,EACvB,MAAA,EAAQ,yBAAA;AAAA,EACR,IAAA,EAAM;AACR,CAAA;AAGA,MAAM,YAAA,GAA0F;AAAA,EAC9F,CAAC,GAAA,CAAI,mBAAmB,GAAG,CAAC,EAAE,MAAA,EAAQ,aAAA,EAAe,IAAA,EAAM,gBAAA,EAAkB,CAAA;AAAA,EAC7E,CAAC,GAAA,CAAI,iBAAiB,GAAG,CAAC,IAAA,EAAM,EAAE,MAAA,EAAQ,aAAA,EAAe,IAAA,EAAM,gBAAA,EAAkB,CAAA;AAAA,EACjF,CAAC,GAAA,CAAI,cAAc,GAAG,CAAC,IAAI,CAAA;AAAA,EAC3B,CAAC,GAAA,CAAI,qBAAqB,GAAG,CAAC,EAAE,MAAA,EAAQ,mBAAA,EAAqB,IAAA,EAAM,wBAAA,EAA0B,CAAA;AAAA,EAC7F,CAAC,GAAA,CAAI,mBAAmB,GAAG,CAAC,YAAY,gBAAgB;AAC1D,CAAA;AAEA,SAAS,oBAAoB,WAAA,EAA2C;AACtE,EAAA,OAAO,CAAA,EAAG,WAAA,CAAY,MAAM,CAAA,EAAA,EAAK,YAAY,IAAI,CAAA,CAAA,CAAA;AACnD;AAMO,SAAS,qBAAA,CACd,OACA,UAAA,EACU;AACV,EAAA,OAAO,CAAC,GAAG,IAAI,GAAA,CAAI,KAAK,CAAC,CAAA,CAAE,OAAA,CAAQ,CAAC,IAAA,KAAS;AAC3C,IAAA,MAAM,OAAA,GAAA,CAAW,YAAA,CAAa,IAAI,CAAA,IAAK,EAAC,EAAG,MAAA,CAAO,CAAC,EAAE,MAAA,EAAO,KAAM,CAAC,UAAA,CAAW,MAAM,CAAC,CAAA;AACrF,IAAA,OAAO,QAAQ,MAAA,KAAW,CAAA,GACtB,EAAC,GACD,CAAC,CAAA,KAAA,EAAQ,IAAI,CAAA,wBAAA,EAA2B,OAAA,CAAQ,IAAI,mBAAmB,CAAA,CAAE,IAAA,CAAK,OAAO,CAAC,CAAA,CAAE,CAAA;AAAA,EAC9F,CAAC,CAAA;AACH;;;;;;"}
+{"version":3,"file":"output-fixes.cjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default. The object names the fixes for this package's code; the public API is the `OutputFix`\n * union and the `OUTPUT_FIXES` list (ADR-021, amendment 1).\n */\nexport const FIX = {\n  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */\n  ALLOF_DISCRIMINATED_UNION: \"allof-discriminated-union\",\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */\n  ANYOF_ONEOF_DESCRIPTIONS: \"anyof-oneof-descriptions\",\n  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */\n  ANYOF_ONEOF_REQUIRED: \"anyof-oneof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */\n  DEDUPE_ENUM_NAMES: \"dedupe-enum-names\",\n  /**\n   * `--default-non-nullable` finds parameters and request bodies by the document's structure, not\n   * by the words `parameters` and `requestBody` anywhere in a schema's location.\n   */\n  DEFAULT_INPUT_LOCATIONS: \"default-input-locations\",\n  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */\n  DISCRIMINATOR_MEMBER_REQUIRED: \"discriminator-member-required\",\n  /**\n   * The value a discriminator member gets: one enum of every discriminator's values, a mapping\n   * before the schema name, a schema's own mapping before an inherited one, none where the member\n   * declares it, and with `--enum` a member of the owner's enum.\n   */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */\n  EXPLODED_QUERY_OBJECTS: \"exploded-query-objects\",\n  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */\n  NULLABLE_ENUMS: \"nullable-enums\",\n  /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */\n  PARAMETER_HEADER_CONTENT: \"parameter-header-content\",\n  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */\n  PATH_PARAM_TYPE_NAMES: \"path-param-type-names\",\n  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */\n  PREFIX_ITEMS: \"prefix-items\",\n  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */\n  READ_WRITE_REFS: \"read-write-refs\",\n  /**\n   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it\n   * points at, also where the original type compiles through an index signature.\n   */\n  REF_POINTERS: \"ref-pointers\",\n  /**\n   * OpenAPI 3.1 and 3.2: keywords next to a `$ref` (`required`, `properties`) apply too, so the\n   * type is the reference intersected with them. OpenAPI 3.0 ignores them, as its spec says.\n   */\n  REF_SIBLINGS: \"ref-siblings\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\n/** The name of one opt-in output fix. */\nexport type OutputFix = (typeof FIX)[keyof typeof FIX];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(FIX);\n\n/** The name that turns on every fix of the installed version. */\nconst ALL_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `\"all\"`. */\nexport type OutputFixName = OutputFix | typeof ALL_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/**\n * The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value, and for a `fix`\n * option that is no list (`fix: \"all\"` from JavaScript), which must not be read letter by letter.\n */\nexport function outputFixNamesOf(values: unknown): readonly OutputFixName[] {\n  if (!Array.isArray(values)) {\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message:\n        'The fix option must be a list of fix names, such as [\"all\"]. ' +\n        `Got ${JSON.stringify(values)}.`,\n      details: { unknown: [values], known: [...KNOWN_NAMES] },\n    });\n  }\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option:\n    | \"arrayLength\"\n    | \"dedupeEnums\"\n    | \"defaultNonNullable\"\n    | \"enum\"\n    | \"pathParamsAsTypes\"\n    | \"rootTypes\"\n    | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst ENUM = { option: \"enum\", flag: \"--enum\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [FIX.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [FIX.DEDUPE_ENUM_NAMES]: [ENUM, { option: \"dedupeEnums\", flag: \"--dedupe-enums\" }],\n  [FIX.DEFAULT_INPUT_LOCATIONS]: [{ option: \"defaultNonNullable\", flag: \"--default-non-nullable\" }],\n  [FIX.NULLABLE_ENUMS]: [ENUM],\n  [FIX.PATH_PARAM_TYPE_NAMES]: [{ option: \"pathParamsAsTypes\", flag: \"--path-params-as-types\" }],\n  [FIX.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES"],"mappings":"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"}

package/dist/domain/output-fixes.mjs

@@ -15,6 +15,11 @@ const FIX = {
   ARRAY_LENGTH_TUPLES: "array-length-tuples",
   /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
   DEDUPE_ENUM_NAMES: "dedupe-enum-names",
+  /**
+   * `--default-non-nullable` finds parameters and request bodies by the document's structure, not
+   * by the words `parameters` and `requestBody` anywhere in a schema's location.
+   */
+  DEFAULT_INPUT_LOCATIONS: "default-input-locations",
   /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
   DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required",
   /**
@@ -27,8 +32,8 @@ const FIX = {
   EXPLODED_QUERY_OBJECTS: "exploded-query-objects",
   /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
   NULLABLE_ENUMS: "nullable-enums",
-  /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
-  PARAMETER_CONTENT: "parameter-content",
+  /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */
+  PARAMETER_HEADER_CONTENT: "parameter-header-content",
   /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
   PATH_PARAM_TYPE_NAMES: "path-param-type-names",
   /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -88,6 +93,7 @@ const NO_SCHEMA_PREFIX = {
 const REQUIREMENTS = {
   [FIX.ARRAY_LENGTH_TUPLES]: [{ option: "arrayLength", flag: "--array-length" }],
   [FIX.DEDUPE_ENUM_NAMES]: [ENUM, { option: "dedupeEnums", flag: "--dedupe-enums" }],
+  [FIX.DEFAULT_INPUT_LOCATIONS]: [{ option: "defaultNonNullable", flag: "--default-non-nullable" }],
   [FIX.NULLABLE_ENUMS]: [ENUM],
   [FIX.PATH_PARAM_TYPE_NAMES]: [{ option: "pathParamsAsTypes", flag: "--path-params-as-types" }],
   [FIX.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX]

package/dist/domain/output-fixes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"output-fixes.mjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default. The object names the fixes for this package's code; the public API is the `OutputFix`\n * union and the `OUTPUT_FIXES` list (ADR-021, amendment 1).\n */\nexport const FIX = {\n  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */\n  ALLOF_DISCRIMINATED_UNION: \"allof-discriminated-union\",\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */\n  ANYOF_ONEOF_DESCRIPTIONS: \"anyof-oneof-descriptions\",\n  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */\n  ANYOF_ONEOF_REQUIRED: \"anyof-oneof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */\n  DEDUPE_ENUM_NAMES: \"dedupe-enum-names\",\n  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */\n  DISCRIMINATOR_MEMBER_REQUIRED: \"discriminator-member-required\",\n  /**\n   * The value a discriminator member gets: one enum of every discriminator's values, a mapping\n   * before the schema name, a schema's own mapping before an inherited one, none where the member\n   * declares it, and with `--enum` a member of the owner's enum.\n   */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */\n  EXPLODED_QUERY_OBJECTS: \"exploded-query-objects\",\n  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */\n  NULLABLE_ENUMS: \"nullable-enums\",\n  /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */\n  PARAMETER_CONTENT: \"parameter-content\",\n  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */\n  PATH_PARAM_TYPE_NAMES: \"path-param-type-names\",\n  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */\n  PREFIX_ITEMS: \"prefix-items\",\n  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */\n  READ_WRITE_REFS: \"read-write-refs\",\n  /**\n   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it\n   * points at, also where the original type compiles through an index signature.\n   */\n  REF_POINTERS: \"ref-pointers\",\n  /**\n   * OpenAPI 3.1 and 3.2: keywords next to a `$ref` (`required`, `properties`) apply too, so the\n   * type is the reference intersected with them. OpenAPI 3.0 ignores them, as its spec says.\n   */\n  REF_SIBLINGS: \"ref-siblings\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\n/** The name of one opt-in output fix. */\nexport type OutputFix = (typeof FIX)[keyof typeof FIX];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(FIX);\n\n/** The name that turns on every fix of the installed version. */\nconst ALL_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `\"all\"`. */\nexport type OutputFixName = OutputFix | typeof ALL_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/**\n * The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value, and for a `fix`\n * option that is no list (`fix: \"all\"` from JavaScript), which must not be read letter by letter.\n */\nexport function outputFixNamesOf(values: unknown): readonly OutputFixName[] {\n  if (!Array.isArray(values)) {\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message:\n        'The fix option must be a list of fix names, such as [\"all\"]. ' +\n        `Got ${JSON.stringify(values)}.`,\n      details: { unknown: [values], known: [...KNOWN_NAMES] },\n    });\n  }\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option:\n    | \"arrayLength\"\n    | \"dedupeEnums\"\n    | \"enum\"\n    | \"pathParamsAsTypes\"\n    | \"rootTypes\"\n    | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst ENUM = { option: \"enum\", flag: \"--enum\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [FIX.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [FIX.DEDUPE_ENUM_NAMES]: [ENUM, { option: \"dedupeEnums\", flag: \"--dedupe-enums\" }],\n  [FIX.NULLABLE_ENUMS]: [ENUM],\n  [FIX.PATH_PARAM_TYPE_NAMES]: [{ option: \"pathParamsAsTypes\", flag: \"--path-params-as-types\" }],\n  [FIX.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"output-fixes.mjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default. The object names the fixes for this package's code; the public API is the `OutputFix`\n * union and the `OUTPUT_FIXES` list (ADR-021, amendment 1).\n */\nexport const FIX = {\n  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */\n  ALLOF_DISCRIMINATED_UNION: \"allof-discriminated-union\",\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */\n  ANYOF_ONEOF_DESCRIPTIONS: \"anyof-oneof-descriptions\",\n  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */\n  ANYOF_ONEOF_REQUIRED: \"anyof-oneof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */\n  DEDUPE_ENUM_NAMES: \"dedupe-enum-names\",\n  /**\n   * `--default-non-nullable` finds parameters and request bodies by the document's structure, not\n   * by the words `parameters` and `requestBody` anywhere in a schema's location.\n   */\n  DEFAULT_INPUT_LOCATIONS: \"default-input-locations\",\n  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */\n  DISCRIMINATOR_MEMBER_REQUIRED: \"discriminator-member-required\",\n  /**\n   * The value a discriminator member gets: one enum of every discriminator's values, a mapping\n   * before the schema name, a schema's own mapping before an inherited one, none where the member\n   * declares it, and with `--enum` a member of the owner's enum.\n   */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */\n  EXPLODED_QUERY_OBJECTS: \"exploded-query-objects\",\n  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */\n  NULLABLE_ENUMS: \"nullable-enums\",\n  /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */\n  PARAMETER_HEADER_CONTENT: \"parameter-header-content\",\n  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */\n  PATH_PARAM_TYPE_NAMES: \"path-param-type-names\",\n  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */\n  PREFIX_ITEMS: \"prefix-items\",\n  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */\n  READ_WRITE_REFS: \"read-write-refs\",\n  /**\n   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it\n   * points at, also where the original type compiles through an index signature.\n   */\n  REF_POINTERS: \"ref-pointers\",\n  /**\n   * OpenAPI 3.1 and 3.2: keywords next to a `$ref` (`required`, `properties`) apply too, so the\n   * type is the reference intersected with them. OpenAPI 3.0 ignores them, as its spec says.\n   */\n  REF_SIBLINGS: \"ref-siblings\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\n/** The name of one opt-in output fix. */\nexport type OutputFix = (typeof FIX)[keyof typeof FIX];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(FIX);\n\n/** The name that turns on every fix of the installed version. */\nconst ALL_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `\"all\"`. */\nexport type OutputFixName = OutputFix | typeof ALL_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/**\n * The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value, and for a `fix`\n * option that is no list (`fix: \"all\"` from JavaScript), which must not be read letter by letter.\n */\nexport function outputFixNamesOf(values: unknown): readonly OutputFixName[] {\n  if (!Array.isArray(values)) {\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message:\n        'The fix option must be a list of fix names, such as [\"all\"]. ' +\n        `Got ${JSON.stringify(values)}.`,\n      details: { unknown: [values], known: [...KNOWN_NAMES] },\n    });\n  }\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option:\n    | \"arrayLength\"\n    | \"dedupeEnums\"\n    | \"defaultNonNullable\"\n    | \"enum\"\n    | \"pathParamsAsTypes\"\n    | \"rootTypes\"\n    | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst ENUM = { option: \"enum\", flag: \"--enum\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [FIX.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [FIX.DEDUPE_ENUM_NAMES]: [ENUM, { option: \"dedupeEnums\", flag: \"--dedupe-enums\" }],\n  [FIX.DEFAULT_INPUT_LOCATIONS]: [{ option: \"defaultNonNullable\", flag: \"--default-non-nullable\" }],\n  [FIX.NULLABLE_ENUMS]: [ENUM],\n  [FIX.PATH_PARAM_TYPE_NAMES]: [{ option: \"pathParamsAsTypes\", flag: \"--path-params-as-types\" }],\n  [FIX.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/domain/terminal-text.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+const CONTROL_RANGES = [
+  [0, 8],
+  [10, 31],
+  [127, 159],
+  [8232, 8233],
+  [8234, 8238],
+  [8294, 8297]
+];
+const SHORT_ESCAPES = { "\n": "\\n", "\r": "\\r" };
+const HEX_DIGITS = 4;
+const HEX_RADIX = 16;
+function isControl(codePoint) {
+  return CONTROL_RANGES.some(([first, last]) => codePoint >= first && codePoint <= last);
+}
+function escapeOf(character, codePoint) {
+  const hex = codePoint.toString(HEX_RADIX).padStart(HEX_DIGITS, "0");
+  return SHORT_ESCAPES[character] ?? `\\u${hex}`;
+}
+function terminalSafeText(text) {
+  let shown = "";
+  for (const character of text) {
+    const codePoint = character.codePointAt(0) ?? 0;
+    shown += isControl(codePoint) ? escapeOf(character, codePoint) : character;
+  }
+  return shown;
+}
+
+exports.terminalSafeText = terminalSafeText;
+//# sourceMappingURL=terminal-text.cjs.map

package/dist/domain/terminal-text.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-text.cjs","sources":["../../src/domain/terminal-text.ts"],"sourcesContent":["/**\n * Text from a document or a project (a path key, an `operationId`, a file name) reaches the\n * terminal and CI job logs. A line break in it starts a new line that CI reads as a command\n * (`::error …` in GitHub Actions, `##vso[…]` in Azure Pipelines), and an escape sequence moves\n * the cursor or erases lines, so it can forge or hide output. Each such character is shown as an\n * escape instead (`\\n`, `\\u001b`), so one message stays one line and shows what the text holds.\n */\n\n/**\n * The code points shown as escapes: C0 controls but the tab, DEL and C1 controls, the Unicode\n * line and paragraph separators, and the bidirectional controls, which reorder how a terminal\n * shows the text around them.\n */\nconst CONTROL_RANGES: readonly (readonly [number, number])[] = [\n  [0x00, 0x08],\n  [0x0a, 0x1f],\n  [0x7f, 0x9f],\n  [0x2028, 0x2029],\n  [0x202a, 0x202e],\n  [0x2066, 0x2069],\n];\n\nconst SHORT_ESCAPES: Readonly<Record<string, string>> = { \"\\n\": \"\\\\n\", \"\\r\": \"\\\\r\" };\nconst HEX_DIGITS = 4;\nconst HEX_RADIX = 16;\n\nfunction isControl(codePoint: number): boolean {\n  return CONTROL_RANGES.some(([first, last]) => codePoint >= first && codePoint <= last);\n}\n\nfunction escapeOf(character: string, codePoint: number): string {\n  const hex = codePoint.toString(HEX_RADIX).padStart(HEX_DIGITS, \"0\");\n  return SHORT_ESCAPES[character] ?? `\\\\u${hex}`;\n}\n\n/** The text with every control character shown as an escape, so it prints as one plain line. */\nexport function terminalSafeText(text: string): string {\n  let shown = \"\";\n  for (const character of text) {\n    const codePoint = character.codePointAt(0) ?? 0;\n    shown += isControl(codePoint) ? escapeOf(character, codePoint) : character;\n  }\n  return shown;\n}\n"],"names":[],"mappings":";;AAaA,MAAM,cAAA,GAAyD;AAAA,EAC7D,CAAC,GAAM,CAAI,CAAA;AAAA,EACX,CAAC,IAAM,EAAI,CAAA;AAAA,EACX,CAAC,KAAM,GAAI,CAAA;AAAA,EACX,CAAC,MAAQ,IAAM,CAAA;AAAA,EACf,CAAC,MAAQ,IAAM,CAAA;AAAA,EACf,CAAC,MAAQ,IAAM;AACjB,CAAA;AAEA,MAAM,aAAA,GAAkD,EAAE,IAAA,EAAM,KAAA,EAAO,MAAM,KAAA,EAAM;AACnF,MAAM,UAAA,GAAa,CAAA;AACnB,MAAM,SAAA,GAAY,EAAA;AAElB,SAAS,UAAU,SAAA,EAA4B;AAC7C,EAAA,OAAO,cAAA,CAAe,IAAA,CAAK,CAAC,CAAC,KAAA,EAAO,IAAI,CAAA,KAAM,SAAA,IAAa,KAAA,IAAS,SAAA,IAAa,IAAI,CAAA;AACvF;AAEA,SAAS,QAAA,CAAS,WAAmB,SAAA,EAA2B;AAC9D,EAAA,MAAM,MAAM,SAAA,CAAU,QAAA,CAAS,SAAS,CAAA,CAAE,QAAA,CAAS,YAAY,GAAG,CAAA;AAClE,EAAA,OAAO,aAAA,CAAc,SAAS,CAAA,IAAK,CAAA,GAAA,EAAM,GAAG,CAAA,CAAA;AAC9C;AAGO,SAAS,iBAAiB,IAAA,EAAsB;AACrD,EAAA,IAAI,KAAA,GAAQ,EAAA;AACZ,EAAA,KAAA,MAAW,aAAa,IAAA,EAAM;AAC5B,IAAA,MAAM,SAAA,GAAY,SAAA,CAAU,WAAA,CAAY,CAAC,CAAA,IAAK,CAAA;AAC9C,IAAA,KAAA,IAAS,UAAU,SAAS,CAAA,GAAI,QAAA,CAAS,SAAA,EAAW,SAAS,CAAA,GAAI,SAAA;AAAA,EACnE;AACA,EAAA,OAAO,KAAA;AACT;;"}

package/dist/domain/terminal-text.mjs

@@ -0,0 +1,29 @@
+const CONTROL_RANGES = [
+  [0, 8],
+  [10, 31],
+  [127, 159],
+  [8232, 8233],
+  [8234, 8238],
+  [8294, 8297]
+];
+const SHORT_ESCAPES = { "\n": "\\n", "\r": "\\r" };
+const HEX_DIGITS = 4;
+const HEX_RADIX = 16;
+function isControl(codePoint) {
+  return CONTROL_RANGES.some(([first, last]) => codePoint >= first && codePoint <= last);
+}
+function escapeOf(character, codePoint) {
+  const hex = codePoint.toString(HEX_RADIX).padStart(HEX_DIGITS, "0");
+  return SHORT_ESCAPES[character] ?? `\\u${hex}`;
+}
+function terminalSafeText(text) {
+  let shown = "";
+  for (const character of text) {
+    const codePoint = character.codePointAt(0) ?? 0;
+    shown += isControl(codePoint) ? escapeOf(character, codePoint) : character;
+  }
+  return shown;
+}
+
+export { terminalSafeText };
+//# sourceMappingURL=terminal-text.mjs.map

package/dist/domain/terminal-text.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-text.mjs","sources":["../../src/domain/terminal-text.ts"],"sourcesContent":["/**\n * Text from a document or a project (a path key, an `operationId`, a file name) reaches the\n * terminal and CI job logs. A line break in it starts a new line that CI reads as a command\n * (`::error …` in GitHub Actions, `##vso[…]` in Azure Pipelines), and an escape sequence moves\n * the cursor or erases lines, so it can forge or hide output. Each such character is shown as an\n * escape instead (`\\n`, `\\u001b`), so one message stays one line and shows what the text holds.\n */\n\n/**\n * The code points shown as escapes: C0 controls but the tab, DEL and C1 controls, the Unicode\n * line and paragraph separators, and the bidirectional controls, which reorder how a terminal\n * shows the text around them.\n */\nconst CONTROL_RANGES: readonly (readonly [number, number])[] = [\n  [0x00, 0x08],\n  [0x0a, 0x1f],\n  [0x7f, 0x9f],\n  [0x2028, 0x2029],\n  [0x202a, 0x202e],\n  [0x2066, 0x2069],\n];\n\nconst SHORT_ESCAPES: Readonly<Record<string, string>> = { \"\\n\": \"\\\\n\", \"\\r\": \"\\\\r\" };\nconst HEX_DIGITS = 4;\nconst HEX_RADIX = 16;\n\nfunction isControl(codePoint: number): boolean {\n  return CONTROL_RANGES.some(([first, last]) => codePoint >= first && codePoint <= last);\n}\n\nfunction escapeOf(character: string, codePoint: number): string {\n  const hex = codePoint.toString(HEX_RADIX).padStart(HEX_DIGITS, \"0\");\n  return SHORT_ESCAPES[character] ?? `\\\\u${hex}`;\n}\n\n/** The text with every control character shown as an escape, so it prints as one plain line. */\nexport function terminalSafeText(text: string): string {\n  let shown = \"\";\n  for (const character of text) {\n    const codePoint = character.codePointAt(0) ?? 0;\n    shown += isControl(codePoint) ? escapeOf(character, codePoint) : character;\n  }\n  return shown;\n}\n"],"names":[],"mappings":"AAaA,MAAM,cAAA,GAAyD;AAAA,EAC7D,CAAC,GAAM,CAAI,CAAA;AAAA,EACX,CAAC,IAAM,EAAI,CAAA;AAAA,EACX,CAAC,KAAM,GAAI,CAAA;AAAA,EACX,CAAC,MAAQ,IAAM,CAAA;AAAA,EACf,CAAC,MAAQ,IAAM,CAAA;AAAA,EACf,CAAC,MAAQ,IAAM;AACjB,CAAA;AAEA,MAAM,aAAA,GAAkD,EAAE,IAAA,EAAM,KAAA,EAAO,MAAM,KAAA,EAAM;AACnF,MAAM,UAAA,GAAa,CAAA;AACnB,MAAM,SAAA,GAAY,EAAA;AAElB,SAAS,UAAU,SAAA,EAA4B;AAC7C,EAAA,OAAO,cAAA,CAAe,IAAA,CAAK,CAAC,CAAC,KAAA,EAAO,IAAI,CAAA,KAAM,SAAA,IAAa,KAAA,IAAS,SAAA,IAAa,IAAI,CAAA;AACvF;AAEA,SAAS,QAAA,CAAS,WAAmB,SAAA,EAA2B;AAC9D,EAAA,MAAM,MAAM,SAAA,CAAU,QAAA,CAAS,SAAS,CAAA,CAAE,QAAA,CAAS,YAAY,GAAG,CAAA;AAClE,EAAA,OAAO,aAAA,CAAc,SAAS,CAAA,IAAK,CAAA,GAAA,EAAM,GAAG,CAAA,CAAA;AAC9C;AAGO,SAAS,iBAAiB,IAAA,EAAsB;AACrD,EAAA,IAAI,KAAA,GAAQ,EAAA;AACZ,EAAA,KAAA,MAAW,aAAa,IAAA,EAAM;AAC5B,IAAA,MAAM,SAAA,GAAY,SAAA,CAAU,WAAA,CAAY,CAAC,CAAA,IAAK,CAAA;AAC9C,IAAA,KAAA,IAAS,UAAU,SAAS,CAAA,GAAI,QAAA,CAAS,SAAA,EAAW,SAAS,CAAA,GAAI,SAAA;AAAA,EACnE;AACA,EAAA,OAAO,KAAA;AACT;;"}

package/dist/domain/warnings.cjs

@@ -2,6 +2,7 @@
 
 const WARNING_CODES = {
   CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED",
+  CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED",
   CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN",
   DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID",
   DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED",

package/dist/domain/warnings.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"warnings.cjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":";;AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;;"}
+{"version":3,"file":"warnings.cjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CLI_OUTPUT_IGNORED: \"CLI_OUTPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":";;AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;;"}

package/dist/domain/warnings.mjs

@@ -1,5 +1,6 @@
 const WARNING_CODES = {
   CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED",
+  CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED",
   CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN",
   DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID",
   DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED",

package/dist/domain/warnings.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"warnings.mjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":"AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;"}
+{"version":3,"file":"warnings.mjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CLI_OUTPUT_IGNORED: \"CLI_OUTPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":"AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;"}

package/dist/index.d.cts

@@ -4,6 +4,22 @@ import { Config } from '@redocly/openapi-core';
 import * as TypeScript from 'typescript';
 import colors from 'ansi-colors';
 
+/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
+type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
+/**
+ * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
+ * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
+ */
+interface Logger {
+    /**
+     * A debug line, with how long the step took when it was measured. A line without a group is
+     * written whenever debug output is on.
+     */
+    debug(message: string, group?: DebugGroup, durationMs?: number): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+
 /**
  * Type IR: the closed set of immutable nodes that describes the TypeScript types and declarations
  * the generator emits (ENGINEERING_PLAN §4.2, ADR-002). Nodes are plain readonly data with a `kind`
@@ -268,6 +284,11 @@ declare const FIX: {
     readonly ARRAY_LENGTH_TUPLES: "array-length-tuples";
     /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
     readonly DEDUPE_ENUM_NAMES: "dedupe-enum-names";
+    /**
+     * `--default-non-nullable` finds parameters and request bodies by the document's structure, not
+     * by the words `parameters` and `requestBody` anywhere in a schema's location.
+     */
+    readonly DEFAULT_INPUT_LOCATIONS: "default-input-locations";
     /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
     readonly DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required";
     /**
@@ -280,8 +301,8 @@ declare const FIX: {
     readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
     /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
     readonly NULLABLE_ENUMS: "nullable-enums";
-    /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
-    readonly PARAMETER_CONTENT: "parameter-content";
+    /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */
+    readonly PARAMETER_HEADER_CONTENT: "parameter-header-content";
     /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
     readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
     /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -1474,22 +1495,6 @@ declare const DEPRECATION_CODES: {
 };
 type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];
 
-/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
-type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
-/**
- * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
- * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
- */
-interface Logger {
-    /**
-     * A debug line, with how long the step took when it was measured. A line without a group is
-     * written whenever debug output is on.
-     */
-    debug(message: string, group?: DebugGroup, durationMs?: number): void;
-    warn(message: string): void;
-    error(message: string): void;
-}
-
 /**
  * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)
  * @param {string|URL|object|Readable} source OpenAPI schema source:
@@ -1498,6 +1503,8 @@ interface Logger {
  *   - URL: URL to a YAML or JSON file (local or remote)
  *   - Readable: Readable stream of YAML or JSON
  */
+declare function openapiTS(source: SchemaSource, options?: OpenAPITSOptions): Promise<IrDeclaration[]>;
+/** Convert an OpenAPI schema to IR declarations, with either form of the options. */
 declare function openapiTS(source: SchemaSource, options?: GeneratorOptions): Promise<IrDeclaration[]>;
 
 /**
@@ -1526,14 +1533,17 @@ declare const ERROR_CODES: {
     readonly ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY";
     readonly CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE";
     readonly OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN";
+    readonly OPTION_INVALID: "OPTION_INVALID";
     readonly TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND";
     readonly CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED";
+    readonly CLI_FLAG_INVALID: "CLI_FLAG_INVALID";
     readonly CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED";
     readonly CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
     readonly CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID";
     readonly CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING";
     readonly CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING";
     readonly CLI_INPUT_MISSING: "CLI_INPUT_MISSING";
+    readonly CLI_INPUT_EXTRA: "CLI_INPUT_EXTRA";
     readonly CLI_OUTPUT_IS_INPUT: "CLI_OUTPUT_IS_INPUT";
     readonly CLI_OUTPUT_DUPLICATE: "CLI_OUTPUT_DUPLICATE";
     readonly CLI_OUTPUT_INVALID: "CLI_OUTPUT_INVALID";
@@ -1849,6 +1859,7 @@ declare function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclar
 /** Every warning code. */
 declare const WARNING_CODES: {
     readonly CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED";
+    readonly CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED";
     readonly CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN";
     readonly DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID";
     readonly DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED";