@kubb/core 5.11.6 → 5.12.1

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { Enforce, FileNode, HttpMethod, ImportNode, InputMeta, InputNode, Macro, Node, OperationNode, SchemaNode, UserFileNode } from "@kubb/ast";
 import { AsyncLocalStorage } from "node:async_hooks";
+import net from "node:net";
 //#region ../../internals/utils/src/promise.d.ts
 /** A value that may already be resolved or still pending.
  *
@@ -92,209 +93,215 @@ export declare function defineParser<TOptions extends object = object, TMeta ext
  */
 declare const diagnosticCatalog: {
   readonly unknown: {
-    readonly code: "KUBB_UNKNOWN";
-    readonly title: "Unknown error";
-    readonly cause: "An error was thrown without a stable Kubb code, so it is reported as-is.";
-    readonly fix: "Read the underlying message and stack. If it comes from a plugin or adapter, check its configuration; otherwise report it as a possible Kubb bug.";
+    readonly code: 'KUBB_UNKNOWN';
+    readonly title: 'Unknown error';
+    readonly cause: 'An error was thrown without a stable Kubb code, so it is reported as-is.';
+    readonly fix: 'Read the underlying message and stack. If it comes from a plugin or adapter, check its configuration; otherwise report it as a possible Kubb bug.';
   };
   readonly inputNotFound: {
-    readonly code: "KUBB_INPUT_NOT_FOUND";
-    readonly title: "Input not found";
-    readonly cause: "The file set as `input` (or passed as `kubb generate PATH`) could not be read. A URL reports `KUBB_INPUT_REQUEST_FAILED` or `KUBB_INPUT_UNREACHABLE` instead.";
-    readonly fix: "Check that the path exists and is readable, then set it as `input` or pass it on the CLI.";
+    readonly code: 'KUBB_INPUT_NOT_FOUND';
+    readonly title: 'Input not found';
+    readonly cause: 'The file set as `input` (or passed as `kubb generate PATH`) could not be read. A URL reports `KUBB_INPUT_REQUEST_FAILED` or `KUBB_INPUT_UNREACHABLE` instead.';
+    readonly fix: 'Check that the path exists and is readable, then set it as `input` or pass it on the CLI.';
   };
   readonly inputRequestFailed: {
-    readonly code: "KUBB_INPUT_REQUEST_FAILED";
-    readonly title: "Input request failed";
-    readonly cause: "A URL set as `input` (or reached through a `$ref`) answered with a 4xx or 5xx status instead of the document.";
-    readonly fix: "Open the URL to see what the server returns. A 401 or 403 needs credentials Kubb does not send, so download the document and point `input` at the local file. A 404 means the path is wrong, and a 5xx means the server itself failed.";
+    readonly code: 'KUBB_INPUT_REQUEST_FAILED';
+    readonly title: 'Input request failed';
+    readonly cause: 'A URL set as `input` (or reached through a `$ref`) answered with a 4xx or 5xx status instead of the document.';
+    readonly fix: 'Open the URL to see what the server returns. A 401 or 403 needs credentials Kubb does not send, so download the document and point `input` at the local file. A 404 means the path is wrong, and a 5xx means the server itself failed.';
   };
   readonly inputUnreachable: {
-    readonly code: "KUBB_INPUT_UNREACHABLE";
-    readonly title: "Input unreachable";
-    readonly cause: "A URL set as `input` (or reached through a `$ref`) never answered, so the request failed before a status came back. A refused connection, an unknown host, an expired certificate, and a timeout all land here.";
-    readonly fix: "Check that the host is running and reachable from this machine. For a local server, start it and confirm the port matches the one in `input`.";
+    readonly code: 'KUBB_INPUT_UNREACHABLE';
+    readonly title: 'Input unreachable';
+    readonly cause: 'A URL set as `input` (or reached through a `$ref`) never answered, so the request failed before a status came back. A refused connection, an unknown host, an expired certificate, and a timeout all land here.';
+    readonly fix: 'Check that the host is running and reachable from this machine. For a local server, start it and confirm the port matches the one in `input`.';
+  };
+  readonly gitInputFailed: {
+    readonly code: 'KUBB_GIT_INPUT_FAILED';
+    readonly title: 'Git input failed';
+    readonly cause: 'A git `input` (`git+<repo>#<ref>:<path>`) is malformed, or `git` could not fetch it: git is not installed, the repository or ref does not exist, or the credentials were refused.';
+    readonly fix: 'Write the input as `git+<repo>#<ref>:<path>`. Run `git fetch --depth 1 <repo> <ref>` yourself to see the git error, and set up a credential helper or SSH key for a private repository.';
   };
   readonly inputRequired: {
-    readonly code: "KUBB_INPUT_REQUIRED";
-    readonly title: "Input required";
-    readonly cause: "An adapter is configured but no `input` was provided.";
-    readonly fix: "Set `input` to a file path, a URL, an inline spec (JSON/YAML string), or a parsed object in your Kubb config.";
+    readonly code: 'KUBB_INPUT_REQUIRED';
+    readonly title: 'Input required';
+    readonly cause: 'An adapter is configured but no `input` was provided.';
+    readonly fix: 'Set `input` to a file path, a URL, an inline spec (JSON/YAML string), or a parsed object in your Kubb config.';
   };
   readonly legacyInput: {
-    readonly code: "KUBB_LEGACY_INPUT";
-    readonly title: "Legacy input shape";
-    readonly cause: "`input` is a `{ path }` or `{ data }` wrapper, which v4 used to point at a document and v5 reads as the document itself.";
-    readonly fix: "Unwrap it: `input: { path: \"./petStore.yaml\" }` becomes `input: \"./petStore.yaml\"`, and `input: { data: spec }` becomes `input: spec`.";
+    readonly code: 'KUBB_LEGACY_INPUT';
+    readonly title: 'Legacy input shape';
+    readonly cause: '`input` is a `{ path }` or `{ data }` wrapper, which v4 used to point at a document and v5 reads as the document itself.';
+    readonly fix: 'Unwrap it: `input: { path: "./petStore.yaml" }` becomes `input: "./petStore.yaml"`, and `input: { data: spec }` becomes `input: spec`.';
   };
   readonly invalidDocument: {
-    readonly code: "KUBB_INVALID_DOCUMENT";
-    readonly title: "Invalid document";
-    readonly cause: "The `input` cannot be read as an OpenAPI or Swagger document: its JSON or YAML has a syntax error, it declares no `openapi` or `swagger` version field, or its version cannot be upgraded to OpenAPI 3.1.";
-    readonly fix: "Fix the syntax at the reported line, and check that `input` points at the spec and not an HTML page. Point `input` at a Swagger 2.0, OpenAPI 3.0, or OpenAPI 3.1 document, and check that a passed object is the spec itself rather than a wrapper around it.";
+    readonly code: 'KUBB_INVALID_DOCUMENT';
+    readonly title: 'Invalid document';
+    readonly cause: 'The `input` cannot be read as an OpenAPI or Swagger document: its JSON or YAML has a syntax error, it declares no `openapi` or `swagger` version field, or its version cannot be upgraded to OpenAPI 3.1.';
+    readonly fix: 'Fix the syntax at the reported line, and check that `input` points at the spec and not an HTML page. Point `input` at a Swagger 2.0, OpenAPI 3.0, or OpenAPI 3.1 document, and check that a passed object is the spec itself rather than a wrapper around it.';
   };
   readonly invalidSpec: {
-    readonly code: "KUBB_INVALID_SPEC";
-    readonly title: "Invalid spec";
-    readonly cause: "The document does not pass OpenAPI schema validation. Kubb still generates from it, but the output can be incomplete or wrong.";
-    readonly fix: "Fix the reported problem in the spec. Run `kubb validate` to list every error, or set `validate: false` on the adapter to skip the check.";
+    readonly code: 'KUBB_INVALID_SPEC';
+    readonly title: 'Invalid spec';
+    readonly cause: 'The document does not pass OpenAPI schema validation. Kubb still generates from it, but the output can be incomplete or wrong.';
+    readonly fix: 'Fix the reported problem in the spec. Run `kubb validate` to list every error, or set `validate: false` on the adapter to skip the check.';
   };
   readonly refNotFound: {
-    readonly code: "KUBB_REF_NOT_FOUND";
-    readonly title: "Reference not found";
-    readonly cause: "A `$ref` could not be resolved in the source document.";
-    readonly fix: "Add the missing definition (for example under `components.schemas`) or fix the `$ref`. Run `kubb validate` to check the spec.";
+    readonly code: 'KUBB_REF_NOT_FOUND';
+    readonly title: 'Reference not found';
+    readonly cause: 'A `$ref` could not be resolved in the source document.';
+    readonly fix: 'Add the missing definition (for example under `components.schemas`) or fix the `$ref`. Run `kubb validate` to check the spec.';
   };
   readonly invalidServerVariable: {
-    readonly code: "KUBB_INVALID_SERVER_VARIABLE";
-    readonly title: "Invalid server variable";
-    readonly cause: "A server variable value is not allowed by its `enum`.";
-    readonly fix: "Use one of the values listed in the server variable `enum`, or update the spec.";
+    readonly code: 'KUBB_INVALID_SERVER_VARIABLE';
+    readonly title: 'Invalid server variable';
+    readonly cause: 'A server variable value is not allowed by its `enum`.';
+    readonly fix: 'Use one of the values listed in the server variable `enum`, or update the spec.';
   };
   readonly pluginNotFound: {
-    readonly code: "KUBB_PLUGIN_NOT_FOUND";
-    readonly title: "Plugin not found";
-    readonly cause: "A plugin that another plugin depends on is missing from the config.";
-    readonly fix: "Add the required plugin to the `plugins` array in kubb.config.ts, or remove the dependency on it.";
+    readonly code: 'KUBB_PLUGIN_NOT_FOUND';
+    readonly title: 'Plugin not found';
+    readonly cause: 'A plugin that another plugin depends on is missing from the config.';
+    readonly fix: 'Add the required plugin to the `plugins` array in kubb.config.ts, or remove the dependency on it.';
   };
   readonly incompatibleExtension: {
-    readonly code: "KUBB_INCOMPATIBLE_EXTENSION";
-    readonly title: "Incompatible extension";
-    readonly cause: "A plugin sets `meta.compatibility.kubb` or `meta.compatibility.node` to a range the running Kubb or Node.js version does not satisfy.";
-    readonly fix: "Upgrade Kubb or Node.js to a version in the range, or install a version of the plugin that supports your current Kubb and Node.js.";
+    readonly code: 'KUBB_INCOMPATIBLE_EXTENSION';
+    readonly title: 'Incompatible extension';
+    readonly cause: 'A plugin sets `meta.compatibility.kubb` or `meta.compatibility.node` to a range the running Kubb or Node.js version does not satisfy.';
+    readonly fix: 'Upgrade Kubb or Node.js to a version in the range, or install a version of the plugin that supports your current Kubb and Node.js.';
   };
   readonly missingDependency: {
-    readonly code: "KUBB_MISSING_DEPENDENCY";
-    readonly title: "Missing dependency";
-    readonly cause: "A plugin lists another plugin in its `dependencies` record without `optional: true`, and the config does not include it.";
-    readonly fix: "Add the missing plugin to the `plugins` array in kubb.config.ts.";
+    readonly code: 'KUBB_MISSING_DEPENDENCY';
+    readonly title: 'Missing dependency';
+    readonly cause: 'A plugin lists another plugin in its `dependencies` record without `optional: true`, and the config does not include it.';
+    readonly fix: 'Add the missing plugin to the `plugins` array in kubb.config.ts.';
   };
   readonly incompatibleDependency: {
-    readonly code: "KUBB_INCOMPATIBLE_DEPENDENCY";
-    readonly title: "Incompatible dependency";
+    readonly code: 'KUBB_INCOMPATIBLE_DEPENDENCY';
+    readonly title: 'Incompatible dependency';
     readonly cause: "A plugin's `dependencies` record sets a `version` range, and the configured plugin's `meta.version` falls outside it.";
-    readonly fix: "Install a version of the dependency inside the range, or a version of the dependent plugin that supports the installed dependency.";
+    readonly fix: 'Install a version of the dependency inside the range, or a version of the dependent plugin that supports the installed dependency.';
   };
   readonly pluginFailed: {
-    readonly code: "KUBB_PLUGIN_FAILED";
-    readonly title: "Plugin failed";
-    readonly cause: "A plugin threw while generating, or reported an error through `ctx.error`.";
-    readonly fix: "Check the plugin options and the node at `at:`. If it is a bug, report it with the stack at `report:`.";
+    readonly code: 'KUBB_PLUGIN_FAILED';
+    readonly title: 'Plugin failed';
+    readonly cause: 'A plugin threw while generating, or reported an error through `ctx.error`.';
+    readonly fix: 'Check the plugin options and the node at `at:`. If it is a bug, report it with the stack at `report:`.';
   };
   readonly adapterFailed: {
-    readonly code: "KUBB_ADAPTER_FAILED";
-    readonly title: "Adapter failed";
-    readonly cause: "The adapter threw an unexpected error while parsing the input.";
-    readonly fix: "Check the input and the adapter options. If it is a bug, report it with the stack at `report:`.";
+    readonly code: 'KUBB_ADAPTER_FAILED';
+    readonly title: 'Adapter failed';
+    readonly cause: 'The adapter threw an unexpected error while parsing the input.';
+    readonly fix: 'Check the input and the adapter options. If it is a bug, report it with the stack at `report:`.';
   };
   readonly parserFailed: {
-    readonly code: "KUBB_PARSER_FAILED";
-    readonly title: "Parser failed";
-    readonly cause: "A parser threw an unexpected error while printing a generated file.";
-    readonly fix: "Check the parser options. If it is a bug, report it with the stack at `report:`.";
+    readonly code: 'KUBB_PARSER_FAILED';
+    readonly title: 'Parser failed';
+    readonly cause: 'A parser threw an unexpected error while printing a generated file.';
+    readonly fix: 'Check the parser options. If it is a bug, report it with the stack at `report:`.';
   };
   readonly pluginWarning: {
-    readonly code: "KUBB_PLUGIN_WARNING";
-    readonly title: "Plugin warning";
-    readonly cause: "A plugin reported a non-fatal warning through `ctx.warn`.";
-    readonly fix: "Review the message. It does not fail the build; adjust the plugin options or input if the warning is unwanted.";
+    readonly code: 'KUBB_PLUGIN_WARNING';
+    readonly title: 'Plugin warning';
+    readonly cause: 'A plugin reported a non-fatal warning through `ctx.warn`.';
+    readonly fix: 'Review the message. It does not fail the build; adjust the plugin options or input if the warning is unwanted.';
   };
   readonly pluginInfo: {
-    readonly code: "KUBB_PLUGIN_INFO";
-    readonly title: "Plugin info";
-    readonly cause: "A plugin reported an informational message through `ctx.info`.";
-    readonly fix: "Informational only. No action is required.";
+    readonly code: 'KUBB_PLUGIN_INFO';
+    readonly title: 'Plugin info';
+    readonly cause: 'A plugin reported an informational message through `ctx.info`.';
+    readonly fix: 'Informational only. No action is required.';
   };
   readonly noContext: {
-    readonly code: "KUBB_NO_CONTEXT";
-    readonly title: "No plugin context";
-    readonly cause: "A `kubb/kit` composable such as `useKubb()` or `addGenerator()` ran outside the `setup` and `kubb:plugin:setup` of a plugin, so there is no plugin to apply it to.";
-    readonly fix: "Call the composable inside `setup` or `kubb:plugin:setup`, including in code that setup awaits.";
+    readonly code: 'KUBB_NO_CONTEXT';
+    readonly title: 'No plugin context';
+    readonly cause: 'A `kubb/kit` composable such as `useKubb()` or `addGenerator()` ran outside the `setup` and `kubb:plugin:setup` of a plugin, so there is no plugin to apply it to.';
+    readonly fix: 'Call the composable inside `setup` or `kubb:plugin:setup`, including in code that setup awaits.';
   };
   readonly unsupportedFormat: {
-    readonly code: "KUBB_UNSUPPORTED_FORMAT";
-    readonly title: "Unsupported format";
-    readonly cause: "A schema uses a `format` Kubb does not map to a specific type, so it falls back to the base type.";
-    readonly fix: "Use a format Kubb supports, or handle the custom format with a parser or plugin.";
+    readonly code: 'KUBB_UNSUPPORTED_FORMAT';
+    readonly title: 'Unsupported format';
+    readonly cause: 'A schema uses a `format` Kubb does not map to a specific type, so it falls back to the base type.';
+    readonly fix: 'Use a format Kubb supports, or handle the custom format with a parser or plugin.';
   };
   readonly deprecated: {
-    readonly code: "KUBB_DEPRECATED";
-    readonly title: "Deprecated";
-    readonly cause: "A referenced schema or operation is marked `deprecated`.";
-    readonly fix: "Migrate off the deprecated definition if the warning is unwanted.";
+    readonly code: 'KUBB_DEPRECATED';
+    readonly title: 'Deprecated';
+    readonly cause: 'A referenced schema or operation is marked `deprecated`.';
+    readonly fix: 'Migrate off the deprecated definition if the warning is unwanted.';
   };
   readonly adapterRequired: {
-    readonly code: "KUBB_ADAPTER_REQUIRED";
-    readonly title: "Adapter required";
-    readonly cause: "An action needs an adapter but none is configured.";
-    readonly fix: "Set `adapter` in kubb.config.ts, for example `adapterOas()`.";
+    readonly code: 'KUBB_ADAPTER_REQUIRED';
+    readonly title: 'Adapter required';
+    readonly cause: 'An action needs an adapter but none is configured.';
+    readonly fix: 'Set `adapter` in kubb.config.ts, for example `adapterOas()`.';
   };
   readonly pathTraversal: {
-    readonly code: "KUBB_PATH_TRAVERSAL";
-    readonly title: "Path traversal";
-    readonly cause: "A resolved output path escaped the output directory, which can stem from a path traversal in the spec or a misconfigured `group.name`.";
-    readonly fix: "Keep generated paths within the output directory. Review the `group.name` function and the names coming from the spec.";
+    readonly code: 'KUBB_PATH_TRAVERSAL';
+    readonly title: 'Path traversal';
+    readonly cause: 'A resolved output path escaped the output directory, which can stem from a path traversal in the spec or a misconfigured `group.name`.';
+    readonly fix: 'Keep generated paths within the output directory. Review the `group.name` function and the names coming from the spec.';
   };
   readonly cleanRoot: {
-    readonly code: "KUBB_CLEAN_ROOT";
-    readonly title: "Clean targets the project root";
-    readonly cause: "`output.clean` is enabled and `output.path` resolves to the project root or a parent of it, so cleaning would delete `kubb.config` and every source file.";
-    readonly fix: "Point `output.path` at a subdirectory such as `./src/gen` so clean only removes generated code, or disable `output.clean`.";
+    readonly code: 'KUBB_CLEAN_ROOT';
+    readonly title: 'Clean targets the project root';
+    readonly cause: '`output.clean` is enabled and `output.path` resolves to the project root or a parent of it, so cleaning would delete `kubb.config` and every source file.';
+    readonly fix: 'Point `output.path` at a subdirectory such as `./src/gen` so clean only removes generated code, or disable `output.clean`.';
   };
   readonly invalidPluginOptions: {
-    readonly code: "KUBB_INVALID_PLUGIN_OPTIONS";
-    readonly title: "Invalid plugin options";
+    readonly code: 'KUBB_INVALID_PLUGIN_OPTIONS';
+    readonly title: 'Invalid plugin options';
     readonly cause: "A plugin was configured with options that cannot be honored, for example `output.mode: 'file'` paired with a `group` option.";
     readonly fix: "Fix the plugin options. A single-file output has nothing to group, so remove the `group` option or use `output.mode: 'directory'`.";
   };
   readonly postGenerateFailed: {
-    readonly code: "KUBB_POST_GENERATE_FAILED";
-    readonly title: "Post-generate command failed";
-    readonly cause: "A post-generate command (`output.postGenerate`) exited with a non-zero status.";
-    readonly fix: "Check the command is installed and correct, and run it manually to see the error.";
+    readonly code: 'KUBB_POST_GENERATE_FAILED';
+    readonly title: 'Post-generate command failed';
+    readonly cause: 'A post-generate command (`output.postGenerate`) exited with a non-zero status.';
+    readonly fix: 'Check the command is installed and correct, and run it manually to see the error.';
   };
   readonly formatFailed: {
-    readonly code: "KUBB_FORMAT_FAILED";
-    readonly title: "Format failed";
-    readonly cause: "The formatter pass over the generated files failed.";
-    readonly fix: "Check the formatter (oxfmt, biome, or prettier) is installed and its config is valid, then run it manually on the output.";
+    readonly code: 'KUBB_FORMAT_FAILED';
+    readonly title: 'Format failed';
+    readonly cause: 'The formatter pass over the generated files failed.';
+    readonly fix: 'Check the formatter (oxfmt, biome, or prettier) is installed and its config is valid, then run it manually on the output.';
   };
   readonly lintFailed: {
-    readonly code: "KUBB_LINT_FAILED";
-    readonly title: "Lint failed";
-    readonly cause: "The linter pass over the generated files failed.";
-    readonly fix: "Check the linter (oxlint, biome, or eslint) is installed and its config is valid, then run it manually on the output.";
+    readonly code: 'KUBB_LINT_FAILED';
+    readonly title: 'Lint failed';
+    readonly cause: 'The linter pass over the generated files failed.';
+    readonly fix: 'Check the linter (oxlint, biome, or eslint) is installed and its config is valid, then run it manually on the output.';
   };
   readonly barrelDuplicateExport: {
-    readonly code: "KUBB_BARREL_DUPLICATE_EXPORT";
-    readonly title: "Duplicate barrel export";
-    readonly cause: "Two generated modules export the same name, so the barrel cannot re-export both.";
-    readonly fix: "Rename one of the colliding declarations, or configure the plugin resolver to produce distinct names.";
+    readonly code: 'KUBB_BARREL_DUPLICATE_EXPORT';
+    readonly title: 'Duplicate barrel export';
+    readonly cause: 'Two generated modules export the same name, so the barrel cannot re-export both.';
+    readonly fix: 'Rename one of the colliding declarations, or configure the plugin resolver to produce distinct names.';
   };
   readonly internalError: {
-    readonly code: "KUBB_INTERNAL_ERROR";
-    readonly title: "Internal error";
-    readonly cause: "Kubb hit a state it does not expect. This is a bug in Kubb, not in your config.";
-    readonly fix: "Rerun with `--reporter json` or `--verbose` to get the stack. Then report it at https://github.com/kubb-labs/kubb/issues with the spec and config that trigger it.";
+    readonly code: 'KUBB_INTERNAL_ERROR';
+    readonly title: 'Internal error';
+    readonly cause: 'Kubb hit a state it does not expect. This is a bug in Kubb, not in your config.';
+    readonly fix: 'Rerun with `--reporter json` or `--verbose` to get the stack. Then report it at https://github.com/kubb-labs/kubb/issues with the spec and config that trigger it.';
   };
   readonly performance: {
-    readonly code: "KUBB_PERFORMANCE";
-    readonly title: "Performance";
-    readonly cause: "Not a failure. Records a plugin’s elapsed time, summed into the run total.";
-    readonly fix: "No action. This is an informational metric.";
+    readonly code: 'KUBB_PERFORMANCE';
+    readonly title: 'Performance';
+    readonly cause: 'Not a failure. Records a plugin’s elapsed time, summed into the run total.';
+    readonly fix: 'No action. This is an informational metric.';
   };
   readonly updateAvailable: {
-    readonly code: "KUBB_UPDATE_AVAILABLE";
-    readonly title: "Update available";
-    readonly cause: "A newer Kubb version is published on npm than the one running.";
-    readonly fix: "Update the `@kubb/*` packages, for example `npm install -g @kubb/cli`, to get the latest fixes.";
+    readonly code: 'KUBB_UPDATE_AVAILABLE';
+    readonly title: 'Update available';
+    readonly cause: 'A newer Kubb version is published on npm than the one running.';
+    readonly fix: 'Update the `@kubb/*` packages, for example `npm install -g @kubb/cli`, to get the latest fixes.';
   };
 };
 /**
  * Stable codes Kubb attaches to a `Diagnostic`, derived from {@link diagnosticCatalog}. Reference
  * these instead of inlining the string at a throw site.
  */
-declare const diagnosticCode: { readonly [K in keyof typeof diagnosticCatalog]: (typeof diagnosticCatalog)[K]["code"]; };
+declare const diagnosticCode: { readonly [K in keyof typeof diagnosticCatalog]: (typeof diagnosticCatalog)[K]['code']; };
 /**
  * Union of the stable {@link diagnosticCode} values.
  */
@@ -1826,6 +1833,7 @@ export declare class Diagnostics {
     readonly inputNotFound: "KUBB_INPUT_NOT_FOUND";
     readonly inputRequestFailed: "KUBB_INPUT_REQUEST_FAILED";
     readonly inputUnreachable: "KUBB_INPUT_UNREACHABLE";
+    readonly gitInputFailed: "KUBB_GIT_INPUT_FAILED";
     readonly inputRequired: "KUBB_INPUT_REQUIRED";
     readonly legacyInput: "KUBB_LEGACY_INPUT";
     readonly invalidDocument: "KUBB_INVALID_DOCUMENT";
@@ -3531,22 +3539,48 @@ type ResolverOptions<T extends PluginType> = Omit<T['resolver'], keyof Resolver>
  */
 export declare function createResolver<T extends PluginType>(options: ResolverOptions<T>): T['resolver'];
 //#endregion
+//#region src/gitInput.d.ts
+/**
+ * Fetches one commit of a git repository into a temporary directory with a shallow `git fetch`,
+ * so any host and the user's own git credentials work, and relative `$ref` files resolve.
+ * Resolves to the spec path on disk and a `dispose` that deletes the checkout.
+ *
+ * With `publicOnly`, the repository must be an https URL on public addresses, the fetch connects to
+ * the addresses checked, and it does not follow a redirect.
+ */
+export declare function checkoutGitInput(input: string, signal?: AbortSignal, { publicOnly }?: {
+  publicOnly?: boolean;
+}): Promise<{
+  path: string;
+  dispose: () => Promise<void>;
+}>;
+//#endregion
+//#region src/publicAddress.d.ts
+/**
+ * Whether `address` is a routable public IP. Loopback, private, link-local, cloud metadata, and
+ * multicast ranges are not, and an IPv4-mapped IPv6 address counts as the IPv4 address it wraps.
+ * Pass `blocked` to replace the ranges.
+ */
+export declare function isPublicAddress(address: string, blocked?: net.BlockList): boolean;
+//#endregion
 //#region src/input.d.ts
 /**
  * What an `input` value points at, once Kubb has looked at it.
  *
  * - `file` is a local file path, absolute or relative to the config file.
  * - `url` is a remote document to fetch.
+ * - `git` is a spec file in a git repository, written as `git+<repo>#<ref>:<path>`.
  * - `inline` is OpenAPI content held in the string itself (JSON or YAML).
  * - `object` is an already-parsed spec.
  */
-type InputKind = 'file' | 'url' | 'inline' | 'object';
+type InputKind = 'file' | 'url' | 'git' | 'inline' | 'object';
 /**
  * Classifies an `input` value so callers branch on it once instead of repeating the checks.
  *
  * A non-string is a parsed spec (`object`). A string is `inline` when it holds OpenAPI content,
  * meaning it starts with `{` or `[`, spans multiple lines, or opens with a YAML `openapi:` or
- * `swagger:` key. Otherwise a string is a `url` when it parses as one, or a `file` path.
+ * `swagger:` key. Otherwise a string is `git` when it starts with `git+`, a `url` when it parses as
+ * one, or a `file` path.
  */
 export declare function getInputKind(input: NonNullable<Input>): InputKind;
 //#endregion
@@ -3580,7 +3614,7 @@ export declare function resolveCacheDir(root: string): string;
  * await cache.writeItem('output-manifest.json', JSON.stringify(entries))
  * ```
  */
-export declare const cacheStorage: (options?: CacheStorageOptions | undefined) => Storage;
+export declare const cacheStorage: (options?: CacheStorageOptions | undefined) => import("@kubb/kit").Storage;
 //#endregion
 //#region src/storages/fsStorage.d.ts
 /**
@@ -3609,7 +3643,7 @@ export declare const cacheStorage: (options?: CacheStorageOptions | undefined) =
  * })
  * ```
  */
-export declare const fsStorage: (options?: Record<string, never> | undefined) => Storage;
+export declare const fsStorage: (options?: Record<string, never> | undefined) => import("@kubb/kit").Storage;
 //#endregion
 //#region src/storages/kubbStorage.d.ts
 type KubbStorageOptions = {
@@ -3658,7 +3692,7 @@ export declare function kubbStorage({ base }?: KubbStorageOptions): import("unst
  * })
  * ```
  */
-export declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
+export declare const memoryStorage: (options?: Record<string, never> | undefined) => import("@kubb/kit").Storage;
 //#endregion
 //#region src/manifest.d.ts
 /** A value that survives `JSON.stringify` and `JSON.parse` unchanged. */

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { $ as NodeCache, $t as ReporterContext, A as PluginFactory, At as KubbInfoContext, B as ResolveImportsOptions, Bt as RunHookOptions, C as NormalizedPlugin, Ct as KubbGenerationEndContext, D as Override, Dt as KubbHookLineContext, E as OutputOptions, Et as KubbHookEndContext, F as definePlugin, Ft as KubbWarnContext, G as ResolverFile, Gt as createOutputManifest, H as ResolvePathOptions, Ht as KubbDriver, I as BannerMeta, It as PossibleConfig, J as ResolverPatch, Jt as createRenderer, K as ResolverFileParams, Kt as Renderer, L as ResolveBannerContext, Lt as PostGenerateCommand, M as PluginType, Mt as KubbMessageContext, N as ResolvePluginOptions, Nt as KubbPluginsEndContext, O as Plugin, Ot as KubbHookStartContext, P as assertPluginOption, Pt as KubbSuccessContext, Q as defineGenerator, Qt as Reporter, R as ResolveBannerFile, Rt as UserConfig, S as KubbPluginStartContext, St as KubbFilesProcessingUpdateContext, T as OutputMode, Tt as KubbGenerationSummaryContext, U as Resolver, Ut as Hookable, V as ResolveOptionsContext, Vt as runHook, W as ResolverDefault, Wt as OutputManifest, X as Generator, Xt as createStorage, Y as ResolverPathParams, Yt as Storage, Z as GeneratorContext, Zt as GenerationResult, _ as Filter, _t as KubbDiagnosticContext, a as AdapterSource, an as DiagnosticFormatOptions, at as Diagnostics, b as KubbPluginEndContext, bt as KubbFilesProcessingEndContext, c as ExtensionDependency, cn as ParserDefinition, ct as ProblemDiagnostic, d as ExtensionKind, dt as CLIOptions, en as ReporterName, et as Diagnostic, f as ExtensionMeta, ft as Config, g as Exclude, gt as KubbBuildStartContext, h as resolveMeta, ht as KubbBuildEndContext, i as AdapterFactoryOptions, in as logLevel, it as DiagnosticSeverity, j as PluginName, jt as KubbLifecycleStartContext, k as PluginDefinition, kt as KubbHooks, l as ExtensionDependencyRecord, ln as ParserFactory, lt as UpdateDiagnostic, m as defineExtension, mt as Input, n as AdapterDefinition, nn as UserReporter, nt as DiagnosticKind, o as createAdapter, on as SerializedDiagnostic, ot as PerformanceDiagnostic, p as checkCompatibility, pt as FilesContext, q as ResolverFilePathParams, qt as RendererFactory, r as AdapterFactory, rn as createReporter, rt as DiagnosticLocation, s as ExtensionDependencies, sn as Parser, st as ProblemCode, t as Adapter, tn as ReporterPluginFiles, tt as DiagnosticDoc, u as ExtensionFactory, un as defineParser, ut as BuildOutput, v as Group, vt as KubbErrorContext, w as Output, wt as KubbGenerationStartContext, x as KubbPluginSetupContext, xt as KubbFilesProcessingStartContext, y as Include, yt as KubbFileProcessingUpdate, z as ResolveFileOptions, zt as HookResult } from "./createAdapter-DtX_MKL-.js";
+import { $ as NodeCache, $t as ReporterContext, A as PluginFactory, At as KubbInfoContext, B as ResolveImportsOptions, Bt as RunHookOptions, C as NormalizedPlugin, Ct as KubbGenerationEndContext, D as Override, Dt as KubbHookLineContext, E as OutputOptions, Et as KubbHookEndContext, F as definePlugin, Ft as KubbWarnContext, G as ResolverFile, Gt as createOutputManifest, H as ResolvePathOptions, Ht as KubbDriver, I as BannerMeta, It as PossibleConfig, J as ResolverPatch, Jt as createRenderer, K as ResolverFileParams, Kt as Renderer, L as ResolveBannerContext, Lt as PostGenerateCommand, M as PluginType, Mt as KubbMessageContext, N as ResolvePluginOptions, Nt as KubbPluginsEndContext, O as Plugin, Ot as KubbHookStartContext, P as assertPluginOption, Pt as KubbSuccessContext, Q as defineGenerator, Qt as Reporter, R as ResolveBannerFile, Rt as UserConfig, S as KubbPluginStartContext, St as KubbFilesProcessingUpdateContext, T as OutputMode, Tt as KubbGenerationSummaryContext, U as Resolver, Ut as Hookable, V as ResolveOptionsContext, Vt as runHook, W as ResolverDefault, Wt as OutputManifest, X as Generator, Xt as createStorage, Y as ResolverPathParams, Yt as Storage, Z as GeneratorContext, Zt as GenerationResult, _ as Filter, _t as KubbDiagnosticContext, a as AdapterSource, an as DiagnosticFormatOptions, at as Diagnostics, b as KubbPluginEndContext, bt as KubbFilesProcessingEndContext, c as ExtensionDependency, cn as ParserDefinition, ct as ProblemDiagnostic, d as ExtensionKind, dt as CLIOptions, en as ReporterName, et as Diagnostic, f as ExtensionMeta, ft as Config, g as Exclude, gt as KubbBuildStartContext, h as resolveMeta, ht as KubbBuildEndContext, i as AdapterFactoryOptions, in as logLevel, it as DiagnosticSeverity, j as PluginName, jt as KubbLifecycleStartContext, k as PluginDefinition, kt as KubbHooks, l as ExtensionDependencyRecord, ln as ParserFactory, lt as UpdateDiagnostic, m as defineExtension, mt as Input, n as AdapterDefinition, nn as UserReporter, nt as DiagnosticKind, o as createAdapter, on as SerializedDiagnostic, ot as PerformanceDiagnostic, p as checkCompatibility, pt as FilesContext, q as ResolverFilePathParams, qt as RendererFactory, r as AdapterFactory, rn as createReporter, rt as DiagnosticLocation, s as ExtensionDependencies, sn as Parser, st as ProblemCode, t as Adapter, tn as ReporterPluginFiles, tt as DiagnosticDoc, u as ExtensionFactory, un as defineParser, ut as BuildOutput, v as Group, vt as KubbErrorContext, w as Output, wt as KubbGenerationStartContext, x as KubbPluginSetupContext, xt as KubbFilesProcessingStartContext, y as Include, yt as KubbFileProcessingUpdate, z as ResolveFileOptions, zt as HookResult } from "./createAdapter-DFXvZLZC.js";
 import { FileNode, Macro, UserFileNode } from "@kubb/ast";
 import { AsyncLocalStorage } from "node:async_hooks";
+import net from "node:net";
 //#region src/composables.d.ts
 /**
  * Holds the setup context of the plugin whose `setup` or `kubb:plugin:setup` is running. `KubbDriver` sets it for each plugin.
@@ -316,22 +317,48 @@ type ResolverOptions<T extends PluginType> = Omit<T['resolver'], keyof Resolver>
  */
 export declare function createResolver<T extends PluginType>(options: ResolverOptions<T>): T['resolver'];
 //#endregion
+//#region src/gitInput.d.ts
+/**
+ * Fetches one commit of a git repository into a temporary directory with a shallow `git fetch`,
+ * so any host and the user's own git credentials work, and relative `$ref` files resolve.
+ * Resolves to the spec path on disk and a `dispose` that deletes the checkout.
+ *
+ * With `publicOnly`, the repository must be an https URL on public addresses, the fetch connects to
+ * the addresses checked, and it does not follow a redirect.
+ */
+export declare function checkoutGitInput(input: string, signal?: AbortSignal, { publicOnly }?: {
+  publicOnly?: boolean;
+}): Promise<{
+  path: string;
+  dispose: () => Promise<void>;
+}>;
+//#endregion
+//#region src/publicAddress.d.ts
+/**
+ * Whether `address` is a routable public IP. Loopback, private, link-local, cloud metadata, and
+ * multicast ranges are not, and an IPv4-mapped IPv6 address counts as the IPv4 address it wraps.
+ * Pass `blocked` to replace the ranges.
+ */
+export declare function isPublicAddress(address: string, blocked?: net.BlockList): boolean;
+//#endregion
 //#region src/input.d.ts
 /**
  * What an `input` value points at, once Kubb has looked at it.
  *
  * - `file` is a local file path, absolute or relative to the config file.
  * - `url` is a remote document to fetch.
+ * - `git` is a spec file in a git repository, written as `git+<repo>#<ref>:<path>`.
  * - `inline` is OpenAPI content held in the string itself (JSON or YAML).
  * - `object` is an already-parsed spec.
  */
-type InputKind = 'file' | 'url' | 'inline' | 'object';
+type InputKind = 'file' | 'url' | 'git' | 'inline' | 'object';
 /**
  * Classifies an `input` value so callers branch on it once instead of repeating the checks.
  *
  * A non-string is a parsed spec (`object`). A string is `inline` when it holds OpenAPI content,
  * meaning it starts with `{` or `[`, spans multiple lines, or opens with a YAML `openapi:` or
- * `swagger:` key. Otherwise a string is a `url` when it parses as one, or a `file` path.
+ * `swagger:` key. Otherwise a string is `git` when it starts with `git+`, a `url` when it parses as
+ * one, or a `file` path.
  */
 export declare function getInputKind(input: NonNullable<Input>): InputKind;
 //#endregion
@@ -365,7 +392,7 @@ export declare function resolveCacheDir(root: string): string;
  * await cache.writeItem('output-manifest.json', JSON.stringify(entries))
  * ```
  */
-export declare const cacheStorage: (options?: CacheStorageOptions | undefined) => Storage;
+export declare const cacheStorage: (options?: CacheStorageOptions | undefined) => import("@kubb/kit").Storage;
 //#endregion
 //#region src/storages/fsStorage.d.ts
 /**
@@ -394,7 +421,7 @@ export declare const cacheStorage: (options?: CacheStorageOptions | undefined) =
  * })
  * ```
  */
-export declare const fsStorage: (options?: Record<string, never> | undefined) => Storage;
+export declare const fsStorage: (options?: Record<string, never> | undefined) => import("@kubb/kit").Storage;
 //#endregion
 //#region src/storages/kubbStorage.d.ts
 type KubbStorageOptions = {
@@ -443,7 +470,7 @@ export declare function kubbStorage({ base }?: KubbStorageOptions): import("unst
  * })
  * ```
  */
-export declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
+export declare const memoryStorage: (options?: Record<string, never> | undefined) => import("@kubb/kit").Storage;
 //#endregion
 //#region src/manifest.d.ts
 /** A value that survives `JSON.stringify` and `JSON.parse` unchanged. */

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as inParallel, C as useOptions, D as Diagnostics, E as resolveMeta, F as rm, I as write, L as writeRaw, M as isPathInside, N as listFiles, O as formatMs, P as read, R as toError, S as useKubb, T as defineExtension, _ as setMacros, b as tryUseKubb, c as Resolver, d as definePlugin, f as addGenerator, g as requirePlugin, h as kubbContext, j as existsSync$1, k as getElapsedMs, l as getInputKind, m as injectFile, n as KubbDriver, o as _usingCtx, p as addMacro, s as createResolver, t as Hookable, u as assertPluginOption, v as setOptions, w as checkCompatibility, x as useConfig, y as setResolver } from "./Hookable-CvStaYYq.js";
+import { A as formatMs, B as toError, C as useConfig, D as defineExtension, E as checkCompatibility, F as listFiles, I as read, L as rm$1, M as inParallel, N as existsSync$1, O as resolveMeta, P as isPathInside, R as write, S as tryUseKubb, T as useOptions, _ as kubbContext, b as setOptions, c as Resolver, d as isPublicAddress, f as assertPluginOption, g as injectFile, h as addMacro, j as getElapsedMs, k as Diagnostics, l as getInputKind, m as addGenerator, n as KubbDriver, o as _usingCtx, p as definePlugin, s as createResolver, t as Hookable, u as checkoutGitInput, v as requirePlugin, w as useKubb, x as setResolver, y as setMacros, z as writeRaw } from "./Hookable-D3jKB944.js";
 import { createRequire } from "node:module";
 import { isValid } from "verkit";
 import process$1 from "node:process";
@@ -7,8 +7,8 @@ import { readFile } from "node:fs/promises";
 import path, { isAbsolute, join, relative, resolve } from "node:path";
 import { chmodSync, existsSync, mkdirSync } from "node:fs";
 import { stripVTControlCharacters, styleText } from "node:util";
-import { hash, randomUUID } from "node:crypto";
 import { homedir, tmpdir } from "node:os";
+import { hash, randomUUID } from "node:crypto";
 import { createInterface } from "node:readline";
 import { createStorage as createStorage$1 } from "unstorage";
 import fsDriver from "unstorage/drivers/fs";
@@ -313,7 +313,7 @@ const fsStorage = createStorage(() => ({
 		});
 	},
 	async removeItem(key) {
-		await rm(resolve(key), { force: true });
+		await rm$1(resolve(key), { force: true });
 	},
 	async readKeys(base) {
 		const resolvedBase = resolve(base ?? process.cwd());
@@ -325,7 +325,7 @@ const fsStorage = createStorage(() => ({
 	},
 	async empty(base) {
 		if (!base) return;
-		await rm(resolve(base), {
+		await rm$1(resolve(base), {
 			recursive: true,
 			force: true
 		});
@@ -1384,6 +1384,6 @@ async function readInstalledPackages({ root, packages = [], resolveFrom = [] })
 	}));
 }
 //#endregion
-export { Diagnostics, Hookable, KubbDriver, Resolver, addGenerator, addMacro, assertPluginOption, cacheStorage, checkCompatibility, cliReporter, createAdapter, createCliReporter, createKubb, createOutputManifest, createRenderer, createReporter, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, htmlReporter, injectFile, isExtensionManifest, isPackageName, isRegistryEntry, jsonReporter, kubbContext, kubbStorage, logLevel, manifestProblems, memoryStorage, readInstalledPackages, requirePlugin, resolveCacheDir, resolveKubbDir, resolveMeta, runHook, runOutputPasses, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions };
+export { Diagnostics, Hookable, KubbDriver, Resolver, addGenerator, addMacro, assertPluginOption, cacheStorage, checkCompatibility, checkoutGitInput, cliReporter, createAdapter, createCliReporter, createKubb, createOutputManifest, createRenderer, createReporter, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, htmlReporter, injectFile, isExtensionManifest, isPackageName, isPublicAddress, isRegistryEntry, jsonReporter, kubbContext, kubbStorage, logLevel, manifestProblems, memoryStorage, readInstalledPackages, requirePlugin, resolveCacheDir, resolveKubbDir, resolveMeta, runHook, runOutputPasses, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions };
 
 //# sourceMappingURL=index.js.map