@kubb/kit 5.10.2 → 5.10.4

package/dist/index.d.cts

@@ -0,0 +1,175 @@
+import { SchemaNode, ast, ast as ast$1 } from "@kubb/ast";
+import { Adapter, AdapterDefinition, AdapterFactory, AdapterFactoryOptions, AdapterSource, BannerMeta, Config, Diagnostic, Diagnostics, Exclude, ExtensionDependencies, ExtensionDependency, ExtensionDependencyRecord, ExtensionFactory, ExtensionKind, ExtensionManifest, ExtensionManifestOption, ExtensionMeta, Generator as Generator$1, GeneratorContext, Group, Hookable, Include, KubbHooks, KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, NodeCache, NormalizedPlugin, Output, OutputOptions, Override, Parser, ParserDefinition, ParserFactory, Plugin, PluginDefinition, PluginFactory, PluginType, Renderer, RendererFactory, ResolveFileOptions, ResolveImportsOptions, ResolvePathOptions, Resolver, ResolverFile, ResolverFileParams, ResolverFilePathParams, ResolverPatch, Storage, addGenerator, addMacro, assertPluginOption, createAdapter, createRenderer, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fsStorage, injectFile, isExtensionManifest, kubbContext, manifestProblems, memoryStorage, requirePlugin, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions } from "@kubb/core";
+//#region src/Url.d.ts
+/**
+ * Helpers for OpenAPI/Swagger paths, plus a thin wrapper over the native `URL`.
+ */
+export declare class Url {
+  /**
+   * Converts an OpenAPI/Swagger path to Express-style colon syntax.
+   *
+   * Distinct parameter names that normalize to the same identifier (e.g. `{group-id}` and
+   * `{group.id}` both becoming `groupId`) are deduplicated with an incrementing suffix so
+   * `path-to-regexp` never sees two identically named captures.
+   *
+   * @example
+   * Url.toPath('/pet/{petId}') // '/pet/:petId'
+   *
+   * @example
+   * Url.toPath('/point/{point-id}') // '/point/:pointId'
+   *
+   * @example
+   * Url.toPath('/groups/{group-id}/{group.id}.json') // '/groups/:groupId/:groupId2.json'
+   */
+  static toPath(path: string): string;
+  /**
+   * Converts an OpenAPI/Swagger path to a template literal that reads each parameter off a
+   * grouped `path` request option, e.g. `/pet/{petId}` becomes `` `/pet/${path.petId}` ``.
+   * Parameter names are kept exactly as they appear in the OpenAPI path; a name falls back to
+   * bracket access (`` path['pet-id'] ``) only when it isn't a valid JS identifier.
+   * `prefix` is prepended inside the literal. Shared by generators that pass a grouped `path` object.
+   *
+   * @example
+   * Url.toGroupedTemplateString('/pet/{petId}') // '`/pet/${path.petId}`'
+   *
+   * @example
+   * Url.toGroupedTemplateString('/user/{monetary-account-id}') // '`/user/${path["monetary-account-id"]}`'
+   */
+  static toGroupedTemplateString(path: string, { prefix }?: {
+    prefix?: string | null;
+  }): string;
+}
+//#endregion
+//#region src/macros/macroDiscriminatorEnum.d.ts
+type Props$2 = {
+  propertyName: string;
+  values: Array<string>;
+  enumName?: string;
+};
+/**
+ * Builds a macro that replaces a discriminator property's schema with a string enum of the given
+ * values. Object schemas that lack the property are returned unchanged.
+ *
+ * @example
+ * ```ts
+ * const macro = macroDiscriminatorEnum({ propertyName: 'type', values: ['dog', 'cat'] })
+ * const next = applyMacros(objectSchema, [macro], { depth: 'shallow' })
+ * ```
+ */
+export declare function macroDiscriminatorEnum({ propertyName, values, enumName }: Props$2): ast$1.Macro;
+//#endregion
+//#region src/macros/macroEnumName.d.ts
+type Props$1 = {
+  parentName: string | null | undefined;
+  propName: string;
+  enumSuffix: string;
+};
+/**
+ * Builds a macro that names an inline enum schema from its parent and property name. Boolean enums
+ * are left anonymous. Non-enum nodes are returned unchanged.
+ *
+ * @example
+ * ```ts
+ * const macro = macroEnumName({ parentName: 'Pet', propName: 'status', enumSuffix: 'enum' })
+ * const named = applyMacros(propSchema, [macro], { depth: 'shallow' })
+ * ```
+ */
+export declare function macroEnumName({ parentName, propName, enumSuffix }: Props$1): ast$1.Macro;
+//#endregion
+//#region src/macros/macroRenameSchema.d.ts
+type Props = {
+  from: string;
+  to: string;
+};
+/**
+ * Builds a macro that renames a schema consistently: the declaration (`name`) and every ref
+ * pointing at it (`targetName`) change together, so imports and printed references stay in
+ * sync. Renaming only one side by hand produces imports for files that are never generated.
+ *
+ * @example
+ * `const macro = macroRenameSchema({ from: 'Order', to: 'StoreOrder' })`
+ */
+export declare function macroRenameSchema({ from, to }: Props): ast$1.Macro;
+//#endregion
+//#region src/macros/macroSimplifyUnion.d.ts
+/**
+ * Removes union members a broader scalar primitive already covers, such as a multi-value string enum
+ * sitting next to a plain `string`. Single-value enums are kept.
+ *
+ * @example
+ * ```ts
+ * const next = applyMacros(unionSchema, [macroSimplifyUnion], { depth: 'shallow' })
+ * ```
+ */
+export declare const macroSimplifyUnion: ast$1.Macro;
+//#endregion
+//#region src/utils/mergeAdjacentSchemas.d.ts
+/**
+ * Merges a run of adjacent anonymous object members into one. Named or non-object members break the
+ * run and pass through unchanged. The merge follows member order, so callers control which members
+ * combine by where they place them in the sequence.
+ *
+ * @example
+ * ```ts
+ * const merged = [...mergeAdjacentObjectsLazy([objectA, objectB])]
+ * ```
+ */
+export declare function mergeAdjacentObjectsLazy(members: Iterable<SchemaNode>): Generator<SchemaNode, void, undefined>;
+//#endregion
+//#region src/utils/refs.d.ts
+/** Returns the last path segment of a reference string, for example `'Pet'` for `#/components/schemas/Pet`. */
+export declare const extractRefName: typeof ast$1.refName;
+/**
+ * Builds a PascalCase child schema name by joining a parent name and property name.
+ * Returns `null` when there is no parent to nest under.
+ *
+ * @example Nested under a parent
+ * `childName('Order', 'shipping_address') // 'OrderShippingAddress'`
+ *
+ * @example No parent
+ * `childName(undefined, 'params') // null`
+ */
+export declare function childName(parentName: string | null | undefined, propName: string): string | null;
+/**
+ * Builds a PascalCase enum name from the parent name, property name, and a suffix, skipping any
+ * empty parts.
+ *
+ * @example
+ * `enumPropName('Order', 'status', 'enum') // 'OrderStatusEnum'`
+ */
+export declare function enumPropName(parentName: string | null | undefined, propName: string, enumSuffix: string): string;
+/**
+ * Applies `ast.mergeRefWithSchema()` to a resolved ref and rebuilds the result through
+ * `ast.factory.createSchema()`. Non-ref nodes and unresolved refs are returned unchanged.
+ *
+ * @example
+ * ```ts
+ * const ref = ast.factory.createSchema({ type: 'ref', ref: '#/components/schemas/Pet', description: 'A cute pet' })
+ * const merged = syncSchemaRef(ref) // merges with resolved Pet schema
+ * ```
+ */
+export declare function syncSchemaRef(node: SchemaNode): SchemaNode;
+/**
+ * Returns `true` when a schema emits as a plain `string` type.
+ *
+ * Covers `string`, `uuid`, `email`, `url`, and `datetime` types. For `date` and `time`
+ * types, returns `true` only when `representation` is `'string'` rather than `'date'`.
+ */
+export declare function isStringType(node: SchemaNode): boolean;
+//#endregion
+//#region src/utils/schemaGraph.d.ts
+/**
+ * Returns `true` when a schema, or anything nested inside it, references a circular schema.
+ *
+ * Pass `excludeName` to skip refs to a specific schema, which helps when self-references are handled
+ * on their own. Pair it with `ast.findCircularSchemas()` to decide where lazy wrappers go.
+ *
+ * @note Reads the memoized `ast.collectSchemaRefs()` set, so a schema is scanned once across plugins.
+ */
+export declare function containsCircularRef(node: SchemaNode | undefined, { circularSchemas, excludeName }: {
+  circularSchemas: ReadonlySet<string>;
+  excludeName?: string;
+}): boolean;
+//#endregion
+export { type Adapter, type AdapterDefinition, type AdapterFactory, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, type Config, type Diagnostic, Diagnostics, type Exclude, type ExtensionDependencies, type ExtensionDependency, type ExtensionDependencyRecord, type ExtensionFactory, type ExtensionKind, type ExtensionManifest, type ExtensionManifestOption, type ExtensionMeta, type Generator$1 as Generator, type GeneratorContext, type Group, Hookable, type Include, type KubbHooks, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, type NodeCache, type NormalizedPlugin, type Output, type OutputOptions, type Override, type Parser, type ParserDefinition, type ParserFactory, type Plugin, type PluginDefinition, type PluginFactory, type PluginType, type Renderer, type RendererFactory, type ResolveFileOptions, type ResolveImportsOptions, type ResolvePathOptions, Resolver, type ResolverFile, type ResolverFileParams, type ResolverFilePathParams, type ResolverPatch, type Storage, addGenerator, addMacro, assertPluginOption, ast, createAdapter, createRenderer, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fsStorage, injectFile, isExtensionManifest, kubbContext, manifestProblems, memoryStorage, requirePlugin, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
 import { SchemaNode, ast, ast as ast$1 } from "@kubb/ast";
 import { Adapter, AdapterDefinition, AdapterFactory, AdapterFactoryOptions, AdapterSource, BannerMeta, Config, Diagnostic, Diagnostics, Exclude, ExtensionDependencies, ExtensionDependency, ExtensionDependencyRecord, ExtensionFactory, ExtensionKind, ExtensionManifest, ExtensionManifestOption, ExtensionMeta, Generator as Generator$1, GeneratorContext, Group, Hookable, Include, KubbHooks, KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, NodeCache, NormalizedPlugin, Output, OutputOptions, Override, Parser, ParserDefinition, ParserFactory, Plugin, PluginDefinition, PluginFactory, PluginType, Renderer, RendererFactory, ResolveFileOptions, ResolveImportsOptions, ResolvePathOptions, Resolver, ResolverFile, ResolverFileParams, ResolverFilePathParams, ResolverPatch, Storage, addGenerator, addMacro, assertPluginOption, createAdapter, createRenderer, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fsStorage, injectFile, isExtensionManifest, kubbContext, manifestProblems, memoryStorage, requirePlugin, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions } from "@kubb/core";
 //#region src/Url.d.ts

package/dist/index.js

@@ -1,6 +1,6 @@
-import "./rolldown-runtime-C0LytTxp.js";
 import { ast, ast as ast$1 } from "@kubb/ast";
 import { Diagnostics, Hookable, Resolver, addGenerator, addMacro, assertPluginOption, createAdapter, createRenderer, createResolver, createStorage, defineExtension, defineGenerator, defineParser, definePlugin, fsStorage, injectFile, isExtensionManifest, kubbContext, manifestProblems, memoryStorage, requirePlugin, setMacros, setOptions, setResolver, tryUseKubb, useConfig, useKubb, useOptions } from "@kubb/core";
+//#endregion
 //#region src/Url.ts
 /**
 * Sanitizes a parameter name so it is safe to use as a `path-to-regexp` capture name, without

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/kit",
-  "version": "5.10.2",
+  "version": "5.10.4",
   "description": "Authoring toolkit for Kubb plugins, generators, adapters, resolvers, and renderers.",
   "keywords": [
     "codegen",
@@ -45,16 +45,27 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "testing": [
+        "./dist/testing.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./testing": {
       "types": "./dist/testing.d.ts",
-      "import": "./dist/testing.js",
-      "require": "./dist/testing.cjs"
+      "default": "./dist/testing.js"
     },
     "./package.json": "./package.json"
   },
@@ -63,14 +74,22 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/ast": "5.10.2",
-    "@kubb/core": "5.10.2"
+    "@kubb/ast": "5.10.4",
+    "@kubb/core": "5.10.4"
   },
   "devDependencies": {
     "@internals/utils": "0.0.1"
   },
+  "peerDependencies": {
+    "vitest": "^4.0.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.12"
   },
   "scripts": {
     "build": "tsdown",

package/dist/rolldown-runtime-C0LytTxp.js

@@ -1,8 +0,0 @@
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", {
-	value,
-	configurable: true
-});
-//#endregion
-export { __name as t };

package/dist/testing.cjs

@@ -1,9 +0,0 @@
-var _kubb_core_mocks = require("@kubb/core/mocks");
-Object.keys(_kubb_core_mocks).forEach(function(k) {
-	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-		enumerable: true,
-		get: function() {
-			return _kubb_core_mocks[k];
-		}
-	});
-});