@kubb/ast 5.0.0-beta.93 → 5.0.0-beta.95

package/dist/{types-Dno_xT4x.d.ts → types-CqXMgUzC.d.ts}

@@ -1,11 +1,11 @@
 import { n as __name } from "./rolldown-runtime-CNktS9qV.js";
-
 //#region src/constants.d.ts
 /**
  * Traversal depth for AST visitor utilities.
  *
- * - `'shallow'` visits only the immediate node, skipping children.
- * - `'deep'` recursively visits all descendant nodes.
+ * - `'shallow'` recurses through every node except nested `Schema` subtrees, which it treats as
+ *   leaves: a schema node itself is visited, but its children are not.
+ * - `'deep'` recursively visits all descendant nodes, including schema subtrees.
  */
 type VisitorDepth = 'shallow' | 'deep';
 /**
@@ -322,7 +322,7 @@ type TypeNode = BaseNode & {
  *
  * @example
  * ```ts
- * createFunctionDeclaration({ name: 'getPet', export: true, async: true, returnType: 'Pet' })
+ * createFunction({ name: 'getPet', export: true, async: true, returnType: 'Pet' })
  * // export async function getPet(): Promise<Pet> { ... }
  * ```
  */
@@ -383,7 +383,7 @@ type FunctionNode = BaseNode & {
  *
  * @example
  * ```ts
- * createArrowFunctionDeclaration({ name: 'getPet', export: true, singleLine: true })
+ * createArrowFunction({ name: 'getPet', export: true, singleLine: true })
  * // export const getPet = () => ...
  * ```
  */
@@ -760,55 +760,55 @@ type PrimitiveSchemaType =
 /**
  * Text value.
  */
-'string'
+'string' |
 /**
  * Floating-point number.
  */
-| 'number'
+'number' |
 /**
  * Integer number.
  */
-| 'integer'
+'integer' |
 /**
  * Big integer number.
  */
-| 'bigint'
+'bigint' |
 /**
  * Boolean value.
  */
-| 'boolean'
+'boolean' |
 /**
  * Null value.
  */
-| 'null'
+'null' |
 /**
  * Any value.
  */
-| 'any'
+'any' |
 /**
  * Unknown value.
  */
-| 'unknown'
+'unknown' |
 /**
  * No value (`void`).
  */
-| 'void'
+'void' |
 /**
  * Never value.
  */
-| 'never'
+'never' |
 /**
  * Object value.
  */
-| 'object'
+'object' |
 /**
  * Array value.
  */
-| 'array'
+'array' |
 /**
  * Date value.
  */
-| 'date';
+'date';
 /**
  * Composite schema types.
  */
@@ -824,7 +824,7 @@ type SchemaType = PrimitiveSchemaType | ComplexSchemaType | SpecialSchemaType;
 /**
  * Scalar schema types without extra object/array/ref structure.
  */
-type ScalarSchemaType = Exclude<SchemaType, 'object' | 'array' | 'tuple' | 'union' | 'intersection' | 'enum' | 'ref' | 'datetime' | 'date' | 'time' | 'string' | 'number' | 'integer' | 'bigint' | 'url' | 'uuid' | 'email'>;
+type ScalarSchemaType = Exclude<SchemaType, 'object' | 'array' | 'tuple' | 'union' | 'intersection' | 'enum' | 'ref' | 'datetime' | 'date' | 'time' | 'string' | 'number' | 'integer' | 'bigint' | 'url' | 'uuid' | 'email' | 'ipv4' | 'ipv6'>;
 /**
  * Fields shared by all schema nodes.
  */
@@ -1106,6 +1106,13 @@ type RefSchemaNode = SchemaNodeBase & {
    * Used to resolve names later.
    */
   ref?: string;
+  /**
+   * Emitted name of the referenced schema when it differs from the pointer's last segment,
+   * for example after a collision rename (`Order` becomes `OrderSchema`) or a macro rename.
+   * Resolve display and import names through `resolveRefName`, which prefers this field and
+   * falls back to the pointer segment, then `name`.
+   */
+  targetName?: string;
   /**
    * Pattern copied from a sibling `pattern` field.
    */
@@ -2268,7 +2275,7 @@ declare function createOutput(overrides?: Partial<Omit<OutputNode, 'kind'>>): Ou
  * }
  * ```
  */
-type Node = InputNode | OutputNode | OperationNode | SchemaNode | PropertyNode | ParameterNode | ResponseNode | RequestBodyNode | ContentNode | FileNode | ImportNode | ExportNode | SourceNode | ConstNode | TypeNode | FunctionNode | ArrowFunctionNode;
+type Node = InputNode | OutputNode | OperationNode | SchemaNode | PropertyNode | ParameterNode | ResponseNode | RequestBodyNode | ContentNode | FileNode | ImportNode | ExportNode | SourceNode | ConstNode | TypeNode | FunctionNode | ArrowFunctionNode | TextNode | BreakNode | JsxNode;
 //#endregion
 //#region src/visitor.d.ts
 /**
@@ -2554,6 +2561,7 @@ declare function applyMacros<TNode extends Node>(root: TNode, macros: ReadonlyAr
  * const context: PrinterHandlerContext<string, {}> = {
  *   options: {},
  *   transform: () => 'value',
+ *   base: () => 'value',
  * }
  * ```
  */
@@ -2608,7 +2616,7 @@ type PrinterHandler<TOutput, TOptions extends object, T extends SchemaType = Sch
  * })
  * ```
  */
-type PrinterPartial<TOutput, TOptions extends object> = Partial<{ [K in SchemaType]: PrinterHandler<TOutput, TOptions, K> }>;
+type PrinterPartial<TOutput, TOptions extends object> = Partial<{ [K in SchemaType]: PrinterHandler<TOutput, TOptions, K>; }>;
 /**
  * Generic shape used by `definePrinter`.
  *
@@ -2678,13 +2686,13 @@ type PrinterBuilder<T extends PrinterFactoryOptions> = (options: T['options']) =
    * Options to store on the printer.
    */
   options: T['options'];
-  nodes: Partial<{ [K in SchemaType]: PrinterHandler<T['output'], T['options'], K> }>;
+  nodes: Partial<{ [K in SchemaType]: PrinterHandler<T['output'], T['options'], K>; }>;
   /**
    * User-supplied handler overrides. An override wins over the matching `nodes` handler,
    * and can call `this.base(node)` to reuse the handler it replaced. Pass overrides here
    * instead of spreading them into `nodes`, otherwise `this.base` cannot find the original.
    */
-  overrides?: Partial<{ [K in SchemaType]: PrinterHandler<T['output'], T['options'], K> }>;
+  overrides?: Partial<{ [K in SchemaType]: PrinterHandler<T['output'], T['options'], K>; }>;
   /**
    * Optional root-level print override. When provided, becomes the public `printer.print`.
    * Use `this.transform(node)` inside this function to dispatch to the node-level handlers (`nodes`),
@@ -2736,4 +2744,4 @@ type PrinterBuilder<T extends PrinterFactoryOptions> = (options: T['options']) =
 declare function createPrinter<T extends PrinterFactoryOptions = PrinterFactoryOptions>(build: PrinterBuilder<T>): (options?: T['options']) => Printer<T>;
 //#endregion
 export { sourceDef as $, NodeDef as $t, StatusCode as A, BreakNode as At, parameterDef as B, constDef as Bt, GenericOperationNode as C, PropertyNode as Ct, createOperation as D, InferSchemaNode as Dt, OperationNode as E, propertyDef as Et, requestBodyDef as F, JsxNode as Ft, UserFileNode as G, createJsx as Gt, FileNode as H, createBreak as Ht, ParameterLocation as I, TextNode as It, createImport as J, functionDef as Jt, createExport as K, createText as Kt, ParameterNode as L, TypeNode as Lt, responseDef as M, ConstNode as Mt, RequestBodyNode as N, FunctionNode as Nt, operationDef as O, ParserOptions as Ot, createRequestBody as P, JSDocNode as Pt, importDef as Q, DistributiveOmit as Qt, ParameterStyle as R, arrowFunctionDef as Rt, inputDef as S, schemaDef as St, HttpOperationNode as T, createProperty as Tt, ImportNode as U, createConst as Ut, ExportNode as V, createArrowFunction as Vt, SourceNode as W, createFunction as Wt, exportDef as X, textDef as Xt, createSource as Y, jsxDef as Yt, fileDef as Z, typeDef as Zt, createOutput as _, StringSchemaNode as _t, Enforce as a, DatetimeSchemaNode as at, InputNode as b, UrlSchemaNode as bt, composeMacros as c, NumberSchemaNode as ct, Visitor as d, RefSchemaNode as dt, defineNode as en, ContentNode as et, VisitorContext as f, ScalarSchemaNode as ft, OutputNode as g, SchemaType as gt, Node as h, SchemaNodeByType as ht, createPrinter as i, DateSchemaNode as it, createResponse as j, CodeNode as jt, ResponseNode as k, ArrowFunctionNode as kt, defineMacro as l, ObjectSchemaNode as lt, transform as m, SchemaNode as mt, PrinterFactoryOptions as n, NodeKind as nn, createContent as nt, Macro as o, EnumSchemaNode as ot, collect as p, ScalarSchemaType as pt, createFile as q, createType as qt, PrinterPartial as r, schemaTypes as rn, ArraySchemaNode as rt, applyMacros as s, IntersectionSchemaNode as st, Printer as t, BaseNode as tn, contentDef as tt, ParentOf as u, PrimitiveSchemaType as ut, outputDef as v, TimeSchemaNode as vt, HttpMethod as w, UserPropertyNode as wt, createInput as x, createSchema as xt, InputMeta as y, UnionSchemaNode as yt, createParameter as z, breakDef as zt };
-//# sourceMappingURL=types-Dno_xT4x.d.ts.map
+//# sourceMappingURL=types-CqXMgUzC.d.ts.map

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { $t as NodeDef, A as StatusCode, At as BreakNode, C as GenericOperationNode, Ct as PropertyNode, Dt as InferSchemaNode, E as OperationNode, Ft as JsxNode, G as UserFileNode, H as FileNode, I as ParameterLocation, It as TextNode, L as ParameterNode, Lt as TypeNode, Mt as ConstNode, N as RequestBodyNode, Nt as FunctionNode, Ot as ParserOptions, Pt as JSDocNode, Qt as DistributiveOmit, R as ParameterStyle, T as HttpOperationNode, U as ImportNode, V as ExportNode, W as SourceNode, _t as StringSchemaNode, a as Enforce, at as DatetimeSchemaNode, b as InputNode, bt as UrlSchemaNode, ct as NumberSchemaNode, d as Visitor, dt as RefSchemaNode, et as ContentNode, f as VisitorContext, ft as ScalarSchemaNode, g as OutputNode, gt as SchemaType, h as Node, ht as SchemaNodeByType, it as DateSchemaNode, jt as CodeNode, k as ResponseNode, kt as ArrowFunctionNode, lt as ObjectSchemaNode, mt as SchemaNode, n as PrinterFactoryOptions, nn as NodeKind, o as Macro, ot as EnumSchemaNode, pt as ScalarSchemaType, r as PrinterPartial, rt as ArraySchemaNode, st as IntersectionSchemaNode, t as Printer, u as ParentOf, ut as PrimitiveSchemaType, vt as TimeSchemaNode, w as HttpMethod, y as InputMeta, yt as UnionSchemaNode } from "./types-Dno_xT4x.js";
+import { $t as NodeDef, A as StatusCode, At as BreakNode, C as GenericOperationNode, Ct as PropertyNode, Dt as InferSchemaNode, E as OperationNode, Ft as JsxNode, G as UserFileNode, H as FileNode, I as ParameterLocation, It as TextNode, L as ParameterNode, Lt as TypeNode, Mt as ConstNode, N as RequestBodyNode, Nt as FunctionNode, Ot as ParserOptions, Pt as JSDocNode, Qt as DistributiveOmit, R as ParameterStyle, T as HttpOperationNode, U as ImportNode, V as ExportNode, W as SourceNode, _t as StringSchemaNode, a as Enforce, at as DatetimeSchemaNode, b as InputNode, bt as UrlSchemaNode, ct as NumberSchemaNode, d as Visitor, dt as RefSchemaNode, et as ContentNode, f as VisitorContext, ft as ScalarSchemaNode, g as OutputNode, gt as SchemaType, h as Node, ht as SchemaNodeByType, it as DateSchemaNode, jt as CodeNode, k as ResponseNode, kt as ArrowFunctionNode, lt as ObjectSchemaNode, mt as SchemaNode, n as PrinterFactoryOptions, nn as NodeKind, o as Macro, ot as EnumSchemaNode, pt as ScalarSchemaType, r as PrinterPartial, rt as ArraySchemaNode, st as IntersectionSchemaNode, t as Printer, u as ParentOf, ut as PrimitiveSchemaType, vt as TimeSchemaNode, w as HttpMethod, y as InputMeta, yt as UnionSchemaNode } from "./types-CqXMgUzC.js";
 export type { ArraySchemaNode, ArrowFunctionNode, BreakNode, CodeNode, ConstNode, ContentNode, DateSchemaNode, DatetimeSchemaNode, DistributiveOmit, Enforce, EnumSchemaNode, ExportNode, FileNode, FunctionNode, GenericOperationNode, HttpMethod, HttpOperationNode, ImportNode, InferSchemaNode, InputMeta, InputNode, IntersectionSchemaNode, JSDocNode, JsxNode, Macro, Node, NodeDef, NodeKind, NumberSchemaNode, ObjectSchemaNode, OperationNode, OutputNode, ParameterLocation, ParameterNode, ParameterStyle, ParentOf, ParserOptions, PrimitiveSchemaType, Printer, PrinterFactoryOptions, PrinterPartial, PropertyNode, RefSchemaNode, RequestBodyNode, ResponseNode, ScalarSchemaNode, ScalarSchemaType, SchemaNode, SchemaNodeByType, SchemaType, SourceNode, StatusCode, StringSchemaNode, TextNode, TimeSchemaNode, TypeNode, UnionSchemaNode, UrlSchemaNode, UserFileNode, Visitor, VisitorContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/ast",
-  "version": "5.0.0-beta.93",
+  "version": "5.0.0-beta.95",
   "description": "Spec-agnostic AST layer for Kubb. Defines the node tree, visitor pattern, factory functions, and type guards used across all code generation plugins.",
   "keywords": [
     "ast",
@@ -42,7 +42,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@types/node": "^22.20.0",
+    "@types/node": "^22.20.1",
     "@internals/utils": "0.0.0"
   },
   "engines": {