@kubb/ast 5.0.0-alpha.32 → 5.0.0-alpha.33

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { A as createOperation, At as FunctionParametersNode, B as syncOptionality, C as createExport, D as createFunctionParameters, E as createFunctionParameter, F as createProperty, Ft as ImportNode, I as createResponse, It as SourceNode, Jt as httpMethods, K as InputNode, Kt as ScalarPrimitive, L as createSchema, M as createParameter, N as createParameterGroup, Nt as ExportNode, O as createImport, P as createParamsType, Qt as schemaTypes, R as createSource, S as createConst, T as createFunction, U as ParserOptions, Xt as mediaTypes, Y as OperationNode, Yt as isScalarPrimitive, Zt as nodeKinds, _ as PrinterPartial, d as transform, f as walk, g as PrinterFactoryOptions, h as Printer, j as createOutput, jt as ParameterGroupNode, k as createInput, kt as FunctionParameterNode, l as collect, m as extractRefName, q as OutputNode, tt as ParameterNode, u as composeTransformers, v as createPrinterFactory, vt as SchemaNode, w as createFile, x as createArrowFunction, y as definePrinter, yt as SchemaNodeByType, z as createType } from "./visitor-DysNCWvh.js";
+import { A as createInput, B as createSource, C as createConst, D as createFunctionParameter, E as createFunction, F as createParameterGroup, H as createType, Ht as CodeNode, I as createParamsType, K as ParserOptions, L as createProperty, M as createOperation, Mt as FunctionParameterNode, N as createOutput, Nt as FunctionParametersNode, O as createFunctionParameters, P as createParameter, Pt as ParameterGroupNode, Q as OperationNode, Qt as ScalarPrimitive, R as createResponse, S as createBreak, St as SchemaNodeByType, T as createFile, U as syncOptionality, V as createText, X as OutputNode, Y as InputNode, _ as PrinterPartial, d as transform, en as httpMethods, f as walk, g as PrinterFactoryOptions, h as Printer, in as schemaTypes, it as ParameterNode, j as createJsx, k as createImport, l as collect, m as extractRefName, nn as mediaTypes, rn as nodeKinds, tn as isScalarPrimitive, u as composeTransformers, v as createPrinterFactory, w as createExport, x as createArrowFunction, xt as SchemaNode, y as definePrinter, z as createSchema } from "./visitor-CJMIoAE3.js";
 
 //#region src/guards.d.ts
 /**
@@ -328,22 +328,13 @@ type CreateOperationParamsOptions = {
  */
 declare function createOperationParams(node: OperationNode, options: CreateOperationParamsOptions): FunctionParametersNode;
 /**
- * Deduplicates an array of `SourceNode` objects.
- * Named sources are deduplicated by `name + isExportable + isTypeOnly`.
- * Unnamed sources are deduplicated by `value`.
- */
-declare function combineSources(sources: Array<SourceNode>): Array<SourceNode>;
-/**
- * Deduplicates and merges an array of `ExportNode` objects.
- * Exports with the same path and `isTypeOnly` flag have their names merged.
- */
-declare function combineExports(exports: Array<ExportNode>): Array<ExportNode>;
-/**
- * Deduplicates and merges an array of `ImportNode` objects.
- * Filters out unused imports (names not referenced in `source` or re-exported).
- * Imports with the same path and `isTypeOnly` flag have their names merged.
+ * Recursively extracts all string content embedded in a {@link CodeNode} tree.
+ *
+ * Includes text node values, and string attribute fields (`params`, `generics`,
+ * `returnType`, `type`) that may reference identifiers needing imports.
+ * Used by `createFile` to build the full source string for import filtering.
  */
-declare function combineImports(imports: Array<ImportNode>, exports: Array<ExportNode>, source?: string): Array<ImportNode>;
+declare function extractStringsFromNodes(nodes: Array<CodeNode> | undefined): string;
 //#endregion
-export { type OperationParamsResolver, type ParserOptions, type Printer, type PrinterFactoryOptions, type PrinterPartial, type ScalarPrimitive, caseParams, childName, collect, collectImports, combineExports, combineImports, combineSources, composeTransformers, createArrowFunction, createConst, createDiscriminantNode, createExport, createFile, createFunction, createFunctionParameter, createFunctionParameters, createImport, createInput, createOperation, createOperationParams, createOutput, createParameter, createParameterGroup, createParamsType, createPrinterFactory, createProperty, createResponse, createSchema, createSource, createType, definePrinter, enumPropName, extractRefName, findDiscriminator, httpMethods, isInputNode, isOperationNode, isOutputNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, nodeKinds, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
+export { type OperationParamsResolver, type ParserOptions, type Printer, type PrinterFactoryOptions, type PrinterPartial, type ScalarPrimitive, caseParams, childName, collect, collectImports, composeTransformers, createArrowFunction, createBreak, createConst, createDiscriminantNode, createExport, createFile, createFunction, createFunctionParameter, createFunctionParameters, createImport, createInput, createJsx, createOperation, createOperationParams, createOutput, createParameter, createParameterGroup, createParamsType, createPrinterFactory, createProperty, createResponse, createSchema, createSource, createText, createType, definePrinter, enumPropName, extractRefName, extractStringsFromNodes, findDiscriminator, httpMethods, isInputNode, isOperationNode, isOutputNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, nodeKinds, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -21,7 +21,9 @@ const nodeKinds = {
 	file: "File",
 	import: "Import",
 	export: "Export",
-	source: "Source"
+	source: "Source",
+	text: "Text",
+	break: "Break"
 };
 /**
 * Canonical schema type strings used by AST schema nodes.
@@ -593,7 +595,7 @@ function toStructType({ node, params, resolver }) {
 	});
 }
 function sourceKey(source) {
-	return `${source.name ?? source.value ?? ""}:${source.isExportable ?? false}:${source.isTypeOnly ?? false}`;
+	return `${source.name ?? extractStringsFromNodes(source.nodes)}:${source.isExportable ?? false}:${source.isTypeOnly ?? false}`;
 }
 function pathTypeKey(path, isTypeOnly) {
 	return `${path}:${isTypeOnly ?? false}`;
@@ -618,7 +620,7 @@ function sortKey(node) {
 /**
 * Deduplicates an array of `SourceNode` objects.
 * Named sources are deduplicated by `name + isExportable + isTypeOnly`.
-* Unnamed sources are deduplicated by `value`.
+* Unnamed sources are deduplicated by object reference.
 */
 function combineSources(sources) {
 	const seen = /* @__PURE__ */ new Map();
@@ -709,6 +711,30 @@ function combineImports(imports, exports, source) {
 	}
 	return result;
 }
+/**
+* Recursively extracts all string content embedded in a {@link CodeNode} tree.
+*
+* Includes text node values, and string attribute fields (`params`, `generics`,
+* `returnType`, `type`) that may reference identifiers needing imports.
+* Used by `createFile` to build the full source string for import filtering.
+*/
+function extractStringsFromNodes(nodes) {
+	if (!nodes?.length) return "";
+	return nodes.map((node) => {
+		if (typeof node === "string") return node;
+		if (node.kind === "Text") return node.value;
+		if (node.kind === "Break") return "";
+		if (node.kind === "Jsx") return node.value;
+		const parts = [];
+		if ("params" in node && node.params) parts.push(node.params);
+		if ("generics" in node && node.generics) parts.push(Array.isArray(node.generics) ? node.generics.join(", ") : node.generics);
+		if ("returnType" in node && node.returnType) parts.push(node.returnType);
+		if ("type" in node && typeof node.type === "string") parts.push(node.type);
+		const nested = extractStringsFromNodes(node.nodes);
+		if (nested) parts.push(nested);
+		return parts.join("\n");
+	}).filter(Boolean).join("\n");
+}
 //#endregion
 //#region src/factory.ts
 /**
@@ -1090,7 +1116,7 @@ function createExport(props) {
 *
 * @example
 * ```ts
-* createSource({ name: 'Pet', value: 'export type Pet = { id: number }', isExportable: true })
+* createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true })
 * ```
 */
 function createSource(props) {
@@ -1119,7 +1145,7 @@ function createSource(props) {
 * const file = createFile({
 *   baseName: 'petStore.ts',
 *   path: 'src/models/petStore.ts',
-*   sources: [createSource({ name: 'Pet', value: 'export type Pet = { id: number }' })],
+*   sources: [createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')] })],
 *   imports: [createImport({ name: ['z'], path: 'zod' })],
 *   exports: [createExport({ name: ['Pet'], path: './petStore' })],
 * })
@@ -1131,9 +1157,9 @@ function createSource(props) {
 function createFile(input) {
 	const extname = path.extname(input.baseName) || (input.baseName.startsWith(".") ? input.baseName : "");
 	if (!extname) throw new Error(`No extname found for ${input.baseName}`);
-	const source = (input.sources ?? []).map((item) => item.value).join("\n\n");
+	const source = (input.sources ?? []).flatMap((item) => item.nodes ?? []).map((node) => extractStringsFromNodes([node])).filter(Boolean).join("\n\n");
 	const resolvedExports = input.exports?.length ? combineExports(input.exports) : [];
-	const resolvedImports = input.imports?.length && source ? combineImports(input.imports, resolvedExports, source) : [];
+	const resolvedImports = input.imports?.length ? combineImports(input.imports, resolvedExports, source || void 0) : [];
 	const resolvedSources = input.sources?.length ? combineSources(input.sources) : [];
 	return {
 		kind: "File",
@@ -1150,7 +1176,7 @@ function createFile(input) {
 /**
 * Creates a `ConstNode` representing a TypeScript `const` declaration.
 *
-* Mirrors the `Const` component from `@kubb/react-fabric`.
+* Mirrors the `Const` component from `@kubb/renderer-jsx`.
 * The component's `children` are represented as `nodes`.
 *
 * @example Simple constant
@@ -1184,7 +1210,7 @@ function createConst(props) {
 /**
 * Creates a `TypeNode` representing a TypeScript `type` alias declaration.
 *
-* Mirrors the `Type` component from `@kubb/react-fabric`.
+* Mirrors the `Type` component from `@kubb/renderer-jsx`.
 * The component's `children` are represented as `nodes`.
 *
 * @example Simple type alias
@@ -1212,7 +1238,7 @@ function createType(props) {
 /**
 * Creates a `FunctionNode` representing a TypeScript `function` declaration.
 *
-* Mirrors the `Function` component from `@kubb/react-fabric`.
+* Mirrors the `Function` component from `@kubb/renderer-jsx`.
 * The component's `children` are represented as `nodes`.
 *
 * @example Simple function
@@ -1248,7 +1274,7 @@ function createFunction(props) {
 /**
 * Creates an `ArrowFunctionNode` representing a TypeScript arrow function.
 *
-* Mirrors the `Function.Arrow` component from `@kubb/react-fabric`.
+* Mirrors the `Function.Arrow` component from `@kubb/renderer-jsx`.
 * The component's `children` are represented as `nodes`.
 *
 * @example Simple arrow function
@@ -1282,6 +1308,56 @@ function createArrowFunction(props) {
 		kind: "ArrowFunction"
 	};
 }
+/**
+* Creates a {@link TextNode} representing a raw string fragment in the source output.
+*
+* Use this instead of bare strings when building `nodes` arrays so that every
+* entry in the array is a typed {@link CodeNode}.
+*
+* @example
+* ```ts
+* createText('return fetch(id)')
+* // { kind: 'Text', value: 'return fetch(id)' }
+* ```
+*/
+function createText(value) {
+	return {
+		value,
+		kind: "Text"
+	};
+}
+/**
+* Creates a {@link BreakNode} representing a line break in the source output.
+*
+* Corresponds to `<br/>` in JSX components. Prints as an empty string which,
+* when joined with `\n` by `printNodes`, produces a blank line.
+*
+* @example
+* ```ts
+* createBreak()
+* // { kind: 'Break' }
+* ```
+*/
+function createBreak() {
+	return { kind: "Break" };
+}
+/**
+* Creates a {@link JsxNode} representing a raw JSX fragment in the source output.
+*
+* Use this to embed JSX markup (including fragments `<>…</>`) directly in generated code.
+*
+* @example
+* ```ts
+* createJsx('<>\n  <a href={href}>Open</a>\n</>')
+* // { kind: 'Jsx', value: '<>\n  <a href={href}>Open</a>\n</>' }
+* ```
+*/
+function createJsx(value) {
+	return {
+		value,
+		kind: "Jsx"
+	};
+}
 //#endregion
 //#region src/printer.ts
 /**
@@ -1839,6 +1915,6 @@ function setEnumName(propNode, parentName, propName, enumSuffix) {
 	return propNode;
 }
 //#endregion
-export { caseParams, childName, collect, collectImports, combineExports, combineImports, combineSources, composeTransformers, createArrowFunction, createConst, createDiscriminantNode, createExport, createFile, createFunction, createFunctionParameter, createFunctionParameters, createImport, createInput, createOperation, createOperationParams, createOutput, createParameter, createParameterGroup, createParamsType, createPrinterFactory, createProperty, createResponse, createSchema, createSource, createType, definePrinter, enumPropName, extractRefName, findDiscriminator, httpMethods, isInputNode, isOperationNode, isOutputNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, nodeKinds, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
+export { caseParams, childName, collect, collectImports, composeTransformers, createArrowFunction, createBreak, createConst, createDiscriminantNode, createExport, createFile, createFunction, createFunctionParameter, createFunctionParameters, createImport, createInput, createJsx, createOperation, createOperationParams, createOutput, createParameter, createParameterGroup, createParamsType, createPrinterFactory, createProperty, createResponse, createSchema, createSource, createText, createType, definePrinter, enumPropName, extractRefName, extractStringsFromNodes, findDiscriminator, httpMethods, isInputNode, isOperationNode, isOutputNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, nodeKinds, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
 
 //# sourceMappingURL=index.js.map