@kubb/ast 5.18.0 → 5.18.2

package/dist/index.d.cts

@@ -1157,6 +1157,11 @@ type ParameterNode = BaseNode & {
    * `application/json` when the value is sent as a JSON-encoded string. Absent for `schema` parameters.
    */
   contentType?: string;
+  /**
+   * Serialization settings per property of a `content` parameter, from the `encoding` of its media type. An OpenAPI 3.2
+   * `querystring` parameter sent as `application/x-www-form-urlencoded` uses it to set `style` and `explode` per field.
+   */
+  encoding?: Record<string, EncodingNode>;
   examples?: Array<ExampleNode>;
   deprecated?: boolean;
   allowEmptyValue?: boolean;
@@ -1221,7 +1226,7 @@ type Digit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
 /**
  * Response status code literal used by operations.
  *
- * Includes three-digit HTTP status code strings, ranges such as `"2XX"`, and `"default"` for catch-all responses.
+ * Includes three-digit HTTP status code strings, ranges such as `"2xx"`, and `"default"` for catch-all responses.
  *
  * @example
  * ```ts
@@ -1229,7 +1234,7 @@ type Digit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
  * const fallback: StatusCode = 'default'
  * ```
  */
-type StatusCode = `${1 | 2 | 3 | 4 | 5}${Digit}${Digit}` | `${1 | 2 | 3 | 4 | 5}XX` | 'default';
+type StatusCode = `${1 | 2 | 3 | 4 | 5}${Digit}${Digit}` | `${1 | 2 | 3 | 4 | 5}xx` | 'default';
 /**
  * AST node representing one operation response variant.
  *
@@ -2663,7 +2668,8 @@ export declare function collectSchemaRefs(node: SchemaNode): ReadonlySet<string>
  *
  * Only refs that carry a `$ref` pointer count, so a synthesized ref pointing at a sibling in the
  * same file (a union member created by name) is left out. That leaves exactly the set
- * `resolver.imports` emits.
+ * `resolver.imports` emits. Refs inside `conditionals`, `contains` and `content` count only with
+ * `checks: true`, for a plugin that prints those checks.
  *
  * @example
  * ```ts
@@ -2671,7 +2677,9 @@ export declare function collectSchemaRefs(node: SchemaNode): ReadonlySet<string>
  * // ['Category', 'Tag']
  * ```
  */
-export declare function collectImportedRefNames(node: SchemaNode): ReadonlyArray<string>;
+export declare function collectImportedRefNames(node: SchemaNode, { checks }?: {
+  checks?: boolean;
+}): ReadonlyArray<string>;
 /**
  * Collects the names of all top-level schemas transitively used by a set of operations.
  *

package/dist/index.d.ts

@@ -1157,6 +1157,11 @@ type ParameterNode = BaseNode & {
    * `application/json` when the value is sent as a JSON-encoded string. Absent for `schema` parameters.
    */
   contentType?: string;
+  /**
+   * Serialization settings per property of a `content` parameter, from the `encoding` of its media type. An OpenAPI 3.2
+   * `querystring` parameter sent as `application/x-www-form-urlencoded` uses it to set `style` and `explode` per field.
+   */
+  encoding?: Record<string, EncodingNode>;
   examples?: Array<ExampleNode>;
   deprecated?: boolean;
   allowEmptyValue?: boolean;
@@ -1221,7 +1226,7 @@ type Digit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
 /**
  * Response status code literal used by operations.
  *
- * Includes three-digit HTTP status code strings, ranges such as `"2XX"`, and `"default"` for catch-all responses.
+ * Includes three-digit HTTP status code strings, ranges such as `"2xx"`, and `"default"` for catch-all responses.
  *
  * @example
  * ```ts
@@ -1229,7 +1234,7 @@ type Digit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
  * const fallback: StatusCode = 'default'
  * ```
  */
-type StatusCode = `${1 | 2 | 3 | 4 | 5}${Digit}${Digit}` | `${1 | 2 | 3 | 4 | 5}XX` | 'default';
+type StatusCode = `${1 | 2 | 3 | 4 | 5}${Digit}${Digit}` | `${1 | 2 | 3 | 4 | 5}xx` | 'default';
 /**
  * AST node representing one operation response variant.
  *
@@ -2663,7 +2668,8 @@ export declare function collectSchemaRefs(node: SchemaNode): ReadonlySet<string>
  *
  * Only refs that carry a `$ref` pointer count, so a synthesized ref pointing at a sibling in the
  * same file (a union member created by name) is left out. That leaves exactly the set
- * `resolver.imports` emits.
+ * `resolver.imports` emits. Refs inside `conditionals`, `contains` and `content` count only with
+ * `checks: true`, for a plugin that prints those checks.
  *
  * @example
  * ```ts
@@ -2671,7 +2677,9 @@ export declare function collectSchemaRefs(node: SchemaNode): ReadonlySet<string>
  * // ['Category', 'Tag']
  * ```
  */
-export declare function collectImportedRefNames(node: SchemaNode): ReadonlyArray<string>;
+export declare function collectImportedRefNames(node: SchemaNode, { checks }?: {
+  checks?: boolean;
+}): ReadonlyArray<string>;
 /**
  * Collects the names of all top-level schemas transitively used by a set of operations.
  *

package/dist/index.js

@@ -201,6 +201,15 @@ const VISITOR_KEYS = {
 	Property: ["schema"],
 	Parameter: ["schema"]
 };
+/**
+* Schema fields that hold checks rather than shape: the `conditionals` entries, `contains` and a string's `content`.
+* `transform` and `collect` skip them, and `visitChildNodes` walks them with `checks: true`.
+*/
+const schemaCheckKeys = [
+	"conditionals",
+	"contains",
+	"content"
+];
 /** Visitor callback names in traversal order, the keys of {@link Visitor}. */
 const visitorKeys = [
 	"input",
@@ -251,28 +260,35 @@ function getChildren(node, recurse) {
 	});
 	return children;
 }
-/** Calls `visit` for each direct child node and stops at the first call that returns `true`. */
-function visitChildNodes(node, visit) {
-	const keys = VISITOR_KEYS[node.kind];
+/**
+* Calls `visit` for each direct child node and stops at the first call that returns `true`.
+* With `checks: true`, a schema's {@link schemaCheckKeys} fields are walked too.
+*/
+function visitChildNodes(node, visit, { checks = false } = {}) {
+	const keys = checks && node.kind === nodeKinds.schema ? [...VISITOR_KEYS[node.kind] ?? [], ...schemaCheckKeys] : VISITOR_KEYS[node.kind];
 	if (!keys) return false;
 	const record = node;
 	const seen = /* @__PURE__ */ new Set();
 	const visitOnce = (child) => !seen.has(child) && (seen.add(child), visit(child));
+	const visitRecord = (value) => {
+		for (const name in value) {
+			if (!Object.hasOwn(value, name)) continue;
+			const item = value[name];
+			if (isNode(item) && visitOnce(item)) return true;
+		}
+		return false;
+	};
 	for (const key of keys) {
 		const value = record[key];
 		if (Array.isArray(value)) {
-			for (const item of value) if (isNode(item) && visitOnce(item)) return true;
+			for (const item of value) if (isNode(item) ? visitOnce(item) : isNodeRecord(item) && visitRecord(item)) return true;
 			continue;
 		}
 		if (isNode(value)) {
 			if (visitOnce(value)) return true;
 			continue;
 		}
-		if (isNodeRecord(value)) for (const name in value) {
-			if (!Object.hasOwn(value, name)) continue;
-			const item = value[name];
-			if (isNode(item) && visitOnce(item)) return true;
-		}
+		if (isNodeRecord(value) && visitRecord(value)) return true;
 	}
 	return false;
 }
@@ -1181,23 +1197,33 @@ function memo(store, key, compute) {
 	return value;
 }
 // src/utils/schemaGraph.ts
-/**
-* Walks a node's subtree once and lists every ref it holds, in traversal order, as the resolved
-* name plus whether the ref carries a `$ref` pointer. Memoized by node identity, so
-* `collectSchemaRefs` and `collectImportedRefNames` share one scan per schema.
-*/
 const refEntries = /* @__PURE__ */ new WeakMap();
+const checkRefEntries = /* @__PURE__ */ new WeakMap();
 const schemaRefs = /* @__PURE__ */ new WeakMap();
 const importedRefNames = /* @__PURE__ */ new WeakMap();
-function collectRefEntries(node) {
-	return memo(refEntries, node, () => collectSync(node, { schema(child) {
-		if (child.type !== "ref") return void 0;
-		const name = resolveRefName(child);
-		return name ? {
-			name,
-			hasPointer: Boolean(child.ref)
-		} : void 0;
-	} }));
+const importedCheckRefNames = /* @__PURE__ */ new WeakMap();
+/**
+* Walks a node's subtree once and lists every ref it holds, in traversal order, as the resolved
+* name plus whether the ref carries a `$ref` pointer. Memoized per node and per `checks` mode, so
+* each helper below scans a schema once.
+*/
+function collectRefEntries(node, { checks }) {
+	return memo(checks ? checkRefEntries : refEntries, node, () => {
+		const entries = [];
+		const walk = (current) => {
+			if (current.kind === nodeKinds.schema && current.type === "ref") {
+				const name = resolveRefName(current);
+				if (name) entries.push({
+					name,
+					hasPointer: Boolean(current.ref)
+				});
+			}
+			visitChildNodes(current, walk, { checks });
+			return false;
+		};
+		walk(node);
+		return entries;
+	});
 }
 /**
 * Collects the names of every schema a node's subtree references, resolved with `resolveRefName`.
@@ -1211,7 +1237,7 @@ function collectRefEntries(node) {
 * ```
 */
 function collectSchemaRefs(node) {
-	return memo(schemaRefs, node, () => new Set(collectRefEntries(node).map((entry) => entry.name)));
+	return memo(schemaRefs, node, () => new Set(collectRefEntries(node, { checks: true }).map((entry) => entry.name)));
 }
 /**
 * Collects the de-duplicated target names of every pointer-carrying ref in a node's subtree, in
@@ -1220,7 +1246,8 @@ function collectSchemaRefs(node) {
 *
 * Only refs that carry a `$ref` pointer count, so a synthesized ref pointing at a sibling in the
 * same file (a union member created by name) is left out. That leaves exactly the set
-* `resolver.imports` emits.
+* `resolver.imports` emits. Refs inside `conditionals`, `contains` and `content` count only with
+* `checks: true`, for a plugin that prints those checks.
 *
 * @example
 * ```ts
@@ -1228,8 +1255,8 @@ function collectSchemaRefs(node) {
 * // ['Category', 'Tag']
 * ```
 */
-function collectImportedRefNames(node) {
-	return memo(importedRefNames, node, () => [...new Set(collectRefEntries(node).flatMap((entry) => entry.hasPointer ? [entry.name] : []))]);
+function collectImportedRefNames(node, { checks = false } = {}) {
+	return memo(checks ? importedCheckRefNames : importedRefNames, node, () => [...new Set(collectRefEntries(node, { checks }).flatMap((entry) => entry.hasPointer ? [entry.name] : []))]);
 }
 /**
 * Collects the names of all top-level schemas transitively used by a set of operations.