@vurb/core 3.2.0

package/dist/converters/PromptConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptConverter.d.ts","sourceRoot":"","sources":["../../src/converters/PromptConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,mBAAmB,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;CAAG"}

package/dist/converters/PromptConverter.js

@@ -0,0 +1,26 @@
+import {} from '../domain/Prompt.js';
+import { ConverterBase } from './ConverterBase.js';
+/**
+ * Base class for Prompt converters.
+ *
+ * Extend this and implement `convertFrom(prompt)` and `convertTo(dto)`.
+ *
+ * @typeParam T - The target DTO type
+ *
+ * @example
+ * ```typescript
+ * class MyPromptConverter extends PromptConverterBase<PromptDto> {
+ *     convertFrom(prompt: Prompt): PromptDto {
+ *         return { name: prompt.name, args: prompt.promptArguments.length };
+ *     }
+ *     convertTo(dto: PromptDto): Prompt {
+ *         return new Prompt(dto.name);
+ *     }
+ * }
+ * ```
+ *
+ * @see {@link ConverterBase} for batch conversion methods
+ */
+export class PromptConverterBase extends ConverterBase {
+}
+//# sourceMappingURL=PromptConverter.js.map

package/dist/converters/PromptConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptConverter.js","sourceRoot":"","sources":["../../src/converters/PromptConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAgB,mBAAuB,SAAQ,aAAwB;CAAG"}

package/dist/converters/ResourceConverter.d.ts

@@ -0,0 +1,35 @@
+import { type Resource } from '../domain/Resource.js';
+import { ConverterBase } from './ConverterBase.js';
+/**
+ * Type-safe Resource converter contract.
+ *
+ * @typeParam T - The target DTO type
+ * @see {@link ResourceConverterBase} for the base implementation class
+ */
+export type ResourceConverter<T> = ConverterBase<Resource, T>;
+/**
+ * Base class for Resource converters.
+ *
+ * Extend this and implement `convertFrom(resource)` and `convertTo(dto)`.
+ *
+ * @typeParam T - The target DTO type
+ *
+ * @example
+ * ```typescript
+ * class MyResourceConverter extends ResourceConverterBase<ResourceDto> {
+ *     convertFrom(resource: Resource): ResourceDto {
+ *         return { name: resource.name, uri: resource.uri ?? '' };
+ *     }
+ *     convertTo(dto: ResourceDto): Resource {
+ *         const r = new Resource(dto.name);
+ *         r.uri = dto.uri;
+ *         return r;
+ *     }
+ * }
+ * ```
+ *
+ * @see {@link ConverterBase} for batch conversion methods
+ */
+export declare abstract class ResourceConverterBase<T> extends ConverterBase<Resource, T> {
+}
+//# sourceMappingURL=ResourceConverter.d.ts.map

package/dist/converters/ResourceConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceConverter.d.ts","sourceRoot":"","sources":["../../src/converters/ResourceConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,qBAAqB,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;CAAG"}

package/dist/converters/ResourceConverter.js

@@ -0,0 +1,28 @@
+import {} from '../domain/Resource.js';
+import { ConverterBase } from './ConverterBase.js';
+/**
+ * Base class for Resource converters.
+ *
+ * Extend this and implement `convertFrom(resource)` and `convertTo(dto)`.
+ *
+ * @typeParam T - The target DTO type
+ *
+ * @example
+ * ```typescript
+ * class MyResourceConverter extends ResourceConverterBase<ResourceDto> {
+ *     convertFrom(resource: Resource): ResourceDto {
+ *         return { name: resource.name, uri: resource.uri ?? '' };
+ *     }
+ *     convertTo(dto: ResourceDto): Resource {
+ *         const r = new Resource(dto.name);
+ *         r.uri = dto.uri;
+ *         return r;
+ *     }
+ * }
+ * ```
+ *
+ * @see {@link ConverterBase} for batch conversion methods
+ */
+export class ResourceConverterBase extends ConverterBase {
+}
+//# sourceMappingURL=ResourceConverter.js.map

package/dist/converters/ResourceConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceConverter.js","sourceRoot":"","sources":["../../src/converters/ResourceConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,qBAAyB,SAAQ,aAA0B;CAAG"}

package/dist/converters/ToolAnnotationsConverter.d.ts

@@ -0,0 +1,33 @@
+import { type ToolAnnotations } from '../domain/ToolAnnotations.js';
+import { ConverterBase } from './ConverterBase.js';
+/**
+ * Type-safe ToolAnnotations converter contract.
+ *
+ * @typeParam T - The target DTO type
+ * @see {@link ToolAnnotationsConverterBase} for the base implementation class
+ */
+export type ToolAnnotationsConverter<T> = ConverterBase<ToolAnnotations, T>;
+/**
+ * Base class for ToolAnnotations converters.
+ *
+ * Extend this and implement `convertFrom(annotations)` and `convertTo(dto)`.
+ *
+ * @typeParam T - The target DTO type
+ *
+ * @example
+ * ```typescript
+ * class MyAnnotationsConverter extends ToolAnnotationsConverterBase<McpAnnotations> {
+ *     convertFrom(ta: ToolAnnotations): McpAnnotations {
+ *         return { readOnly: ta.readOnlyHint ?? false, destructive: ta.destructiveHint ?? false };
+ *     }
+ *     convertTo(mcp: McpAnnotations): ToolAnnotations {
+ *         return createToolAnnotations({ readOnlyHint: mcp.readOnly, destructiveHint: mcp.destructive });
+ *     }
+ * }
+ * ```
+ *
+ * @see {@link ConverterBase} for batch conversion methods
+ */
+export declare abstract class ToolAnnotationsConverterBase<T> extends ConverterBase<ToolAnnotations, T> {
+}
+//# sourceMappingURL=ToolAnnotationsConverter.d.ts.map

package/dist/converters/ToolAnnotationsConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolAnnotationsConverter.d.ts","sourceRoot":"","sources":["../../src/converters/ToolAnnotationsConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI,aAAa,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,4BAA4B,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,eAAe,EAAE,CAAC,CAAC;CAAG"}

package/dist/converters/ToolAnnotationsConverter.js

@@ -0,0 +1,26 @@
+import {} from '../domain/ToolAnnotations.js';
+import { ConverterBase } from './ConverterBase.js';
+/**
+ * Base class for ToolAnnotations converters.
+ *
+ * Extend this and implement `convertFrom(annotations)` and `convertTo(dto)`.
+ *
+ * @typeParam T - The target DTO type
+ *
+ * @example
+ * ```typescript
+ * class MyAnnotationsConverter extends ToolAnnotationsConverterBase<McpAnnotations> {
+ *     convertFrom(ta: ToolAnnotations): McpAnnotations {
+ *         return { readOnly: ta.readOnlyHint ?? false, destructive: ta.destructiveHint ?? false };
+ *     }
+ *     convertTo(mcp: McpAnnotations): ToolAnnotations {
+ *         return createToolAnnotations({ readOnlyHint: mcp.readOnly, destructiveHint: mcp.destructive });
+ *     }
+ * }
+ * ```
+ *
+ * @see {@link ConverterBase} for batch conversion methods
+ */
+export class ToolAnnotationsConverterBase extends ConverterBase {
+}
+//# sourceMappingURL=ToolAnnotationsConverter.js.map

package/dist/converters/ToolAnnotationsConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolAnnotationsConverter.js","sourceRoot":"","sources":["../../src/converters/ToolAnnotationsConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAgB,4BAAgC,SAAQ,aAAiC;CAAG"}

package/dist/converters/ToolConverter.d.ts

@@ -0,0 +1,35 @@
+import { type Tool } from '../domain/Tool.js';
+import { ConverterBase } from './ConverterBase.js';
+/**
+ * Type-safe Tool converter contract.
+ *
+ * @typeParam T - The target DTO type
+ * @see {@link ToolConverterBase} for the base implementation class
+ */
+export type ToolConverter<T> = ConverterBase<Tool, T>;
+/**
+ * Base class for Tool converters.
+ *
+ * Extend this and implement `convertFrom(tool)` and `convertTo(dto)`.
+ *
+ * @typeParam T - The target DTO type
+ *
+ * @example
+ * ```typescript
+ * class McpToolConverter extends ToolConverterBase<McpTool> {
+ *     convertFrom(tool: Tool): McpTool {
+ *         return { name: tool.name, description: tool.description ?? '' };
+ *     }
+ *     convertTo(mcp: McpTool): Tool {
+ *         const tool = new Tool(mcp.name);
+ *         tool.description = mcp.description;
+ *         return tool;
+ *     }
+ * }
+ * ```
+ *
+ * @see {@link ConverterBase} for batch conversion methods
+ */
+export declare abstract class ToolConverterBase<T> extends ConverterBase<Tool, T> {
+}
+//# sourceMappingURL=ToolConverter.d.ts.map

package/dist/converters/ToolConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolConverter.d.ts","sourceRoot":"","sources":["../../src/converters/ToolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,iBAAiB,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;CAAG"}

package/dist/converters/ToolConverter.js

@@ -0,0 +1,28 @@
+import {} from '../domain/Tool.js';
+import { ConverterBase } from './ConverterBase.js';
+/**
+ * Base class for Tool converters.
+ *
+ * Extend this and implement `convertFrom(tool)` and `convertTo(dto)`.
+ *
+ * @typeParam T - The target DTO type
+ *
+ * @example
+ * ```typescript
+ * class McpToolConverter extends ToolConverterBase<McpTool> {
+ *     convertFrom(tool: Tool): McpTool {
+ *         return { name: tool.name, description: tool.description ?? '' };
+ *     }
+ *     convertTo(mcp: McpTool): Tool {
+ *         const tool = new Tool(mcp.name);
+ *         tool.description = mcp.description;
+ *         return tool;
+ *     }
+ * }
+ * ```
+ *
+ * @see {@link ConverterBase} for batch conversion methods
+ */
+export class ToolConverterBase extends ConverterBase {
+}
+//# sourceMappingURL=ToolConverter.js.map

package/dist/converters/ToolConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolConverter.js","sourceRoot":"","sources":["../../src/converters/ToolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,iBAAqB,SAAQ,aAAsB;CAAG"}

package/dist/converters/index.d.ts

@@ -0,0 +1,7 @@
+export { ConverterBase } from './ConverterBase.js';
+export { type GroupConverter, GroupConverterBase } from './GroupConverter.js';
+export { type ToolConverter, ToolConverterBase } from './ToolConverter.js';
+export { type PromptConverter, PromptConverterBase } from './PromptConverter.js';
+export { type ResourceConverter, ResourceConverterBase } from './ResourceConverter.js';
+export { type ToolAnnotationsConverter, ToolAnnotationsConverterBase } from './ToolAnnotationsConverter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/converters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/converters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,KAAK,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,KAAK,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,KAAK,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,KAAK,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/converters/index.js

@@ -0,0 +1,7 @@
+export { ConverterBase } from './ConverterBase.js';
+export { GroupConverterBase } from './GroupConverter.js';
+export { ToolConverterBase } from './ToolConverter.js';
+export { PromptConverterBase } from './PromptConverter.js';
+export { ResourceConverterBase } from './ResourceConverter.js';
+export { ToolAnnotationsConverterBase } from './ToolAnnotationsConverter.js';
+//# sourceMappingURL=index.js.map

package/dist/converters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/converters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAuB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAsB,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAwB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAA0B,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAiC,4BAA4B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/core/StandardSchema.d.ts

@@ -0,0 +1,178 @@
+/**
+ * StandardSchema — Universal Schema Abstraction Layer
+ *
+ * Decouples the Vurb validation engine from Zod specifically,
+ * enabling support for any validator that implements the Standard Schema
+ * specification (`@standard-schema/spec`).
+ *
+ * This allows users to choose lighter alternatives:
+ * - **Zod** (~14kb min): Full-featured, most popular
+ * - **Valibot** (~1kb min via tree-shaking): Ultra-lightweight
+ * - **ArkType** (~5kb min): Fastest runtime validation
+ * - **TypeBox** (~4kb min): JSON Schema native
+ *
+ * ## Standard Schema Spec
+ *
+ * Any object with `~standard` property conforming to:
+ * ```typescript
+ * interface StandardSchema {
+ *   '~standard': {
+ *     version: 1;
+ *     vendor: string;
+ *     validate: (value: unknown) => { value: T } | { issues: Issue[] };
+ *   }
+ * }
+ * ```
+ *
+ * @see https://github.com/standard-schema/standard-schema
+ *
+ * @example
+ * ```typescript
+ * import { toStandardValidator } from 'vurb';
+ * import * as v from 'valibot';
+ *
+ * // Valibot schemas work natively via Standard Schema
+ * const schema = v.object({ name: v.string(), age: v.number() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const result = validator.validate({ name: 'Alice', age: 30 });
+ * // { success: true, data: { name: 'Alice', age: 30 } }
+ * ```
+ *
+ * @module
+ */
+/**
+ * Issue reported by a Standard Schema validator.
+ */
+export interface StandardSchemaIssue {
+    readonly message: string;
+    readonly path?: readonly (string | number | symbol)[];
+}
+/**
+ * Standard Schema v1 spec — the universal validator contract.
+ *
+ * Any schema library implementing this interface can be used with
+ * Vurb's validation pipeline.
+ */
+export interface StandardSchemaV1<TInput = unknown, TOutput = TInput> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: TInput) => {
+            readonly value: TOutput;
+        } | {
+            readonly issues: readonly StandardSchemaIssue[];
+        };
+    };
+}
+/**
+ * Infer the output type from a Standard Schema.
+ */
+export type InferStandardOutput<T> = T extends StandardSchemaV1<unknown, infer O> ? O : never;
+/**
+ * Vurb's internal validation result.
+ */
+export type ValidationResult<T> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly issues: readonly StandardSchemaIssue[];
+};
+/**
+ * Universal validator interface used internally by Vurb.
+ *
+ * Wraps any schema library (Zod, Valibot, ArkType, etc.) into
+ * a consistent validation contract.
+ */
+export interface VurbValidator<T = unknown> {
+    /** Run validation and return a result (never throws) */
+    validate(value: unknown): ValidationResult<T>;
+    /** Vendor identifier (e.g. 'zod', 'valibot', 'arktype') */
+    readonly vendor: string;
+    /** Original schema reference (for introspection) */
+    readonly schema: unknown;
+}
+/**
+ * Create a VurbValidator from a Standard Schema v1 compatible schema.
+ *
+ * This is the primary entry point for non-Zod validators. Any schema
+ * library implementing the Standard Schema spec can be used directly.
+ *
+ * @param schema - A Standard Schema v1 compatible schema
+ * @returns A {@link VurbValidator} wrapping the schema
+ *
+ * @example
+ * ```typescript
+ * import * as v from 'valibot'; // ~1kb tree-shaken
+ *
+ * const schema = v.object({ name: v.string() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ *
+ * const err = validator.validate({ name: 42 });
+ * // { success: false, issues: [{ message: 'Expected string', path: ['name'] }] }
+ * ```
+ */
+export declare function toStandardValidator<T>(schema: StandardSchemaV1<unknown, T>): VurbValidator<T>;
+/**
+ * Create a VurbValidator from a raw Zod schema.
+ *
+ * This adapter uses Zod's `.safeParse()` method and maps the result
+ * to the standard VurbValidator interface.
+ *
+ * @param schema - A Zod schema (z.object, z.string, etc.)
+ * @returns A {@link VurbValidator} wrapping the Zod schema
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({ name: z.string() });
+ * const validator = fromZodSchema(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ * ```
+ */
+export declare function fromZodSchema<T>(schema: ZodSchemaLike<T>): VurbValidator<T>;
+/**
+ * Check if a value implements the Standard Schema v1 spec.
+ *
+ * @param value - Any value to check
+ * @returns `true` if the value has a valid `~standard` property
+ */
+export declare function isStandardSchema(value: unknown): value is StandardSchemaV1;
+/**
+ * Auto-detect and create a VurbValidator from any supported schema.
+ *
+ * Detection order:
+ * 1. Standard Schema v1 (Valibot, ArkType, etc.)
+ * 2. Zod-like (has `.safeParse()`)
+ * 3. Throws if unrecognized
+ *
+ * @param schema - Any supported schema
+ * @returns A {@link VurbValidator}
+ * @throws If the schema type is not recognized
+ */
+export declare function autoValidator<T = unknown>(schema: unknown): VurbValidator<T>;
+/** Duck-typed Zod schema interface */
+interface ZodSchemaLike<T = unknown> {
+    safeParse(value: unknown): {
+        success: true;
+        data: unknown;
+    } | {
+        success: false;
+        error: {
+            issues: Array<{
+                message: string;
+                path?: (string | number)[];
+            }>;
+        };
+    };
+    parse?(value: unknown): T;
+}
+export {};
+//# sourceMappingURL=StandardSchema.d.ts.map

package/dist/core/StandardSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardSchema.d.ts","sourceRoot":"","sources":["../../src/core/StandardSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACzD;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM;IAChE,QAAQ,CAAC,WAAW,EAAE;QAClB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAC3B;YAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;SAAE,GAC3B;YAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAA;SAAE,CAAC;KAC7D,CAAC;CACL;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAI9F;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IACxB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACtC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACjC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,GACrC,aAAa,CAAC,CAAC,CAAC,CA2BlB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAyB3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAU1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,CAa5E;AAID,sCAAsC;AACtC,UAAU,aAAa,CAAC,CAAC,GAAG,OAAO;IAC/B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IAC5J,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CAC7B"}

package/dist/core/StandardSchema.js

@@ -0,0 +1,174 @@
+/**
+ * StandardSchema — Universal Schema Abstraction Layer
+ *
+ * Decouples the Vurb validation engine from Zod specifically,
+ * enabling support for any validator that implements the Standard Schema
+ * specification (`@standard-schema/spec`).
+ *
+ * This allows users to choose lighter alternatives:
+ * - **Zod** (~14kb min): Full-featured, most popular
+ * - **Valibot** (~1kb min via tree-shaking): Ultra-lightweight
+ * - **ArkType** (~5kb min): Fastest runtime validation
+ * - **TypeBox** (~4kb min): JSON Schema native
+ *
+ * ## Standard Schema Spec
+ *
+ * Any object with `~standard` property conforming to:
+ * ```typescript
+ * interface StandardSchema {
+ *   '~standard': {
+ *     version: 1;
+ *     vendor: string;
+ *     validate: (value: unknown) => { value: T } | { issues: Issue[] };
+ *   }
+ * }
+ * ```
+ *
+ * @see https://github.com/standard-schema/standard-schema
+ *
+ * @example
+ * ```typescript
+ * import { toStandardValidator } from 'vurb';
+ * import * as v from 'valibot';
+ *
+ * // Valibot schemas work natively via Standard Schema
+ * const schema = v.object({ name: v.string(), age: v.number() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const result = validator.validate({ name: 'Alice', age: 30 });
+ * // { success: true, data: { name: 'Alice', age: 30 } }
+ * ```
+ *
+ * @module
+ */
+// ── Adapters ─────────────────────────────────────────────
+/**
+ * Create a VurbValidator from a Standard Schema v1 compatible schema.
+ *
+ * This is the primary entry point for non-Zod validators. Any schema
+ * library implementing the Standard Schema spec can be used directly.
+ *
+ * @param schema - A Standard Schema v1 compatible schema
+ * @returns A {@link VurbValidator} wrapping the schema
+ *
+ * @example
+ * ```typescript
+ * import * as v from 'valibot'; // ~1kb tree-shaken
+ *
+ * const schema = v.object({ name: v.string() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ *
+ * const err = validator.validate({ name: 42 });
+ * // { success: false, issues: [{ message: 'Expected string', path: ['name'] }] }
+ * ```
+ */
+export function toStandardValidator(schema) {
+    const spec = schema['~standard'];
+    return {
+        validate(value) {
+            const result = spec.validate(value);
+            // Guard: async validators return a Promise, which would silently
+            // produce { success: false, issues: undefined } because
+            // 'value' in Promise is false. Detect and throw early. (Bug #9 fix)
+            if (result != null && typeof result.then === 'function') {
+                throw new Error(`[Vurb] Schema validator "${spec.vendor}" returned a Promise. ` +
+                    'Async validators are not supported — use a synchronous schema. ' +
+                    'See: https://vurb.vinkius.com/docs/standard-schema');
+            }
+            if ('value' in result) {
+                return { success: true, data: result.value };
+            }
+            return { success: false, issues: result.issues };
+        },
+        vendor: spec.vendor,
+        schema,
+    };
+}
+/**
+ * Create a VurbValidator from a raw Zod schema.
+ *
+ * This adapter uses Zod's `.safeParse()` method and maps the result
+ * to the standard VurbValidator interface.
+ *
+ * @param schema - A Zod schema (z.object, z.string, etc.)
+ * @returns A {@link VurbValidator} wrapping the Zod schema
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({ name: z.string() });
+ * const validator = fromZodSchema(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ * ```
+ */
+export function fromZodSchema(schema) {
+    return {
+        validate(value) {
+            const result = schema.safeParse(value);
+            if (result.success) {
+                return { success: true, data: result.data };
+            }
+            // Map Zod errors to StandardSchemaIssue
+            const issues = (result.error?.issues ?? []).map((issue) => {
+                const mapped = { message: issue.message };
+                if (issue.path) {
+                    mapped.path = issue.path;
+                }
+                return mapped;
+            });
+            return { success: false, issues };
+        },
+        vendor: 'zod',
+        schema,
+    };
+}
+/**
+ * Check if a value implements the Standard Schema v1 spec.
+ *
+ * @param value - Any value to check
+ * @returns `true` if the value has a valid `~standard` property
+ */
+export function isStandardSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '~standard' in value &&
+        typeof value['~standard'] === 'object' &&
+        value['~standard'] !== null &&
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        value['~standard'].version === 1);
+}
+/**
+ * Auto-detect and create a VurbValidator from any supported schema.
+ *
+ * Detection order:
+ * 1. Standard Schema v1 (Valibot, ArkType, etc.)
+ * 2. Zod-like (has `.safeParse()`)
+ * 3. Throws if unrecognized
+ *
+ * @param schema - Any supported schema
+ * @returns A {@link VurbValidator}
+ * @throws If the schema type is not recognized
+ */
+export function autoValidator(schema) {
+    if (isStandardSchema(schema)) {
+        return toStandardValidator(schema);
+    }
+    if (isZodLike(schema)) {
+        return fromZodSchema(schema);
+    }
+    throw new Error('Unsupported schema type. Expected a Standard Schema v1 (' +
+        'Valibot, ArkType) or Zod schema. See: https://vurb.vinkius.com/docs/standard-schema');
+}
+/** Duck-type check for Zod-like schemas */
+function isZodLike(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.safeParse === 'function');
+}
+//# sourceMappingURL=StandardSchema.js.map

package/dist/core/StandardSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardSchema.js","sourceRoot":"","sources":["../../src/core/StandardSchema.ts"],"names":[],"mappings":"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"}