@trapi/metadata 2.0.0-beta.1 → 2.0.0-beta.3

package/dist/index.d.mts

@@ -1,480 +1,7 @@
 import { BaseError } from "@ebec/core";
-import * as ts from "typescript";
-import { ClassDeclaration, CompilerOptions, EnumDeclaration, EnumMember, Expression, JSDoc, JSDocComment, JSDocTag, MethodDeclaration, Node, NodeArray, ParameterDeclaration, PropertyDeclaration, PropertySignature, SyntaxKind, TypeAliasDeclaration, TypeChecker, TypeNode } from "typescript";
-import { Container } from "validup";
-import { z } from "zod";
+import { ClassDeclaration, CompilerOptions, EnumDeclaration, EnumMember, Expression, HasInitializer, InterfaceDeclaration, JSDoc, JSDocComment, JSDocTag, LiteralTypeNode, MethodDeclaration, Node, NodeArray, ParameterDeclaration, PropertyDeclaration, PropertySignature, SyntaxKind, Token, TypeAliasDeclaration, TypeChecker, TypeNode, TypeReferenceNode } from "typescript";
+import { BaseType, Controller, DecoratorArgument, DecoratorHost, DecoratorSource, DecoratorTarget, DependencyResolver, Extension, HandlerContext, IControllerGenerator, IParameterGenerator, IResolverCache, JsDocHandlerContext, JsDocMatch, JsDocSource, Match, Metadata, Method, NeverType, Parameter, Preset, PrimitiveType, RefEnumType, RefObjectType, ReferenceType, Registry, ResolverProperty, Type, UnmatchedDecoratorReport, Validator, VoidType } from "@trapi/core";
 
-//#region src/core/validator/types.d.ts
-interface ValidatorMeta {}
-type Validator = {
-  value?: unknown;
-  message?: string;
-  meta?: ValidatorMeta;
-};
-type Validators = Record<string, Validator>;
-//#endregion
-//#region src/core/resolver/constants.d.ts
-declare enum TypeName {
-  STRING = "string",
-  BOOLEAN = "boolean",
-  BIGINT = "bigint",
-  DOUBLE = "double",
-  FLOAT = "float",
-  FILE = "file",
-  INTEGER = "integer",
-  LONG = "long",
-  ENUM = "enum",
-  ARRAY = "array",
-  DATETIME = "datetime",
-  DATE = "date",
-  BINARY = "binary",
-  BUFFER = "buffer",
-  BYTE = "byte",
-  VOID = "void",
-  OBJECT = "object",
-  ANY = "any",
-  UNDEFINED = "undefined",
-  NEVER = "never",
-  REF_ENUM = "refEnum",
-  REF_OBJECT = "refObject",
-  REF_ALIAS = "refAlias",
-  NESTED_OBJECT_LITERAL = "nestedObjectLiteral",
-  UNION = "union",
-  INTERSECTION = "intersection",
-  TUPLE = "tuple"
-}
-declare enum UtilityTypeName {
-  NON_NULLABLE = "NonNullable",
-  OMIT = "Omit",
-  PARTIAL = "Partial",
-  READONLY = "Readonly",
-  RECORD = "Record",
-  REQUIRED = "Required",
-  PICK = "Pick",
-  EXTRACT = "Extract",
-  EXCLUDE = "Exclude",
-  RETURN_TYPE = "ReturnType",
-  PARAMETERS = "Parameters",
-  AWAITED = "Awaited",
-  INSTANCE_TYPE = "InstanceType",
-  CONSTRUCTOR_PARAMETERS = "ConstructorParameters"
-}
-//#endregion
-//#region src/core/resolver/extension.d.ts
-type Extension = {
-  key: string;
-  value: ExtensionType | ExtensionType[];
-};
-type ExtensionType = string | number | boolean | null | ExtensionType[] | {
-  [name: string]: ExtensionType | ExtensionType[];
-};
-//#endregion
-//#region src/core/resolver/types.d.ts
-type Type = PrimitiveType | ObjectType | EnumType | ArrayType | FileType | DateTimeType | DateType | BinaryType | BufferType | ByteType | AnyType | UndefinedType | NeverType | RefEnumType | RefObjectType | RefAliasType | NestedObjectLiteralType | UnionType | IntersectionType | TupleType | VoidType;
-type BaseType = {
-  typeName: `${TypeName}`;
-};
-type AnyType = BaseType & {
-  typeName: `${TypeName.ANY}`;
-};
-type UndefinedType = BaseType & {
-  typeName: `${TypeName.UNDEFINED}`;
-};
-type StringType = BaseType & {
-  typeName: `${TypeName.STRING}`;
-};
-type BooleanType = BaseType & {
-  typeName: `${TypeName.BOOLEAN}`;
-};
-type BigintType = BaseType & {
-  typeName: `${TypeName.BIGINT}`;
-};
-type DoubleType = BaseType & {
-  typeName: `${TypeName.DOUBLE}`;
-};
-type FloatType = BaseType & {
-  typeName: `${TypeName.FLOAT}`;
-};
-type IntegerType = BaseType & {
-  typeName: `${TypeName.INTEGER}`;
-};
-type LongType = BaseType & {
-  typeName: `${TypeName.LONG}`;
-};
-type VoidType = BaseType & {
-  typeName: `${TypeName.VOID}`;
-};
-type NeverType = BaseType & {
-  typeName: `${TypeName.NEVER}`;
-};
-type DateType = BaseType & {
-  typeName: `${TypeName.DATE}`;
-};
-type FileType = BaseType & {
-  typeName: `${TypeName.FILE}`;
-};
-type DateTimeType = BaseType & {
-  typeName: `${TypeName.DATETIME}`;
-};
-type BinaryType = BaseType & {
-  typeName: `${TypeName.BINARY}`;
-};
-type BufferType = BaseType & {
-  typeName: `${TypeName.BUFFER}`;
-};
-type ByteType = BaseType & {
-  typeName: `${TypeName.BYTE}`;
-};
-type ObjectType = BaseType & {
-  typeName: `${TypeName.OBJECT}`;
-};
-type EnumType = BaseType & {
-  members: Array<string | number | boolean | null>;
-  typeName: `${TypeName.ENUM}`;
-};
-type ArrayType = BaseType & {
-  elementType: Type;
-  typeName: `${TypeName.ARRAY}`;
-};
-type NestedObjectLiteralType = BaseType & {
-  typeName: `${TypeName.NESTED_OBJECT_LITERAL}`;
-  properties: ResolverProperty[];
-  additionalProperties?: Type;
-};
-type IntersectionType = BaseType & {
-  typeName: `${TypeName.INTERSECTION}`;
-  members: Type[];
-};
-type UnionType = BaseType & {
-  typeName: `${TypeName.UNION}`;
-  members: Type[];
-};
-type TupleElement = {
-  type: Type;
-  name?: string;
-};
-type TupleType = BaseType & {
-  typeName: `${TypeName.TUPLE}`;
-  elements: TupleElement[];
-};
-type ReferenceType = RefEnumType | RefObjectType | RefAliasType;
-type ReferenceTypes = Record<string, ReferenceType>;
-type DependencyResolver = (referenceTypes: ReferenceTypes) => void;
-type ReferenceTypeBase = BaseType & {
-  description?: string;
-  typeName: `${TypeName.REF_ALIAS}` | `${TypeName.REF_ENUM}` | `${TypeName.REF_OBJECT}`;
-  refName: string;
-  example?: unknown;
-  deprecated: boolean;
-};
-type RefEnumType = ReferenceTypeBase & {
-  typeName: `${TypeName.REF_ENUM}`;
-  members: Array<string | number | boolean>;
-  memberNames?: string[];
-};
-type RefObjectType = ReferenceTypeBase & {
-  typeName: `${TypeName.REF_OBJECT}`;
-  properties: ResolverProperty[];
-  additionalProperties?: Type;
-};
-type RefAliasType = Omit<ResolverProperty, 'name' | 'required'> & ReferenceTypeBase & {
-  typeName: `${TypeName.REF_ALIAS}`;
-};
-type PrimitiveType = AnyType | BinaryType | BooleanType | BufferType | ByteType | DateType | DateTimeType | DoubleType | FloatType | FileType | BigintType | IntegerType | LongType | ObjectType | StringType | UndefinedType;
-type ResolverProperty = {
-  default?: any;
-  format?: string;
-  example?: unknown;
-  validators?: Record<string, Validator>;
-  description?: string;
-  name: string;
-  type: Type;
-  required: boolean;
-  deprecated: boolean;
-  extensions?: Extension[];
-};
-/**
- * Cache interface for the resolver's type cache.
- */
-interface IResolverCache {
-  getCachedType(name: string): ReferenceType | undefined;
-  setCachedType(name: string, type: ReferenceType): void;
-  isInProgress(name: string): boolean;
-  markInProgress(name: string): void;
-  clearInProgress(name: string): void;
-  clear(): void;
-}
-//#endregion
-//#region src/core/resolver/type-guards.d.ts
-declare function isAnyType(param: BaseType): param is AnyType;
-declare function isUndefinedType(param: BaseType): param is UndefinedType;
-declare function isStringType(param: BaseType): param is StringType;
-declare function isBooleanType(param: BaseType): param is BooleanType;
-declare function isBigintType(param: BaseType): param is BigintType;
-declare function isDoubleType(param: BaseType): param is DoubleType;
-declare function isFloatType(param: BaseType): param is FloatType;
-declare function isIntegerType(param: BaseType): param is IntegerType;
-declare function isLongType(param: BaseType): param is LongType;
-declare function isVoidType(param: BaseType | undefined): param is VoidType;
-declare function isNeverType(param: BaseType): param is NeverType;
-declare function isDateType(param: BaseType): param is DateType;
-declare function isFileType(param: BaseType): param is FileType;
-declare function isDateTimeType(param: BaseType): param is DateTimeType;
-declare function isBinaryType(param: BaseType): param is BinaryType;
-declare function isBufferType(param: BaseType): param is BufferType;
-declare function isByteType(param: BaseType): param is ByteType;
-declare function isObjectType(param: BaseType): param is ObjectType;
-declare function isEnumType(param: BaseType): param is EnumType;
-declare function isArrayType(param: BaseType): param is ArrayType;
-declare function isNestedObjectLiteralType(param: BaseType): param is NestedObjectLiteralType;
-declare function isIntersectionType(param: BaseType): param is IntersectionType;
-declare function isUnionType(param: BaseType): param is UnionType;
-declare function isTupleType(param: BaseType): param is TupleType;
-declare function isRefEnumType(param: BaseType): param is RefEnumType;
-declare function isRefObjectType(param: BaseType): param is RefObjectType;
-declare function isRefAliasType(param: BaseType): param is RefAliasType;
-declare function isReferenceType(param: BaseType): param is ReferenceType;
-declare function isPrimitiveType(type: BaseType): type is PrimitiveType;
-//#endregion
-//#region src/core/error/base.d.ts
-declare class MetadataError extends BaseError {}
-//#endregion
-//#region src/core/resolver/error.d.ts
-declare class ResolverError extends MetadataError {
-  readonly file?: string;
-  readonly line?: number;
-  constructor(message: string, node?: Node | TypeNode, options?: boolean | {
-    onlyCurrent?: boolean;
-    cause?: unknown;
-  });
-}
-declare function isResolverError(input: unknown): input is ResolverError;
-declare function prettyLocationOfNode(node: Node | TypeNode): {
-  text: string;
-  file: string;
-  line?: number;
-} | undefined;
-declare function prettyTroubleCause(node: Node | TypeNode, onlyCurrent?: boolean): string;
-//#endregion
-//#region src/core/generator/types.d.ts
-type Security = Record<string, string[]>;
-type Example = {
-  value: unknown | unknown[];
-  summary?: string;
-  description?: string;
-  label?: string;
-};
-type Response = {
-  description: string;
-  examples?: Example[];
-  headers?: NestedObjectLiteralType | RefObjectType;
-  name: string;
-  produces?: string[];
-  status: string;
-  schema?: BaseType;
-};
-//#endregion
-//#region src/core/parameter/constants.d.ts
-declare const ParameterSource: {
-  readonly BODY: "body";
-  readonly BODY_PROP: "bodyProp";
-  readonly CONTEXT: "context";
-  readonly COOKIE: "cookie";
-  readonly HEADER: "header";
-  readonly FORM_DATA: "formData";
-  readonly QUERY: "query";
-  readonly QUERY_PROP: "queryProp";
-  readonly PATH: "path";
-};
-type ParameterSource = typeof ParameterSource[keyof typeof ParameterSource];
-declare const CollectionFormat: {
-  readonly CSV: "csv";
-  readonly SSV: "ssv";
-  readonly TSV: "tsv";
-  readonly PIPES: "pipes";
-  readonly MULTI: "multi";
-};
-type CollectionFormat = typeof CollectionFormat[keyof typeof CollectionFormat];
-declare const ParameterErrorCode: {
-  readonly TYPE_UNSUPPORTED: "PARAMETER_TYPE_UNSUPPORTED";
-  readonly METHOD_UNSUPPORTED: "PARAMETER_METHOD_UNSUPPORTED";
-  readonly PATH_MISMATCH: "PARAMETER_PATH_MISMATCH";
-  readonly SCOPE_REQUIRED: "PARAMETER_SCOPE_REQUIRED";
-  readonly INVALID_EXAMPLE: "PARAMETER_INVALID_EXAMPLE";
-};
-//#endregion
-//#region src/core/parameter/types.d.ts
-type Parameter = {
-  parameterName: string;
-  description: string;
-  in: `${ParameterSource}`;
-  name: string;
-  required: boolean;
-  type: Type;
-  collectionFormat?: `${CollectionFormat}`;
-  allowEmptyValue?: boolean;
-  default?: any;
-  maxItems?: number;
-  minItems?: number;
-  deprecated?: boolean;
-  examples?: Example[];
-  exampleLabels?: string[];
-  extensions: Extension[];
-  validators?: Record<string, Validator>;
-};
-type ArrayParameter = Parameter & {
-  type: ArrayType;
-};
-interface IParameterGenerator {
-  generate(): Parameter[];
-}
-//#endregion
-//#region src/core/method/types.d.ts
-type Method = {
-  operationId?: string;
-  deprecated?: boolean;
-  description: string;
-  method: MethodType;
-  extensions: Extension[];
-  name: string;
-  parameters: Parameter[];
-  path: string;
-  type: BaseType;
-  tags: string[];
-  responses: Response[];
-  security?: Security[];
-  summary?: string;
-  consumes: string[];
-  produces: string[];
-  hidden: boolean;
-};
-type MethodType = 'get' | 'post' | 'put' | 'delete' | 'options' | 'head' | 'patch';
-//#endregion
-//#region src/core/controller/types.d.ts
-type Controller = {
-  /**
-   * Allowed Content-Types to pass
-   * data according the definition.
-   *
-   * i.e. ['application/json']
-   */
-  consumes: string[];
-  /**
-   * Whether every operation under this controller should be considered
-   * deprecated. OpenAPI has no controller-level `deprecated` field — emitters
-   * should cascade this flag to each emitted operation (combined with the
-   * method's own `deprecated`).
-   */
-  deprecated?: boolean;
-  /**
-   * Vendor extensions (x-* keys) declared on the controller class.
-   */
-  extensions: Extension[];
-  /**
-   * Is controller hidden, and should
-   * not be used/displayed in some scenarios.
-   */
-  hidden: boolean;
-  /**
-   * File Location of the Controller.
-   */
-  location: string;
-  /**
-   * Array of found method ( class functions )
-   * for a specific controller (class)
-   */
-  methods: Method[];
-  name: string;
-  /**
-   * Relative URL paths the controller mounts at, e.g. ['/users'] or
-   * ['/roles', '/realms/:id/roles'] for multi-mounting.
-   *
-   * Always non-empty; a controller declared with no path argument has
-   * `paths: ['']`.
-   */
-  paths: string[];
-  /**
-   * Possible Content-Types to receive
-   * data according the definition.
-   *
-   * i.e. ['application/json']
-   */
-  produces: string[];
-  responses: Response[];
-  /**
-   * Tags can be used to group controllers
-   * by a name together.
-   *
-   * i.e. ['auth']
-   */
-  tags: string[];
-  security?: Security[];
-};
-interface IControllerGenerator {
-  isValid(): boolean;
-  generate(): Controller | null;
-}
-//#endregion
-//#region src/core/method/constants.d.ts
-declare const MethodName: {
-  readonly ALL: "ALL";
-  readonly GET: "GET";
-  readonly POST: "POST";
-  readonly PUT: "PUT";
-  readonly DELETE: "DELETE";
-  readonly PATCH: "PATCH";
-  readonly OPTIONS: "OPTIONS";
-  readonly HEAD: "HEAD";
-};
-type MethodName = typeof MethodName[keyof typeof MethodName];
-//#endregion
-//#region src/core/parameter/error.d.ts
-type UnsupportedTypeContext = {
-  decoratorName: string;
-  propertyName: string;
-  type: BaseType;
-  node?: Node;
-};
-type UnsupportedMethodContext = {
-  decoratorName: string;
-  propertyName: string;
-  method: string;
-  node?: Node;
-};
-type PathMatchInvalidContext = {
-  decoratorName: string;
-  propertyName: string;
-  path: string;
-  node?: Node;
-};
-type ScopeRequiredContext = {
-  decoratorName: string;
-  node?: Node;
-};
-declare class ParameterError extends MetadataError {
-  static typeUnsupported(context: UnsupportedTypeContext): ParameterError;
-  static methodUnsupported(context: UnsupportedMethodContext): ParameterError;
-  static invalidPathMatch(context: PathMatchInvalidContext): ParameterError;
-  static scopeRequired(context: ScopeRequiredContext): ParameterError;
-  static invalidExampleSchema(): ParameterError;
-  static getCurrentLocation(node: Node): string;
-}
-//#endregion
-//#region src/core/generator/error.d.ts
-declare class GeneratorError extends MetadataError {}
-declare function isGeneratorError(input: unknown): input is GeneratorError & {
-  code: string;
-};
-//#endregion
-//#region src/core/generator/constants.d.ts
-declare const GeneratorErrorCode: {
-  readonly CONTROLLER_NO_SOURCE_FILE: "GENERATOR_CONTROLLER_NO_SOURCE_FILE";
-  readonly CONTROLLER_NO_NAME: "GENERATOR_CONTROLLER_NO_NAME";
-  readonly PARAMETER_GENERATION_FAILED: "GENERATOR_PARAMETER_GENERATION_FAILED";
-  readonly BODY_PARAMETER_DUPLICATE: "GENERATOR_BODY_PARAMETER_DUPLICATE";
-  readonly BODY_FORM_CONFLICT: "GENERATOR_BODY_FORM_CONFLICT";
-};
-//#endregion
 //#region src/adapters/cache/types.d.ts
 interface CacheOptions {
   /**
@@ -553,238 +80,6 @@ declare const CACHE_FILE_SUFFIX = ".json";
 /** 7 days. */
 declare const CACHE_DEFAULT_MAX_AGE_MS: number;
 //#endregion
-//#region src/adapters/decorator/constants.d.ts
-declare const ParamKind: {
-  readonly Body: "body";
-  readonly BodyProp: "bodyProp";
-  readonly Context: "context";
-  readonly Cookie: "cookie";
-  readonly Header: "header";
-  readonly FormData: "formData";
-  readonly Query: "query";
-  readonly QueryProp: "queryProp";
-  readonly Path: "path";
-};
-type ParamKind = typeof ParamKind[keyof typeof ParamKind];
-declare const CollectionKind: {
-  readonly Csv: "csv";
-  readonly Ssv: "ssv";
-  readonly Tsv: "tsv";
-  readonly Pipes: "pipes";
-  readonly Multi: "multi";
-};
-type CollectionKind = typeof CollectionKind[keyof typeof CollectionKind];
-declare const DecoratorTargetKind: {
-  readonly Class: "class";
-  readonly Method: "method";
-  readonly Parameter: "parameter";
-  readonly Property: "property";
-};
-type DecoratorTargetKind = typeof DecoratorTargetKind[keyof typeof DecoratorTargetKind];
-declare const DecoratorArgumentKindName: {
-  readonly Literal: "literal";
-  readonly Object: "object";
-  readonly Array: "array";
-  readonly Identifier: "identifier";
-  readonly Unresolvable: "unresolvable";
-};
-type DecoratorArgumentKindName = typeof DecoratorArgumentKindName[keyof typeof DecoratorArgumentKindName];
-declare const MarkerName: {
-  readonly Hidden: "hidden";
-  readonly Deprecated: "deprecated";
-  readonly Extension: "extension";
-};
-type MarkerName = typeof MarkerName[keyof typeof MarkerName];
-declare const NumericKind: {
-  readonly Int: "int";
-  readonly Long: "long";
-  readonly Float: "float";
-  readonly Double: "double";
-};
-type NumericKind = typeof NumericKind[keyof typeof NumericKind];
-//#endregion
-//#region src/adapters/decorator/types.d.ts
-type DecoratorTarget = `${DecoratorTargetKind}`;
-type DecoratorArgumentKind = `${DecoratorArgumentKindName}`;
-type DecoratorArgument = {
-  raw: unknown;
-  kind: DecoratorArgumentKind;
-};
-type DecoratorTypeArgument = {
-  resolve: () => Type;
-};
-type DecoratorHost = {
-  name: string;
-  parentName?: string;
-};
-type DecoratorSource = {
-  name: string;
-  arguments: DecoratorArgument[];
-  typeArguments: DecoratorTypeArgument[];
-  target: DecoratorTarget;
-  host: DecoratorHost;
-  /**
-   * Source-file location of the decorator AST node itself (1-based line).
-   * Optional because decorator sources can be synthesised in tests without
-   * a real source file. Populated by {@link buildDecoratorSources} when the
-   * decorator's containing source file is available.
-   */
-  location?: {
-    file: string;
-    line: number;
-  };
-};
-type JsDocSource = {
-  tag: string;
-  text?: string;
-  typeExpression?: {
-    resolve: () => Type;
-  };
-  parameterName?: string;
-  target: DecoratorTarget;
-  host: DecoratorHost;
-};
-type ControllerDraft = {
-  name: string;
-  location: string;
-  paths?: string[];
-  hidden: boolean;
-  deprecated?: boolean;
-  consumes: string[];
-  produces: string[];
-  tags: string[];
-  responses: Response[];
-  security: Security[];
-  extensions: Extension[];
-};
-type MethodDraft = {
-  name: string;
-  verb?: MethodType;
-  path: string;
-  operationId?: string;
-  description: string;
-  summary?: string;
-  deprecated?: boolean;
-  hidden: boolean;
-  consumes: string[];
-  produces: string[];
-  tags: string[];
-  responses: Response[];
-  security: Security[];
-  extensions: Extension[];
-  parameters: ParameterDraft[];
-  type?: BaseType;
-  /**
-   * Examples that handlers (e.g. `@Example`) want attached to the implicitly
-   * generated default response. The orchestrator merges these into the
-   * default 200/204 response when finalising the method.
-   */
-  defaultResponseExamples: Example[];
-};
-type ParameterDraft = {
-  parameterName: string;
-  name: string;
-  in?: `${ParamKind}`;
-  description: string;
-  required: boolean;
-  type?: Type;
-  collectionFormat?: `${CollectionKind}`;
-  allowEmptyValue?: boolean;
-  default?: unknown;
-  maxItems?: number;
-  minItems?: number;
-  deprecated?: boolean;
-  examples: Example[];
-  exampleLabels: string[];
-  extensions: Extension[];
-  validators: Record<string, Validator>;
-};
-type HandlerContext = {
-  host: DecoratorHost;
-  argument: (index: number) => DecoratorArgument | undefined;
-  arguments: () => DecoratorArgument[];
-  typeArgument: (index: number) => DecoratorTypeArgument | undefined;
-  typeArguments: () => DecoratorTypeArgument[];
-  parameterType: () => Type | undefined;
-};
-type JsDocHandlerContext = {
-  host: DecoratorHost;
-  source: JsDocSource;
-  parameterType: () => Type | undefined;
-};
-type Match = {
-  name: string;
-  on?: DecoratorTarget;
-};
-type JsDocMatch = {
-  tag: string;
-  on?: DecoratorTarget;
-};
-type ReplacesPolicy = true | string;
-/**
- * Tags a handler with a semantic concept that the type resolver consults.
- *
- * Allows preset authors to rename a decorator (via `match.name`) without
- * breaking type-resolver behaviour: the resolver looks up handlers by marker
- * and reads the canonical decorator name from each handler's `match.name`.
- */
-type ResolverMarker = `${MarkerName}` | {
-  numeric: `${NumericKind}`;
-};
-type HandlerBase = {
-  match: Match;
-  replaces?: ReplacesPolicy;
-  marker?: ResolverMarker;
-};
-type ControllerHandler = HandlerBase & {
-  apply: (ctx: HandlerContext, draft: ControllerDraft) => void;
-};
-type MethodHandler = HandlerBase & {
-  apply: (ctx: HandlerContext, draft: MethodDraft) => void;
-};
-type ParameterHandler = HandlerBase & {
-  apply: (ctx: HandlerContext, draft: ParameterDraft) => void;
-};
-type JsDocHandlerBase = {
-  match: JsDocMatch;
-  replaces?: ReplacesPolicy;
-  marker?: ResolverMarker;
-};
-type ControllerJsDocHandler = JsDocHandlerBase & {
-  apply: (ctx: JsDocHandlerContext, draft: ControllerDraft) => void;
-};
-type MethodJsDocHandler = JsDocHandlerBase & {
-  apply: (ctx: JsDocHandlerContext, draft: MethodDraft) => void;
-};
-type ParameterJsDocHandler = JsDocHandlerBase & {
-  apply: (ctx: JsDocHandlerContext, draft: ParameterDraft) => void;
-};
-type AnyDecoratorHandler = ControllerHandler | MethodHandler | ParameterHandler;
-type AnyJsDocHandler = ControllerJsDocHandler | MethodJsDocHandler | ParameterJsDocHandler;
-type Preset = {
-  name: string;
-  extends?: string[];
-  controllers?: ControllerHandler[];
-  methods?: MethodHandler[];
-  parameters?: ParameterHandler[];
-  controllerJsDoc?: ControllerJsDocHandler[];
-  methodJsDoc?: MethodJsDocHandler[];
-  parameterJsDoc?: ParameterJsDocHandler[];
-};
-type Registry = {
-  controllers: ControllerHandler[];
-  methods: MethodHandler[];
-  parameters: ParameterHandler[];
-  controllerJsDoc: ControllerJsDocHandler[];
-  methodJsDoc: MethodJsDocHandler[];
-  parameterJsDoc: ParameterJsDocHandler[];
-};
-type PresetResolver = (name: string) => Promise<Preset> | Preset;
-type LoadRegistryOptions = {
-  resolver: PresetResolver;
-  strict?: boolean;
-};
-//#endregion
 //#region src/adapters/cache/utils.d.ts
 declare function buildCacheOptions(input?: string | boolean | CacheOptionsInput): CacheOptions;
 type CacheKeyParts = {
@@ -813,507 +108,6 @@ declare function hashCompilerOptions(options?: CompilerOptions): string;
  */
 declare function hashRegistry(registry: Registry): string;
 //#endregion
-//#region src/adapters/decorator/helpers.d.ts
-/**
- * Read a positional argument as a string. Accepts both literal string args
- * (`@Foo('value')`) and identifier references that resolve to a string
- * (`@Foo(SOME_CONSTANT)`). Returns `undefined` for any other argument shape.
- */
-declare function readString(arg: DecoratorArgument | undefined): string | undefined;
-/**
- * Read a positional argument as a number. Only matches numeric literals.
- */
-declare function readNumber(arg: DecoratorArgument | undefined): number | undefined;
-/**
- * Read a positional argument as a boolean. Only matches boolean literals.
- */
-declare function readBoolean(arg: DecoratorArgument | undefined): boolean | undefined;
-/**
- * Read a positional argument that may be either a single string or an array
- * of strings. Returns `undefined` when the argument is missing, when any
- * array element is non-string, or otherwise unresolvable. All-or-nothing:
- * never returns a partial array with non-string items silently dropped.
- */
-declare function readStringOrStringArray(arg: DecoratorArgument | undefined): string[] | undefined;
-/**
- * Convenience for the common controller path assignment. Reads the first
- * argument as a string-or-string-array and writes it to `draft.paths`,
- * defaulting to `['']` when the argument is missing or unresolvable. Use this
- * inside a `controller({ match, apply })` handler to declare a class as a
- * controller.
- */
-declare function setControllerPaths(draft: ControllerDraft, arg: DecoratorArgument | undefined): void;
-/**
- * Convenience for the common method path assignment. Reads the first argument
- * as a string and writes it to `draft.path` if present; leaves the field
- * untouched otherwise (the orchestrator initialises it to `''`).
- */
-declare function setMethodPath(draft: MethodDraft, arg: DecoratorArgument | undefined): void;
-//#endregion
-//#region src/adapters/decorator/module.d.ts
-declare function loadRegistry(preset: Preset, options: LoadRegistryOptions): Promise<Registry>;
-/**
- * Resolve a preset by string identifier (npm package, relative path, etc.) and
- * return the v2 Preset object. Looks for a `preset` named export, then the
- * default export, then the module itself.
- */
-declare function resolvePresetByName(input: string): Promise<Preset>;
-/**
- * Resolve a preset by name and immediately materialize its registry, recursively
- * loading `extends` parents through the same resolver.
- */
-declare function loadRegistryByName(input: string): Promise<Registry>;
-//#endregion
-//#region src/adapters/decorator/test-helpers.d.ts
-/**
- * Build a literal-kind {@link DecoratorArgument} from a primitive value.
- * Use this in unit tests to feed handlers a mock argument:
- *
- * ```ts
- * const ctx = createHandlerContext({ args: [literalArg('users')] });
- * controllerHandler.apply(ctx, draft);
- * ```
- */
-declare function literalArg(raw: string | number | boolean | null): DecoratorArgument;
-/**
- * Build an identifier-kind {@link DecoratorArgument} (e.g. `@Foo(SOME_CONSTANT)`).
- * `raw` is the resolved value the identifier points to — typically a string.
- */
-declare function identifierArg(raw: unknown): DecoratorArgument;
-/**
- * Build an array-kind {@link DecoratorArgument} (e.g. `@Foo(['a', 'b'])`).
- */
-declare function arrayArg(raw: unknown[]): DecoratorArgument;
-/**
- * Build an object-kind {@link DecoratorArgument} (e.g. `@Foo({ key: 'value' })`).
- */
-declare function objectArg(raw: Record<string, unknown>): DecoratorArgument;
-/**
- * Build an unresolvable-kind {@link DecoratorArgument} — represents arguments
- * the source extractor couldn't statically evaluate (e.g. function calls,
- * unknown identifiers).
- */
-declare function unresolvableArg(): DecoratorArgument;
-/**
- * Build a {@link DecoratorTypeArgument} stub that returns the supplied type
- * when `resolve()` is called.
- */
-declare function typeArg(type: Type): DecoratorTypeArgument;
-type CreateHandlerContextInput = {
-  args?: DecoratorArgument[];
-  typeArgs?: DecoratorTypeArgument[];
-  host?: DecoratorHost;
-  parameterType?: Type;
-};
-/**
- * Construct a {@link HandlerContext} for unit-testing handlers in isolation
- * without spinning up the full TypeScript compiler / `generateMetadata`
- * pipeline. Combine with the `*Arg(...)` builders to feed a handler a
- * controlled mock decorator source.
- *
- * ```ts
- * const ctx = createHandlerContext({ args: [literalArg('users')] });
- * const draft = newControllerDraft({ name: 'UserController', location: '/x.ts' });
- * myHandler.apply(ctx, draft);
- * expect(draft.paths).toEqual(['users']);
- * ```
- */
-declare function createHandlerContext(input?: CreateHandlerContextInput): HandlerContext;
-//#endregion
-//#region src/adapters/decorator/orchestrator/types.d.ts
-/**
- * Reported when a decorator on a node has no matching handler in the
- * supplied registry. The orchestrator computes file/line from the host node
- * (1-based line number).
- */
-type UnmatchedDecoratorReport = {
-  name: string;
-  target: DecoratorTarget;
-  host: DecoratorHost;
-  file: string;
-  line: number;
-};
-type ApplyHandlersOptions = {
-  target: DecoratorTarget;
-  host: DecoratorHost;
-  resolveTypeNode: (node: TypeNode) => Type;
-  parameterType?: () => Type | undefined;
-  typeChecker?: TypeChecker;
-  /**
-   * Optional reporter for decorator sources that no handler matched.
-   * The orchestrator builds a {@link DecoratorSource} for every decorator
-   * on the node; if iteration finishes without any handler claiming a
-   * source, this callback fires once for that source.
-   */
-  onUnmatchedDecorator?: (report: UnmatchedDecoratorReport, source: DecoratorSource) => void;
-};
-//#endregion
-//#region src/adapters/decorator/orchestrator/module.d.ts
-type DecoratorHandlerLike<D> = {
-  match: Match;
-  apply: (ctx: HandlerContext, draft: D) => void;
-};
-type JsDocHandlerLike<D> = {
-  match: JsDocMatch;
-  apply: (ctx: JsDocHandlerContext, draft: D) => void;
-};
-declare function buildHandlerContext(source: DecoratorSource, options: ApplyHandlersOptions): HandlerContext;
-declare function buildJsDocHandlerContext(source: JsDocSource, options: ApplyHandlersOptions): JsDocHandlerContext;
-declare function applyDecoratorHandlers<D>(node: Node, handlers: DecoratorHandlerLike<D>[], draft: D, options: ApplyHandlersOptions): void;
-declare function applyJsDocHandlers<D>(node: Node, handlers: JsDocHandlerLike<D>[], draft: D, options: ApplyHandlersOptions): void;
-//#endregion
-//#region src/adapters/decorator/typescript/types.d.ts
-type DecoratorSourceBuilderOptions = {
-  target: DecoratorTarget;
-  host: DecoratorHost;
-  resolveTypeNode: (node: TypeNode) => Type;
-  typeChecker?: TypeChecker;
-};
-type JsDocSourceBuilderOptions = {
-  target: DecoratorTarget;
-  host: DecoratorHost;
-  resolveTypeNode: (node: TypeNode) => Type;
-};
-//#endregion
-//#region src/adapters/decorator/typescript/module.d.ts
-declare function buildDecoratorSources(node: Node, options: DecoratorSourceBuilderOptions): DecoratorSource[];
-declare function buildJsDocSources(node: Node, options: JsDocSourceBuilderOptions): JsDocSource[];
-//#endregion
-//#region src/adapters/decorator/typescript/utils.d.ts
-type RawDecorator = {
-  name: string;
-  arguments: DecoratorArgument[];
-};
-/**
- * Enumerate decorators on a TS node and classify their argument values without
- * going through the registry. Used by read-side consumers (type resolver,
- * extension extraction) that only need decorator names + argument values.
- */
-declare function readNodeDecorators(node: Node, typeChecker?: TypeChecker): RawDecorator[];
-declare function findDecoratorByName(node: Node, name: string, typeChecker?: TypeChecker): RawDecorator | undefined;
-declare function findDecoratorsByName(node: Node, name: string, typeChecker?: TypeChecker): RawDecorator[];
-declare function hasDecoratorNamed(node: Node, name: string, typeChecker?: TypeChecker): boolean;
-declare function buildDecoratorArgument(expr: Expression, typeChecker?: TypeChecker): DecoratorArgument;
-//#endregion
-//#region src/adapters/decorator/utils.d.ts
-declare function matches(match: Match, source: Pick<DecoratorSource, 'name' | 'target'>): boolean;
-declare function matchesJsDoc(match: JsDocMatch, source: Pick<JsDocSource, 'tag' | 'target'>): boolean;
-declare function newControllerDraft(input: Pick<ControllerDraft, 'name' | 'location'>): ControllerDraft;
-declare function newMethodDraft(input: Pick<MethodDraft, 'name'>): MethodDraft;
-declare function newParameterDraft(input: Pick<ParameterDraft, 'parameterName'>): ParameterDraft;
-declare function createRegistry(): Registry;
-declare function generatePresetLookupPaths(input: string): string[];
-/**
- * Collect the unique decorator names of every handler whose `marker` matches
- * the given predicate. Lets the type resolver discover preset-renamed
- * decorators without hard-coding canonical names.
- */
-declare function namesForMarker(registry: Registry, predicate: (marker: ResolverMarker) => boolean): Set<string>;
-/**
- * Collect the unique JSDoc tag names of every JSDoc handler whose `marker`
- * matches the given predicate. JSDoc analogue of `namesForMarker`.
- */
-declare function tagsForMarker(registry: Registry, predicate: (marker: ResolverMarker) => boolean): Set<string>;
-declare function isHiddenMarker(marker: ResolverMarker): boolean;
-declare function isDeprecatedMarker(marker: ResolverMarker): boolean;
-declare function isExtensionMarker(marker: ResolverMarker): boolean;
-declare function numericMarkerKind(marker: ResolverMarker): 'int' | 'long' | 'float' | 'double' | undefined;
-declare const controller: (handler: ControllerHandler) => ControllerHandler;
-declare const method: (handler: MethodHandler) => MethodHandler;
-declare const parameter: (handler: ParameterHandler) => ParameterHandler;
-declare const controllerJsDoc: (handler: ControllerJsDocHandler) => ControllerJsDocHandler;
-declare const methodJsDoc: (handler: MethodJsDocHandler) => MethodJsDocHandler;
-declare const parameterJsDoc: (handler: ParameterJsDocHandler) => ParameterJsDocHandler;
-type AnyDraft = ControllerDraft | MethodDraft | ParameterDraft;
-type DraftApply = (ctx: HandlerContext, draft: AnyDraft) => void;
-declare function into(key: string): {
-  positional(index: number): DraftApply;
-  typeArgument(index?: number): DraftApply;
-};
-declare function append(key: string): {
-  positional(index: number): DraftApply;
-  positionalAll(): DraftApply;
-};
-declare function flag(key: string, value?: unknown): DraftApply;
-//#endregion
-//#region src/adapters/decorator/validation/module.d.ts
-declare const matchSchema: z.ZodObject<{
-  name: z.ZodString;
-  on: z.ZodOptional<z.ZodEnum<{
-    class: "class";
-    method: "method";
-    parameter: "parameter";
-    property: "property";
-  }>>;
-}, z.core.$strip>;
-declare const jsDocMatchSchema: z.ZodObject<{
-  tag: z.ZodString;
-  on: z.ZodOptional<z.ZodEnum<{
-    class: "class";
-    method: "method";
-    parameter: "parameter";
-    property: "property";
-  }>>;
-}, z.core.$strip>;
-declare const controllerHandlerSchema: z.ZodObject<{
-  replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-  marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-    numeric: z.ZodEnum<{
-      double: "double";
-      float: "float";
-      long: "long";
-      int: "int";
-    }>;
-  }, z.core.$strip>]>>;
-  apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-  match: z.ZodObject<{
-    name: z.ZodString;
-    on: z.ZodOptional<z.ZodEnum<{
-      class: "class";
-      method: "method";
-      parameter: "parameter";
-      property: "property";
-    }>>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-declare const methodHandlerSchema: z.ZodObject<{
-  replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-  marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-    numeric: z.ZodEnum<{
-      double: "double";
-      float: "float";
-      long: "long";
-      int: "int";
-    }>;
-  }, z.core.$strip>]>>;
-  apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-  match: z.ZodObject<{
-    name: z.ZodString;
-    on: z.ZodOptional<z.ZodEnum<{
-      class: "class";
-      method: "method";
-      parameter: "parameter";
-      property: "property";
-    }>>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-declare const parameterHandlerSchema: z.ZodObject<{
-  replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-  marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-    numeric: z.ZodEnum<{
-      double: "double";
-      float: "float";
-      long: "long";
-      int: "int";
-    }>;
-  }, z.core.$strip>]>>;
-  apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-  match: z.ZodObject<{
-    name: z.ZodString;
-    on: z.ZodOptional<z.ZodEnum<{
-      class: "class";
-      method: "method";
-      parameter: "parameter";
-      property: "property";
-    }>>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-declare const controllerJsDocHandlerSchema: z.ZodObject<{
-  replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-  marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-    numeric: z.ZodEnum<{
-      double: "double";
-      float: "float";
-      long: "long";
-      int: "int";
-    }>;
-  }, z.core.$strip>]>>;
-  apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-  match: z.ZodObject<{
-    tag: z.ZodString;
-    on: z.ZodOptional<z.ZodEnum<{
-      class: "class";
-      method: "method";
-      parameter: "parameter";
-      property: "property";
-    }>>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-declare const methodJsDocHandlerSchema: z.ZodObject<{
-  replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-  marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-    numeric: z.ZodEnum<{
-      double: "double";
-      float: "float";
-      long: "long";
-      int: "int";
-    }>;
-  }, z.core.$strip>]>>;
-  apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-  match: z.ZodObject<{
-    tag: z.ZodString;
-    on: z.ZodOptional<z.ZodEnum<{
-      class: "class";
-      method: "method";
-      parameter: "parameter";
-      property: "property";
-    }>>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-declare const parameterJsDocHandlerSchema: z.ZodObject<{
-  replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-  marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-    numeric: z.ZodEnum<{
-      double: "double";
-      float: "float";
-      long: "long";
-      int: "int";
-    }>;
-  }, z.core.$strip>]>>;
-  apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-  match: z.ZodObject<{
-    tag: z.ZodString;
-    on: z.ZodOptional<z.ZodEnum<{
-      class: "class";
-      method: "method";
-      parameter: "parameter";
-      property: "property";
-    }>>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-declare const presetSchema: z.ZodObject<{
-  name: z.ZodString;
-  extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  controllers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-    marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-      numeric: z.ZodEnum<{
-        double: "double";
-        float: "float";
-        long: "long";
-        int: "int";
-      }>;
-    }, z.core.$strip>]>>;
-    apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-    match: z.ZodObject<{
-      name: z.ZodString;
-      on: z.ZodOptional<z.ZodEnum<{
-        class: "class";
-        method: "method";
-        parameter: "parameter";
-        property: "property";
-      }>>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>>;
-  methods: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-    marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-      numeric: z.ZodEnum<{
-        double: "double";
-        float: "float";
-        long: "long";
-        int: "int";
-      }>;
-    }, z.core.$strip>]>>;
-    apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-    match: z.ZodObject<{
-      name: z.ZodString;
-      on: z.ZodOptional<z.ZodEnum<{
-        class: "class";
-        method: "method";
-        parameter: "parameter";
-        property: "property";
-      }>>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>>;
-  parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-    marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-      numeric: z.ZodEnum<{
-        double: "double";
-        float: "float";
-        long: "long";
-        int: "int";
-      }>;
-    }, z.core.$strip>]>>;
-    apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-    match: z.ZodObject<{
-      name: z.ZodString;
-      on: z.ZodOptional<z.ZodEnum<{
-        class: "class";
-        method: "method";
-        parameter: "parameter";
-        property: "property";
-      }>>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>>;
-  controllerJsDoc: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-    marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-      numeric: z.ZodEnum<{
-        double: "double";
-        float: "float";
-        long: "long";
-        int: "int";
-      }>;
-    }, z.core.$strip>]>>;
-    apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-    match: z.ZodObject<{
-      tag: z.ZodString;
-      on: z.ZodOptional<z.ZodEnum<{
-        class: "class";
-        method: "method";
-        parameter: "parameter";
-        property: "property";
-      }>>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>>;
-  methodJsDoc: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-    marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-      numeric: z.ZodEnum<{
-        double: "double";
-        float: "float";
-        long: "long";
-        int: "int";
-      }>;
-    }, z.core.$strip>]>>;
-    apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-    match: z.ZodObject<{
-      tag: z.ZodString;
-      on: z.ZodOptional<z.ZodEnum<{
-        class: "class";
-        method: "method";
-        parameter: "parameter";
-        property: "property";
-      }>>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>>;
-  parameterJsDoc: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    replaces: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodString]>>;
-    marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hidden">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"extension">, z.ZodObject<{
-      numeric: z.ZodEnum<{
-        double: "double";
-        float: "float";
-        long: "long";
-        int: "int";
-      }>;
-    }, z.core.$strip>]>>;
-    apply: z.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-    match: z.ZodObject<{
-      tag: z.ZodString;
-      on: z.ZodOptional<z.ZodEnum<{
-        class: "class";
-        method: "method";
-        parameter: "parameter";
-        property: "property";
-      }>>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>>;
-}, z.core.$strip>;
-declare function createPresetContainer(): Container<Preset>;
-declare function validatePreset(input: unknown): Promise<Preset>;
-//#endregion
 //#region src/adapters/filesystem/tsconfig/types.d.ts
 type TsconfigLoadContext = {
   cwd?: string;
@@ -1356,9 +150,29 @@ type MetadataGeneratorOptions = {
    */
   cache?: string | boolean | Partial<CacheOptions>;
   /**
-   * Load a specific preset configuration.
+   * Decorator preset to load. Either:
+   * - a string identifier resolved via {@link resolvePresetByName}
+   *   (npm package, relative path, or `module:` specifier), or
+   * - an inline {@link Preset} object (still walked through `loadRegistry`,
+   *   so its `extends` chain — if any — is resolved by name).
+   *
+   * If both `preset` and `registry` are provided, the resolved preset
+   * registry comes first and the inline `registry` is appended after.
+   * Inline handlers therefore run last (winning on scalar mutations like
+   * `into('path')`) and additively contribute on `append`-style fields.
+   */
+  preset?: string | Preset;
+  /**
+   * An already-resolved decorator {@link Registry}. Use this to wire
+   * decorator handlers manually without authoring a full {@link Preset}.
+   *
+   * If provided alongside `preset`, the registry is appended to the
+   * preset-derived registry (preset first, registry second). Inline
+   * handlers cannot carry `replaces` semantics — those are enforced at
+   * preset-load time. To remove a preset handler, author a `Preset` with
+   * `replaces` and pass it via `preset` instead.
    */
-  preset?: string;
+  registry?: Registry;
   /**
    * Controls how unmatched decorators (decorators with no matching handler
    * in the resolved registry) are surfaced.
@@ -1405,21 +219,6 @@ type MetadataGeneratorContext = {
 interface IMetadataGenerator {
   generate(): Promise<Metadata>;
 }
-/**
- * The output specification for metadata generation.
- */
-type Metadata = {
-  /**
-   * A Controller is a collection of grouped methods (GET, POST, ...)
-   * for a common URL path (i.e /users) or an more explicit URL path (i.e. /users/:id).
-   */
-  controllers: Controller[];
-  /**
-   * ReferenceTypes is an object of found types (interfaces, type, ...),
-   * and classes which were detected during code analysis.
-   */
-  referenceTypes: ReferenceTypes;
-};
 /**
  * Narrow context interface for the type resolver.
  * Contains only what TypeNodeResolver needs — no generator methods.
@@ -1457,30 +256,8 @@ interface IGeneratorContext extends IResolverContext, IReferenceTypeRegistry {
   reportUnmatchedDecorator?(report: UnmatchedDecoratorReport): void;
 }
 //#endregion
-//#region src/core/metadata/variable.d.ts
-type VariableType = 'string' | 'number' | 'bigint' | 'boolean' | 'symbol' | 'undefined' | 'object' | 'function';
-//#endregion
-//#region src/core/validator/error.d.ts
-declare class ValidatorError extends MetadataError {}
-//#endregion
-//#region src/core/validator/constants.d.ts
-declare enum ValidatorName {
-  UNIQUE_ITEMS = "uniqueItems",
-  MINIMUM = "minimum",
-  MAXIMUM = "maximum",
-  MIN_ITEMS = "minItems",
-  MAX_ITEMS = "maxItems",
-  MIN_LENGTH = "minLength",
-  MAX_LENGTH = "maxLength",
-  MIN_DATE = "minDate",
-  MAX_DATE = "maxDate",
-  PATTERN = "pattern"
-}
-declare const ValidatorErrorCode: {
-  readonly EXPECTED_NUMBER: "VALIDATOR_EXPECTED_NUMBER";
-  readonly EXPECTED_DATE: "VALIDATOR_EXPECTED_DATE";
-  readonly EXPECTED_STRING: "VALIDATOR_EXPECTED_STRING";
-};
+//#region src/core/error/base.d.ts
+declare class MetadataError extends BaseError {}
 //#endregion
 //#region src/core/error/config.d.ts
 declare class ConfigError extends MetadataError {}
@@ -1493,28 +270,115 @@ declare const ConfigErrorCode: {
 };
 type ConfigErrorCode = typeof ConfigErrorCode[keyof typeof ConfigErrorCode];
 //#endregion
+//#region src/core/error/generator.d.ts
+declare class GeneratorError extends MetadataError {}
+declare function isGeneratorError(input: unknown): input is GeneratorError & {
+  code: string;
+};
+//#endregion
+//#region src/core/error/generator-codes.d.ts
+declare const GeneratorErrorCode: {
+  readonly CONTROLLER_NO_SOURCE_FILE: "GENERATOR_CONTROLLER_NO_SOURCE_FILE";
+  readonly CONTROLLER_NO_NAME: "GENERATOR_CONTROLLER_NO_NAME";
+  readonly PARAMETER_GENERATION_FAILED: "GENERATOR_PARAMETER_GENERATION_FAILED";
+  readonly BODY_PARAMETER_DUPLICATE: "GENERATOR_BODY_PARAMETER_DUPLICATE";
+  readonly BODY_FORM_CONFLICT: "GENERATOR_BODY_FORM_CONFLICT";
+  readonly STRICT_UNMATCHED_DECORATORS: "GENERATOR_STRICT_UNMATCHED_DECORATORS";
+};
+type GeneratorErrorCode = typeof GeneratorErrorCode[keyof typeof GeneratorErrorCode];
+//#endregion
+//#region src/core/error/parameter.d.ts
+type UnsupportedTypeContext = {
+  decoratorName: string;
+  propertyName: string;
+  type: BaseType;
+  node?: Node;
+};
+type UnsupportedMethodContext = {
+  decoratorName: string;
+  propertyName: string;
+  method: string;
+  node?: Node;
+};
+type PathMatchInvalidContext = {
+  decoratorName: string;
+  propertyName: string;
+  path: string;
+  node?: Node;
+};
+type ScopeRequiredContext = {
+  decoratorName: string;
+  node?: Node;
+};
+declare class ParameterError extends MetadataError {
+  static typeUnsupported(context: UnsupportedTypeContext): ParameterError;
+  static methodUnsupported(context: UnsupportedMethodContext): ParameterError;
+  static invalidPathMatch(context: PathMatchInvalidContext): ParameterError;
+  static scopeRequired(context: ScopeRequiredContext): ParameterError;
+  static invalidExampleSchema(): ParameterError;
+  static getCurrentLocation(node: Node): string;
+}
+//#endregion
+//#region src/core/error/parameter-codes.d.ts
+declare const ParameterErrorCode: {
+  readonly TYPE_UNSUPPORTED: "PARAMETER_TYPE_UNSUPPORTED";
+  readonly METHOD_UNSUPPORTED: "PARAMETER_METHOD_UNSUPPORTED";
+  readonly PATH_MISMATCH: "PARAMETER_PATH_MISMATCH";
+  readonly SCOPE_REQUIRED: "PARAMETER_SCOPE_REQUIRED";
+  readonly INVALID_EXAMPLE: "PARAMETER_INVALID_EXAMPLE";
+};
+type ParameterErrorCode = typeof ParameterErrorCode[keyof typeof ParameterErrorCode];
+//#endregion
+//#region src/core/error/resolver.d.ts
+declare class ResolverError extends MetadataError {
+  readonly file?: string;
+  readonly line?: number;
+  constructor(message: string, node?: Node | TypeNode, options?: boolean | {
+    onlyCurrent?: boolean;
+    cause?: unknown;
+  });
+}
+declare function isResolverError(input: unknown): input is ResolverError;
+declare function prettyLocationOfNode(node: Node | TypeNode): {
+  text: string;
+  file: string;
+  line?: number;
+} | undefined;
+declare function prettyTroubleCause(node: Node | TypeNode, onlyCurrent?: boolean): string;
+//#endregion
+//#region src/core/error/validator.d.ts
+declare class ValidatorError extends MetadataError {}
+//#endregion
+//#region src/core/error/validator-codes.d.ts
+declare const ValidatorErrorCode: {
+  readonly EXPECTED_NUMBER: "VALIDATOR_EXPECTED_NUMBER";
+  readonly EXPECTED_DATE: "VALIDATOR_EXPECTED_DATE";
+  readonly EXPECTED_STRING: "VALIDATOR_EXPECTED_STRING";
+};
+type ValidatorErrorCode = typeof ValidatorErrorCode[keyof typeof ValidatorErrorCode];
+//#endregion
 //#region src/adapters/typescript/resolver/types.d.ts
-type OverrideToken = ts.Token<ts.SyntaxKind.QuestionToken> | ts.Token<ts.SyntaxKind.PlusToken> | ts.Token<ts.SyntaxKind.MinusToken>;
-type UsableDeclaration = ts.InterfaceDeclaration | ts.ClassDeclaration | ts.PropertySignature | ts.TypeAliasDeclaration | ts.EnumMember;
+type OverrideToken = Token<SyntaxKind.QuestionToken> | Token<SyntaxKind.PlusToken> | Token<SyntaxKind.MinusToken>;
+type UsableDeclaration = InterfaceDeclaration | ClassDeclaration | PropertySignature | TypeAliasDeclaration | EnumMember;
 type TypeNodeResolverContext = {
-  [name: string]: ts.TypeReferenceNode | ts.TypeNode;
+  [name: string]: TypeReferenceNode | TypeNode;
 };
 type SubResolverContext = {
-  readonly typeChecker: ts.TypeChecker;
+  readonly typeChecker: TypeChecker;
   readonly current: IResolverContext & IReferenceTypeRegistry;
-  readonly parentNode?: ts.Node;
+  readonly parentNode?: Node;
   readonly context: TypeNodeResolverContext;
-  readonly referencer?: ts.TypeNode;
-  resolveType(typeNode: ts.TypeNode, parentNode?: ts.Node, context?: TypeNodeResolverContext, referencer?: ts.TypeNode): Type;
-  propertyFromSignature(sig: ts.PropertySignature, overrideToken?: OverrideToken): ResolverProperty;
-  propertyFromDeclaration(decl: ts.PropertyDeclaration | ts.ParameterDeclaration, overrideToken?: OverrideToken): ResolverProperty;
-  getNodeDescription(node: UsableDeclaration | ts.PropertyDeclaration | ts.ParameterDeclaration | ts.EnumDeclaration): string;
-  getNodeExample(node: UsableDeclaration | ts.PropertyDeclaration | ts.ParameterDeclaration | ts.EnumDeclaration): unknown;
-  getNodeExtensions(node: UsableDeclaration | ts.PropertyDeclaration | ts.ParameterDeclaration | ts.EnumDeclaration): Extension[];
+  readonly referencer?: TypeNode;
+  resolveType(typeNode: TypeNode, parentNode?: Node, context?: TypeNodeResolverContext, referencer?: TypeNode): Type;
+  propertyFromSignature(sig: PropertySignature, overrideToken?: OverrideToken): ResolverProperty;
+  propertyFromDeclaration(decl: PropertyDeclaration | ParameterDeclaration, overrideToken?: OverrideToken): ResolverProperty;
+  getNodeDescription(node: UsableDeclaration | PropertyDeclaration | ParameterDeclaration | EnumDeclaration): string;
+  getNodeExample(node: UsableDeclaration | PropertyDeclaration | ParameterDeclaration | EnumDeclaration): unknown;
+  getNodeExtensions(node: UsableDeclaration | PropertyDeclaration | ParameterDeclaration | EnumDeclaration): Extension[];
 };
 //#endregion
 //#region src/adapters/typescript/resolver/sub/array.d.ts
-declare function resolveArrayType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveArrayType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/base.d.ts
 declare class ResolverBase {
@@ -1524,27 +388,27 @@ declare class ResolverBase {
 }
 //#endregion
 //#region src/adapters/typescript/resolver/sub/indexed-access.d.ts
-declare function resolveIndexedAccessType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveIndexedAccessType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/intersection.d.ts
-declare function resolveIntersectionType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveIntersectionType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/literal.d.ts
-declare function resolveLiteralType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
-declare function getLiteralValue(typeNode: ts.LiteralTypeNode): string | number | boolean | null;
+declare function resolveLiteralType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function getLiteralValue(typeNode: LiteralTypeNode): string | number | boolean | null;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/mapped.d.ts
-declare function resolveMappedType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveMappedType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/object-literal.d.ts
-declare function resolveObjectLiteralType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveObjectLiteralType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/primitive.d.ts
 declare class PrimitiveResolver {
   protected registry: Registry;
   constructor(registry: Registry);
   resolve(node: TypeNode, parentNode?: Node): PrimitiveType | NeverType | VoidType | undefined;
-  resolveSyntaxKind(syntaxKind: SyntaxKind): "string" | "number" | "boolean" | "bigint" | "null" | "undefined" | "void" | "never";
+  resolveSyntaxKind(syntaxKind: SyntaxKind): "string" | "boolean" | "void" | "undefined" | "null" | "number" | "bigint" | "never";
 }
 //#endregion
 //#region src/adapters/typescript/resolver/sub/reference.d.ts
@@ -1561,13 +425,13 @@ declare class ReferenceResolver extends ResolverBase {
 }
 //#endregion
 //#region src/adapters/typescript/resolver/sub/tuple.d.ts
-declare function resolveTupleType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveTupleType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/type-operator.d.ts
-declare function resolveTypeOperatorType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveTypeOperatorType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/sub/union.d.ts
-declare function resolveUnionType(typeNode: ts.TypeNode, ctx: SubResolverContext): Type | undefined;
+declare function resolveUnionType(typeNode: TypeNode, ctx: SubResolverContext): Type | undefined;
 //#endregion
 //#region src/adapters/typescript/resolver/module.d.ts
 declare class TypeNodeResolver extends ResolverBase {
@@ -1580,7 +444,7 @@ declare class TypeNodeResolver extends ResolverBase {
   private readonly depth;
   private readonly primitiveResolver;
   private readonly referenceResolver;
-  constructor(typeNode: ts.TypeNode, current: IResolverContext & IReferenceTypeRegistry, parentNode?: ts.Node, context?: TypeNodeResolverContext, referencer?: ts.TypeNode, depth?: number);
+  constructor(typeNode: TypeNode, current: IResolverContext & IReferenceTypeRegistry, parentNode?: Node, context?: TypeNodeResolverContext, referencer?: TypeNode, depth?: number);
   /**
    * @deprecated Use resolverCache.clear() on the context instead.
    * Kept for backward compatibility — no-ops since cache is now instance-scoped.
@@ -1632,7 +496,7 @@ declare class TypeNodeResolver extends ResolverBase {
   private getNodeDescription;
   private static getNodeFormat;
   private getNodeExample;
-  protected getNodeExtensions(node: UsableDeclaration | ts.PropertyDeclaration | ts.ParameterDeclaration | ts.EnumDeclaration): Extension[];
+  protected getNodeExtensions(node: UsableDeclaration | PropertyDeclaration | ParameterDeclaration | EnumDeclaration): Extension[];
 }
 //#endregion
 //#region src/adapters/typescript/resolver/cache.d.ts
@@ -1671,8 +535,8 @@ interface NodeDecorator {
 declare function getNodeDecorators(node: Node, isMatching?: (data: NodeDecorator) => boolean): NodeDecorator[];
 //#endregion
 //#region src/adapters/typescript/initializer.d.ts
-declare function getInitializerValue(initializer?: ts.Expression, typeChecker?: ts.TypeChecker, type?: Type): unknown;
-declare const hasInitializer: (node: ts.Node) => node is ts.HasInitializer;
+declare function getInitializerValue(initializer?: Expression, typeChecker?: TypeChecker, type?: Type): unknown;
+declare const hasInitializer: (node: Node) => node is HasInitializer;
 //#endregion
 //#region src/adapters/typescript/js-doc/constants.d.ts
 declare enum JSDocTagName {
@@ -1708,6 +572,69 @@ declare function transformJSDocComment(input?: string | NodeArray<JSDocComment>)
 //#region src/adapters/typescript/validator/module.d.ts
 declare function getDeclarationValidators(declaration: PropertyDeclaration | TypeAliasDeclaration | PropertySignature | ParameterDeclaration, name?: string): Record<string, Validator>;
 //#endregion
+//#region src/adapters/decorator/orchestrator/types.d.ts
+type ApplyHandlersOptions = {
+  target: DecoratorTarget;
+  host: DecoratorHost;
+  resolveTypeNode: (node: TypeNode) => Type;
+  parameterType?: () => Type | undefined;
+  typeChecker?: TypeChecker;
+  /**
+   * Optional reporter for decorator sources that no handler matched.
+   * The orchestrator builds a {@link DecoratorSource} for every decorator
+   * on the node; if iteration finishes without any handler claiming a
+   * source, this callback fires once for that source.
+   */
+  onUnmatchedDecorator?: (report: UnmatchedDecoratorReport, source: DecoratorSource) => void;
+};
+//#endregion
+//#region src/adapters/decorator/orchestrator/module.d.ts
+type DecoratorHandlerLike<D> = {
+  match: Match;
+  apply: (ctx: HandlerContext, draft: D) => void;
+};
+type JsDocHandlerLike<D> = {
+  match: JsDocMatch;
+  apply: (ctx: JsDocHandlerContext, draft: D) => void;
+};
+declare function buildHandlerContext(source: DecoratorSource, options: ApplyHandlersOptions): HandlerContext;
+declare function buildJsDocHandlerContext(source: JsDocSource, options: ApplyHandlersOptions): JsDocHandlerContext;
+declare function applyDecoratorHandlers<D>(node: Node, handlers: DecoratorHandlerLike<D>[], draft: D, options: ApplyHandlersOptions): void;
+declare function applyJsDocHandlers<D>(node: Node, handlers: JsDocHandlerLike<D>[], draft: D, options: ApplyHandlersOptions): void;
+//#endregion
+//#region src/adapters/decorator/typescript/types.d.ts
+type DecoratorSourceBuilderOptions = {
+  target: DecoratorTarget;
+  host: DecoratorHost;
+  resolveTypeNode: (node: TypeNode) => Type;
+  typeChecker?: TypeChecker;
+};
+type JsDocSourceBuilderOptions = {
+  target: DecoratorTarget;
+  host: DecoratorHost;
+  resolveTypeNode: (node: TypeNode) => Type;
+};
+//#endregion
+//#region src/adapters/decorator/typescript/module.d.ts
+declare function buildDecoratorSources(node: Node, options: DecoratorSourceBuilderOptions): DecoratorSource[];
+declare function buildJsDocSources(node: Node, options: JsDocSourceBuilderOptions): JsDocSource[];
+//#endregion
+//#region src/adapters/decorator/typescript/utils.d.ts
+type RawDecorator = {
+  name: string;
+  arguments: DecoratorArgument[];
+};
+/**
+ * Enumerate decorators on a TS node and classify their argument values without
+ * going through the registry. Used by read-side consumers (type resolver,
+ * extension extraction) that only need decorator names + argument values.
+ */
+declare function readNodeDecorators(node: Node, typeChecker?: TypeChecker): RawDecorator[];
+declare function findDecoratorByName(node: Node, name: string, typeChecker?: TypeChecker): RawDecorator | undefined;
+declare function findDecoratorsByName(node: Node, name: string, typeChecker?: TypeChecker): RawDecorator[];
+declare function hasDecoratorNamed(node: Node, name: string, typeChecker?: TypeChecker): boolean;
+declare function buildDecoratorArgument(expr: Expression, typeChecker?: TypeChecker): DecoratorArgument;
+//#endregion
 //#region src/adapters/filesystem/source-files.d.ts
 declare function scanSourceFiles(input: EntryPoint): Promise<string[]>;
 //#endregion
@@ -1755,9 +682,6 @@ declare class MetadataGenerator implements IGeneratorContext, IMetadataGenerator
   private buildControllers;
 }
 //#endregion
-//#region src/app/generator/metadata/utils.d.ts
-declare function isMetadata(input: unknown): input is Metadata;
-//#endregion
 //#region src/app/generator/controller/module.d.ts
 declare class ControllerGenerator implements IControllerGenerator {
   protected readonly node: ClassDeclaration;
@@ -1789,7 +713,7 @@ declare class ParameterGenerator implements IParameterGenerator {
   private readonly method;
   private readonly paths;
   private readonly current;
-  constructor(parameter: ts.ParameterDeclaration, method: string, paths: string[], current: IGeneratorContext);
+  constructor(parameter: ParameterDeclaration, method: string, paths: string[], current: IGeneratorContext);
   generate(): Parameter[];
   private finalize;
   private draftToParameter;
@@ -1815,5 +739,5 @@ declare function hasOwnProperty<Y extends PropertyKey>(obj: unknown, prop: Y): o
 //#region src/core/utils/path-normalize.d.ts
 declare function normalizePath(str: string): string;
 //#endregion
-export { AnyDecoratorHandler, AnyJsDocHandler, AnyType, ApplyHandlersOptions, ArrayParameter, ArrayType, BaseType, BigintType, BinaryType, BooleanType, BufferType, ByteType, CACHE_DEFAULT_MAX_AGE_MS, CACHE_FILE_PREFIX, CACHE_FILE_SUFFIX, CACHE_SCHEMA_VERSION, CacheClient, CacheData, CacheKeyParts, CacheOptions, CacheOptionsInput, CollectionFormat, CollectionKind, ConfigError, ConfigErrorCode, Controller, ControllerDraft, ControllerGenerator, ControllerHandler, ControllerJsDocHandler, CreateHandlerContextInput, DateTimeType, DateType, DecoratorArgument, DecoratorArgumentKind, DecoratorArgumentKindName, DecoratorHost, DecoratorSource, DecoratorSourceBuilderOptions, DecoratorTarget, DecoratorTargetKind, DecoratorTypeArgument, DependencyResolver, DoubleType, EntryPoint, EntryPointOptions, EnumType, Example, Extension, ExtensionType, FileType, FloatType, GeneratorError, GeneratorErrorCode, HandlerContext, ICacheClient, IControllerGenerator, IGeneratorContext, IMetadataGenerator, IParameterGenerator, IReferenceTypeRegistry, IResolverCache, IResolverContext, IntegerType, IntersectionType, JSDocTagName, JsDocHandlerContext, JsDocMatch, JsDocSource, JsDocSourceBuilderOptions, LoadRegistryOptions, LongType, MarkerName, Match, Metadata, MetadataError, MetadataGenerateOptions, MetadataGenerator, MetadataGeneratorContext, MetadataGeneratorOptions, Method, MethodDraft, MethodGenerator, MethodHandler, MethodJsDocHandler, MethodName, MethodType, NestedObjectLiteralType, NeverType, NodeDecorator, NumericKind, ObjectType, OverrideToken, ParamKind, Parameter, ParameterDraft, ParameterError, ParameterErrorCode, ParameterGenerator, ParameterHandler, ParameterJsDocHandler, ParameterSource, Preset, PresetResolver, PrimitiveResolver, PrimitiveType, RawDecorator, RefAliasType, RefEnumType, RefObjectType, ReferenceResolver, ReferenceType, ReferenceTypeBase, ReferenceTypes, Registry, ReplacesPolicy, ResolverBase, ResolverCache, ResolverError, ResolverMarker, ResolverProperty, Response, Security, StringType, SubResolverContext, TsCompilerOptions, TsConfig, TsconfigLoadContext, TupleElement, TupleType, Type, TypeName, TypeNodeResolver, TypeNodeResolverContext, UndefinedType, UnionType, UnmatchedDecoratorReport, UsableDeclaration, UtilityTypeName, Validator, ValidatorError, ValidatorErrorCode, ValidatorMeta, ValidatorName, Validators, VariableType, VoidType, append, applyDecoratorHandlers, applyJsDocHandlers, arrayArg, buildCacheOptions, buildDecoratorArgument, buildDecoratorSources, buildHandlerContext, buildJsDocHandlerContext, buildJsDocSources, composeCacheKey, controller, controllerHandlerSchema, controllerJsDoc, controllerJsDocHandlerSchema, createHandlerContext, createPresetContainer, createRegistry, findDecoratorByName, findDecoratorsByName, flag, generateMetadata, generatePresetLookupPaths, getDeclarationValidators, getInitializerValue, getJSDoc, getJSDocDescription, getJSDocTagComment, getJSDocTagNames, getJSDocTags, getLiteralValue, getNodeDecorators, getNodeDescription, getNodeExtensions, hasDecoratorNamed, hasInitializer, hasJSDocTag, hasOwnProperty, hashCompilerOptions, hashRegistry, identifierArg, into, isAnyType, isArrayType, isBigintType, isBinaryType, isBooleanType, isBufferType, isByteType, isDateTimeType, isDateType, isDeprecatedMarker, isDoubleType, isEnumType, isExtensionMarker, isFileType, isFloatType, isGeneratorError, isHiddenMarker, isIntegerType, isIntersectionType, isLongType, isMetadata, isNestedObjectLiteralType, isNeverType, isObjectType, isPrimitiveType, isRefAliasType, isRefEnumType, isRefObjectType, isReferenceType, isResolverError, isStringArray, isStringType, isTupleType, isUndefinedType, isUnionType, isVoidType, jsDocMatchSchema, literalArg, loadRegistry, loadRegistryByName, loadTSConfig, matchSchema, matches, matchesJsDoc, method, methodHandlerSchema, methodJsDoc, methodJsDocHandlerSchema, namesForMarker, newControllerDraft, newMethodDraft, newParameterDraft, normalizePath, numericMarkerKind, objectArg, parameter, parameterHandlerSchema, parameterJsDoc, parameterJsDocHandlerSchema, presetSchema, prettyLocationOfNode, prettyTroubleCause, readBoolean, readNodeDecorators, readNumber, readString, readStringOrStringArray, resolveArrayType, resolveIndexedAccessType, resolveIntersectionType, resolveLiteralType, resolveMappedType, resolveObjectLiteralType, resolvePresetByName, resolveTupleType, resolveTypeOperatorType, resolveUnionType, scanSourceFiles, setControllerPaths, setMethodPath, softLoadTsconfig, tagsForMarker, toTypeNodeOrFail, transformJSDocComment, typeArg, unresolvableArg, validatePreset };
+export { ApplyHandlersOptions, CACHE_DEFAULT_MAX_AGE_MS, CACHE_FILE_PREFIX, CACHE_FILE_SUFFIX, CACHE_SCHEMA_VERSION, CacheClient, CacheData, CacheKeyParts, CacheOptions, CacheOptionsInput, ConfigError, ConfigErrorCode, ControllerGenerator, DecoratorSourceBuilderOptions, EntryPoint, EntryPointOptions, GeneratorError, GeneratorErrorCode, ICacheClient, IGeneratorContext, IMetadataGenerator, IReferenceTypeRegistry, IResolverContext, JSDocTagName, JsDocSourceBuilderOptions, MetadataError, MetadataGenerateOptions, MetadataGenerator, MetadataGeneratorContext, MetadataGeneratorOptions, MethodGenerator, NodeDecorator, OverrideToken, ParameterError, ParameterErrorCode, ParameterGenerator, PrimitiveResolver, RawDecorator, ReferenceResolver, ResolverBase, ResolverCache, ResolverError, SubResolverContext, TsCompilerOptions, TsConfig, TsconfigLoadContext, TypeNodeResolver, TypeNodeResolverContext, UsableDeclaration, ValidatorError, ValidatorErrorCode, applyDecoratorHandlers, applyJsDocHandlers, buildCacheOptions, buildDecoratorArgument, buildDecoratorSources, buildHandlerContext, buildJsDocHandlerContext, buildJsDocSources, composeCacheKey, findDecoratorByName, findDecoratorsByName, generateMetadata, getDeclarationValidators, getInitializerValue, getJSDoc, getJSDocDescription, getJSDocTagComment, getJSDocTagNames, getJSDocTags, getLiteralValue, getNodeDecorators, getNodeDescription, getNodeExtensions, hasDecoratorNamed, hasInitializer, hasJSDocTag, hasOwnProperty, hashCompilerOptions, hashRegistry, isGeneratorError, isResolverError, isStringArray, loadTSConfig, normalizePath, prettyLocationOfNode, prettyTroubleCause, readNodeDecorators, resolveArrayType, resolveIndexedAccessType, resolveIntersectionType, resolveLiteralType, resolveMappedType, resolveObjectLiteralType, resolveTupleType, resolveTypeOperatorType, resolveUnionType, scanSourceFiles, softLoadTsconfig, toTypeNodeOrFail, transformJSDocComment };
 //# sourceMappingURL=index.d.mts.map