@kubb/ast 5.0.0-beta.62 → 5.0.0-beta.63

package/dist/{index-CTaN_ee_.d.ts → index-B9cc8MBS.d.ts}

@@ -1,75 +1,5 @@
 import { n as __name } from "./chunk-CNktS9qV.js";
 
-//#region src/dialect.d.ts
-/**
- * The spec-specific questions a schema parser answers while turning a source document into Kubb
- * AST nodes. The rest of the pipeline is generic JSON Schema, so this is the one seam where
- * OpenAPI, AsyncAPI, and plain JSON Schema differ.
- */
-type SchemaDialect<TSchema = unknown, TRef = TSchema, TDiscriminated = TSchema, TDocument = unknown> = {
-  /**
-   * Whether the schema is nullable.
-   */
-  isNullable(schema?: TSchema): boolean;
-  /**
-   * Whether the value is a `$ref` pointer.
-   */
-  isReference(value?: unknown): value is TRef;
-  /**
-   * Whether the schema carries a discriminator for polymorphism.
-   */
-  isDiscriminator(value?: unknown): value is TDiscriminated;
-  /**
-   * Whether the schema is binary data, converted to a `blob` node.
-   */
-  isBinary(schema: TSchema): boolean;
-  /**
-   * Resolves a local `$ref` against the document, or nullish when it cannot.
-   */
-  resolveRef<TResolved>(document: TDocument, ref: string): TResolved | null | undefined;
-  /**
-   * Derives a schema's `optional`/`nullish` flags from a parent's `required` value and the
-   * schema's own `nullable`. How "required" and "nullable" combine is spec-specific, so the
-   * dialect owns it. Method syntax keeps a concrete dialect assignable to the base
-   * `SchemaDialect` (bivariant parameters).
-   */
-  optionality(schema: SchemaNode, required: boolean): SchemaNode;
-};
-/**
- * A spec adapter's dialect. `name` identifies it in logs and diagnostics; `schema` holds the
- * spec-specific schema questions the parser answers.
- */
-type Dialect<TSchema = unknown, TRef = TSchema, TDiscriminated = TSchema, TDocument = unknown> = {
-  /**
-   * Identifies the dialect in logs and diagnostics.
-   */
-  name: string;
-  /**
-   * The spec-specific schema behavior. See {@link SchemaDialect}.
-   */
-  schema: SchemaDialect<TSchema, TRef, TDiscriminated, TDocument>;
-};
-/**
- * Types a {@link Dialect} for an adapter. Adds no runtime behavior and only pins the
- * dialect's type for inference.
- *
- * @example
- * ```ts
- * export const oasDialect = defineDialect({
- *   name: 'oas',
- *   schema: {
- *     isNullable,
- *     isReference,
- *     isDiscriminator,
- *     isBinary: (schema) => schema.type === 'string' && schema.contentMediaType === 'application/octet-stream',
- *     resolveRef,
- *     optionality,
- *   },
- * })
- * ```
- */
-declare function defineDialect<TSchema, TRef, TDiscriminated, TDocument>(dialect: Dialect<TSchema, TRef, TDiscriminated, TDocument>): Dialect<TSchema, TRef, TDiscriminated, TDocument>;
-//#endregion
 //#region src/nodes/base.d.ts
 /**
  * `kind` values used by AST nodes.
@@ -128,11 +58,9 @@ type NodeDef<TNode extends BaseNode = BaseNode, TInput = never> = {
    */
   kind: NodeKind;
   /**
-   * Builds a node from its input, applying `defaults` and the optional `build` hook. An
-   * optional `dialect` is forwarded to `build` so nodes can derive spec-specific fields
-   * (e.g. a schema's `optional`/`nullish`) through `dialect.schema.optionality` when one is given.
+   * Builds a node from its input, applying `defaults` and the optional `build` hook.
    */
-  create: (input: TInput, dialect?: Dialect) => TNode;
+  create: (input: TInput) => TNode;
   /**
    * Type guard matching this node kind.
    */
@@ -149,7 +77,7 @@ type NodeDef<TNode extends BaseNode = BaseNode, TInput = never> = {
 type DefineNodeConfig<TNode extends BaseNode, TInput, TBuilt extends object> = {
   kind: TNode['kind'];
   defaults?: Partial<TNode>;
-  build?: (input: TInput, dialect?: Dialect) => TBuilt;
+  build?: (input: TInput) => TBuilt;
   children?: ReadonlyArray<string>;
   visitorKey?: VisitorKey;
 };
@@ -289,7 +217,10 @@ type FunctionNode = BaseNode & {
    */
   default?: boolean | null;
   /**
-   * Function parameter list rendered as a string (e.g. from `FunctionParams.toConstructor()`).
+   * Function parameter list as a pre-rendered string, written verbatim between the parentheses.
+   *
+   * @example
+   * `'id: string, config: Config = {}'`
    */
   params?: string | null;
   /**
@@ -363,16 +294,16 @@ type TextNode = BaseNode & {
   value: string;
 };
 /**
- * AST node representing a line break in the source output.
+ * AST node representing a blank line in the source output.
  *
- * Corresponds to `<br/>` in JSX components. When printed it produces an empty string,
- * so joining nodes with `\n` in `printNodes` leaves a blank line between the surrounding code.
+ * Corresponds to `<br/>` in JSX components. `printNodes` turns a `Break` between two
+ * statements into one blank line. Consecutive breaks, and breaks at the start or end of
+ * the list, are folded away, so a `Break` never produces more than one blank line.
  *
  * @example
  * ```ts
  * createBreak()
  * // { kind: 'Break' }
- * // prints as '' → blank line when surrounded by other nodes
  * ```
  */
 type BreakNode = BaseNode & {
@@ -441,7 +372,7 @@ declare const jsxDef: NodeDef<JsxNode, string>;
  * // export const pets: Pet[] = ... as const
  * ```
  */
-declare const createConst: (input: Omit<ConstNode, "kind">, dialect?: Dialect) => ConstNode;
+declare const createConst: (input: Omit<ConstNode, "kind">) => ConstNode;
 /**
  * Creates a `TypeNode` representing a TypeScript `type` alias declaration.
  *
@@ -451,7 +382,7 @@ declare const createConst: (input: Omit<ConstNode, "kind">, dialect?: Dialect) =
  * // export type Pet = ...
  * ```
  */
-declare const createType: (input: Omit<TypeNode, "kind">, dialect?: Dialect) => TypeNode;
+declare const createType: (input: Omit<TypeNode, "kind">) => TypeNode;
 /**
  * Creates a `FunctionNode` representing a TypeScript `function` declaration.
  *
@@ -461,7 +392,7 @@ declare const createType: (input: Omit<TypeNode, "kind">, dialect?: Dialect) =>
  * // export async function fetchPet(): Promise<Pet> { ... }
  * ```
  */
-declare const createFunction: (input: Omit<FunctionNode, "kind">, dialect?: Dialect) => FunctionNode;
+declare const createFunction: (input: Omit<FunctionNode, "kind">) => FunctionNode;
 /**
  * Creates an `ArrowFunctionNode` representing a TypeScript arrow function.
  *
@@ -471,7 +402,7 @@ declare const createFunction: (input: Omit<FunctionNode, "kind">, dialect?: Dial
  * // export const double = (n: number) => ...
  * ```
  */
-declare const createArrowFunction: (input: Omit<ArrowFunctionNode, "kind">, dialect?: Dialect) => ArrowFunctionNode;
+declare const createArrowFunction: (input: Omit<ArrowFunctionNode, "kind">) => ArrowFunctionNode;
 /**
  * Creates a {@link TextNode} representing a raw string fragment in the source output.
  *
@@ -481,7 +412,7 @@ declare const createArrowFunction: (input: Omit<ArrowFunctionNode, "kind">, dial
  * // { kind: 'Text', value: 'return fetch(id)' }
  * ```
  */
-declare const createText: (input: string, dialect?: Dialect) => TextNode;
+declare const createText: (input: string) => TextNode;
 /**
  * Creates a {@link BreakNode} representing a line break in the source output.
  *
@@ -501,11 +432,11 @@ declare function createBreak(): BreakNode;
  * // { kind: 'Jsx', value: '<>\n  <a href={href}>Open</a>\n</>' }
  * ```
  */
-declare const createJsx: (input: string, dialect?: Dialect) => JsxNode;
+declare const createJsx: (input: string) => JsxNode;
 //#endregion
 //#region src/infer.d.ts
 /**
- * Shared parser options used by OAS-to-AST inference and parser flows.
+ * Options that control how the adapter parser maps OpenAPI schemas to AST nodes.
  */
 type ParserOptions = {
   /**
@@ -685,9 +616,8 @@ type PropertyNode = BaseNode & {
  */
 type UserPropertyNode = Pick<PropertyNode, 'name' | 'schema'> & Partial<Omit<PropertyNode, 'kind' | 'name' | 'schema'>>;
 /**
- * Definition for the {@link PropertyNode}. `required` defaults to `false`. When a `dialect` is
- * passed to `create`, the schema's `optional`/`nullish` flags are derived through its
- * `optionality`; without one, the schema is left as-is.
+ * Definition for the {@link PropertyNode}. `required` defaults to `false`, and the schema's
+ * `optional`/`nullish` flags are derived from it through {@link optionality}.
  */
 declare const propertyDef: NodeDef<PropertyNode, UserPropertyNode>;
 /**
@@ -703,7 +633,7 @@ declare const propertyDef: NodeDef<PropertyNode, UserPropertyNode>;
  * // required=true, no optional/nullish
  * ```
  */
-declare const createProperty: (input: UserPropertyNode, dialect?: Dialect) => PropertyNode;
+declare const createProperty: (input: UserPropertyNode) => PropertyNode;
 //#endregion
 //#region src/nodes/schema.d.ts
 type PrimitiveSchemaType =
@@ -786,7 +716,7 @@ type SchemaNodeBase = BaseNode & {
   /**
    * Schema name for named definitions (for example, `"Pet"`).
    * Inline schemas omit this field.
-   * `null` means kubb has processed this and determined there is no applicable name.
+   * `null` means Kubb has processed this and determined there is no applicable name.
    * `undefined` means the name has not been set yet.
    */
   name?: string | null;
@@ -868,7 +798,7 @@ type ObjectSchemaNode = SchemaNodeBase & {
   /**
    * Additional object properties behavior:
    * - `true`: allow any value
-   * - `false`: reject unknown properties (maps to `.strict()` in Zod)
+   * - `false`: reject unknown properties
    * - `SchemaNode`: allow values that match that schema
    * - `undefined`: no additional properties constraint (open object)
    */
@@ -1375,7 +1305,7 @@ declare const contentDef: NodeDef<ContentNode, Omit<ContentNode, "kind">>;
 /**
  * Creates a `ContentNode` for a single request-body or response content type.
  */
-declare const createContent: (input: Omit<ContentNode, "kind">, dialect?: Dialect) => ContentNode;
+declare const createContent: (input: Omit<ContentNode, "kind">) => ContentNode;
 //#endregion
 //#region src/nodes/file.d.ts
 /**
@@ -1566,13 +1496,14 @@ type FileNode<TMeta extends object = object> = BaseNode & {
   id: string;
   /**
    * File name without extension, derived from `baseName`.
-   * @link https://nodejs.org/api/path.html#pathformatpathobject
+   *
+   * @see https://nodejs.org/api/path.html#pathformatpathobject
    */
   name: string;
   /**
-   * File base name, including extension.
-   * Based on UNIX basename: `${name}${extname}`
-   * @link https://nodejs.org/api/path.html#pathbasenamepath-suffix
+   * File base name, including extension, shaped like `${name}${extname}`.
+   *
+   * @see https://nodejs.org/api/path.html#pathbasenamepath-suffix
    */
   baseName: `${string}.${string}`;
   /**
@@ -1636,7 +1567,7 @@ declare const fileDef: NodeDef<FileNode<object>, Omit<FileNode<object>, "kind">>
  * // import { useState } from 'react'
  * ```
  */
-declare const createImport: (input: Omit<ImportNode, "kind">, dialect?: Dialect) => ImportNode;
+declare const createImport: (input: Omit<ImportNode, "kind">) => ImportNode;
 /**
  * Creates an `ExportNode` representing a language-agnostic export/public API declaration.
  *
@@ -1646,7 +1577,7 @@ declare const createImport: (input: Omit<ImportNode, "kind">, dialect?: Dialect)
  * // export { Pet } from './Pet'
  * ```
  */
-declare const createExport: (input: Omit<ExportNode, "kind">, dialect?: Dialect) => ExportNode;
+declare const createExport: (input: Omit<ExportNode, "kind">) => ExportNode;
 /**
  * Creates a `SourceNode` representing a fragment of source code within a file.
  *
@@ -1655,7 +1586,7 @@ declare const createExport: (input: Omit<ExportNode, "kind">, dialect?: Dialect)
  * createSource({ name: 'Pet', nodes: [createText('export type Pet = { id: number }')], isExportable: true })
  * ```
  */
-declare const createSource: (input: Omit<SourceNode, "kind">, dialect?: Dialect) => SourceNode;
+declare const createSource: (input: Omit<SourceNode, "kind">) => SourceNode;
 /**
  * Input descriptor for {@link createFile}, before `id`, `name`, and `extname` are computed
  * and `imports`/`exports`/`sources` are deduplicated.
@@ -1897,7 +1828,7 @@ declare const functionParametersDef: NodeDef<FunctionParametersNode, Partial<Omi
  * // { petId: string }
  * ```
  */
-declare const createTypeLiteral: (input: Pick<TypeLiteralNode, "members">, dialect?: Dialect) => TypeLiteralNode;
+declare const createTypeLiteral: (input: Pick<TypeLiteralNode, "members">) => TypeLiteralNode;
 /**
  * Creates an {@link IndexedAccessTypeNode} representing a single field accessed from a named type.
  *
@@ -1907,7 +1838,7 @@ declare const createTypeLiteral: (input: Pick<TypeLiteralNode, "members">, diale
  * // DeletePetPathParams['petId']
  * ```
  */
-declare const createIndexedAccessType: (input: Omit<IndexedAccessTypeNode, "kind">, dialect?: Dialect) => IndexedAccessTypeNode;
+declare const createIndexedAccessType: (input: Omit<IndexedAccessTypeNode, "kind">) => IndexedAccessTypeNode;
 /**
  * Creates an {@link ObjectBindingPatternNode} for a destructured parameter binding.
  *
@@ -1917,7 +1848,7 @@ declare const createIndexedAccessType: (input: Omit<IndexedAccessTypeNode, "kind
  * // { id, name }
  * ```
  */
-declare const createObjectBindingPattern: (input: Pick<ObjectBindingPatternNode, "elements">, dialect?: Dialect) => ObjectBindingPatternNode;
+declare const createObjectBindingPattern: (input: Pick<ObjectBindingPatternNode, "elements">) => ObjectBindingPatternNode;
 /**
  * Creates a `FunctionParameterNode`. `optional` defaults to `false`.
  *
@@ -1933,7 +1864,7 @@ declare const createObjectBindingPattern: (input: Pick<ObjectBindingPatternNode,
  * // → { id, name }: { id: string; name?: string } = {}
  * ```
  */
-declare const createFunctionParameter: (input: FunctionParameterInput, dialect?: Dialect) => FunctionParameterNode;
+declare const createFunctionParameter: (input: FunctionParameterInput) => FunctionParameterNode;
 /**
  * Creates a `FunctionParametersNode` from an ordered list of parameters.
  *
@@ -1998,9 +1929,8 @@ type ParameterNode = BaseNode & {
 };
 type UserParameterNode = Pick<ParameterNode, 'name' | 'in' | 'schema'> & Partial<Omit<ParameterNode, 'kind' | 'name' | 'in' | 'schema'>>;
 /**
- * Definition for the {@link ParameterNode}. `required` defaults to `false`. When a `dialect` is
- * passed to `create`, the schema's `optional`/`nullish` flags are derived through its
- * `optionality`; without one, the schema is left as-is.
+ * Definition for the {@link ParameterNode}. `required` defaults to `false`, and the schema's
+ * `optional`/`nullish` flags are derived from it through {@link optionality}.
  */
 declare const parameterDef: NodeDef<ParameterNode, UserParameterNode>;
 /**
@@ -2016,7 +1946,7 @@ declare const parameterDef: NodeDef<ParameterNode, UserParameterNode>;
  * })
  * ```
  */
-declare const createParameter: (input: UserParameterNode, dialect?: Dialect) => ParameterNode;
+declare const createParameter: (input: UserParameterNode) => ParameterNode;
 //#endregion
 //#region src/nodes/requestBody.d.ts
 /**
@@ -2063,7 +1993,7 @@ declare const requestBodyDef: NodeDef<RequestBodyNode, Omit<RequestBodyNode, "ki
 /**
  * Creates a `RequestBodyNode`.
  */
-declare const createRequestBody: (input: Omit<RequestBodyNode, "kind">, dialect?: Dialect) => RequestBodyNode;
+declare const createRequestBody: (input: Omit<RequestBodyNode, "kind">) => RequestBodyNode;
 //#endregion
 //#region src/nodes/response.d.ts
 /**
@@ -2151,9 +2081,12 @@ declare const responseDef: NodeDef<ResponseNode, ResponseInput>;
  * })
  * ```
  */
-declare const createResponse: (input: ResponseInput, dialect?: Dialect) => ResponseNode;
+declare const createResponse: (input: ResponseInput) => ResponseNode;
 //#endregion
 //#region src/nodes/operation.d.ts
+/**
+ * HTTP method an operation responds to.
+ */
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | 'TRACE';
 /**
  * Transport an operation belongs to.
@@ -2466,5 +2399,5 @@ declare function createOutput(overrides?: Partial<Omit<OutputNode, 'kind'>>): Ou
  */
 type Node = InputNode | OutputNode | OperationNode | SchemaNode | PropertyNode | ParameterNode | ResponseNode | RequestBodyNode | ContentNode | FunctionParamNode | FileNode | ImportNode | ExportNode | SourceNode | ConstNode | TypeNode | FunctionNode | ArrowFunctionNode;
 //#endregion
-export { exportDef as $, textDef as $t, IndexedAccessTypeNode as A, InferSchemaNode as At, functionParametersDef as B, TypeNode as Bt, ParameterNode as C, UrlSchemaNode as Ct, FunctionParamNode as D, UserPropertyNode as Dt, FunctionParamKind as E, PropertyNode as Et, createFunctionParameters as F, ConstNode as Ft, FileNode as G, createBreak as Gt, objectBindingPatternDef as H, breakDef as Ht, createIndexedAccessType as I, FunctionNode as It, UserFileNode as J, createJsx as Jt, ImportNode as K, createConst as Kt, createObjectBindingPattern as L, JSDocNode as Lt, TypeExpression as M, ArrowFunctionNode as Mt, TypeLiteralNode as N, BreakNode as Nt, FunctionParameterNode as O, createProperty as Ot, createFunctionParameter as P, CodeNode as Pt, createSource as Q, jsxDef as Qt, createTypeLiteral as R, JsxNode as Rt, ParameterLocation as S, UnionSchemaNode as St, parameterDef as T, schemaDef as Tt, typeLiteralDef as U, constDef as Ut, indexedAccessTypeDef as V, arrowFunctionDef as Vt, ExportNode as W, createArrowFunction as Wt, createFile as X, createType as Xt, createExport as Y, createText as Yt, createImport as Z, functionDef as Zt, createResponse as _, SchemaNode as _t, InputMeta as a, NodeKind as an, createContent as at, createRequestBody as b, StringSchemaNode as bt, inputDef as c, defineDialect as cn, DatetimeSchemaNode as ct, HttpOperationNode as d, NumberSchemaNode as dt, typeDef as en, fileDef as et, OperationNode as f, ObjectSchemaNode as ft, StatusCode as g, ScalarSchemaType as gt, ResponseNode as h, ScalarSchemaNode as ht, outputDef as i, BaseNode as in, contentDef as it, ObjectBindingPatternNode as j, ParserOptions as jt, FunctionParametersNode as k, propertyDef as kt, GenericOperationNode as l, EnumSchemaNode as lt, operationDef as m, RefSchemaNode as mt, OutputNode as n, NodeDef as nn, sourceDef as nt, InputNode as o, Dialect as on, ArraySchemaNode as ot, createOperation as p, PrimitiveSchemaType as pt, SourceNode as q, createFunction as qt, createOutput as r, defineNode as rn, ContentNode as rt, createInput as s, SchemaDialect as sn, DateSchemaNode as st, Node as t, DistributiveOmit as tn, importDef as tt, HttpMethod as u, IntersectionSchemaNode as ut, responseDef as v, SchemaNodeByType as vt, createParameter as w, createSchema as wt, requestBodyDef as x, TimeSchemaNode as xt, RequestBodyNode as y, SchemaType as yt, functionParameterDef as z, TextNode as zt };
-//# sourceMappingURL=index-CTaN_ee_.d.ts.map
+export { exportDef as $, textDef as $t, IndexedAccessTypeNode as A, InferSchemaNode as At, functionParametersDef as B, TypeNode as Bt, ParameterNode as C, UrlSchemaNode as Ct, FunctionParamNode as D, UserPropertyNode as Dt, FunctionParamKind as E, PropertyNode as Et, createFunctionParameters as F, ConstNode as Ft, FileNode as G, createBreak as Gt, objectBindingPatternDef as H, breakDef as Ht, createIndexedAccessType as I, FunctionNode as It, UserFileNode as J, createJsx as Jt, ImportNode as K, createConst as Kt, createObjectBindingPattern as L, JSDocNode as Lt, TypeExpression as M, ArrowFunctionNode as Mt, TypeLiteralNode as N, BreakNode as Nt, FunctionParameterNode as O, createProperty as Ot, createFunctionParameter as P, CodeNode as Pt, createSource as Q, jsxDef as Qt, createTypeLiteral as R, JsxNode as Rt, ParameterLocation as S, UnionSchemaNode as St, parameterDef as T, schemaDef as Tt, typeLiteralDef as U, constDef as Ut, indexedAccessTypeDef as V, arrowFunctionDef as Vt, ExportNode as W, createArrowFunction as Wt, createFile as X, createType as Xt, createExport as Y, createText as Yt, createImport as Z, functionDef as Zt, createResponse as _, SchemaNode as _t, InputMeta as a, NodeKind as an, createContent as at, createRequestBody as b, StringSchemaNode as bt, inputDef as c, DatetimeSchemaNode as ct, HttpOperationNode as d, NumberSchemaNode as dt, typeDef as en, fileDef as et, OperationNode as f, ObjectSchemaNode as ft, StatusCode as g, ScalarSchemaType as gt, ResponseNode as h, ScalarSchemaNode as ht, outputDef as i, BaseNode as in, contentDef as it, ObjectBindingPatternNode as j, ParserOptions as jt, FunctionParametersNode as k, propertyDef as kt, GenericOperationNode as l, EnumSchemaNode as lt, operationDef as m, RefSchemaNode as mt, OutputNode as n, NodeDef as nn, sourceDef as nt, InputNode as o, ArraySchemaNode as ot, createOperation as p, PrimitiveSchemaType as pt, SourceNode as q, createFunction as qt, createOutput as r, defineNode as rn, ContentNode as rt, createInput as s, DateSchemaNode as st, Node as t, DistributiveOmit as tn, importDef as tt, HttpMethod as u, IntersectionSchemaNode as ut, responseDef as v, SchemaNodeByType as vt, createParameter as w, createSchema as wt, requestBodyDef as x, TimeSchemaNode as xt, RequestBodyNode as y, SchemaType as yt, functionParameterDef as z, TextNode as zt };
+//# sourceMappingURL=index-B9cc8MBS.d.ts.map