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

package/dist/domain/append-all.mjs

@@ -0,0 +1,8 @@
+function appendAll(target, items) {
+  for (const item of items) {
+    target.push(item);
+  }
+}
+
+export { appendAll };
+//# sourceMappingURL=append-all.mjs.map

package/dist/domain/append-all.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-all.mjs","sources":["../../src/domain/append-all.ts"],"sourcesContent":["/**\n * Append every item of `items` to `target`. `target.push(...items)` passes each item as an\n * argument, and engines limit the arguments of a call (V8 throws a RangeError from about 125,000),\n * so a list as long as a document allows (an `enum`, an `anyOf`, `examples`) must not be spread.\n */\nexport function appendAll<T>(target: T[], items: Iterable<T>): void {\n  for (const item of items) {\n    target.push(item);\n  }\n}\n"],"names":[],"mappings":"AAKO,SAAS,SAAA,CAAa,QAAa,KAAA,EAA0B;AAClE,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,MAAA,CAAO,KAAK,IAAI,CAAA;AAAA,EAClB;AACF;;"}

package/dist/domain/cause-secrets.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+const urlSecrets = require('./url-secrets.cjs');
+
+const MAX_CAUSE_DEPTH = 8;
+function deeper(walk, value) {
+  return { path: /* @__PURE__ */ new Set([...walk.path, value]), depth: walk.depth + 1 };
+}
+function redactedArray(array, walk) {
+  const inner = deeper(walk, array);
+  const items = array.map((item) => redactedValue(item, inner));
+  return items.every((item, index) => item === array[index]) ? array : items;
+}
+function redactedObject(value, walk) {
+  const inner = deeper(walk, value);
+  const copy = value instanceof Error ? Object.setPrototypeOf(new Error(), Object.getPrototypeOf(value)) : Object.create(Object.getPrototypeOf(value));
+  let isChanged = false;
+  for (const key of Reflect.ownKeys(value)) {
+    const property = Reflect.get(value, key);
+    const shown = redactedValue(property, inner);
+    isChanged ||= shown !== property;
+    const enumerable = Object.getOwnPropertyDescriptor(value, key)?.enumerable === true;
+    Object.defineProperty(copy, key, {
+      value: shown,
+      enumerable,
+      writable: true,
+      configurable: true
+    });
+  }
+  return isChanged ? copy : value;
+}
+function isOpaque(value) {
+  return typeof value === "function" || ArrayBuffer.isView(value) || value instanceof ArrayBuffer;
+}
+function redactedValue(value, walk) {
+  if (typeof value === "string") {
+    return urlSecrets.redactUrlSecrets(value);
+  }
+  if (typeof value !== "object" || value === null || isOpaque(value)) {
+    return value;
+  }
+  if (walk.path.has(value) || walk.depth >= MAX_CAUSE_DEPTH) {
+    return void 0;
+  }
+  return Array.isArray(value) ? redactedArray(value, walk) : redactedObject(value, walk);
+}
+function redactCauseSecrets(cause) {
+  return redactedValue(cause, { path: /* @__PURE__ */ new Set(), depth: 0 });
+}
+
+exports.redactCauseSecrets = redactCauseSecrets;
+//# sourceMappingURL=cause-secrets.cjs.map

package/dist/domain/cause-secrets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cause-secrets.cjs","sources":["../../src/domain/cause-secrets.ts"],"sourcesContent":["import { redactUrlSecrets } from \"./url-secrets.js\";\n\n/**\n * The `cause` of a typed error is shown wherever the error is: `console.error(error)` and\n * `util.inspect` print the whole chain, and error trackers send it. A lower-level error names the\n * URL it failed on (fetch refuses `https://user:token@host/…` and quotes it), and may keep it in\n * nested objects too (Redocly's parse error holds `originalError.mark.name` and\n * `source.absoluteRef`), so the chain must hide the same secrets as the message (url-secrets.ts)\n * at every depth.\n */\n\n/**\n * How deep the walk copies a cause. The data of a cause is shallow (Redocly's deepest URL is three\n * levels below the error); a value below this depth is dropped, so no secret is kept unread.\n */\nconst MAX_CAUSE_DEPTH = 8;\n\ninterface Walk {\n  /** The objects on the way from the cause to the value, so a cycle is cut where it closes. */\n  readonly path: ReadonlySet<object>;\n  readonly depth: number;\n}\n\nfunction deeper(walk: Walk, value: object): Walk {\n  return { path: new Set([...walk.path, value]), depth: walk.depth + 1 };\n}\n\n/** An array with each item hidden, or the array itself when no item holds a secret. */\nfunction redactedArray(array: readonly unknown[], walk: Walk): readonly unknown[] {\n  const inner = deeper(walk, array);\n  const items = array.map((item) => redactedValue(item, inner));\n  return items.every((item, index) => item === array[index]) ? array : items;\n}\n\n/**\n * A copy of `value` with the same prototype, its own properties (`message`, `stack`, `code`,\n * `input`, a nested `cause` or object) with URL secrets hidden, or `value` itself when none of\n * them holds one. Each property is read through its getter (V8 keeps `stack` behind one) and\n * copied as a value.\n */\nfunction redactedObject(value: object, walk: Walk): object {\n  const inner = deeper(walk, value);\n  // An error is copied as a real error, so `util.inspect` and `util.types.isNativeError` treat\n  // the copy as one.\n  const copy: object =\n    value instanceof Error\n      ? Object.setPrototypeOf(new Error(), Object.getPrototypeOf(value))\n      : Object.create(Object.getPrototypeOf(value) as object | null);\n  let isChanged = false;\n  for (const key of Reflect.ownKeys(value)) {\n    const property: unknown = Reflect.get(value, key);\n    const shown = redactedValue(property, inner);\n    isChanged ||= shown !== property;\n    const enumerable = Object.getOwnPropertyDescriptor(value, key)?.enumerable === true;\n    Object.defineProperty(copy, key, {\n      value: shown,\n      enumerable,\n      writable: true,\n      configurable: true,\n    });\n  }\n  return isChanged ? copy : value;\n}\n\n/** Binary data and functions hold no text to hide, so they are kept as they are. */\nfunction isOpaque(value: object): boolean {\n  return typeof value === \"function\" || ArrayBuffer.isView(value) || value instanceof ArrayBuffer;\n}\n\nfunction redactedValue(value: unknown, walk: Walk): unknown {\n  if (typeof value === \"string\") {\n    return redactUrlSecrets(value);\n  }\n  if (typeof value !== \"object\" || value === null || isOpaque(value)) {\n    return value;\n  }\n  if (walk.path.has(value) || walk.depth >= MAX_CAUSE_DEPTH) {\n    return undefined;\n  }\n  return Array.isArray(value) ? redactedArray(value, walk) : redactedObject(value, walk);\n}\n\n/** The cause of a typed error with the URL secrets of its whole chain hidden. */\nexport function redactCauseSecrets(cause: unknown): unknown {\n  return redactedValue(cause, { path: new Set(), depth: 0 });\n}\n"],"names":["redactUrlSecrets"],"mappings":";;;;AAeA,MAAM,eAAA,GAAkB,CAAA;AAQxB,SAAS,MAAA,CAAO,MAAY,KAAA,EAAqB;AAC/C,EAAA,OAAO,EAAE,IAAA,kBAAM,IAAI,GAAA,CAAI,CAAC,GAAG,IAAA,CAAK,IAAA,EAAM,KAAK,CAAC,CAAA,EAAG,KAAA,EAAO,IAAA,CAAK,QAAQ,CAAA,EAAE;AACvE;AAGA,SAAS,aAAA,CAAc,OAA2B,IAAA,EAAgC;AAChF,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,EAAM,KAAK,CAAA;AAChC,EAAA,MAAM,KAAA,GAAQ,MAAM,GAAA,CAAI,CAAC,SAAS,aAAA,CAAc,IAAA,EAAM,KAAK,CAAC,CAAA;AAC5D,EAAA,OAAO,KAAA,CAAM,KAAA,CAAM,CAAC,IAAA,EAAM,KAAA,KAAU,SAAS,KAAA,CAAM,KAAK,CAAC,CAAA,GAAI,KAAA,GAAQ,KAAA;AACvE;AAQA,SAAS,cAAA,CAAe,OAAe,IAAA,EAAoB;AACzD,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,EAAM,KAAK,CAAA;AAGhC,EAAA,MAAM,OACJ,KAAA,YAAiB,KAAA,GACb,OAAO,cAAA,CAAe,IAAI,OAAM,EAAG,MAAA,CAAO,cAAA,CAAe,KAAK,CAAC,CAAA,GAC/D,MAAA,CAAO,OAAO,MAAA,CAAO,cAAA,CAAe,KAAK,CAAkB,CAAA;AACjE,EAAA,IAAI,SAAA,GAAY,KAAA;AAChB,EAAA,KAAA,MAAW,GAAA,IAAO,OAAA,CAAQ,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxC,IAAA,MAAM,QAAA,GAAoB,OAAA,CAAQ,GAAA,CAAI,KAAA,EAAO,GAAG,CAAA;AAChD,IAAA,MAAM,KAAA,GAAQ,aAAA,CAAc,QAAA,EAAU,KAAK,CAAA;AAC3C,IAAA,SAAA,KAAc,KAAA,KAAU,QAAA;AACxB,IAAA,MAAM,aAAa,MAAA,CAAO,wBAAA,CAAyB,KAAA,EAAO,GAAG,GAAG,UAAA,KAAe,IAAA;AAC/E,IAAA,MAAA,CAAO,cAAA,CAAe,MAAM,GAAA,EAAK;AAAA,MAC/B,KAAA,EAAO,KAAA;AAAA,MACP,UAAA;AAAA,MACA,QAAA,EAAU,IAAA;AAAA,MACV,YAAA,EAAc;AAAA,KACf,CAAA;AAAA,EACH;AACA,EAAA,OAAO,YAAY,IAAA,GAAO,KAAA;AAC5B;AAGA,SAAS,SAAS,KAAA,EAAwB;AACxC,EAAA,OAAO,OAAO,KAAA,KAAU,UAAA,IAAc,YAAY,MAAA,CAAO,KAAK,KAAK,KAAA,YAAiB,WAAA;AACtF;AAEA,SAAS,aAAA,CAAc,OAAgB,IAAA,EAAqB;AAC1D,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAOA,4BAAiB,KAAK,CAAA;AAAA,EAC/B;AACA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,UAAU,IAAA,IAAQ,QAAA,CAAS,KAAK,CAAA,EAAG;AAClE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,KAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,IAAK,IAAA,CAAK,SAAS,eAAA,EAAiB;AACzD,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,aAAA,CAAc,OAAO,IAAI,CAAA,GAAI,cAAA,CAAe,KAAA,EAAO,IAAI,CAAA;AACvF;AAGO,SAAS,mBAAmB,KAAA,EAAyB;AAC1D,EAAA,OAAO,aAAA,CAAc,OAAO,EAAE,IAAA,sBAAU,GAAA,EAAI,EAAG,KAAA,EAAO,CAAA,EAAG,CAAA;AAC3D;;"}

package/dist/domain/cause-secrets.mjs

@@ -0,0 +1,50 @@
+import { redactUrlSecrets } from './url-secrets.mjs';
+
+const MAX_CAUSE_DEPTH = 8;
+function deeper(walk, value) {
+  return { path: /* @__PURE__ */ new Set([...walk.path, value]), depth: walk.depth + 1 };
+}
+function redactedArray(array, walk) {
+  const inner = deeper(walk, array);
+  const items = array.map((item) => redactedValue(item, inner));
+  return items.every((item, index) => item === array[index]) ? array : items;
+}
+function redactedObject(value, walk) {
+  const inner = deeper(walk, value);
+  const copy = value instanceof Error ? Object.setPrototypeOf(new Error(), Object.getPrototypeOf(value)) : Object.create(Object.getPrototypeOf(value));
+  let isChanged = false;
+  for (const key of Reflect.ownKeys(value)) {
+    const property = Reflect.get(value, key);
+    const shown = redactedValue(property, inner);
+    isChanged ||= shown !== property;
+    const enumerable = Object.getOwnPropertyDescriptor(value, key)?.enumerable === true;
+    Object.defineProperty(copy, key, {
+      value: shown,
+      enumerable,
+      writable: true,
+      configurable: true
+    });
+  }
+  return isChanged ? copy : value;
+}
+function isOpaque(value) {
+  return typeof value === "function" || ArrayBuffer.isView(value) || value instanceof ArrayBuffer;
+}
+function redactedValue(value, walk) {
+  if (typeof value === "string") {
+    return redactUrlSecrets(value);
+  }
+  if (typeof value !== "object" || value === null || isOpaque(value)) {
+    return value;
+  }
+  if (walk.path.has(value) || walk.depth >= MAX_CAUSE_DEPTH) {
+    return void 0;
+  }
+  return Array.isArray(value) ? redactedArray(value, walk) : redactedObject(value, walk);
+}
+function redactCauseSecrets(cause) {
+  return redactedValue(cause, { path: /* @__PURE__ */ new Set(), depth: 0 });
+}
+
+export { redactCauseSecrets };
+//# sourceMappingURL=cause-secrets.mjs.map

package/dist/domain/cause-secrets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cause-secrets.mjs","sources":["../../src/domain/cause-secrets.ts"],"sourcesContent":["import { redactUrlSecrets } from \"./url-secrets.js\";\n\n/**\n * The `cause` of a typed error is shown wherever the error is: `console.error(error)` and\n * `util.inspect` print the whole chain, and error trackers send it. A lower-level error names the\n * URL it failed on (fetch refuses `https://user:token@host/…` and quotes it), and may keep it in\n * nested objects too (Redocly's parse error holds `originalError.mark.name` and\n * `source.absoluteRef`), so the chain must hide the same secrets as the message (url-secrets.ts)\n * at every depth.\n */\n\n/**\n * How deep the walk copies a cause. The data of a cause is shallow (Redocly's deepest URL is three\n * levels below the error); a value below this depth is dropped, so no secret is kept unread.\n */\nconst MAX_CAUSE_DEPTH = 8;\n\ninterface Walk {\n  /** The objects on the way from the cause to the value, so a cycle is cut where it closes. */\n  readonly path: ReadonlySet<object>;\n  readonly depth: number;\n}\n\nfunction deeper(walk: Walk, value: object): Walk {\n  return { path: new Set([...walk.path, value]), depth: walk.depth + 1 };\n}\n\n/** An array with each item hidden, or the array itself when no item holds a secret. */\nfunction redactedArray(array: readonly unknown[], walk: Walk): readonly unknown[] {\n  const inner = deeper(walk, array);\n  const items = array.map((item) => redactedValue(item, inner));\n  return items.every((item, index) => item === array[index]) ? array : items;\n}\n\n/**\n * A copy of `value` with the same prototype, its own properties (`message`, `stack`, `code`,\n * `input`, a nested `cause` or object) with URL secrets hidden, or `value` itself when none of\n * them holds one. Each property is read through its getter (V8 keeps `stack` behind one) and\n * copied as a value.\n */\nfunction redactedObject(value: object, walk: Walk): object {\n  const inner = deeper(walk, value);\n  // An error is copied as a real error, so `util.inspect` and `util.types.isNativeError` treat\n  // the copy as one.\n  const copy: object =\n    value instanceof Error\n      ? Object.setPrototypeOf(new Error(), Object.getPrototypeOf(value))\n      : Object.create(Object.getPrototypeOf(value) as object | null);\n  let isChanged = false;\n  for (const key of Reflect.ownKeys(value)) {\n    const property: unknown = Reflect.get(value, key);\n    const shown = redactedValue(property, inner);\n    isChanged ||= shown !== property;\n    const enumerable = Object.getOwnPropertyDescriptor(value, key)?.enumerable === true;\n    Object.defineProperty(copy, key, {\n      value: shown,\n      enumerable,\n      writable: true,\n      configurable: true,\n    });\n  }\n  return isChanged ? copy : value;\n}\n\n/** Binary data and functions hold no text to hide, so they are kept as they are. */\nfunction isOpaque(value: object): boolean {\n  return typeof value === \"function\" || ArrayBuffer.isView(value) || value instanceof ArrayBuffer;\n}\n\nfunction redactedValue(value: unknown, walk: Walk): unknown {\n  if (typeof value === \"string\") {\n    return redactUrlSecrets(value);\n  }\n  if (typeof value !== \"object\" || value === null || isOpaque(value)) {\n    return value;\n  }\n  if (walk.path.has(value) || walk.depth >= MAX_CAUSE_DEPTH) {\n    return undefined;\n  }\n  return Array.isArray(value) ? redactedArray(value, walk) : redactedObject(value, walk);\n}\n\n/** The cause of a typed error with the URL secrets of its whole chain hidden. */\nexport function redactCauseSecrets(cause: unknown): unknown {\n  return redactedValue(cause, { path: new Set(), depth: 0 });\n}\n"],"names":[],"mappings":";;AAeA,MAAM,eAAA,GAAkB,CAAA;AAQxB,SAAS,MAAA,CAAO,MAAY,KAAA,EAAqB;AAC/C,EAAA,OAAO,EAAE,IAAA,kBAAM,IAAI,GAAA,CAAI,CAAC,GAAG,IAAA,CAAK,IAAA,EAAM,KAAK,CAAC,CAAA,EAAG,KAAA,EAAO,IAAA,CAAK,QAAQ,CAAA,EAAE;AACvE;AAGA,SAAS,aAAA,CAAc,OAA2B,IAAA,EAAgC;AAChF,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,EAAM,KAAK,CAAA;AAChC,EAAA,MAAM,KAAA,GAAQ,MAAM,GAAA,CAAI,CAAC,SAAS,aAAA,CAAc,IAAA,EAAM,KAAK,CAAC,CAAA;AAC5D,EAAA,OAAO,KAAA,CAAM,KAAA,CAAM,CAAC,IAAA,EAAM,KAAA,KAAU,SAAS,KAAA,CAAM,KAAK,CAAC,CAAA,GAAI,KAAA,GAAQ,KAAA;AACvE;AAQA,SAAS,cAAA,CAAe,OAAe,IAAA,EAAoB;AACzD,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,EAAM,KAAK,CAAA;AAGhC,EAAA,MAAM,OACJ,KAAA,YAAiB,KAAA,GACb,OAAO,cAAA,CAAe,IAAI,OAAM,EAAG,MAAA,CAAO,cAAA,CAAe,KAAK,CAAC,CAAA,GAC/D,MAAA,CAAO,OAAO,MAAA,CAAO,cAAA,CAAe,KAAK,CAAkB,CAAA;AACjE,EAAA,IAAI,SAAA,GAAY,KAAA;AAChB,EAAA,KAAA,MAAW,GAAA,IAAO,OAAA,CAAQ,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxC,IAAA,MAAM,QAAA,GAAoB,OAAA,CAAQ,GAAA,CAAI,KAAA,EAAO,GAAG,CAAA;AAChD,IAAA,MAAM,KAAA,GAAQ,aAAA,CAAc,QAAA,EAAU,KAAK,CAAA;AAC3C,IAAA,SAAA,KAAc,KAAA,KAAU,QAAA;AACxB,IAAA,MAAM,aAAa,MAAA,CAAO,wBAAA,CAAyB,KAAA,EAAO,GAAG,GAAG,UAAA,KAAe,IAAA;AAC/E,IAAA,MAAA,CAAO,cAAA,CAAe,MAAM,GAAA,EAAK;AAAA,MAC/B,KAAA,EAAO,KAAA;AAAA,MACP,UAAA;AAAA,MACA,QAAA,EAAU,IAAA;AAAA,MACV,YAAA,EAAc;AAAA,KACf,CAAA;AAAA,EACH;AACA,EAAA,OAAO,YAAY,IAAA,GAAO,KAAA;AAC5B;AAGA,SAAS,SAAS,KAAA,EAAwB;AACxC,EAAA,OAAO,OAAO,KAAA,KAAU,UAAA,IAAc,YAAY,MAAA,CAAO,KAAK,KAAK,KAAA,YAAiB,WAAA;AACtF;AAEA,SAAS,aAAA,CAAc,OAAgB,IAAA,EAAqB;AAC1D,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,iBAAiB,KAAK,CAAA;AAAA,EAC/B;AACA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,UAAU,IAAA,IAAQ,QAAA,CAAS,KAAK,CAAA,EAAG;AAClE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,KAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,IAAK,IAAA,CAAK,SAAS,eAAA,EAAiB;AACzD,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,aAAA,CAAc,OAAO,IAAI,CAAA,GAAI,cAAA,CAAe,KAAA,EAAO,IAAI,CAAA;AACvF;AAGO,SAAS,mBAAmB,KAAA,EAAyB;AAC1D,EAAA,OAAO,aAAA,CAAc,OAAO,EAAE,IAAA,sBAAU,GAAA,EAAI,EAAG,KAAA,EAAO,CAAA,EAAG,CAAA;AAC3D;;"}

package/dist/domain/errors.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-const urlCredentials = require('./url-credentials.cjs');
+const causeSecrets = require('./cause-secrets.cjs');
+const urlSecrets = require('./url-secrets.cjs');
 
 const ERROR_CODES = {
   SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY",
@@ -18,14 +19,20 @@ const ERROR_CODES = {
   ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY",
   CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE",
   OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN",
+  OPTION_INVALID: "OPTION_INVALID",
   TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND",
   CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED",
+  CLI_FLAG_INVALID: "CLI_FLAG_INVALID",
   CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED",
   CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND",
   CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID",
   CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING",
   CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING",
   CLI_INPUT_MISSING: "CLI_INPUT_MISSING",
+  CLI_OUTPUT_IS_INPUT: "CLI_OUTPUT_IS_INPUT",
+  CLI_OUTPUT_DUPLICATE: "CLI_OUTPUT_DUPLICATE",
+  CLI_OUTPUT_INVALID: "CLI_OUTPUT_INVALID",
+  CLI_LOCATION_INVALID: "CLI_LOCATION_INVALID",
   OUTPUT_STALE: "OUTPUT_STALE",
   OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED",
   OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED"
@@ -34,8 +41,9 @@ class OpenAPITypesafeError extends Error {
   code;
   details;
   constructor(init) {
-    const message = urlCredentials.redactUrlCredentials(init.message);
-    super(message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    const message = urlSecrets.redactUrlSecrets(init.message);
+    const cause = causeSecrets.redactCauseSecrets(init.cause);
+    super(message, cause === void 0 ? void 0 : { cause });
     this.name = "OpenAPITypesafeError";
     this.code = init.code;
     this.details = init.details ?? {};

package/dist/domain/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["import { redactUrlCredentials } from \"./url-credentials.js\";\n\n/**\n * Typed errors (ENGINEERING_PLAN 4.6, ADR-011). Every expected failure of the generator and the CLI\n * is an `OpenAPITypesafeError` with a stable machine-readable `code` and structured `details`. The\n * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken\n * invariant) is a plain `Error`, not one of these.\n */\n\n/**\n * Every error code. A minor release may add codes (ADR-034); each one needs a row in the CLI's\n * exit-code table, which the compiler checks.\n */\nexport const ERROR_CODES = {\n  SCHEMA_SOURCE_EMPTY: \"SCHEMA_SOURCE_EMPTY\",\n  SCHEMA_SOURCE_INVALID: \"SCHEMA_SOURCE_INVALID\",\n  SCHEMA_LOAD_FAILED: \"SCHEMA_LOAD_FAILED\",\n  SCHEMA_PARSE_FAILED: \"SCHEMA_PARSE_FAILED\",\n  SCHEMA_VERSION_UNSUPPORTED: \"SCHEMA_VERSION_UNSUPPORTED\",\n  SCHEMA_INVALID: \"SCHEMA_INVALID\",\n  SCHEMA_REF_INVALID: \"SCHEMA_REF_INVALID\",\n  SCHEMA_REF_FORBIDDEN: \"SCHEMA_REF_FORBIDDEN\",\n  SCHEMA_OBJECT_INVALID: \"SCHEMA_OBJECT_INVALID\",\n  SCHEMA_PROPERTY_INVALID: \"SCHEMA_PROPERTY_INVALID\",\n  SCHEMA_TOO_DEEP: \"SCHEMA_TOO_DEEP\",\n  SCHEMA_KEY_UNSUPPORTED: \"SCHEMA_KEY_UNSUPPORTED\",\n  ENUM_NAME_EMPTY: \"ENUM_NAME_EMPTY\",\n  CALLBACK_RESULT_UNREADABLE: \"CALLBACK_RESULT_UNREADABLE\",\n  OPTION_FIX_UNKNOWN: \"OPTION_FIX_UNKNOWN\",\n  TYPESCRIPT_NOT_FOUND: \"TYPESCRIPT_NOT_FOUND\",\n  CLI_FLAG_REMOVED: \"CLI_FLAG_REMOVED\",\n  CLI_GLOB_UNSUPPORTED: \"CLI_GLOB_UNSUPPORTED\",\n  CLI_CONFIG_NOT_FOUND: \"CLI_CONFIG_NOT_FOUND\",\n  CLI_CONFIG_INVALID: \"CLI_CONFIG_INVALID\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  CLI_INPUT_MISSING: \"CLI_INPUT_MISSING\",\n  OUTPUT_STALE: \"OUTPUT_STALE\",\n  OUTPUT_READ_FAILED: \"OUTPUT_READ_FAILED\",\n  OUTPUT_WRITE_FAILED: \"OUTPUT_WRITE_FAILED\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n/**\n * Structured, JSON-serializable facts about a failure, for programs and logs. Only the keys that\n * docs/node.md (Errors) lists are stable (ADR-034, amendment of 2026-11-08).\n */\nexport type ErrorDetails = Readonly<Record<string, unknown>>;\n\nexport interface OpenAPITypesafeErrorInit {\n  readonly code: ErrorCode;\n  readonly message: string;\n  readonly details?: ErrorDetails;\n  /** The lower-level error this one reports, if any (kept as the standard `cause`). */\n  readonly cause?: unknown;\n}\n\n/**\n * The base of every expected failure; check `code`, not the class or the message. The message\n * never shows the user info of a URL (`url-credentials.ts`).\n */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    const message = redactUrlCredentials(init.message);\n    super(message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.name = \"OpenAPITypesafeError\";\n    this.code = init.code;\n    this.details = init.details ?? {};\n  }\n}\n\n/** Whether a thrown value is one of our typed errors (also across bundled copies of the class). */\nexport function isOpenAPITypesafeError(value: unknown): value is OpenAPITypesafeError {\n  if (value instanceof OpenAPITypesafeError) {\n    return true;\n  }\n  const code = (value as { code?: unknown } | null)?.code;\n  return (\n    value instanceof Error &&\n    typeof code === \"string\" &&\n    Object.hasOwn(ERROR_CODES, code) &&\n    typeof (value as { details?: unknown }).details === \"object\"\n  );\n}\n"],"names":["redactUrlCredentials"],"mappings":";;;;AAaO,MAAM,WAAA,GAAc;AAAA,EACzB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,cAAA,EAAgB,gBAAA;AAAA,EAChB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,uBAAA,EAAyB,yBAAA;AAAA,EACzB,eAAA,EAAiB,iBAAA;AAAA,EACjB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,eAAA,EAAiB,iBAAA;AAAA,EACjB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAsBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,MAAM,OAAA,GAAUA,mCAAA,CAAqB,IAAA,CAAK,OAAO,CAAA;AACjD,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA;AAC3E,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,IAAW,EAAC;AAAA,EAClC;AACF;AAGO,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,IAAI,iBAAiB,oBAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAQ,KAAA,EAAqC,IAAA;AACnD,EAAA,OACE,KAAA,YAAiB,KAAA,IACjB,OAAO,IAAA,KAAS,QAAA,IAChB,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA,IAC/B,OAAQ,KAAA,CAAgC,OAAA,KAAY,QAAA;AAExD;;;;"}
+{"version":3,"file":"errors.cjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["import { redactCauseSecrets } from \"./cause-secrets.js\";\nimport { redactUrlSecrets } from \"./url-secrets.js\";\n\n/**\n * Typed errors (ENGINEERING_PLAN 4.6, ADR-011). Every expected failure of the generator and the CLI\n * is an `OpenAPITypesafeError` with a stable machine-readable `code` and structured `details`. The\n * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken\n * invariant) is a plain `Error`, not one of these.\n */\n\n/**\n * Every error code. A minor release may add codes (ADR-034); each one needs a row in the CLI's\n * exit-code table, which the compiler checks.\n */\nexport const ERROR_CODES = {\n  SCHEMA_SOURCE_EMPTY: \"SCHEMA_SOURCE_EMPTY\",\n  SCHEMA_SOURCE_INVALID: \"SCHEMA_SOURCE_INVALID\",\n  SCHEMA_LOAD_FAILED: \"SCHEMA_LOAD_FAILED\",\n  SCHEMA_PARSE_FAILED: \"SCHEMA_PARSE_FAILED\",\n  SCHEMA_VERSION_UNSUPPORTED: \"SCHEMA_VERSION_UNSUPPORTED\",\n  SCHEMA_INVALID: \"SCHEMA_INVALID\",\n  SCHEMA_REF_INVALID: \"SCHEMA_REF_INVALID\",\n  SCHEMA_REF_FORBIDDEN: \"SCHEMA_REF_FORBIDDEN\",\n  SCHEMA_OBJECT_INVALID: \"SCHEMA_OBJECT_INVALID\",\n  SCHEMA_PROPERTY_INVALID: \"SCHEMA_PROPERTY_INVALID\",\n  SCHEMA_TOO_DEEP: \"SCHEMA_TOO_DEEP\",\n  SCHEMA_KEY_UNSUPPORTED: \"SCHEMA_KEY_UNSUPPORTED\",\n  ENUM_NAME_EMPTY: \"ENUM_NAME_EMPTY\",\n  CALLBACK_RESULT_UNREADABLE: \"CALLBACK_RESULT_UNREADABLE\",\n  OPTION_FIX_UNKNOWN: \"OPTION_FIX_UNKNOWN\",\n  OPTION_INVALID: \"OPTION_INVALID\",\n  TYPESCRIPT_NOT_FOUND: \"TYPESCRIPT_NOT_FOUND\",\n  CLI_FLAG_REMOVED: \"CLI_FLAG_REMOVED\",\n  CLI_FLAG_INVALID: \"CLI_FLAG_INVALID\",\n  CLI_GLOB_UNSUPPORTED: \"CLI_GLOB_UNSUPPORTED\",\n  CLI_CONFIG_NOT_FOUND: \"CLI_CONFIG_NOT_FOUND\",\n  CLI_CONFIG_INVALID: \"CLI_CONFIG_INVALID\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  CLI_INPUT_MISSING: \"CLI_INPUT_MISSING\",\n  CLI_OUTPUT_IS_INPUT: \"CLI_OUTPUT_IS_INPUT\",\n  CLI_OUTPUT_DUPLICATE: \"CLI_OUTPUT_DUPLICATE\",\n  CLI_OUTPUT_INVALID: \"CLI_OUTPUT_INVALID\",\n  CLI_LOCATION_INVALID: \"CLI_LOCATION_INVALID\",\n  OUTPUT_STALE: \"OUTPUT_STALE\",\n  OUTPUT_READ_FAILED: \"OUTPUT_READ_FAILED\",\n  OUTPUT_WRITE_FAILED: \"OUTPUT_WRITE_FAILED\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n/**\n * Structured, JSON-serializable facts about a failure, for programs and logs. Only the keys that\n * docs/node.md (Errors) lists are stable (ADR-034, amendment of 2026-11-08).\n */\nexport type ErrorDetails = Readonly<Record<string, unknown>>;\n\nexport interface OpenAPITypesafeErrorInit {\n  readonly code: ErrorCode;\n  readonly message: string;\n  readonly details?: ErrorDetails;\n  /**\n   * The lower-level error this one reports, if any (kept as the standard `cause`; a copy with URL\n   * secrets hidden when its chain names one, see cause-secrets.ts).\n   */\n  readonly cause?: unknown;\n}\n\n/**\n * The base of every expected failure; check `code`, not the class or the message. The message\n * and the `cause` chain never show the user info or the query of a URL (`url-secrets.ts`).\n */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    const message = redactUrlSecrets(init.message);\n    const cause = redactCauseSecrets(init.cause);\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"OpenAPITypesafeError\";\n    this.code = init.code;\n    this.details = init.details ?? {};\n  }\n}\n\n/** Whether a thrown value is one of our typed errors (also across bundled copies of the class). */\nexport function isOpenAPITypesafeError(value: unknown): value is OpenAPITypesafeError {\n  if (value instanceof OpenAPITypesafeError) {\n    return true;\n  }\n  const code = (value as { code?: unknown } | null)?.code;\n  return (\n    value instanceof Error &&\n    typeof code === \"string\" &&\n    Object.hasOwn(ERROR_CODES, code) &&\n    typeof (value as { details?: unknown }).details === \"object\"\n  );\n}\n"],"names":["redactUrlSecrets","redactCauseSecrets"],"mappings":";;;;;AAcO,MAAM,WAAA,GAAc;AAAA,EACzB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,cAAA,EAAgB,gBAAA;AAAA,EAChB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,uBAAA,EAAyB,yBAAA;AAAA,EACzB,eAAA,EAAiB,iBAAA;AAAA,EACjB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,eAAA,EAAiB,iBAAA;AAAA,EACjB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,kBAAA,EAAoB,oBAAA;AAAA,EACpB,cAAA,EAAgB,gBAAA;AAAA,EAChB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAyBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,MAAM,OAAA,GAAUA,2BAAA,CAAiB,IAAA,CAAK,OAAO,CAAA;AAC7C,IAAA,MAAM,KAAA,GAAQC,+BAAA,CAAmB,IAAA,CAAK,KAAK,CAAA;AAC3C,IAAA,KAAA,CAAM,SAAS,KAAA,KAAU,MAAA,GAAY,MAAA,GAAY,EAAE,OAAO,CAAA;AAC1D,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,IAAW,EAAC;AAAA,EAClC;AACF;AAGO,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,IAAI,iBAAiB,oBAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAQ,KAAA,EAAqC,IAAA;AACnD,EAAA,OACE,KAAA,YAAiB,KAAA,IACjB,OAAO,IAAA,KAAS,QAAA,IAChB,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA,IAC/B,OAAQ,KAAA,CAAgC,OAAA,KAAY,QAAA;AAExD;;;;"}

package/dist/domain/errors.mjs

@@ -1,4 +1,5 @@
-import { redactUrlCredentials } from './url-credentials.mjs';
+import { redactCauseSecrets } from './cause-secrets.mjs';
+import { redactUrlSecrets } from './url-secrets.mjs';
 
 const ERROR_CODES = {
   SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY",
@@ -16,14 +17,20 @@ const ERROR_CODES = {
   ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY",
   CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE",
   OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN",
+  OPTION_INVALID: "OPTION_INVALID",
   TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND",
   CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED",
+  CLI_FLAG_INVALID: "CLI_FLAG_INVALID",
   CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED",
   CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND",
   CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID",
   CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING",
   CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING",
   CLI_INPUT_MISSING: "CLI_INPUT_MISSING",
+  CLI_OUTPUT_IS_INPUT: "CLI_OUTPUT_IS_INPUT",
+  CLI_OUTPUT_DUPLICATE: "CLI_OUTPUT_DUPLICATE",
+  CLI_OUTPUT_INVALID: "CLI_OUTPUT_INVALID",
+  CLI_LOCATION_INVALID: "CLI_LOCATION_INVALID",
   OUTPUT_STALE: "OUTPUT_STALE",
   OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED",
   OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED"
@@ -32,8 +39,9 @@ class OpenAPITypesafeError extends Error {
   code;
   details;
   constructor(init) {
-    const message = redactUrlCredentials(init.message);
-    super(message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    const message = redactUrlSecrets(init.message);
+    const cause = redactCauseSecrets(init.cause);
+    super(message, cause === void 0 ? void 0 : { cause });
     this.name = "OpenAPITypesafeError";
     this.code = init.code;
     this.details = init.details ?? {};

package/dist/domain/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["import { redactUrlCredentials } from \"./url-credentials.js\";\n\n/**\n * Typed errors (ENGINEERING_PLAN 4.6, ADR-011). Every expected failure of the generator and the CLI\n * is an `OpenAPITypesafeError` with a stable machine-readable `code` and structured `details`. The\n * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken\n * invariant) is a plain `Error`, not one of these.\n */\n\n/**\n * Every error code. A minor release may add codes (ADR-034); each one needs a row in the CLI's\n * exit-code table, which the compiler checks.\n */\nexport const ERROR_CODES = {\n  SCHEMA_SOURCE_EMPTY: \"SCHEMA_SOURCE_EMPTY\",\n  SCHEMA_SOURCE_INVALID: \"SCHEMA_SOURCE_INVALID\",\n  SCHEMA_LOAD_FAILED: \"SCHEMA_LOAD_FAILED\",\n  SCHEMA_PARSE_FAILED: \"SCHEMA_PARSE_FAILED\",\n  SCHEMA_VERSION_UNSUPPORTED: \"SCHEMA_VERSION_UNSUPPORTED\",\n  SCHEMA_INVALID: \"SCHEMA_INVALID\",\n  SCHEMA_REF_INVALID: \"SCHEMA_REF_INVALID\",\n  SCHEMA_REF_FORBIDDEN: \"SCHEMA_REF_FORBIDDEN\",\n  SCHEMA_OBJECT_INVALID: \"SCHEMA_OBJECT_INVALID\",\n  SCHEMA_PROPERTY_INVALID: \"SCHEMA_PROPERTY_INVALID\",\n  SCHEMA_TOO_DEEP: \"SCHEMA_TOO_DEEP\",\n  SCHEMA_KEY_UNSUPPORTED: \"SCHEMA_KEY_UNSUPPORTED\",\n  ENUM_NAME_EMPTY: \"ENUM_NAME_EMPTY\",\n  CALLBACK_RESULT_UNREADABLE: \"CALLBACK_RESULT_UNREADABLE\",\n  OPTION_FIX_UNKNOWN: \"OPTION_FIX_UNKNOWN\",\n  TYPESCRIPT_NOT_FOUND: \"TYPESCRIPT_NOT_FOUND\",\n  CLI_FLAG_REMOVED: \"CLI_FLAG_REMOVED\",\n  CLI_GLOB_UNSUPPORTED: \"CLI_GLOB_UNSUPPORTED\",\n  CLI_CONFIG_NOT_FOUND: \"CLI_CONFIG_NOT_FOUND\",\n  CLI_CONFIG_INVALID: \"CLI_CONFIG_INVALID\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  CLI_INPUT_MISSING: \"CLI_INPUT_MISSING\",\n  OUTPUT_STALE: \"OUTPUT_STALE\",\n  OUTPUT_READ_FAILED: \"OUTPUT_READ_FAILED\",\n  OUTPUT_WRITE_FAILED: \"OUTPUT_WRITE_FAILED\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n/**\n * Structured, JSON-serializable facts about a failure, for programs and logs. Only the keys that\n * docs/node.md (Errors) lists are stable (ADR-034, amendment of 2026-11-08).\n */\nexport type ErrorDetails = Readonly<Record<string, unknown>>;\n\nexport interface OpenAPITypesafeErrorInit {\n  readonly code: ErrorCode;\n  readonly message: string;\n  readonly details?: ErrorDetails;\n  /** The lower-level error this one reports, if any (kept as the standard `cause`). */\n  readonly cause?: unknown;\n}\n\n/**\n * The base of every expected failure; check `code`, not the class or the message. The message\n * never shows the user info of a URL (`url-credentials.ts`).\n */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    const message = redactUrlCredentials(init.message);\n    super(message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.name = \"OpenAPITypesafeError\";\n    this.code = init.code;\n    this.details = init.details ?? {};\n  }\n}\n\n/** Whether a thrown value is one of our typed errors (also across bundled copies of the class). */\nexport function isOpenAPITypesafeError(value: unknown): value is OpenAPITypesafeError {\n  if (value instanceof OpenAPITypesafeError) {\n    return true;\n  }\n  const code = (value as { code?: unknown } | null)?.code;\n  return (\n    value instanceof Error &&\n    typeof code === \"string\" &&\n    Object.hasOwn(ERROR_CODES, code) &&\n    typeof (value as { details?: unknown }).details === \"object\"\n  );\n}\n"],"names":[],"mappings":";;AAaO,MAAM,WAAA,GAAc;AAAA,EACzB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,cAAA,EAAgB,gBAAA;AAAA,EAChB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,uBAAA,EAAyB,yBAAA;AAAA,EACzB,eAAA,EAAiB,iBAAA;AAAA,EACjB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,eAAA,EAAiB,iBAAA;AAAA,EACjB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAsBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,MAAM,OAAA,GAAU,oBAAA,CAAqB,IAAA,CAAK,OAAO,CAAA;AACjD,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA;AAC3E,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,IAAW,EAAC;AAAA,EAClC;AACF;AAGO,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,IAAI,iBAAiB,oBAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAQ,KAAA,EAAqC,IAAA;AACnD,EAAA,OACE,KAAA,YAAiB,KAAA,IACjB,OAAO,IAAA,KAAS,QAAA,IAChB,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA,IAC/B,OAAQ,KAAA,CAAgC,OAAA,KAAY,QAAA;AAExD;;"}
+{"version":3,"file":"errors.mjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["import { redactCauseSecrets } from \"./cause-secrets.js\";\nimport { redactUrlSecrets } from \"./url-secrets.js\";\n\n/**\n * Typed errors (ENGINEERING_PLAN 4.6, ADR-011). Every expected failure of the generator and the CLI\n * is an `OpenAPITypesafeError` with a stable machine-readable `code` and structured `details`. The\n * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken\n * invariant) is a plain `Error`, not one of these.\n */\n\n/**\n * Every error code. A minor release may add codes (ADR-034); each one needs a row in the CLI's\n * exit-code table, which the compiler checks.\n */\nexport const ERROR_CODES = {\n  SCHEMA_SOURCE_EMPTY: \"SCHEMA_SOURCE_EMPTY\",\n  SCHEMA_SOURCE_INVALID: \"SCHEMA_SOURCE_INVALID\",\n  SCHEMA_LOAD_FAILED: \"SCHEMA_LOAD_FAILED\",\n  SCHEMA_PARSE_FAILED: \"SCHEMA_PARSE_FAILED\",\n  SCHEMA_VERSION_UNSUPPORTED: \"SCHEMA_VERSION_UNSUPPORTED\",\n  SCHEMA_INVALID: \"SCHEMA_INVALID\",\n  SCHEMA_REF_INVALID: \"SCHEMA_REF_INVALID\",\n  SCHEMA_REF_FORBIDDEN: \"SCHEMA_REF_FORBIDDEN\",\n  SCHEMA_OBJECT_INVALID: \"SCHEMA_OBJECT_INVALID\",\n  SCHEMA_PROPERTY_INVALID: \"SCHEMA_PROPERTY_INVALID\",\n  SCHEMA_TOO_DEEP: \"SCHEMA_TOO_DEEP\",\n  SCHEMA_KEY_UNSUPPORTED: \"SCHEMA_KEY_UNSUPPORTED\",\n  ENUM_NAME_EMPTY: \"ENUM_NAME_EMPTY\",\n  CALLBACK_RESULT_UNREADABLE: \"CALLBACK_RESULT_UNREADABLE\",\n  OPTION_FIX_UNKNOWN: \"OPTION_FIX_UNKNOWN\",\n  OPTION_INVALID: \"OPTION_INVALID\",\n  TYPESCRIPT_NOT_FOUND: \"TYPESCRIPT_NOT_FOUND\",\n  CLI_FLAG_REMOVED: \"CLI_FLAG_REMOVED\",\n  CLI_FLAG_INVALID: \"CLI_FLAG_INVALID\",\n  CLI_GLOB_UNSUPPORTED: \"CLI_GLOB_UNSUPPORTED\",\n  CLI_CONFIG_NOT_FOUND: \"CLI_CONFIG_NOT_FOUND\",\n  CLI_CONFIG_INVALID: \"CLI_CONFIG_INVALID\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  CLI_INPUT_MISSING: \"CLI_INPUT_MISSING\",\n  CLI_OUTPUT_IS_INPUT: \"CLI_OUTPUT_IS_INPUT\",\n  CLI_OUTPUT_DUPLICATE: \"CLI_OUTPUT_DUPLICATE\",\n  CLI_OUTPUT_INVALID: \"CLI_OUTPUT_INVALID\",\n  CLI_LOCATION_INVALID: \"CLI_LOCATION_INVALID\",\n  OUTPUT_STALE: \"OUTPUT_STALE\",\n  OUTPUT_READ_FAILED: \"OUTPUT_READ_FAILED\",\n  OUTPUT_WRITE_FAILED: \"OUTPUT_WRITE_FAILED\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n/**\n * Structured, JSON-serializable facts about a failure, for programs and logs. Only the keys that\n * docs/node.md (Errors) lists are stable (ADR-034, amendment of 2026-11-08).\n */\nexport type ErrorDetails = Readonly<Record<string, unknown>>;\n\nexport interface OpenAPITypesafeErrorInit {\n  readonly code: ErrorCode;\n  readonly message: string;\n  readonly details?: ErrorDetails;\n  /**\n   * The lower-level error this one reports, if any (kept as the standard `cause`; a copy with URL\n   * secrets hidden when its chain names one, see cause-secrets.ts).\n   */\n  readonly cause?: unknown;\n}\n\n/**\n * The base of every expected failure; check `code`, not the class or the message. The message\n * and the `cause` chain never show the user info or the query of a URL (`url-secrets.ts`).\n */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    const message = redactUrlSecrets(init.message);\n    const cause = redactCauseSecrets(init.cause);\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"OpenAPITypesafeError\";\n    this.code = init.code;\n    this.details = init.details ?? {};\n  }\n}\n\n/** Whether a thrown value is one of our typed errors (also across bundled copies of the class). */\nexport function isOpenAPITypesafeError(value: unknown): value is OpenAPITypesafeError {\n  if (value instanceof OpenAPITypesafeError) {\n    return true;\n  }\n  const code = (value as { code?: unknown } | null)?.code;\n  return (\n    value instanceof Error &&\n    typeof code === \"string\" &&\n    Object.hasOwn(ERROR_CODES, code) &&\n    typeof (value as { details?: unknown }).details === \"object\"\n  );\n}\n"],"names":[],"mappings":";;;AAcO,MAAM,WAAA,GAAc;AAAA,EACzB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,cAAA,EAAgB,gBAAA;AAAA,EAChB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,uBAAA,EAAyB,yBAAA;AAAA,EACzB,eAAA,EAAiB,iBAAA;AAAA,EACjB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,eAAA,EAAiB,iBAAA;AAAA,EACjB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,kBAAA,EAAoB,oBAAA;AAAA,EACpB,cAAA,EAAgB,gBAAA;AAAA,EAChB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAyBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,MAAM,OAAA,GAAU,gBAAA,CAAiB,IAAA,CAAK,OAAO,CAAA;AAC7C,IAAA,MAAM,KAAA,GAAQ,kBAAA,CAAmB,IAAA,CAAK,KAAK,CAAA;AAC3C,IAAA,KAAA,CAAM,SAAS,KAAA,KAAU,MAAA,GAAY,MAAA,GAAY,EAAE,OAAO,CAAA;AAC1D,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,IAAW,EAAC;AAAA,EAClC;AACF;AAGO,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,IAAI,iBAAiB,oBAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAQ,KAAA,EAAqC,IAAA;AACnD,EAAA,OACE,KAAA,YAAiB,KAAA,IACjB,OAAO,IAAA,KAAS,QAAA,IAChB,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA,IAC/B,OAAQ,KAAA,CAAgC,OAAA,KAAY,QAAA;AAExD;;"}

package/dist/domain/ir/identifier-text.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"identifier-text.cjs","sources":["../../../src/domain/ir/identifier-text.ts"],"sourcesContent":["import { NEWER_IDENTIFIER_PART, NEWER_IDENTIFIER_START } from \"./newer-identifier-ranges.js\";\n\n/**\n * Identifier rules of ECMAScript (Unicode `ID_Start` / `ID_Continue`, plus `$`, `_`, ZWNJ and\n * ZWJ), for names built from document text, without the characters that TypeScript's scanner\n * does not know yet. Node.js follows a newer Unicode version than TypeScript's identifier tables,\n * so a name such as `꟒Name` (Unicode 17) passed here and failed to parse with \"Invalid\n * character\" (ADR-019). Removing the newer characters also gives the same names on every\n * supported Node.js version.\n */\n\nconst IDENTIFIER_START_RE = new RegExp(\n  `^[[\\\\p{ID_Start}$_]--[${NEWER_IDENTIFIER_START.join(\"\")}]]`,\n  \"v\",\n);\nconst INVALID_IDENTIFIER_PART_RE = new RegExp(\n  `[^[\\\\p{ID_Continue}$\\\\u{200C}\\\\u{200D}]--[${NEWER_IDENTIFIER_PART.join(\"\")}]]`,\n  \"gv\",\n);\n\n/** Whether the text starts with a character that may start an identifier. */\nexport function hasIdentifierStart(text: string): boolean {\n  return IDENTIFIER_START_RE.test(text);\n}\n\n/** The text with each character that cannot be part of an identifier replaced by `_`. */\nexport function withIdentifierParts(text: string): string {\n  return text.replace(INVALID_IDENTIFIER_PART_RE, \"_\");\n}\n\n/**\n * The names TypeScript does not accept as a type alias name: reserved words, strict mode and\n * module reserved words, and predefined type names (`void`, `string`, …). Checked with the\n * TypeScript 6.0 compiler on `export type <name> = 1;` in a module.\n */\nconst RESERVED_TYPE_NAMES: ReadonlySet<string> = new Set(\n  (\n    \"any as await bigint boolean break case catch class const continue debugger default delete \" +\n    \"do else enum export extends false finally for function if implements import in instanceof \" +\n    \"interface let never new null number object package private protected public return static \" +\n    \"string super switch symbol this throw true try typeof undefined unknown var void while with \" +\n    \"yield\"\n  ).split(\" \"),\n);\n\n/** Whether TypeScript rejects the text as the name of a type alias. */\nexport function isReservedTypeName(text: string): boolean {\n  return RESERVED_TYPE_NAMES.has(text);\n}\n"],"names":["NEWER_IDENTIFIER_START","NEWER_IDENTIFIER_PART"],"mappings":";;;;AAWA,MAAM,sBAAsB,IAAI,MAAA;AAAA,EAC9B,CAAA,sBAAA,EAAyBA,4CAAA,CAAuB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EACxD;AACF,CAAA;AACA,MAAM,6BAA6B,IAAI,MAAA;AAAA,EACrC,CAAA,0CAAA,EAA6CC,2CAAA,CAAsB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EAC3E;AACF,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,KAAK,IAAI,CAAA;AACtC;AAGO,SAAS,oBAAoB,IAAA,EAAsB;AACxD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,0BAAA,EAA4B,GAAG,CAAA;AACrD;AAOA,MAAM,sBAA2C,IAAI,GAAA;AAAA,EAEjD,iXAAA,CAKA,MAAM,GAAG;AACb,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,IAAI,IAAI,CAAA;AACrC;;;;"}
+{"version":3,"file":"identifier-text.cjs","sources":["../../../src/domain/ir/identifier-text.ts"],"sourcesContent":["import { NEWER_IDENTIFIER_PART, NEWER_IDENTIFIER_START } from \"./newer-identifier-ranges.js\";\n\n/**\n * Identifier rules of ECMAScript (Unicode `ID_Start` / `ID_Continue`, plus `$`, `_`, ZWNJ and\n * ZWJ), for names built from document text, without the characters that the scanner of the lowest\n * supported TypeScript (5.4) does not know. Node.js follows a newer Unicode version than\n * TypeScript's identifier tables, so a name such as `꟒Name` (Unicode 17) passed here and failed to\n * parse with \"Invalid character\" (ADR-019); TypeScript 5.4 also rejects ZWJ and characters that\n * TypeScript 6 accepts. Removing these also gives the same names on every supported Node.js\n * version.\n */\n\nconst IDENTIFIER_START_RE = new RegExp(\n  `^[[\\\\p{ID_Start}$_]--[${NEWER_IDENTIFIER_START.join(\"\")}]]`,\n  \"v\",\n);\nconst INVALID_IDENTIFIER_PART_RE = new RegExp(\n  `[^[\\\\p{ID_Continue}$\\\\u{200C}\\\\u{200D}]--[${NEWER_IDENTIFIER_PART.join(\"\")}]]`,\n  \"gv\",\n);\n\n/** Whether the text starts with a character that may start an identifier. */\nexport function hasIdentifierStart(text: string): boolean {\n  return IDENTIFIER_START_RE.test(text);\n}\n\n/** The text with each character that cannot be part of an identifier replaced by `_`. */\nexport function withIdentifierParts(text: string): string {\n  return text.replace(INVALID_IDENTIFIER_PART_RE, \"_\");\n}\n\n/**\n * The names TypeScript does not accept as a type alias name: reserved words, strict mode and\n * module reserved words, and predefined type names (`void`, `string`, …). Checked with the\n * TypeScript 6.0 compiler on `export type <name> = 1;` in a module.\n */\nconst RESERVED_TYPE_NAMES: ReadonlySet<string> = new Set(\n  (\n    \"any as await bigint boolean break case catch class const continue debugger default delete \" +\n    \"do else enum export extends false finally for function if implements import in instanceof \" +\n    \"interface let never new null number object package private protected public return static \" +\n    \"string super switch symbol this throw true try typeof undefined unknown var void while with \" +\n    \"yield\"\n  ).split(\" \"),\n);\n\n/** Whether TypeScript rejects the text as the name of a type alias. */\nexport function isReservedTypeName(text: string): boolean {\n  return RESERVED_TYPE_NAMES.has(text);\n}\n"],"names":["NEWER_IDENTIFIER_START","NEWER_IDENTIFIER_PART"],"mappings":";;;;AAYA,MAAM,sBAAsB,IAAI,MAAA;AAAA,EAC9B,CAAA,sBAAA,EAAyBA,4CAAA,CAAuB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EACxD;AACF,CAAA;AACA,MAAM,6BAA6B,IAAI,MAAA;AAAA,EACrC,CAAA,0CAAA,EAA6CC,2CAAA,CAAsB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EAC3E;AACF,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,KAAK,IAAI,CAAA;AACtC;AAGO,SAAS,oBAAoB,IAAA,EAAsB;AACxD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,0BAAA,EAA4B,GAAG,CAAA;AACrD;AAOA,MAAM,sBAA2C,IAAI,GAAA;AAAA,EAEjD,iXAAA,CAKA,MAAM,GAAG;AACb,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,IAAI,IAAI,CAAA;AACrC;;;;"}

package/dist/domain/ir/identifier-text.mjs

@@ -1,4 +1,4 @@
-import { NEWER_IDENTIFIER_PART, NEWER_IDENTIFIER_START } from './newer-identifier-ranges.mjs';
+import { NEWER_IDENTIFIER_START, NEWER_IDENTIFIER_PART } from './newer-identifier-ranges.mjs';
 
 const IDENTIFIER_START_RE = new RegExp(
   `^[[\\p{ID_Start}$_]--[${NEWER_IDENTIFIER_START.join("")}]]`,

package/dist/domain/ir/identifier-text.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"identifier-text.mjs","sources":["../../../src/domain/ir/identifier-text.ts"],"sourcesContent":["import { NEWER_IDENTIFIER_PART, NEWER_IDENTIFIER_START } from \"./newer-identifier-ranges.js\";\n\n/**\n * Identifier rules of ECMAScript (Unicode `ID_Start` / `ID_Continue`, plus `$`, `_`, ZWNJ and\n * ZWJ), for names built from document text, without the characters that TypeScript's scanner\n * does not know yet. Node.js follows a newer Unicode version than TypeScript's identifier tables,\n * so a name such as `꟒Name` (Unicode 17) passed here and failed to parse with \"Invalid\n * character\" (ADR-019). Removing the newer characters also gives the same names on every\n * supported Node.js version.\n */\n\nconst IDENTIFIER_START_RE = new RegExp(\n  `^[[\\\\p{ID_Start}$_]--[${NEWER_IDENTIFIER_START.join(\"\")}]]`,\n  \"v\",\n);\nconst INVALID_IDENTIFIER_PART_RE = new RegExp(\n  `[^[\\\\p{ID_Continue}$\\\\u{200C}\\\\u{200D}]--[${NEWER_IDENTIFIER_PART.join(\"\")}]]`,\n  \"gv\",\n);\n\n/** Whether the text starts with a character that may start an identifier. */\nexport function hasIdentifierStart(text: string): boolean {\n  return IDENTIFIER_START_RE.test(text);\n}\n\n/** The text with each character that cannot be part of an identifier replaced by `_`. */\nexport function withIdentifierParts(text: string): string {\n  return text.replace(INVALID_IDENTIFIER_PART_RE, \"_\");\n}\n\n/**\n * The names TypeScript does not accept as a type alias name: reserved words, strict mode and\n * module reserved words, and predefined type names (`void`, `string`, …). Checked with the\n * TypeScript 6.0 compiler on `export type <name> = 1;` in a module.\n */\nconst RESERVED_TYPE_NAMES: ReadonlySet<string> = new Set(\n  (\n    \"any as await bigint boolean break case catch class const continue debugger default delete \" +\n    \"do else enum export extends false finally for function if implements import in instanceof \" +\n    \"interface let never new null number object package private protected public return static \" +\n    \"string super switch symbol this throw true try typeof undefined unknown var void while with \" +\n    \"yield\"\n  ).split(\" \"),\n);\n\n/** Whether TypeScript rejects the text as the name of a type alias. */\nexport function isReservedTypeName(text: string): boolean {\n  return RESERVED_TYPE_NAMES.has(text);\n}\n"],"names":[],"mappings":";;AAWA,MAAM,sBAAsB,IAAI,MAAA;AAAA,EAC9B,CAAA,sBAAA,EAAyB,sBAAA,CAAuB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EACxD;AACF,CAAA;AACA,MAAM,6BAA6B,IAAI,MAAA;AAAA,EACrC,CAAA,0CAAA,EAA6C,qBAAA,CAAsB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EAC3E;AACF,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,KAAK,IAAI,CAAA;AACtC;AAGO,SAAS,oBAAoB,IAAA,EAAsB;AACxD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,0BAAA,EAA4B,GAAG,CAAA;AACrD;AAOA,MAAM,sBAA2C,IAAI,GAAA;AAAA,EAEjD,iXAAA,CAKA,MAAM,GAAG;AACb,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,IAAI,IAAI,CAAA;AACrC;;"}
+{"version":3,"file":"identifier-text.mjs","sources":["../../../src/domain/ir/identifier-text.ts"],"sourcesContent":["import { NEWER_IDENTIFIER_PART, NEWER_IDENTIFIER_START } from \"./newer-identifier-ranges.js\";\n\n/**\n * Identifier rules of ECMAScript (Unicode `ID_Start` / `ID_Continue`, plus `$`, `_`, ZWNJ and\n * ZWJ), for names built from document text, without the characters that the scanner of the lowest\n * supported TypeScript (5.4) does not know. Node.js follows a newer Unicode version than\n * TypeScript's identifier tables, so a name such as `꟒Name` (Unicode 17) passed here and failed to\n * parse with \"Invalid character\" (ADR-019); TypeScript 5.4 also rejects ZWJ and characters that\n * TypeScript 6 accepts. Removing these also gives the same names on every supported Node.js\n * version.\n */\n\nconst IDENTIFIER_START_RE = new RegExp(\n  `^[[\\\\p{ID_Start}$_]--[${NEWER_IDENTIFIER_START.join(\"\")}]]`,\n  \"v\",\n);\nconst INVALID_IDENTIFIER_PART_RE = new RegExp(\n  `[^[\\\\p{ID_Continue}$\\\\u{200C}\\\\u{200D}]--[${NEWER_IDENTIFIER_PART.join(\"\")}]]`,\n  \"gv\",\n);\n\n/** Whether the text starts with a character that may start an identifier. */\nexport function hasIdentifierStart(text: string): boolean {\n  return IDENTIFIER_START_RE.test(text);\n}\n\n/** The text with each character that cannot be part of an identifier replaced by `_`. */\nexport function withIdentifierParts(text: string): string {\n  return text.replace(INVALID_IDENTIFIER_PART_RE, \"_\");\n}\n\n/**\n * The names TypeScript does not accept as a type alias name: reserved words, strict mode and\n * module reserved words, and predefined type names (`void`, `string`, …). Checked with the\n * TypeScript 6.0 compiler on `export type <name> = 1;` in a module.\n */\nconst RESERVED_TYPE_NAMES: ReadonlySet<string> = new Set(\n  (\n    \"any as await bigint boolean break case catch class const continue debugger default delete \" +\n    \"do else enum export extends false finally for function if implements import in instanceof \" +\n    \"interface let never new null number object package private protected public return static \" +\n    \"string super switch symbol this throw true try typeof undefined unknown var void while with \" +\n    \"yield\"\n  ).split(\" \"),\n);\n\n/** Whether TypeScript rejects the text as the name of a type alias. */\nexport function isReservedTypeName(text: string): boolean {\n  return RESERVED_TYPE_NAMES.has(text);\n}\n"],"names":[],"mappings":";;AAYA,MAAM,sBAAsB,IAAI,MAAA;AAAA,EAC9B,CAAA,sBAAA,EAAyB,sBAAA,CAAuB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EACxD;AACF,CAAA;AACA,MAAM,6BAA6B,IAAI,MAAA;AAAA,EACrC,CAAA,0CAAA,EAA6C,qBAAA,CAAsB,IAAA,CAAK,EAAE,CAAC,CAAA,EAAA,CAAA;AAAA,EAC3E;AACF,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,KAAK,IAAI,CAAA;AACtC;AAGO,SAAS,oBAAoB,IAAA,EAAsB;AACxD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,0BAAA,EAA4B,GAAG,CAAA;AACrD;AAOA,MAAM,sBAA2C,IAAI,GAAA;AAAA,EAEjD,iXAAA,CAKA,MAAM,GAAG;AACb,CAAA;AAGO,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,mBAAA,CAAoB,IAAI,IAAI,CAAA;AACrC;;"}

package/dist/domain/ir/ir-shape.cjs

@@ -0,0 +1,187 @@
+'use strict';
+
+const identifierText = require('./identifier-text.cjs');
+
+const KEYWORDS = /* @__PURE__ */ new Set([
+  "string",
+  "number",
+  "boolean",
+  "null",
+  "undefined",
+  "unknown",
+  "never"
+]);
+const STRING_ENCODINGS = /* @__PURE__ */ new Set([void 0, "json", "escaped"]);
+function isFields(value) {
+  return typeof value === "object" && value !== null;
+}
+function isText(value) {
+  return typeof value === "string" && value.trim() !== "";
+}
+function isIdentifier(text) {
+  return typeof text === "string" && identifierText.hasIdentifierStart(text) && identifierText.withIdentifierParts(text) === text;
+}
+const TYPE_QUERY_PREFIX = "typeof ";
+const NOT_TYPE_QUERY_START = new Set(
+  "import implements interface let package private protected public static yield".split(" ")
+);
+const NOT_TYPE_REFERENCE_START = /* @__PURE__ */ new Set([
+  ...NOT_TYPE_QUERY_START,
+  ..."new typeof infer keyof readonly unique".split(" ")
+]);
+function isTypeName(text) {
+  if (typeof text !== "string") {
+    return false;
+  }
+  const isQuery = text.startsWith(TYPE_QUERY_PREFIX);
+  const names = (isQuery ? text.slice(TYPE_QUERY_PREFIX.length) : text).split(".");
+  const reserved = isQuery ? NOT_TYPE_QUERY_START : NOT_TYPE_REFERENCE_START;
+  return names.every(isIdentifier) && !reserved.has(names[0]);
+}
+function isNumberName(text) {
+  return typeof text === "string" && String(Number(text)) === text && !text.startsWith("-");
+}
+class IrShapeCheck {
+  #ancestors = /* @__PURE__ */ new Set();
+  isType(value) {
+    return this.#within(value, (node) => {
+      const check = TYPE_CHECKS[node.kind];
+      return Object.hasOwn(TYPE_CHECKS, String(node.kind)) && check(node, this);
+    });
+  }
+  isTypeList(value, isEmptyAllowed) {
+    return Array.isArray(value) && (isEmptyAllowed || value.length > 0) && value.every((entry) => this.isType(entry));
+  }
+  isMember(value) {
+    return isFields(value) && value.kind === "indexSignature" ? this.#within(value, (node) => this.#isIndexSignature(node)) : this.isProperty(value);
+  }
+  isProperty(value) {
+    return this.#within(
+      value,
+      (node) => node.kind === "property" && isPropertyName(node.name) && this.isType(node.type) && typeof node.isOptional === "boolean" && typeof node.isReadonly === "boolean" && areComments(node.comments)
+    );
+  }
+  #isIndexSignature(node) {
+    return isIdentifier(node.parameterName) && this.isType(node.parameterType) && isIndexParameterType(node.parameterType) && this.isType(node.type) && typeof node.isReadonly === "boolean" && areComments(node.comments);
+  }
+  #within(value, check) {
+    if (!isFields(value) || this.#ancestors.has(value)) {
+      return false;
+    }
+    this.#ancestors.add(value);
+    try {
+      return check(value);
+    } finally {
+      this.#ancestors.delete(value);
+    }
+  }
+}
+const INDEX_KEYWORD_ATOMS = /* @__PURE__ */ new Map([
+  ["string", "string"],
+  ["number", "number"]
+]);
+const TAG = "tag";
+const UNRESOLVED = "unresolved";
+function intersectAtoms(left, right) {
+  if (left === right || right === TAG) {
+    return left;
+  }
+  return left === TAG ? right : void 0;
+}
+function intersectKeys(left, right) {
+  if (left === UNRESOLVED || right === UNRESOLVED) {
+    return UNRESOLVED;
+  }
+  const atoms = [...left].flatMap((atom) => [...right].map((other) => intersectAtoms(atom, other)));
+  return new Set(atoms.filter((atom) => atom !== void 0));
+}
+function unionKeys(left, right) {
+  return left === UNRESOLVED || right === UNRESOLVED ? UNRESOLVED : /* @__PURE__ */ new Set([...left, ...right]);
+}
+function combineKeys(types, combine) {
+  let combined;
+  for (const member of types) {
+    const keys = indexKeys(member);
+    if (keys === void 0) {
+      return void 0;
+    }
+    combined = combined === void 0 ? keys : combine(combined, keys);
+  }
+  return combined;
+}
+function indexKeys(type) {
+  switch (type.kind) {
+    case "keyword": {
+      const atom = INDEX_KEYWORD_ATOMS.get(type.keyword);
+      return atom === void 0 ? void 0 : /* @__PURE__ */ new Set([atom]);
+    }
+    case "object":
+      return /* @__PURE__ */ new Set([TAG]);
+    case "reference":
+    case "indexedAccess":
+    case "raw":
+      return UNRESOLVED;
+    case "union":
+      return combineKeys(type.types, unionKeys);
+    case "intersection":
+      return combineKeys(type.types, intersectKeys);
+    default:
+      return void 0;
+  }
+}
+function isIndexParameterType(type) {
+  const keys = indexKeys(type);
+  return keys === UNRESOLVED || keys !== void 0 && keys.size > 0 && !keys.has(TAG);
+}
+function isPropertyName(value) {
+  if (!isFields(value)) {
+    return false;
+  }
+  switch (value.kind) {
+    case "identifier":
+      return isIdentifier(value.text);
+    case "number":
+      return isNumberName(value.text);
+    case "string":
+      return typeof value.value === "string";
+    default:
+      return false;
+  }
+}
+function isComment(value) {
+  if (!isFields(value) || typeof value.text !== "string") {
+    return false;
+  }
+  return value.kind === "block" ? !value.text.includes("*/") : value.kind === "line" && !/[\n\r\u2028\u2029]/.test(value.text);
+}
+function areComments(value) {
+  return Array.isArray(value) && value.every(isComment);
+}
+function isTupleElement(value, check) {
+  return isFields(value) && check.isType(value.type) && typeof value.isRest === "boolean" && typeof value.isOptional === "boolean" && !(value.isRest && value.isOptional);
+}
+const TYPE_CHECKS = {
+  keyword: (node) => KEYWORDS.has(node.keyword),
+  stringLiteral: (node) => typeof node.value === "string" && STRING_ENCODINGS.has(node.encoding),
+  numberLiteral: (node) => Number.isFinite(node.value),
+  booleanLiteral: (node) => typeof node.value === "boolean",
+  reference: (node, check) => isTypeName(node.name) && check.isTypeList(node.typeArguments, true),
+  array: (node, check) => check.isType(node.element),
+  tuple: (node, check) => Array.isArray(node.elements) && node.elements.every((entry) => isTupleElement(entry, check)),
+  union: (node, check) => check.isTypeList(node.types, false),
+  intersection: (node, check) => check.isTypeList(node.types, false),
+  object: (node, check) => Array.isArray(node.members) && node.members.every((member) => check.isMember(member)),
+  indexedAccess: (node, check) => check.isType(node.object) && check.isType(node.index),
+  readonly: (node, check) => check.isType(node.type),
+  raw: (node) => isText(node.text)
+};
+function isPrintableIrType(value) {
+  return new IrShapeCheck().isType(value);
+}
+function isPrintableIrProperty(value) {
+  return new IrShapeCheck().isProperty(value);
+}
+
+exports.isPrintableIrProperty = isPrintableIrProperty;
+exports.isPrintableIrType = isPrintableIrType;
+//# sourceMappingURL=ir-shape.cjs.map

package/dist/domain/ir/ir-shape.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir-shape.cjs","sources":["../../../src/domain/ir/ir-shape.ts"],"sourcesContent":["import { hasIdentifierStart, withIdentifierParts } from \"./identifier-text.js\";\nimport type { IrKeyword, IrPropertySignature, IrType } from \"./nodes.js\";\n\n/**\n * Whether a value from outside the package (an IR callback's result) is IR the printer writes as\n * valid TypeScript. JavaScript callers can return any value, and the type checker of a\n * TypeScript caller does not stop `{ kind: \"union\", types: [] }` or an empty type text either:\n * without this check such a result crashed the printer with an untyped error, or printed text\n * such as `a?: ;`. Raw type text is printed as written, so only blank text is rejected; the text\n * itself is the caller's TypeScript, which the caller's compiler checks.\n */\n\ntype Fields = Readonly<Record<string, unknown>>;\n\nconst KEYWORDS: ReadonlySet<string> = new Set<IrKeyword>([\n  \"string\",\n  \"number\",\n  \"boolean\",\n  \"null\",\n  \"undefined\",\n  \"unknown\",\n  \"never\",\n]);\n\nconst STRING_ENCODINGS: ReadonlySet<unknown> = new Set([undefined, \"json\", \"escaped\"]);\n\nfunction isFields(value: unknown): value is Fields {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isText(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim() !== \"\";\n}\n\nfunction isIdentifier(text: unknown): boolean {\n  return typeof text === \"string\" && hasIdentifierStart(text) && withIdentifierParts(text) === text;\n}\n\n/** The prefix of a type query: the generator writes `typeof Status` as a reference name. */\nconst TYPE_QUERY_PREFIX = \"typeof \";\n\n/**\n * Words that cannot start the name of a type query (`typeof <name>`): `import` starts an import\n * type, and strict mode reserves the others. Found with the TypeScript 5.4 and 6.0 compilers\n * (syntax and grammar errors) on `type A = { a?: typeof <name> }`, over every reserved word and\n * contextual keyword. A name after a `.` may be any identifier, reserved words included.\n */\nconst NOT_TYPE_QUERY_START: ReadonlySet<string> = new Set(\n  \"import implements interface let package private protected public static yield\".split(\" \"),\n);\n/** Words that cannot start a type reference either: they are operators of a type there. */\nconst NOT_TYPE_REFERENCE_START: ReadonlySet<string> = new Set([\n  ...NOT_TYPE_QUERY_START,\n  ...\"new typeof infer keyof readonly unique\".split(\" \"),\n]);\n\n/**\n * A name TypeScript reads as the name of a type: identifiers joined by `.` (`Status`,\n * `Status.active`), optionally as a type query (`typeof Status`). Text such as `a b` or `A<B>`\n * would print as other or invalid TypeScript, and so would `keyof` or `let` as the first name;\n * type arguments go in `typeArguments`.\n */\nfunction isTypeName(text: unknown): boolean {\n  if (typeof text !== \"string\") {\n    return false;\n  }\n  const isQuery = text.startsWith(TYPE_QUERY_PREFIX);\n  const names = (isQuery ? text.slice(TYPE_QUERY_PREFIX.length) : text).split(\".\");\n  const reserved = isQuery ? NOT_TYPE_QUERY_START : NOT_TYPE_REFERENCE_START;\n  return names.every(isIdentifier) && !reserved.has(names[0] as string);\n}\n\n/** A non-negative number written as JavaScript writes it, as `toPropertyName` makes them. */\nfunction isNumberName(text: unknown): boolean {\n  return typeof text === \"string\" && String(Number(text)) === text && !text.startsWith(\"-\");\n}\n\n/** Walks one value; `ancestors` makes a cycle invalid instead of an endless recursion. */\nclass IrShapeCheck {\n  readonly #ancestors = new Set<object>();\n\n  isType(value: unknown): boolean {\n    return this.#within(value, (node) => {\n      const check = TYPE_CHECKS[node.kind as IrType[\"kind\"]];\n      return Object.hasOwn(TYPE_CHECKS, String(node.kind)) && check(node, this);\n    });\n  }\n\n  isTypeList(value: unknown, isEmptyAllowed: boolean): boolean {\n    return (\n      Array.isArray(value) &&\n      (isEmptyAllowed || value.length > 0) &&\n      value.every((entry) => this.isType(entry))\n    );\n  }\n\n  isMember(value: unknown): boolean {\n    return isFields(value) && value.kind === \"indexSignature\"\n      ? this.#within(value, (node) => this.#isIndexSignature(node))\n      : this.isProperty(value);\n  }\n\n  isProperty(value: unknown): boolean {\n    return this.#within(\n      value,\n      (node) =>\n        node.kind === \"property\" &&\n        isPropertyName(node.name) &&\n        this.isType(node.type) &&\n        typeof node.isOptional === \"boolean\" &&\n        typeof node.isReadonly === \"boolean\" &&\n        areComments(node.comments),\n    );\n  }\n\n  #isIndexSignature(node: Fields): boolean {\n    return (\n      isIdentifier(node.parameterName) &&\n      this.isType(node.parameterType) &&\n      isIndexParameterType(node.parameterType as IrType) &&\n      this.isType(node.type) &&\n      typeof node.isReadonly === \"boolean\" &&\n      areComments(node.comments)\n    );\n  }\n\n  #within(value: unknown, check: (node: Fields) => boolean): boolean {\n    if (!isFields(value) || this.#ancestors.has(value)) {\n      return false;\n    }\n    this.#ancestors.add(value);\n    try {\n      return check(value);\n    } finally {\n      this.#ancestors.delete(value);\n    }\n  }\n}\n\n/**\n * What an index signature parameter type reduces to: `string`, `number`, or an object type that\n * tags one of them (`string & {}`), each as an atom; `unresolved` for a name, an indexed access\n * (`K[\"a\"]`) or type text, which only TypeScript can resolve; undefined for a type that can never\n * be one (a literal, an array, a tuple, `readonly`, another keyword).\n */\ntype IndexAtom = \"string\" | \"number\" | \"tag\";\ntype IndexKeys = ReadonlySet<IndexAtom> | \"unresolved\";\n\n/** The keywords an index signature takes as its parameter type, as atoms. */\nconst INDEX_KEYWORD_ATOMS: ReadonlyMap<string, IndexAtom> = new Map([\n  [\"string\", \"string\"],\n  [\"number\", \"number\"],\n]);\n\nconst TAG: IndexAtom = \"tag\";\nconst UNRESOLVED = \"unresolved\";\n\n/** One atom of each side together: a tag keeps the other side, two keys must be the same. */\nfunction intersectAtoms(left: IndexAtom, right: IndexAtom): IndexAtom | undefined {\n  if (left === right || right === TAG) {\n    return left;\n  }\n  return left === TAG ? right : undefined;\n}\n\n/** `A & B` over atoms, as TypeScript spreads an intersection over the members of a union. */\nfunction intersectKeys(left: IndexKeys, right: IndexKeys): IndexKeys {\n  if (left === UNRESOLVED || right === UNRESOLVED) {\n    return UNRESOLVED;\n  }\n  const atoms = [...left].flatMap((atom) => [...right].map((other) => intersectAtoms(atom, other)));\n  return new Set(atoms.filter((atom) => atom !== undefined));\n}\n\n/** `A | B` over atoms. */\nfunction unionKeys(left: IndexKeys, right: IndexKeys): IndexKeys {\n  return left === UNRESOLVED || right === UNRESOLVED ? UNRESOLVED : new Set([...left, ...right]);\n}\n\n/** The keys of each member combined, or undefined when one member can never be a key. */\nfunction combineKeys(\n  types: readonly IrType[],\n  combine: (left: IndexKeys, right: IndexKeys) => IndexKeys,\n): IndexKeys | undefined {\n  let combined: IndexKeys | undefined;\n  for (const member of types) {\n    const keys = indexKeys(member);\n    if (keys === undefined) {\n      return undefined;\n    }\n    combined = combined === undefined ? keys : combine(combined, keys);\n  }\n  return combined;\n}\n\nfunction indexKeys(type: IrType): IndexKeys | undefined {\n  switch (type.kind) {\n    case \"keyword\": {\n      const atom = INDEX_KEYWORD_ATOMS.get(type.keyword);\n      return atom === undefined ? undefined : new Set([atom]);\n    }\n    case \"object\":\n      return new Set([TAG]);\n    case \"reference\":\n    case \"indexedAccess\":\n    case \"raw\":\n      return UNRESOLVED;\n    case \"union\":\n      return combineKeys(type.types, unionKeys);\n    case \"intersection\":\n      return combineKeys(type.types, intersectKeys);\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Whether a type can be the parameter type of an index signature. TypeScript takes `string`,\n * `number`, `symbol`, a template literal type, a union of these, or one of them tagged by an\n * intersection (`string & {}`); anything else fails with TS1268 or TS1337. It decides by the\n * resolved type, so `string & \"a\"` (the literal `\"a\"`), `string & number` (`never`) and an\n * object type alone are refused, and a name, an indexed access and type text pass for TypeScript\n * to check.\n */\nfunction isIndexParameterType(type: IrType): boolean {\n  const keys = indexKeys(type);\n  return keys === UNRESOLVED || (keys !== undefined && keys.size > 0 && !keys.has(TAG));\n}\n\nfunction isPropertyName(value: unknown): boolean {\n  if (!isFields(value)) {\n    return false;\n  }\n  switch (value.kind) {\n    case \"identifier\":\n      return isIdentifier(value.text);\n    case \"number\":\n      return isNumberName(value.text);\n    case \"string\":\n      return typeof value.value === \"string\";\n    default:\n      return false;\n  }\n}\n\n/** A block comment must not end itself early (`*\\/`); a line comment must stay on its line. */\nfunction isComment(value: unknown): boolean {\n  if (!isFields(value) || typeof value.text !== \"string\") {\n    return false;\n  }\n  return value.kind === \"block\"\n    ? !value.text.includes(\"*/\")\n    : value.kind === \"line\" && !/[\\n\\r\\u2028\\u2029]/.test(value.text);\n}\n\nfunction areComments(value: unknown): boolean {\n  return Array.isArray(value) && value.every(isComment);\n}\n\nfunction isTupleElement(value: unknown, check: IrShapeCheck): boolean {\n  return (\n    isFields(value) &&\n    check.isType(value.type) &&\n    typeof value.isRest === \"boolean\" &&\n    typeof value.isOptional === \"boolean\" &&\n    !(value.isRest && value.isOptional)\n  );\n}\n\n/** One check per kind; the `Record` makes a new kind fail to compile until it is checked. */\nconst TYPE_CHECKS: Readonly<\n  Record<IrType[\"kind\"], (node: Fields, check: IrShapeCheck) => boolean>\n> = {\n  keyword: (node) => KEYWORDS.has(node.keyword as string),\n  stringLiteral: (node) => typeof node.value === \"string\" && STRING_ENCODINGS.has(node.encoding),\n  numberLiteral: (node) => Number.isFinite(node.value),\n  booleanLiteral: (node) => typeof node.value === \"boolean\",\n  reference: (node, check) => isTypeName(node.name) && check.isTypeList(node.typeArguments, true),\n  array: (node, check) => check.isType(node.element),\n  tuple: (node, check) =>\n    Array.isArray(node.elements) && node.elements.every((entry) => isTupleElement(entry, check)),\n  union: (node, check) => check.isTypeList(node.types, false),\n  intersection: (node, check) => check.isTypeList(node.types, false),\n  object: (node, check) =>\n    Array.isArray(node.members) && node.members.every((member) => check.isMember(member)),\n  indexedAccess: (node, check) => check.isType(node.object) && check.isType(node.index),\n  readonly: (node, check) => check.isType(node.type),\n  raw: (node) => isText(node.text),\n};\n\n/** Whether `value` is an IR type the printer writes as valid TypeScript. */\nexport function isPrintableIrType(value: unknown): value is IrType {\n  return new IrShapeCheck().isType(value);\n}\n\n/** Whether `value` is an IR property signature the printer writes as valid TypeScript. */\nexport function isPrintableIrProperty(value: unknown): value is IrPropertySignature {\n  return new IrShapeCheck().isProperty(value);\n}\n"],"names":["hasIdentifierStart","withIdentifierParts"],"mappings":"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"}