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

package/dist/index.cjs

@@ -44,7 +44,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.
@@ -616,7 +618,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}`;
@@ -641,7 +643,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();
@@ -732,6 +734,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
 /**
@@ -1113,7 +1139,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) {
@@ -1142,7 +1168,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' })],
 * })
@@ -1154,9 +1180,9 @@ function createSource(props) {
 function createFile(input) {
 	const extname = node_path.default.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",
@@ -1173,7 +1199,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
@@ -1207,7 +1233,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
@@ -1235,7 +1261,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
@@ -1271,7 +1297,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
@@ -1305,6 +1331,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
 /**
@@ -1866,11 +1942,9 @@ exports.caseParams = caseParams;
 exports.childName = childName;
 exports.collect = collect;
 exports.collectImports = collectImports;
-exports.combineExports = combineExports;
-exports.combineImports = combineImports;
-exports.combineSources = combineSources;
 exports.composeTransformers = composeTransformers;
 exports.createArrowFunction = createArrowFunction;
+exports.createBreak = createBreak;
 exports.createConst = createConst;
 exports.createDiscriminantNode = createDiscriminantNode;
 exports.createExport = createExport;
@@ -1880,6 +1954,7 @@ exports.createFunctionParameter = createFunctionParameter;
 exports.createFunctionParameters = createFunctionParameters;
 exports.createImport = createImport;
 exports.createInput = createInput;
+exports.createJsx = createJsx;
 exports.createOperation = createOperation;
 exports.createOperationParams = createOperationParams;
 exports.createOutput = createOutput;
@@ -1891,10 +1966,12 @@ exports.createProperty = createProperty;
 exports.createResponse = createResponse;
 exports.createSchema = createSchema;
 exports.createSource = createSource;
+exports.createText = createText;
 exports.createType = createType;
 exports.definePrinter = definePrinter;
 exports.enumPropName = enumPropName;
 exports.extractRefName = extractRefName;
+exports.extractStringsFromNodes = extractStringsFromNodes;
 exports.findDiscriminator = findDiscriminator;
 exports.httpMethods = httpMethods;
 exports.isInputNode = isInputNode;