openapi-typesafe 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/application/transform/footer/type-indexing.mjs

@@ -0,0 +1,105 @@
+import { MISSING, OPAQUE, unionType, isNullish, NEVER, intersectionType, propertyKey } from './evaluation.mjs';
+import { isNeverIntersection, declaredFirst } from './type-rules.mjs';
+
+function indexType(types, value, index) {
+  const owner = types.expand(value);
+  if (owner.kind !== "type") {
+    return owner;
+  }
+  if (types.membersOf(owner).length > 1) {
+    return unionIndex(types, owner, index);
+  }
+  const { type } = owner;
+  switch (type.kind) {
+    case "object":
+      return memberType(types, owner, type.members, index);
+    case "intersection":
+      return partsIndex(types, owner, type.types, index);
+    case "union":
+      return unionIndex(types, owner, index);
+    case "array":
+      return isNumberIndex(index) ? flattened(types, owner, type.element) : builtInIndex(index);
+    case "keyword":
+      return type.keyword === "never" ? owner : builtInIndex(index);
+    default:
+      return builtInIndex(index);
+  }
+}
+function memberType(types, owner, members, index) {
+  const key = indexKey(index);
+  const property = members.find(
+    (member) => member.kind === "property" && key !== null && propertyKey(member.name) === key
+  );
+  if (property !== void 0) {
+    return flattened(types, owner, property.type);
+  }
+  const signature = members.find((member) => member.kind === "indexSignature");
+  if (signature !== void 0) {
+    return flattened(types, owner, signature.type);
+  }
+  return key === null || isObjectBuiltIn(key) ? OPAQUE : MISSING;
+}
+function partsIndex(types, owner, parts, index) {
+  if (isNeverIntersection(types, owner, parts)) {
+    return { ...owner, type: NEVER };
+  }
+  const found = parts.map((type) => types.index({ ...owner, type }, index));
+  if (found.some((part) => part.kind === "opaque")) {
+    return OPAQUE;
+  }
+  const read = parts.map((type, at) => ({ type, found: found[at] }));
+  const kept = declaredFirst(types, owner, indexKey(index), read).flatMap(
+    (part) => part.kind === "type" ? [part.type] : []
+  );
+  return kept.length === 0 ? MISSING : { ...owner, type: intersectionType(kept) };
+}
+function unionIndex(types, owner, index) {
+  const found = types.membersOf(owner).map((member) => member.kind === "type" ? types.index(member, index) : member);
+  if (found.some((member) => member.kind === "missing")) {
+    return MISSING;
+  }
+  if (found.some((member) => member.kind === "opaque")) {
+    return OPAQUE;
+  }
+  return { ...owner, type: unionType(found.map((member) => member.type)) };
+}
+function flattened(types, owner, type) {
+  const member = { ...owner, type };
+  if (!owner.deep) {
+    return types.expand(member);
+  }
+  const members = types.membersOf(member);
+  if (members.some((candidate) => candidate.kind !== "type")) {
+    return OPAQUE;
+  }
+  const present = members.filter((candidate) => !isNullish(candidate.type));
+  const elements = present.map((candidate) => arrayElement(candidate.type));
+  if (present.length > 0 && elements.every((element) => element !== null)) {
+    return types.expand({ ...owner, type: unionType(elements) });
+  }
+  return { ...owner, type: unionType(present.map((candidate) => candidate.type)) };
+}
+function arrayElement(type) {
+  return type.kind === "array" ? type.element : null;
+}
+function indexKey(index) {
+  if (index.kind === "stringLiteral") {
+    return index.value;
+  }
+  return index.kind === "numberLiteral" ? String(index.value) : null;
+}
+function isNumberIndex(index) {
+  const key = indexKey(index);
+  return index.kind === "keyword" && index.keyword === "number" || /^\d+$/.test(key ?? "");
+}
+function isObjectBuiltIn(key) {
+  return key in {};
+}
+function builtInIndex(index) {
+  const key = indexKey(index);
+  const isBuiltIn = key === null || key in String.prototype || key in Array.prototype;
+  return isBuiltIn || key in Number.prototype ? OPAQUE : MISSING;
+}
+
+export { indexType };
+//# sourceMappingURL=type-indexing.mjs.map

package/dist/application/transform/footer/type-indexing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-indexing.mjs","sources":["../../../../src/application/transform/footer/type-indexing.ts"],"sourcesContent":["import type { IrMember, IrType } from \"../../../domain/ir/nodes.js\";\nimport {\n  type Evaluated,\n  type Evaluation,\n  intersectionType,\n  isNullish,\n  MISSING,\n  NEVER,\n  OPAQUE,\n  propertyKey,\n  unionType,\n} from \"./evaluation.js\";\nimport { declaredFirst, isNeverIntersection, type TypeExpansion } from \"./type-rules.js\";\n\n/**\n * Indexed access (`T[\"key\"]`, `T[number]`) on the generated types, as TypeScript reads it, for\n * the evaluator of the `--enum-values` check (ADR-027).\n */\n\n/** The part of the evaluator that indexed access uses. */\nexport interface IndexedTypes extends TypeExpansion {\n  expand(value: Evaluated): Evaluation;\n  index(value: Evaluated, index: IrType): Evaluation;\n}\n\n/** `value[index]` for a string literal, `string` or `number` index. */\nexport function indexType(types: IndexedTypes, value: Evaluated, index: IrType): Evaluation {\n  const owner = types.expand(value);\n  if (owner.kind !== \"type\") {\n    return owner;\n  }\n  if (types.membersOf(owner).length > 1) {\n    return unionIndex(types, owner, index);\n  }\n  const { type } = owner;\n  switch (type.kind) {\n    case \"object\":\n      return memberType(types, owner, type.members, index);\n    case \"intersection\":\n      return partsIndex(types, owner, type.types, index);\n    case \"union\":\n      return unionIndex(types, owner, index);\n    case \"array\":\n      return isNumberIndex(index) ? flattened(types, owner, type.element) : builtInIndex(index);\n    case \"keyword\":\n      return type.keyword === \"never\" ? owner : builtInIndex(index);\n    default:\n      return builtInIndex(index);\n  }\n}\n\nfunction memberType(\n  types: IndexedTypes,\n  owner: Evaluated,\n  members: readonly IrMember[],\n  index: IrType,\n): Evaluation {\n  const key = indexKey(index);\n  const property = members.find(\n    (member) => member.kind === \"property\" && key !== null && propertyKey(member.name) === key,\n  );\n  if (property !== undefined) {\n    return flattened(types, owner, property.type);\n  }\n  const signature = members.find((member) => member.kind === \"indexSignature\");\n  if (signature !== undefined) {\n    return flattened(types, owner, signature.type);\n  }\n  return key === null || isObjectBuiltIn(key) ? OPAQUE : MISSING;\n}\n\nfunction partsIndex(\n  types: IndexedTypes,\n  owner: Evaluated,\n  parts: readonly IrType[],\n  index: IrType,\n): Evaluation {\n  if (isNeverIntersection(types, owner, parts)) {\n    return { ...owner, type: NEVER };\n  }\n  const found = parts.map((type) => types.index({ ...owner, type }, index));\n  if (found.some((part) => part.kind === \"opaque\")) {\n    return OPAQUE;\n  }\n  const read = parts.map((type, at) => ({ type, found: found[at] as Evaluation }));\n  const kept = declaredFirst(types, owner, indexKey(index), read).flatMap((part) =>\n    part.kind === \"type\" ? [part.type] : [],\n  );\n  return kept.length === 0 ? MISSING : { ...owner, type: intersectionType(kept) };\n}\n\nfunction unionIndex(types: IndexedTypes, owner: Evaluated, index: IrType): Evaluation {\n  const found = types\n    .membersOf(owner)\n    .map((member) => (member.kind === \"type\" ? types.index(member, index) : member));\n  if (found.some((member) => member.kind === \"missing\")) {\n    return MISSING;\n  }\n  if (found.some((member) => member.kind === \"opaque\")) {\n    return OPAQUE;\n  }\n  return { ...owner, type: unionType((found as Evaluated[]).map((member) => member.type)) };\n}\n\n/**\n * A member read through `FlattenedDeepRequired`: a value that is only arrays (and `undefined` or\n * `null`) is replaced by its elements, anything else loses `undefined` and `null`.\n */\nfunction flattened(types: IndexedTypes, owner: Evaluated, type: IrType): Evaluation {\n  const member: Evaluated = { ...owner, type };\n  if (!owner.deep) {\n    return types.expand(member);\n  }\n  const members = types.membersOf(member);\n  if (members.some((candidate) => candidate.kind !== \"type\")) {\n    return OPAQUE;\n  }\n  const present = (members as Evaluated[]).filter((candidate) => !isNullish(candidate.type));\n  const elements = present.map((candidate) => arrayElement(candidate.type));\n  if (present.length > 0 && elements.every((element) => element !== null)) {\n    return types.expand({ ...owner, type: unionType(elements as IrType[]) });\n  }\n  return { ...owner, type: unionType(present.map((candidate) => candidate.type)) };\n}\n\n/** The element of an expanded member; expanding already dropped `readonly`. */\nfunction arrayElement(type: IrType): IrType | null {\n  return type.kind === \"array\" ? type.element : null;\n}\n\nfunction indexKey(index: IrType): string | null {\n  if (index.kind === \"stringLiteral\") {\n    return index.value;\n  }\n  return index.kind === \"numberLiteral\" ? String(index.value) : null;\n}\n\nfunction isNumberIndex(index: IrType): boolean {\n  const key = indexKey(index);\n  return (index.kind === \"keyword\" && index.keyword === \"number\") || /^\\d+$/.test(key ?? \"\");\n}\n\nfunction isObjectBuiltIn(key: string): boolean {\n  return key in {};\n}\n\n/** A key of a primitive or an array: a built-in member is opaque, any other key is missing. */\nfunction builtInIndex(index: IrType): Evaluation {\n  const key = indexKey(index);\n  const isBuiltIn = key === null || key in String.prototype || key in Array.prototype;\n  return isBuiltIn || key in Number.prototype ? OPAQUE : MISSING;\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/api-settings.cjs

@@ -0,0 +1,78 @@
+'use strict';
+
+const scule = require('scule');
+const warnings = require('../domain/warnings.cjs');
+const cliArguments = require('./cli-arguments.cjs');
+const cliErrors = require('./cli-errors.cjs');
+const cliOutput = require('./cli-output.cjs');
+
+const OUTPUT_SETTING = "output";
+const FIX_SETTING = "fix";
+const LOCAL_REF_ROOT_SETTING = "localRefRoot";
+const REMOTE_REF_HOSTS_SETTING = "remoteRefHosts";
+const IGNORED_SETTINGS = ["contentNever"];
+const CAMEL_CASE_SETTINGS = [
+  OUTPUT_SETTING,
+  FIX_SETTING,
+  LOCAL_REF_ROOT_SETTING,
+  REMOTE_REF_HOSTS_SETTING,
+  ...cliArguments.GENERATOR_FLAGS,
+  ...IGNORED_SETTINGS
+];
+const KNOWN_SETTINGS = /* @__PURE__ */ new Set([
+  ...CAMEL_CASE_SETTINGS,
+  ...CAMEL_CASE_SETTINGS.map((name) => scule.kebabCase(name))
+]);
+function unknownSettingWarnings(apiName, settings) {
+  return Object.keys(settings).filter((key) => !KNOWN_SETTINGS.has(key)).map(
+    (key) => warnings.warningText(
+      `API ${apiName}: the setting \`${key}\` is not an openapi-typesafe option and is ignored`,
+      warnings.WARNING_CODES.CONFIG_SETTING_UNKNOWN
+    )
+  );
+}
+function settingValue(settings, name) {
+  return name in settings ? settings[name] : settings[scule.kebabCase(name)];
+}
+function hasSetting(settings, name) {
+  return name in settings || scule.kebabCase(name) in settings;
+}
+function invalidSetting(apiName, name, expected) {
+  return cliErrors.cliError(
+    "CLI_CONFIG_INVALID",
+    `API ${apiName}: \`${scule.kebabCase(name)}\` in x-openapi-ts must be ${expected}`
+  );
+}
+function localRefRootOf(apiName, settings, configRoot) {
+  if (!hasSetting(settings, LOCAL_REF_ROOT_SETTING)) {
+    return {};
+  }
+  const value = settingValue(settings, LOCAL_REF_ROOT_SETTING) ?? "";
+  if (typeof value !== "string") {
+    throw invalidSetting(apiName, LOCAL_REF_ROOT_SETTING, "a directory path");
+  }
+  return { localRefRoot: cliOutput.resolveLocationUrl(value === "" ? "." : value, configRoot) };
+}
+function remoteRefHostsOf(apiName, settings) {
+  if (!hasSetting(settings, REMOTE_REF_HOSTS_SETTING)) {
+    return {};
+  }
+  const value = settingValue(settings, REMOTE_REF_HOSTS_SETTING) ?? [];
+  const entries = [value].flat();
+  if (entries.some((entry) => typeof entry !== "string")) {
+    throw invalidSetting(apiName, REMOTE_REF_HOSTS_SETTING, "a host list");
+  }
+  return { remoteRefHosts: cliArguments.hostList(entries) ?? [] };
+}
+function apiRefLimitOptions(apiName, settings, configRoot) {
+  return {
+    ...localRefRootOf(apiName, settings, configRoot),
+    ...remoteRefHostsOf(apiName, settings)
+  };
+}
+
+exports.FIX_SETTING = FIX_SETTING;
+exports.OUTPUT_SETTING = OUTPUT_SETTING;
+exports.apiRefLimitOptions = apiRefLimitOptions;
+exports.unknownSettingWarnings = unknownSettingWarnings;
+//# sourceMappingURL=api-settings.cjs.map

package/dist/cli/api-settings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-settings.cjs","sources":["../../src/cli/api-settings.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport { GENERATOR_FLAGS, hostList } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\nimport type { RefLimitOptions } from \"./ref-limits.js\";\n\n/**\n * The settings of one API in `redocly.yaml` (`apis.<name>.x-openapi-ts`). A setting has the name\n * of its CLI flag, in kebab-case or camelCase (ADR-021, decision 1); a setting the CLI does not\n * read gets a warning, as an unknown flag gets a notice.\n */\n\nexport type ApiSettings = Readonly<Record<string, unknown>>;\n\n/** The setting that names the output file. */\nexport const OUTPUT_SETTING = \"output\";\n\n/** The setting that lists the API's output fixes. */\nexport const FIX_SETTING = \"fix\";\n\nconst LOCAL_REF_ROOT_SETTING = \"localRefRoot\";\nconst REMOTE_REF_HOSTS_SETTING = \"remoteRefHosts\";\n\n/** `--content-never` is accepted and has no effect, as on the command line. */\nconst IGNORED_SETTINGS = [\"contentNever\"] as const;\n\nconst CAMEL_CASE_SETTINGS = [\n  OUTPUT_SETTING,\n  FIX_SETTING,\n  LOCAL_REF_ROOT_SETTING,\n  REMOTE_REF_HOSTS_SETTING,\n  ...GENERATOR_FLAGS,\n  ...IGNORED_SETTINGS,\n];\n\nconst KNOWN_SETTINGS = new Set<string>([\n  ...CAMEL_CASE_SETTINGS,\n  ...CAMEL_CASE_SETTINGS.map((name) => kebabCase(name)),\n]);\n\n/** The warning for each setting of an API that no code reads. */\nexport function unknownSettingWarnings(apiName: string, settings: ApiSettings): string[] {\n  return Object.keys(settings)\n    .filter((key) => !KNOWN_SETTINGS.has(key))\n    .map((key) =>\n      warningText(\n        `API ${apiName}: the setting \\`${key}\\` is not an openapi-typesafe option and is ignored`,\n        WARNING_CODES.CONFIG_SETTING_UNKNOWN,\n      ),\n    );\n}\n\n/** The value of a setting in camelCase, else in kebab-case; `undefined` when it is absent. */\nfunction settingValue(settings: ApiSettings, name: string): unknown {\n  return name in settings ? settings[name] : settings[kebabCase(name)];\n}\n\nfunction hasSetting(settings: ApiSettings, name: string): boolean {\n  return name in settings || kebabCase(name) in settings;\n}\n\nfunction invalidSetting(apiName: string, name: string, expected: string): Error {\n  return cliError(\n    \"CLI_CONFIG_INVALID\",\n    `API ${apiName}: \\`${kebabCase(name)}\\` in x-openapi-ts must be ${expected}`,\n  );\n}\n\n/** `local-ref-root: dir`, relative to the config file; empty means the config file's directory. */\nfunction localRefRootOf(apiName: string, settings: ApiSettings, configRoot: URL): RefLimitOptions {\n  if (!hasSetting(settings, LOCAL_REF_ROOT_SETTING)) {\n    return {};\n  }\n  const value = settingValue(settings, LOCAL_REF_ROOT_SETTING) ?? \"\";\n  if (typeof value !== \"string\") {\n    throw invalidSetting(apiName, LOCAL_REF_ROOT_SETTING, \"a directory path\");\n  }\n  return { localRefRoot: resolveLocationUrl(value === \"\" ? \".\" : value, configRoot) };\n}\n\n/** `remote-ref-hosts: [a, b]` or `a,b`; an empty list or value allows no host. */\nfunction remoteRefHostsOf(apiName: string, settings: ApiSettings): RefLimitOptions {\n  if (!hasSetting(settings, REMOTE_REF_HOSTS_SETTING)) {\n    return {};\n  }\n  const value = settingValue(settings, REMOTE_REF_HOSTS_SETTING) ?? [];\n  const entries = [value].flat();\n  if (entries.some((entry) => typeof entry !== \"string\")) {\n    throw invalidSetting(apiName, REMOTE_REF_HOSTS_SETTING, \"a host list\");\n  }\n  return { remoteRefHosts: hostList(entries) ?? [] };\n}\n\n/**\n * The `$ref` limits an API sets (threat model R1, R2). Each one replaces the CLI flag of the same\n * name for this API, as its boolean settings and `fix` do; fails with `CLI_CONFIG_INVALID` for a\n * value of another type.\n */\nexport function apiRefLimitOptions(\n  apiName: string,\n  settings: ApiSettings,\n  configRoot: URL,\n): RefLimitOptions {\n  return {\n    ...localRefRootOf(apiName, settings, configRoot),\n    ...remoteRefHostsOf(apiName, settings),\n  };\n}\n"],"names":["GENERATOR_FLAGS","kebabCase","warningText","WARNING_CODES","cliError","resolveLocationUrl","hostList"],"mappings":";;;;;;;;AAgBO,MAAM,cAAA,GAAiB;AAGvB,MAAM,WAAA,GAAc;AAE3B,MAAM,sBAAA,GAAyB,cAAA;AAC/B,MAAM,wBAAA,GAA2B,gBAAA;AAGjC,MAAM,gBAAA,GAAmB,CAAC,cAAc,CAAA;AAExC,MAAM,mBAAA,GAAsB;AAAA,EAC1B,cAAA;AAAA,EACA,WAAA;AAAA,EACA,sBAAA;AAAA,EACA,wBAAA;AAAA,EACA,GAAGA,4BAAA;AAAA,EACH,GAAG;AACL,CAAA;AAEA,MAAM,cAAA,uBAAqB,GAAA,CAAY;AAAA,EACrC,GAAG,mBAAA;AAAA,EACH,GAAG,mBAAA,CAAoB,GAAA,CAAI,CAAC,IAAA,KAASC,eAAA,CAAU,IAAI,CAAC;AACtD,CAAC,CAAA;AAGM,SAAS,sBAAA,CAAuB,SAAiB,QAAA,EAAiC;AACvF,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,CACxB,MAAA,CAAO,CAAC,GAAA,KAAQ,CAAC,cAAA,CAAe,GAAA,CAAI,GAAG,CAAC,CAAA,CACxC,GAAA;AAAA,IAAI,CAAC,GAAA,KACJC,oBAAA;AAAA,MACE,CAAA,IAAA,EAAO,OAAO,CAAA,gBAAA,EAAmB,GAAG,CAAA,mDAAA,CAAA;AAAA,MACpCC,sBAAA,CAAc;AAAA;AAChB,GACF;AACJ;AAGA,SAAS,YAAA,CAAa,UAAuB,IAAA,EAAuB;AAClE,EAAA,OAAO,IAAA,IAAQ,WAAW,QAAA,CAAS,IAAI,IAAI,QAAA,CAASF,eAAA,CAAU,IAAI,CAAC,CAAA;AACrE;AAEA,SAAS,UAAA,CAAW,UAAuB,IAAA,EAAuB;AAChE,EAAA,OAAO,IAAA,IAAQ,QAAA,IAAYA,eAAA,CAAU,IAAI,CAAA,IAAK,QAAA;AAChD;AAEA,SAAS,cAAA,CAAe,OAAA,EAAiB,IAAA,EAAc,QAAA,EAAyB;AAC9E,EAAA,OAAOG,kBAAA;AAAA,IACL,oBAAA;AAAA,IACA,OAAO,OAAO,CAAA,IAAA,EAAOH,gBAAU,IAAI,CAAC,8BAA8B,QAAQ,CAAA;AAAA,GAC5E;AACF;AAGA,SAAS,cAAA,CAAe,OAAA,EAAiB,QAAA,EAAuB,UAAA,EAAkC;AAChG,EAAA,IAAI,CAAC,UAAA,CAAW,QAAA,EAAU,sBAAsB,CAAA,EAAG;AACjD,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,QAAA,EAAU,sBAAsB,CAAA,IAAK,EAAA;AAChE,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,MAAM,cAAA,CAAe,OAAA,EAAS,sBAAA,EAAwB,kBAAkB,CAAA;AAAA,EAC1E;AACA,EAAA,OAAO,EAAE,cAAcI,4BAAA,CAAmB,KAAA,KAAU,KAAK,GAAA,GAAM,KAAA,EAAO,UAAU,CAAA,EAAE;AACpF;AAGA,SAAS,gBAAA,CAAiB,SAAiB,QAAA,EAAwC;AACjF,EAAA,IAAI,CAAC,UAAA,CAAW,QAAA,EAAU,wBAAwB,CAAA,EAAG;AACnD,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,QAAA,EAAU,wBAAwB,KAAK,EAAC;AACnE,EAAA,MAAM,OAAA,GAAU,CAAC,KAAK,CAAA,CAAE,IAAA,EAAK;AAC7B,EAAA,IAAI,QAAQ,IAAA,CAAK,CAAC,UAAU,OAAO,KAAA,KAAU,QAAQ,CAAA,EAAG;AACtD,IAAA,MAAM,cAAA,CAAe,OAAA,EAAS,wBAAA,EAA0B,aAAa,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,EAAE,cAAA,EAAgBC,qBAAA,CAAS,OAAO,CAAA,IAAK,EAAC,EAAE;AACnD;AAOO,SAAS,kBAAA,CACd,OAAA,EACA,QAAA,EACA,UAAA,EACiB;AACjB,EAAA,OAAO;AAAA,IACL,GAAG,cAAA,CAAe,OAAA,EAAS,QAAA,EAAU,UAAU,CAAA;AAAA,IAC/C,GAAG,gBAAA,CAAiB,OAAA,EAAS,QAAQ;AAAA,GACvC;AACF;;;;;"}

package/dist/cli/api-settings.mjs

@@ -0,0 +1,73 @@
+import { kebabCase } from 'scule';
+import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
+import { GENERATOR_FLAGS, hostList } from './cli-arguments.mjs';
+import { cliError } from './cli-errors.mjs';
+import { resolveLocationUrl } from './cli-output.mjs';
+
+const OUTPUT_SETTING = "output";
+const FIX_SETTING = "fix";
+const LOCAL_REF_ROOT_SETTING = "localRefRoot";
+const REMOTE_REF_HOSTS_SETTING = "remoteRefHosts";
+const IGNORED_SETTINGS = ["contentNever"];
+const CAMEL_CASE_SETTINGS = [
+  OUTPUT_SETTING,
+  FIX_SETTING,
+  LOCAL_REF_ROOT_SETTING,
+  REMOTE_REF_HOSTS_SETTING,
+  ...GENERATOR_FLAGS,
+  ...IGNORED_SETTINGS
+];
+const KNOWN_SETTINGS = /* @__PURE__ */ new Set([
+  ...CAMEL_CASE_SETTINGS,
+  ...CAMEL_CASE_SETTINGS.map((name) => kebabCase(name))
+]);
+function unknownSettingWarnings(apiName, settings) {
+  return Object.keys(settings).filter((key) => !KNOWN_SETTINGS.has(key)).map(
+    (key) => warningText(
+      `API ${apiName}: the setting \`${key}\` is not an openapi-typesafe option and is ignored`,
+      WARNING_CODES.CONFIG_SETTING_UNKNOWN
+    )
+  );
+}
+function settingValue(settings, name) {
+  return name in settings ? settings[name] : settings[kebabCase(name)];
+}
+function hasSetting(settings, name) {
+  return name in settings || kebabCase(name) in settings;
+}
+function invalidSetting(apiName, name, expected) {
+  return cliError(
+    "CLI_CONFIG_INVALID",
+    `API ${apiName}: \`${kebabCase(name)}\` in x-openapi-ts must be ${expected}`
+  );
+}
+function localRefRootOf(apiName, settings, configRoot) {
+  if (!hasSetting(settings, LOCAL_REF_ROOT_SETTING)) {
+    return {};
+  }
+  const value = settingValue(settings, LOCAL_REF_ROOT_SETTING) ?? "";
+  if (typeof value !== "string") {
+    throw invalidSetting(apiName, LOCAL_REF_ROOT_SETTING, "a directory path");
+  }
+  return { localRefRoot: resolveLocationUrl(value === "" ? "." : value, configRoot) };
+}
+function remoteRefHostsOf(apiName, settings) {
+  if (!hasSetting(settings, REMOTE_REF_HOSTS_SETTING)) {
+    return {};
+  }
+  const value = settingValue(settings, REMOTE_REF_HOSTS_SETTING) ?? [];
+  const entries = [value].flat();
+  if (entries.some((entry) => typeof entry !== "string")) {
+    throw invalidSetting(apiName, REMOTE_REF_HOSTS_SETTING, "a host list");
+  }
+  return { remoteRefHosts: hostList(entries) ?? [] };
+}
+function apiRefLimitOptions(apiName, settings, configRoot) {
+  return {
+    ...localRefRootOf(apiName, settings, configRoot),
+    ...remoteRefHostsOf(apiName, settings)
+  };
+}
+
+export { FIX_SETTING, OUTPUT_SETTING, apiRefLimitOptions, unknownSettingWarnings };
+//# sourceMappingURL=api-settings.mjs.map

package/dist/cli/api-settings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-settings.mjs","sources":["../../src/cli/api-settings.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport { GENERATOR_FLAGS, hostList } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\nimport type { RefLimitOptions } from \"./ref-limits.js\";\n\n/**\n * The settings of one API in `redocly.yaml` (`apis.<name>.x-openapi-ts`). A setting has the name\n * of its CLI flag, in kebab-case or camelCase (ADR-021, decision 1); a setting the CLI does not\n * read gets a warning, as an unknown flag gets a notice.\n */\n\nexport type ApiSettings = Readonly<Record<string, unknown>>;\n\n/** The setting that names the output file. */\nexport const OUTPUT_SETTING = \"output\";\n\n/** The setting that lists the API's output fixes. */\nexport const FIX_SETTING = \"fix\";\n\nconst LOCAL_REF_ROOT_SETTING = \"localRefRoot\";\nconst REMOTE_REF_HOSTS_SETTING = \"remoteRefHosts\";\n\n/** `--content-never` is accepted and has no effect, as on the command line. */\nconst IGNORED_SETTINGS = [\"contentNever\"] as const;\n\nconst CAMEL_CASE_SETTINGS = [\n  OUTPUT_SETTING,\n  FIX_SETTING,\n  LOCAL_REF_ROOT_SETTING,\n  REMOTE_REF_HOSTS_SETTING,\n  ...GENERATOR_FLAGS,\n  ...IGNORED_SETTINGS,\n];\n\nconst KNOWN_SETTINGS = new Set<string>([\n  ...CAMEL_CASE_SETTINGS,\n  ...CAMEL_CASE_SETTINGS.map((name) => kebabCase(name)),\n]);\n\n/** The warning for each setting of an API that no code reads. */\nexport function unknownSettingWarnings(apiName: string, settings: ApiSettings): string[] {\n  return Object.keys(settings)\n    .filter((key) => !KNOWN_SETTINGS.has(key))\n    .map((key) =>\n      warningText(\n        `API ${apiName}: the setting \\`${key}\\` is not an openapi-typesafe option and is ignored`,\n        WARNING_CODES.CONFIG_SETTING_UNKNOWN,\n      ),\n    );\n}\n\n/** The value of a setting in camelCase, else in kebab-case; `undefined` when it is absent. */\nfunction settingValue(settings: ApiSettings, name: string): unknown {\n  return name in settings ? settings[name] : settings[kebabCase(name)];\n}\n\nfunction hasSetting(settings: ApiSettings, name: string): boolean {\n  return name in settings || kebabCase(name) in settings;\n}\n\nfunction invalidSetting(apiName: string, name: string, expected: string): Error {\n  return cliError(\n    \"CLI_CONFIG_INVALID\",\n    `API ${apiName}: \\`${kebabCase(name)}\\` in x-openapi-ts must be ${expected}`,\n  );\n}\n\n/** `local-ref-root: dir`, relative to the config file; empty means the config file's directory. */\nfunction localRefRootOf(apiName: string, settings: ApiSettings, configRoot: URL): RefLimitOptions {\n  if (!hasSetting(settings, LOCAL_REF_ROOT_SETTING)) {\n    return {};\n  }\n  const value = settingValue(settings, LOCAL_REF_ROOT_SETTING) ?? \"\";\n  if (typeof value !== \"string\") {\n    throw invalidSetting(apiName, LOCAL_REF_ROOT_SETTING, \"a directory path\");\n  }\n  return { localRefRoot: resolveLocationUrl(value === \"\" ? \".\" : value, configRoot) };\n}\n\n/** `remote-ref-hosts: [a, b]` or `a,b`; an empty list or value allows no host. */\nfunction remoteRefHostsOf(apiName: string, settings: ApiSettings): RefLimitOptions {\n  if (!hasSetting(settings, REMOTE_REF_HOSTS_SETTING)) {\n    return {};\n  }\n  const value = settingValue(settings, REMOTE_REF_HOSTS_SETTING) ?? [];\n  const entries = [value].flat();\n  if (entries.some((entry) => typeof entry !== \"string\")) {\n    throw invalidSetting(apiName, REMOTE_REF_HOSTS_SETTING, \"a host list\");\n  }\n  return { remoteRefHosts: hostList(entries) ?? [] };\n}\n\n/**\n * The `$ref` limits an API sets (threat model R1, R2). Each one replaces the CLI flag of the same\n * name for this API, as its boolean settings and `fix` do; fails with `CLI_CONFIG_INVALID` for a\n * value of another type.\n */\nexport function apiRefLimitOptions(\n  apiName: string,\n  settings: ApiSettings,\n  configRoot: URL,\n): RefLimitOptions {\n  return {\n    ...localRefRootOf(apiName, settings, configRoot),\n    ...remoteRefHostsOf(apiName, settings),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/cli-arguments.cjs

@@ -140,6 +140,7 @@ function parseCliArguments(argv) {
 }
 
 exports.GENERATOR_FLAGS = GENERATOR_FLAGS;
+exports.hostList = hostList;
 exports.ineffectiveFlagNotices = ineffectiveFlagNotices;
 exports.parseCliArguments = parseCliArguments;
 //# sourceMappingURL=cli-arguments.cjs.map

package/dist/cli/cli-arguments.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.cjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** Boolean flags that become generator options (camelCase; yargs also accepts kebab-case). */\nexport const GENERATOR_FLAGS = [\n  \"additionalProperties\",\n  \"alphabetize\",\n  \"arrayLength\",\n  \"binaryAsBlob\",\n  \"conditionalEnums\",\n  \"dedupeEnums\",\n  \"defaultNonNullable\",\n  \"emptyObjectsUnknown\",\n  \"enum\",\n  \"enumValues\",\n  \"excludeDeprecated\",\n  \"exportType\",\n  \"generatePathParams\",\n  \"immutable\",\n  \"lint\",\n  \"makePathsEnum\",\n  \"pathParamsAsTypes\",\n  \"propertiesRequiredByDefault\",\n  \"readWriteMarkers\",\n  \"rootTypes\",\n  \"rootTypesKeepCasing\",\n  \"rootTypesNoSchemaPrefix\",\n] as const;\n\nexport type GeneratorFlag = (typeof GENERATOR_FLAGS)[number];\n\nexport type GeneratorFlags = Readonly<Partial<Record<GeneratorFlag, boolean>>>;\n\n// `contentNever` was a boolean flag of the original CLI that no code reads; it stays in the list\n// so that `--content-never <input>` keeps parsing as a flag and an input.\nconst CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, \"check\", \"contentNever\", \"help\"];\n\n// yargs-parser matches the `boolean` list by the exact spelling of the flag: with camelCase names\n// only, `--root-types schema.yaml` took the path as the flag's value (upstream #2523). Both\n// spellings are listed.\nconst BOOLEAN_FLAGS = [\n  ...CAMEL_CASE_BOOLEAN_FLAGS,\n  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag)),\n];\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags of older versions that were removed or renamed, with the message for each. */\nconst REMOVED_FLAGS: readonly (readonly [string, string])[] = [\n  [\"-ap\", `The -ap alias has been deprecated. Use \"--additional-properties\" instead.`],\n  [\"--immutable-types\", `The --immutable-types flag has been renamed to \"--immutable\".`],\n  [\n    \"--support-array-length\",\n    `The --support-array-length flag has been renamed to \"--array-length\".`,\n  ],\n  [\"-it\", `The -it alias has been deprecated. Use \"--immutable\" instead.`],\n  [\"--redoc\", `The --redoc config flag has been renamed to \"--redocly\" (or -c as shorthand).`],\n];\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"--root-types-no-schema-prefix\", \"--root-types-keep-casing\"] as const;\n\nfunction rejectRemovedFlags(argv: readonly string[]): void {\n  for (const [flag, message] of REMOVED_FLAGS) {\n    if (argv.includes(flag)) {\n      throw cliError(\"CLI_FLAG_REMOVED\", message);\n    }\n  }\n}\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(argv: readonly string[]): string[] {\n  if (argv.includes(\"--root-types\")) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(\n    (flag) => `${flag} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/** The last value of a flag that may be given more than once. */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/** `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. */\nfunction hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/** String flags, in both spellings, so that a value such as `8080` is not read as a number. */\nconst STRING_FLAGS = [\n  \"output\",\n  \"redocly\",\n  \"fix\",\n  ...[\"localRefRoot\", \"remoteRefHosts\"].flatMap((flag) => [flag, kebabCase(flag)]),\n];\n\nconst ALIASES = { redocly: [\"c\"], exportType: [\"t\"], output: [\"o\"] };\n\n/** Every name yargs-parser can return for a flag this CLI reads. */\nconst KNOWN_FLAGS = new Set<string>([\n  ...BOOLEAN_FLAGS,\n  ...STRING_FLAGS,\n  ...Object.values(ALIASES).flat(),\n  \"version\",\n]);\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  rejectRemovedFlags(argv);\n  const parsed = parser([...argv], {\n    boolean: BOOLEAN_FLAGS,\n    string: STRING_FLAGS,\n    alias: ALIASES,\n  });\n  return {\n    input: optionalString(parsed._[0]),\n    output: optionalString(parsed.output),\n    redocly: optionalString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":["kebabCase","cliError","parser","fixNamesOf"],"mappings":"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"}
+{"version":3,"file":"cli-arguments.cjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** Boolean flags that become generator options (camelCase; yargs also accepts kebab-case). */\nexport const GENERATOR_FLAGS = [\n  \"additionalProperties\",\n  \"alphabetize\",\n  \"arrayLength\",\n  \"binaryAsBlob\",\n  \"conditionalEnums\",\n  \"dedupeEnums\",\n  \"defaultNonNullable\",\n  \"emptyObjectsUnknown\",\n  \"enum\",\n  \"enumValues\",\n  \"excludeDeprecated\",\n  \"exportType\",\n  \"generatePathParams\",\n  \"immutable\",\n  \"lint\",\n  \"makePathsEnum\",\n  \"pathParamsAsTypes\",\n  \"propertiesRequiredByDefault\",\n  \"readWriteMarkers\",\n  \"rootTypes\",\n  \"rootTypesKeepCasing\",\n  \"rootTypesNoSchemaPrefix\",\n] as const;\n\nexport type GeneratorFlag = (typeof GENERATOR_FLAGS)[number];\n\nexport type GeneratorFlags = Readonly<Partial<Record<GeneratorFlag, boolean>>>;\n\n// `contentNever` was a boolean flag of the original CLI that no code reads; it stays in the list\n// so that `--content-never <input>` keeps parsing as a flag and an input.\nconst CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, \"check\", \"contentNever\", \"help\"];\n\n// yargs-parser matches the `boolean` list by the exact spelling of the flag: with camelCase names\n// only, `--root-types schema.yaml` took the path as the flag's value (upstream #2523). Both\n// spellings are listed.\nconst BOOLEAN_FLAGS = [\n  ...CAMEL_CASE_BOOLEAN_FLAGS,\n  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag)),\n];\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags of older versions that were removed or renamed, with the message for each. */\nconst REMOVED_FLAGS: readonly (readonly [string, string])[] = [\n  [\"-ap\", `The -ap alias has been deprecated. Use \"--additional-properties\" instead.`],\n  [\"--immutable-types\", `The --immutable-types flag has been renamed to \"--immutable\".`],\n  [\n    \"--support-array-length\",\n    `The --support-array-length flag has been renamed to \"--array-length\".`,\n  ],\n  [\"-it\", `The -it alias has been deprecated. Use \"--immutable\" instead.`],\n  [\"--redoc\", `The --redoc config flag has been renamed to \"--redocly\" (or -c as shorthand).`],\n];\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"--root-types-no-schema-prefix\", \"--root-types-keep-casing\"] as const;\n\nfunction rejectRemovedFlags(argv: readonly string[]): void {\n  for (const [flag, message] of REMOVED_FLAGS) {\n    if (argv.includes(flag)) {\n      throw cliError(\"CLI_FLAG_REMOVED\", message);\n    }\n  }\n}\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(argv: readonly string[]): string[] {\n  if (argv.includes(\"--root-types\")) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(\n    (flag) => `${flag} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/** The last value of a flag that may be given more than once. */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/**\n * `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. The\n * `remote-ref-hosts` setting of a `redocly.yaml` API is read the same way.\n */\nexport function hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/** String flags, in both spellings, so that a value such as `8080` is not read as a number. */\nconst STRING_FLAGS = [\n  \"output\",\n  \"redocly\",\n  \"fix\",\n  ...[\"localRefRoot\", \"remoteRefHosts\"].flatMap((flag) => [flag, kebabCase(flag)]),\n];\n\nconst ALIASES = { redocly: [\"c\"], exportType: [\"t\"], output: [\"o\"] };\n\n/** Every name yargs-parser can return for a flag this CLI reads. */\nconst KNOWN_FLAGS = new Set<string>([\n  ...BOOLEAN_FLAGS,\n  ...STRING_FLAGS,\n  ...Object.values(ALIASES).flat(),\n  \"version\",\n]);\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  rejectRemovedFlags(argv);\n  const parsed = parser([...argv], {\n    boolean: BOOLEAN_FLAGS,\n    string: STRING_FLAGS,\n    alias: ALIASES,\n  });\n  return {\n    input: optionalString(parsed._[0]),\n    output: optionalString(parsed.output),\n    redocly: optionalString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":["kebabCase","cliError","parser","fixNamesOf"],"mappings":"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"}

package/dist/cli/cli-arguments.mjs

@@ -133,5 +133,5 @@ function parseCliArguments(argv) {
   };
 }
 
-export { GENERATOR_FLAGS, ineffectiveFlagNotices, parseCliArguments };
+export { GENERATOR_FLAGS, hostList, ineffectiveFlagNotices, parseCliArguments };
 //# sourceMappingURL=cli-arguments.mjs.map

package/dist/cli/cli-arguments.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.mjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** Boolean flags that become generator options (camelCase; yargs also accepts kebab-case). */\nexport const GENERATOR_FLAGS = [\n  \"additionalProperties\",\n  \"alphabetize\",\n  \"arrayLength\",\n  \"binaryAsBlob\",\n  \"conditionalEnums\",\n  \"dedupeEnums\",\n  \"defaultNonNullable\",\n  \"emptyObjectsUnknown\",\n  \"enum\",\n  \"enumValues\",\n  \"excludeDeprecated\",\n  \"exportType\",\n  \"generatePathParams\",\n  \"immutable\",\n  \"lint\",\n  \"makePathsEnum\",\n  \"pathParamsAsTypes\",\n  \"propertiesRequiredByDefault\",\n  \"readWriteMarkers\",\n  \"rootTypes\",\n  \"rootTypesKeepCasing\",\n  \"rootTypesNoSchemaPrefix\",\n] as const;\n\nexport type GeneratorFlag = (typeof GENERATOR_FLAGS)[number];\n\nexport type GeneratorFlags = Readonly<Partial<Record<GeneratorFlag, boolean>>>;\n\n// `contentNever` was a boolean flag of the original CLI that no code reads; it stays in the list\n// so that `--content-never <input>` keeps parsing as a flag and an input.\nconst CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, \"check\", \"contentNever\", \"help\"];\n\n// yargs-parser matches the `boolean` list by the exact spelling of the flag: with camelCase names\n// only, `--root-types schema.yaml` took the path as the flag's value (upstream #2523). Both\n// spellings are listed.\nconst BOOLEAN_FLAGS = [\n  ...CAMEL_CASE_BOOLEAN_FLAGS,\n  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag)),\n];\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags of older versions that were removed or renamed, with the message for each. */\nconst REMOVED_FLAGS: readonly (readonly [string, string])[] = [\n  [\"-ap\", `The -ap alias has been deprecated. Use \"--additional-properties\" instead.`],\n  [\"--immutable-types\", `The --immutable-types flag has been renamed to \"--immutable\".`],\n  [\n    \"--support-array-length\",\n    `The --support-array-length flag has been renamed to \"--array-length\".`,\n  ],\n  [\"-it\", `The -it alias has been deprecated. Use \"--immutable\" instead.`],\n  [\"--redoc\", `The --redoc config flag has been renamed to \"--redocly\" (or -c as shorthand).`],\n];\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"--root-types-no-schema-prefix\", \"--root-types-keep-casing\"] as const;\n\nfunction rejectRemovedFlags(argv: readonly string[]): void {\n  for (const [flag, message] of REMOVED_FLAGS) {\n    if (argv.includes(flag)) {\n      throw cliError(\"CLI_FLAG_REMOVED\", message);\n    }\n  }\n}\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(argv: readonly string[]): string[] {\n  if (argv.includes(\"--root-types\")) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(\n    (flag) => `${flag} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/** The last value of a flag that may be given more than once. */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/** `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. */\nfunction hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/** String flags, in both spellings, so that a value such as `8080` is not read as a number. */\nconst STRING_FLAGS = [\n  \"output\",\n  \"redocly\",\n  \"fix\",\n  ...[\"localRefRoot\", \"remoteRefHosts\"].flatMap((flag) => [flag, kebabCase(flag)]),\n];\n\nconst ALIASES = { redocly: [\"c\"], exportType: [\"t\"], output: [\"o\"] };\n\n/** Every name yargs-parser can return for a flag this CLI reads. */\nconst KNOWN_FLAGS = new Set<string>([\n  ...BOOLEAN_FLAGS,\n  ...STRING_FLAGS,\n  ...Object.values(ALIASES).flat(),\n  \"version\",\n]);\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  rejectRemovedFlags(argv);\n  const parsed = parser([...argv], {\n    boolean: BOOLEAN_FLAGS,\n    string: STRING_FLAGS,\n    alias: ALIASES,\n  });\n  return {\n    input: optionalString(parsed._[0]),\n    output: optionalString(parsed.output),\n    redocly: optionalString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-arguments.mjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** Boolean flags that become generator options (camelCase; yargs also accepts kebab-case). */\nexport const GENERATOR_FLAGS = [\n  \"additionalProperties\",\n  \"alphabetize\",\n  \"arrayLength\",\n  \"binaryAsBlob\",\n  \"conditionalEnums\",\n  \"dedupeEnums\",\n  \"defaultNonNullable\",\n  \"emptyObjectsUnknown\",\n  \"enum\",\n  \"enumValues\",\n  \"excludeDeprecated\",\n  \"exportType\",\n  \"generatePathParams\",\n  \"immutable\",\n  \"lint\",\n  \"makePathsEnum\",\n  \"pathParamsAsTypes\",\n  \"propertiesRequiredByDefault\",\n  \"readWriteMarkers\",\n  \"rootTypes\",\n  \"rootTypesKeepCasing\",\n  \"rootTypesNoSchemaPrefix\",\n] as const;\n\nexport type GeneratorFlag = (typeof GENERATOR_FLAGS)[number];\n\nexport type GeneratorFlags = Readonly<Partial<Record<GeneratorFlag, boolean>>>;\n\n// `contentNever` was a boolean flag of the original CLI that no code reads; it stays in the list\n// so that `--content-never <input>` keeps parsing as a flag and an input.\nconst CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, \"check\", \"contentNever\", \"help\"];\n\n// yargs-parser matches the `boolean` list by the exact spelling of the flag: with camelCase names\n// only, `--root-types schema.yaml` took the path as the flag's value (upstream #2523). Both\n// spellings are listed.\nconst BOOLEAN_FLAGS = [\n  ...CAMEL_CASE_BOOLEAN_FLAGS,\n  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag)),\n];\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags of older versions that were removed or renamed, with the message for each. */\nconst REMOVED_FLAGS: readonly (readonly [string, string])[] = [\n  [\"-ap\", `The -ap alias has been deprecated. Use \"--additional-properties\" instead.`],\n  [\"--immutable-types\", `The --immutable-types flag has been renamed to \"--immutable\".`],\n  [\n    \"--support-array-length\",\n    `The --support-array-length flag has been renamed to \"--array-length\".`,\n  ],\n  [\"-it\", `The -it alias has been deprecated. Use \"--immutable\" instead.`],\n  [\"--redoc\", `The --redoc config flag has been renamed to \"--redocly\" (or -c as shorthand).`],\n];\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"--root-types-no-schema-prefix\", \"--root-types-keep-casing\"] as const;\n\nfunction rejectRemovedFlags(argv: readonly string[]): void {\n  for (const [flag, message] of REMOVED_FLAGS) {\n    if (argv.includes(flag)) {\n      throw cliError(\"CLI_FLAG_REMOVED\", message);\n    }\n  }\n}\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(argv: readonly string[]): string[] {\n  if (argv.includes(\"--root-types\")) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(\n    (flag) => `${flag} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/** The last value of a flag that may be given more than once. */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/**\n * `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. The\n * `remote-ref-hosts` setting of a `redocly.yaml` API is read the same way.\n */\nexport function hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/** String flags, in both spellings, so that a value such as `8080` is not read as a number. */\nconst STRING_FLAGS = [\n  \"output\",\n  \"redocly\",\n  \"fix\",\n  ...[\"localRefRoot\", \"remoteRefHosts\"].flatMap((flag) => [flag, kebabCase(flag)]),\n];\n\nconst ALIASES = { redocly: [\"c\"], exportType: [\"t\"], output: [\"o\"] };\n\n/** Every name yargs-parser can return for a flag this CLI reads. */\nconst KNOWN_FLAGS = new Set<string>([\n  ...BOOLEAN_FLAGS,\n  ...STRING_FLAGS,\n  ...Object.values(ALIASES).flat(),\n  \"version\",\n]);\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  rejectRemovedFlags(argv);\n  const parsed = parser([...argv], {\n    boolean: BOOLEAN_FLAGS,\n    string: STRING_FLAGS,\n    alias: ALIASES,\n  });\n  return {\n    input: optionalString(parsed._[0]),\n    output: optionalString(parsed.output),\n    redocly: optionalString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/help-text.cjs

@@ -5,7 +5,7 @@ const HELP_TEXT = [
   "  $ openapi-typesafe [input] [options]",
   "",
   "Options",
-  "  --help                     Display this",
+  "  --help                     Show this help",
   "  --version                  Display the version",
   "  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)",
   "  --output, -o               Specify output file (if not specified in redocly.yaml)",
@@ -18,7 +18,7 @@ const HELP_TEXT = [
   "  --immutable                Generate readonly types",
   "  --additional-properties    Treat schema objects as if `additionalProperties: true` is set",
   "  --empty-objects-unknown    Generate `unknown` instead of `Record<string, never>` for empty objects",
-  "  --default-non-nullable     Set to `false` to ignore default values when generating non-nullable types",
+  "  --default-non-nullable     A property with a `default` is required (default: true; =false makes it optional)",
   "  --properties-required-by-default",
   "                             Treat schema objects as if `required` is set to all properties by default",
   "  --array-length             Generate tuples using array minItems / maxItems",
@@ -28,7 +28,7 @@ const HELP_TEXT = [
   "  --generate-path-params     Generate path parameters for all paths where they are undefined by schema",
   "  --alphabetize              Sort object keys alphabetically",
   "  --exclude-deprecated       Exclude deprecated types",
-  "  --root-types               Export schemas types at root level",
+  "  --root-types               Export `components` types as root-level aliases",
   "  --root-types-no-schema-prefix",
   '                             Do not add "Schema" prefix to types at the root level (should only be used with --root-types)',
   "  --root-types-keep-casing   Keep casing of root types (should only be used with --root-types)",

package/dist/cli/help-text.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"help-text.cjs","sources":["../../src/cli/help-text.ts"],"sourcesContent":["/** The text of `--help`, as in the original CLI; long lines are split only in this source. */\nexport const HELP_TEXT = [\n  \"Usage\",\n  \"  $ openapi-typesafe [input] [options]\",\n  \"\",\n  \"Options\",\n  \"  --help                     Display this\",\n  \"  --version                  Display the version\",\n  \"  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)\",\n  \"  --output, -o               Specify output file (if not specified in redocly.yaml)\",\n  \"  --enum                     Export true TS enums instead of unions\",\n  \"  --enum-values              Export enum values as arrays\",\n  \"  --conditional-enums        Only generate true TS enums when enum\" +\n    \" metadata is available (default: false)\",\n  \"  --dedupe-enums             Dedupe enum types when `--enum=true` is set\",\n  \"  --check                    Check that the generated types are\" +\n    \" up-to-date. (default: false)\",\n  \"  --export-type, -t          Export top-level `type` instead of `interface`\",\n  \"  --immutable                Generate readonly types\",\n  \"  --additional-properties    Treat schema objects as if `additionalProperties: true` is set\",\n  \"  --empty-objects-unknown    Generate `unknown` instead of\" +\n    \" `Record<string, never>` for empty objects\",\n  \"  --default-non-nullable     Set to `false` to ignore default values\" +\n    \" when generating non-nullable types\",\n  \"  --properties-required-by-default\",\n  \"                             Treat schema objects as if `required` is\" +\n    \" set to all properties by default\",\n  \"  --array-length             Generate tuples using array minItems / maxItems\",\n  \"  --binary-as-blob           Type raw binary strings (format: binary,\" +\n    \" contentMediaType) as Blob\",\n  \"  --fix [names]              Turn on output fixes, comma-separated, or\" +\n    ' \"all\" (see docs/cli.md#fix)',\n  \"  --path-params-as-types     Convert paths to template literal types\",\n  \"  --generate-path-params     Generate path parameters for all paths where they are\" +\n    \" undefined by schema\",\n  \"  --alphabetize              Sort object keys alphabetically\",\n  \"  --exclude-deprecated       Exclude deprecated types\",\n  \"  --root-types               Export schemas types at root level\",\n  \"  --root-types-no-schema-prefix\",\n  '                             Do not add \"Schema\" prefix to types at' +\n    \" the root level (should only be used with --root-types)\",\n  \"  --root-types-keep-casing   Keep casing of root types (should only be\" +\n    \" used with --root-types)\",\n  \"  --make-paths-enum          Generate ApiPaths enum for all paths\",\n  \"  --read-write-markers       Generate $Read/$Write markers for\" +\n    \" readOnly/writeOnly properties\",\n  \"  --no-lint                  Skip the Redocly lint (bundling errors still fail)\",\n  \"  --local-ref-root [dir]     Load local $ref files only from this directory\",\n  \"  --remote-ref-hosts [hosts] Load remote $ref documents only from these\" +\n    \" comma-separated hosts (empty: none)\",\n  \"\",\n].join(\"\\n\");\n"],"names":[],"mappings":";;AACO,MAAM,SAAA,GAAY;AAAA,EACvB,OAAA;AAAA,EACA,wCAAA;AAAA,EACA,EAAA;AAAA,EACA,SAAA;AAAA,EACA,2CAAA;AAAA,EACA,kDAAA;AAAA,EACA,qFAAA;AAAA,EACA,qFAAA;AAAA,EACA,qEAAA;AAAA,EACA,2DAAA;AAAA,EACA,2GAAA;AAAA,EAEA,0EAAA;AAAA,EACA,8FAAA;AAAA,EAEA,6EAAA;AAAA,EACA,sDAAA;AAAA,EACA,6FAAA;AAAA,EACA,sGAAA;AAAA,EAEA,yGAAA;AAAA,EAEA,oCAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8EAAA;AAAA,EACA,iGAAA;AAAA,EAEA,oGAAA;AAAA,EAEA,sEAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8DAAA;AAAA,EACA,uDAAA;AAAA,EACA,iEAAA;AAAA,EACA,iCAAA;AAAA,EACA,4HAAA;AAAA,EAEA,gGAAA;AAAA,EAEA,mEAAA;AAAA,EACA,8FAAA;AAAA,EAEA,iFAAA;AAAA,EACA,6EAAA;AAAA,EACA,6GAAA;AAAA,EAEA;AACF,CAAA,CAAE,KAAK,IAAI;;"}
+{"version":3,"file":"help-text.cjs","sources":["../../src/cli/help-text.ts"],"sourcesContent":["/** The text of `--help`, as in the original CLI; long lines are split only in this source. */\nexport const HELP_TEXT = [\n  \"Usage\",\n  \"  $ openapi-typesafe [input] [options]\",\n  \"\",\n  \"Options\",\n  \"  --help                     Show this help\",\n  \"  --version                  Display the version\",\n  \"  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)\",\n  \"  --output, -o               Specify output file (if not specified in redocly.yaml)\",\n  \"  --enum                     Export true TS enums instead of unions\",\n  \"  --enum-values              Export enum values as arrays\",\n  \"  --conditional-enums        Only generate true TS enums when enum\" +\n    \" metadata is available (default: false)\",\n  \"  --dedupe-enums             Dedupe enum types when `--enum=true` is set\",\n  \"  --check                    Check that the generated types are\" +\n    \" up-to-date. (default: false)\",\n  \"  --export-type, -t          Export top-level `type` instead of `interface`\",\n  \"  --immutable                Generate readonly types\",\n  \"  --additional-properties    Treat schema objects as if `additionalProperties: true` is set\",\n  \"  --empty-objects-unknown    Generate `unknown` instead of\" +\n    \" `Record<string, never>` for empty objects\",\n  \"  --default-non-nullable     A property with a `default` is required\" +\n    \" (default: true; =false makes it optional)\",\n  \"  --properties-required-by-default\",\n  \"                             Treat schema objects as if `required` is\" +\n    \" set to all properties by default\",\n  \"  --array-length             Generate tuples using array minItems / maxItems\",\n  \"  --binary-as-blob           Type raw binary strings (format: binary,\" +\n    \" contentMediaType) as Blob\",\n  \"  --fix [names]              Turn on output fixes, comma-separated, or\" +\n    ' \"all\" (see docs/cli.md#fix)',\n  \"  --path-params-as-types     Convert paths to template literal types\",\n  \"  --generate-path-params     Generate path parameters for all paths where they are\" +\n    \" undefined by schema\",\n  \"  --alphabetize              Sort object keys alphabetically\",\n  \"  --exclude-deprecated       Exclude deprecated types\",\n  \"  --root-types               Export `components` types as root-level aliases\",\n  \"  --root-types-no-schema-prefix\",\n  '                             Do not add \"Schema\" prefix to types at' +\n    \" the root level (should only be used with --root-types)\",\n  \"  --root-types-keep-casing   Keep casing of root types (should only be\" +\n    \" used with --root-types)\",\n  \"  --make-paths-enum          Generate ApiPaths enum for all paths\",\n  \"  --read-write-markers       Generate $Read/$Write markers for\" +\n    \" readOnly/writeOnly properties\",\n  \"  --no-lint                  Skip the Redocly lint (bundling errors still fail)\",\n  \"  --local-ref-root [dir]     Load local $ref files only from this directory\",\n  \"  --remote-ref-hosts [hosts] Load remote $ref documents only from these\" +\n    \" comma-separated hosts (empty: none)\",\n  \"\",\n].join(\"\\n\");\n"],"names":[],"mappings":";;AACO,MAAM,SAAA,GAAY;AAAA,EACvB,OAAA;AAAA,EACA,wCAAA;AAAA,EACA,EAAA;AAAA,EACA,SAAA;AAAA,EACA,6CAAA;AAAA,EACA,kDAAA;AAAA,EACA,qFAAA;AAAA,EACA,qFAAA;AAAA,EACA,qEAAA;AAAA,EACA,2DAAA;AAAA,EACA,2GAAA;AAAA,EAEA,0EAAA;AAAA,EACA,8FAAA;AAAA,EAEA,6EAAA;AAAA,EACA,sDAAA;AAAA,EACA,6FAAA;AAAA,EACA,sGAAA;AAAA,EAEA,gHAAA;AAAA,EAEA,oCAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8EAAA;AAAA,EACA,iGAAA;AAAA,EAEA,oGAAA;AAAA,EAEA,sEAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8DAAA;AAAA,EACA,uDAAA;AAAA,EACA,8EAAA;AAAA,EACA,iCAAA;AAAA,EACA,4HAAA;AAAA,EAEA,gGAAA;AAAA,EAEA,mEAAA;AAAA,EACA,8FAAA;AAAA,EAEA,iFAAA;AAAA,EACA,6EAAA;AAAA,EACA,6GAAA;AAAA,EAEA;AACF,CAAA,CAAE,KAAK,IAAI;;"}

package/dist/cli/help-text.mjs

@@ -3,7 +3,7 @@ const HELP_TEXT = [
   "  $ openapi-typesafe [input] [options]",
   "",
   "Options",
-  "  --help                     Display this",
+  "  --help                     Show this help",
   "  --version                  Display the version",
   "  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)",
   "  --output, -o               Specify output file (if not specified in redocly.yaml)",
@@ -16,7 +16,7 @@ const HELP_TEXT = [
   "  --immutable                Generate readonly types",
   "  --additional-properties    Treat schema objects as if `additionalProperties: true` is set",
   "  --empty-objects-unknown    Generate `unknown` instead of `Record<string, never>` for empty objects",
-  "  --default-non-nullable     Set to `false` to ignore default values when generating non-nullable types",
+  "  --default-non-nullable     A property with a `default` is required (default: true; =false makes it optional)",
   "  --properties-required-by-default",
   "                             Treat schema objects as if `required` is set to all properties by default",
   "  --array-length             Generate tuples using array minItems / maxItems",
@@ -26,7 +26,7 @@ const HELP_TEXT = [
   "  --generate-path-params     Generate path parameters for all paths where they are undefined by schema",
   "  --alphabetize              Sort object keys alphabetically",
   "  --exclude-deprecated       Exclude deprecated types",
-  "  --root-types               Export schemas types at root level",
+  "  --root-types               Export `components` types as root-level aliases",
   "  --root-types-no-schema-prefix",
   '                             Do not add "Schema" prefix to types at the root level (should only be used with --root-types)',
   "  --root-types-keep-casing   Keep casing of root types (should only be used with --root-types)",

package/dist/cli/help-text.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"help-text.mjs","sources":["../../src/cli/help-text.ts"],"sourcesContent":["/** The text of `--help`, as in the original CLI; long lines are split only in this source. */\nexport const HELP_TEXT = [\n  \"Usage\",\n  \"  $ openapi-typesafe [input] [options]\",\n  \"\",\n  \"Options\",\n  \"  --help                     Display this\",\n  \"  --version                  Display the version\",\n  \"  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)\",\n  \"  --output, -o               Specify output file (if not specified in redocly.yaml)\",\n  \"  --enum                     Export true TS enums instead of unions\",\n  \"  --enum-values              Export enum values as arrays\",\n  \"  --conditional-enums        Only generate true TS enums when enum\" +\n    \" metadata is available (default: false)\",\n  \"  --dedupe-enums             Dedupe enum types when `--enum=true` is set\",\n  \"  --check                    Check that the generated types are\" +\n    \" up-to-date. (default: false)\",\n  \"  --export-type, -t          Export top-level `type` instead of `interface`\",\n  \"  --immutable                Generate readonly types\",\n  \"  --additional-properties    Treat schema objects as if `additionalProperties: true` is set\",\n  \"  --empty-objects-unknown    Generate `unknown` instead of\" +\n    \" `Record<string, never>` for empty objects\",\n  \"  --default-non-nullable     Set to `false` to ignore default values\" +\n    \" when generating non-nullable types\",\n  \"  --properties-required-by-default\",\n  \"                             Treat schema objects as if `required` is\" +\n    \" set to all properties by default\",\n  \"  --array-length             Generate tuples using array minItems / maxItems\",\n  \"  --binary-as-blob           Type raw binary strings (format: binary,\" +\n    \" contentMediaType) as Blob\",\n  \"  --fix [names]              Turn on output fixes, comma-separated, or\" +\n    ' \"all\" (see docs/cli.md#fix)',\n  \"  --path-params-as-types     Convert paths to template literal types\",\n  \"  --generate-path-params     Generate path parameters for all paths where they are\" +\n    \" undefined by schema\",\n  \"  --alphabetize              Sort object keys alphabetically\",\n  \"  --exclude-deprecated       Exclude deprecated types\",\n  \"  --root-types               Export schemas types at root level\",\n  \"  --root-types-no-schema-prefix\",\n  '                             Do not add \"Schema\" prefix to types at' +\n    \" the root level (should only be used with --root-types)\",\n  \"  --root-types-keep-casing   Keep casing of root types (should only be\" +\n    \" used with --root-types)\",\n  \"  --make-paths-enum          Generate ApiPaths enum for all paths\",\n  \"  --read-write-markers       Generate $Read/$Write markers for\" +\n    \" readOnly/writeOnly properties\",\n  \"  --no-lint                  Skip the Redocly lint (bundling errors still fail)\",\n  \"  --local-ref-root [dir]     Load local $ref files only from this directory\",\n  \"  --remote-ref-hosts [hosts] Load remote $ref documents only from these\" +\n    \" comma-separated hosts (empty: none)\",\n  \"\",\n].join(\"\\n\");\n"],"names":[],"mappings":"AACO,MAAM,SAAA,GAAY;AAAA,EACvB,OAAA;AAAA,EACA,wCAAA;AAAA,EACA,EAAA;AAAA,EACA,SAAA;AAAA,EACA,2CAAA;AAAA,EACA,kDAAA;AAAA,EACA,qFAAA;AAAA,EACA,qFAAA;AAAA,EACA,qEAAA;AAAA,EACA,2DAAA;AAAA,EACA,2GAAA;AAAA,EAEA,0EAAA;AAAA,EACA,8FAAA;AAAA,EAEA,6EAAA;AAAA,EACA,sDAAA;AAAA,EACA,6FAAA;AAAA,EACA,sGAAA;AAAA,EAEA,yGAAA;AAAA,EAEA,oCAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8EAAA;AAAA,EACA,iGAAA;AAAA,EAEA,oGAAA;AAAA,EAEA,sEAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8DAAA;AAAA,EACA,uDAAA;AAAA,EACA,iEAAA;AAAA,EACA,iCAAA;AAAA,EACA,4HAAA;AAAA,EAEA,gGAAA;AAAA,EAEA,mEAAA;AAAA,EACA,8FAAA;AAAA,EAEA,iFAAA;AAAA,EACA,6EAAA;AAAA,EACA,6GAAA;AAAA,EAEA;AACF,CAAA,CAAE,KAAK,IAAI;;"}
+{"version":3,"file":"help-text.mjs","sources":["../../src/cli/help-text.ts"],"sourcesContent":["/** The text of `--help`, as in the original CLI; long lines are split only in this source. */\nexport const HELP_TEXT = [\n  \"Usage\",\n  \"  $ openapi-typesafe [input] [options]\",\n  \"\",\n  \"Options\",\n  \"  --help                     Show this help\",\n  \"  --version                  Display the version\",\n  \"  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)\",\n  \"  --output, -o               Specify output file (if not specified in redocly.yaml)\",\n  \"  --enum                     Export true TS enums instead of unions\",\n  \"  --enum-values              Export enum values as arrays\",\n  \"  --conditional-enums        Only generate true TS enums when enum\" +\n    \" metadata is available (default: false)\",\n  \"  --dedupe-enums             Dedupe enum types when `--enum=true` is set\",\n  \"  --check                    Check that the generated types are\" +\n    \" up-to-date. (default: false)\",\n  \"  --export-type, -t          Export top-level `type` instead of `interface`\",\n  \"  --immutable                Generate readonly types\",\n  \"  --additional-properties    Treat schema objects as if `additionalProperties: true` is set\",\n  \"  --empty-objects-unknown    Generate `unknown` instead of\" +\n    \" `Record<string, never>` for empty objects\",\n  \"  --default-non-nullable     A property with a `default` is required\" +\n    \" (default: true; =false makes it optional)\",\n  \"  --properties-required-by-default\",\n  \"                             Treat schema objects as if `required` is\" +\n    \" set to all properties by default\",\n  \"  --array-length             Generate tuples using array minItems / maxItems\",\n  \"  --binary-as-blob           Type raw binary strings (format: binary,\" +\n    \" contentMediaType) as Blob\",\n  \"  --fix [names]              Turn on output fixes, comma-separated, or\" +\n    ' \"all\" (see docs/cli.md#fix)',\n  \"  --path-params-as-types     Convert paths to template literal types\",\n  \"  --generate-path-params     Generate path parameters for all paths where they are\" +\n    \" undefined by schema\",\n  \"  --alphabetize              Sort object keys alphabetically\",\n  \"  --exclude-deprecated       Exclude deprecated types\",\n  \"  --root-types               Export `components` types as root-level aliases\",\n  \"  --root-types-no-schema-prefix\",\n  '                             Do not add \"Schema\" prefix to types at' +\n    \" the root level (should only be used with --root-types)\",\n  \"  --root-types-keep-casing   Keep casing of root types (should only be\" +\n    \" used with --root-types)\",\n  \"  --make-paths-enum          Generate ApiPaths enum for all paths\",\n  \"  --read-write-markers       Generate $Read/$Write markers for\" +\n    \" readOnly/writeOnly properties\",\n  \"  --no-lint                  Skip the Redocly lint (bundling errors still fail)\",\n  \"  --local-ref-root [dir]     Load local $ref files only from this directory\",\n  \"  --remote-ref-hosts [hosts] Load remote $ref documents only from these\" +\n    \" comma-separated hosts (empty: none)\",\n  \"\",\n].join(\"\\n\");\n"],"names":[],"mappings":"AACO,MAAM,SAAA,GAAY;AAAA,EACvB,OAAA;AAAA,EACA,wCAAA;AAAA,EACA,EAAA;AAAA,EACA,SAAA;AAAA,EACA,6CAAA;AAAA,EACA,kDAAA;AAAA,EACA,qFAAA;AAAA,EACA,qFAAA;AAAA,EACA,qEAAA;AAAA,EACA,2DAAA;AAAA,EACA,2GAAA;AAAA,EAEA,0EAAA;AAAA,EACA,8FAAA;AAAA,EAEA,6EAAA;AAAA,EACA,sDAAA;AAAA,EACA,6FAAA;AAAA,EACA,sGAAA;AAAA,EAEA,gHAAA;AAAA,EAEA,oCAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8EAAA;AAAA,EACA,iGAAA;AAAA,EAEA,oGAAA;AAAA,EAEA,sEAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8DAAA;AAAA,EACA,uDAAA;AAAA,EACA,8EAAA;AAAA,EACA,iCAAA;AAAA,EACA,4HAAA;AAAA,EAEA,gGAAA;AAAA,EAEA,mEAAA;AAAA,EACA,8FAAA;AAAA,EAEA,iFAAA;AAAA,EACA,6EAAA;AAAA,EACA,6GAAA;AAAA,EAEA;AACF,CAAA,CAAE,KAAK,IAAI;;"}

package/dist/cli/redocly-apis.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 const scule = require('scule');
+const apiSettings = require('./api-settings.cjs');
 const cliArguments = require('./cli-arguments.cjs');
 const cliErrors = require('./cli-errors.cjs');
 const cliOutput = require('./cli-output.cjs');
@@ -9,7 +10,6 @@ const fixOption = require('./fix-option.cjs');
 const refLimits = require('./ref-limits.cjs');
 
 const REDOCLY_CONFIG_KEY = "x-openapi-ts";
-const FIX_SETTING = "fix";
 function redoclyApisOf(redocly) {
   return Object.entries(redocly.apis ?? {}).map(([name, api]) => {
     const settings = api[REDOCLY_CONFIG_KEY];
@@ -30,24 +30,28 @@ function apiFlags(settings) {
   return flags;
 }
 function apiFixNames(settings) {
-  return fixOption.fixNamesOf(settings[FIX_SETTING]);
+  return fixOption.fixNamesOf(settings[apiSettings.FIX_SETTING]);
 }
 function configRootOf(redocly, cwd) {
   return redocly.configFile ? cliOutput.resolveLocationUrl(redocly.configFile, cwd) : cwd;
 }
 async function generateApi(run, redocly, api) {
-  if (!api.settings?.output) {
+  if (!api.settings?.[apiSettings.OUTPUT_SETTING]) {
     throw cliErrors.cliError(
       "CLI_CONFIG_OUTPUT_MISSING",
       `API ${api.name} is missing an \`${REDOCLY_CONFIG_KEY}.output\` key. See ${docsLinks.MULTIPLE_SCHEMAS_DOCS_URL}`
     );
   }
-  const output = String(api.settings.output);
+  for (const warning of apiSettings.unknownSettingWarnings(api.name, api.settings)) {
+    run.deps.logger.warn(warning);
+  }
+  const output = String(api.settings[apiSettings.OUTPUT_SETTING]);
   const configRoot = configRootOf(redocly, run.deps.cwd);
   const options = {
     ...run.args.generatorFlags,
     ...apiFlags(api.settings),
     ...refLimits.refLimitOptions(run.args, run.deps.cwd),
+    ...apiSettings.apiRefLimitOptions(api.name, api.settings, configRoot),
     ...fixOption.fixOption(apiFixNames(api.settings) ?? run.args.fix),
     redocly
   };