@kubb/ast 4.33.3 → 4.34.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/constants.ts","../src/factory.ts","../src/guards.ts","../src/refs.ts","../src/visitor.ts"],"sourcesContent":["import type { NodeKind } from './nodes/base.ts'\nimport type { MediaType } from './nodes/http.ts'\nimport type { HttpMethod } from './nodes/operation.ts'\nimport type { ParameterLocation } from './nodes/parameter.ts'\nimport type { SchemaType } from './nodes/schema.ts'\n\n/**\n * Depth for schema traversal in visitor functions.\n */\nexport type VisitorDepth = 'shallow' | 'deep'\n\nexport const visitorDepths = {\n  shallow: 'shallow',\n  deep: 'deep',\n} as const satisfies Record<VisitorDepth, VisitorDepth>\n\nexport const nodeKinds = {\n  root: 'Root',\n  operation: 'Operation',\n  schema: 'Schema',\n  property: 'Property',\n  parameter: 'Parameter',\n  response: 'Response',\n} as const satisfies Record<Lowercase<NodeKind>, NodeKind>\n\nexport const schemaTypes = {\n  string: 'string',\n  /**\n   * Floating-point number (`float`, `double`).\n   */\n  number: 'number',\n  /**\n   * Whole number (`int32`). Use `bigint` for `int64`.\n   */\n  integer: 'integer',\n  /**\n   * 64-bit integer (`int64`). Only used when `integerType` is set to `'bigint'`.\n   */\n  bigint: 'bigint',\n  boolean: 'boolean',\n  null: 'null',\n  any: 'any',\n  unknown: 'unknown',\n  void: 'void',\n  object: 'object',\n  array: 'array',\n  tuple: 'tuple',\n  union: 'union',\n  intersection: 'intersection',\n  enum: 'enum',\n  ref: 'ref',\n  date: 'date',\n  datetime: 'datetime',\n  time: 'time',\n  uuid: 'uuid',\n  email: 'email',\n  url: 'url',\n  blob: 'blob',\n} as const satisfies Record<SchemaType, SchemaType>\n\nexport const httpMethods = {\n  get: 'GET',\n  post: 'POST',\n  put: 'PUT',\n  patch: 'PATCH',\n  delete: 'DELETE',\n  head: 'HEAD',\n  options: 'OPTIONS',\n  trace: 'TRACE',\n} as const satisfies Record<Lowercase<HttpMethod>, HttpMethod>\n\nexport const parameterLocations = {\n  path: 'path',\n  query: 'query',\n  header: 'header',\n  cookie: 'cookie',\n} as const satisfies Record<ParameterLocation, ParameterLocation>\n\n/**\n * Fallback status code string for API spec responses.\n */\nexport const DEFAULT_STATUS_CODE = 'default' as const\n\nexport const mediaTypes = {\n  applicationJson: 'application/json',\n  applicationXml: 'application/xml',\n  applicationFormUrlEncoded: 'application/x-www-form-urlencoded',\n  applicationOctetStream: 'application/octet-stream',\n  applicationPdf: 'application/pdf',\n  applicationZip: 'application/zip',\n  applicationGraphql: 'application/graphql',\n  multipartFormData: 'multipart/form-data',\n  textPlain: 'text/plain',\n  textHtml: 'text/html',\n  textCsv: 'text/csv',\n  textXml: 'text/xml',\n  imagePng: 'image/png',\n  imageJpeg: 'image/jpeg',\n  imageGif: 'image/gif',\n  imageWebp: 'image/webp',\n  imageSvgXml: 'image/svg+xml',\n  audioMpeg: 'audio/mpeg',\n  videoMp4: 'video/mp4',\n} as const satisfies Record<string, MediaType>\n","import type { OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Distributive variant of `Omit` that preserves union members.\n */\nexport type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never\n\n/**\n * Creates a `RootNode`.\n */\nexport function createRoot(overrides: Partial<Omit<RootNode, 'kind'>> = {}): RootNode {\n  return {\n    schemas: [],\n    operations: [],\n    ...overrides,\n    kind: 'Root',\n  }\n}\n\n/**\n * Creates an `OperationNode`.\n */\nexport function createOperation(\n  props: Pick<OperationNode, 'operationId' | 'method' | 'path'> & Partial<Omit<OperationNode, 'kind' | 'operationId' | 'method' | 'path'>>,\n): OperationNode {\n  return {\n    tags: [],\n    parameters: [],\n    responses: [],\n    ...props,\n    kind: 'Operation',\n  }\n}\n\n/**\n * Creates a `SchemaNode`, narrowed to the variant of `props.type`.\n */\nexport function createSchema<T extends DistributiveOmit<SchemaNode, 'kind'>>(props: T): T & { kind: 'Schema' } {\n  return { ...props, kind: 'Schema' } as T & { kind: 'Schema' }\n}\n\n/**\n * Creates a `PropertyNode`. `required` defaults to `false`.\n */\nexport function createProperty(props: Pick<PropertyNode, 'name' | 'schema'> & Partial<Omit<PropertyNode, 'kind' | 'name' | 'schema'>>): PropertyNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Property',\n  }\n}\n\n/**\n * Creates a `ParameterNode`. `required` defaults to `false`.\n */\nexport function createParameter(\n  props: Pick<ParameterNode, 'name' | 'in' | 'schema'> & Partial<Omit<ParameterNode, 'kind' | 'name' | 'in' | 'schema'>>,\n): ParameterNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Parameter',\n  }\n}\n\n/**\n * Creates a `ResponseNode`.\n */\nexport function createResponse(props: Pick<ResponseNode, 'statusCode'> & Partial<Omit<ResponseNode, 'kind' | 'statusCode'>>): ResponseNode {\n  return {\n    ...props,\n    kind: 'Response',\n  }\n}\n","import type { Node, NodeKind, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode, SchemaNodeByType } from './nodes/index.ts'\n\n/**\n * Narrows a `SchemaNode` to the specific variant matching `type`.\n */\nexport function narrowSchema<T extends SchemaNode['type']>(node: SchemaNode | undefined, type: T): SchemaNodeByType[T] | undefined {\n  return node?.type === type ? (node as SchemaNodeByType[T]) : undefined\n}\n\nfunction isKind<T extends Node>(kind: NodeKind) {\n  return (node: Node): node is T => node.kind === kind\n}\n\n/**\n * Type guard for `RootNode`.\n */\nexport const isRootNode = isKind<RootNode>('Root')\n\n/**\n * Type guard for `OperationNode`.\n */\nexport const isOperationNode = isKind<OperationNode>('Operation')\n\n/**\n * Type guard for `SchemaNode`.\n */\nexport const isSchemaNode = isKind<SchemaNode>('Schema')\n\n/**\n * Type guard for `PropertyNode`.\n */\nexport const isPropertyNode = isKind<PropertyNode>('Property')\n\n/**\n * Type guard for `ParameterNode`.\n */\nexport const isParameterNode = isKind<ParameterNode>('Parameter')\n\n/**\n * Type guard for `ResponseNode`.\n */\nexport const isResponseNode = isKind<ResponseNode>('Response')\n","import type { RootNode } from './nodes/root.ts'\nimport type { SchemaNode } from './nodes/schema.ts'\n\n/**\n * Schema name to `SchemaNode` mapping.\n */\nexport type RefMap = Map<string, SchemaNode>\n\n/**\n * Indexes named schemas from `root.schemas` by name. Unnamed schemas are skipped.\n */\nexport function buildRefMap(root: RootNode): RefMap {\n  const map: RefMap = new Map()\n\n  for (const schema of root.schemas) {\n    if (schema.name) {\n      map.set(schema.name, schema)\n    }\n  }\n  return map\n}\n\n/**\n * Looks up a schema by name. Prefer over `RefMap.get()` to keep the resolution strategy swappable.\n */\nexport function resolveRef(refMap: RefMap, ref: string): SchemaNode | undefined {\n  return refMap.get(ref)\n}\n\n/**\n * Converts a `RefMap` to a plain object.\n */\nexport function refMapToObject(refMap: RefMap): Record<string, SchemaNode> {\n  return Object.fromEntries(refMap)\n}\n","import type { VisitorDepth } from './constants.ts'\nimport { visitorDepths } from './constants.ts'\nimport type { Node, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Shared options for `walk`, `transform`, and `collect`.\n */\nexport type VisitorOptions = {\n  depth?: VisitorDepth\n}\n\n/**\n * Synchronous visitor for `transform` and `walk`.\n */\nexport interface Visitor {\n  root?(node: RootNode): void | RootNode\n  operation?(node: OperationNode): void | OperationNode\n  schema?(node: SchemaNode): void | SchemaNode\n  property?(node: PropertyNode): void | PropertyNode\n  parameter?(node: ParameterNode): void | ParameterNode\n  response?(node: ResponseNode): void | ResponseNode\n}\n\ntype MaybePromise<T> = T | Promise<T>\n\n/**\n * Async visitor for `walk`. Synchronous `Visitor` objects are compatible.\n */\nexport interface AsyncVisitor {\n  root?(node: RootNode): MaybePromise<void | RootNode>\n  operation?(node: OperationNode): MaybePromise<void | OperationNode>\n  schema?(node: SchemaNode): MaybePromise<void | SchemaNode>\n  property?(node: PropertyNode): MaybePromise<void | PropertyNode>\n  parameter?(node: ParameterNode): MaybePromise<void | ParameterNode>\n  response?(node: ResponseNode): MaybePromise<void | ResponseNode>\n}\n\n/**\n * Visitor for `collect`.\n */\nexport interface CollectVisitor<T> {\n  root?(node: RootNode): T | undefined\n  operation?(node: OperationNode): T | undefined\n  schema?(node: SchemaNode): T | undefined\n  property?(node: PropertyNode): T | undefined\n  parameter?(node: ParameterNode): T | undefined\n  response?(node: ResponseNode): T | undefined\n}\n\n/**\n * Traversable children of `node`, respecting `recurse` for schema nodes.\n */\nfunction getChildren(node: Node, recurse: boolean): Array<Node> {\n  switch (node.kind) {\n    case 'Root':\n      return [...node.schemas, ...node.operations]\n    case 'Operation':\n      return [...node.parameters, ...(node.requestBody ? [node.requestBody] : []), ...node.responses]\n    case 'Schema': {\n      const children: Array<Node> = []\n\n      if (!recurse) return []\n\n      if ('properties' in node && node.properties) children.push(...node.properties)\n      if ('items' in node && node.items) children.push(...node.items)\n      if ('members' in node && node.members) children.push(...node.members)\n\n      return children\n    }\n    case 'Property':\n      return [node.schema]\n    case 'Parameter':\n      return [node.schema]\n    case 'Response':\n      return node.schema ? [node.schema] : []\n  }\n}\n\n/**\n * Depth-first traversal for side effects. Visitor return values are ignored.\n */\nexport async function walk(node: Node, visitor: AsyncVisitor, options: VisitorOptions = {}): Promise<void> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root':\n      await visitor.root?.(node)\n      break\n    case 'Operation':\n      await visitor.operation?.(node)\n      break\n    case 'Schema':\n      await visitor.schema?.(node)\n      break\n    case 'Property':\n      await visitor.property?.(node)\n      break\n    case 'Parameter':\n      await visitor.parameter?.(node)\n      break\n    case 'Response':\n      await visitor.response?.(node)\n      break\n  }\n\n  for (const child of getChildren(node, recurse)) {\n    await walk(child, visitor, options)\n  }\n}\n\n/**\n * Depth-first immutable transformation. Visitor return values replace nodes; `undefined` keeps the original.\n */\nexport function transform(node: RootNode, visitor: Visitor, options?: VisitorOptions): RootNode\nexport function transform(node: OperationNode, visitor: Visitor, options?: VisitorOptions): OperationNode\nexport function transform(node: SchemaNode, visitor: Visitor, options?: VisitorOptions): SchemaNode\nexport function transform(node: PropertyNode, visitor: Visitor, options?: VisitorOptions): PropertyNode\nexport function transform(node: ParameterNode, visitor: Visitor, options?: VisitorOptions): ParameterNode\nexport function transform(node: ResponseNode, visitor: Visitor, options?: VisitorOptions): ResponseNode\nexport function transform(node: Node, visitor: Visitor, options?: VisitorOptions): Node\nexport function transform(node: Node, visitor: Visitor, options: VisitorOptions = {}): Node {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root': {\n      let root = node\n      const replaced = visitor.root?.(root)\n      if (replaced) root = replaced\n\n      return {\n        ...root,\n        schemas: root.schemas.map((s) => transform(s, visitor, options)),\n        operations: root.operations.map((op) => transform(op, visitor, options)),\n      }\n    }\n    case 'Operation': {\n      let op = node\n      const replaced = visitor.operation?.(op)\n      if (replaced) op = replaced\n\n      return {\n        ...op,\n        parameters: op.parameters.map((p) => transform(p, visitor, options)),\n        requestBody: op.requestBody ? transform(op.requestBody, visitor, options) : undefined,\n        responses: op.responses.map((r) => transform(r, visitor, options)),\n      }\n    }\n    case 'Schema': {\n      let schema = node\n      const replaced = visitor.schema?.(schema)\n      if (replaced) schema = replaced\n\n      return {\n        ...schema,\n        ...('properties' in schema && recurse ? { properties: schema.properties?.map((p) => transform(p, visitor, options)) } : {}),\n        ...('items' in schema && recurse ? { items: schema.items?.map((i) => transform(i, visitor, options)) } : {}),\n        ...('members' in schema && recurse ? { members: schema.members?.map((m) => transform(m, visitor, options)) } : {}),\n      }\n    }\n    case 'Property': {\n      let prop = node\n      const replaced = visitor.property?.(prop)\n      if (replaced) prop = replaced\n\n      return {\n        ...prop,\n        schema: transform(prop.schema, visitor, options),\n      }\n    }\n    case 'Parameter': {\n      let param = node\n      const replaced = visitor.parameter?.(param)\n      if (replaced) param = replaced\n\n      return {\n        ...param,\n        schema: transform(param.schema, visitor, options),\n      }\n    }\n    case 'Response': {\n      let response = node\n      const replaced = visitor.response?.(response)\n      if (replaced) response = replaced\n\n      return {\n        ...response,\n        schema: response.schema ? transform(response.schema, visitor, options) : undefined,\n      }\n    }\n  }\n}\n\n/**\n * Depth-first synchronous reduction. Collects non-`undefined` visitor return values into an array.\n */\nexport function collect<T>(node: Node, visitor: CollectVisitor<T>, options: VisitorOptions = {}): Array<T> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n  const results: Array<T> = []\n\n  let v: T | undefined\n  switch (node.kind) {\n    case 'Root':\n      v = visitor.root?.(node)\n      break\n    case 'Operation':\n      v = visitor.operation?.(node)\n      break\n    case 'Schema':\n      v = visitor.schema?.(node)\n      break\n    case 'Property':\n      v = visitor.property?.(node)\n      break\n    case 'Parameter':\n      v = visitor.parameter?.(node)\n      break\n    case 'Response':\n      v = visitor.response?.(node)\n      break\n  }\n  if (v !== undefined) results.push(v)\n\n  for (const child of getChildren(node, recurse)) {\n    for (const item of collect(child, visitor, options)) {\n      results.push(item)\n    }\n  }\n\n  return results\n}\n"],"mappings":";;;;AAWA,MAAa,gBAAgB;CAC3B,SAAS;CACT,MAAM;CACP;AAED,MAAa,YAAY;CACvB,MAAM;CACN,WAAW;CACX,QAAQ;CACR,UAAU;CACV,WAAW;CACX,UAAU;CACX;AAED,MAAa,cAAc;CACzB,QAAQ;CAIR,QAAQ;CAIR,SAAS;CAIT,QAAQ;CACR,SAAS;CACT,MAAM;CACN,KAAK;CACL,SAAS;CACT,MAAM;CACN,QAAQ;CACR,OAAO;CACP,OAAO;CACP,OAAO;CACP,cAAc;CACd,MAAM;CACN,KAAK;CACL,MAAM;CACN,UAAU;CACV,MAAM;CACN,MAAM;CACN,OAAO;CACP,KAAK;CACL,MAAM;CACP;AAED,MAAa,cAAc;CACzB,KAAK;CACL,MAAM;CACN,KAAK;CACL,OAAO;CACP,QAAQ;CACR,MAAM;CACN,SAAS;CACT,OAAO;CACR;AAcD,MAAa,aAAa;CACxB,iBAAiB;CACjB,gBAAgB;CAChB,2BAA2B;CAC3B,wBAAwB;CACxB,gBAAgB;CAChB,gBAAgB;CAChB,oBAAoB;CACpB,mBAAmB;CACnB,WAAW;CACX,UAAU;CACV,SAAS;CACT,SAAS;CACT,UAAU;CACV,WAAW;CACX,UAAU;CACV,WAAW;CACX,aAAa;CACb,WAAW;CACX,UAAU;CACX;;;;;;AC7FD,SAAgB,WAAW,YAA6C,EAAE,EAAY;AACpF,QAAO;EACL,SAAS,EAAE;EACX,YAAY,EAAE;EACd,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,gBACd,OACe;AACf,QAAO;EACL,MAAM,EAAE;EACR,YAAY,EAAE;EACd,WAAW,EAAE;EACb,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,aAA6D,OAAkC;AAC7G,QAAO;EAAE,GAAG;EAAO,MAAM;EAAU;;;;;AAMrC,SAAgB,eAAe,OAAsH;AACnJ,QAAO;EACL,UAAU;EACV,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,gBACd,OACe;AACf,QAAO;EACL,UAAU;EACV,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,eAAe,OAA4G;AACzI,QAAO;EACL,GAAG;EACH,MAAM;EACP;;;;;;;ACnEH,SAAgB,aAA2C,MAA8B,MAA0C;AACjI,QAAO,MAAM,SAAS,OAAQ,OAA+B,KAAA;;AAG/D,SAAS,OAAuB,MAAgB;AAC9C,SAAQ,SAA0B,KAAK,SAAS;;;;;AAMlD,MAAa,aAAa,OAAiB,OAAO;;;;AAKlD,MAAa,kBAAkB,OAAsB,YAAY;;;;AAKjE,MAAa,eAAe,OAAmB,SAAS;;;;AAKxD,MAAa,iBAAiB,OAAqB,WAAW;;;;AAK9D,MAAa,kBAAkB,OAAsB,YAAY;;;;AAKjE,MAAa,iBAAiB,OAAqB,WAAW;;;;;;AC9B9D,SAAgB,YAAY,MAAwB;CAClD,MAAM,sBAAc,IAAI,KAAK;AAE7B,MAAK,MAAM,UAAU,KAAK,QACxB,KAAI,OAAO,KACT,KAAI,IAAI,OAAO,MAAM,OAAO;AAGhC,QAAO;;;;;AAMT,SAAgB,WAAW,QAAgB,KAAqC;AAC9E,QAAO,OAAO,IAAI,IAAI;;;;;AAMxB,SAAgB,eAAe,QAA4C;AACzE,QAAO,OAAO,YAAY,OAAO;;;;;;;ACmBnC,SAAS,YAAY,MAAY,SAA+B;AAC9D,SAAQ,KAAK,MAAb;EACE,KAAK,OACH,QAAO,CAAC,GAAG,KAAK,SAAS,GAAG,KAAK,WAAW;EAC9C,KAAK,YACH,QAAO;GAAC,GAAG,KAAK;GAAY,GAAI,KAAK,cAAc,CAAC,KAAK,YAAY,GAAG,EAAE;GAAG,GAAG,KAAK;GAAU;EACjG,KAAK,UAAU;GACb,MAAM,WAAwB,EAAE;AAEhC,OAAI,CAAC,QAAS,QAAO,EAAE;AAEvB,OAAI,gBAAgB,QAAQ,KAAK,WAAY,UAAS,KAAK,GAAG,KAAK,WAAW;AAC9E,OAAI,WAAW,QAAQ,KAAK,MAAO,UAAS,KAAK,GAAG,KAAK,MAAM;AAC/D,OAAI,aAAa,QAAQ,KAAK,QAAS,UAAS,KAAK,GAAG,KAAK,QAAQ;AAErE,UAAO;;EAET,KAAK,WACH,QAAO,CAAC,KAAK,OAAO;EACtB,KAAK,YACH,QAAO,CAAC,KAAK,OAAO;EACtB,KAAK,WACH,QAAO,KAAK,SAAS,CAAC,KAAK,OAAO,GAAG,EAAE;;;;;;AAO7C,eAAsB,KAAK,MAAY,SAAuB,UAA0B,EAAE,EAAiB;CACzG,MAAM,WAAW,QAAQ,SAAS,cAAc,UAAU,cAAc;AAExE,SAAQ,KAAK,MAAb;EACE,KAAK;AACH,SAAM,QAAQ,OAAO,KAAK;AAC1B;EACF,KAAK;AACH,SAAM,QAAQ,YAAY,KAAK;AAC/B;EACF,KAAK;AACH,SAAM,QAAQ,SAAS,KAAK;AAC5B;EACF,KAAK;AACH,SAAM,QAAQ,WAAW,KAAK;AAC9B;EACF,KAAK;AACH,SAAM,QAAQ,YAAY,KAAK;AAC/B;EACF,KAAK;AACH,SAAM,QAAQ,WAAW,KAAK;AAC9B;;AAGJ,MAAK,MAAM,SAAS,YAAY,MAAM,QAAQ,CAC5C,OAAM,KAAK,OAAO,SAAS,QAAQ;;AAcvC,SAAgB,UAAU,MAAY,SAAkB,UAA0B,EAAE,EAAQ;CAC1F,MAAM,WAAW,QAAQ,SAAS,cAAc,UAAU,cAAc;AAExE,SAAQ,KAAK,MAAb;EACE,KAAK,QAAQ;GACX,IAAI,OAAO;GACX,MAAM,WAAW,QAAQ,OAAO,KAAK;AACrC,OAAI,SAAU,QAAO;AAErB,UAAO;IACL,GAAG;IACH,SAAS,KAAK,QAAQ,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC;IAChE,YAAY,KAAK,WAAW,KAAK,OAAO,UAAU,IAAI,SAAS,QAAQ,CAAC;IACzE;;EAEH,KAAK,aAAa;GAChB,IAAI,KAAK;GACT,MAAM,WAAW,QAAQ,YAAY,GAAG;AACxC,OAAI,SAAU,MAAK;AAEnB,UAAO;IACL,GAAG;IACH,YAAY,GAAG,WAAW,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC;IACpE,aAAa,GAAG,cAAc,UAAU,GAAG,aAAa,SAAS,QAAQ,GAAG,KAAA;IAC5E,WAAW,GAAG,UAAU,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC;IACnE;;EAEH,KAAK,UAAU;GACb,IAAI,SAAS;GACb,MAAM,WAAW,QAAQ,SAAS,OAAO;AACzC,OAAI,SAAU,UAAS;AAEvB,UAAO;IACL,GAAG;IACH,GAAI,gBAAgB,UAAU,UAAU,EAAE,YAAY,OAAO,YAAY,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC,EAAE,GAAG,EAAE;IAC1H,GAAI,WAAW,UAAU,UAAU,EAAE,OAAO,OAAO,OAAO,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC,EAAE,GAAG,EAAE;IAC3G,GAAI,aAAa,UAAU,UAAU,EAAE,SAAS,OAAO,SAAS,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC,EAAE,GAAG,EAAE;IAClH;;EAEH,KAAK,YAAY;GACf,IAAI,OAAO;GACX,MAAM,WAAW,QAAQ,WAAW,KAAK;AACzC,OAAI,SAAU,QAAO;AAErB,UAAO;IACL,GAAG;IACH,QAAQ,UAAU,KAAK,QAAQ,SAAS,QAAQ;IACjD;;EAEH,KAAK,aAAa;GAChB,IAAI,QAAQ;GACZ,MAAM,WAAW,QAAQ,YAAY,MAAM;AAC3C,OAAI,SAAU,SAAQ;AAEtB,UAAO;IACL,GAAG;IACH,QAAQ,UAAU,MAAM,QAAQ,SAAS,QAAQ;IAClD;;EAEH,KAAK,YAAY;GACf,IAAI,WAAW;GACf,MAAM,WAAW,QAAQ,WAAW,SAAS;AAC7C,OAAI,SAAU,YAAW;AAEzB,UAAO;IACL,GAAG;IACH,QAAQ,SAAS,SAAS,UAAU,SAAS,QAAQ,SAAS,QAAQ,GAAG,KAAA;IAC1E;;;;;;;AAQP,SAAgB,QAAW,MAAY,SAA4B,UAA0B,EAAE,EAAY;CACzG,MAAM,WAAW,QAAQ,SAAS,cAAc,UAAU,cAAc;CACxE,MAAM,UAAoB,EAAE;CAE5B,IAAI;AACJ,SAAQ,KAAK,MAAb;EACE,KAAK;AACH,OAAI,QAAQ,OAAO,KAAK;AACxB;EACF,KAAK;AACH,OAAI,QAAQ,YAAY,KAAK;AAC7B;EACF,KAAK;AACH,OAAI,QAAQ,SAAS,KAAK;AAC1B;EACF,KAAK;AACH,OAAI,QAAQ,WAAW,KAAK;AAC5B;EACF,KAAK;AACH,OAAI,QAAQ,YAAY,KAAK;AAC7B;EACF,KAAK;AACH,OAAI,QAAQ,WAAW,KAAK;AAC5B;;AAEJ,KAAI,MAAM,KAAA,EAAW,SAAQ,KAAK,EAAE;AAEpC,MAAK,MAAM,SAAS,YAAY,MAAM,QAAQ,CAC5C,MAAK,MAAM,QAAQ,QAAQ,OAAO,SAAS,QAAQ,CACjD,SAAQ,KAAK,KAAK;AAItB,QAAO"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/constants.ts","../src/factory.ts","../src/guards.ts","../src/refs.ts","../src/visitor.ts"],"sourcesContent":["import type { NodeKind } from './nodes/base.ts'\nimport type { MediaType } from './nodes/http.ts'\nimport type { HttpMethod } from './nodes/operation.ts'\nimport type { ParameterLocation } from './nodes/parameter.ts'\nimport type { SchemaType } from './nodes/schema.ts'\n\n/**\n * Depth for schema traversal in visitor functions.\n */\nexport type VisitorDepth = 'shallow' | 'deep'\n\nexport const visitorDepths = {\n  shallow: 'shallow',\n  deep: 'deep',\n} as const satisfies Record<VisitorDepth, VisitorDepth>\n\nexport const nodeKinds = {\n  root: 'Root',\n  operation: 'Operation',\n  schema: 'Schema',\n  property: 'Property',\n  parameter: 'Parameter',\n  response: 'Response',\n} as const satisfies Record<Lowercase<NodeKind>, NodeKind>\n\nexport const schemaTypes = {\n  string: 'string',\n  /**\n   * Floating-point number (`float`, `double`).\n   */\n  number: 'number',\n  /**\n   * Whole number (`int32`). Use `bigint` for `int64`.\n   */\n  integer: 'integer',\n  /**\n   * 64-bit integer (`int64`). Only used when `integerType` is set to `'bigint'`.\n   */\n  bigint: 'bigint',\n  boolean: 'boolean',\n  null: 'null',\n  any: 'any',\n  unknown: 'unknown',\n  void: 'void',\n  object: 'object',\n  array: 'array',\n  tuple: 'tuple',\n  union: 'union',\n  intersection: 'intersection',\n  enum: 'enum',\n  ref: 'ref',\n  date: 'date',\n  datetime: 'datetime',\n  time: 'time',\n  uuid: 'uuid',\n  email: 'email',\n  url: 'url',\n  blob: 'blob',\n} as const satisfies Record<SchemaType, SchemaType>\n\nexport const httpMethods = {\n  get: 'GET',\n  post: 'POST',\n  put: 'PUT',\n  patch: 'PATCH',\n  delete: 'DELETE',\n  head: 'HEAD',\n  options: 'OPTIONS',\n  trace: 'TRACE',\n} as const satisfies Record<Lowercase<HttpMethod>, HttpMethod>\n\nexport const parameterLocations = {\n  path: 'path',\n  query: 'query',\n  header: 'header',\n  cookie: 'cookie',\n} as const satisfies Record<ParameterLocation, ParameterLocation>\n\n/**\n * Fallback status code string for API spec responses.\n */\nexport const DEFAULT_STATUS_CODE = 'default' as const\n\nexport const mediaTypes = {\n  applicationJson: 'application/json',\n  applicationXml: 'application/xml',\n  applicationFormUrlEncoded: 'application/x-www-form-urlencoded',\n  applicationOctetStream: 'application/octet-stream',\n  applicationPdf: 'application/pdf',\n  applicationZip: 'application/zip',\n  applicationGraphql: 'application/graphql',\n  multipartFormData: 'multipart/form-data',\n  textPlain: 'text/plain',\n  textHtml: 'text/html',\n  textCsv: 'text/csv',\n  textXml: 'text/xml',\n  imagePng: 'image/png',\n  imageJpeg: 'image/jpeg',\n  imageGif: 'image/gif',\n  imageWebp: 'image/webp',\n  imageSvgXml: 'image/svg+xml',\n  audioMpeg: 'audio/mpeg',\n  videoMp4: 'video/mp4',\n} as const satisfies Record<string, MediaType>\n","import type { OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Distributive variant of `Omit` that preserves union members.\n */\nexport type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never\n\n/**\n * Creates a `RootNode`.\n */\nexport function createRoot(overrides: Partial<Omit<RootNode, 'kind'>> = {}): RootNode {\n  return {\n    schemas: [],\n    operations: [],\n    ...overrides,\n    kind: 'Root',\n  }\n}\n\n/**\n * Creates an `OperationNode`.\n */\nexport function createOperation(\n  props: Pick<OperationNode, 'operationId' | 'method' | 'path'> & Partial<Omit<OperationNode, 'kind' | 'operationId' | 'method' | 'path'>>,\n): OperationNode {\n  return {\n    tags: [],\n    parameters: [],\n    responses: [],\n    ...props,\n    kind: 'Operation',\n  }\n}\n\n/**\n * Creates a `SchemaNode`, narrowed to the variant of `props.type`.\n */\nexport function createSchema<T extends DistributiveOmit<SchemaNode, 'kind'>>(props: T): T & { kind: 'Schema' } {\n  return { ...props, kind: 'Schema' } as T & { kind: 'Schema' }\n}\n\n/**\n * Creates a `PropertyNode`. `required` defaults to `false`.\n */\nexport function createProperty(props: Pick<PropertyNode, 'name' | 'schema'> & Partial<Omit<PropertyNode, 'kind' | 'name' | 'schema'>>): PropertyNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Property',\n  }\n}\n\n/**\n * Creates a `ParameterNode`. `required` defaults to `false`.\n */\nexport function createParameter(\n  props: Pick<ParameterNode, 'name' | 'in' | 'schema'> & Partial<Omit<ParameterNode, 'kind' | 'name' | 'in' | 'schema'>>,\n): ParameterNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Parameter',\n  }\n}\n\n/**\n * Creates a `ResponseNode`.\n */\nexport function createResponse(props: Pick<ResponseNode, 'statusCode'> & Partial<Omit<ResponseNode, 'kind' | 'statusCode'>>): ResponseNode {\n  return {\n    ...props,\n    kind: 'Response',\n  }\n}\n","import type { Node, NodeKind, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode, SchemaNodeByType } from './nodes/index.ts'\n\n/**\n * Narrows a `SchemaNode` to the specific variant matching `type`.\n */\nexport function narrowSchema<T extends SchemaNode['type']>(node: SchemaNode | undefined, type: T): SchemaNodeByType[T] | undefined {\n  return node?.type === type ? (node as SchemaNodeByType[T]) : undefined\n}\n\nfunction isKind<T extends Node>(kind: NodeKind) {\n  return (node: Node): node is T => node.kind === kind\n}\n\n/**\n * Type guard for `RootNode`.\n */\nexport const isRootNode = isKind<RootNode>('Root')\n\n/**\n * Type guard for `OperationNode`.\n */\nexport const isOperationNode = isKind<OperationNode>('Operation')\n\n/**\n * Type guard for `SchemaNode`.\n */\nexport const isSchemaNode = isKind<SchemaNode>('Schema')\n\n/**\n * Type guard for `PropertyNode`.\n */\nexport const isPropertyNode = isKind<PropertyNode>('Property')\n\n/**\n * Type guard for `ParameterNode`.\n */\nexport const isParameterNode = isKind<ParameterNode>('Parameter')\n\n/**\n * Type guard for `ResponseNode`.\n */\nexport const isResponseNode = isKind<ResponseNode>('Response')\n","import type { RootNode } from './nodes/root.ts'\nimport type { SchemaNode } from './nodes/schema.ts'\n\n/**\n * Schema name to `SchemaNode` mapping.\n */\nexport type RefMap = Map<string, SchemaNode>\n\n/**\n * Indexes named schemas from `root.schemas` by name. Unnamed schemas are skipped.\n */\nexport function buildRefMap(root: RootNode): RefMap {\n  const map: RefMap = new Map()\n\n  for (const schema of root.schemas) {\n    if (schema.name) {\n      map.set(schema.name, schema)\n    }\n  }\n  return map\n}\n\n/**\n * Looks up a schema by name. Prefer over `RefMap.get()` to keep the resolution strategy swappable.\n */\nexport function resolveRef(refMap: RefMap, ref: string): SchemaNode | undefined {\n  return refMap.get(ref)\n}\n\n/**\n * Converts a `RefMap` to a plain object.\n */\nexport function refMapToObject(refMap: RefMap): Record<string, SchemaNode> {\n  return Object.fromEntries(refMap)\n}\n","import type { VisitorDepth } from './constants.ts'\nimport { visitorDepths } from './constants.ts'\nimport type { Node, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Shared options for `walk`, `transform`, and `collect`.\n */\nexport type VisitorOptions = {\n  depth?: VisitorDepth\n}\n\n/**\n * Synchronous visitor for `transform` and `walk`.\n */\nexport type Visitor = {\n  root?(node: RootNode): void | RootNode\n  operation?(node: OperationNode): void | OperationNode\n  schema?(node: SchemaNode): void | SchemaNode\n  property?(node: PropertyNode): void | PropertyNode\n  parameter?(node: ParameterNode): void | ParameterNode\n  response?(node: ResponseNode): void | ResponseNode\n}\n\ntype MaybePromise<T> = T | Promise<T>\n\n/**\n * Async visitor for `walk`. Synchronous `Visitor` objects are compatible.\n */\nexport type AsyncVisitor = {\n  root?(node: RootNode): MaybePromise<void | RootNode>\n  operation?(node: OperationNode): MaybePromise<void | OperationNode>\n  schema?(node: SchemaNode): MaybePromise<void | SchemaNode>\n  property?(node: PropertyNode): MaybePromise<void | PropertyNode>\n  parameter?(node: ParameterNode): MaybePromise<void | ParameterNode>\n  response?(node: ResponseNode): MaybePromise<void | ResponseNode>\n}\n\n/**\n * Visitor for `collect`.\n */\nexport type CollectVisitor<T> = {\n  root?(node: RootNode): T | undefined\n  operation?(node: OperationNode): T | undefined\n  schema?(node: SchemaNode): T | undefined\n  property?(node: PropertyNode): T | undefined\n  parameter?(node: ParameterNode): T | undefined\n  response?(node: ResponseNode): T | undefined\n}\n\n/**\n * Traversable children of `node`, respecting `recurse` for schema nodes.\n */\nfunction getChildren(node: Node, recurse: boolean): Array<Node> {\n  switch (node.kind) {\n    case 'Root':\n      return [...node.schemas, ...node.operations]\n    case 'Operation':\n      return [...node.parameters, ...(node.requestBody ? [node.requestBody] : []), ...node.responses]\n    case 'Schema': {\n      const children: Array<Node> = []\n\n      if (!recurse) return []\n\n      if ('properties' in node && node.properties) children.push(...node.properties)\n      if ('items' in node && node.items) children.push(...node.items)\n      if ('members' in node && node.members) children.push(...node.members)\n\n      return children\n    }\n    case 'Property':\n      return [node.schema]\n    case 'Parameter':\n      return [node.schema]\n    case 'Response':\n      return node.schema ? [node.schema] : []\n  }\n}\n\n/**\n * Depth-first traversal for side effects. Visitor return values are ignored.\n */\nexport async function walk(node: Node, visitor: AsyncVisitor, options: VisitorOptions = {}): Promise<void> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root':\n      await visitor.root?.(node)\n      break\n    case 'Operation':\n      await visitor.operation?.(node)\n      break\n    case 'Schema':\n      await visitor.schema?.(node)\n      break\n    case 'Property':\n      await visitor.property?.(node)\n      break\n    case 'Parameter':\n      await visitor.parameter?.(node)\n      break\n    case 'Response':\n      await visitor.response?.(node)\n      break\n  }\n\n  for (const child of getChildren(node, recurse)) {\n    await walk(child, visitor, options)\n  }\n}\n\n/**\n * Depth-first immutable transformation. Visitor return values replace nodes; `undefined` keeps the original.\n */\nexport function transform(node: RootNode, visitor: Visitor, options?: VisitorOptions): RootNode\nexport function transform(node: OperationNode, visitor: Visitor, options?: VisitorOptions): OperationNode\nexport function transform(node: SchemaNode, visitor: Visitor, options?: VisitorOptions): SchemaNode\nexport function transform(node: PropertyNode, visitor: Visitor, options?: VisitorOptions): PropertyNode\nexport function transform(node: ParameterNode, visitor: Visitor, options?: VisitorOptions): ParameterNode\nexport function transform(node: ResponseNode, visitor: Visitor, options?: VisitorOptions): ResponseNode\nexport function transform(node: Node, visitor: Visitor, options?: VisitorOptions): Node\nexport function transform(node: Node, visitor: Visitor, options: VisitorOptions = {}): Node {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root': {\n      let root = node\n      const replaced = visitor.root?.(root)\n      if (replaced) root = replaced\n\n      return {\n        ...root,\n        schemas: root.schemas.map((s) => transform(s, visitor, options)),\n        operations: root.operations.map((op) => transform(op, visitor, options)),\n      }\n    }\n    case 'Operation': {\n      let op = node\n      const replaced = visitor.operation?.(op)\n      if (replaced) op = replaced\n\n      return {\n        ...op,\n        parameters: op.parameters.map((p) => transform(p, visitor, options)),\n        requestBody: op.requestBody ? transform(op.requestBody, visitor, options) : undefined,\n        responses: op.responses.map((r) => transform(r, visitor, options)),\n      }\n    }\n    case 'Schema': {\n      let schema = node\n      const replaced = visitor.schema?.(schema)\n      if (replaced) schema = replaced\n\n      return {\n        ...schema,\n        ...('properties' in schema && recurse ? { properties: schema.properties?.map((p) => transform(p, visitor, options)) } : {}),\n        ...('items' in schema && recurse ? { items: schema.items?.map((i) => transform(i, visitor, options)) } : {}),\n        ...('members' in schema && recurse ? { members: schema.members?.map((m) => transform(m, visitor, options)) } : {}),\n      }\n    }\n    case 'Property': {\n      let prop = node\n      const replaced = visitor.property?.(prop)\n      if (replaced) prop = replaced\n\n      return {\n        ...prop,\n        schema: transform(prop.schema, visitor, options),\n      }\n    }\n    case 'Parameter': {\n      let param = node\n      const replaced = visitor.parameter?.(param)\n      if (replaced) param = replaced\n\n      return {\n        ...param,\n        schema: transform(param.schema, visitor, options),\n      }\n    }\n    case 'Response': {\n      let response = node\n      const replaced = visitor.response?.(response)\n      if (replaced) response = replaced\n\n      return {\n        ...response,\n        schema: response.schema ? transform(response.schema, visitor, options) : undefined,\n      }\n    }\n  }\n}\n\n/**\n * Depth-first synchronous reduction. Collects non-`undefined` visitor return values into an array.\n */\nexport function collect<T>(node: Node, visitor: CollectVisitor<T>, options: VisitorOptions = {}): Array<T> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n  const results: Array<T> = []\n\n  let v: T | undefined\n  switch (node.kind) {\n    case 'Root':\n      v = visitor.root?.(node)\n      break\n    case 'Operation':\n      v = visitor.operation?.(node)\n      break\n    case 'Schema':\n      v = visitor.schema?.(node)\n      break\n    case 'Property':\n      v = visitor.property?.(node)\n      break\n    case 'Parameter':\n      v = visitor.parameter?.(node)\n      break\n    case 'Response':\n      v = visitor.response?.(node)\n      break\n  }\n  if (v !== undefined) results.push(v)\n\n  for (const child of getChildren(node, recurse)) {\n    for (const item of collect(child, visitor, options)) {\n      results.push(item)\n    }\n  }\n\n  return results\n}\n"],"mappings":";;;;AAWA,MAAa,gBAAgB;CAC3B,SAAS;CACT,MAAM;CACP;AAED,MAAa,YAAY;CACvB,MAAM;CACN,WAAW;CACX,QAAQ;CACR,UAAU;CACV,WAAW;CACX,UAAU;CACX;AAED,MAAa,cAAc;CACzB,QAAQ;CAIR,QAAQ;CAIR,SAAS;CAIT,QAAQ;CACR,SAAS;CACT,MAAM;CACN,KAAK;CACL,SAAS;CACT,MAAM;CACN,QAAQ;CACR,OAAO;CACP,OAAO;CACP,OAAO;CACP,cAAc;CACd,MAAM;CACN,KAAK;CACL,MAAM;CACN,UAAU;CACV,MAAM;CACN,MAAM;CACN,OAAO;CACP,KAAK;CACL,MAAM;CACP;AAED,MAAa,cAAc;CACzB,KAAK;CACL,MAAM;CACN,KAAK;CACL,OAAO;CACP,QAAQ;CACR,MAAM;CACN,SAAS;CACT,OAAO;CACR;AAcD,MAAa,aAAa;CACxB,iBAAiB;CACjB,gBAAgB;CAChB,2BAA2B;CAC3B,wBAAwB;CACxB,gBAAgB;CAChB,gBAAgB;CAChB,oBAAoB;CACpB,mBAAmB;CACnB,WAAW;CACX,UAAU;CACV,SAAS;CACT,SAAS;CACT,UAAU;CACV,WAAW;CACX,UAAU;CACV,WAAW;CACX,aAAa;CACb,WAAW;CACX,UAAU;CACX;;;;;;AC7FD,SAAgB,WAAW,YAA6C,EAAE,EAAY;AACpF,QAAO;EACL,SAAS,EAAE;EACX,YAAY,EAAE;EACd,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,gBACd,OACe;AACf,QAAO;EACL,MAAM,EAAE;EACR,YAAY,EAAE;EACd,WAAW,EAAE;EACb,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,aAA6D,OAAkC;AAC7G,QAAO;EAAE,GAAG;EAAO,MAAM;EAAU;;;;;AAMrC,SAAgB,eAAe,OAAsH;AACnJ,QAAO;EACL,UAAU;EACV,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,gBACd,OACe;AACf,QAAO;EACL,UAAU;EACV,GAAG;EACH,MAAM;EACP;;;;;AAMH,SAAgB,eAAe,OAA4G;AACzI,QAAO;EACL,GAAG;EACH,MAAM;EACP;;;;;;;ACnEH,SAAgB,aAA2C,MAA8B,MAA0C;AACjI,QAAO,MAAM,SAAS,OAAQ,OAA+B,KAAA;;AAG/D,SAAS,OAAuB,MAAgB;AAC9C,SAAQ,SAA0B,KAAK,SAAS;;;;;AAMlD,MAAa,aAAa,OAAiB,OAAO;;;;AAKlD,MAAa,kBAAkB,OAAsB,YAAY;;;;AAKjE,MAAa,eAAe,OAAmB,SAAS;;;;AAKxD,MAAa,iBAAiB,OAAqB,WAAW;;;;AAK9D,MAAa,kBAAkB,OAAsB,YAAY;;;;AAKjE,MAAa,iBAAiB,OAAqB,WAAW;;;;;;AC9B9D,SAAgB,YAAY,MAAwB;CAClD,MAAM,sBAAc,IAAI,KAAK;AAE7B,MAAK,MAAM,UAAU,KAAK,QACxB,KAAI,OAAO,KACT,KAAI,IAAI,OAAO,MAAM,OAAO;AAGhC,QAAO;;;;;AAMT,SAAgB,WAAW,QAAgB,KAAqC;AAC9E,QAAO,OAAO,IAAI,IAAI;;;;;AAMxB,SAAgB,eAAe,QAA4C;AACzE,QAAO,OAAO,YAAY,OAAO;;;;;;;ACmBnC,SAAS,YAAY,MAAY,SAA+B;AAC9D,SAAQ,KAAK,MAAb;EACE,KAAK,OACH,QAAO,CAAC,GAAG,KAAK,SAAS,GAAG,KAAK,WAAW;EAC9C,KAAK,YACH,QAAO;GAAC,GAAG,KAAK;GAAY,GAAI,KAAK,cAAc,CAAC,KAAK,YAAY,GAAG,EAAE;GAAG,GAAG,KAAK;GAAU;EACjG,KAAK,UAAU;GACb,MAAM,WAAwB,EAAE;AAEhC,OAAI,CAAC,QAAS,QAAO,EAAE;AAEvB,OAAI,gBAAgB,QAAQ,KAAK,WAAY,UAAS,KAAK,GAAG,KAAK,WAAW;AAC9E,OAAI,WAAW,QAAQ,KAAK,MAAO,UAAS,KAAK,GAAG,KAAK,MAAM;AAC/D,OAAI,aAAa,QAAQ,KAAK,QAAS,UAAS,KAAK,GAAG,KAAK,QAAQ;AAErE,UAAO;;EAET,KAAK,WACH,QAAO,CAAC,KAAK,OAAO;EACtB,KAAK,YACH,QAAO,CAAC,KAAK,OAAO;EACtB,KAAK,WACH,QAAO,KAAK,SAAS,CAAC,KAAK,OAAO,GAAG,EAAE;;;;;;AAO7C,eAAsB,KAAK,MAAY,SAAuB,UAA0B,EAAE,EAAiB;CACzG,MAAM,WAAW,QAAQ,SAAS,cAAc,UAAU,cAAc;AAExE,SAAQ,KAAK,MAAb;EACE,KAAK;AACH,SAAM,QAAQ,OAAO,KAAK;AAC1B;EACF,KAAK;AACH,SAAM,QAAQ,YAAY,KAAK;AAC/B;EACF,KAAK;AACH,SAAM,QAAQ,SAAS,KAAK;AAC5B;EACF,KAAK;AACH,SAAM,QAAQ,WAAW,KAAK;AAC9B;EACF,KAAK;AACH,SAAM,QAAQ,YAAY,KAAK;AAC/B;EACF,KAAK;AACH,SAAM,QAAQ,WAAW,KAAK;AAC9B;;AAGJ,MAAK,MAAM,SAAS,YAAY,MAAM,QAAQ,CAC5C,OAAM,KAAK,OAAO,SAAS,QAAQ;;AAcvC,SAAgB,UAAU,MAAY,SAAkB,UAA0B,EAAE,EAAQ;CAC1F,MAAM,WAAW,QAAQ,SAAS,cAAc,UAAU,cAAc;AAExE,SAAQ,KAAK,MAAb;EACE,KAAK,QAAQ;GACX,IAAI,OAAO;GACX,MAAM,WAAW,QAAQ,OAAO,KAAK;AACrC,OAAI,SAAU,QAAO;AAErB,UAAO;IACL,GAAG;IACH,SAAS,KAAK,QAAQ,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC;IAChE,YAAY,KAAK,WAAW,KAAK,OAAO,UAAU,IAAI,SAAS,QAAQ,CAAC;IACzE;;EAEH,KAAK,aAAa;GAChB,IAAI,KAAK;GACT,MAAM,WAAW,QAAQ,YAAY,GAAG;AACxC,OAAI,SAAU,MAAK;AAEnB,UAAO;IACL,GAAG;IACH,YAAY,GAAG,WAAW,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC;IACpE,aAAa,GAAG,cAAc,UAAU,GAAG,aAAa,SAAS,QAAQ,GAAG,KAAA;IAC5E,WAAW,GAAG,UAAU,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC;IACnE;;EAEH,KAAK,UAAU;GACb,IAAI,SAAS;GACb,MAAM,WAAW,QAAQ,SAAS,OAAO;AACzC,OAAI,SAAU,UAAS;AAEvB,UAAO;IACL,GAAG;IACH,GAAI,gBAAgB,UAAU,UAAU,EAAE,YAAY,OAAO,YAAY,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC,EAAE,GAAG,EAAE;IAC1H,GAAI,WAAW,UAAU,UAAU,EAAE,OAAO,OAAO,OAAO,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC,EAAE,GAAG,EAAE;IAC3G,GAAI,aAAa,UAAU,UAAU,EAAE,SAAS,OAAO,SAAS,KAAK,MAAM,UAAU,GAAG,SAAS,QAAQ,CAAC,EAAE,GAAG,EAAE;IAClH;;EAEH,KAAK,YAAY;GACf,IAAI,OAAO;GACX,MAAM,WAAW,QAAQ,WAAW,KAAK;AACzC,OAAI,SAAU,QAAO;AAErB,UAAO;IACL,GAAG;IACH,QAAQ,UAAU,KAAK,QAAQ,SAAS,QAAQ;IACjD;;EAEH,KAAK,aAAa;GAChB,IAAI,QAAQ;GACZ,MAAM,WAAW,QAAQ,YAAY,MAAM;AAC3C,OAAI,SAAU,SAAQ;AAEtB,UAAO;IACL,GAAG;IACH,QAAQ,UAAU,MAAM,QAAQ,SAAS,QAAQ;IAClD;;EAEH,KAAK,YAAY;GACf,IAAI,WAAW;GACf,MAAM,WAAW,QAAQ,WAAW,SAAS;AAC7C,OAAI,SAAU,YAAW;AAEzB,UAAO;IACL,GAAG;IACH,QAAQ,SAAS,SAAS,UAAU,SAAS,QAAQ,SAAS,QAAQ,GAAG,KAAA;IAC1E;;;;;;;AAQP,SAAgB,QAAW,MAAY,SAA4B,UAA0B,EAAE,EAAY;CACzG,MAAM,WAAW,QAAQ,SAAS,cAAc,UAAU,cAAc;CACxE,MAAM,UAAoB,EAAE;CAE5B,IAAI;AACJ,SAAQ,KAAK,MAAb;EACE,KAAK;AACH,OAAI,QAAQ,OAAO,KAAK;AACxB;EACF,KAAK;AACH,OAAI,QAAQ,YAAY,KAAK;AAC7B;EACF,KAAK;AACH,OAAI,QAAQ,SAAS,KAAK;AAC1B;EACF,KAAK;AACH,OAAI,QAAQ,WAAW,KAAK;AAC5B;EACF,KAAK;AACH,OAAI,QAAQ,YAAY,KAAK;AAC7B;EACF,KAAK;AACH,OAAI,QAAQ,WAAW,KAAK;AAC5B;;AAEJ,KAAI,MAAM,KAAA,EAAW,SAAQ,KAAK,EAAE;AAEpC,MAAK,MAAM,SAAS,YAAY,MAAM,QAAQ,CAC5C,MAAK,MAAM,QAAQ,QAAQ,OAAO,SAAS,QAAQ,CACjD,SAAQ,KAAK,KAAK;AAItB,QAAO"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { $ as httpMethods, C as ResponseNode, H as SchemaNode, O as ParameterNode, S as OperationNode, U as SchemaNodeByType, Y as PropertyNode, _ as createRoot, a as collect, b as RootNode, d as resolveRef, et as mediaTypes, g as createResponse, h as createProperty, l as buildRefMap, m as createParameter, nt as schemaTypes, o as transform, p as createOperation, s as walk, tt as nodeKinds, u as refMapToObject, v as createSchema, y as Node } from "./visitor-dtVfQZwX.js";
+import { C as OperationNode, U as SchemaNode, W as SchemaNodeByType, X as PropertyNode, _ as createRoot, a as collect, d as resolveRef, et as httpMethods, g as createResponse, h as createProperty, k as ParameterNode, l as buildRefMap, m as createParameter, nt as nodeKinds, o as transform, p as createOperation, rt as schemaTypes, s as walk, tt as mediaTypes, u as refMapToObject, v as createSchema, w as ResponseNode, x as RootNode, y as Node } from "./visitor-DRohZSfu.js";
 
 //#region src/guards.d.ts
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/constants.ts","../src/factory.ts","../src/guards.ts","../src/refs.ts","../src/visitor.ts"],"sourcesContent":["import type { NodeKind } from './nodes/base.ts'\nimport type { MediaType } from './nodes/http.ts'\nimport type { HttpMethod } from './nodes/operation.ts'\nimport type { ParameterLocation } from './nodes/parameter.ts'\nimport type { SchemaType } from './nodes/schema.ts'\n\n/**\n * Depth for schema traversal in visitor functions.\n */\nexport type VisitorDepth = 'shallow' | 'deep'\n\nexport const visitorDepths = {\n  shallow: 'shallow',\n  deep: 'deep',\n} as const satisfies Record<VisitorDepth, VisitorDepth>\n\nexport const nodeKinds = {\n  root: 'Root',\n  operation: 'Operation',\n  schema: 'Schema',\n  property: 'Property',\n  parameter: 'Parameter',\n  response: 'Response',\n} as const satisfies Record<Lowercase<NodeKind>, NodeKind>\n\nexport const schemaTypes = {\n  string: 'string',\n  /**\n   * Floating-point number (`float`, `double`).\n   */\n  number: 'number',\n  /**\n   * Whole number (`int32`). Use `bigint` for `int64`.\n   */\n  integer: 'integer',\n  /**\n   * 64-bit integer (`int64`). Only used when `integerType` is set to `'bigint'`.\n   */\n  bigint: 'bigint',\n  boolean: 'boolean',\n  null: 'null',\n  any: 'any',\n  unknown: 'unknown',\n  void: 'void',\n  object: 'object',\n  array: 'array',\n  tuple: 'tuple',\n  union: 'union',\n  intersection: 'intersection',\n  enum: 'enum',\n  ref: 'ref',\n  date: 'date',\n  datetime: 'datetime',\n  time: 'time',\n  uuid: 'uuid',\n  email: 'email',\n  url: 'url',\n  blob: 'blob',\n} as const satisfies Record<SchemaType, SchemaType>\n\nexport const httpMethods = {\n  get: 'GET',\n  post: 'POST',\n  put: 'PUT',\n  patch: 'PATCH',\n  delete: 'DELETE',\n  head: 'HEAD',\n  options: 'OPTIONS',\n  trace: 'TRACE',\n} as const satisfies Record<Lowercase<HttpMethod>, HttpMethod>\n\nexport const parameterLocations = {\n  path: 'path',\n  query: 'query',\n  header: 'header',\n  cookie: 'cookie',\n} as const satisfies Record<ParameterLocation, ParameterLocation>\n\n/**\n * Fallback status code string for API spec responses.\n */\nexport const DEFAULT_STATUS_CODE = 'default' as const\n\nexport const mediaTypes = {\n  applicationJson: 'application/json',\n  applicationXml: 'application/xml',\n  applicationFormUrlEncoded: 'application/x-www-form-urlencoded',\n  applicationOctetStream: 'application/octet-stream',\n  applicationPdf: 'application/pdf',\n  applicationZip: 'application/zip',\n  applicationGraphql: 'application/graphql',\n  multipartFormData: 'multipart/form-data',\n  textPlain: 'text/plain',\n  textHtml: 'text/html',\n  textCsv: 'text/csv',\n  textXml: 'text/xml',\n  imagePng: 'image/png',\n  imageJpeg: 'image/jpeg',\n  imageGif: 'image/gif',\n  imageWebp: 'image/webp',\n  imageSvgXml: 'image/svg+xml',\n  audioMpeg: 'audio/mpeg',\n  videoMp4: 'video/mp4',\n} as const satisfies Record<string, MediaType>\n","import type { OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Distributive variant of `Omit` that preserves union members.\n */\nexport type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never\n\n/**\n * Creates a `RootNode`.\n */\nexport function createRoot(overrides: Partial<Omit<RootNode, 'kind'>> = {}): RootNode {\n  return {\n    schemas: [],\n    operations: [],\n    ...overrides,\n    kind: 'Root',\n  }\n}\n\n/**\n * Creates an `OperationNode`.\n */\nexport function createOperation(\n  props: Pick<OperationNode, 'operationId' | 'method' | 'path'> & Partial<Omit<OperationNode, 'kind' | 'operationId' | 'method' | 'path'>>,\n): OperationNode {\n  return {\n    tags: [],\n    parameters: [],\n    responses: [],\n    ...props,\n    kind: 'Operation',\n  }\n}\n\n/**\n * Creates a `SchemaNode`, narrowed to the variant of `props.type`.\n */\nexport function createSchema<T extends DistributiveOmit<SchemaNode, 'kind'>>(props: T): T & { kind: 'Schema' } {\n  return { ...props, kind: 'Schema' } as T & { kind: 'Schema' }\n}\n\n/**\n * Creates a `PropertyNode`. `required` defaults to `false`.\n */\nexport function createProperty(props: Pick<PropertyNode, 'name' | 'schema'> & Partial<Omit<PropertyNode, 'kind' | 'name' | 'schema'>>): PropertyNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Property',\n  }\n}\n\n/**\n * Creates a `ParameterNode`. `required` defaults to `false`.\n */\nexport function createParameter(\n  props: Pick<ParameterNode, 'name' | 'in' | 'schema'> & Partial<Omit<ParameterNode, 'kind' | 'name' | 'in' | 'schema'>>,\n): ParameterNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Parameter',\n  }\n}\n\n/**\n * Creates a `ResponseNode`.\n */\nexport function createResponse(props: Pick<ResponseNode, 'statusCode'> & Partial<Omit<ResponseNode, 'kind' | 'statusCode'>>): ResponseNode {\n  return {\n    ...props,\n    kind: 'Response',\n  }\n}\n","import type { Node, NodeKind, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode, SchemaNodeByType } from './nodes/index.ts'\n\n/**\n * Narrows a `SchemaNode` to the specific variant matching `type`.\n */\nexport function narrowSchema<T extends SchemaNode['type']>(node: SchemaNode | undefined, type: T): SchemaNodeByType[T] | undefined {\n  return node?.type === type ? (node as SchemaNodeByType[T]) : undefined\n}\n\nfunction isKind<T extends Node>(kind: NodeKind) {\n  return (node: Node): node is T => node.kind === kind\n}\n\n/**\n * Type guard for `RootNode`.\n */\nexport const isRootNode = isKind<RootNode>('Root')\n\n/**\n * Type guard for `OperationNode`.\n */\nexport const isOperationNode = isKind<OperationNode>('Operation')\n\n/**\n * Type guard for `SchemaNode`.\n */\nexport const isSchemaNode = isKind<SchemaNode>('Schema')\n\n/**\n * Type guard for `PropertyNode`.\n */\nexport const isPropertyNode = isKind<PropertyNode>('Property')\n\n/**\n * Type guard for `ParameterNode`.\n */\nexport const isParameterNode = isKind<ParameterNode>('Parameter')\n\n/**\n * Type guard for `ResponseNode`.\n */\nexport const isResponseNode = isKind<ResponseNode>('Response')\n","import type { RootNode } from './nodes/root.ts'\nimport type { SchemaNode } from './nodes/schema.ts'\n\n/**\n * Schema name to `SchemaNode` mapping.\n */\nexport type RefMap = Map<string, SchemaNode>\n\n/**\n * Indexes named schemas from `root.schemas` by name. Unnamed schemas are skipped.\n */\nexport function buildRefMap(root: RootNode): RefMap {\n  const map: RefMap = new Map()\n\n  for (const schema of root.schemas) {\n    if (schema.name) {\n      map.set(schema.name, schema)\n    }\n  }\n  return map\n}\n\n/**\n * Looks up a schema by name. Prefer over `RefMap.get()` to keep the resolution strategy swappable.\n */\nexport function resolveRef(refMap: RefMap, ref: string): SchemaNode | undefined {\n  return refMap.get(ref)\n}\n\n/**\n * Converts a `RefMap` to a plain object.\n */\nexport function refMapToObject(refMap: RefMap): Record<string, SchemaNode> {\n  return Object.fromEntries(refMap)\n}\n","import type { VisitorDepth } from './constants.ts'\nimport { visitorDepths } from './constants.ts'\nimport type { Node, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Shared options for `walk`, `transform`, and `collect`.\n */\nexport type VisitorOptions = {\n  depth?: VisitorDepth\n}\n\n/**\n * Synchronous visitor for `transform` and `walk`.\n */\nexport interface Visitor {\n  root?(node: RootNode): void | RootNode\n  operation?(node: OperationNode): void | OperationNode\n  schema?(node: SchemaNode): void | SchemaNode\n  property?(node: PropertyNode): void | PropertyNode\n  parameter?(node: ParameterNode): void | ParameterNode\n  response?(node: ResponseNode): void | ResponseNode\n}\n\ntype MaybePromise<T> = T | Promise<T>\n\n/**\n * Async visitor for `walk`. Synchronous `Visitor` objects are compatible.\n */\nexport interface AsyncVisitor {\n  root?(node: RootNode): MaybePromise<void | RootNode>\n  operation?(node: OperationNode): MaybePromise<void | OperationNode>\n  schema?(node: SchemaNode): MaybePromise<void | SchemaNode>\n  property?(node: PropertyNode): MaybePromise<void | PropertyNode>\n  parameter?(node: ParameterNode): MaybePromise<void | ParameterNode>\n  response?(node: ResponseNode): MaybePromise<void | ResponseNode>\n}\n\n/**\n * Visitor for `collect`.\n */\nexport interface CollectVisitor<T> {\n  root?(node: RootNode): T | undefined\n  operation?(node: OperationNode): T | undefined\n  schema?(node: SchemaNode): T | undefined\n  property?(node: PropertyNode): T | undefined\n  parameter?(node: ParameterNode): T | undefined\n  response?(node: ResponseNode): T | undefined\n}\n\n/**\n * Traversable children of `node`, respecting `recurse` for schema nodes.\n */\nfunction getChildren(node: Node, recurse: boolean): Array<Node> {\n  switch (node.kind) {\n    case 'Root':\n      return [...node.schemas, ...node.operations]\n    case 'Operation':\n      return [...node.parameters, ...(node.requestBody ? [node.requestBody] : []), ...node.responses]\n    case 'Schema': {\n      const children: Array<Node> = []\n\n      if (!recurse) return []\n\n      if ('properties' in node && node.properties) children.push(...node.properties)\n      if ('items' in node && node.items) children.push(...node.items)\n      if ('members' in node && node.members) children.push(...node.members)\n\n      return children\n    }\n    case 'Property':\n      return [node.schema]\n    case 'Parameter':\n      return [node.schema]\n    case 'Response':\n      return node.schema ? [node.schema] : []\n  }\n}\n\n/**\n * Depth-first traversal for side effects. Visitor return values are ignored.\n */\nexport async function walk(node: Node, visitor: AsyncVisitor, options: VisitorOptions = {}): Promise<void> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root':\n      await visitor.root?.(node)\n      break\n    case 'Operation':\n      await visitor.operation?.(node)\n      break\n    case 'Schema':\n      await visitor.schema?.(node)\n      break\n    case 'Property':\n      await visitor.property?.(node)\n      break\n    case 'Parameter':\n      await visitor.parameter?.(node)\n      break\n    case 'Response':\n      await visitor.response?.(node)\n      break\n  }\n\n  for (const child of getChildren(node, recurse)) {\n    await walk(child, visitor, options)\n  }\n}\n\n/**\n * Depth-first immutable transformation. Visitor return values replace nodes; `undefined` keeps the original.\n */\nexport function transform(node: RootNode, visitor: Visitor, options?: VisitorOptions): RootNode\nexport function transform(node: OperationNode, visitor: Visitor, options?: VisitorOptions): OperationNode\nexport function transform(node: SchemaNode, visitor: Visitor, options?: VisitorOptions): SchemaNode\nexport function transform(node: PropertyNode, visitor: Visitor, options?: VisitorOptions): PropertyNode\nexport function transform(node: ParameterNode, visitor: Visitor, options?: VisitorOptions): ParameterNode\nexport function transform(node: ResponseNode, visitor: Visitor, options?: VisitorOptions): ResponseNode\nexport function transform(node: Node, visitor: Visitor, options?: VisitorOptions): Node\nexport function transform(node: Node, visitor: Visitor, options: VisitorOptions = {}): Node {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root': {\n      let root = node\n      const replaced = visitor.root?.(root)\n      if (replaced) root = replaced\n\n      return {\n        ...root,\n        schemas: root.schemas.map((s) => transform(s, visitor, options)),\n        operations: root.operations.map((op) => transform(op, visitor, options)),\n      }\n    }\n    case 'Operation': {\n      let op = node\n      const replaced = visitor.operation?.(op)\n      if (replaced) op = replaced\n\n      return {\n        ...op,\n        parameters: op.parameters.map((p) => transform(p, visitor, options)),\n        requestBody: op.requestBody ? transform(op.requestBody, visitor, options) : undefined,\n        responses: op.responses.map((r) => transform(r, visitor, options)),\n      }\n    }\n    case 'Schema': {\n      let schema = node\n      const replaced = visitor.schema?.(schema)\n      if (replaced) schema = replaced\n\n      return {\n        ...schema,\n        ...('properties' in schema && recurse ? { properties: schema.properties?.map((p) => transform(p, visitor, options)) } : {}),\n        ...('items' in schema && recurse ? { items: schema.items?.map((i) => transform(i, visitor, options)) } : {}),\n        ...('members' in schema && recurse ? { members: schema.members?.map((m) => transform(m, visitor, options)) } : {}),\n      }\n    }\n    case 'Property': {\n      let prop = node\n      const replaced = visitor.property?.(prop)\n      if (replaced) prop = replaced\n\n      return {\n        ...prop,\n        schema: transform(prop.schema, visitor, options),\n      }\n    }\n    case 'Parameter': {\n      let param = node\n      const replaced = visitor.parameter?.(param)\n      if (replaced) param = replaced\n\n      return {\n        ...param,\n        schema: transform(param.schema, visitor, options),\n      }\n    }\n    case 'Response': {\n      let response = node\n      const replaced = visitor.response?.(response)\n      if (replaced) response = replaced\n\n      return {\n        ...response,\n        schema: response.schema ? transform(response.schema, visitor, options) : undefined,\n      }\n    }\n  }\n}\n\n/**\n * Depth-first synchronous reduction. Collects non-`undefined` visitor return values into an array.\n */\nexport function collect<T>(node: Node, visitor: CollectVisitor<T>, options: VisitorOptions = {}): Array<T> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n  const results: Array<T> = []\n\n  let v: T | undefined\n  switch (node.kind) {\n    case 'Root':\n      v = visitor.root?.(node)\n      break\n    case 'Operation':\n      v = visitor.operation?.(node)\n      break\n    case 'Schema':\n      v = visitor.schema?.(node)\n      break\n    case 'Property':\n      v = visitor.property?.(node)\n      break\n    case 'Parameter':\n      v = visitor.parameter?.(node)\n      break\n    case 'Response':\n      v = visitor.response?.(node)\n      break\n  }\n  if (v !== undefined) results.push(v)\n\n  for (const child of getChildren(node, recurse)) {\n    for (const item of collect(child, visitor, options)) {\n      results.push(item)\n    }\n  }\n\n  return results\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/constants.ts","../src/factory.ts","../src/guards.ts","../src/refs.ts","../src/visitor.ts"],"sourcesContent":["import type { NodeKind } from './nodes/base.ts'\nimport type { MediaType } from './nodes/http.ts'\nimport type { HttpMethod } from './nodes/operation.ts'\nimport type { ParameterLocation } from './nodes/parameter.ts'\nimport type { SchemaType } from './nodes/schema.ts'\n\n/**\n * Depth for schema traversal in visitor functions.\n */\nexport type VisitorDepth = 'shallow' | 'deep'\n\nexport const visitorDepths = {\n  shallow: 'shallow',\n  deep: 'deep',\n} as const satisfies Record<VisitorDepth, VisitorDepth>\n\nexport const nodeKinds = {\n  root: 'Root',\n  operation: 'Operation',\n  schema: 'Schema',\n  property: 'Property',\n  parameter: 'Parameter',\n  response: 'Response',\n} as const satisfies Record<Lowercase<NodeKind>, NodeKind>\n\nexport const schemaTypes = {\n  string: 'string',\n  /**\n   * Floating-point number (`float`, `double`).\n   */\n  number: 'number',\n  /**\n   * Whole number (`int32`). Use `bigint` for `int64`.\n   */\n  integer: 'integer',\n  /**\n   * 64-bit integer (`int64`). Only used when `integerType` is set to `'bigint'`.\n   */\n  bigint: 'bigint',\n  boolean: 'boolean',\n  null: 'null',\n  any: 'any',\n  unknown: 'unknown',\n  void: 'void',\n  object: 'object',\n  array: 'array',\n  tuple: 'tuple',\n  union: 'union',\n  intersection: 'intersection',\n  enum: 'enum',\n  ref: 'ref',\n  date: 'date',\n  datetime: 'datetime',\n  time: 'time',\n  uuid: 'uuid',\n  email: 'email',\n  url: 'url',\n  blob: 'blob',\n} as const satisfies Record<SchemaType, SchemaType>\n\nexport const httpMethods = {\n  get: 'GET',\n  post: 'POST',\n  put: 'PUT',\n  patch: 'PATCH',\n  delete: 'DELETE',\n  head: 'HEAD',\n  options: 'OPTIONS',\n  trace: 'TRACE',\n} as const satisfies Record<Lowercase<HttpMethod>, HttpMethod>\n\nexport const parameterLocations = {\n  path: 'path',\n  query: 'query',\n  header: 'header',\n  cookie: 'cookie',\n} as const satisfies Record<ParameterLocation, ParameterLocation>\n\n/**\n * Fallback status code string for API spec responses.\n */\nexport const DEFAULT_STATUS_CODE = 'default' as const\n\nexport const mediaTypes = {\n  applicationJson: 'application/json',\n  applicationXml: 'application/xml',\n  applicationFormUrlEncoded: 'application/x-www-form-urlencoded',\n  applicationOctetStream: 'application/octet-stream',\n  applicationPdf: 'application/pdf',\n  applicationZip: 'application/zip',\n  applicationGraphql: 'application/graphql',\n  multipartFormData: 'multipart/form-data',\n  textPlain: 'text/plain',\n  textHtml: 'text/html',\n  textCsv: 'text/csv',\n  textXml: 'text/xml',\n  imagePng: 'image/png',\n  imageJpeg: 'image/jpeg',\n  imageGif: 'image/gif',\n  imageWebp: 'image/webp',\n  imageSvgXml: 'image/svg+xml',\n  audioMpeg: 'audio/mpeg',\n  videoMp4: 'video/mp4',\n} as const satisfies Record<string, MediaType>\n","import type { OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Distributive variant of `Omit` that preserves union members.\n */\nexport type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never\n\n/**\n * Creates a `RootNode`.\n */\nexport function createRoot(overrides: Partial<Omit<RootNode, 'kind'>> = {}): RootNode {\n  return {\n    schemas: [],\n    operations: [],\n    ...overrides,\n    kind: 'Root',\n  }\n}\n\n/**\n * Creates an `OperationNode`.\n */\nexport function createOperation(\n  props: Pick<OperationNode, 'operationId' | 'method' | 'path'> & Partial<Omit<OperationNode, 'kind' | 'operationId' | 'method' | 'path'>>,\n): OperationNode {\n  return {\n    tags: [],\n    parameters: [],\n    responses: [],\n    ...props,\n    kind: 'Operation',\n  }\n}\n\n/**\n * Creates a `SchemaNode`, narrowed to the variant of `props.type`.\n */\nexport function createSchema<T extends DistributiveOmit<SchemaNode, 'kind'>>(props: T): T & { kind: 'Schema' } {\n  return { ...props, kind: 'Schema' } as T & { kind: 'Schema' }\n}\n\n/**\n * Creates a `PropertyNode`. `required` defaults to `false`.\n */\nexport function createProperty(props: Pick<PropertyNode, 'name' | 'schema'> & Partial<Omit<PropertyNode, 'kind' | 'name' | 'schema'>>): PropertyNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Property',\n  }\n}\n\n/**\n * Creates a `ParameterNode`. `required` defaults to `false`.\n */\nexport function createParameter(\n  props: Pick<ParameterNode, 'name' | 'in' | 'schema'> & Partial<Omit<ParameterNode, 'kind' | 'name' | 'in' | 'schema'>>,\n): ParameterNode {\n  return {\n    required: false,\n    ...props,\n    kind: 'Parameter',\n  }\n}\n\n/**\n * Creates a `ResponseNode`.\n */\nexport function createResponse(props: Pick<ResponseNode, 'statusCode'> & Partial<Omit<ResponseNode, 'kind' | 'statusCode'>>): ResponseNode {\n  return {\n    ...props,\n    kind: 'Response',\n  }\n}\n","import type { Node, NodeKind, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode, SchemaNodeByType } from './nodes/index.ts'\n\n/**\n * Narrows a `SchemaNode` to the specific variant matching `type`.\n */\nexport function narrowSchema<T extends SchemaNode['type']>(node: SchemaNode | undefined, type: T): SchemaNodeByType[T] | undefined {\n  return node?.type === type ? (node as SchemaNodeByType[T]) : undefined\n}\n\nfunction isKind<T extends Node>(kind: NodeKind) {\n  return (node: Node): node is T => node.kind === kind\n}\n\n/**\n * Type guard for `RootNode`.\n */\nexport const isRootNode = isKind<RootNode>('Root')\n\n/**\n * Type guard for `OperationNode`.\n */\nexport const isOperationNode = isKind<OperationNode>('Operation')\n\n/**\n * Type guard for `SchemaNode`.\n */\nexport const isSchemaNode = isKind<SchemaNode>('Schema')\n\n/**\n * Type guard for `PropertyNode`.\n */\nexport const isPropertyNode = isKind<PropertyNode>('Property')\n\n/**\n * Type guard for `ParameterNode`.\n */\nexport const isParameterNode = isKind<ParameterNode>('Parameter')\n\n/**\n * Type guard for `ResponseNode`.\n */\nexport const isResponseNode = isKind<ResponseNode>('Response')\n","import type { RootNode } from './nodes/root.ts'\nimport type { SchemaNode } from './nodes/schema.ts'\n\n/**\n * Schema name to `SchemaNode` mapping.\n */\nexport type RefMap = Map<string, SchemaNode>\n\n/**\n * Indexes named schemas from `root.schemas` by name. Unnamed schemas are skipped.\n */\nexport function buildRefMap(root: RootNode): RefMap {\n  const map: RefMap = new Map()\n\n  for (const schema of root.schemas) {\n    if (schema.name) {\n      map.set(schema.name, schema)\n    }\n  }\n  return map\n}\n\n/**\n * Looks up a schema by name. Prefer over `RefMap.get()` to keep the resolution strategy swappable.\n */\nexport function resolveRef(refMap: RefMap, ref: string): SchemaNode | undefined {\n  return refMap.get(ref)\n}\n\n/**\n * Converts a `RefMap` to a plain object.\n */\nexport function refMapToObject(refMap: RefMap): Record<string, SchemaNode> {\n  return Object.fromEntries(refMap)\n}\n","import type { VisitorDepth } from './constants.ts'\nimport { visitorDepths } from './constants.ts'\nimport type { Node, OperationNode, ParameterNode, PropertyNode, ResponseNode, RootNode, SchemaNode } from './nodes/index.ts'\n\n/**\n * Shared options for `walk`, `transform`, and `collect`.\n */\nexport type VisitorOptions = {\n  depth?: VisitorDepth\n}\n\n/**\n * Synchronous visitor for `transform` and `walk`.\n */\nexport type Visitor = {\n  root?(node: RootNode): void | RootNode\n  operation?(node: OperationNode): void | OperationNode\n  schema?(node: SchemaNode): void | SchemaNode\n  property?(node: PropertyNode): void | PropertyNode\n  parameter?(node: ParameterNode): void | ParameterNode\n  response?(node: ResponseNode): void | ResponseNode\n}\n\ntype MaybePromise<T> = T | Promise<T>\n\n/**\n * Async visitor for `walk`. Synchronous `Visitor` objects are compatible.\n */\nexport type AsyncVisitor = {\n  root?(node: RootNode): MaybePromise<void | RootNode>\n  operation?(node: OperationNode): MaybePromise<void | OperationNode>\n  schema?(node: SchemaNode): MaybePromise<void | SchemaNode>\n  property?(node: PropertyNode): MaybePromise<void | PropertyNode>\n  parameter?(node: ParameterNode): MaybePromise<void | ParameterNode>\n  response?(node: ResponseNode): MaybePromise<void | ResponseNode>\n}\n\n/**\n * Visitor for `collect`.\n */\nexport type CollectVisitor<T> = {\n  root?(node: RootNode): T | undefined\n  operation?(node: OperationNode): T | undefined\n  schema?(node: SchemaNode): T | undefined\n  property?(node: PropertyNode): T | undefined\n  parameter?(node: ParameterNode): T | undefined\n  response?(node: ResponseNode): T | undefined\n}\n\n/**\n * Traversable children of `node`, respecting `recurse` for schema nodes.\n */\nfunction getChildren(node: Node, recurse: boolean): Array<Node> {\n  switch (node.kind) {\n    case 'Root':\n      return [...node.schemas, ...node.operations]\n    case 'Operation':\n      return [...node.parameters, ...(node.requestBody ? [node.requestBody] : []), ...node.responses]\n    case 'Schema': {\n      const children: Array<Node> = []\n\n      if (!recurse) return []\n\n      if ('properties' in node && node.properties) children.push(...node.properties)\n      if ('items' in node && node.items) children.push(...node.items)\n      if ('members' in node && node.members) children.push(...node.members)\n\n      return children\n    }\n    case 'Property':\n      return [node.schema]\n    case 'Parameter':\n      return [node.schema]\n    case 'Response':\n      return node.schema ? [node.schema] : []\n  }\n}\n\n/**\n * Depth-first traversal for side effects. Visitor return values are ignored.\n */\nexport async function walk(node: Node, visitor: AsyncVisitor, options: VisitorOptions = {}): Promise<void> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root':\n      await visitor.root?.(node)\n      break\n    case 'Operation':\n      await visitor.operation?.(node)\n      break\n    case 'Schema':\n      await visitor.schema?.(node)\n      break\n    case 'Property':\n      await visitor.property?.(node)\n      break\n    case 'Parameter':\n      await visitor.parameter?.(node)\n      break\n    case 'Response':\n      await visitor.response?.(node)\n      break\n  }\n\n  for (const child of getChildren(node, recurse)) {\n    await walk(child, visitor, options)\n  }\n}\n\n/**\n * Depth-first immutable transformation. Visitor return values replace nodes; `undefined` keeps the original.\n */\nexport function transform(node: RootNode, visitor: Visitor, options?: VisitorOptions): RootNode\nexport function transform(node: OperationNode, visitor: Visitor, options?: VisitorOptions): OperationNode\nexport function transform(node: SchemaNode, visitor: Visitor, options?: VisitorOptions): SchemaNode\nexport function transform(node: PropertyNode, visitor: Visitor, options?: VisitorOptions): PropertyNode\nexport function transform(node: ParameterNode, visitor: Visitor, options?: VisitorOptions): ParameterNode\nexport function transform(node: ResponseNode, visitor: Visitor, options?: VisitorOptions): ResponseNode\nexport function transform(node: Node, visitor: Visitor, options?: VisitorOptions): Node\nexport function transform(node: Node, visitor: Visitor, options: VisitorOptions = {}): Node {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n\n  switch (node.kind) {\n    case 'Root': {\n      let root = node\n      const replaced = visitor.root?.(root)\n      if (replaced) root = replaced\n\n      return {\n        ...root,\n        schemas: root.schemas.map((s) => transform(s, visitor, options)),\n        operations: root.operations.map((op) => transform(op, visitor, options)),\n      }\n    }\n    case 'Operation': {\n      let op = node\n      const replaced = visitor.operation?.(op)\n      if (replaced) op = replaced\n\n      return {\n        ...op,\n        parameters: op.parameters.map((p) => transform(p, visitor, options)),\n        requestBody: op.requestBody ? transform(op.requestBody, visitor, options) : undefined,\n        responses: op.responses.map((r) => transform(r, visitor, options)),\n      }\n    }\n    case 'Schema': {\n      let schema = node\n      const replaced = visitor.schema?.(schema)\n      if (replaced) schema = replaced\n\n      return {\n        ...schema,\n        ...('properties' in schema && recurse ? { properties: schema.properties?.map((p) => transform(p, visitor, options)) } : {}),\n        ...('items' in schema && recurse ? { items: schema.items?.map((i) => transform(i, visitor, options)) } : {}),\n        ...('members' in schema && recurse ? { members: schema.members?.map((m) => transform(m, visitor, options)) } : {}),\n      }\n    }\n    case 'Property': {\n      let prop = node\n      const replaced = visitor.property?.(prop)\n      if (replaced) prop = replaced\n\n      return {\n        ...prop,\n        schema: transform(prop.schema, visitor, options),\n      }\n    }\n    case 'Parameter': {\n      let param = node\n      const replaced = visitor.parameter?.(param)\n      if (replaced) param = replaced\n\n      return {\n        ...param,\n        schema: transform(param.schema, visitor, options),\n      }\n    }\n    case 'Response': {\n      let response = node\n      const replaced = visitor.response?.(response)\n      if (replaced) response = replaced\n\n      return {\n        ...response,\n        schema: response.schema ? transform(response.schema, visitor, options) : undefined,\n      }\n    }\n  }\n}\n\n/**\n * Depth-first synchronous reduction. Collects non-`undefined` visitor return values into an array.\n */\nexport function collect<T>(node: Node, visitor: CollectVisitor<T>, options: VisitorOptions = {}): Array<T> {\n  const recurse = (options.depth ?? visitorDepths.deep) === visitorDepths.deep\n  const results: Array<T> = []\n\n  let v: T | undefined\n  switch (node.kind) {\n    case 'Root':\n      v = visitor.root?.(node)\n      break\n    case 'Operation':\n      v = visitor.operation?.(node)\n      break\n    case 'Schema':\n      v = visitor.schema?.(node)\n      break\n    case 'Property':\n      v = visitor.property?.(node)\n      break\n    case 'Parameter':\n      v = visitor.parameter?.(node)\n      break\n    case 'Response':\n      v = visitor.response?.(node)\n      break\n  }\n  if (v !== undefined) results.push(v)\n\n  for (const child of getChildren(node, recurse)) {\n    for (const item of collect(child, visitor, options)) {\n      results.push(item)\n    }\n  }\n\n  return results\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { A as ComplexSchemaType, B as ScalarSchemaNode, C as ResponseNode, D as ParameterLocation, E as StatusCode, F as IntersectionSchemaNode, G as SpecialSchemaType, H as SchemaNode, I as NumberSchemaNode, J as UnionSchemaNode, K as StringSchemaNode, L as ObjectSchemaNode, M as DatetimeSchemaNode, N as EnumSchemaNode, O as ParameterNode, P as EnumValueNode, Q as VisitorDepth, R as PrimitiveSchemaType, S as OperationNode, T as MediaType, U as SchemaNodeByType, V as ScalarSchemaType, W as SchemaType, X as BaseNode, Y as PropertyNode, Z as NodeKind, b as RootNode, c as RefMap, f as DistributiveOmit, i as VisitorOptions, j as DateSchemaNode, k as ArraySchemaNode, n as CollectVisitor, q as TimeSchemaNode, r as Visitor, t as AsyncVisitor, w as HttpStatusCode, x as HttpMethod, y as Node, z as RefSchemaNode } from "./visitor-dtVfQZwX.js";
-export { type ArraySchemaNode, type AsyncVisitor, type BaseNode, type CollectVisitor, type ComplexSchemaType, type DateSchemaNode, type DatetimeSchemaNode, type DistributiveOmit, type EnumSchemaNode, type EnumValueNode, type HttpMethod, type HttpStatusCode, type IntersectionSchemaNode, type MediaType, type Node, type NodeKind, type NumberSchemaNode, type ObjectSchemaNode, type OperationNode, type ParameterLocation, type ParameterNode, type PrimitiveSchemaType, type PropertyNode, type RefMap, type RefSchemaNode, type ResponseNode, type RootNode, type ScalarSchemaNode, type ScalarSchemaType, type SchemaNode, type SchemaNodeByType, type SchemaType, type SpecialSchemaType, type StatusCode, type StringSchemaNode, type TimeSchemaNode, type UnionSchemaNode, type Visitor, type VisitorDepth, type VisitorOptions };
+import { $ as VisitorDepth, A as ArraySchemaNode, B as RefSchemaNode, C as OperationNode, D as StatusCode, E as MediaType, F as EnumValueNode, G as SchemaType, H as ScalarSchemaType, I as IntersectionSchemaNode, J as TimeSchemaNode, K as SpecialSchemaType, L as NumberSchemaNode, M as DateSchemaNode, N as DatetimeSchemaNode, O as ParameterLocation, P as EnumSchemaNode, Q as NodeKind, R as ObjectSchemaNode, S as HttpMethod, T as HttpStatusCode, U as SchemaNode, V as ScalarSchemaNode, W as SchemaNodeByType, X as PropertyNode, Y as UnionSchemaNode, Z as BaseNode, b as RootMeta, c as RefMap, f as DistributiveOmit, i as VisitorOptions, j as ComplexSchemaType, k as ParameterNode, n as CollectVisitor, q as StringSchemaNode, r as Visitor, t as AsyncVisitor, w as ResponseNode, x as RootNode, y as Node, z as PrimitiveSchemaType } from "./visitor-DRohZSfu.js";
+export { type ArraySchemaNode, type AsyncVisitor, type BaseNode, type CollectVisitor, type ComplexSchemaType, type DateSchemaNode, type DatetimeSchemaNode, type DistributiveOmit, type EnumSchemaNode, type EnumValueNode, type HttpMethod, type HttpStatusCode, type IntersectionSchemaNode, type MediaType, type Node, type NodeKind, type NumberSchemaNode, type ObjectSchemaNode, type OperationNode, type ParameterLocation, type ParameterNode, type PrimitiveSchemaType, type PropertyNode, type RefMap, type RefSchemaNode, type ResponseNode, type RootMeta, type RootNode, type ScalarSchemaNode, type ScalarSchemaType, type SchemaNode, type SchemaNodeByType, type SchemaType, type SpecialSchemaType, type StatusCode, type StringSchemaNode, type TimeSchemaNode, type UnionSchemaNode, type Visitor, type VisitorDepth, type VisitorOptions };

package/dist/{visitor-dtVfQZwX.d.ts → visitor-DRohZSfu.d.ts}

@@ -87,20 +87,20 @@ type NodeKind = 'Root' | 'Operation' | 'Schema' | 'Property' | 'Parameter' | 'Re
 /**
  * Common base for all AST nodes.
  */
-interface BaseNode {
+type BaseNode = {
   kind: NodeKind;
-}
+};
 //#endregion
 //#region src/nodes/property.d.ts
 /**
  * A named property within an object schema.
  */
-interface PropertyNode extends BaseNode {
+type PropertyNode = BaseNode & {
   kind: 'Property';
   name: string;
   schema: SchemaNode;
   required: boolean;
-}
+};
 //#endregion
 //#region src/nodes/schema.d.ts
 type PrimitiveSchemaType = 'string' | 'number' | 'integer' | 'bigint' | 'boolean' | 'null' | 'any' | 'unknown' | 'void' | 'object' | 'array' | 'date';
@@ -114,7 +114,7 @@ type ScalarSchemaType = Exclude<SchemaType, 'object' | 'array' | 'tuple' | 'unio
 /**
  * Base fields shared by every schema variant. Does not include spec-specific fields.
  */
-interface SchemaNodeBase extends BaseNode {
+type SchemaNodeBase = BaseNode & {
   kind: 'Schema';
   /**
    * Named schema identifier (e.g. `"Pet"` from `#/components/schemas/Pet`). `undefined` for inline schemas.
@@ -123,6 +123,7 @@ interface SchemaNodeBase extends BaseNode {
   title?: string;
   description?: string;
   nullable?: boolean;
+  optional?: boolean;
   /**
    * Both optional and nullable (`optional` + `nullable`).
    */
@@ -136,11 +137,11 @@ interface SchemaNodeBase extends BaseNode {
    * Underlying primitive before format/semantic promotion (e.g. `'string'` for a `uuid` node).
    */
   primitive?: PrimitiveSchemaType;
-}
+};
 /**
  * Object schema with ordered property definitions.
  */
-interface ObjectSchemaNode extends SchemaNodeBase {
+type ObjectSchemaNode = SchemaNodeBase & {
   type: 'object';
   properties?: Array<PropertyNode>;
   /**
@@ -148,11 +149,11 @@ interface ObjectSchemaNode extends SchemaNodeBase {
    */
   additionalProperties?: SchemaNode | true;
   patternProperties?: Record<string, SchemaNode>;
-}
+};
 /**
  * Array or tuple schema.
  */
-interface ArraySchemaNode extends SchemaNodeBase {
+type ArraySchemaNode = SchemaNodeBase & {
   type: 'array' | 'tuple';
   items?: Array<SchemaNode>;
   /**
@@ -162,41 +163,41 @@ interface ArraySchemaNode extends SchemaNodeBase {
   min?: number;
   max?: number;
   unique?: boolean;
-}
+};
 /**
  * Shared base for union and intersection schemas.
  */
-interface CompositeSchemaNodeBase extends SchemaNodeBase {
+type CompositeSchemaNodeBase = SchemaNodeBase & {
   members?: Array<SchemaNode>;
-}
+};
 /**
  * Union schema (`oneOf` / `anyOf`).
  */
-interface UnionSchemaNode extends CompositeSchemaNodeBase {
+type UnionSchemaNode = CompositeSchemaNodeBase & {
   type: 'union';
   /**
    * Discriminator property from OAS `discriminator.propertyName`.
    */
   discriminatorPropertyName?: string;
-}
+};
 /**
  * Intersection schema (`allOf`).
  */
-interface IntersectionSchemaNode extends CompositeSchemaNodeBase {
+type IntersectionSchemaNode = CompositeSchemaNodeBase & {
   type: 'intersection';
-}
+};
 /**
  * A named enum variant.
  */
-interface EnumValueNode {
+type EnumValueNode = {
   name: string;
   value: string | number | boolean;
   format: 'string' | 'number' | 'boolean';
-}
+};
 /**
  * Enum schema.
  */
-interface EnumSchemaNode extends SchemaNodeBase {
+type EnumSchemaNode = SchemaNodeBase & {
   type: 'enum';
   /**
    * Enum member type. Generators should use const assertions for `'number'` / `'boolean'`.
@@ -210,11 +211,11 @@ interface EnumSchemaNode extends SchemaNodeBase {
    * Named variants (rich form). Takes priority over `enumValues` when present.
    */
   namedEnumValues?: Array<EnumValueNode>;
-}
+};
 /**
  * Ref schema — pointer to another schema definition.
  */
-interface RefSchemaNode extends SchemaNodeBase {
+type RefSchemaNode = SchemaNodeBase & {
   type: 'ref';
   name?: string;
   /**
@@ -225,11 +226,11 @@ interface RefSchemaNode extends SchemaNodeBase {
    * Pattern constraint propagated from a sibling `pattern` field next to the `$ref`.
    */
   pattern?: string;
-}
+};
 /**
  * Datetime schema.
  */
-interface DatetimeSchemaNode extends SchemaNodeBase {
+type DatetimeSchemaNode = SchemaNodeBase & {
   type: 'datetime';
   /**
    * Includes timezone offset (`dateType: 'stringOffset'`).
@@ -239,17 +240,17 @@ interface DatetimeSchemaNode extends SchemaNodeBase {
    * Local datetime without timezone (`dateType: 'stringLocal'`).
    */
   local?: boolean;
-}
+};
 /**
  * Base for `date` and `time` schemas.
  */
-interface TemporalSchemaNodeBase<T extends 'date' | 'time'> extends SchemaNodeBase {
+type TemporalSchemaNodeBase<T extends 'date' | 'time'> = SchemaNodeBase & {
   type: T;
   /**
    * Representation in generated code: native `Date` or plain string.
    */
   representation: 'date' | 'string';
-}
+};
 /**
  * Date schema.
  */
@@ -261,28 +262,28 @@ type TimeSchemaNode = TemporalSchemaNodeBase<'time'>;
 /**
  * String schema.
  */
-interface StringSchemaNode extends SchemaNodeBase {
+type StringSchemaNode = SchemaNodeBase & {
   type: 'string';
   min?: number;
   max?: number;
   pattern?: string;
-}
+};
 /**
  * Number, integer, or bigint schema.
  */
-interface NumberSchemaNode extends SchemaNodeBase {
+type NumberSchemaNode = SchemaNodeBase & {
   type: 'number' | 'integer' | 'bigint';
   min?: number;
   max?: number;
   exclusiveMinimum?: number;
   exclusiveMaximum?: number;
-}
+};
 /**
  * Schema for scalar types with no additional constraints.
  */
-interface ScalarSchemaNode extends SchemaNodeBase {
+type ScalarSchemaNode = SchemaNodeBase & {
   type: ScalarSchemaType;
-}
+};
 /**
  * Maps each schema type string to its `SchemaNode` variant. Used by `narrowSchema`.
  */
@@ -321,13 +322,13 @@ type ParameterLocation = 'path' | 'query' | 'header' | 'cookie';
 /**
  * A single input parameter for an operation.
  */
-interface ParameterNode extends BaseNode {
+type ParameterNode = BaseNode & {
   kind: 'Parameter';
   name: string;
   in: ParameterLocation;
   schema: SchemaNode;
   required: boolean;
-}
+};
 //#endregion
 //#region src/nodes/http.d.ts
 /**
@@ -349,7 +350,7 @@ type MediaType = 'application/json' | 'application/xml' | 'application/x-www-for
 /**
  * A single response variant for an operation.
  */
-interface ResponseNode extends BaseNode {
+type ResponseNode = BaseNode & {
   kind: 'Response';
   /**
    * HTTP status code or `'default'` for a fallback response.
@@ -358,14 +359,14 @@ interface ResponseNode extends BaseNode {
   description?: string;
   schema?: SchemaNode;
   mediaType?: MediaType;
-}
+};
 //#endregion
 //#region src/nodes/operation.d.ts
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | 'TRACE';
 /**
  * A spec-agnostic representation of a single API operation.
  */
-interface OperationNode extends BaseNode {
+type OperationNode = BaseNode & {
   kind: 'Operation';
   /**
    * Unique operation identifier (maps to `operationId` in OAS).
@@ -383,17 +384,33 @@ interface OperationNode extends BaseNode {
    */
   requestBody?: SchemaNode;
   responses: Array<ResponseNode>;
-}
+};
 //#endregion
 //#region src/nodes/root.d.ts
+/**
+ * Format-agnostic metadata about the API document.
+ * Adapters populate whichever fields are available in their source format.
+ */
+type RootMeta = {
+  /** API title (from `info.title` in OAS/AsyncAPI). */title?: string; /** API version string (from `info.version` in OAS/AsyncAPI). */
+  version?: string;
+  /**
+   * Resolved base URL for the API.
+   * OAS: derived from `servers[serverIndex].url` with variable substitution.
+   * AsyncAPI: derived from `servers[serverIndex].url`.
+   * Drizzle / schema-only formats: not set.
+   */
+  baseURL?: string;
+};
 /**
  * Top-level container for all schemas and operations in a single API document.
  */
-interface RootNode extends BaseNode {
+type RootNode = BaseNode & {
   kind: 'Root';
   schemas: Array<SchemaNode>;
-  operations: Array<OperationNode>;
-}
+  operations: Array<OperationNode>; /** Format-agnostic document metadata populated by the adapter. */
+  meta?: RootMeta;
+};
 //#endregion
 //#region src/nodes/index.d.ts
 /**
@@ -465,37 +482,37 @@ type VisitorOptions = {
 /**
  * Synchronous visitor for `transform` and `walk`.
  */
-interface Visitor {
+type Visitor = {
   root?(node: RootNode): void | RootNode;
   operation?(node: OperationNode): void | OperationNode;
   schema?(node: SchemaNode): void | SchemaNode;
   property?(node: PropertyNode): void | PropertyNode;
   parameter?(node: ParameterNode): void | ParameterNode;
   response?(node: ResponseNode): void | ResponseNode;
-}
+};
 type MaybePromise<T> = T | Promise<T>;
 /**
  * Async visitor for `walk`. Synchronous `Visitor` objects are compatible.
  */
-interface AsyncVisitor {
+type AsyncVisitor = {
   root?(node: RootNode): MaybePromise<void | RootNode>;
   operation?(node: OperationNode): MaybePromise<void | OperationNode>;
   schema?(node: SchemaNode): MaybePromise<void | SchemaNode>;
   property?(node: PropertyNode): MaybePromise<void | PropertyNode>;
   parameter?(node: ParameterNode): MaybePromise<void | ParameterNode>;
   response?(node: ResponseNode): MaybePromise<void | ResponseNode>;
-}
+};
 /**
  * Visitor for `collect`.
  */
-interface CollectVisitor<T> {
+type CollectVisitor<T> = {
   root?(node: RootNode): T | undefined;
   operation?(node: OperationNode): T | undefined;
   schema?(node: SchemaNode): T | undefined;
   property?(node: PropertyNode): T | undefined;
   parameter?(node: ParameterNode): T | undefined;
   response?(node: ResponseNode): T | undefined;
-}
+};
 /**
  * Depth-first traversal for side effects. Visitor return values are ignored.
  */
@@ -515,5 +532,5 @@ declare function transform(node: Node, visitor: Visitor, options?: VisitorOption
  */
 declare function collect<T>(node: Node, visitor: CollectVisitor<T>, options?: VisitorOptions): Array<T>;
 //#endregion
-export { httpMethods as $, ComplexSchemaType as A, ScalarSchemaNode as B, ResponseNode as C, ParameterLocation as D, StatusCode as E, IntersectionSchemaNode as F, SpecialSchemaType as G, SchemaNode as H, NumberSchemaNode as I, UnionSchemaNode as J, StringSchemaNode as K, ObjectSchemaNode as L, DatetimeSchemaNode as M, EnumSchemaNode as N, ParameterNode as O, EnumValueNode as P, VisitorDepth as Q, PrimitiveSchemaType as R, OperationNode as S, MediaType as T, SchemaNodeByType as U, ScalarSchemaType as V, SchemaType as W, BaseNode as X, PropertyNode as Y, NodeKind as Z, createRoot as _, collect as a, RootNode as b, RefMap as c, resolveRef as d, mediaTypes as et, DistributiveOmit as f, createResponse as g, createProperty as h, VisitorOptions as i, DateSchemaNode as j, ArraySchemaNode as k, buildRefMap as l, createParameter as m, CollectVisitor as n, schemaTypes as nt, transform as o, createOperation as p, TimeSchemaNode as q, Visitor as r, walk as s, AsyncVisitor as t, nodeKinds as tt, refMapToObject as u, createSchema as v, HttpStatusCode as w, HttpMethod as x, Node as y, RefSchemaNode as z };
-//# sourceMappingURL=visitor-dtVfQZwX.d.ts.map
+export { VisitorDepth as $, ArraySchemaNode as A, RefSchemaNode as B, OperationNode as C, StatusCode as D, MediaType as E, EnumValueNode as F, SchemaType as G, ScalarSchemaType as H, IntersectionSchemaNode as I, TimeSchemaNode as J, SpecialSchemaType as K, NumberSchemaNode as L, DateSchemaNode as M, DatetimeSchemaNode as N, ParameterLocation as O, EnumSchemaNode as P, NodeKind as Q, ObjectSchemaNode as R, HttpMethod as S, HttpStatusCode as T, SchemaNode as U, ScalarSchemaNode as V, SchemaNodeByType as W, PropertyNode as X, UnionSchemaNode as Y, BaseNode as Z, createRoot as _, collect as a, RootMeta as b, RefMap as c, resolveRef as d, httpMethods as et, DistributiveOmit as f, createResponse as g, createProperty as h, VisitorOptions as i, ComplexSchemaType as j, ParameterNode as k, buildRefMap as l, createParameter as m, CollectVisitor as n, nodeKinds as nt, transform as o, createOperation as p, StringSchemaNode as q, Visitor as r, schemaTypes as rt, walk as s, AsyncVisitor as t, mediaTypes as tt, refMapToObject as u, createSchema as v, ResponseNode as w, RootNode as x, Node as y, PrimitiveSchemaType as z };
+//# sourceMappingURL=visitor-DRohZSfu.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/ast",
-  "version": "4.33.3",
+  "version": "4.34.0",
   "description": "Spec-agnostic AST layer for Kubb. Defines nodes, visitor pattern, and factory functions used across codegen plugins.",
   "keywords": [
     "kubb",

package/src/nodes/base.ts

@@ -6,7 +6,7 @@ export type NodeKind = 'Root' | 'Operation' | 'Schema' | 'Property' | 'Parameter
 /**
  * Common base for all AST nodes.
  */
-export interface BaseNode {
+export type BaseNode = {
   kind: NodeKind
 }
 

package/src/nodes/index.ts

@@ -11,7 +11,7 @@ export type { HttpMethod, OperationNode } from './operation.ts'
 export type { ParameterLocation, ParameterNode } from './parameter.ts'
 export type { PropertyNode } from './property.ts'
 export type { ResponseNode } from './response.ts'
-export type { RootNode } from './root.ts'
+export type { RootMeta, RootNode } from './root.ts'
 export type {
   ArraySchemaNode,
   ComplexSchemaType,

package/src/nodes/operation.ts

@@ -8,7 +8,7 @@ export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' |
 /**
  * A spec-agnostic representation of a single API operation.
  */
-export interface OperationNode extends BaseNode {
+export type OperationNode = BaseNode & {
   kind: 'Operation'
   /**
    * Unique operation identifier (maps to `operationId` in OAS).

package/src/nodes/parameter.ts

@@ -6,7 +6,7 @@ export type ParameterLocation = 'path' | 'query' | 'header' | 'cookie'
 /**
  * A single input parameter for an operation.
  */
-export interface ParameterNode extends BaseNode {
+export type ParameterNode = BaseNode & {
   kind: 'Parameter'
   name: string
   in: ParameterLocation

package/src/nodes/property.ts

@@ -4,7 +4,7 @@ import type { SchemaNode } from './schema.ts'
 /**
  * A named property within an object schema.
  */
-export interface PropertyNode extends BaseNode {
+export type PropertyNode = BaseNode & {
   kind: 'Property'
   name: string
   schema: SchemaNode

package/src/nodes/response.ts

@@ -5,7 +5,7 @@ import type { SchemaNode } from './schema.ts'
 /**
  * A single response variant for an operation.
  */
-export interface ResponseNode extends BaseNode {
+export type ResponseNode = BaseNode & {
   kind: 'Response'
   /**
    * HTTP status code or `'default'` for a fallback response.

package/src/nodes/root.ts

@@ -2,11 +2,31 @@ import type { BaseNode } from './base.ts'
 import type { OperationNode } from './operation.ts'
 import type { SchemaNode } from './schema.ts'
 
+/**
+ * Format-agnostic metadata about the API document.
+ * Adapters populate whichever fields are available in their source format.
+ */
+export type RootMeta = {
+  /** API title (from `info.title` in OAS/AsyncAPI). */
+  title?: string
+  /** API version string (from `info.version` in OAS/AsyncAPI). */
+  version?: string
+  /**
+   * Resolved base URL for the API.
+   * OAS: derived from `servers[serverIndex].url` with variable substitution.
+   * AsyncAPI: derived from `servers[serverIndex].url`.
+   * Drizzle / schema-only formats: not set.
+   */
+  baseURL?: string
+}
+
 /**
  * Top-level container for all schemas and operations in a single API document.
  */
-export interface RootNode extends BaseNode {
+export type RootNode = BaseNode & {
   kind: 'Root'
   schemas: Array<SchemaNode>
   operations: Array<OperationNode>
+  /** Format-agnostic document metadata populated by the adapter. */
+  meta?: RootMeta
 }

package/src/nodes/schema.ts

@@ -20,7 +20,7 @@ export type ScalarSchemaType = Exclude<
 /**
  * Base fields shared by every schema variant. Does not include spec-specific fields.
  */
-interface SchemaNodeBase extends BaseNode {
+type SchemaNodeBase = BaseNode & {
   kind: 'Schema'
   /**
    * Named schema identifier (e.g. `"Pet"` from `#/components/schemas/Pet`). `undefined` for inline schemas.
@@ -29,6 +29,7 @@ interface SchemaNodeBase extends BaseNode {
   title?: string
   description?: string
   nullable?: boolean
+  optional?: boolean
   /**
    * Both optional and nullable (`optional` + `nullable`).
    */
@@ -47,7 +48,7 @@ interface SchemaNodeBase extends BaseNode {
 /**
  * Object schema with ordered property definitions.
  */
-export interface ObjectSchemaNode extends SchemaNodeBase {
+export type ObjectSchemaNode = SchemaNodeBase & {
   type: 'object'
   properties?: Array<PropertyNode>
   /**
@@ -60,7 +61,7 @@ export interface ObjectSchemaNode extends SchemaNodeBase {
 /**
  * Array or tuple schema.
  */
-export interface ArraySchemaNode extends SchemaNodeBase {
+export type ArraySchemaNode = SchemaNodeBase & {
   type: 'array' | 'tuple'
   items?: Array<SchemaNode>
   /**
@@ -75,14 +76,14 @@ export interface ArraySchemaNode extends SchemaNodeBase {
 /**
  * Shared base for union and intersection schemas.
  */
-interface CompositeSchemaNodeBase extends SchemaNodeBase {
+type CompositeSchemaNodeBase = SchemaNodeBase & {
   members?: Array<SchemaNode>
 }
 
 /**
  * Union schema (`oneOf` / `anyOf`).
  */
-export interface UnionSchemaNode extends CompositeSchemaNodeBase {
+export type UnionSchemaNode = CompositeSchemaNodeBase & {
   type: 'union'
   /**
    * Discriminator property from OAS `discriminator.propertyName`.
@@ -93,14 +94,14 @@ export interface UnionSchemaNode extends CompositeSchemaNodeBase {
 /**
  * Intersection schema (`allOf`).
  */
-export interface IntersectionSchemaNode extends CompositeSchemaNodeBase {
+export type IntersectionSchemaNode = CompositeSchemaNodeBase & {
   type: 'intersection'
 }
 
 /**
  * A named enum variant.
  */
-export interface EnumValueNode {
+export type EnumValueNode = {
   name: string
   value: string | number | boolean
   format: 'string' | 'number' | 'boolean'
@@ -109,7 +110,7 @@ export interface EnumValueNode {
 /**
  * Enum schema.
  */
-export interface EnumSchemaNode extends SchemaNodeBase {
+export type EnumSchemaNode = SchemaNodeBase & {
   type: 'enum'
   /**
    * Enum member type. Generators should use const assertions for `'number'` / `'boolean'`.
@@ -128,7 +129,7 @@ export interface EnumSchemaNode extends SchemaNodeBase {
 /**
  * Ref schema — pointer to another schema definition.
  */
-export interface RefSchemaNode extends SchemaNodeBase {
+export type RefSchemaNode = SchemaNodeBase & {
   type: 'ref'
   name?: string
   /**
@@ -144,7 +145,7 @@ export interface RefSchemaNode extends SchemaNodeBase {
 /**
  * Datetime schema.
  */
-export interface DatetimeSchemaNode extends SchemaNodeBase {
+export type DatetimeSchemaNode = SchemaNodeBase & {
   type: 'datetime'
   /**
    * Includes timezone offset (`dateType: 'stringOffset'`).
@@ -159,7 +160,7 @@ export interface DatetimeSchemaNode extends SchemaNodeBase {
 /**
  * Base for `date` and `time` schemas.
  */
-interface TemporalSchemaNodeBase<T extends 'date' | 'time'> extends SchemaNodeBase {
+type TemporalSchemaNodeBase<T extends 'date' | 'time'> = SchemaNodeBase & {
   type: T
   /**
    * Representation in generated code: native `Date` or plain string.
@@ -180,7 +181,7 @@ export type TimeSchemaNode = TemporalSchemaNodeBase<'time'>
 /**
  * String schema.
  */
-export interface StringSchemaNode extends SchemaNodeBase {
+export type StringSchemaNode = SchemaNodeBase & {
   type: 'string'
   min?: number
   max?: number
@@ -190,7 +191,7 @@ export interface StringSchemaNode extends SchemaNodeBase {
 /**
  * Number, integer, or bigint schema.
  */
-export interface NumberSchemaNode extends SchemaNodeBase {
+export type NumberSchemaNode = SchemaNodeBase & {
   type: 'number' | 'integer' | 'bigint'
   min?: number
   max?: number
@@ -201,7 +202,7 @@ export interface NumberSchemaNode extends SchemaNodeBase {
 /**
  * Schema for scalar types with no additional constraints.
  */
-export interface ScalarSchemaNode extends SchemaNodeBase {
+export type ScalarSchemaNode = SchemaNodeBase & {
   type: ScalarSchemaType
 }
 

package/src/types.ts

@@ -23,6 +23,7 @@ export type {
   PropertyNode,
   RefSchemaNode,
   ResponseNode,
+  RootMeta,
   RootNode,
   ScalarSchemaNode,
   ScalarSchemaType,

package/src/visitor.ts

@@ -12,7 +12,7 @@ export type VisitorOptions = {
 /**
  * Synchronous visitor for `transform` and `walk`.
  */
-export interface Visitor {
+export type Visitor = {
   root?(node: RootNode): void | RootNode
   operation?(node: OperationNode): void | OperationNode
   schema?(node: SchemaNode): void | SchemaNode
@@ -26,7 +26,7 @@ type MaybePromise<T> = T | Promise<T>
 /**
  * Async visitor for `walk`. Synchronous `Visitor` objects are compatible.
  */
-export interface AsyncVisitor {
+export type AsyncVisitor = {
   root?(node: RootNode): MaybePromise<void | RootNode>
   operation?(node: OperationNode): MaybePromise<void | OperationNode>
   schema?(node: SchemaNode): MaybePromise<void | SchemaNode>
@@ -38,7 +38,7 @@ export interface AsyncVisitor {
 /**
  * Visitor for `collect`.
  */
-export interface CollectVisitor<T> {
+export type CollectVisitor<T> = {
   root?(node: RootNode): T | undefined
   operation?(node: OperationNode): T | undefined
   schema?(node: SchemaNode): T | undefined