@kubb/ast 5.0.0-beta.42 → 5.0.0-beta.43

package/dist/{types-CEIHPTfs.d.ts → types-CC46hQUP.d.ts}

@@ -3565,6 +3565,42 @@ declare function createOperationParams(node: OperationNode, options: CreateOpera
  * and nested node content. Used internally to build the full source string for import filtering.
  */
 declare function extractStringsFromNodes(nodes: Array<CodeNode> | undefined): string;
+/**
+ * Renders an object key, quoting it only when it is not a valid variable name.
+ *
+ * @example
+ * ```ts
+ * objectKey('id')      // 'id'
+ * objectKey('x-total') // '"x-total"'
+ * ```
+ */
+declare function objectKey(name: string): string;
+/**
+ * Assembles a multi-line object literal from already-rendered `entries`, indenting each entry one
+ * level and closing the brace at column zero. Nested objects built the same way indent cumulatively,
+ * so callers never re-parse the generated code. A trailing comma is added per entry to match the
+ * formatter's multi-line style.
+ *
+ * @example
+ * ```ts
+ * buildObject(['id: z.number()', 'name: z.string()'])
+ * // '{\n  id: z.number(),\n  name: z.string(),\n}'
+ * ```
+ */
+declare function buildObject(entries: Array<string>): string;
+/**
+ * Assembles a bracketed list (array by default) from already-rendered `items`. Keeps everything on
+ * one line when no item spans multiple lines, and otherwise puts each item on its own line, indented
+ * one level with a trailing comma and the closing bracket at column zero. Use it for `z.union([…])`,
+ * `z.array([…])`, and similar member lists so objects inside them nest correctly.
+ *
+ * @example
+ * ```ts
+ * buildList(['z.string()', 'z.number()'])
+ * // '[z.string(), z.number()]'
+ * ```
+ */
+declare function buildList(items: Array<string>, brackets?: [open: string, close: string]): string;
 declare function collectUsedSchemaNames(operations: ReadonlyArray<OperationNode>, schemas: ReadonlyArray<SchemaNode>): Set<string>;
 /**
  * Identifies all schemas that participate in circular dependency chains, including direct self-loops.
@@ -3592,5 +3628,5 @@ declare function containsCircularRef(node: SchemaNode | undefined, {
   excludeName?: string;
 }): boolean;
 //#endregion
-export { update as $, ScalarSchemaType as $t, createBreak as A, FunctionParameterNode as At, createOperation as B, DateSchemaNode as Bt, PrinterFactoryOptions as C, httpMethods as Cn, HttpStatusCode as Ct, DistributiveOmit as D, ParameterNode as Dt, definePrinter as E, ParameterLocation as Et, createFunctionParameter as F, FileNode as Ft, createProperty as G, IntersectionSchemaNode as Gt, createParameter as H, EnumSchemaNode as Ht, createFunctionParameters as I, ImportNode as It, createSource as J, NumberSchemaNode as Jt, createResponse as K, Ipv4SchemaNode as Kt, createImport as L, SourceNode as Lt, createExport as M, ParameterGroupNode as Mt, createFile as N, ParamsTypeNode as Nt, UserFileNode as O, FunctionNodeType as Ot, createFunction as P, ExportNode as Pt, syncOptionality as Q, ScalarSchemaNode as Qt, createInput as R, ArraySchemaNode as Rt, Printer as S, VisitorDepth as Sn, ResponseNode as St, createPrinterFactory as T, StatusCode as Tt, createParameterGroup as U, EnumValueNode as Ut, createOutput as V, DatetimeSchemaNode as Vt, createParamsType as W, FormatStringSchemaNode as Wt, createText as X, PrimitiveSchemaType as Xt, createStreamInput as Y, ObjectSchemaNode as Yt, createType as Z, RefSchemaNode as Zt, VisitorContext as _, TypeDeclarationNode as _n, HttpMethod as _t, createDiscriminantNode as a, TimeSchemaNode as an, defineSchemaDialect as at, transform as b, NodeKind as bn, OperationNodeBase as bt, findCircularSchemas as c, PropertyNode as cn, DedupePlan as ct, AsyncVisitor as d, CodeNode as dn, Node as dt, SchemaNode as en, InferSchemaNode as et, CollectOptions as f, ConstNode as fn, InputMeta as ft, Visitor as g, TextNode as gn, GenericOperationNode as gt, TransformOptions as h, JsxNode as hn, OutputNode as ht, containsCircularRef as i, StringSchemaNode as in, SchemaDialect as it, createConst as j, FunctionParametersNode as jt, createArrowFunction as k, FunctionParamNode as kt, isStringType as l, ArrowFunctionNode as ln, applyDedupe as lt, ParentOf as m, JSDocNode as mn, InputStreamNode as mt, caseParams as n, SchemaType as nn, DispatchRule as nt, createOperationParams as o, UnionSchemaNode as on, BuildDedupePlanOptions as ot, CollectVisitor as p, FunctionNode as pn, InputNode as pt, createSchema as q, Ipv6SchemaNode as qt, collectUsedSchemaNames as r, SpecialSchemaType as rn, dispatch as rt, extractStringsFromNodes as s, UrlSchemaNode as sn, DedupeCanonical as st, OperationParamsResolver as t, SchemaNodeByType as tn, ParserOptions as tt, syncSchemaRef as u, BreakNode as un, buildDedupePlan as ut, WalkOptions as v, TypeNode as vn, HttpOperationNode as vt, PrinterPartial as w, schemaTypes as wn, MediaType as wt, walk as x, ScalarPrimitive as xn, OperationProtocol as xt, collect as y, BaseNode as yn, OperationNode as yt, createJsx as z, ComplexSchemaType as zt };
-//# sourceMappingURL=types-CEIHPTfs.d.ts.map
+export { createText as $, PrimitiveSchemaType as $t, DistributiveOmit as A, ParameterNode as At, createImport as B, SourceNode as Bt, transform as C, NodeKind as Cn, OperationNodeBase as Ct, PrinterPartial as D, schemaTypes as Dn, MediaType as Dt, PrinterFactoryOptions as E, httpMethods as En, HttpStatusCode as Et, createExport as F, ParameterGroupNode as Ft, createParameter as G, EnumSchemaNode as Gt, createJsx as H, ComplexSchemaType as Ht, createFile as I, ParamsTypeNode as It, createProperty as J, IntersectionSchemaNode as Jt, createParameterGroup as K, EnumValueNode as Kt, createFunction as L, ExportNode as Lt, createArrowFunction as M, FunctionParamNode as Mt, createBreak as N, FunctionParameterNode as Nt, createPrinterFactory as O, StatusCode as Ot, createConst as P, FunctionParametersNode as Pt, createStreamInput as Q, ObjectSchemaNode as Qt, createFunctionParameter as R, FileNode as Rt, collect as S, BaseNode as Sn, OperationNode as St, Printer as T, VisitorDepth as Tn, ResponseNode as Tt, createOperation as U, DateSchemaNode as Ut, createInput as V, ArraySchemaNode as Vt, createOutput as W, DatetimeSchemaNode as Wt, createSchema as X, Ipv6SchemaNode as Xt, createResponse as Y, Ipv4SchemaNode as Yt, createSource as Z, NumberSchemaNode as Zt, ParentOf as _, JSDocNode as _n, InputStreamNode as _t, collectUsedSchemaNames as a, SchemaType as an, DispatchRule as at, VisitorContext as b, TypeDeclarationNode as bn, HttpMethod as bt, createOperationParams as c, TimeSchemaNode as cn, defineSchemaDialect as ct, isStringType as d, PropertyNode as dn, DedupePlan as dt, RefSchemaNode as en, createType as et, objectKey as f, ArrowFunctionNode as fn, applyDedupe as ft, CollectVisitor as g, FunctionNode as gn, InputNode as gt, CollectOptions as h, ConstNode as hn, InputMeta as ht, caseParams as i, SchemaNodeByType as in, ParserOptions as it, UserFileNode as j, FunctionNodeType as jt, definePrinter as k, ParameterLocation as kt, extractStringsFromNodes as l, UnionSchemaNode as ln, BuildDedupePlanOptions as lt, AsyncVisitor as m, CodeNode as mn, Node as mt, buildList as n, ScalarSchemaType as nn, update as nt, containsCircularRef as o, SpecialSchemaType as on, dispatch as ot, syncSchemaRef as p, BreakNode as pn, buildDedupePlan as pt, createParamsType as q, FormatStringSchemaNode as qt, buildObject as r, SchemaNode as rn, InferSchemaNode as rt, createDiscriminantNode as s, StringSchemaNode as sn, SchemaDialect as st, OperationParamsResolver as t, ScalarSchemaNode as tn, syncOptionality as tt, findCircularSchemas as u, UrlSchemaNode as un, DedupeCanonical as ut, TransformOptions as v, JsxNode as vn, OutputNode as vt, walk as w, ScalarPrimitive as wn, OperationProtocol as wt, WalkOptions as x, TypeNode as xn, HttpOperationNode as xt, Visitor as y, TextNode as yn, GenericOperationNode as yt, createFunctionParameters as z, ImportNode as zt };
+//# sourceMappingURL=types-CC46hQUP.d.ts.map

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { $t as ScalarSchemaType, At as FunctionParameterNode, Bt as DateSchemaNode, C as PrinterFactoryOptions, Ct as HttpStatusCode, D as DistributiveOmit, Dt as ParameterNode, Et as ParameterLocation, Ft as FileNode, Gt as IntersectionSchemaNode, Ht as EnumSchemaNode, It as ImportNode, Jt as NumberSchemaNode, Kt as Ipv4SchemaNode, Lt as SourceNode, Mt as ParameterGroupNode, Nt as ParamsTypeNode, O as UserFileNode, Ot as FunctionNodeType, Pt as ExportNode, Qt as ScalarSchemaNode, Rt as ArraySchemaNode, S as Printer, Sn as VisitorDepth, St as ResponseNode, Tt as StatusCode, Ut as EnumValueNode, Vt as DatetimeSchemaNode, Wt as FormatStringSchemaNode, Xt as PrimitiveSchemaType, Yt as ObjectSchemaNode, Zt as RefSchemaNode, _ as VisitorContext, _n as TypeDeclarationNode, _t as HttpMethod, an as TimeSchemaNode, bn as NodeKind, bt as OperationNodeBase, cn as PropertyNode, ct as DedupePlan, d as AsyncVisitor, dn as CodeNode, dt as Node, en as SchemaNode, et as InferSchemaNode, f as CollectOptions, fn as ConstNode, ft as InputMeta, g as Visitor, gn as TextNode, gt as GenericOperationNode, h as TransformOptions, hn as JsxNode, ht as OutputNode, in as StringSchemaNode, it as SchemaDialect, jt as FunctionParametersNode, kt as FunctionParamNode, ln as ArrowFunctionNode, m as ParentOf, mn as JSDocNode, mt as InputStreamNode, nn as SchemaType, nt as DispatchRule, on as UnionSchemaNode, ot as BuildDedupePlanOptions, p as CollectVisitor, pn as FunctionNode, pt as InputNode, qt as Ipv6SchemaNode, rn as SpecialSchemaType, sn as UrlSchemaNode, st as DedupeCanonical, t as OperationParamsResolver, tn as SchemaNodeByType, tt as ParserOptions, un as BreakNode, v as WalkOptions, vn as TypeNode, vt as HttpOperationNode, w as PrinterPartial, wt as MediaType, xn as ScalarPrimitive, xt as OperationProtocol, yn as BaseNode, yt as OperationNode, zt as ComplexSchemaType } from "./types-CEIHPTfs.js";
+import { $t as PrimitiveSchemaType, A as DistributiveOmit, At as ParameterNode, Bt as SourceNode, Cn as NodeKind, Ct as OperationNodeBase, D as PrinterPartial, Dt as MediaType, E as PrinterFactoryOptions, Et as HttpStatusCode, Ft as ParameterGroupNode, Gt as EnumSchemaNode, Ht as ComplexSchemaType, It as ParamsTypeNode, Jt as IntersectionSchemaNode, Kt as EnumValueNode, Lt as ExportNode, Mt as FunctionParamNode, Nt as FunctionParameterNode, Ot as StatusCode, Pt as FunctionParametersNode, Qt as ObjectSchemaNode, Rt as FileNode, Sn as BaseNode, St as OperationNode, T as Printer, Tn as VisitorDepth, Tt as ResponseNode, Ut as DateSchemaNode, Vt as ArraySchemaNode, Wt as DatetimeSchemaNode, Xt as Ipv6SchemaNode, Yt as Ipv4SchemaNode, Zt as NumberSchemaNode, _ as ParentOf, _n as JSDocNode, _t as InputStreamNode, an as SchemaType, at as DispatchRule, b as VisitorContext, bn as TypeDeclarationNode, bt as HttpMethod, cn as TimeSchemaNode, dn as PropertyNode, dt as DedupePlan, en as RefSchemaNode, fn as ArrowFunctionNode, g as CollectVisitor, gn as FunctionNode, gt as InputNode, h as CollectOptions, hn as ConstNode, ht as InputMeta, in as SchemaNodeByType, it as ParserOptions, j as UserFileNode, jt as FunctionNodeType, kt as ParameterLocation, ln as UnionSchemaNode, lt as BuildDedupePlanOptions, m as AsyncVisitor, mn as CodeNode, mt as Node, nn as ScalarSchemaType, on as SpecialSchemaType, pn as BreakNode, qt as FormatStringSchemaNode, rn as SchemaNode, rt as InferSchemaNode, sn as StringSchemaNode, st as SchemaDialect, t as OperationParamsResolver, tn as ScalarSchemaNode, un as UrlSchemaNode, ut as DedupeCanonical, v as TransformOptions, vn as JsxNode, vt as OutputNode, wn as ScalarPrimitive, wt as OperationProtocol, x as WalkOptions, xn as TypeNode, xt as HttpOperationNode, y as Visitor, yn as TextNode, yt as GenericOperationNode, zt as ImportNode } from "./types-CC46hQUP.js";
 export type { ArraySchemaNode, ArrowFunctionNode, AsyncVisitor, BaseNode, BreakNode, BuildDedupePlanOptions, CodeNode, CollectOptions, CollectVisitor, ComplexSchemaType, ConstNode, DateSchemaNode, DatetimeSchemaNode, DedupeCanonical, DedupePlan, DispatchRule, DistributiveOmit, EnumSchemaNode, EnumValueNode, ExportNode, FileNode, FormatStringSchemaNode, FunctionNode, FunctionNodeType, FunctionParamNode, FunctionParameterNode, FunctionParametersNode, GenericOperationNode, HttpMethod, HttpOperationNode, HttpStatusCode, ImportNode, InferSchemaNode, InputMeta, InputNode, InputStreamNode, IntersectionSchemaNode, Ipv4SchemaNode, Ipv6SchemaNode, JSDocNode, JsxNode, MediaType, Node, NodeKind, NumberSchemaNode, ObjectSchemaNode, OperationNode, OperationNodeBase, OperationParamsResolver, OperationProtocol, OutputNode, ParameterGroupNode, ParameterLocation, ParameterNode, ParamsTypeNode, ParentOf, ParserOptions, PrimitiveSchemaType, Printer, PrinterFactoryOptions, PrinterPartial, PropertyNode, RefSchemaNode, ResponseNode, ScalarPrimitive, ScalarSchemaNode, ScalarSchemaType, SchemaDialect, SchemaNode, SchemaNodeByType, SchemaType, SourceNode, SpecialSchemaType, StatusCode, StringSchemaNode, TextNode, TimeSchemaNode, TransformOptions, TypeDeclarationNode, TypeNode, UnionSchemaNode, UrlSchemaNode, UserFileNode, Visitor, VisitorContext, VisitorDepth, WalkOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/ast",
-  "version": "5.0.0-beta.42",
+  "version": "5.0.0-beta.43",
   "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",
@@ -43,7 +43,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@types/node": "^22.19.19",
+    "@types/node": "^22.19.20",
     "@internals/utils": "0.0.0"
   },
   "engines": {
@@ -51,7 +51,7 @@
   },
   "scripts": {
     "build": "tsdown",
-    "clean": "npx rimraf ./dist",
+    "clean": "node -e \"require('node:fs').rmSync('./dist', {recursive:true,force:true})\"",
     "lint": "oxlint .",
     "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",

package/src/constants.ts

@@ -176,3 +176,14 @@ export const httpMethods = {
  * ```
  */
 export const WALK_CONCURRENCY = 30
+
+/**
+ * Number of spaces in one indentation level when assembling multi-line code as strings.
+ * Set to 2, 3, … to change the indent width used by `buildObject`/`buildList`.
+ */
+export const INDENT_SIZE = 2
+
+/**
+ * One indentation level, derived from {@link INDENT_SIZE}.
+ */
+export const INDENT = Array.from({ length: INDENT_SIZE }, () => ' ').join('')

package/src/index.ts

@@ -37,6 +37,8 @@ export { schemaSignature } from './signature.ts'
 export { mergeAdjacentObjectsLazy, setDiscriminatorEnum, setEnumName, simplifyUnion } from './transformers.ts'
 export type * from './types.ts'
 export {
+  buildList,
+  buildObject,
   caseParams,
   collectUsedSchemaNames,
   containsCircularRef,
@@ -45,6 +47,7 @@ export {
   extractStringsFromNodes,
   findCircularSchemas,
   isStringType,
+  objectKey,
   syncSchemaRef,
 } from './utils.ts'
 export { collect, transform, walk } from './visitor.ts'

package/src/utils.ts

@@ -1,5 +1,6 @@
 import { camelCase, isValidVarName, memoize } from '@internals/utils'
 
+import { INDENT } from './constants.ts'
 import { createFunctionParameter, createFunctionParameters, createParameterGroup, createParamsType, createProperty, createSchema } from './factory.ts'
 import { narrowSchema } from './guards.ts'
 import type {
@@ -761,6 +762,68 @@ export function extractStringsFromNodes(nodes: Array<CodeNode> | undefined): str
     .join('\n')
 }
 
+/**
+ * Indents every non-empty line of `text` by one indent level, leaving blank lines empty.
+ */
+function indentLines(text: string): string {
+  if (!text) return ''
+  return text
+    .split('\n')
+    .map((line) => (line.trim() ? `${INDENT}${line}` : ''))
+    .join('\n')
+}
+
+/**
+ * Renders an object key, quoting it only when it is not a valid variable name.
+ *
+ * @example
+ * ```ts
+ * objectKey('id')      // 'id'
+ * objectKey('x-total') // '"x-total"'
+ * ```
+ */
+export function objectKey(name: string): string {
+  return isValidVarName(name) ? name : JSON.stringify(name)
+}
+
+/**
+ * Assembles a multi-line object literal from already-rendered `entries`, indenting each entry one
+ * level and closing the brace at column zero. Nested objects built the same way indent cumulatively,
+ * so callers never re-parse the generated code. A trailing comma is added per entry to match the
+ * formatter's multi-line style.
+ *
+ * @example
+ * ```ts
+ * buildObject(['id: z.number()', 'name: z.string()'])
+ * // '{\n  id: z.number(),\n  name: z.string(),\n}'
+ * ```
+ */
+export function buildObject(entries: Array<string>): string {
+  if (entries.length === 0) return '{}'
+  const body = entries.map((entry) => `${indentLines(entry)},`).join('\n')
+  return `{\n${body}\n}`
+}
+
+/**
+ * Assembles a bracketed list (array by default) from already-rendered `items`. Keeps everything on
+ * one line when no item spans multiple lines, and otherwise puts each item on its own line, indented
+ * one level with a trailing comma and the closing bracket at column zero. Use it for `z.union([…])`,
+ * `z.array([…])`, and similar member lists so objects inside them nest correctly.
+ *
+ * @example
+ * ```ts
+ * buildList(['z.string()', 'z.number()'])
+ * // '[z.string(), z.number()]'
+ * ```
+ */
+export function buildList(items: Array<string>, brackets: [open: string, close: string] = ['[', ']']): string {
+  const [open, close] = brackets
+  if (items.length === 0) return `${open}${close}`
+  if (!items.some((item) => item.includes('\n'))) return `${open}${items.join(', ')}${close}`
+  const body = items.map((item) => `${indentLines(item)},`).join('\n')
+  return `${open}\n${body}\n${close}`
+}
+
 /**
  * Resolves the schema name of a ref node, falling back through `ref` → `name` → nested `schema.name`.
  *