@kubb/ast 5.0.0-alpha.24 → 5.0.0-alpha.25

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { A as syncOptionality, C as createParameter, Ct as httpMethods, D as createRoot, E as createResponse, Et as schemaTypes, N as ParserOptions, O as createSchema, R as OperationNode, S as createOperation, T as createProperty, Tt as mediaTypes, W as ParameterNode, _ as createPrinterFactory, _t as ParameterGroupNode, at as SchemaNodeByType, b as createFunctionParameter, d as transform, f as walk, g as PrinterFactoryOptions, gt as FunctionParametersNode, ht as FunctionParameterNode, it as SchemaNode, k as createTypeNode, l as collect, m as extractRefName, u as composeTransformers, v as definePrinter, w as createParameterGroup, wt as isScalarPrimitive, x as createFunctionParameters, xt as ScalarPrimitive } from "./visitor-DsdLcLjR.js";
+import { A as syncOptionality, C as createParameter, D as createRoot, Dt as isScalarPrimitive, E as createResponse, Et as httpMethods, N as ParserOptions, O as createSchema, Ot as mediaTypes, R as OperationNode, S as createOperation, T as createProperty, W as ParameterNode, _ as createPrinterFactory, b as createFunctionParameter, bt as ParameterGroupNode, ct as SchemaNodeByType, d as transform, f as walk, g as PrinterFactoryOptions, k as createTypeNode, kt as schemaTypes, l as collect, m as extractRefName, st as SchemaNode, u as composeTransformers, v as definePrinter, vt as FunctionParameterNode, w as createParameterGroup, wt as ScalarPrimitive, x as createFunctionParameters, yt as FunctionParametersNode } from "./visitor-C2XD9px4.js";
 
 //#region src/guards.d.ts
 /**
@@ -107,6 +107,16 @@ declare function simplifyUnion(members: Array<SchemaNode>): Array<SchemaNode>;
 declare function setEnumName(propNode: SchemaNode, parentName: string | null | undefined, propName: string, enumSuffix: string): SchemaNode;
 //#endregion
 //#region src/utils.d.ts
+/**
+ * Returns a merged schema view for a ref node, combining the resolved `node.schema`
+ * (base from the referenced definition) with any usage-site sibling fields set directly
+ * on the ref node (description, readOnly, nullable, deprecated, etc.).
+ *
+ * Usage-site fields take precedence over the resolved schema's own fields when both are defined.
+ *
+ * For non-ref nodes the node itself is returned unchanged.
+ */
+declare function syncSchemaRef(node: SchemaNode): SchemaNode;
 /**
  * Returns `true` when a schema is emitted as a plain `string` type.
  *
@@ -296,5 +306,5 @@ type CreateOperationParamsOptions = {
  */
 declare function createOperationParams(node: OperationNode, options: CreateOperationParamsOptions): FunctionParametersNode;
 //#endregion
-export { type OperationParamsResolver, type ParserOptions, type PrinterFactoryOptions, type ScalarPrimitive, caseParams, childName, collect, collectImports, composeTransformers, createDiscriminantNode, createFunctionParameter, createFunctionParameters, createOperation, createOperationParams, createParameter, createParameterGroup, createPrinterFactory, createProperty, createResponse, createRoot, createSchema, createTypeNode, definePrinter, enumPropName, extractRefName, findDiscriminator, httpMethods, isOperationNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, transform, walk };
+export { type OperationParamsResolver, type ParserOptions, type PrinterFactoryOptions, type ScalarPrimitive, caseParams, childName, collect, collectImports, composeTransformers, createDiscriminantNode, createFunctionParameter, createFunctionParameters, createOperation, createOperationParams, createParameter, createParameterGroup, createPrinterFactory, createProperty, createResponse, createRoot, createSchema, createTypeNode, definePrinter, enumPropName, extractRefName, findDiscriminator, httpMethods, isOperationNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -38,6 +38,8 @@ const schemaTypes = {
 	uuid: "uuid",
 	email: "email",
 	url: "url",
+	ipv4: "ipv4",
+	ipv6: "ipv6",
 	blob: "blob",
 	never: "never"
 };
@@ -159,13 +161,41 @@ function createOperation(props) {
 		kind: "Operation"
 	};
 }
+/**
+* Maps schema `type` to its underlying `primitive`.
+* Primitive types map to themselves; special string formats map to `'string'`.
+* Complex types (`ref`, `enum`, `union`, `intersection`, `tuple`, `blob`) are left unset.
+*/
+const TYPE_TO_PRIMITIVE = {
+	string: "string",
+	number: "number",
+	integer: "integer",
+	bigint: "bigint",
+	boolean: "boolean",
+	null: "null",
+	any: "any",
+	unknown: "unknown",
+	void: "void",
+	never: "never",
+	object: "object",
+	array: "array",
+	date: "date",
+	uuid: "string",
+	email: "string",
+	url: "string",
+	datetime: "string",
+	time: "string"
+};
 function createSchema(props) {
+	const inferredPrimitive = TYPE_TO_PRIMITIVE[props.type];
 	if (props["type"] === "object") return {
 		properties: [],
+		primitive: "object",
 		...props,
 		kind: "Schema"
 	};
 	return {
+		primitive: inferredPrimitive,
 		...props,
 		kind: "Schema"
 	};
@@ -592,11 +622,9 @@ function isValidVarName(name) {
 * @example
 * ```ts
 * const limit = createLimit(2)
-* await Promise.all([
-*   limit(() => taskA()),
-*   limit(() => taskB()),
-*   limit(() => taskC()),
-* ])
+* for (const task of [taskA, taskB, taskC]) {
+*   await limit(() => task())
+* }
 * // only 2 tasks run at the same time
 * ```
 */
@@ -708,7 +736,7 @@ async function _walk(node, visitor, recurse, limit, parent) {
 		case "FunctionParameters": break;
 	}
 	const children = getChildren(node, recurse);
-	await Promise.all(children.map((child) => _walk(child, visitor, recurse, limit, node)));
+	for (const child of children) await _walk(child, visitor, recurse, limit, node);
 }
 function transform(node, options) {
 	const { depth, parent, ...visitor } = options;
@@ -1047,6 +1075,26 @@ const plainStringTypes = new Set([
 	"datetime"
 ]);
 /**
+* Returns a merged schema view for a ref node, combining the resolved `node.schema`
+* (base from the referenced definition) with any usage-site sibling fields set directly
+* on the ref node (description, readOnly, nullable, deprecated, etc.).
+*
+* Usage-site fields take precedence over the resolved schema's own fields when both are defined.
+*
+* For non-ref nodes the node itself is returned unchanged.
+*/
+function syncSchemaRef(node) {
+	const ref = narrowSchema(node, "ref");
+	if (!ref) return node;
+	if (!ref.schema) return node;
+	const { kind: _kind, type: _type, name: _name, ref: _ref, schema: _schema, ...overrides } = ref;
+	const definedOverrides = Object.fromEntries(Object.entries(overrides).filter(([, v]) => v !== void 0));
+	return createSchema({
+		...ref.schema,
+		...definedOverrides
+	});
+}
+/**
 * Returns `true` when a schema is emitted as a plain `string` type.
 *
 * - `string`, `uuid`, `email`, `url`, `datetime` are always plain strings.
@@ -1339,6 +1387,6 @@ function toStructType({ node, params, resolver }) {
 	});
 }
 //#endregion
-export { caseParams, childName, collect, collectImports, composeTransformers, createDiscriminantNode, createFunctionParameter, createFunctionParameters, createOperation, createOperationParams, createParameter, createParameterGroup, createPrinterFactory, createProperty, createResponse, createRoot, createSchema, createTypeNode, definePrinter, enumPropName, extractRefName, findDiscriminator, httpMethods, isOperationNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, transform, walk };
+export { caseParams, childName, collect, collectImports, composeTransformers, createDiscriminantNode, createFunctionParameter, createFunctionParameters, createOperation, createOperationParams, createParameter, createParameterGroup, createPrinterFactory, createProperty, createResponse, createRoot, createSchema, createTypeNode, definePrinter, enumPropName, extractRefName, findDiscriminator, httpMethods, isOperationNode, isScalarPrimitive, isSchemaNode, isStringType, mediaTypes, mergeAdjacentObjects, narrowSchema, schemaTypes, setDiscriminatorEnum, setEnumName, simplifyUnion, syncOptionality, syncSchemaRef, transform, walk };
 
 //# sourceMappingURL=index.js.map