@kubb/ast 5.0.0-beta.15 → 5.0.0-beta.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/ast",
-  "version": "5.0.0-beta.15",
+  "version": "5.0.0-beta.16",
   "description": "Spec-agnostic AST layer for Kubb. Defines the node tree, visitor pattern, factory functions, and type guards used across all code generation plugins.",
   "keywords": [
     "ast",

package/src/factory.ts

@@ -12,7 +12,9 @@ import type {
   FunctionParameterNode,
   FunctionParametersNode,
   ImportNode,
+  InputMeta,
   InputNode,
+  InputStreamNode,
   JsxNode,
   ObjectSchemaNode,
   OperationNode,
@@ -89,6 +91,18 @@ export function createInput(overrides: Partial<Omit<InputNode, 'kind'>> = {}): I
   }
 }
 
+/**
+ * Creates an `InputStreamNode` from pre-built `AsyncIterable` sources.
+ *
+ * @example
+ * ```ts
+ * const node = createStreamInput(schemasIterable, operationsIterable, { title: 'My API' })
+ * ```
+ */
+export function createStreamInput(schemas: AsyncIterable<SchemaNode>, operations: AsyncIterable<OperationNode>, meta?: InputMeta): InputStreamNode {
+  return { kind: 'Input', schemas, operations, meta }
+}
+
 /**
  * Creates an `OutputNode` with a stable default for `files`.
  *

package/src/index.ts

@@ -10,6 +10,7 @@ export {
   createFunctionParameters,
   createImport,
   createInput,
+  createStreamInput,
   createJsx,
   createOperation,
   createOutput,

package/src/nodes/index.ts

@@ -19,7 +19,7 @@ export type { OutputNode } from './output.ts'
 export type { ParameterLocation, ParameterNode } from './parameter.ts'
 export type { PropertyNode } from './property.ts'
 export type { ResponseNode } from './response.ts'
-export type { InputMeta, InputNode } from './root.ts'
+export type { InputMeta, InputNode, InputStreamNode } from './root.ts'
 export type {
   ArraySchemaNode,
   ComplexSchemaType,

package/src/nodes/root.ts

@@ -62,3 +62,27 @@ export type InputNode = BaseNode & {
    */
   meta?: InputMeta
 }
+
+/**
+ * Streaming variant of `InputNode` for memory-efficient processing of large API specs.
+ *
+ * `schemas` and `operations` are `AsyncIterable` rather than arrays — each `for await`
+ * loop creates a fresh parse pass from the cached in-memory document, so multiple
+ * consumers (plugins) can iterate independently without keeping all nodes in memory.
+ *
+ * @example
+ * ```ts
+ * for await (const schema of inputStreamNode.schemas) {
+ *   // only this one SchemaNode is live here; previous ones are GC-eligible
+ * }
+ * ```
+ */
+export type InputStreamNode = {
+  kind: 'Input'
+  /** Lazily parsed schema nodes. Each `for await` creates a fresh parse pass. */
+  schemas: AsyncIterable<SchemaNode>
+  /** Lazily parsed operation nodes. Each `for await` creates a fresh parse pass. */
+  operations: AsyncIterable<OperationNode>
+  /** Document metadata — available immediately, before the first yield. */
+  meta?: InputMeta
+}

package/src/types.ts

@@ -26,6 +26,7 @@ export type {
   ImportNode,
   InputMeta,
   InputNode,
+  InputStreamNode,
   IntersectionSchemaNode,
   Ipv4SchemaNode,
   Ipv6SchemaNode,