openapi-typesafe 0.0.0 → 1.0.0-rc.0

package/dist/application/transform/schema-comment.mjs

@@ -0,0 +1,81 @@
+const LINE_BREAK_RE = /\r?\n/g;
+const CONTINUATION = "\n *     ";
+const COMMENT_END_RE = /\*\//g;
+const VALUE_TAGS = ["description", "default", "example"];
+const TAGS_KEEPING_EMPTY_STRING = /* @__PURE__ */ new Set(["default", "example"]);
+const JSON_INDENT = 2;
+function formatValue(value) {
+  const text = typeof value === "object" ? JSON.stringify(value, null, JSON_INDENT) : value;
+  return String(text).trim().replace(LINE_BREAK_RE, CONTINUATION);
+}
+function plainLines(schema) {
+  const lines = [];
+  for (const text of [schema.title, schema.summary]) {
+    if (typeof text === "string" && text) {
+      lines.push(text.trim().replace(LINE_BREAK_RE, CONTINUATION));
+    }
+  }
+  if (schema.format) {
+    lines.push(`Format: ${schema.format}`);
+  }
+  if (schema.deprecated) {
+    lines.push("@deprecated");
+  }
+  return lines;
+}
+function valueTagLines(schema) {
+  const lines = [];
+  for (const tag of VALUE_TAGS) {
+    const value = schema[tag];
+    if (value === void 0 || value === "" && !TAGS_KEEPING_EMPTY_STRING.has(tag)) {
+      continue;
+    }
+    lines.push(`@${tag} ${formatValue(value)}`);
+  }
+  if (Array.isArray(schema.examples)) {
+    lines.push(...schema.examples.map((example) => `@example ${formatValue(example)}`));
+  }
+  return lines;
+}
+function enumTypeName(schema) {
+  if (Array.isArray(schema.type)) {
+    return schema.type.join("|");
+  }
+  return typeof schema.type === "string" ? schema.type : "unknown";
+}
+function constantAndEnumLines(schema) {
+  const lines = [];
+  if ("const" in schema) {
+    lines.push("@constant");
+  }
+  if (schema.enum) {
+    lines.push(`@enum {${enumTypeName(schema)}${schema.nullable ? "|null" : ""}}`);
+  }
+  return lines;
+}
+function schemaComment(schema) {
+  if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
+    return null;
+  }
+  const annotated = schema;
+  const lines = [
+    ...plainLines(annotated),
+    ...valueTagLines(annotated),
+    ...constantAndEnumLines(annotated)
+  ];
+  if (lines.length === 0) {
+    return null;
+  }
+  const isSingleLine = lines.length === 1 && !lines.some((line) => line.includes("\n"));
+  const text = isSingleLine ? `* ${lines.join("\n")} ` : `*
+ * ${lines.join("\n * ")}
+ `;
+  return { kind: "block", text: text.replace(COMMENT_END_RE, "*\\/") };
+}
+function withSchemaComment(property, schema) {
+  const comment = schemaComment(schema);
+  return comment === null ? property : { ...property, comments: [...property.comments, comment] };
+}
+
+export { schemaComment, withSchemaComment };
+//# sourceMappingURL=schema-comment.mjs.map

package/dist/application/transform/schema-comment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-comment.mjs","sources":["../../../src/application/transform/schema-comment.ts"],"sourcesContent":["import type { IrComment, IrPropertySignature } from \"../../domain/ir/nodes.js\";\n\n/** Schema fields that produce JSDoc lines (the original `AnnotatedSchemaObject`). */\nexport interface AnnotatedSchema {\n  readonly const?: unknown;\n  readonly default?: unknown;\n  readonly deprecated?: boolean;\n  readonly description?: string;\n  readonly enum?: unknown[];\n  readonly example?: unknown;\n  readonly examples?: unknown;\n  readonly format?: string;\n  readonly nullable?: boolean;\n  readonly summary?: string;\n  readonly title?: string;\n  readonly type?: string | string[];\n}\n\nconst LINE_BREAK_RE = /\\r?\\n/g;\n/** Continuation lines of a multi-line value are indented under the tag. */\nconst CONTINUATION = \"\\n *     \";\nconst COMMENT_END_RE = /\\*\\//g;\n/** Tags written as `@tag value`; an empty string is kept only where it is a meaningful value. */\nconst VALUE_TAGS = [\"description\", \"default\", \"example\"] as const;\nconst TAGS_KEEPING_EMPTY_STRING: ReadonlySet<string> = new Set([\"default\", \"example\"]);\nconst JSON_INDENT = 2;\n\nfunction formatValue(value: unknown): string {\n  const text = typeof value === \"object\" ? JSON.stringify(value, null, JSON_INDENT) : value;\n  return String(text).trim().replace(LINE_BREAK_RE, CONTINUATION);\n}\n\nfunction plainLines(schema: AnnotatedSchema): string[] {\n  const lines: string[] = [];\n  for (const text of [schema.title, schema.summary]) {\n    // The document is not validated against the schema dialect: a property named `summary`\n    // written without `properties:` makes `summary` an object (upstream #2349).\n    if (typeof text === \"string\" && text) {\n      lines.push(text.trim().replace(LINE_BREAK_RE, CONTINUATION));\n    }\n  }\n  if (schema.format) {\n    lines.push(`Format: ${schema.format}`);\n  }\n  if (schema.deprecated) {\n    lines.push(\"@deprecated\");\n  }\n  return lines;\n}\n\nfunction valueTagLines(schema: AnnotatedSchema): string[] {\n  const lines: string[] = [];\n  for (const tag of VALUE_TAGS) {\n    const value = schema[tag];\n    if (value === undefined || (value === \"\" && !TAGS_KEEPING_EMPTY_STRING.has(tag))) {\n      continue;\n    }\n    lines.push(`@${tag} ${formatValue(value)}`);\n  }\n  if (Array.isArray(schema.examples)) {\n    lines.push(...schema.examples.map((example: unknown) => `@example ${formatValue(example)}`));\n  }\n  return lines;\n}\n\nfunction enumTypeName(schema: AnnotatedSchema): string {\n  if (Array.isArray(schema.type)) {\n    return schema.type.join(\"|\");\n  }\n  return typeof schema.type === \"string\" ? schema.type : \"unknown\";\n}\n\nfunction constantAndEnumLines(schema: AnnotatedSchema): string[] {\n  const lines: string[] = [];\n  if (\"const\" in schema) {\n    lines.push(\"@constant\");\n  }\n  if (schema.enum) {\n    lines.push(`@enum {${enumTypeName(schema)}${schema.nullable ? \"|null\" : \"\"}}`);\n  }\n  return lines;\n}\n\n/**\n * The JSDoc comment the original writes for a schema (`addJSDocComment`): title, summary and\n * format, then `@deprecated`, `@description`, `@default`, `@example`, `@constant` and `@enum`\n * tags. One short line stays on the `/**` line; anything else is a block. Returns null when there\n * is nothing to say, or when the value is not a schema object.\n */\nexport function schemaComment(schema: unknown): IrComment | null {\n  if (!schema || typeof schema !== \"object\" || Array.isArray(schema)) {\n    return null;\n  }\n  const annotated = schema as AnnotatedSchema;\n  const lines = [\n    ...plainLines(annotated),\n    ...valueTagLines(annotated),\n    ...constantAndEnumLines(annotated),\n  ];\n  if (lines.length === 0) {\n    return null;\n  }\n  const isSingleLine = lines.length === 1 && !lines.some((line) => line.includes(\"\\n\"));\n  const text = isSingleLine ? `* ${lines.join(\"\\n\")} ` : `*\\n * ${lines.join(\"\\n * \")}\\n `;\n  // A `*/` inside a value would end the comment early.\n  return { kind: \"block\", text: text.replace(COMMENT_END_RE, \"*\\\\/\") };\n}\n\n/** The property with the schema's JSDoc added after the comments it already has. */\nexport function withSchemaComment(\n  property: IrPropertySignature,\n  schema: unknown,\n): IrPropertySignature {\n  const comment = schemaComment(schema);\n  return comment === null ? property : { ...property, comments: [...property.comments, comment] };\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/shared-types.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+const constructors = require('../../domain/ir/constructors.cjs');
+
+const UNKNOWN_TYPE = Object.freeze(constructors.irKeyword("unknown"));
+
+exports.UNKNOWN_TYPE = UNKNOWN_TYPE;
+//# sourceMappingURL=shared-types.cjs.map

package/dist/application/transform/shared-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.cjs","sources":["../../../src/application/transform/shared-types.ts"],"sourcesContent":["import { irKeyword } from \"../../domain/ir/constructors.js\";\nimport type { IrKeywordType } from \"../../domain/ir/nodes.js\";\n\n/**\n * The shared `unknown` node. The original compares types with its shared `UNKNOWN` node by\n * identity (a nullable schema whose type *is* that node stays `unknown`), so the transformers use\n * one frozen node for the same cases, and the legacy adapter maps the original constant to it.\n */\nexport const UNKNOWN_TYPE: IrKeywordType = Object.freeze(irKeyword(\"unknown\"));\n"],"names":["irKeyword"],"mappings":";;;;AAQO,MAAM,YAAA,GAA8B,MAAA,CAAO,MAAA,CAAOA,sBAAA,CAAU,SAAS,CAAC;;"}

package/dist/application/transform/shared-types.mjs

@@ -0,0 +1,6 @@
+import { irKeyword } from '../../domain/ir/constructors.mjs';
+
+const UNKNOWN_TYPE = Object.freeze(irKeyword("unknown"));
+
+export { UNKNOWN_TYPE };
+//# sourceMappingURL=shared-types.mjs.map

package/dist/application/transform/shared-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.mjs","sources":["../../../src/application/transform/shared-types.ts"],"sourcesContent":["import { irKeyword } from \"../../domain/ir/constructors.js\";\nimport type { IrKeywordType } from \"../../domain/ir/nodes.js\";\n\n/**\n * The shared `unknown` node. The original compares types with its shared `UNKNOWN` node by\n * identity (a nullable schema whose type *is* that node stays `unknown`), so the transformers use\n * one frozen node for the same cases, and the legacy adapter maps the original constant to it.\n */\nexport const UNKNOWN_TYPE: IrKeywordType = Object.freeze(irKeyword(\"unknown\"));\n"],"names":[],"mappings":";;AAQO,MAAM,YAAA,GAA8B,MAAA,CAAO,MAAA,CAAO,SAAA,CAAU,SAAS,CAAC;;"}

package/dist/application/transform/type-combinators.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+const constructors = require('../../domain/ir/constructors.cjs');
+const normalize = require('../../domain/ir/normalize.cjs');
+const literalType = require('./literal-type.cjs');
+
+function unionOf(types) {
+  if (types.length <= 1) {
+    return types[0] ?? constructors.irKeyword("never");
+  }
+  return constructors.irUnion(normalize.dedupeTypes(types));
+}
+function intersectionOf(types) {
+  if (types.length <= 1) {
+    return types[0] ?? constructors.irKeyword("never");
+  }
+  return constructors.irIntersection(normalize.dedupeTypes(types));
+}
+function nullableOf(types) {
+  return constructors.irUnion([...types, constructors.irKeyword("null")]);
+}
+function omitKeys(type, keys) {
+  return constructors.irReference("Omit", [type, constructors.irUnion(keys.map(literalType.literalType))]);
+}
+function withRequiredKeys(type, keys) {
+  if (keys.length === 0) {
+    return type;
+  }
+  return constructors.irReference("WithRequired", [type, unionOf(keys.map(literalType.literalType))]);
+}
+const PRIMITIVE_KEYWORDS = /* @__PURE__ */ new Set([
+  "boolean",
+  "never",
+  "null",
+  "number",
+  "string",
+  "undefined"
+]);
+function isPrimitiveType(type) {
+  return type.kind === "keyword" && PRIMITIVE_KEYWORDS.has(type.keyword);
+}
+
+exports.intersectionOf = intersectionOf;
+exports.isPrimitiveType = isPrimitiveType;
+exports.nullableOf = nullableOf;
+exports.omitKeys = omitKeys;
+exports.unionOf = unionOf;
+exports.withRequiredKeys = withRequiredKeys;
+//# sourceMappingURL=type-combinators.cjs.map

package/dist/application/transform/type-combinators.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-combinators.cjs","sources":["../../../src/application/transform/type-combinators.ts"],"sourcesContent":["import { irIntersection, irKeyword, irReference, irUnion } from \"../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../domain/ir/nodes.js\";\nimport { dedupeTypes } from \"../../domain/ir/normalize.js\";\nimport { literalType } from \"./literal-type.js\";\n\n/**\n * Type combinators with the original helper semantics (`tsUnion`, `tsIntersection`, `tsOmit`, …).\n * They are the only places where the transformers normalize types.\n */\n\n/** `never` for no types, the type itself for one, else a de-duplicated union (`tsUnion`). */\nexport function unionOf(types: readonly IrType[]): IrType {\n  if (types.length <= 1) {\n    return types[0] ?? irKeyword(\"never\");\n  }\n  return irUnion(dedupeTypes(types));\n}\n\n/** Like `unionOf`, for intersections (`tsIntersection`). */\nexport function intersectionOf(types: readonly IrType[]): IrType {\n  if (types.length <= 1) {\n    return types[0] ?? irKeyword(\"never\");\n  }\n  return irIntersection(dedupeTypes(types));\n}\n\n/** `T | null` without de-duplication (`tsNullable`). */\nexport function nullableOf(types: readonly IrType[]): IrType {\n  return irUnion([...types, irKeyword(\"null\")]);\n}\n\n/** `Omit<T, \"a\" | \"b\">`; the key union is never collapsed or de-duplicated (`tsOmit`). */\nexport function omitKeys(type: IrType, keys: readonly string[]): IrType {\n  return irReference(\"Omit\", [type, irUnion(keys.map(literalType))]);\n}\n\n/** `WithRequired<T, \"a\" | \"b\">`, or the type itself for no keys (`tsWithRequired`). */\nexport function withRequiredKeys(type: IrType, keys: readonly string[]): IrType {\n  if (keys.length === 0) {\n    return type;\n  }\n  return irReference(\"WithRequired\", [type, unionOf(keys.map(literalType))]);\n}\n\n/** Primitive keywords, as the original `tsIsPrimitive` defines them (the null literal included). */\nconst PRIMITIVE_KEYWORDS: ReadonlySet<string> = new Set([\n  \"boolean\",\n  \"never\",\n  \"null\",\n  \"number\",\n  \"string\",\n  \"undefined\",\n]);\n\nexport function isPrimitiveType(type: IrType): boolean {\n  return type.kind === \"keyword\" && PRIMITIVE_KEYWORDS.has(type.keyword);\n}\n"],"names":["irKeyword","irUnion","dedupeTypes","irIntersection","irReference","literalType"],"mappings":";;;;;;AAWO,SAAS,QAAQ,KAAA,EAAkC;AACxD,EAAA,IAAI,KAAA,CAAM,UAAU,CAAA,EAAG;AACrB,IAAA,OAAO,KAAA,CAAM,CAAC,CAAA,IAAKA,sBAAA,CAAU,OAAO,CAAA;AAAA,EACtC;AACA,EAAA,OAAOC,oBAAA,CAAQC,qBAAA,CAAY,KAAK,CAAC,CAAA;AACnC;AAGO,SAAS,eAAe,KAAA,EAAkC;AAC/D,EAAA,IAAI,KAAA,CAAM,UAAU,CAAA,EAAG;AACrB,IAAA,OAAO,KAAA,CAAM,CAAC,CAAA,IAAKF,sBAAA,CAAU,OAAO,CAAA;AAAA,EACtC;AACA,EAAA,OAAOG,2BAAA,CAAeD,qBAAA,CAAY,KAAK,CAAC,CAAA;AAC1C;AAGO,SAAS,WAAW,KAAA,EAAkC;AAC3D,EAAA,OAAOD,qBAAQ,CAAC,GAAG,OAAOD,sBAAA,CAAU,MAAM,CAAC,CAAC,CAAA;AAC9C;AAGO,SAAS,QAAA,CAAS,MAAc,IAAA,EAAiC;AACtE,EAAA,OAAOI,wBAAA,CAAY,MAAA,EAAQ,CAAC,IAAA,EAAMH,oBAAA,CAAQ,KAAK,GAAA,CAAII,uBAAW,CAAC,CAAC,CAAC,CAAA;AACnE;AAGO,SAAS,gBAAA,CAAiB,MAAc,IAAA,EAAiC;AAC9E,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACrB,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAOD,wBAAA,CAAY,cAAA,EAAgB,CAAC,IAAA,EAAM,OAAA,CAAQ,KAAK,GAAA,CAAIC,uBAAW,CAAC,CAAC,CAAC,CAAA;AAC3E;AAGA,MAAM,kBAAA,uBAA8C,GAAA,CAAI;AAAA,EACtD,SAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAC,CAAA;AAEM,SAAS,gBAAgB,IAAA,EAAuB;AACrD,EAAA,OAAO,KAAK,IAAA,KAAS,SAAA,IAAa,kBAAA,CAAmB,GAAA,CAAI,KAAK,OAAO,CAAA;AACvE;;;;;;;"}

package/dist/application/transform/type-combinators.mjs

@@ -0,0 +1,42 @@
+import { irUnion, irKeyword, irIntersection, irReference } from '../../domain/ir/constructors.mjs';
+import { dedupeTypes } from '../../domain/ir/normalize.mjs';
+import { literalType } from './literal-type.mjs';
+
+function unionOf(types) {
+  if (types.length <= 1) {
+    return types[0] ?? irKeyword("never");
+  }
+  return irUnion(dedupeTypes(types));
+}
+function intersectionOf(types) {
+  if (types.length <= 1) {
+    return types[0] ?? irKeyword("never");
+  }
+  return irIntersection(dedupeTypes(types));
+}
+function nullableOf(types) {
+  return irUnion([...types, irKeyword("null")]);
+}
+function omitKeys(type, keys) {
+  return irReference("Omit", [type, irUnion(keys.map(literalType))]);
+}
+function withRequiredKeys(type, keys) {
+  if (keys.length === 0) {
+    return type;
+  }
+  return irReference("WithRequired", [type, unionOf(keys.map(literalType))]);
+}
+const PRIMITIVE_KEYWORDS = /* @__PURE__ */ new Set([
+  "boolean",
+  "never",
+  "null",
+  "number",
+  "string",
+  "undefined"
+]);
+function isPrimitiveType(type) {
+  return type.kind === "keyword" && PRIMITIVE_KEYWORDS.has(type.keyword);
+}
+
+export { intersectionOf, isPrimitiveType, nullableOf, omitKeys, unionOf, withRequiredKeys };
+//# sourceMappingURL=type-combinators.mjs.map

package/dist/application/transform/type-combinators.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-combinators.mjs","sources":["../../../src/application/transform/type-combinators.ts"],"sourcesContent":["import { irIntersection, irKeyword, irReference, irUnion } from \"../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../domain/ir/nodes.js\";\nimport { dedupeTypes } from \"../../domain/ir/normalize.js\";\nimport { literalType } from \"./literal-type.js\";\n\n/**\n * Type combinators with the original helper semantics (`tsUnion`, `tsIntersection`, `tsOmit`, …).\n * They are the only places where the transformers normalize types.\n */\n\n/** `never` for no types, the type itself for one, else a de-duplicated union (`tsUnion`). */\nexport function unionOf(types: readonly IrType[]): IrType {\n  if (types.length <= 1) {\n    return types[0] ?? irKeyword(\"never\");\n  }\n  return irUnion(dedupeTypes(types));\n}\n\n/** Like `unionOf`, for intersections (`tsIntersection`). */\nexport function intersectionOf(types: readonly IrType[]): IrType {\n  if (types.length <= 1) {\n    return types[0] ?? irKeyword(\"never\");\n  }\n  return irIntersection(dedupeTypes(types));\n}\n\n/** `T | null` without de-duplication (`tsNullable`). */\nexport function nullableOf(types: readonly IrType[]): IrType {\n  return irUnion([...types, irKeyword(\"null\")]);\n}\n\n/** `Omit<T, \"a\" | \"b\">`; the key union is never collapsed or de-duplicated (`tsOmit`). */\nexport function omitKeys(type: IrType, keys: readonly string[]): IrType {\n  return irReference(\"Omit\", [type, irUnion(keys.map(literalType))]);\n}\n\n/** `WithRequired<T, \"a\" | \"b\">`, or the type itself for no keys (`tsWithRequired`). */\nexport function withRequiredKeys(type: IrType, keys: readonly string[]): IrType {\n  if (keys.length === 0) {\n    return type;\n  }\n  return irReference(\"WithRequired\", [type, unionOf(keys.map(literalType))]);\n}\n\n/** Primitive keywords, as the original `tsIsPrimitive` defines them (the null literal included). */\nconst PRIMITIVE_KEYWORDS: ReadonlySet<string> = new Set([\n  \"boolean\",\n  \"never\",\n  \"null\",\n  \"number\",\n  \"string\",\n  \"undefined\",\n]);\n\nexport function isPrimitiveType(type: IrType): boolean {\n  return type.kind === \"keyword\" && PRIMITIVE_KEYWORDS.has(type.keyword);\n}\n"],"names":[],"mappings":";;;;AAWO,SAAS,QAAQ,KAAA,EAAkC;AACxD,EAAA,IAAI,KAAA,CAAM,UAAU,CAAA,EAAG;AACrB,IAAA,OAAO,KAAA,CAAM,CAAC,CAAA,IAAK,SAAA,CAAU,OAAO,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,OAAA,CAAQ,WAAA,CAAY,KAAK,CAAC,CAAA;AACnC;AAGO,SAAS,eAAe,KAAA,EAAkC;AAC/D,EAAA,IAAI,KAAA,CAAM,UAAU,CAAA,EAAG;AACrB,IAAA,OAAO,KAAA,CAAM,CAAC,CAAA,IAAK,SAAA,CAAU,OAAO,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,cAAA,CAAe,WAAA,CAAY,KAAK,CAAC,CAAA;AAC1C;AAGO,SAAS,WAAW,KAAA,EAAkC;AAC3D,EAAA,OAAO,QAAQ,CAAC,GAAG,OAAO,SAAA,CAAU,MAAM,CAAC,CAAC,CAAA;AAC9C;AAGO,SAAS,QAAA,CAAS,MAAc,IAAA,EAAiC;AACtE,EAAA,OAAO,WAAA,CAAY,MAAA,EAAQ,CAAC,IAAA,EAAM,OAAA,CAAQ,KAAK,GAAA,CAAI,WAAW,CAAC,CAAC,CAAC,CAAA;AACnE;AAGO,SAAS,gBAAA,CAAiB,MAAc,IAAA,EAAiC;AAC9E,EAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACrB,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,WAAA,CAAY,cAAA,EAAgB,CAAC,IAAA,EAAM,OAAA,CAAQ,KAAK,GAAA,CAAI,WAAW,CAAC,CAAC,CAAC,CAAA;AAC3E;AAGA,MAAM,kBAAA,uBAA8C,GAAA,CAAI;AAAA,EACtD,SAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAC,CAAA;AAEM,SAAS,gBAAgB,IAAA,EAAuB;AACrD,EAAA,OAAO,KAAK,IAAA,KAAS,SAAA,IAAa,kBAAA,CAAmB,GAAA,CAAI,KAAK,OAAO,CAAA;AACvE;;"}

package/dist/cli/cli-arguments.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+const scule = require('scule');
+const parser = require('yargs-parser');
+const cliErrors = require('./cli-errors.cjs');
+const fixOption = require('./fix-option.cjs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const parser__default = /*#__PURE__*/_interopDefaultCompat(parser);
+
+const GENERATOR_FLAGS = [
+  "additionalProperties",
+  "alphabetize",
+  "arrayLength",
+  "binaryAsBlob",
+  "conditionalEnums",
+  "dedupeEnums",
+  "defaultNonNullable",
+  "emptyObjectsUnknown",
+  "enum",
+  "enumValues",
+  "excludeDeprecated",
+  "exportType",
+  "generatePathParams",
+  "immutable",
+  "lint",
+  "makePathsEnum",
+  "pathParamsAsTypes",
+  "propertiesRequiredByDefault",
+  "readWriteMarkers",
+  "rootTypes",
+  "rootTypesKeepCasing",
+  "rootTypesNoSchemaPrefix"
+];
+const CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, "check", "contentNever", "help"];
+const BOOLEAN_FLAGS = [
+  ...CAMEL_CASE_BOOLEAN_FLAGS,
+  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => scule.kebabCase(flag))
+];
+const REMOVED_FLAGS = [
+  ["-ap", `The -ap alias has been deprecated. Use "--additional-properties" instead.`],
+  ["--immutable-types", `The --immutable-types flag has been renamed to "--immutable".`],
+  [
+    "--support-array-length",
+    `The --support-array-length flag has been renamed to "--array-length".`
+  ],
+  ["-it", `The -it alias has been deprecated. Use "--immutable" instead.`],
+  ["--redoc", `The --redoc config flag has been renamed to "--redocly" (or -c as shorthand).`]
+];
+const ROOT_TYPES_FLAGS = ["--root-types-no-schema-prefix", "--root-types-keep-casing"];
+function rejectRemovedFlags(argv) {
+  for (const [flag, message] of REMOVED_FLAGS) {
+    if (argv.includes(flag)) {
+      throw cliErrors.cliError("CLI_FLAG_REMOVED", message);
+    }
+  }
+}
+function ineffectiveFlagNotices(argv) {
+  if (argv.includes("--root-types")) {
+    return [];
+  }
+  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(
+    (flag) => `${flag} has no effect without --root-types flag`
+  );
+}
+function generatorFlagsOf(parsed) {
+  const flags = {};
+  for (const name of GENERATOR_FLAGS) {
+    if (typeof parsed[name] === "boolean") {
+      flags[name] = parsed[name];
+    }
+  }
+  return flags;
+}
+function optionalString(value) {
+  return value === void 0 ? void 0 : String(value);
+}
+function lastString(value) {
+  return optionalString(Array.isArray(value) ? value.at(-1) : value);
+}
+function hostList(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return [value].flat().flatMap((entry) => String(entry).split(",")).map((host) => host.trim()).filter((host) => host !== "");
+}
+function refLimitsOf(parsed) {
+  const localRefRoot = lastString(parsed.localRefRoot);
+  const remoteRefHosts = hostList(parsed.remoteRefHosts);
+  return {
+    ...localRefRoot === void 0 ? {} : { localRefRoot },
+    ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
+  };
+}
+const STRING_FLAGS = [
+  "output",
+  "redocly",
+  "fix",
+  ...["localRefRoot", "remoteRefHosts"].flatMap((flag) => [flag, scule.kebabCase(flag)])
+];
+const ALIASES = { redocly: ["c"], exportType: ["t"], output: ["o"] };
+const KNOWN_FLAGS = /* @__PURE__ */ new Set([
+  ...BOOLEAN_FLAGS,
+  ...STRING_FLAGS,
+  ...Object.values(ALIASES).flat(),
+  "version"
+]);
+function unknownFlagsOf(parsed) {
+  const names = Object.keys(parsed).filter((key) => key !== "_" && key !== "--" && !KNOWN_FLAGS.has(key)).map((key) => key.length === 1 ? `-${key}` : `--${scule.kebabCase(key)}`);
+  return [...new Set(names)];
+}
+function parseCliArguments(argv) {
+  rejectRemovedFlags(argv);
+  const parsed = parser__default([...argv], {
+    boolean: BOOLEAN_FLAGS,
+    string: STRING_FLAGS,
+    alias: ALIASES
+  });
+  return {
+    input: optionalString(parsed._[0]),
+    output: optionalString(parsed.output),
+    redocly: optionalString(parsed.redocly),
+    isCheck: parsed.check === true,
+    isHelp: "help" in parsed,
+    isVersion: "version" in parsed,
+    generatorFlags: generatorFlagsOf(parsed),
+    refLimits: refLimitsOf(parsed),
+    fix: fixOption.fixNamesOf(parsed.fix),
+    unknownFlags: unknownFlagsOf(parsed)
+  };
+}
+
+exports.GENERATOR_FLAGS = GENERATOR_FLAGS;
+exports.ineffectiveFlagNotices = ineffectiveFlagNotices;
+exports.parseCliArguments = parseCliArguments;
+//# sourceMappingURL=cli-arguments.cjs.map

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

@@ -0,0 +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): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => (key.length === 1 ? `-${key}` : `--${kebabCase(key)}`));\n  return [...new Set(names)];\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),\n  };\n}\n"],"names":["kebabCase","cliError","parser","fixNamesOf"],"mappings":"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"}

package/dist/cli/cli-arguments.mjs

@@ -0,0 +1,129 @@
+import { kebabCase } from 'scule';
+import parser from 'yargs-parser';
+import { cliError } from './cli-errors.mjs';
+import { fixNamesOf } from './fix-option.mjs';
+
+const GENERATOR_FLAGS = [
+  "additionalProperties",
+  "alphabetize",
+  "arrayLength",
+  "binaryAsBlob",
+  "conditionalEnums",
+  "dedupeEnums",
+  "defaultNonNullable",
+  "emptyObjectsUnknown",
+  "enum",
+  "enumValues",
+  "excludeDeprecated",
+  "exportType",
+  "generatePathParams",
+  "immutable",
+  "lint",
+  "makePathsEnum",
+  "pathParamsAsTypes",
+  "propertiesRequiredByDefault",
+  "readWriteMarkers",
+  "rootTypes",
+  "rootTypesKeepCasing",
+  "rootTypesNoSchemaPrefix"
+];
+const CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, "check", "contentNever", "help"];
+const BOOLEAN_FLAGS = [
+  ...CAMEL_CASE_BOOLEAN_FLAGS,
+  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag))
+];
+const REMOVED_FLAGS = [
+  ["-ap", `The -ap alias has been deprecated. Use "--additional-properties" instead.`],
+  ["--immutable-types", `The --immutable-types flag has been renamed to "--immutable".`],
+  [
+    "--support-array-length",
+    `The --support-array-length flag has been renamed to "--array-length".`
+  ],
+  ["-it", `The -it alias has been deprecated. Use "--immutable" instead.`],
+  ["--redoc", `The --redoc config flag has been renamed to "--redocly" (or -c as shorthand).`]
+];
+const ROOT_TYPES_FLAGS = ["--root-types-no-schema-prefix", "--root-types-keep-casing"];
+function rejectRemovedFlags(argv) {
+  for (const [flag, message] of REMOVED_FLAGS) {
+    if (argv.includes(flag)) {
+      throw cliError("CLI_FLAG_REMOVED", message);
+    }
+  }
+}
+function ineffectiveFlagNotices(argv) {
+  if (argv.includes("--root-types")) {
+    return [];
+  }
+  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(
+    (flag) => `${flag} has no effect without --root-types flag`
+  );
+}
+function generatorFlagsOf(parsed) {
+  const flags = {};
+  for (const name of GENERATOR_FLAGS) {
+    if (typeof parsed[name] === "boolean") {
+      flags[name] = parsed[name];
+    }
+  }
+  return flags;
+}
+function optionalString(value) {
+  return value === void 0 ? void 0 : String(value);
+}
+function lastString(value) {
+  return optionalString(Array.isArray(value) ? value.at(-1) : value);
+}
+function hostList(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return [value].flat().flatMap((entry) => String(entry).split(",")).map((host) => host.trim()).filter((host) => host !== "");
+}
+function refLimitsOf(parsed) {
+  const localRefRoot = lastString(parsed.localRefRoot);
+  const remoteRefHosts = hostList(parsed.remoteRefHosts);
+  return {
+    ...localRefRoot === void 0 ? {} : { localRefRoot },
+    ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
+  };
+}
+const STRING_FLAGS = [
+  "output",
+  "redocly",
+  "fix",
+  ...["localRefRoot", "remoteRefHosts"].flatMap((flag) => [flag, kebabCase(flag)])
+];
+const ALIASES = { redocly: ["c"], exportType: ["t"], output: ["o"] };
+const KNOWN_FLAGS = /* @__PURE__ */ new Set([
+  ...BOOLEAN_FLAGS,
+  ...STRING_FLAGS,
+  ...Object.values(ALIASES).flat(),
+  "version"
+]);
+function unknownFlagsOf(parsed) {
+  const names = Object.keys(parsed).filter((key) => key !== "_" && key !== "--" && !KNOWN_FLAGS.has(key)).map((key) => key.length === 1 ? `-${key}` : `--${kebabCase(key)}`);
+  return [...new Set(names)];
+}
+function parseCliArguments(argv) {
+  rejectRemovedFlags(argv);
+  const parsed = parser([...argv], {
+    boolean: BOOLEAN_FLAGS,
+    string: STRING_FLAGS,
+    alias: ALIASES
+  });
+  return {
+    input: optionalString(parsed._[0]),
+    output: optionalString(parsed.output),
+    redocly: optionalString(parsed.redocly),
+    isCheck: parsed.check === true,
+    isHelp: "help" in parsed,
+    isVersion: "version" in parsed,
+    generatorFlags: generatorFlagsOf(parsed),
+    refLimits: refLimitsOf(parsed),
+    fix: fixNamesOf(parsed.fix),
+    unknownFlags: unknownFlagsOf(parsed)
+  };
+}
+
+export { GENERATOR_FLAGS, ineffectiveFlagNotices, parseCliArguments };
+//# sourceMappingURL=cli-arguments.mjs.map

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

@@ -0,0 +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): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => (key.length === 1 ? `-${key}` : `--${kebabCase(key)}`));\n  return [...new Set(names)];\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),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/cli-errors.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+const errors = require('../domain/errors.cjs');
+
+const EXIT_CODES = {
+  SUCCESS: 0,
+  /** `--check` found output that differs from the generated types (as in the original CLI). */
+  OUTPUT_STALE: 1,
+  /** A flag, the Redocly config, the environment or a callback is wrong. */
+  USAGE: 2,
+  /** The OpenAPI document cannot be read, is invalid, or cannot be converted. */
+  SCHEMA: 3,
+  /** An output file cannot be read or written. */
+  OUTPUT: 4,
+  /** An unexpected failure: a bug in the generator (sysexits `EX_SOFTWARE`). */
+  INTERNAL: 70
+};
+function schemaInvalidMessage(error) {
+  const count = Array.isArray(error.details.problems) ? error.details.problems.length : 1;
+  return `The OpenAPI document has ${count} ${count === 1 ? "error" : "errors"} (see above)`;
+}
+function loadFailedMessage(error) {
+  const reason = error.cause instanceof Error ? error.cause.cause : void 0;
+  if (!(reason instanceof Error)) {
+    return error.message;
+  }
+  const source = typeof error.details.source === "string" ? ` (${error.details.source})` : "";
+  return `${error.message}: ${reason.message}${source}`;
+}
+const YAML_DEPTH_LIMIT_MESSAGE = /nesting exceeded maxDepth \((\d+)\)/;
+function parseFailedMessage(error) {
+  const limit = YAML_DEPTH_LIMIT_MESSAGE.exec(error.message)?.[1];
+  if (limit === void 0) {
+    return error.message;
+  }
+  return `${error.message}. The YAML parser reads at most ${limit} nested levels: move nested schemas to \`components\` and reference them with \`$ref\``;
+}
+const CLI_ERROR_REPORTS = {
+  SCHEMA_SOURCE_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_SOURCE_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_LOAD_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: loadFailedMessage },
+  SCHEMA_PARSE_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: parseFailedMessage },
+  SCHEMA_VERSION_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: schemaInvalidMessage },
+  SCHEMA_REF_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_REF_FORBIDDEN: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_OBJECT_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_PROPERTY_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_TOO_DEEP: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_KEY_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },
+  ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
+  CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },
+  OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },
+  TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
+  CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },
+  CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  OUTPUT_STALE: { exitCode: EXIT_CODES.OUTPUT_STALE },
+  OUTPUT_READ_FAILED: { exitCode: EXIT_CODES.OUTPUT },
+  OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT }
+};
+function describeCliFailure(error) {
+  if (!errors.isOpenAPITypesafeError(error)) {
+    const text = error instanceof Error ? error.stack ?? error.message : String(error);
+    return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };
+  }
+  const report = CLI_ERROR_REPORTS[error.code];
+  const message = report.message?.(error) ?? error.message;
+  return { exitCode: report.exitCode, message: `${message} (${error.code})` };
+}
+function cliError(code, message, cause) {
+  return new errors.OpenAPITypesafeError({ code: errors.ERROR_CODES[code], message, cause });
+}
+
+exports.EXIT_CODES = EXIT_CODES;
+exports.cliError = cliError;
+exports.describeCliFailure = describeCliFailure;
+//# sourceMappingURL=cli-errors.cjs.map