@kubb/ast 5.9.3 → 5.9.5

package/dist/index.js

@@ -2,10 +2,6 @@ import { t as __exportAll } from "./rolldown-runtime-CNktS9qV.js";
 import path from "node:path";
 import { hash } from "node:crypto";
 //#region src/constants.ts
-const visitorDepths = {
-	shallow: "shallow",
-	deep: "deep"
-};
 /**
 * Schema type discriminators used by all AST schema nodes.
 *
@@ -173,7 +169,6 @@ const VISITOR_KEYS = {
 /** Visitor callback names in traversal order, the keys of {@link Visitor}. */
 const visitorKeys = [
 	"input",
-	"output",
 	"operation",
 	"schema",
 	"property",
@@ -185,14 +180,12 @@ const visitorKeys = [
 */
 const VISITOR_KEY_BY_KIND = {
 	Input: "input",
-	Output: "output",
 	Operation: "operation",
 	Schema: "schema",
 	Property: "property",
 	Parameter: "parameter",
 	Response: "response"
 };
-const visitorKeysByKind = VISITOR_KEYS;
 /**
 * Returns `true` when `value` is an AST node (an object carrying a `kind`).
 */
@@ -206,14 +199,6 @@ function isNodeRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
-* Returns the child fields of `node` to walk, from {@link VISITOR_KEYS}, or `undefined` when there
-* is nothing to walk. `Schema` children are only walked when `recurse` is `true`.
-*/
-function childKeys(node, recurse) {
-	if (node.kind === "Schema" && !recurse) return void 0;
-	return visitorKeysByKind[node.kind];
-}
-/**
 * Returns the immediate traversable children of `node`.
 *
 * @example
@@ -223,7 +208,7 @@ function childKeys(node, recurse) {
 * ```
 */
 function* getChildren(node, recurse) {
-	const keys = childKeys(node, recurse);
+	const keys = node.kind === "Schema" && !recurse ? void 0 : VISITOR_KEYS[node.kind];
 	if (!keys) return;
 	const record = node;
 	for (const key of keys) {
@@ -282,7 +267,7 @@ function applyVisitor(node, visitor, parent) {
 */
 function transform(node, options) {
 	const { depth, parent, ...visitor } = options;
-	return transformNode(node, visitor, (depth ?? visitorDepths.deep) === visitorDepths.deep, parent);
+	return transformNode(node, visitor, (depth ?? "deep") === "deep", parent);
 }
 /**
 * Visits a single node, then immutably rebuilds its children. Returns the original
@@ -297,7 +282,7 @@ function transformNode(node, visitor, recurse, parent) {
 * (e.g. `additionalProperties: true`) intact.
 */
 function transformChildren(node, visitor, recurse) {
-	const keys = childKeys(node, recurse);
+	const keys = node.kind === "Schema" && !recurse ? void 0 : VISITOR_KEYS[node.kind];
 	if (!keys) return node;
 	const record = node;
 	let updates;
@@ -355,7 +340,7 @@ function transformChildren(node, visitor, recurse) {
 */
 function* collect(node, options) {
 	const { depth, parent, ...visitor } = options;
-	yield* collectNode(node, visitor, (depth ?? visitorDepths.deep) === visitorDepths.deep, parent);
+	yield* collectNode(node, visitor, (depth ?? "deep") === "deep", parent);
 }
 function* collectNode(node, visitor, recurse, parent) {
 	const v = applyVisitor(node, visitor, parent);
@@ -485,18 +470,6 @@ function optionality(schema, required) {
 		nullish: !required && nullable ? true : void 0
 	};
 }
-/**
-* Defaults `required` to `false` and derives the schema's `optional`/`nullish` flags from it.
-* Shared build step of `createProperty` and `createParameter`.
-*/
-function withRequired(props) {
-	const required = props.required ?? false;
-	return {
-		...props,
-		required,
-		schema: optionality(props.schema, required)
-	};
-}
 //#endregion
 //#region src/createPrinter.ts
 /**
@@ -604,6 +577,10 @@ function extractStringsFromNodes(nodes) {
 }
 //#endregion
 //#region src/utils/refs.ts
+/** Returns the last segment of a `$ref` pointer, for example `'Pet'` for `#/components/schemas/Pet`. */
+function refName(ref) {
+	return ref.split("/").at(-1) ?? ref;
+}
 /**
 * Resolves the emitted name of the schema a ref node points at. Prefers `targetName` (set when
 * the referenced schema was renamed, e.g. to break a collision), then the last segment of `ref`,
@@ -620,7 +597,7 @@ function extractStringsFromNodes(nodes) {
 function resolveRefName(node) {
 	if (!node || node.type !== "ref") return null;
 	if (node.targetName) return node.targetName;
-	if (node.ref) return node.ref.split("/").at(-1) ?? node.ref;
+	if (node.ref) return refName(node.ref);
 	return node.name ?? node.schema?.name ?? null;
 }
 /**
@@ -955,6 +932,17 @@ function inferDiscriminatorPropertyName(members) {
 	}
 }
 //#endregion
+//#region src/nodes/base.ts
+/** Builds a `createX` factory for a node whose only computed field is `kind`. */
+function nodeFactory(kind) {
+	return (input) => {
+		return {
+			...input,
+			kind
+		};
+	};
+}
+//#endregion
 //#region src/nodes/code.ts
 /**
 * Creates a `ConstNode` representing a TypeScript `const` declaration.
@@ -965,12 +953,7 @@ function inferDiscriminatorPropertyName(members) {
 * // export const pets: Pet[] = ... as const
 * ```
 */
-function createConst(input) {
-	return {
-		...input,
-		kind: "Const"
-	};
-}
+const createConst = nodeFactory("Const");
 /**
 * Creates a `TypeNode` representing a TypeScript `type` alias declaration.
 *
@@ -980,12 +963,7 @@ function createConst(input) {
 * // export type Pet = ...
 * ```
 */
-function createType(input) {
-	return {
-		...input,
-		kind: "Type"
-	};
-}
+const createType = nodeFactory("Type");
 /**
 * Creates a `FunctionNode` representing a TypeScript `function` declaration.
 *
@@ -995,12 +973,7 @@ function createType(input) {
 * // export async function fetchPet(): Promise<Pet> { ... }
 * ```
 */
-function createFunction(input) {
-	return {
-		...input,
-		kind: "Function"
-	};
-}
+const createFunction = nodeFactory("Function");
 /**
 * Creates an `ArrowFunctionNode` representing a TypeScript arrow function.
 *
@@ -1010,12 +983,7 @@ function createFunction(input) {
 * // export const double = (n: number) => ...
 * ```
 */
-function createArrowFunction(input) {
-	return {
-		...input,
-		kind: "ArrowFunction"
-	};
-}
+const createArrowFunction = nodeFactory("ArrowFunction");
 /**
 * Creates a {@link TextNode} representing a raw string fragment in the source output.
 *
@@ -1063,12 +1031,7 @@ function createJsx(value) {
 /**
 * Creates a `ContentNode` for a single request-body or response content type.
 */
-function createContent(input) {
-	return {
-		...input,
-		kind: "Content"
-	};
-}
+const createContent = nodeFactory("Content");
 //#endregion
 //#region src/utils/combineFileMembers.ts
 const IDENTIFIER_RUN = /[\w$]+/g;
@@ -1217,12 +1180,7 @@ function combineImports(imports, exports, source) {
 * // import { useState } from 'react'
 * ```
 */
-function createImport(input) {
-	return {
-		...input,
-		kind: "Import"
-	};
-}
+const createImport = nodeFactory("Import");
 /**
 * Creates an `ExportNode` representing a language-agnostic export/public API declaration.
 *
@@ -1232,12 +1190,7 @@ function createImport(input) {
 * // export { Pet } from './Pet'
 * ```
 */
-function createExport(input) {
-	return {
-		...input,
-		kind: "Export"
-	};
-}
+const createExport = nodeFactory("Export");
 /**
 * Creates a `SourceNode` representing a fragment of source code within a file.
 *
@@ -1246,12 +1199,7 @@ function createExport(input) {
 * createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true })
 * ```
 */
-function createSource(input) {
-	return {
-		...input,
-		kind: "Source"
-	};
-}
+const createSource = nodeFactory("Source");
 /**
 * Creates a fully resolved `FileNode` from a file input descriptor.
 *
@@ -1357,12 +1305,7 @@ function createInput(overrides = {}) {
 /**
 * Creates a `RequestBodyNode`.
 */
-function createRequestBody(input) {
-	return {
-		...input,
-		kind: "RequestBody"
-	};
-}
+const createRequestBody = nodeFactory("RequestBody");
 //#endregion
 //#region src/nodes/operation.ts
 function createOperation(props) {
@@ -1379,28 +1322,10 @@ function createOperation(props) {
 	};
 }
 //#endregion
-//#region src/nodes/output.ts
-/**
-* Creates an `OutputNode` with a stable default for `files`.
-*
-* @example
-* ```ts
-* const output = createOutput()
-* // { kind: 'Output', files: [] }
-* ```
-*/
-function createOutput(overrides = {}) {
-	return {
-		files: [],
-		...overrides,
-		kind: "Output"
-	};
-}
-//#endregion
 //#region src/nodes/parameter.ts
 /**
 * Creates a `ParameterNode`. `required` defaults to `false`, and the schema's
-* `optional`/`nullish` flags are derived from it through {@link withRequired}.
+* `optional`/`nullish` flags are derived from it.
 *
 * @example
 * ```ts
@@ -1413,8 +1338,11 @@ function createOutput(overrides = {}) {
 * ```
 */
 function createParameter(input) {
+	const required = input.required ?? false;
 	return {
-		...withRequired(input),
+		...input,
+		required,
+		schema: optionality(input.schema, required),
 		kind: "Parameter"
 	};
 }
@@ -1422,7 +1350,7 @@ function createParameter(input) {
 //#region src/nodes/property.ts
 /**
 * Creates a `PropertyNode`. `required` defaults to `false`, and the schema's
-* `optional`/`nullish` flags are derived from it through {@link withRequired}.
+* `optional`/`nullish` flags are derived from it.
 *
 * @example
 * ```ts
@@ -1435,8 +1363,11 @@ function createParameter(input) {
 * ```
 */
 function createProperty(input) {
+	const required = input.required ?? false;
 	return {
-		...withRequired(input),
+		...input,
+		required,
+		schema: optionality(input.schema, required),
 		kind: "Property"
 	};
 }
@@ -1508,8 +1439,8 @@ function createSchema(props) {
 	};
 }
 //#endregion
-//#region src/factory.ts
-var factory_exports = /* @__PURE__ */ __exportAll({
+//#region src/nodes/index.ts
+var nodes_exports = /* @__PURE__ */ __exportAll({
 	createArrowFunction: () => createArrowFunction,
 	createBreak: () => createBreak,
 	createConst: () => createConst,
@@ -1521,7 +1452,6 @@ var factory_exports = /* @__PURE__ */ __exportAll({
 	createInput: () => createInput,
 	createJsx: () => createJsx,
 	createOperation: () => createOperation,
-	createOutput: () => createOutput,
 	createParameter: () => createParameter,
 	createProperty: () => createProperty,
 	createRequestBody: () => createRequestBody,
@@ -1529,32 +1459,8 @@ var factory_exports = /* @__PURE__ */ __exportAll({
 	createSchema: () => createSchema,
 	createSource: () => createSource,
 	createText: () => createText,
-	createType: () => createType,
-	update: () => update
+	createType: () => createType
 });
-/**
-* Identity-preserving node update: returns `node` unchanged when every field in
-* `changes` already equals (by reference) the current value, otherwise a new node
-* with the changes applied.
-*
-* Mirrors the TypeScript compiler's `factory.updateX` contract. Pair it with the
-* structural sharing in {@link transform} so a no-op rewrite does not allocate and
-* downstream passes can detect "nothing changed" by identity. Comparison is shallow,
-* so a structurally equal but newly allocated array or object counts as a change.
-*
-* @example
-* ```ts
-* update(node, { name: node.name })        // -> same `node` reference
-* update(node, { name: 'renamed' })        // -> new node, `name` replaced
-* ```
-*/
-function update(node, changes) {
-	for (const key in changes) if (changes[key] !== node[key]) return {
-		...node,
-		...changes
-	};
-	return node;
-}
 //#endregion
 //#region src/index.ts
 var src_exports = /* @__PURE__ */ __exportAll({
@@ -1569,7 +1475,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	createPrinter: () => createPrinter,
 	defineMacro: () => defineMacro,
 	extractStringsFromNodes: () => extractStringsFromNodes,
-	factory: () => factory_exports,
+	factory: () => nodes_exports,
 	findCircularSchemas: () => findCircularSchemas,
 	findCircularSchemasFromGraph: () => findCircularSchemasFromGraph,
 	getSchemaLiteralValues: () => getSchemaLiteralValues,
@@ -1579,12 +1485,13 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	mergeRefWithSchema: () => mergeRefWithSchema,
 	narrowSchema: () => narrowSchema,
 	optionality: () => optionality,
+	refName: () => refName,
 	resolveRefName: () => resolveRefName,
 	resolveSchemaProperties: () => resolveSchemaProperties,
 	schemaTypes: () => schemaTypes,
 	transform: () => transform
 });
 //#endregion
-export { applyMacros, src_exports as ast, collect, collectImportedRefNames, collectSchemaRefs, collectSync, collectUsedSchemaNames, composeMacros, createPrinter, defineMacro, extractStringsFromNodes, factory_exports as factory, findCircularSchemas, findCircularSchemasFromGraph, getSchemaLiteralValues, inferDiscriminatorPropertyName, isBareRef, isHttpOperationNode, mergeRefWithSchema, narrowSchema, optionality, resolveRefName, resolveSchemaProperties, schemaTypes, transform };
+export { applyMacros, src_exports as ast, collect, collectImportedRefNames, collectSchemaRefs, collectSync, collectUsedSchemaNames, composeMacros, createPrinter, defineMacro, extractStringsFromNodes, nodes_exports as factory, findCircularSchemas, findCircularSchemasFromGraph, getSchemaLiteralValues, inferDiscriminatorPropertyName, isBareRef, isHttpOperationNode, mergeRefWithSchema, narrowSchema, optionality, refName, resolveRefName, resolveSchemaProperties, schemaTypes, transform };
 
 //# sourceMappingURL=index.js.map