@kubb/ast 5.9.5 → 5.10.0

package/dist/index.d.ts

@@ -70,6 +70,8 @@ export declare const schemaTypes: {
    * "All of" multiple schema members.
    */
   readonly intersection: "intersection";
+  /** "Not" a single schema member. */
+  readonly not: "not";
   /**
    * Enum schema.
    */
@@ -462,6 +464,11 @@ type IntersectionSchemaNode = CompositeSchemaNodeBase & {
    */
   type: 'intersection';
 };
+/** Negation from `not`: the value must not match its single member. Printers that cannot express it return `null`. */
+type NotSchemaNode = CompositeSchemaNodeBase & {
+  /** Schema type discriminator. */
+  type: 'not';
+};
 /**
  * One named enum item.
  */
@@ -744,6 +751,7 @@ type SchemaNodeByType = {
   tuple: ArraySchemaNode;
   union: UnionSchemaNode;
   intersection: IntersectionSchemaNode;
+  not: NotSchemaNode;
   enum: EnumSchemaNode;
   ref: RefSchemaNode;
   datetime: DatetimeSchemaNode;
@@ -769,7 +777,7 @@ type SchemaNodeByType = {
 /**
  * Union of all schema node types.
  */
-type SchemaNode = ObjectSchemaNode | ArraySchemaNode | UnionSchemaNode | IntersectionSchemaNode | EnumSchemaNode | RefSchemaNode | DatetimeSchemaNode | DateSchemaNode | TimeSchemaNode | StringSchemaNode | NumberSchemaNode | UrlSchemaNode | FormatStringSchemaNode | ScalarSchemaNode;
+type SchemaNode = ObjectSchemaNode | ArraySchemaNode | UnionSchemaNode | IntersectionSchemaNode | NotSchemaNode | EnumSchemaNode | RefSchemaNode | DatetimeSchemaNode | DateSchemaNode | TimeSchemaNode | StringSchemaNode | NumberSchemaNode | UrlSchemaNode | FormatStringSchemaNode | ScalarSchemaNode;
 type CreateSchemaObjectInput = Omit<ObjectSchemaNode, 'kind' | 'properties' | 'primitive'> & {
   properties?: Array<PropertyNode>;
   primitive?: 'object';
@@ -845,6 +853,11 @@ type ParameterNode = BaseNode & {
    * leaving consumers to apply the default for the style.
    */
   explode?: boolean;
+  /**
+   * Whether reserved characters (RFC 3986 `:/?#[]@!$&'()*+,;=`) are sent as-is instead of
+   * percent-encoded. Only applies to query parameters. Absent when the source omits it.
+   */
+  allowReserved?: boolean;
 };
 type UserParameterNode = Pick<ParameterNode, 'name' | 'in' | 'schema'> & Partial<Omit<ParameterNode, 'kind' | 'name' | 'in' | 'schema'>>;
 /**
@@ -1071,6 +1084,10 @@ type OperationNodeBase = BaseNode & {
    * Operation responses.
    */
   responses: Array<ResponseNode>;
+  /**
+   * Vendor extensions (`x-*` keys) from the source operation, copied as-is. Absent when the source has none.
+   */
+  extensions?: Record<string, unknown>;
 };
 /**
  * Operation served over HTTP. `method` and `path` are guaranteed.
@@ -1783,9 +1800,22 @@ declare function createFile<TMeta extends object = object>(input: UserFileNode<T
 /**
  * A server from the source document, with `{variable}` placeholders filled from their defaults.
  */
+/**
+ * A variable declared by a server URL template.
+ */
+type InputServerVariable = {
+  default?: string;
+  enum?: Array<string>;
+  description?: string;
+};
 type InputServer = {
   url: string;
   description?: string;
+  /**
+   * Variables of the source URL template, copied as-is. `url` already has their defaults filled in, so
+   * this tells a templated server apart from a literal one. Absent when the server declares none.
+   */
+  variables?: Record<string, InputServerVariable>;
 };
 /**
  * An authentication scheme from the source document, keyed by `name`. `parameterName` is the header, query, or cookie name of an `apiKey`.
@@ -1830,6 +1860,10 @@ type InputMeta = {
   baseURL?: string | null;
   servers?: Array<InputServer>;
   securitySchemes?: Array<InputSecurityScheme>;
+  /**
+   * Vendor extensions (`x-*` keys) from the document root, copied as-is. Absent when the root has none.
+   */
+  extensions?: Record<string, unknown>;
   /**
    * Names of schemas that participate in a circular reference chain.
    * Computed once during the adapter pre-scan, so a generator never has to
@@ -2645,8 +2679,8 @@ type ParserOptions = {
   enumSuffix: 'enum' | (string & {});
 };
 declare namespace index_d_exports {
-  export { ArraySchemaNode, ArrowFunctionNode, BreakNode, CodeNode, ConstNode, ContentNode, DateOnlyTypeValue, DateSchemaNode, DateTimeTypeValue, DateTypeOptions, DatetimeSchemaNode, DistributiveOmit, Enforce, EnumSchemaNode, ExportNode, FileNode, FunctionNode, GenericOperationNode, HttpMethod, HttpOperationNode, ImportNode, InputMeta, InputNode, InputSecurityScheme, InputServer, IntersectionSchemaNode, JSDocNode, JsxNode, Macro, Node, NodeKind, NumberSchemaNode, ObjectSchemaNode, OperationNode, ParameterLocation, ParameterNode, ParameterStyle, ParentOf, ParserOptions, PrimitiveSchemaType, Printer, PrinterFactoryOptions, PrinterPartial, PropertyNode, RefSchemaNode, RequestBodyNode, ResponseNode, ScalarSchemaNode, ScalarSchemaType, SchemaNode, SchemaNodeByType, SchemaType, SourceNode, StatusCode, StringSchemaNode, TextNode, TimeSchemaNode, TypeNode, UnionSchemaNode, UrlSchemaNode, UserFileNode, Visitor, VisitorContext, applyMacros, index_d_exports as ast, collect, collectImportedRefNames, collectSchemaRefs, collectSync, collectUsedSchemaNames, composeMacros, createPrinter, defineMacro, extractStringsFromNodes, index_d_exports$1 as factory, findCircularSchemas, findCircularSchemasFromGraph, getSchemaLiteralValues, inferDiscriminatorPropertyName, isBareRef, isHttpOperationNode, mergeRefWithSchema, narrowSchema, optionality, refName, resolveRefName, resolveSchemaProperties, schemaTypes, transform };
+  export { ArraySchemaNode, ArrowFunctionNode, BreakNode, CodeNode, ConstNode, ContentNode, DateOnlyTypeValue, DateSchemaNode, DateTimeTypeValue, DateTypeOptions, DatetimeSchemaNode, DistributiveOmit, Enforce, EnumSchemaNode, ExportNode, FileNode, FunctionNode, GenericOperationNode, HttpMethod, HttpOperationNode, ImportNode, InputMeta, InputNode, InputSecurityScheme, InputServer, IntersectionSchemaNode, JSDocNode, JsxNode, Macro, Node, NodeKind, NotSchemaNode, NumberSchemaNode, ObjectSchemaNode, OperationNode, ParameterLocation, ParameterNode, ParameterStyle, ParentOf, ParserOptions, PrimitiveSchemaType, Printer, PrinterFactoryOptions, PrinterPartial, PropertyNode, RefSchemaNode, RequestBodyNode, ResponseNode, ScalarSchemaNode, ScalarSchemaType, SchemaNode, SchemaNodeByType, SchemaType, SourceNode, StatusCode, StringSchemaNode, TextNode, TimeSchemaNode, TypeNode, UnionSchemaNode, UrlSchemaNode, UserFileNode, Visitor, VisitorContext, applyMacros, index_d_exports as ast, collect, collectImportedRefNames, collectSchemaRefs, collectSync, collectUsedSchemaNames, composeMacros, createPrinter, defineMacro, extractStringsFromNodes, index_d_exports$1 as factory, findCircularSchemas, findCircularSchemasFromGraph, getSchemaLiteralValues, inferDiscriminatorPropertyName, isBareRef, isHttpOperationNode, mergeRefWithSchema, narrowSchema, optionality, refName, resolveRefName, resolveSchemaProperties, schemaTypes, transform };
 }
 //#endregion
-export { type ArraySchemaNode, type ArrowFunctionNode, type BreakNode, type CodeNode, type ConstNode, type ContentNode, type DateOnlyTypeValue, type DateSchemaNode, type DateTimeTypeValue, type DateTypeOptions, type DatetimeSchemaNode, type DistributiveOmit, type Enforce, type EnumSchemaNode, type ExportNode, type FileNode, type FunctionNode, type GenericOperationNode, type HttpMethod, type HttpOperationNode, type ImportNode, type InputMeta, type InputNode, type InputSecurityScheme, type InputServer, type IntersectionSchemaNode, type JSDocNode, type JsxNode, type Macro, type Node, type NodeKind, type NumberSchemaNode, type ObjectSchemaNode, type OperationNode, type ParameterLocation, type ParameterNode, type ParameterStyle, type ParentOf, type ParserOptions, type PrimitiveSchemaType, type Printer, type PrinterFactoryOptions, type PrinterPartial, type PropertyNode, type RefSchemaNode, type RequestBodyNode, type ResponseNode, type ScalarSchemaNode, type ScalarSchemaType, type SchemaNode, type SchemaNodeByType, type SchemaType, type SourceNode, type StatusCode, type StringSchemaNode, type TextNode, type TimeSchemaNode, type TypeNode, type UnionSchemaNode, type UrlSchemaNode, type UserFileNode, type Visitor, type VisitorContext, index_d_exports as ast, index_d_exports$1 as factory };
+export { type ArraySchemaNode, type ArrowFunctionNode, type BreakNode, type CodeNode, type ConstNode, type ContentNode, type DateOnlyTypeValue, type DateSchemaNode, type DateTimeTypeValue, type DateTypeOptions, type DatetimeSchemaNode, type DistributiveOmit, type Enforce, type EnumSchemaNode, type ExportNode, type FileNode, type FunctionNode, type GenericOperationNode, type HttpMethod, type HttpOperationNode, type ImportNode, type InputMeta, type InputNode, type InputSecurityScheme, type InputServer, type IntersectionSchemaNode, type JSDocNode, type JsxNode, type Macro, type Node, type NodeKind, type NotSchemaNode, type NumberSchemaNode, type ObjectSchemaNode, type OperationNode, type ParameterLocation, type ParameterNode, type ParameterStyle, type ParentOf, type ParserOptions, type PrimitiveSchemaType, type Printer, type PrinterFactoryOptions, type PrinterPartial, type PropertyNode, type RefSchemaNode, type RequestBodyNode, type ResponseNode, type ScalarSchemaNode, type ScalarSchemaType, type SchemaNode, type SchemaNodeByType, type SchemaType, type SourceNode, type StatusCode, type StringSchemaNode, type TextNode, type TimeSchemaNode, type TypeNode, type UnionSchemaNode, type UrlSchemaNode, type UserFileNode, type Visitor, type VisitorContext, index_d_exports as ast, index_d_exports$1 as factory };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -64,6 +64,8 @@ const schemaTypes = {
 	* "All of" multiple schema members.
 	*/
 	intersection: "intersection",
+	/** "Not" a single schema member. */
+	not: "not",
 	/**
 	* Enum schema.
 	*/
@@ -1089,16 +1091,17 @@ function mergeByPath(result) {
 }
 /**
 * Deduplicates `SourceNode` objects by `name + isExportable + isTypeOnly`, keeping the first of each
-* key. Unnamed sources fall back to their extracted node strings as the name part of the key. Returns
-* the deduplicated array in original order.
+* key. An unnamed source only drops when the same node appears twice, so markdown can repeat a
+* paragraph or a table. Returns the deduplicated array in original order.
 */
 function combineSources(sources) {
-	const seen = /* @__PURE__ */ new Map();
-	for (const source of sources) {
-		const key = `${source.name ?? extractStringsFromNodes(source.nodes)}:${source.isExportable ?? false}:${source.isTypeOnly ?? false}`;
-		if (!seen.has(key)) seen.set(key, source);
-	}
-	return [...seen.values()];
+	const seen = /* @__PURE__ */ new Set();
+	return sources.filter((source) => {
+		const key = source.name != null ? `${source.name}:${source.isExportable ?? false}:${source.isTypeOnly ?? false}` : source;
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return true;
+	});
 }
 /**
 * Deduplicates and merges `ExportNode` objects by path and type.
@@ -1403,7 +1406,7 @@ function createResponse(props) {
 /**
 * Maps schema `type` to its underlying `primitive`.
 * Primitive types map to themselves and special string formats map to `'string'`.
-* Any type not listed here (such as `ref`, `enum`, `union`, `intersection`, `tuple`, `ipv4`, `ipv6`, `blob`) has no `primitive`.
+* Any type not listed here (such as `ref`, `enum`, `union`, `intersection`, `not`, `tuple`, `ipv4`, `ipv6`, `blob`) has no `primitive`.
 */
 const TYPE_TO_PRIMITIVE = {
 	string: "string",