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

package/dist/cli/help-text.cjs

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

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

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

package/dist/cli/help-text.mjs

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

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

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

package/dist/cli/main.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 const fs = require('node:fs');
+const node_tty = require('node:tty');
 const node_url = require('node:url');
 const colors = require('ansi-colors');
 const nodeFileSystem = require('../adapters/node-file-system/node-file-system.cjs');
@@ -31,6 +32,7 @@ function terminalStyle() {
     dim: (text) => palette.dim(text)
   };
 }
+const STDIN_DESCRIPTOR = 0;
 const generateTypes = async (source, options) => `${commentHeader.COMMENT_HEADER}${astToString.astToString(await openapiTs.default(source, options))}`;
 function terminalConsole() {
   return {
@@ -49,6 +51,9 @@ function processDependencies() {
     console: terminalConsole(),
     writeStdout: (text) => process.stdout.write(text),
     stdin: () => process.stdin,
+    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the
+    // process alive.
+    isStdinTerminal: () => node_tty.isatty(STDIN_DESCRIPTOR),
     files: nodeFileSystem.createNodeFileSystem(),
     redoclyConfigs: redoclyConfigSource.createRedoclyConfigSource(cwd),
     generate: generateTypes,

package/dist/cli/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport openapiTS from \"../api/openapi-ts.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst generateTypes: GenerateTypes = async (source, options) =>\n  `${COMMENT_HEADER}${astToString(await openapiTS(source, options))}`;\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(text),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: (text) => process.stdout.write(text),\n    stdin: () => process.stdin,\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":["fs","colors","terminalSupportsColor","COMMENT_HEADER","astToString","openapiTS","pathToFileURL","defaultLogger","createNodeFileSystem","createRedoclyConfigSource","monotonicNow","runCli"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,8PAAe,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAMA,YAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAUC,gBAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAUC,kCAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,KAClD,CAAA,EAAGC,4BAAc,CAAA,EAAGC,uBAAA,CAAY,MAAMC,iBAAA,CAAU,MAAA,EAAQ,OAAO,CAAC,CAAC,CAAA,CAAA;AAEnE,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,IAEjC,MAAA,EAAQ,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI;AAAA,GACrC;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAKC,sBAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQC,2BAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,aAAa,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA,IACrB,OAAOC,mCAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgBC,8CAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAKC,yBAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEAC,aAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"main.cjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { isatty } from \"node:tty\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport openapiTS from \"../api/openapi-ts.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst STDIN_DESCRIPTOR = 0;\n\nconst generateTypes: GenerateTypes = async (source, options) =>\n  `${COMMENT_HEADER}${astToString(await openapiTS(source, options))}`;\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(text),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: (text) => process.stdout.write(text),\n    stdin: () => process.stdin,\n    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the\n    // process alive.\n    isStdinTerminal: () => isatty(STDIN_DESCRIPTOR),\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":["fs","colors","terminalSupportsColor","COMMENT_HEADER","astToString","openapiTS","pathToFileURL","defaultLogger","isatty","createNodeFileSystem","createRedoclyConfigSource","monotonicNow","runCli"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,8PAAe,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAMA,YAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAUC,gBAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAUC,kCAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,gBAAA,GAAmB,CAAA;AAEzB,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,KAClD,CAAA,EAAGC,4BAAc,CAAA,EAAGC,uBAAA,CAAY,MAAMC,iBAAA,CAAU,MAAA,EAAQ,OAAO,CAAC,CAAC,CAAA,CAAA;AAEnE,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,IAEjC,MAAA,EAAQ,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI;AAAA,GACrC;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAKC,sBAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQC,2BAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,aAAa,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA;AAAA;AAAA,IAGrB,eAAA,EAAiB,MAAMC,eAAA,CAAO,gBAAgB,CAAA;AAAA,IAC9C,OAAOC,mCAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgBC,8CAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAKC,yBAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEAC,aAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}

package/dist/cli/main.mjs

@@ -1,4 +1,5 @@
 import fs from 'node:fs';
+import { isatty } from 'node:tty';
 import { pathToFileURL } from 'node:url';
 import colors from 'ansi-colors';
 import { createNodeFileSystem } from '../adapters/node-file-system/node-file-system.mjs';
@@ -23,6 +24,7 @@ function terminalStyle() {
     dim: (text) => palette.dim(text)
   };
 }
+const STDIN_DESCRIPTOR = 0;
 const generateTypes = async (source, options) => `${COMMENT_HEADER}${astToString(await openapiTS(source, options))}`;
 function terminalConsole() {
   return {
@@ -41,6 +43,9 @@ function processDependencies() {
     console: terminalConsole(),
     writeStdout: (text) => process.stdout.write(text),
     stdin: () => process.stdin,
+    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the
+    // process alive.
+    isStdinTerminal: () => isatty(STDIN_DESCRIPTOR),
     files: createNodeFileSystem(),
     redoclyConfigs: createRedoclyConfigSource(cwd),
     generate: generateTypes,

package/dist/cli/main.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.mjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport openapiTS from \"../api/openapi-ts.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst generateTypes: GenerateTypes = async (source, options) =>\n  `${COMMENT_HEADER}${astToString(await openapiTS(source, options))}`;\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(text),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: (text) => process.stdout.write(text),\n    stdin: () => process.stdin,\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":[],"mappings":";;;;;;;;;;;AAkBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,YAAY,GAAG,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAU,OAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAU,qBAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,KAClD,CAAA,EAAG,cAAc,CAAA,EAAG,WAAA,CAAY,MAAM,SAAA,CAAU,MAAA,EAAQ,OAAO,CAAC,CAAC,CAAA,CAAA;AAEnE,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,IAEjC,MAAA,EAAQ,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI;AAAA,GACrC;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQ,cAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,aAAa,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA,IACrB,OAAO,oBAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgB,0BAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAK,YAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEA,MAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"main.mjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { isatty } from \"node:tty\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport openapiTS from \"../api/openapi-ts.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst STDIN_DESCRIPTOR = 0;\n\nconst generateTypes: GenerateTypes = async (source, options) =>\n  `${COMMENT_HEADER}${astToString(await openapiTS(source, options))}`;\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(text),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: (text) => process.stdout.write(text),\n    stdin: () => process.stdin,\n    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the\n    // process alive.\n    isStdinTerminal: () => isatty(STDIN_DESCRIPTOR),\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":[],"mappings":";;;;;;;;;;;;AAmBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,YAAY,GAAG,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAU,OAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAU,qBAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,gBAAA,GAAmB,CAAA;AAEzB,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,KAClD,CAAA,EAAG,cAAc,CAAA,EAAG,WAAA,CAAY,MAAM,SAAA,CAAU,MAAA,EAAQ,OAAO,CAAC,CAAC,CAAA,CAAA;AAEnE,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,IAEjC,MAAA,EAAQ,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI;AAAA,GACrC;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQ,cAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,aAAa,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA;AAAA;AAAA,IAGrB,eAAA,EAAiB,MAAM,MAAA,CAAO,gBAAgB,CAAA;AAAA,IAC9C,OAAO,oBAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgB,0BAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAK,YAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEA,MAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}

package/dist/cli/redocly-apis.cjs

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

package/dist/cli/redocly-apis.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"redocly-apis.cjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport { GENERATOR_FLAGS, type GeneratorFlags } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveFileUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf, fixOption } from \"./fix-option.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/** The `apis` of a Redocly config: each API is generated into its `x-openapi-ts.output`. */\n\n/** The key of an API's openapi-typesafe settings in `redocly.yaml`. */\nconst REDOCLY_CONFIG_KEY = \"x-openapi-ts\";\n\n/** The setting of an API that lists its output fixes. */\nconst FIX_SETTING = \"fix\";\n\ntype ApiSettings = Readonly<Record<string, unknown>>;\n\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings | undefined;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const settings = (api as Record<string, unknown>)[REDOCLY_CONFIG_KEY];\n    return { name, root: api.root, settings: settings as ApiSettings | undefined };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** The boolean flags an API sets, in camelCase or kebab-case; they win over the CLI's flags. */\nfunction apiFlags(settings: ApiSettings): GeneratorFlags {\n  const flags: Partial<Record<(typeof GENERATOR_FLAGS)[number], boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    const value = typeof settings[name] === \"boolean\" ? settings[name] : settings[kebabCase(name)];\n    if (typeof value === \"boolean\") {\n      flags[name] = value;\n    }\n  }\n  return flags;\n}\n\n/** The API's `fix` names; they replace the CLI's `--fix`, as its boolean settings win (ADR-021). */\nfunction apiFixNames(settings: ApiSettings): readonly OutputFixName[] | undefined {\n  return fixNamesOf(settings[FIX_SETTING]);\n}\n\n/** Paths in the config are relative to the config file; without a file, to the working dir. */\nfunction configRootOf(redocly: RedoclyConfig, cwd: URL): URL {\n  return redocly.configFile ? resolveFileUrl(redocly.configFile, cwd) : cwd;\n}\n\nasync function generateApi(run: CliRun, redocly: RedoclyConfig, api: RedoclyApi): Promise<void> {\n  if (!api.settings?.output) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${api.name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  const output = String(api.settings.output);\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const options: GeneratorOptions = {\n    ...run.args.generatorFlags,\n    ...apiFlags(api.settings),\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(apiFixNames(api.settings) ?? run.args.fix),\n    redocly,\n  };\n  const contents = await run.deps.generate(new URL(api.root, configRoot), options);\n  emitOutput(run, { source: api.name, output, file: new URL(output, configRoot) }, contents);\n}\n\n/**\n * Generate every API of the config, concurrently. Every API is generated or checked even when\n * another fails, so `--check` reports a stale output wherever it is; the failures are returned\n * in the order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const results = await Promise.allSettled(apis.map((api) => generateApi(run, redocly, api)));\n  return results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n}\n"],"names":["GENERATOR_FLAGS","kebabCase","fixNamesOf","resolveFileUrl","cliError","MULTIPLE_SCHEMAS_DOCS_URL","refLimitOptions","fixOption","emitOutput"],"mappings":"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"}
+{"version":3,"file":"redocly-apis.cjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport {\n  type ApiSettings,\n  apiRefLimitOptions,\n  FIX_SETTING,\n  OUTPUT_SETTING,\n  unknownSettingWarnings,\n} from \"./api-settings.js\";\nimport { GENERATOR_FLAGS, type GeneratorFlags } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveLocationUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf, fixOption } from \"./fix-option.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/** The `apis` of a Redocly config: each API is generated into its `x-openapi-ts.output`. */\n\n/** The key of an API's openapi-typesafe settings in `redocly.yaml`. */\nconst REDOCLY_CONFIG_KEY = \"x-openapi-ts\";\n\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings | undefined;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const settings = (api as Record<string, unknown>)[REDOCLY_CONFIG_KEY];\n    return { name, root: api.root, settings: settings as ApiSettings | undefined };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** The boolean flags an API sets, in camelCase or kebab-case; they win over the CLI's flags. */\nfunction apiFlags(settings: ApiSettings): GeneratorFlags {\n  const flags: Partial<Record<(typeof GENERATOR_FLAGS)[number], boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    const value = typeof settings[name] === \"boolean\" ? settings[name] : settings[kebabCase(name)];\n    if (typeof value === \"boolean\") {\n      flags[name] = value;\n    }\n  }\n  return flags;\n}\n\n/** The API's `fix` names; they replace the CLI's `--fix`, as its boolean settings win (ADR-021). */\nfunction apiFixNames(settings: ApiSettings): readonly OutputFixName[] | undefined {\n  return fixNamesOf(settings[FIX_SETTING]);\n}\n\n/** Paths in the config are relative to the config file; without a file, to the working dir. */\nfunction configRootOf(redocly: RedoclyConfig, cwd: URL): URL {\n  return redocly.configFile ? resolveLocationUrl(redocly.configFile, cwd) : cwd;\n}\n\nasync function generateApi(run: CliRun, redocly: RedoclyConfig, api: RedoclyApi): Promise<void> {\n  if (!api.settings?.[OUTPUT_SETTING]) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${api.name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  for (const warning of unknownSettingWarnings(api.name, api.settings)) {\n    run.deps.logger.warn(warning);\n  }\n  const output = String(api.settings[OUTPUT_SETTING]);\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const options: GeneratorOptions = {\n    ...run.args.generatorFlags,\n    ...apiFlags(api.settings),\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...apiRefLimitOptions(api.name, api.settings, configRoot),\n    ...fixOption(apiFixNames(api.settings) ?? run.args.fix),\n    redocly,\n  };\n  const contents = await run.deps.generate(resolveLocationUrl(api.root, configRoot), options);\n  emitOutput(\n    run,\n    { source: api.name, output, file: resolveLocationUrl(output, configRoot) },\n    contents,\n  );\n}\n\n/**\n * Generate every API of the config, concurrently. Every API is generated or checked even when\n * another fails, so `--check` reports a stale output wherever it is; the failures are returned\n * in the order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const results = await Promise.allSettled(apis.map((api) => generateApi(run, redocly, api)));\n  return results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n}\n"],"names":["GENERATOR_FLAGS","kebabCase","fixNamesOf","FIX_SETTING","resolveLocationUrl","OUTPUT_SETTING","cliError","MULTIPLE_SCHEMAS_DOCS_URL","unknownSettingWarnings","refLimitOptions","apiRefLimitOptions","fixOption","emitOutput"],"mappings":"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"}

package/dist/cli/redocly-apis.mjs

@@ -1,13 +1,13 @@
 import { kebabCase } from 'scule';
+import { OUTPUT_SETTING, unknownSettingWarnings, apiRefLimitOptions, FIX_SETTING } from './api-settings.mjs';
 import { GENERATOR_FLAGS } from './cli-arguments.mjs';
 import { cliError } from './cli-errors.mjs';
-import { emitOutput, resolveFileUrl } from './cli-output.mjs';
+import { resolveLocationUrl, emitOutput } from './cli-output.mjs';
 import { MULTIPLE_SCHEMAS_DOCS_URL } from './docs-links.mjs';
 import { fixOption, fixNamesOf } from './fix-option.mjs';
 import { refLimitOptions } from './ref-limits.mjs';
 
 const REDOCLY_CONFIG_KEY = "x-openapi-ts";
-const FIX_SETTING = "fix";
 function redoclyApisOf(redocly) {
   return Object.entries(redocly.apis ?? {}).map(([name, api]) => {
     const settings = api[REDOCLY_CONFIG_KEY];
@@ -31,26 +31,34 @@ function apiFixNames(settings) {
   return fixNamesOf(settings[FIX_SETTING]);
 }
 function configRootOf(redocly, cwd) {
-  return redocly.configFile ? resolveFileUrl(redocly.configFile, cwd) : cwd;
+  return redocly.configFile ? resolveLocationUrl(redocly.configFile, cwd) : cwd;
 }
 async function generateApi(run, redocly, api) {
-  if (!api.settings?.output) {
+  if (!api.settings?.[OUTPUT_SETTING]) {
     throw cliError(
       "CLI_CONFIG_OUTPUT_MISSING",
       `API ${api.name} is missing an \`${REDOCLY_CONFIG_KEY}.output\` key. See ${MULTIPLE_SCHEMAS_DOCS_URL}`
     );
   }
-  const output = String(api.settings.output);
+  for (const warning of unknownSettingWarnings(api.name, api.settings)) {
+    run.deps.logger.warn(warning);
+  }
+  const output = String(api.settings[OUTPUT_SETTING]);
   const configRoot = configRootOf(redocly, run.deps.cwd);
   const options = {
     ...run.args.generatorFlags,
     ...apiFlags(api.settings),
     ...refLimitOptions(run.args, run.deps.cwd),
+    ...apiRefLimitOptions(api.name, api.settings, configRoot),
     ...fixOption(apiFixNames(api.settings) ?? run.args.fix),
     redocly
   };
-  const contents = await run.deps.generate(new URL(api.root, configRoot), options);
-  emitOutput(run, { source: api.name, output, file: new URL(output, configRoot) }, contents);
+  const contents = await run.deps.generate(resolveLocationUrl(api.root, configRoot), options);
+  emitOutput(
+    run,
+    { source: api.name, output, file: resolveLocationUrl(output, configRoot) },
+    contents
+  );
 }
 async function generateRedoclyApis(run, redocly) {
   const apis = redoclyApisOf(redocly);

package/dist/cli/redocly-apis.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"redocly-apis.mjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport { GENERATOR_FLAGS, type GeneratorFlags } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveFileUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf, fixOption } from \"./fix-option.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/** The `apis` of a Redocly config: each API is generated into its `x-openapi-ts.output`. */\n\n/** The key of an API's openapi-typesafe settings in `redocly.yaml`. */\nconst REDOCLY_CONFIG_KEY = \"x-openapi-ts\";\n\n/** The setting of an API that lists its output fixes. */\nconst FIX_SETTING = \"fix\";\n\ntype ApiSettings = Readonly<Record<string, unknown>>;\n\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings | undefined;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const settings = (api as Record<string, unknown>)[REDOCLY_CONFIG_KEY];\n    return { name, root: api.root, settings: settings as ApiSettings | undefined };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** The boolean flags an API sets, in camelCase or kebab-case; they win over the CLI's flags. */\nfunction apiFlags(settings: ApiSettings): GeneratorFlags {\n  const flags: Partial<Record<(typeof GENERATOR_FLAGS)[number], boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    const value = typeof settings[name] === \"boolean\" ? settings[name] : settings[kebabCase(name)];\n    if (typeof value === \"boolean\") {\n      flags[name] = value;\n    }\n  }\n  return flags;\n}\n\n/** The API's `fix` names; they replace the CLI's `--fix`, as its boolean settings win (ADR-021). */\nfunction apiFixNames(settings: ApiSettings): readonly OutputFixName[] | undefined {\n  return fixNamesOf(settings[FIX_SETTING]);\n}\n\n/** Paths in the config are relative to the config file; without a file, to the working dir. */\nfunction configRootOf(redocly: RedoclyConfig, cwd: URL): URL {\n  return redocly.configFile ? resolveFileUrl(redocly.configFile, cwd) : cwd;\n}\n\nasync function generateApi(run: CliRun, redocly: RedoclyConfig, api: RedoclyApi): Promise<void> {\n  if (!api.settings?.output) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${api.name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  const output = String(api.settings.output);\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const options: GeneratorOptions = {\n    ...run.args.generatorFlags,\n    ...apiFlags(api.settings),\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(apiFixNames(api.settings) ?? run.args.fix),\n    redocly,\n  };\n  const contents = await run.deps.generate(new URL(api.root, configRoot), options);\n  emitOutput(run, { source: api.name, output, file: new URL(output, configRoot) }, contents);\n}\n\n/**\n * Generate every API of the config, concurrently. Every API is generated or checked even when\n * another fails, so `--check` reports a stale output wherever it is; the failures are returned\n * in the order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const results = await Promise.allSettled(apis.map((api) => generateApi(run, redocly, api)));\n  return results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"redocly-apis.mjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport {\n  type ApiSettings,\n  apiRefLimitOptions,\n  FIX_SETTING,\n  OUTPUT_SETTING,\n  unknownSettingWarnings,\n} from \"./api-settings.js\";\nimport { GENERATOR_FLAGS, type GeneratorFlags } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveLocationUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf, fixOption } from \"./fix-option.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/** The `apis` of a Redocly config: each API is generated into its `x-openapi-ts.output`. */\n\n/** The key of an API's openapi-typesafe settings in `redocly.yaml`. */\nconst REDOCLY_CONFIG_KEY = \"x-openapi-ts\";\n\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings | undefined;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const settings = (api as Record<string, unknown>)[REDOCLY_CONFIG_KEY];\n    return { name, root: api.root, settings: settings as ApiSettings | undefined };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** The boolean flags an API sets, in camelCase or kebab-case; they win over the CLI's flags. */\nfunction apiFlags(settings: ApiSettings): GeneratorFlags {\n  const flags: Partial<Record<(typeof GENERATOR_FLAGS)[number], boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    const value = typeof settings[name] === \"boolean\" ? settings[name] : settings[kebabCase(name)];\n    if (typeof value === \"boolean\") {\n      flags[name] = value;\n    }\n  }\n  return flags;\n}\n\n/** The API's `fix` names; they replace the CLI's `--fix`, as its boolean settings win (ADR-021). */\nfunction apiFixNames(settings: ApiSettings): readonly OutputFixName[] | undefined {\n  return fixNamesOf(settings[FIX_SETTING]);\n}\n\n/** Paths in the config are relative to the config file; without a file, to the working dir. */\nfunction configRootOf(redocly: RedoclyConfig, cwd: URL): URL {\n  return redocly.configFile ? resolveLocationUrl(redocly.configFile, cwd) : cwd;\n}\n\nasync function generateApi(run: CliRun, redocly: RedoclyConfig, api: RedoclyApi): Promise<void> {\n  if (!api.settings?.[OUTPUT_SETTING]) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${api.name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  for (const warning of unknownSettingWarnings(api.name, api.settings)) {\n    run.deps.logger.warn(warning);\n  }\n  const output = String(api.settings[OUTPUT_SETTING]);\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const options: GeneratorOptions = {\n    ...run.args.generatorFlags,\n    ...apiFlags(api.settings),\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...apiRefLimitOptions(api.name, api.settings, configRoot),\n    ...fixOption(apiFixNames(api.settings) ?? run.args.fix),\n    redocly,\n  };\n  const contents = await run.deps.generate(resolveLocationUrl(api.root, configRoot), options);\n  emitOutput(\n    run,\n    { source: api.name, output, file: resolveLocationUrl(output, configRoot) },\n    contents,\n  );\n}\n\n/**\n * Generate every API of the config, concurrently. Every API is generated or checked even when\n * another fails, so `--check` reports a stale output wherever it is; the failures are returned\n * in the order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const results = await Promise.allSettled(apis.map((api) => generateApi(run, redocly, api)));\n  return results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/ref-limits.cjs

@@ -5,7 +5,7 @@ const cliOutput = require('./cli-output.cjs');
 function refLimitOptions(args, cwd) {
   const { localRefRoot, remoteRefHosts } = args.refLimits;
   return {
-    ...localRefRoot === void 0 ? {} : { localRefRoot: cliOutput.resolveFileUrl(localRefRoot, cwd) },
+    ...localRefRoot === void 0 ? {} : { localRefRoot: cliOutput.resolveLocationUrl(localRefRoot, cwd) },
     ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
   };
 }

package/dist/cli/ref-limits.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ref-limits.cjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { resolveFileUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\n/** `--local-ref-root` resolves against the working directory, like every other CLI path. */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot: resolveFileUrl(localRefRoot, cwd) }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":["resolveFileUrl"],"mappings":";;;;AASO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,OAAO;AAAA,IACL,GAAI,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAcA,wBAAA,CAAe,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IACxF,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}
+{"version":3,"file":"ref-limits.cjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\n/** `--local-ref-root` resolves against the working directory, like every other CLI path. */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot: resolveLocationUrl(localRefRoot, cwd) }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":["resolveLocationUrl"],"mappings":";;;;AASO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,OAAO;AAAA,IACL,GAAI,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAcA,4BAAA,CAAmB,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IAC5F,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}

package/dist/cli/ref-limits.mjs

@@ -1,9 +1,9 @@
-import { resolveFileUrl } from './cli-output.mjs';
+import { resolveLocationUrl } from './cli-output.mjs';
 
 function refLimitOptions(args, cwd) {
   const { localRefRoot, remoteRefHosts } = args.refLimits;
   return {
-    ...localRefRoot === void 0 ? {} : { localRefRoot: resolveFileUrl(localRefRoot, cwd) },
+    ...localRefRoot === void 0 ? {} : { localRefRoot: resolveLocationUrl(localRefRoot, cwd) },
     ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
   };
 }

package/dist/cli/ref-limits.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ref-limits.mjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { resolveFileUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\n/** `--local-ref-root` resolves against the working directory, like every other CLI path. */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot: resolveFileUrl(localRefRoot, cwd) }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":[],"mappings":";;AASO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,OAAO;AAAA,IACL,GAAI,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,cAAA,CAAe,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IACxF,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}
+{"version":3,"file":"ref-limits.mjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\n/** `--local-ref-root` resolves against the working directory, like every other CLI path. */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot: resolveLocationUrl(localRefRoot, cwd) }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":[],"mappings":";;AASO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,OAAO;AAAA,IACL,GAAI,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,kBAAA,CAAmB,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IAC5F,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}

package/dist/cli/run-cli.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+const warnings = require('../domain/warnings.cjs');
 const cliArguments = require('./cli-arguments.cjs');
 const cliErrors = require('./cli-errors.cjs');
 const cliOutput = require('./cli-output.cjs');
@@ -18,6 +19,19 @@ async function loadRedoclyConfig(run) {
   }
   return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();
 }
+function schemaSource(run) {
+  const { input } = run.args;
+  if (input) {
+    return cliOutput.resolveLocationUrl(input, run.deps.cwd);
+  }
+  if (run.deps.isStdinTerminal()) {
+    throw cliErrors.cliError(
+      "CLI_INPUT_MISSING",
+      "No schema given: pass a schema path or URL, pipe a schema into stdin, or define `apis` in redocly.yaml. See --help."
+    );
+  }
+  return run.deps.stdin();
+}
 async function generateSingleSchema(run, redocly) {
   const { input, output } = run.args;
   if (input?.includes("*")) {
@@ -32,7 +46,7 @@ async function generateSingleSchema(run, redocly) {
       "--check needs the generated file to compare with: add --output <file>."
     );
   }
-  const source = input ? new URL(input, run.deps.cwd) : run.deps.stdin();
+  const source = schemaSource(run);
   const options = {
     ...run.args.generatorFlags,
     ...refLimits.refLimitOptions(run.args, run.deps.cwd),
@@ -45,7 +59,7 @@ async function generateSingleSchema(run, redocly) {
     run.deps.writeStdout(contents);
     return;
   }
-  const file = cliOutput.resolveFileUrl(output, run.deps.cwd);
+  const file = cliOutput.resolveLocationUrl(output, run.deps.cwd);
   cliOutput.emitOutput(run, { source: input ?? "stdin", output, file }, contents);
 }
 async function generate(run) {
@@ -56,7 +70,10 @@ async function generate(run) {
   }
   if (run.args.input) {
     run.deps.logger.warn(
-      "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config."
+      warnings.warningText(
+        "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.",
+        warnings.WARNING_CODES.CLI_INPUT_IGNORED
+      )
     );
   }
   return redoclyApis.generateRedoclyApis(run, redocly);

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

@@ -1 +1 @@
-{"version":3,"file":"run-cli.cjs","sources":["../../src/cli/run-cli.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { ineffectiveFlagNotices, parseCliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies } from \"./cli-dependencies.js\";\nimport { cliError, describeCliFailure, EXIT_CODES, type ExitCode } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveFileUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixOption } from \"./fix-option.js\";\nimport { HELP_TEXT } from \"./help-text.js\";\nimport { generateRedoclyApis, hasRedoclyApis } from \"./redocly-apis.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/**\n * The CLI's use case: parse the arguments, then generate the APIs of the Redocly config, one\n * schema file or URL, or stdin. It has no process access of its own; `main.ts` wires it (ADR-012).\n */\n\nasync function loadRedoclyConfig(run: CliRun): Promise<RedoclyConfig> {\n  const { redoclyConfigs } = run.deps;\n  const explicitPath = run.args.redocly;\n  const configPath = redoclyConfigs.find(explicitPath);\n  if (explicitPath && !configPath) {\n    throw cliError(\"CLI_CONFIG_NOT_FOUND\", `Redocly config not found at: ${explicitPath}`);\n  }\n  return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();\n}\n\n/** One schema from a path, a URL or stdin; without `--output`, the types go to stdout only. */\nasync function generateSingleSchema(run: CliRun, redocly: RedoclyConfig): Promise<void> {\n  const { input, output } = run.args;\n  if (input?.includes(\"*\")) {\n    throw cliError(\n      \"CLI_GLOB_UNSUPPORTED\",\n      \"Globbing has been deprecated in favor of redocly.yaml’s `apis` keys. \" +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  if (run.args.isCheck && !output) {\n    // Without a file there is nothing to compare: the original printed the types and passed.\n    throw cliError(\n      \"CLI_CHECK_OUTPUT_MISSING\",\n      \"--check needs the generated file to compare with: add --output <file>.\",\n    );\n  }\n  const source = input ? new URL(input, run.deps.cwd) : run.deps.stdin();\n  const options = {\n    ...run.args.generatorFlags,\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(run.args.fix),\n    redocly,\n    silent: !output,\n  };\n  const contents = await run.deps.generate(source, options);\n  if (!output) {\n    run.deps.writeStdout(contents);\n    return;\n  }\n  const file = resolveFileUrl(output, run.deps.cwd);\n  emitOutput(run, { source: input ?? \"stdin\", output, file }, contents);\n}\n\nasync function generate(run: CliRun): Promise<unknown[]> {\n  const redocly = await loadRedoclyConfig(run);\n  if (!hasRedoclyApis(redocly)) {\n    await generateSingleSchema(run, redocly);\n    return [];\n  }\n  if (run.args.input) {\n    run.deps.logger.warn(\n      \"APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.\",\n    );\n  }\n  return generateRedoclyApis(run, redocly);\n}\n\n/** Run the command; the failures it returns did not stop the other outputs. */\nasync function runCommand(argv: readonly string[], deps: CliDependencies): Promise<unknown[]> {\n  const startedAt = deps.now();\n  for (const notice of ineffectiveFlagNotices(argv)) {\n    deps.console.notice(notice);\n  }\n  const args = parseCliArguments(argv);\n  for (const flag of args.unknownFlags) {\n    deps.console.notice(`Unknown flag ${flag} is ignored (see --help)`);\n  }\n  if (args.isHelp || args.isVersion) {\n    deps.console.info(args.isHelp ? HELP_TEXT : `v${deps.version}`);\n    return [];\n  }\n  if (args.output) {\n    deps.console.info(`✨ ${deps.style.bold(`openapi-typesafe ${deps.version}`)}`);\n  }\n  return generate({ deps, args, startedAt });\n}\n\n/** Print one line per failure; the exit code is the first failure's (ADR-011). */\nfunction reportFailures(failures: readonly unknown[], logger: Logger): ExitCode {\n  const reports = failures.map(describeCliFailure);\n  for (const report of reports) {\n    logger.error(report.message);\n  }\n  return reports[0]?.exitCode ?? EXIT_CODES.SUCCESS;\n}\n\n/** Run the CLI with the arguments after `node cli.js`, and return the process exit code. */\nexport async function runCli(argv: readonly string[], deps: CliDependencies): Promise<ExitCode> {\n  let failures: unknown[];\n  try {\n    failures = await runCommand(argv, deps);\n  } catch (thrown) {\n    failures = [thrown];\n  }\n  return reportFailures(failures, deps.logger);\n}\n"],"names":["cliError","MULTIPLE_SCHEMAS_DOCS_URL","refLimitOptions","fixOption","resolveFileUrl","emitOutput","hasRedoclyApis","generateRedoclyApis","ineffectiveFlagNotices","parseCliArguments","HELP_TEXT","describeCliFailure","EXIT_CODES"],"mappings":"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"}
+{"version":3,"file":"run-cli.cjs","sources":["../../src/cli/run-cli.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { SchemaSource } from \"../types.js\";\nimport { ineffectiveFlagNotices, parseCliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies } from \"./cli-dependencies.js\";\nimport { cliError, describeCliFailure, EXIT_CODES, type ExitCode } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveLocationUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixOption } from \"./fix-option.js\";\nimport { HELP_TEXT } from \"./help-text.js\";\nimport { generateRedoclyApis, hasRedoclyApis } from \"./redocly-apis.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/**\n * The CLI's use case: parse the arguments, then generate the APIs of the Redocly config, one\n * schema file or URL, or stdin. It has no process access of its own; `main.ts` wires it (ADR-012).\n */\n\nasync function loadRedoclyConfig(run: CliRun): Promise<RedoclyConfig> {\n  const { redoclyConfigs } = run.deps;\n  const explicitPath = run.args.redocly;\n  const configPath = redoclyConfigs.find(explicitPath);\n  if (explicitPath && !configPath) {\n    throw cliError(\"CLI_CONFIG_NOT_FOUND\", `Redocly config not found at: ${explicitPath}`);\n  }\n  return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();\n}\n\n/** The schema's URL, or stdin when no path or URL is given and something is piped in. */\nfunction schemaSource(run: CliRun): SchemaSource {\n  const { input } = run.args;\n  if (input) {\n    return resolveLocationUrl(input, run.deps.cwd);\n  }\n  if (run.deps.isStdinTerminal()) {\n    throw cliError(\n      \"CLI_INPUT_MISSING\",\n      \"No schema given: pass a schema path or URL, pipe a schema into stdin, or define `apis` \" +\n        \"in redocly.yaml. See --help.\",\n    );\n  }\n  return run.deps.stdin();\n}\n\n/** One schema from a path, a URL or stdin; without `--output`, the types go to stdout only. */\nasync function generateSingleSchema(run: CliRun, redocly: RedoclyConfig): Promise<void> {\n  const { input, output } = run.args;\n  if (input?.includes(\"*\")) {\n    throw cliError(\n      \"CLI_GLOB_UNSUPPORTED\",\n      \"Globbing has been deprecated in favor of redocly.yaml’s `apis` keys. \" +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  if (run.args.isCheck && !output) {\n    // Without a file there is nothing to compare: the original printed the types and passed.\n    throw cliError(\n      \"CLI_CHECK_OUTPUT_MISSING\",\n      \"--check needs the generated file to compare with: add --output <file>.\",\n    );\n  }\n  const source = schemaSource(run);\n  const options = {\n    ...run.args.generatorFlags,\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(run.args.fix),\n    redocly,\n    silent: !output,\n  };\n  const contents = await run.deps.generate(source, options);\n  if (!output) {\n    run.deps.writeStdout(contents);\n    return;\n  }\n  const file = resolveLocationUrl(output, run.deps.cwd);\n  emitOutput(run, { source: input ?? \"stdin\", output, file }, contents);\n}\n\nasync function generate(run: CliRun): Promise<unknown[]> {\n  const redocly = await loadRedoclyConfig(run);\n  if (!hasRedoclyApis(redocly)) {\n    await generateSingleSchema(run, redocly);\n    return [];\n  }\n  if (run.args.input) {\n    run.deps.logger.warn(\n      warningText(\n        \"APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.\",\n        WARNING_CODES.CLI_INPUT_IGNORED,\n      ),\n    );\n  }\n  return generateRedoclyApis(run, redocly);\n}\n\n/** Run the command; the failures it returns did not stop the other outputs. */\nasync function runCommand(argv: readonly string[], deps: CliDependencies): Promise<unknown[]> {\n  const startedAt = deps.now();\n  for (const notice of ineffectiveFlagNotices(argv)) {\n    deps.console.notice(notice);\n  }\n  const args = parseCliArguments(argv);\n  for (const flag of args.unknownFlags) {\n    deps.console.notice(`Unknown flag ${flag} is ignored (see --help)`);\n  }\n  if (args.isHelp || args.isVersion) {\n    deps.console.info(args.isHelp ? HELP_TEXT : `v${deps.version}`);\n    return [];\n  }\n  if (args.output) {\n    deps.console.info(`✨ ${deps.style.bold(`openapi-typesafe ${deps.version}`)}`);\n  }\n  return generate({ deps, args, startedAt });\n}\n\n/** Print one line per failure; the exit code is the first failure's (ADR-011). */\nfunction reportFailures(failures: readonly unknown[], logger: Logger): ExitCode {\n  const reports = failures.map(describeCliFailure);\n  for (const report of reports) {\n    logger.error(report.message);\n  }\n  return reports[0]?.exitCode ?? EXIT_CODES.SUCCESS;\n}\n\n/** Run the CLI with the arguments after `node cli.js`, and return the process exit code. */\nexport async function runCli(argv: readonly string[], deps: CliDependencies): Promise<ExitCode> {\n  let failures: unknown[];\n  try {\n    failures = await runCommand(argv, deps);\n  } catch (thrown) {\n    failures = [thrown];\n  }\n  return reportFailures(failures, deps.logger);\n}\n"],"names":["cliError","resolveLocationUrl","MULTIPLE_SCHEMAS_DOCS_URL","refLimitOptions","fixOption","emitOutput","hasRedoclyApis","warningText","WARNING_CODES","generateRedoclyApis","ineffectiveFlagNotices","parseCliArguments","HELP_TEXT","describeCliFailure","EXIT_CODES"],"mappings":"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"}

package/dist/cli/run-cli.mjs

@@ -1,6 +1,7 @@
+import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
 import { ineffectiveFlagNotices, parseCliArguments } from './cli-arguments.mjs';
 import { describeCliFailure, EXIT_CODES, cliError } from './cli-errors.mjs';
-import { resolveFileUrl, emitOutput } from './cli-output.mjs';
+import { resolveLocationUrl, emitOutput } from './cli-output.mjs';
 import { MULTIPLE_SCHEMAS_DOCS_URL } from './docs-links.mjs';
 import { fixOption } from './fix-option.mjs';
 import { HELP_TEXT } from './help-text.mjs';
@@ -16,6 +17,19 @@ async function loadRedoclyConfig(run) {
   }
   return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();
 }
+function schemaSource(run) {
+  const { input } = run.args;
+  if (input) {
+    return resolveLocationUrl(input, run.deps.cwd);
+  }
+  if (run.deps.isStdinTerminal()) {
+    throw cliError(
+      "CLI_INPUT_MISSING",
+      "No schema given: pass a schema path or URL, pipe a schema into stdin, or define `apis` in redocly.yaml. See --help."
+    );
+  }
+  return run.deps.stdin();
+}
 async function generateSingleSchema(run, redocly) {
   const { input, output } = run.args;
   if (input?.includes("*")) {
@@ -30,7 +44,7 @@ async function generateSingleSchema(run, redocly) {
       "--check needs the generated file to compare with: add --output <file>."
     );
   }
-  const source = input ? new URL(input, run.deps.cwd) : run.deps.stdin();
+  const source = schemaSource(run);
   const options = {
     ...run.args.generatorFlags,
     ...refLimitOptions(run.args, run.deps.cwd),
@@ -43,7 +57,7 @@ async function generateSingleSchema(run, redocly) {
     run.deps.writeStdout(contents);
     return;
   }
-  const file = resolveFileUrl(output, run.deps.cwd);
+  const file = resolveLocationUrl(output, run.deps.cwd);
   emitOutput(run, { source: input ?? "stdin", output, file }, contents);
 }
 async function generate(run) {
@@ -54,7 +68,10 @@ async function generate(run) {
   }
   if (run.args.input) {
     run.deps.logger.warn(
-      "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config."
+      warningText(
+        "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.",
+        WARNING_CODES.CLI_INPUT_IGNORED
+      )
     );
   }
   return generateRedoclyApis(run, redocly);