@vielzeug/spell 1.1.0

package/README.md

@@ -0,0 +1,68 @@
+# @vielzeug/spell
+
+> Zero-dependency schema validation library with strict-by-default objects, unified sync/async `validate()`, coercion, flexible schema composition, and full TypeScript inference.
+
+[![npm version](https://img.shields.io/npm/v/@vielzeug/spell)](https://www.npmjs.com/package/@vielzeug/spell) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<details>
+<summary>Quick Reference</summary>
+
+**Package:** `@vielzeug/spell` &nbsp;·&nbsp; **Category:** Validation
+
+**Key exports:** `s`, `SpellValidationError`, `setMessages`, `setLogger`, `resetMessages`, `ErrorCode`, `errorsAt`, `descriptorToJsonSchema`
+
+**When to use:** Zero-dependency schema validation library with strict-by-default objects, async refinements, coercion, flexible schema composition, and full TypeScript inference.
+
+**Related:** [@vielzeug/forge](https://vielzeug.dev/forge/) · [@vielzeug/courier](https://vielzeug.dev/courier/) · [@vielzeug/vault](https://vielzeug.dev/vault/)
+
+</details>
+
+`@vielzeug/spell` is part of Vielzeug and ships as a zero-dependency TypeScript package with ESM+CJS output.
+
+## Installation
+
+```sh
+pnpm add @vielzeug/spell
+npm install @vielzeug/spell
+yarn add @vielzeug/spell
+```
+
+## Quick Start
+
+```ts
+import { s, type Infer } from '@vielzeug/spell';
+
+const UserSchema = s.object({
+  id: s.coerce.number().int().positive(),
+  name: s.string().trim().min(1),
+  email: s.string().trim().email(),
+  role: s.union('admin', 'editor', 'viewer').default('viewer'),
+  tags: s.array(s.string()).unique().default([]),
+});
+
+type User = Infer<typeof UserSchema>;
+
+const result = UserSchema.safeParse({ id: '42', name: 'Ada', email: 'ada@example.com' });
+
+if (result.success) {
+  const user: User = result.data;
+  console.log(user.id); // 42
+
+  // Assertion form — narrows type, throws SpellValidationError on failure
+  UserSchema.assert(result.data, 'user');
+} else {
+  const { fieldErrors, formErrors } = result.error.flattenFirst();
+  console.log(fieldErrors, formErrors);
+}
+```
+
+## Documentation
+
+- [Overview](https://vielzeug.dev/spell/)
+- [Usage Guide](https://vielzeug.dev/spell/usage)
+- [API Reference](https://vielzeug.dev/spell/api)
+- [Examples](https://vielzeug.dev/spell/examples)
+
+## License
+
+MIT © [Helmuth Saatkamp](https://github.com/helmuthdu) — part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.

package/dist/_dev.cjs

@@ -0,0 +1,2 @@
+var e=!globalThis.__SPELL_PROD__;function t(t){e&&console.warn(`[@vielzeug/spell] ${t}`)}exports.warn=t;
+//# sourceMappingURL=_dev.cjs.map

package/dist/_dev.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __SPELL_PROD__?: boolean }).__SPELL_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/spell] ${msg}`);\n}\n\n/** @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. */\nexport function devOnly(fn: () => void): void {\n  if (isDev) fn();\n}\n"],"mappings":"AAAA,IAAM,EAAQ,CAAE,WAA4C,eAG5D,SAAgB,EAAK,EAAmB,CAClC,GAAO,QAAQ,KAAK,qBAAqB,GAAK,CACpD"}

package/dist/_dev.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=_dev.d.ts.map

package/dist/_dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.d.ts","sourceRoot":"","sources":["../src/_dev.ts"],"names":[],"mappings":""}

package/dist/_dev.js

@@ -0,0 +1,2 @@
+var e=!globalThis.__SPELL_PROD__;function t(t){e&&console.warn(`[@vielzeug/spell] ${t}`)}export{t as warn};
+//# sourceMappingURL=_dev.js.map

package/dist/_dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __SPELL_PROD__?: boolean }).__SPELL_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/spell] ${msg}`);\n}\n\n/** @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. */\nexport function devOnly(fn: () => void): void {\n  if (isDev) fn();\n}\n"],"mappings":"AAAA,IAAM,EAAQ,CAAE,WAA4C,eAG5D,SAAgB,EAAK,EAAmB,CAClC,GAAO,QAAQ,KAAK,qBAAqB,GAAK,CACpD"}

package/dist/core.cjs

@@ -0,0 +1,2 @@
+const e=require("./types.cjs"),t=require("./errors.cjs"),n=require("./safe-object.cjs"),r=require("./json-schema.cjs"),i=require("./messages.cjs");let a=require("@vielzeug/arsenal");function o(e){if(typeof e!=`object`||!e)return e;if(Array.isArray(e))return e.map(e=>o(e));if(e instanceof Date)return new Date(e.getTime());if(e instanceof Map){let t=new Map;for(let[n,r]of e.entries())t.set(o(n),o(r));return t}if(e instanceof Set)return new Set([...e.values()].map(e=>o(e)));if((0,a.isPlainObject)(e)){let t={};for(let[r,i]of Object.entries(e))n.defineOwnProperty(t,r,o(i));return t}return e}function s(){return{isNullable:!1,isOptional:!1,postprocessors:[],preprocessors:[],validators:[]}}function c(e){return{catch:e.catch,defaultValue:e.defaultValue,description:e.description,isNullable:e.isNullable,isOptional:e.isOptional,postprocessors:[...e.postprocessors],preprocessors:[...e.preprocessors],validators:[...e.validators]}}function l(e){return{messages:e??i._messages()}}function u(t,n){let r=[...n];return typeof t==`string`?r.push({code:e.ErrorCode.custom,message:t,path:[]}):t===!1&&r.length===0&&r.push({code:e.ErrorCode.custom,message:i._messages().check.default(),path:[]}),r.length?r:null}var d=class{state;_annotations={};_typeValidator=null;constructor(e){this.state=s(),this._typeValidator=e??null}parse(n,r){let i=r??l();return this._withCatch(()=>{let r=this._prepareInput(n);if(r.skip)return r.value;let a=this._parse(r.value,i);if(a instanceof Promise)throw new t.SpellValidationError([{code:e.ErrorCode.custom,message:`parse() received an async schema. Use parseAsync() instead.`,path:[]}]);let o=a,s=o.typeOk?this._runValidatorsSync(o.data,i):[],c=[...o.issues,...s];if(c.length)throw new t.SpellValidationError(c);return this._runPostprocessors(o.data)})}safeParse(e,n){try{return{data:this.parse(e,n),success:!0}}catch(e){if(t.SpellValidationError.is(e))return{error:e,success:!1};throw e}}async parseAsync(e,n){let r=n??l();return this._withCatchAsync(async()=>{let n=this._prepareInput(e);if(n.skip)return n.value;let i=await this._parse(n.value,r),a=i.typeOk?await this._runValidatorsAsync(i.data,r):[],o=[...i.issues,...a];if(o.length)throw new t.SpellValidationError(o);return this._runPostprocessors(i.data)})}async safeParseAsync(e,n){try{return{data:await this.parseAsync(e,n),success:!0}}catch(e){if(t.SpellValidationError.is(e))return{error:e,success:!1};throw e}}_parseFullSync(n,r){let i=r??l(),a=this._prepareInput(n);if(a.skip)return{data:a.value,issues:[]};let o=this._parse(a.value,i);if(o instanceof Promise)throw new t.SpellValidationError([{code:e.ErrorCode.custom,message:`Sync parse path received an async schema. Use parseAsync() instead.`,path:[]}]);let s=o,c=s.typeOk?this._runValidatorsSync(s.data,i):[],u=[...s.issues,...c];return u.length>0?this.state.catch?{data:this.state.catch(),issues:[]}:{data:s.data,issues:u}:{data:this._runPostprocessors(s.data),issues:[]}}async _parseFullAsync(e,t){let n=t??l(),r=this._prepareInput(e);if(r.skip)return{data:r.value,issues:[]};let i=await this._parse(r.value,n),a=i.typeOk?await this._runValidatorsAsync(i.data,n):[],o=[...i.issues,...a];return o.length>0?this.state.catch?{data:this.state.catch(),issues:[]}:{data:i.data,issues:o}:{data:this._runPostprocessors(i.data),issues:[]}}validate(e){return this._addConstraint((t,n)=>{let r=[],i=e(t,{addIssue:e=>r.push({...e,path:e.path??[]})});return i instanceof Promise?i.then(e=>u(e,r)):u(i,r)})}refine(n,r){return this._addConstraint((i,a)=>{if(n(i))return null;let o=r?t.resolveMessage(r,{value:i}):a.messages.check.default();return t.fail(e.ErrorCode.custom,o)})}optional(){let e=this._clone();return e.state.isOptional=!0,e}nullable(){let e=this._clone();return e.state.isNullable=!0,e}nullish(){let e=this._clone();return e.state.isOptional=!0,e.state.isNullable=!0,e}required(){let e=this._clone();return e.state.isOptional=!1,e}default(e){let t=this._clone();return t.state.defaultValue=typeof e==`function`?e:()=>o(e),t}catch(e){let t=this._clone();return t.state.catch=typeof e==`function`?e:()=>o(e),t}transform(e){let t=this._clone();return t.state.postprocessors.push(e),t}preprocess(e){let t=this._clone();return t.state.preprocessors.push(e),t}pipe(e){return new f(this,e)}label(e){let t=this._clone();return t.state.description=e,t}toDescriptor(){return this.state.preprocessors.length>0&&i._dev(`toDescriptor(): this schema has preprocessors (e.g. trim(), lowercase(), coerce()). Preprocessors are not serializable and will not appear in the descriptor output.`),this._toDescriptorImpl()}get description(){return this.state.description}get isOptional(){return this.state.isOptional}get isNullable(){return this.state.isNullable}is(e){return this.safeParse(e).success}toJsonSchema(){return r.schemaToJsonSchema(this)}assert(e,n){let r=this._parseFullSync(e);if(r.issues.length!==0)throw new t.SpellValidationError(n?r.issues.map(e=>({...e,message:e.path.length===0?`${n}: ${e.message}`:e.message})):r.issues)}walk(e){return this._walk(e)}equals(e){return e===this?!0:Object.getPrototypeOf(e)!==Object.getPrototypeOf(this)||e.isOptional!==this.isOptional||e.isNullable!==this.isNullable||e.description!==this.description?!1:this._equalsImpl(e)}get kind(){return this._kind}get _kind(){return`any`}_describeBase(){return{...this.state.description===void 0?{}:{description:this.state.description},...this.state.isNullable?{isNullable:!0}:{},...this.state.isOptional?{isOptional:!0}:{}}}_annotationsEqual(e){let t=this._annotations,n=e._annotations,r=Object.keys(t),i=Object.keys(n);return r.length===i.length?r.every(e=>t[e]===n[e]):!1}_addConstraint(e,t){let n=this._clone();return n.state.validators.push(e),t&&(n._annotations=t({...n._annotations})),n}_construct(e){let t=Object.assign(Object.create(Object.getPrototypeOf(this)),this,{state:e});return t._annotations={...this._annotations},t}_clone(){return this._construct(c(this.state))}_copyStateTo(e){return e.state=c(this.state),e}_walk(e){return e.unknown?e.unknown(this):null}_toDescriptorImpl(){return{...this._describeBase(),kind:`any`}}_equalsImpl(e){return!0}_withCatch(e){if(!this.state.catch)return e();try{return e()}catch(e){if(t.SpellValidationError.is(e))return this.state.catch();throw e}}async _withCatchAsync(e){if(!this.state.catch)return e();try{return await e()}catch(e){if(t.SpellValidationError.is(e))return this.state.catch();throw e}}_prepareInput(e){let t=this._runPreprocessors(e),n=t===void 0&&this.state.defaultValue?this.state.defaultValue():t;return this.state.isOptional&&n===void 0||this.state.isNullable&&n===null?{skip:!0,value:n}:{skip:!1,value:n}}_runPreprocessors(e){let t=e;for(let e of this.state.preprocessors)t=e(t);return t}_runPostprocessors(e){let t=e;for(let e of this.state.postprocessors)t=e(t);return t}_runValidatorsSync(n,r){if(this._typeValidator){let i=this._typeValidator(n,r);if(i instanceof Promise)throw new t.SpellValidationError([{code:e.ErrorCode.custom,message:`Type validator returned a Promise. Use parseAsync() for async validation.`,path:[]}]);if(i&&i.length>0)return i}let a=[];for(let e of this.state.validators){let t=e(n,r);if(t instanceof Promise){i._dev(`An async validate() callback was skipped because parse()/safeParse() cannot await it. The value passed this check unvalidated — use parseAsync()/safeParseAsync() instead.`);continue}t&&a.push(...t)}return a}async _runValidatorsAsync(e,t){if(this._typeValidator){let n=await this._typeValidator(e,t);if(n&&n.length>0)return n}let n=[];for(let r of this.state.validators){let i=await r(e,t);i&&n.push(...i)}return n}_parse(e,t){return{data:e,issues:[],typeOk:!0}}},f=class e extends d{from;to;get _kind(){return`pipe`}constructor(e,t){super(),this.from=e,this.to=t}_parse(e,t){let n=this.from._parseFullSync(e,t);if(n instanceof Promise)return n.then(n=>n.issues.length>0?{data:e,issues:n.issues,typeOk:!1}:this.to._parseFullAsync(n.data,t).then(e=>e.issues.length>0?{data:n.data,issues:e.issues,typeOk:!1}:{data:e.data,issues:[],typeOk:!0}));if(n.issues.length>0)return{data:e,issues:n.issues,typeOk:!1};let r=this.to._parseFullSync(n.data,t);return r instanceof Promise?r.then(e=>e.issues.length>0?{data:n.data,issues:e.issues,typeOk:!1}:{data:e.data,issues:[],typeOk:!0}):r.issues.length>0?{data:n.data,issues:r.issues,typeOk:!1}:{data:r.data,issues:[],typeOk:!0}}_walk(e){let t=this.from.walk(e),n=this.to.walk(e);return e.pipe?e.pipe(this,t,n):super._walk(e)}_toDescriptorImpl(){return{...this._describeBase(),from:this.from.toDescriptor(),kind:`pipe`,to:this.to.toDescriptor()}}_equalsImpl(t){return t instanceof e?this.from.equals(t.from)&&this.to.equals(t.to):!1}};exports.ErrorCode=e.ErrorCode,exports.PipeSchema=f,exports.Schema=d,exports.SpellError=t.SpellError,exports.SpellValidationError=t.SpellValidationError,exports._makeCtx=l,exports.errorsAt=t.errorsAt,exports.fail=t.fail,exports.prependIssuePath=t.prependIssuePath,exports.resolveMessage=t.resolveMessage;
+//# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.cjs","names":[],"sources":["../src/core.ts"],"sourcesContent":["import { isPlainObject } from '@vielzeug/arsenal';\n\nimport { fail, resolveMessage, SpellValidationError } from './errors';\nimport { schemaToJsonSchema } from './json-schema';\nimport { _messages, _dev } from './messages';\nimport { defineOwnProperty } from './safe-object';\nimport {\n  type AnySchema,\n  type CheckContext,\n  ErrorCode,\n  type FlatError,\n  type FlatErrorFirst,\n  type FormattedErrors,\n  type Infer,\n  type InferInput,\n  type InferOutput,\n  type Issue,\n  type JsonSchema,\n  type MessageFn,\n  type Messages,\n  type ParseContext,\n  type ParseResult,\n  type SchemaDescriptor,\n  type SchemaWalker,\n  type ValidateFn,\n  type ValidateResult,\n} from './types';\n\nexport {\n  ErrorCode,\n  type AnySchema,\n  type CheckContext,\n  type FlatError,\n  type FlatErrorFirst,\n  type FormattedErrors,\n  type Infer,\n  type InferInput,\n  type InferOutput,\n  type Issue,\n  type JsonSchema,\n  type MessageFn,\n  type Messages,\n  type ParseContext,\n  type ParseResult,\n  type SchemaDescriptor,\n  type SchemaWalker,\n  type ValidateFn,\n  type ValidateResult,\n};\n\nexport { SpellError, SpellValidationError, errorsAt, fail, prependIssuePath, resolveMessage } from './errors';\n\nfunction materializeValue<T>(value: T): T {\n  if (value == null || typeof value !== 'object') return value;\n\n  if (Array.isArray(value)) return value.map((item) => materializeValue(item)) as T;\n\n  if (value instanceof Date) return new Date(value.getTime()) as T;\n\n  if (value instanceof Map) {\n    const out = new Map<unknown, unknown>();\n\n    for (const [key, mapValue] of value.entries()) out.set(materializeValue(key), materializeValue(mapValue));\n\n    return out as T;\n  }\n\n  if (value instanceof Set) return new Set([...value.values()].map((item) => materializeValue(item))) as T;\n\n  if (isPlainObject(value)) {\n    const out: Record<string, unknown> = {};\n\n    for (const [key, entry] of Object.entries(value)) defineOwnProperty(out, key, materializeValue(entry));\n\n    return out as T;\n  }\n\n  return value;\n}\n\n/* -------------------- Schema State -------------------- */\n\ntype Preprocessor = (value: unknown) => unknown;\ntype Postprocessor = (value: unknown) => unknown;\n\nexport interface SchemaState<Output = unknown> {\n  catch?: () => Output;\n  defaultValue?: () => Output;\n  description?: string;\n  isNullable: boolean;\n  isOptional: boolean;\n  postprocessors: Postprocessor[];\n  preprocessors: Preprocessor[];\n  validators: ValidateFn[];\n}\n\nfunction defaultState<Output>(): SchemaState<Output> {\n  return { isNullable: false, isOptional: false, postprocessors: [], preprocessors: [], validators: [] };\n}\n\nfunction cloneState<Output>(state: SchemaState<Output>): SchemaState<Output> {\n  return {\n    catch: state.catch,\n    defaultValue: state.defaultValue,\n    description: state.description,\n    isNullable: state.isNullable,\n    isOptional: state.isOptional,\n    postprocessors: [...state.postprocessors],\n    preprocessors: [...state.preprocessors],\n    validators: [...state.validators],\n  };\n}\n\n/* -------------------- Internal parse-value return type -------------------- */\n\n/** @internal */\nexport type ParseValue = { data: unknown; issues: Issue[]; typeOk: boolean };\n\ntype MaybePromise<T> = T | Promise<T>;\n\n/* -------------------- ParseContext default -------------------- */\n\n/** @internal */\nexport function _makeCtx(messages?: Messages): ParseContext {\n  return { messages: messages ?? _messages() };\n}\n\n/* -------------------- ValidateResult normalizer -------------------- */\n\nfunction normalizeValidateResult(result: ValidateResult, ctxIssues: Issue[]): Issue[] | null {\n  const issues = [...ctxIssues];\n\n  if (typeof result === 'string') {\n    issues.push({ code: ErrorCode.custom, message: result, path: [] });\n  } else if (result === false && issues.length === 0) {\n    issues.push({ code: ErrorCode.custom, message: _messages().check.default(), path: [] });\n  }\n\n  return issues.length ? issues : null;\n}\n\n/* -------------------- Base Schema -------------------- */\n\nexport class Schema<Output = unknown, Input = Output> {\n  protected state: SchemaState<Output>;\n\n  protected _annotations: Record<string, unknown> = {};\n\n  private _typeValidator: ValidateFn | null = null;\n\n  constructor(typeValidator?: ValidateFn) {\n    this.state = defaultState<Output>();\n    this._typeValidator = typeValidator ?? null;\n  }\n\n  /* -------------------- Parse -------------------- */\n\n  parse(value: unknown, ctx?: ParseContext): Output {\n    const c = ctx ?? _makeCtx();\n\n    return this._withCatch(() => {\n      const prepared = this._prepareInput(value);\n\n      if (prepared.skip) return prepared.value as Output;\n\n      const coreOrPromise = this._parse(prepared.value, c);\n\n      if (coreOrPromise instanceof Promise) {\n        throw new SpellValidationError([\n          {\n            code: ErrorCode.custom,\n            message: 'parse() received an async schema. Use parseAsync() instead.',\n            path: [],\n          },\n        ]);\n      }\n\n      const core = coreOrPromise;\n      const validationIssues = core.typeOk ? this._runValidatorsSync(core.data, c) : [];\n      const allIssues = [...core.issues, ...validationIssues];\n\n      if (allIssues.length) throw new SpellValidationError(allIssues);\n\n      return this._runPostprocessors(core.data) as Output;\n    });\n  }\n\n  safeParse(value: unknown, ctx?: ParseContext): ParseResult<Output> {\n    try {\n      return { data: this.parse(value, ctx), success: true };\n    } catch (error) {\n      if (SpellValidationError.is(error)) return { error, success: false };\n\n      throw error;\n    }\n  }\n\n  async parseAsync(value: unknown, ctx?: ParseContext): Promise<Output> {\n    const c = ctx ?? _makeCtx();\n\n    return this._withCatchAsync(async () => {\n      const prepared = this._prepareInput(value);\n\n      if (prepared.skip) return prepared.value as Output;\n\n      const core = await this._parse(prepared.value, c);\n      const validationIssues = core.typeOk ? await this._runValidatorsAsync(core.data, c) : [];\n      const allIssues = [...core.issues, ...validationIssues];\n\n      if (allIssues.length) throw new SpellValidationError(allIssues);\n\n      return this._runPostprocessors(core.data) as Output;\n    });\n  }\n\n  async safeParseAsync(value: unknown, ctx?: ParseContext): Promise<ParseResult<Output>> {\n    try {\n      return { data: await this.parseAsync(value, ctx), success: true };\n    } catch (error) {\n      if (SpellValidationError.is(error)) return { error, success: false };\n\n      throw error;\n    }\n  }\n\n  /**\n   * Internal full parse without throwing. Returns { data, issues }.\n   * Used by composite schemas (array, object, union, etc.) to avoid\n   * the try/catch + object allocation overhead of safeParse().\n   * @internal\n   */\n  _parseFullSync(value: unknown, ctx?: ParseContext): { data: unknown; issues: Issue[] } {\n    const c = ctx ?? _makeCtx();\n    const prepared = this._prepareInput(value);\n\n    if (prepared.skip) return { data: prepared.value, issues: [] };\n\n    const coreOrPromise = this._parse(prepared.value, c);\n\n    if (coreOrPromise instanceof Promise) {\n      throw new SpellValidationError([\n        {\n          code: ErrorCode.custom,\n          message: 'Sync parse path received an async schema. Use parseAsync() instead.',\n          path: [],\n        },\n      ]);\n    }\n\n    const core = coreOrPromise;\n    const validationIssues = core.typeOk ? this._runValidatorsSync(core.data, c) : [];\n    const allIssues = [...core.issues, ...validationIssues];\n\n    if (allIssues.length > 0) {\n      if (this.state.catch) return { data: this.state.catch(), issues: [] };\n\n      return { data: core.data, issues: allIssues };\n    }\n\n    return { data: this._runPostprocessors(core.data), issues: [] };\n  }\n\n  /**\n   * Async version of _parseFullSync.\n   * @internal\n   */\n  async _parseFullAsync(value: unknown, ctx?: ParseContext): Promise<{ data: unknown; issues: Issue[] }> {\n    const c = ctx ?? _makeCtx();\n    const prepared = this._prepareInput(value);\n\n    if (prepared.skip) return { data: prepared.value, issues: [] };\n\n    const core = await this._parse(prepared.value, c);\n    const validationIssues = core.typeOk ? await this._runValidatorsAsync(core.data, c) : [];\n    const allIssues = [...core.issues, ...validationIssues];\n\n    if (allIssues.length > 0) {\n      if (this.state.catch) return { data: this.state.catch(), issues: [] };\n\n      return { data: core.data, issues: allIssues };\n    }\n\n    return { data: this._runPostprocessors(core.data), issues: [] };\n  }\n\n  /* -------------------- Validators -------------------- */\n\n  /**\n   * Add a custom validation rule. The callback receives the typed value and an optional\n   * `{ addIssue }` context for reporting multiple issues in one pass.\n   *\n   * **Return values:**\n   * - `string` — fail with that message\n   * - `false` — fail silently (use `addIssue` to report)\n   * - `true` / `null` / `void` — pass\n   *\n   * The `|| 'message'` shorthand works naturally:\n   * ```ts\n   * s.string().validate(v => v.length > 0 || 'Cannot be empty')\n   * ```\n   *\n   * For async validation, return a Promise:\n   * ```ts\n   * s.string().validate(async v => (await db.exists(v)) ? 'Already taken' : null)\n   * ```\n   */\n  validate(\n    fn:\n      | ((value: Output, ctx: CheckContext) => ValidateResult)\n      | ((value: Output, ctx: CheckContext) => Promise<ValidateResult>),\n  ): this {\n    const validator: ValidateFn = (value, _ctx) => {\n      const ctxIssues: Issue[] = [];\n      const checkCtx: CheckContext = {\n        addIssue: (issue) => ctxIssues.push({ ...issue, path: issue.path ?? [] } as Issue),\n      };\n      const result = fn(value as Output, checkCtx);\n\n      if (result instanceof Promise) {\n        return result.then((r) => normalizeValidateResult(r, ctxIssues));\n      }\n\n      return normalizeValidateResult(result, ctxIssues);\n    };\n\n    return this._addConstraint(validator);\n  }\n\n  refine(predicate: (value: Output) => boolean, message?: MessageFn<{ value: Output }>): this {\n    return this._addConstraint((value, ctx) => {\n      if ((predicate as (v: unknown) => boolean)(value)) return null;\n\n      const msg = message ? resolveMessage(message, { value: value as Output }) : ctx!.messages.check.default();\n\n      return fail(ErrorCode.custom, msg);\n    });\n  }\n\n  /* -------------------- Nullability / Optionality -------------------- */\n\n  optional(): Schema<Output | undefined, Input | undefined> {\n    const cloned = this._clone() as unknown as Schema<Output | undefined, Input | undefined>;\n\n    cloned.state.isOptional = true;\n\n    return cloned;\n  }\n\n  nullable(): Schema<Output | null, Input | null> {\n    const cloned = this._clone() as unknown as Schema<Output | null, Input | null>;\n\n    cloned.state.isNullable = true;\n\n    return cloned;\n  }\n\n  nullish(): Schema<Output | null | undefined, Input | null | undefined> {\n    const cloned = this._clone() as unknown as Schema<Output | null | undefined, Input | null | undefined>;\n\n    cloned.state.isOptional = true;\n    cloned.state.isNullable = true;\n\n    return cloned;\n  }\n\n  required(): Schema<Exclude<Output, undefined>, Exclude<Input, undefined>> {\n    const cloned = this._clone() as unknown as Schema<Exclude<Output, undefined>, Exclude<Input, undefined>>;\n\n    cloned.state.isOptional = false;\n\n    return cloned;\n  }\n\n  /* -------------------- Transforms -------------------- */\n\n  default(defaultValue: Output | (() => Output)): this {\n    const cloned = this._clone();\n\n    cloned.state.defaultValue =\n      typeof defaultValue === 'function' ? (defaultValue as () => Output) : () => materializeValue(defaultValue);\n\n    return cloned;\n  }\n\n  catch(fallback: Output | (() => Output)): this {\n    const cloned = this._clone();\n\n    cloned.state.catch = typeof fallback === 'function' ? (fallback as () => Output) : () => materializeValue(fallback);\n\n    return cloned;\n  }\n\n  transform<NewOutput>(fn: (value: Output) => NewOutput): Schema<NewOutput, Input> {\n    const next = this._clone() as unknown as Schema<NewOutput, Input>;\n\n    next.state.postprocessors.push(fn as (v: unknown) => unknown);\n\n    return next;\n  }\n\n  preprocess(fn: (value: unknown) => unknown): this {\n    const cloned = this._clone();\n\n    cloned.state.preprocessors.push(fn);\n\n    return cloned;\n  }\n\n  pipe<B>(next: Schema<B, NoInfer<Output>>): Schema<B, Input> {\n    return new PipeSchema<B, Input>(this, next);\n  }\n\n  /* -------------------- Introspection -------------------- */\n\n  label(description: string): this {\n    const cloned = this._clone();\n\n    cloned.state.description = description;\n\n    return cloned;\n  }\n\n  toDescriptor(): SchemaDescriptor {\n    if (this.state.preprocessors.length > 0) {\n      _dev(\n        'toDescriptor(): this schema has preprocessors (e.g. trim(), lowercase(), coerce()). ' +\n          'Preprocessors are not serializable and will not appear in the descriptor output.',\n      );\n    }\n\n    return this._toDescriptorImpl();\n  }\n\n  get description(): string | undefined {\n    return this.state.description;\n  }\n\n  get isOptional(): boolean {\n    return this.state.isOptional;\n  }\n\n  get isNullable(): boolean {\n    return this.state.isNullable;\n  }\n\n  is(value: unknown): value is Output {\n    return this.safeParse(value).success;\n  }\n\n  toJsonSchema(): JsonSchema {\n    return schemaToJsonSchema(this);\n  }\n\n  assert(value: unknown, label?: string): asserts value is Output {\n    const result = this._parseFullSync(value);\n\n    if (result.issues.length === 0) return;\n\n    const issues = label\n      ? result.issues.map((issue) => ({\n          ...issue,\n          message: issue.path.length === 0 ? `${label}: ${issue.message}` : issue.message,\n        }))\n      : result.issues;\n\n    throw new SpellValidationError(issues);\n  }\n\n  walk<R>(visitor: SchemaWalker<R>): R | null {\n    return this._walk(visitor);\n  }\n\n  equals(other: AnySchema): boolean {\n    if (other === this) return true;\n\n    if (Object.getPrototypeOf(other) !== Object.getPrototypeOf(this)) return false;\n\n    if (other.isOptional !== this.isOptional) return false;\n\n    if (other.isNullable !== this.isNullable) return false;\n\n    if (other.description !== this.description) return false;\n\n    return this._equalsImpl(other);\n  }\n\n  get kind(): string {\n    return this._kind;\n  }\n\n  protected get _kind(): string {\n    return 'any';\n  }\n\n  /* -------------------- Protected helpers -------------------- */\n\n  protected _describeBase(): { description?: string; isNullable?: true; isOptional?: true } {\n    return {\n      ...(this.state.description !== undefined ? { description: this.state.description } : {}),\n      ...(this.state.isNullable ? { isNullable: true as const } : {}),\n      ...(this.state.isOptional ? { isOptional: true as const } : {}),\n    };\n  }\n\n  protected _annotationsEqual(other: AnySchema): boolean {\n    const a = this._annotations;\n    const b = (other as Schema)._annotations;\n    const keysA = Object.keys(a);\n    const keysB = Object.keys(b);\n\n    if (keysA.length !== keysB.length) return false;\n\n    return keysA.every((k) => a[k] === b[k]);\n  }\n\n  protected _addConstraint(\n    validator: ValidateFn,\n    mergeAnnotations?: (current: Record<string, unknown>) => Record<string, unknown>,\n  ): this {\n    const next = this._clone();\n\n    next.state.validators.push(validator);\n\n    if (mergeAnnotations) {\n      next._annotations = mergeAnnotations({ ...next._annotations });\n    }\n\n    return next;\n  }\n\n  protected _construct(state: SchemaState<any>): this {\n    const next = Object.assign(Object.create(Object.getPrototypeOf(this)), this, { state }) as this;\n\n    next._annotations = { ...this._annotations };\n\n    return next;\n  }\n\n  protected _clone(): this {\n    return this._construct(cloneState(this.state));\n  }\n\n  protected _copyStateTo<T extends Schema<any, any>>(target: T): T {\n    target.state = cloneState(this.state);\n\n    return target;\n  }\n\n  protected _walk<R>(visitor: SchemaWalker<R>): R | null {\n    if (visitor.unknown) return visitor.unknown(this);\n\n    return null;\n  }\n\n  protected _toDescriptorImpl(): SchemaDescriptor {\n    return { ...this._describeBase(), kind: 'any' };\n  }\n\n  protected _equalsImpl(_other: AnySchema): boolean {\n    return true;\n  }\n\n  /* -------------------- Private -------------------- */\n\n  private _withCatch<T>(fn: () => T): T {\n    if (!this.state.catch) return fn();\n\n    try {\n      return fn();\n    } catch (error) {\n      if (SpellValidationError.is(error)) return this.state.catch() as unknown as T;\n\n      throw error;\n    }\n  }\n\n  protected async _withCatchAsync<T>(fn: () => Promise<T>): Promise<T> {\n    if (!this.state.catch) return fn();\n\n    try {\n      return await fn();\n    } catch (error) {\n      if (SpellValidationError.is(error)) return this.state.catch() as unknown as T;\n\n      throw error;\n    }\n  }\n\n  protected _prepareInput(value: unknown): { skip: true; value: null | undefined } | { skip: false; value: unknown } {\n    const processed = this._runPreprocessors(value);\n    const withDefault = processed === undefined && this.state.defaultValue ? this.state.defaultValue() : processed;\n\n    if ((this.state.isOptional && withDefault === undefined) || (this.state.isNullable && withDefault === null)) {\n      return { skip: true, value: withDefault };\n    }\n\n    return { skip: false, value: withDefault };\n  }\n\n  protected _runPreprocessors(value: unknown): unknown {\n    let current = value;\n\n    for (const preprocess of this.state.preprocessors) current = preprocess(current);\n\n    return current;\n  }\n\n  protected _runPostprocessors(value: unknown): unknown {\n    let current = value;\n\n    for (const postprocess of this.state.postprocessors) current = postprocess(current);\n\n    return current;\n  }\n\n  private _runValidatorsSync(value: unknown, ctx: ParseContext): Issue[] {\n    if (this._typeValidator) {\n      const typeResult = this._typeValidator(value, ctx);\n\n      if (typeResult instanceof Promise) {\n        throw new SpellValidationError([\n          {\n            code: ErrorCode.custom,\n            message: 'Type validator returned a Promise. Use parseAsync() for async validation.',\n            path: [],\n          },\n        ]);\n      }\n\n      if (typeResult && typeResult.length > 0) return typeResult;\n    }\n\n    const issues: Issue[] = [];\n\n    for (const validate of this.state.validators) {\n      const result = validate(value, ctx);\n\n      if (result instanceof Promise) {\n        _dev(\n          'An async validate() callback was skipped because parse()/safeParse() cannot await it. ' +\n            'The value passed this check unvalidated — use parseAsync()/safeParseAsync() instead.',\n        );\n        continue;\n      }\n\n      if (result) issues.push(...result);\n    }\n\n    return issues;\n  }\n\n  protected async _runValidatorsAsync(value: unknown, ctx: ParseContext): Promise<Issue[]> {\n    if (this._typeValidator) {\n      const typeResult = await this._typeValidator(value, ctx);\n\n      if (typeResult && typeResult.length > 0) return typeResult;\n    }\n\n    const issues: Issue[] = [];\n\n    for (const validate of this.state.validators) {\n      const result = await validate(value, ctx);\n\n      if (result) issues.push(...result);\n    }\n\n    return issues;\n  }\n\n  protected _parse(_value: unknown, _ctx: ParseContext): MaybePromise<ParseValue> {\n    return { data: _value, issues: [], typeOk: true };\n  }\n}\n\n/* -------------------- PipeSchema -------------------- */\n\nexport class PipeSchema<Output, Input = unknown> extends Schema<Output, Input> {\n  readonly from: Schema<any, Input>;\n  readonly to: Schema<Output, any>;\n\n  protected override get _kind(): string {\n    return 'pipe';\n  }\n\n  constructor(from: Schema<any, Input>, to: Schema<Output, any>) {\n    super();\n    this.from = from;\n    this.to = to;\n  }\n\n  protected override _parse(value: unknown, ctx: ParseContext): MaybePromise<ParseValue> {\n    const r1OrPromise = this.from._parseFullSync(value, ctx);\n\n    if (r1OrPromise instanceof Promise) {\n      return (r1OrPromise as Promise<{ data: unknown; issues: Issue[] }>).then((r1) => {\n        if (r1.issues.length > 0) return { data: value, issues: r1.issues, typeOk: false };\n\n        return this.to\n          ._parseFullAsync(r1.data, ctx)\n          .then((r2) =>\n            r2.issues.length > 0\n              ? { data: r1.data, issues: r2.issues, typeOk: false }\n              : { data: r2.data, issues: [], typeOk: true },\n          );\n      });\n    }\n\n    if (r1OrPromise.issues.length > 0) return { data: value, issues: r1OrPromise.issues, typeOk: false };\n\n    const r2OrPromise = this.to._parseFullSync(r1OrPromise.data, ctx);\n\n    if (r2OrPromise instanceof Promise) {\n      return r2OrPromise.then((r2) =>\n        r2.issues.length > 0\n          ? { data: r1OrPromise.data, issues: r2.issues, typeOk: false }\n          : { data: r2.data, issues: [], typeOk: true },\n      );\n    }\n\n    return r2OrPromise.issues.length > 0\n      ? { data: r1OrPromise.data, issues: r2OrPromise.issues, typeOk: false }\n      : { data: r2OrPromise.data, issues: [], typeOk: true };\n  }\n\n  protected override _walk<R>(visitor: SchemaWalker<R>): R | null {\n    const fromR = this.from.walk(visitor);\n    const toR = this.to.walk(visitor);\n\n    if (visitor.pipe) return visitor.pipe(this, fromR, toR);\n\n    return super._walk(visitor);\n  }\n\n  protected override _toDescriptorImpl(): SchemaDescriptor {\n    return {\n      ...this._describeBase(),\n      from: this.from.toDescriptor(),\n      kind: 'pipe',\n      to: this.to.toDescriptor(),\n    };\n  }\n\n  protected override _equalsImpl(other: AnySchema): boolean {\n    if (!(other instanceof PipeSchema)) return false;\n\n    return this.from.equals(other.from) && this.to.equals(other.to);\n  }\n}\n"],"mappings":"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"}

package/dist/core.d.ts

@@ -0,0 +1,108 @@
+import { type AnySchema, type CheckContext, ErrorCode, type FlatError, type FlatErrorFirst, type FormattedErrors, type Infer, type InferInput, type InferOutput, type Issue, type JsonSchema, type MessageFn, type Messages, type ParseContext, type ParseResult, type SchemaDescriptor, type SchemaWalker, type ValidateFn, type ValidateResult } from './types';
+export { ErrorCode, type AnySchema, type CheckContext, type FlatError, type FlatErrorFirst, type FormattedErrors, type Infer, type InferInput, type InferOutput, type Issue, type JsonSchema, type MessageFn, type Messages, type ParseContext, type ParseResult, type SchemaDescriptor, type SchemaWalker, type ValidateFn, type ValidateResult, };
+export { SpellError, SpellValidationError, errorsAt, fail, prependIssuePath, resolveMessage } from './errors';
+type Preprocessor = (value: unknown) => unknown;
+type Postprocessor = (value: unknown) => unknown;
+export interface SchemaState<Output = unknown> {
+    catch?: () => Output;
+    defaultValue?: () => Output;
+    description?: string;
+    isNullable: boolean;
+    isOptional: boolean;
+    postprocessors: Postprocessor[];
+    preprocessors: Preprocessor[];
+    validators: ValidateFn[];
+}
+type MaybePromise<T> = T | Promise<T>;
+export declare class Schema<Output = unknown, Input = Output> {
+    protected state: SchemaState<Output>;
+    protected _annotations: Record<string, unknown>;
+    private _typeValidator;
+    constructor(typeValidator?: ValidateFn);
+    parse(value: unknown, ctx?: ParseContext): Output;
+    safeParse(value: unknown, ctx?: ParseContext): ParseResult<Output>;
+    parseAsync(value: unknown, ctx?: ParseContext): Promise<Output>;
+    safeParseAsync(value: unknown, ctx?: ParseContext): Promise<ParseResult<Output>>;
+    /**
+     * Add a custom validation rule. The callback receives the typed value and an optional
+     * `{ addIssue }` context for reporting multiple issues in one pass.
+     *
+     * **Return values:**
+     * - `string` — fail with that message
+     * - `false` — fail silently (use `addIssue` to report)
+     * - `true` / `null` / `void` — pass
+     *
+     * The `|| 'message'` shorthand works naturally:
+     * ```ts
+     * s.string().validate(v => v.length > 0 || 'Cannot be empty')
+     * ```
+     *
+     * For async validation, return a Promise:
+     * ```ts
+     * s.string().validate(async v => (await db.exists(v)) ? 'Already taken' : null)
+     * ```
+     */
+    validate(fn: ((value: Output, ctx: CheckContext) => ValidateResult) | ((value: Output, ctx: CheckContext) => Promise<ValidateResult>)): this;
+    refine(predicate: (value: Output) => boolean, message?: MessageFn<{
+        value: Output;
+    }>): this;
+    optional(): Schema<Output | undefined, Input | undefined>;
+    nullable(): Schema<Output | null, Input | null>;
+    nullish(): Schema<Output | null | undefined, Input | null | undefined>;
+    required(): Schema<Exclude<Output, undefined>, Exclude<Input, undefined>>;
+    default(defaultValue: Output | (() => Output)): this;
+    catch(fallback: Output | (() => Output)): this;
+    transform<NewOutput>(fn: (value: Output) => NewOutput): Schema<NewOutput, Input>;
+    preprocess(fn: (value: unknown) => unknown): this;
+    pipe<B>(next: Schema<B, NoInfer<Output>>): Schema<B, Input>;
+    label(description: string): this;
+    toDescriptor(): SchemaDescriptor;
+    get description(): string | undefined;
+    get isOptional(): boolean;
+    get isNullable(): boolean;
+    is(value: unknown): value is Output;
+    toJsonSchema(): JsonSchema;
+    assert(value: unknown, label?: string): asserts value is Output;
+    walk<R>(visitor: SchemaWalker<R>): R | null;
+    equals(other: AnySchema): boolean;
+    get kind(): string;
+    protected get _kind(): string;
+    protected _describeBase(): {
+        description?: string;
+        isNullable?: true;
+        isOptional?: true;
+    };
+    protected _annotationsEqual(other: AnySchema): boolean;
+    protected _addConstraint(validator: ValidateFn, mergeAnnotations?: (current: Record<string, unknown>) => Record<string, unknown>): this;
+    protected _construct(state: SchemaState<any>): this;
+    protected _clone(): this;
+    protected _copyStateTo<T extends Schema<any, any>>(target: T): T;
+    protected _walk<R>(visitor: SchemaWalker<R>): R | null;
+    protected _toDescriptorImpl(): SchemaDescriptor;
+    protected _equalsImpl(_other: AnySchema): boolean;
+    private _withCatch;
+    protected _withCatchAsync<T>(fn: () => Promise<T>): Promise<T>;
+    protected _prepareInput(value: unknown): {
+        skip: true;
+        value: null | undefined;
+    } | {
+        skip: false;
+        value: unknown;
+    };
+    protected _runPreprocessors(value: unknown): unknown;
+    protected _runPostprocessors(value: unknown): unknown;
+    private _runValidatorsSync;
+    protected _runValidatorsAsync(value: unknown, ctx: ParseContext): Promise<Issue[]>;
+    protected _parse(_value: unknown, _ctx: ParseContext): MaybePromise<ParseValue>;
+}
+export declare class PipeSchema<Output, Input = unknown> extends Schema<Output, Input> {
+    readonly from: Schema<any, Input>;
+    readonly to: Schema<Output, any>;
+    protected get _kind(): string;
+    constructor(from: Schema<any, Input>, to: Schema<Output, any>);
+    protected _parse(value: unknown, ctx: ParseContext): MaybePromise<ParseValue>;
+    protected _walk<R>(visitor: SchemaWalker<R>): R | null;
+    protected _toDescriptorImpl(): SchemaDescriptor;
+    protected _equalsImpl(other: AnySchema): boolean;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

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

package/dist/core.js

@@ -0,0 +1,2 @@
+import{ErrorCode as e}from"./types.js";import{SpellError as t,SpellValidationError as n,errorsAt as r,fail as i,prependIssuePath as a,resolveMessage as o}from"./errors.js";import{defineOwnProperty as s}from"./safe-object.js";import{schemaToJsonSchema as c}from"./json-schema.js";import{_dev as l,_messages as u}from"./messages.js";import{isPlainObject as d}from"@vielzeug/arsenal";function f(e){if(typeof e!=`object`||!e)return e;if(Array.isArray(e))return e.map(e=>f(e));if(e instanceof Date)return new Date(e.getTime());if(e instanceof Map){let t=new Map;for(let[n,r]of e.entries())t.set(f(n),f(r));return t}if(e instanceof Set)return new Set([...e.values()].map(e=>f(e)));if(d(e)){let t={};for(let[n,r]of Object.entries(e))s(t,n,f(r));return t}return e}function p(){return{isNullable:!1,isOptional:!1,postprocessors:[],preprocessors:[],validators:[]}}function m(e){return{catch:e.catch,defaultValue:e.defaultValue,description:e.description,isNullable:e.isNullable,isOptional:e.isOptional,postprocessors:[...e.postprocessors],preprocessors:[...e.preprocessors],validators:[...e.validators]}}function h(e){return{messages:e??u()}}function g(t,n){let r=[...n];return typeof t==`string`?r.push({code:e.custom,message:t,path:[]}):t===!1&&r.length===0&&r.push({code:e.custom,message:u().check.default(),path:[]}),r.length?r:null}var _=class{state;_annotations={};_typeValidator=null;constructor(e){this.state=p(),this._typeValidator=e??null}parse(t,r){let i=r??h();return this._withCatch(()=>{let r=this._prepareInput(t);if(r.skip)return r.value;let a=this._parse(r.value,i);if(a instanceof Promise)throw new n([{code:e.custom,message:`parse() received an async schema. Use parseAsync() instead.`,path:[]}]);let o=a,s=o.typeOk?this._runValidatorsSync(o.data,i):[],c=[...o.issues,...s];if(c.length)throw new n(c);return this._runPostprocessors(o.data)})}safeParse(e,t){try{return{data:this.parse(e,t),success:!0}}catch(e){if(n.is(e))return{error:e,success:!1};throw e}}async parseAsync(e,t){let r=t??h();return this._withCatchAsync(async()=>{let t=this._prepareInput(e);if(t.skip)return t.value;let i=await this._parse(t.value,r),a=i.typeOk?await this._runValidatorsAsync(i.data,r):[],o=[...i.issues,...a];if(o.length)throw new n(o);return this._runPostprocessors(i.data)})}async safeParseAsync(e,t){try{return{data:await this.parseAsync(e,t),success:!0}}catch(e){if(n.is(e))return{error:e,success:!1};throw e}}_parseFullSync(t,r){let i=r??h(),a=this._prepareInput(t);if(a.skip)return{data:a.value,issues:[]};let o=this._parse(a.value,i);if(o instanceof Promise)throw new n([{code:e.custom,message:`Sync parse path received an async schema. Use parseAsync() instead.`,path:[]}]);let s=o,c=s.typeOk?this._runValidatorsSync(s.data,i):[],l=[...s.issues,...c];return l.length>0?this.state.catch?{data:this.state.catch(),issues:[]}:{data:s.data,issues:l}:{data:this._runPostprocessors(s.data),issues:[]}}async _parseFullAsync(e,t){let n=t??h(),r=this._prepareInput(e);if(r.skip)return{data:r.value,issues:[]};let i=await this._parse(r.value,n),a=i.typeOk?await this._runValidatorsAsync(i.data,n):[],o=[...i.issues,...a];return o.length>0?this.state.catch?{data:this.state.catch(),issues:[]}:{data:i.data,issues:o}:{data:this._runPostprocessors(i.data),issues:[]}}validate(e){return this._addConstraint((t,n)=>{let r=[],i=e(t,{addIssue:e=>r.push({...e,path:e.path??[]})});return i instanceof Promise?i.then(e=>g(e,r)):g(i,r)})}refine(t,n){return this._addConstraint((r,a)=>{if(t(r))return null;let s=n?o(n,{value:r}):a.messages.check.default();return i(e.custom,s)})}optional(){let e=this._clone();return e.state.isOptional=!0,e}nullable(){let e=this._clone();return e.state.isNullable=!0,e}nullish(){let e=this._clone();return e.state.isOptional=!0,e.state.isNullable=!0,e}required(){let e=this._clone();return e.state.isOptional=!1,e}default(e){let t=this._clone();return t.state.defaultValue=typeof e==`function`?e:()=>f(e),t}catch(e){let t=this._clone();return t.state.catch=typeof e==`function`?e:()=>f(e),t}transform(e){let t=this._clone();return t.state.postprocessors.push(e),t}preprocess(e){let t=this._clone();return t.state.preprocessors.push(e),t}pipe(e){return new v(this,e)}label(e){let t=this._clone();return t.state.description=e,t}toDescriptor(){return this.state.preprocessors.length>0&&l(`toDescriptor(): this schema has preprocessors (e.g. trim(), lowercase(), coerce()). Preprocessors are not serializable and will not appear in the descriptor output.`),this._toDescriptorImpl()}get description(){return this.state.description}get isOptional(){return this.state.isOptional}get isNullable(){return this.state.isNullable}is(e){return this.safeParse(e).success}toJsonSchema(){return c(this)}assert(e,t){let r=this._parseFullSync(e);if(r.issues.length!==0)throw new n(t?r.issues.map(e=>({...e,message:e.path.length===0?`${t}: ${e.message}`:e.message})):r.issues)}walk(e){return this._walk(e)}equals(e){return e===this?!0:Object.getPrototypeOf(e)!==Object.getPrototypeOf(this)||e.isOptional!==this.isOptional||e.isNullable!==this.isNullable||e.description!==this.description?!1:this._equalsImpl(e)}get kind(){return this._kind}get _kind(){return`any`}_describeBase(){return{...this.state.description===void 0?{}:{description:this.state.description},...this.state.isNullable?{isNullable:!0}:{},...this.state.isOptional?{isOptional:!0}:{}}}_annotationsEqual(e){let t=this._annotations,n=e._annotations,r=Object.keys(t),i=Object.keys(n);return r.length===i.length?r.every(e=>t[e]===n[e]):!1}_addConstraint(e,t){let n=this._clone();return n.state.validators.push(e),t&&(n._annotations=t({...n._annotations})),n}_construct(e){let t=Object.assign(Object.create(Object.getPrototypeOf(this)),this,{state:e});return t._annotations={...this._annotations},t}_clone(){return this._construct(m(this.state))}_copyStateTo(e){return e.state=m(this.state),e}_walk(e){return e.unknown?e.unknown(this):null}_toDescriptorImpl(){return{...this._describeBase(),kind:`any`}}_equalsImpl(e){return!0}_withCatch(e){if(!this.state.catch)return e();try{return e()}catch(e){if(n.is(e))return this.state.catch();throw e}}async _withCatchAsync(e){if(!this.state.catch)return e();try{return await e()}catch(e){if(n.is(e))return this.state.catch();throw e}}_prepareInput(e){let t=this._runPreprocessors(e),n=t===void 0&&this.state.defaultValue?this.state.defaultValue():t;return this.state.isOptional&&n===void 0||this.state.isNullable&&n===null?{skip:!0,value:n}:{skip:!1,value:n}}_runPreprocessors(e){let t=e;for(let e of this.state.preprocessors)t=e(t);return t}_runPostprocessors(e){let t=e;for(let e of this.state.postprocessors)t=e(t);return t}_runValidatorsSync(t,r){if(this._typeValidator){let i=this._typeValidator(t,r);if(i instanceof Promise)throw new n([{code:e.custom,message:`Type validator returned a Promise. Use parseAsync() for async validation.`,path:[]}]);if(i&&i.length>0)return i}let i=[];for(let e of this.state.validators){let n=e(t,r);if(n instanceof Promise){l(`An async validate() callback was skipped because parse()/safeParse() cannot await it. The value passed this check unvalidated — use parseAsync()/safeParseAsync() instead.`);continue}n&&i.push(...n)}return i}async _runValidatorsAsync(e,t){if(this._typeValidator){let n=await this._typeValidator(e,t);if(n&&n.length>0)return n}let n=[];for(let r of this.state.validators){let i=await r(e,t);i&&n.push(...i)}return n}_parse(e,t){return{data:e,issues:[],typeOk:!0}}},v=class e extends _{from;to;get _kind(){return`pipe`}constructor(e,t){super(),this.from=e,this.to=t}_parse(e,t){let n=this.from._parseFullSync(e,t);if(n instanceof Promise)return n.then(n=>n.issues.length>0?{data:e,issues:n.issues,typeOk:!1}:this.to._parseFullAsync(n.data,t).then(e=>e.issues.length>0?{data:n.data,issues:e.issues,typeOk:!1}:{data:e.data,issues:[],typeOk:!0}));if(n.issues.length>0)return{data:e,issues:n.issues,typeOk:!1};let r=this.to._parseFullSync(n.data,t);return r instanceof Promise?r.then(e=>e.issues.length>0?{data:n.data,issues:e.issues,typeOk:!1}:{data:e.data,issues:[],typeOk:!0}):r.issues.length>0?{data:n.data,issues:r.issues,typeOk:!1}:{data:r.data,issues:[],typeOk:!0}}_walk(e){let t=this.from.walk(e),n=this.to.walk(e);return e.pipe?e.pipe(this,t,n):super._walk(e)}_toDescriptorImpl(){return{...this._describeBase(),from:this.from.toDescriptor(),kind:`pipe`,to:this.to.toDescriptor()}}_equalsImpl(t){return t instanceof e?this.from.equals(t.from)&&this.to.equals(t.to):!1}};export{e as ErrorCode,v as PipeSchema,_ as Schema,t as SpellError,n as SpellValidationError,h as _makeCtx,r as errorsAt,i as fail,a as prependIssuePath,o as resolveMessage};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["import { isPlainObject } from '@vielzeug/arsenal';\n\nimport { fail, resolveMessage, SpellValidationError } from './errors';\nimport { schemaToJsonSchema } from './json-schema';\nimport { _messages, _dev } from './messages';\nimport { defineOwnProperty } from './safe-object';\nimport {\n  type AnySchema,\n  type CheckContext,\n  ErrorCode,\n  type FlatError,\n  type FlatErrorFirst,\n  type FormattedErrors,\n  type Infer,\n  type InferInput,\n  type InferOutput,\n  type Issue,\n  type JsonSchema,\n  type MessageFn,\n  type Messages,\n  type ParseContext,\n  type ParseResult,\n  type SchemaDescriptor,\n  type SchemaWalker,\n  type ValidateFn,\n  type ValidateResult,\n} from './types';\n\nexport {\n  ErrorCode,\n  type AnySchema,\n  type CheckContext,\n  type FlatError,\n  type FlatErrorFirst,\n  type FormattedErrors,\n  type Infer,\n  type InferInput,\n  type InferOutput,\n  type Issue,\n  type JsonSchema,\n  type MessageFn,\n  type Messages,\n  type ParseContext,\n  type ParseResult,\n  type SchemaDescriptor,\n  type SchemaWalker,\n  type ValidateFn,\n  type ValidateResult,\n};\n\nexport { SpellError, SpellValidationError, errorsAt, fail, prependIssuePath, resolveMessage } from './errors';\n\nfunction materializeValue<T>(value: T): T {\n  if (value == null || typeof value !== 'object') return value;\n\n  if (Array.isArray(value)) return value.map((item) => materializeValue(item)) as T;\n\n  if (value instanceof Date) return new Date(value.getTime()) as T;\n\n  if (value instanceof Map) {\n    const out = new Map<unknown, unknown>();\n\n    for (const [key, mapValue] of value.entries()) out.set(materializeValue(key), materializeValue(mapValue));\n\n    return out as T;\n  }\n\n  if (value instanceof Set) return new Set([...value.values()].map((item) => materializeValue(item))) as T;\n\n  if (isPlainObject(value)) {\n    const out: Record<string, unknown> = {};\n\n    for (const [key, entry] of Object.entries(value)) defineOwnProperty(out, key, materializeValue(entry));\n\n    return out as T;\n  }\n\n  return value;\n}\n\n/* -------------------- Schema State -------------------- */\n\ntype Preprocessor = (value: unknown) => unknown;\ntype Postprocessor = (value: unknown) => unknown;\n\nexport interface SchemaState<Output = unknown> {\n  catch?: () => Output;\n  defaultValue?: () => Output;\n  description?: string;\n  isNullable: boolean;\n  isOptional: boolean;\n  postprocessors: Postprocessor[];\n  preprocessors: Preprocessor[];\n  validators: ValidateFn[];\n}\n\nfunction defaultState<Output>(): SchemaState<Output> {\n  return { isNullable: false, isOptional: false, postprocessors: [], preprocessors: [], validators: [] };\n}\n\nfunction cloneState<Output>(state: SchemaState<Output>): SchemaState<Output> {\n  return {\n    catch: state.catch,\n    defaultValue: state.defaultValue,\n    description: state.description,\n    isNullable: state.isNullable,\n    isOptional: state.isOptional,\n    postprocessors: [...state.postprocessors],\n    preprocessors: [...state.preprocessors],\n    validators: [...state.validators],\n  };\n}\n\n/* -------------------- Internal parse-value return type -------------------- */\n\n/** @internal */\nexport type ParseValue = { data: unknown; issues: Issue[]; typeOk: boolean };\n\ntype MaybePromise<T> = T | Promise<T>;\n\n/* -------------------- ParseContext default -------------------- */\n\n/** @internal */\nexport function _makeCtx(messages?: Messages): ParseContext {\n  return { messages: messages ?? _messages() };\n}\n\n/* -------------------- ValidateResult normalizer -------------------- */\n\nfunction normalizeValidateResult(result: ValidateResult, ctxIssues: Issue[]): Issue[] | null {\n  const issues = [...ctxIssues];\n\n  if (typeof result === 'string') {\n    issues.push({ code: ErrorCode.custom, message: result, path: [] });\n  } else if (result === false && issues.length === 0) {\n    issues.push({ code: ErrorCode.custom, message: _messages().check.default(), path: [] });\n  }\n\n  return issues.length ? issues : null;\n}\n\n/* -------------------- Base Schema -------------------- */\n\nexport class Schema<Output = unknown, Input = Output> {\n  protected state: SchemaState<Output>;\n\n  protected _annotations: Record<string, unknown> = {};\n\n  private _typeValidator: ValidateFn | null = null;\n\n  constructor(typeValidator?: ValidateFn) {\n    this.state = defaultState<Output>();\n    this._typeValidator = typeValidator ?? null;\n  }\n\n  /* -------------------- Parse -------------------- */\n\n  parse(value: unknown, ctx?: ParseContext): Output {\n    const c = ctx ?? _makeCtx();\n\n    return this._withCatch(() => {\n      const prepared = this._prepareInput(value);\n\n      if (prepared.skip) return prepared.value as Output;\n\n      const coreOrPromise = this._parse(prepared.value, c);\n\n      if (coreOrPromise instanceof Promise) {\n        throw new SpellValidationError([\n          {\n            code: ErrorCode.custom,\n            message: 'parse() received an async schema. Use parseAsync() instead.',\n            path: [],\n          },\n        ]);\n      }\n\n      const core = coreOrPromise;\n      const validationIssues = core.typeOk ? this._runValidatorsSync(core.data, c) : [];\n      const allIssues = [...core.issues, ...validationIssues];\n\n      if (allIssues.length) throw new SpellValidationError(allIssues);\n\n      return this._runPostprocessors(core.data) as Output;\n    });\n  }\n\n  safeParse(value: unknown, ctx?: ParseContext): ParseResult<Output> {\n    try {\n      return { data: this.parse(value, ctx), success: true };\n    } catch (error) {\n      if (SpellValidationError.is(error)) return { error, success: false };\n\n      throw error;\n    }\n  }\n\n  async parseAsync(value: unknown, ctx?: ParseContext): Promise<Output> {\n    const c = ctx ?? _makeCtx();\n\n    return this._withCatchAsync(async () => {\n      const prepared = this._prepareInput(value);\n\n      if (prepared.skip) return prepared.value as Output;\n\n      const core = await this._parse(prepared.value, c);\n      const validationIssues = core.typeOk ? await this._runValidatorsAsync(core.data, c) : [];\n      const allIssues = [...core.issues, ...validationIssues];\n\n      if (allIssues.length) throw new SpellValidationError(allIssues);\n\n      return this._runPostprocessors(core.data) as Output;\n    });\n  }\n\n  async safeParseAsync(value: unknown, ctx?: ParseContext): Promise<ParseResult<Output>> {\n    try {\n      return { data: await this.parseAsync(value, ctx), success: true };\n    } catch (error) {\n      if (SpellValidationError.is(error)) return { error, success: false };\n\n      throw error;\n    }\n  }\n\n  /**\n   * Internal full parse without throwing. Returns { data, issues }.\n   * Used by composite schemas (array, object, union, etc.) to avoid\n   * the try/catch + object allocation overhead of safeParse().\n   * @internal\n   */\n  _parseFullSync(value: unknown, ctx?: ParseContext): { data: unknown; issues: Issue[] } {\n    const c = ctx ?? _makeCtx();\n    const prepared = this._prepareInput(value);\n\n    if (prepared.skip) return { data: prepared.value, issues: [] };\n\n    const coreOrPromise = this._parse(prepared.value, c);\n\n    if (coreOrPromise instanceof Promise) {\n      throw new SpellValidationError([\n        {\n          code: ErrorCode.custom,\n          message: 'Sync parse path received an async schema. Use parseAsync() instead.',\n          path: [],\n        },\n      ]);\n    }\n\n    const core = coreOrPromise;\n    const validationIssues = core.typeOk ? this._runValidatorsSync(core.data, c) : [];\n    const allIssues = [...core.issues, ...validationIssues];\n\n    if (allIssues.length > 0) {\n      if (this.state.catch) return { data: this.state.catch(), issues: [] };\n\n      return { data: core.data, issues: allIssues };\n    }\n\n    return { data: this._runPostprocessors(core.data), issues: [] };\n  }\n\n  /**\n   * Async version of _parseFullSync.\n   * @internal\n   */\n  async _parseFullAsync(value: unknown, ctx?: ParseContext): Promise<{ data: unknown; issues: Issue[] }> {\n    const c = ctx ?? _makeCtx();\n    const prepared = this._prepareInput(value);\n\n    if (prepared.skip) return { data: prepared.value, issues: [] };\n\n    const core = await this._parse(prepared.value, c);\n    const validationIssues = core.typeOk ? await this._runValidatorsAsync(core.data, c) : [];\n    const allIssues = [...core.issues, ...validationIssues];\n\n    if (allIssues.length > 0) {\n      if (this.state.catch) return { data: this.state.catch(), issues: [] };\n\n      return { data: core.data, issues: allIssues };\n    }\n\n    return { data: this._runPostprocessors(core.data), issues: [] };\n  }\n\n  /* -------------------- Validators -------------------- */\n\n  /**\n   * Add a custom validation rule. The callback receives the typed value and an optional\n   * `{ addIssue }` context for reporting multiple issues in one pass.\n   *\n   * **Return values:**\n   * - `string` — fail with that message\n   * - `false` — fail silently (use `addIssue` to report)\n   * - `true` / `null` / `void` — pass\n   *\n   * The `|| 'message'` shorthand works naturally:\n   * ```ts\n   * s.string().validate(v => v.length > 0 || 'Cannot be empty')\n   * ```\n   *\n   * For async validation, return a Promise:\n   * ```ts\n   * s.string().validate(async v => (await db.exists(v)) ? 'Already taken' : null)\n   * ```\n   */\n  validate(\n    fn:\n      | ((value: Output, ctx: CheckContext) => ValidateResult)\n      | ((value: Output, ctx: CheckContext) => Promise<ValidateResult>),\n  ): this {\n    const validator: ValidateFn = (value, _ctx) => {\n      const ctxIssues: Issue[] = [];\n      const checkCtx: CheckContext = {\n        addIssue: (issue) => ctxIssues.push({ ...issue, path: issue.path ?? [] } as Issue),\n      };\n      const result = fn(value as Output, checkCtx);\n\n      if (result instanceof Promise) {\n        return result.then((r) => normalizeValidateResult(r, ctxIssues));\n      }\n\n      return normalizeValidateResult(result, ctxIssues);\n    };\n\n    return this._addConstraint(validator);\n  }\n\n  refine(predicate: (value: Output) => boolean, message?: MessageFn<{ value: Output }>): this {\n    return this._addConstraint((value, ctx) => {\n      if ((predicate as (v: unknown) => boolean)(value)) return null;\n\n      const msg = message ? resolveMessage(message, { value: value as Output }) : ctx!.messages.check.default();\n\n      return fail(ErrorCode.custom, msg);\n    });\n  }\n\n  /* -------------------- Nullability / Optionality -------------------- */\n\n  optional(): Schema<Output | undefined, Input | undefined> {\n    const cloned = this._clone() as unknown as Schema<Output | undefined, Input | undefined>;\n\n    cloned.state.isOptional = true;\n\n    return cloned;\n  }\n\n  nullable(): Schema<Output | null, Input | null> {\n    const cloned = this._clone() as unknown as Schema<Output | null, Input | null>;\n\n    cloned.state.isNullable = true;\n\n    return cloned;\n  }\n\n  nullish(): Schema<Output | null | undefined, Input | null | undefined> {\n    const cloned = this._clone() as unknown as Schema<Output | null | undefined, Input | null | undefined>;\n\n    cloned.state.isOptional = true;\n    cloned.state.isNullable = true;\n\n    return cloned;\n  }\n\n  required(): Schema<Exclude<Output, undefined>, Exclude<Input, undefined>> {\n    const cloned = this._clone() as unknown as Schema<Exclude<Output, undefined>, Exclude<Input, undefined>>;\n\n    cloned.state.isOptional = false;\n\n    return cloned;\n  }\n\n  /* -------------------- Transforms -------------------- */\n\n  default(defaultValue: Output | (() => Output)): this {\n    const cloned = this._clone();\n\n    cloned.state.defaultValue =\n      typeof defaultValue === 'function' ? (defaultValue as () => Output) : () => materializeValue(defaultValue);\n\n    return cloned;\n  }\n\n  catch(fallback: Output | (() => Output)): this {\n    const cloned = this._clone();\n\n    cloned.state.catch = typeof fallback === 'function' ? (fallback as () => Output) : () => materializeValue(fallback);\n\n    return cloned;\n  }\n\n  transform<NewOutput>(fn: (value: Output) => NewOutput): Schema<NewOutput, Input> {\n    const next = this._clone() as unknown as Schema<NewOutput, Input>;\n\n    next.state.postprocessors.push(fn as (v: unknown) => unknown);\n\n    return next;\n  }\n\n  preprocess(fn: (value: unknown) => unknown): this {\n    const cloned = this._clone();\n\n    cloned.state.preprocessors.push(fn);\n\n    return cloned;\n  }\n\n  pipe<B>(next: Schema<B, NoInfer<Output>>): Schema<B, Input> {\n    return new PipeSchema<B, Input>(this, next);\n  }\n\n  /* -------------------- Introspection -------------------- */\n\n  label(description: string): this {\n    const cloned = this._clone();\n\n    cloned.state.description = description;\n\n    return cloned;\n  }\n\n  toDescriptor(): SchemaDescriptor {\n    if (this.state.preprocessors.length > 0) {\n      _dev(\n        'toDescriptor(): this schema has preprocessors (e.g. trim(), lowercase(), coerce()). ' +\n          'Preprocessors are not serializable and will not appear in the descriptor output.',\n      );\n    }\n\n    return this._toDescriptorImpl();\n  }\n\n  get description(): string | undefined {\n    return this.state.description;\n  }\n\n  get isOptional(): boolean {\n    return this.state.isOptional;\n  }\n\n  get isNullable(): boolean {\n    return this.state.isNullable;\n  }\n\n  is(value: unknown): value is Output {\n    return this.safeParse(value).success;\n  }\n\n  toJsonSchema(): JsonSchema {\n    return schemaToJsonSchema(this);\n  }\n\n  assert(value: unknown, label?: string): asserts value is Output {\n    const result = this._parseFullSync(value);\n\n    if (result.issues.length === 0) return;\n\n    const issues = label\n      ? result.issues.map((issue) => ({\n          ...issue,\n          message: issue.path.length === 0 ? `${label}: ${issue.message}` : issue.message,\n        }))\n      : result.issues;\n\n    throw new SpellValidationError(issues);\n  }\n\n  walk<R>(visitor: SchemaWalker<R>): R | null {\n    return this._walk(visitor);\n  }\n\n  equals(other: AnySchema): boolean {\n    if (other === this) return true;\n\n    if (Object.getPrototypeOf(other) !== Object.getPrototypeOf(this)) return false;\n\n    if (other.isOptional !== this.isOptional) return false;\n\n    if (other.isNullable !== this.isNullable) return false;\n\n    if (other.description !== this.description) return false;\n\n    return this._equalsImpl(other);\n  }\n\n  get kind(): string {\n    return this._kind;\n  }\n\n  protected get _kind(): string {\n    return 'any';\n  }\n\n  /* -------------------- Protected helpers -------------------- */\n\n  protected _describeBase(): { description?: string; isNullable?: true; isOptional?: true } {\n    return {\n      ...(this.state.description !== undefined ? { description: this.state.description } : {}),\n      ...(this.state.isNullable ? { isNullable: true as const } : {}),\n      ...(this.state.isOptional ? { isOptional: true as const } : {}),\n    };\n  }\n\n  protected _annotationsEqual(other: AnySchema): boolean {\n    const a = this._annotations;\n    const b = (other as Schema)._annotations;\n    const keysA = Object.keys(a);\n    const keysB = Object.keys(b);\n\n    if (keysA.length !== keysB.length) return false;\n\n    return keysA.every((k) => a[k] === b[k]);\n  }\n\n  protected _addConstraint(\n    validator: ValidateFn,\n    mergeAnnotations?: (current: Record<string, unknown>) => Record<string, unknown>,\n  ): this {\n    const next = this._clone();\n\n    next.state.validators.push(validator);\n\n    if (mergeAnnotations) {\n      next._annotations = mergeAnnotations({ ...next._annotations });\n    }\n\n    return next;\n  }\n\n  protected _construct(state: SchemaState<any>): this {\n    const next = Object.assign(Object.create(Object.getPrototypeOf(this)), this, { state }) as this;\n\n    next._annotations = { ...this._annotations };\n\n    return next;\n  }\n\n  protected _clone(): this {\n    return this._construct(cloneState(this.state));\n  }\n\n  protected _copyStateTo<T extends Schema<any, any>>(target: T): T {\n    target.state = cloneState(this.state);\n\n    return target;\n  }\n\n  protected _walk<R>(visitor: SchemaWalker<R>): R | null {\n    if (visitor.unknown) return visitor.unknown(this);\n\n    return null;\n  }\n\n  protected _toDescriptorImpl(): SchemaDescriptor {\n    return { ...this._describeBase(), kind: 'any' };\n  }\n\n  protected _equalsImpl(_other: AnySchema): boolean {\n    return true;\n  }\n\n  /* -------------------- Private -------------------- */\n\n  private _withCatch<T>(fn: () => T): T {\n    if (!this.state.catch) return fn();\n\n    try {\n      return fn();\n    } catch (error) {\n      if (SpellValidationError.is(error)) return this.state.catch() as unknown as T;\n\n      throw error;\n    }\n  }\n\n  protected async _withCatchAsync<T>(fn: () => Promise<T>): Promise<T> {\n    if (!this.state.catch) return fn();\n\n    try {\n      return await fn();\n    } catch (error) {\n      if (SpellValidationError.is(error)) return this.state.catch() as unknown as T;\n\n      throw error;\n    }\n  }\n\n  protected _prepareInput(value: unknown): { skip: true; value: null | undefined } | { skip: false; value: unknown } {\n    const processed = this._runPreprocessors(value);\n    const withDefault = processed === undefined && this.state.defaultValue ? this.state.defaultValue() : processed;\n\n    if ((this.state.isOptional && withDefault === undefined) || (this.state.isNullable && withDefault === null)) {\n      return { skip: true, value: withDefault };\n    }\n\n    return { skip: false, value: withDefault };\n  }\n\n  protected _runPreprocessors(value: unknown): unknown {\n    let current = value;\n\n    for (const preprocess of this.state.preprocessors) current = preprocess(current);\n\n    return current;\n  }\n\n  protected _runPostprocessors(value: unknown): unknown {\n    let current = value;\n\n    for (const postprocess of this.state.postprocessors) current = postprocess(current);\n\n    return current;\n  }\n\n  private _runValidatorsSync(value: unknown, ctx: ParseContext): Issue[] {\n    if (this._typeValidator) {\n      const typeResult = this._typeValidator(value, ctx);\n\n      if (typeResult instanceof Promise) {\n        throw new SpellValidationError([\n          {\n            code: ErrorCode.custom,\n            message: 'Type validator returned a Promise. Use parseAsync() for async validation.',\n            path: [],\n          },\n        ]);\n      }\n\n      if (typeResult && typeResult.length > 0) return typeResult;\n    }\n\n    const issues: Issue[] = [];\n\n    for (const validate of this.state.validators) {\n      const result = validate(value, ctx);\n\n      if (result instanceof Promise) {\n        _dev(\n          'An async validate() callback was skipped because parse()/safeParse() cannot await it. ' +\n            'The value passed this check unvalidated — use parseAsync()/safeParseAsync() instead.',\n        );\n        continue;\n      }\n\n      if (result) issues.push(...result);\n    }\n\n    return issues;\n  }\n\n  protected async _runValidatorsAsync(value: unknown, ctx: ParseContext): Promise<Issue[]> {\n    if (this._typeValidator) {\n      const typeResult = await this._typeValidator(value, ctx);\n\n      if (typeResult && typeResult.length > 0) return typeResult;\n    }\n\n    const issues: Issue[] = [];\n\n    for (const validate of this.state.validators) {\n      const result = await validate(value, ctx);\n\n      if (result) issues.push(...result);\n    }\n\n    return issues;\n  }\n\n  protected _parse(_value: unknown, _ctx: ParseContext): MaybePromise<ParseValue> {\n    return { data: _value, issues: [], typeOk: true };\n  }\n}\n\n/* -------------------- PipeSchema -------------------- */\n\nexport class PipeSchema<Output, Input = unknown> extends Schema<Output, Input> {\n  readonly from: Schema<any, Input>;\n  readonly to: Schema<Output, any>;\n\n  protected override get _kind(): string {\n    return 'pipe';\n  }\n\n  constructor(from: Schema<any, Input>, to: Schema<Output, any>) {\n    super();\n    this.from = from;\n    this.to = to;\n  }\n\n  protected override _parse(value: unknown, ctx: ParseContext): MaybePromise<ParseValue> {\n    const r1OrPromise = this.from._parseFullSync(value, ctx);\n\n    if (r1OrPromise instanceof Promise) {\n      return (r1OrPromise as Promise<{ data: unknown; issues: Issue[] }>).then((r1) => {\n        if (r1.issues.length > 0) return { data: value, issues: r1.issues, typeOk: false };\n\n        return this.to\n          ._parseFullAsync(r1.data, ctx)\n          .then((r2) =>\n            r2.issues.length > 0\n              ? { data: r1.data, issues: r2.issues, typeOk: false }\n              : { data: r2.data, issues: [], typeOk: true },\n          );\n      });\n    }\n\n    if (r1OrPromise.issues.length > 0) return { data: value, issues: r1OrPromise.issues, typeOk: false };\n\n    const r2OrPromise = this.to._parseFullSync(r1OrPromise.data, ctx);\n\n    if (r2OrPromise instanceof Promise) {\n      return r2OrPromise.then((r2) =>\n        r2.issues.length > 0\n          ? { data: r1OrPromise.data, issues: r2.issues, typeOk: false }\n          : { data: r2.data, issues: [], typeOk: true },\n      );\n    }\n\n    return r2OrPromise.issues.length > 0\n      ? { data: r1OrPromise.data, issues: r2OrPromise.issues, typeOk: false }\n      : { data: r2OrPromise.data, issues: [], typeOk: true };\n  }\n\n  protected override _walk<R>(visitor: SchemaWalker<R>): R | null {\n    const fromR = this.from.walk(visitor);\n    const toR = this.to.walk(visitor);\n\n    if (visitor.pipe) return visitor.pipe(this, fromR, toR);\n\n    return super._walk(visitor);\n  }\n\n  protected override _toDescriptorImpl(): SchemaDescriptor {\n    return {\n      ...this._describeBase(),\n      from: this.from.toDescriptor(),\n      kind: 'pipe',\n      to: this.to.toDescriptor(),\n    };\n  }\n\n  protected override _equalsImpl(other: AnySchema): boolean {\n    if (!(other instanceof PipeSchema)) return false;\n\n    return this.from.equals(other.from) && this.to.equals(other.to);\n  }\n}\n"],"mappings":"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"}

package/dist/errors.cjs

@@ -0,0 +1,3 @@
+const e=require("./types.cjs");function t(e,t,n){return[{code:e,message:t,params:n,path:[]}]}function n(e,t){return typeof e==`function`?e(t):e}function r(e,t){return e.map(e=>({...e,path:[t,...e.path]}))}function i(e,...t){let n=e;for(let e of t){if(Array.isArray(n))return[];n=n[String(e)===`_errors`?`_errors_`:String(e)]??{_errors:[]}}return Array.isArray(n)?n:n._errors}var a=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}};function o(e){return e.map(({code:e,message:t,path:n})=>`${n.length?n.join(`.`):`value`}: ${t} [${e}]`).join(`
+`)}function s(){let e=Object.create(null);return e._errors=[],e}var c=class t extends a{issues;constructor(e,t){super(o(e),{cause:t}),this.issues=e}static is(e){return e instanceof t}bestMatch(){let t=this.issues.find(t=>t.code===e.ErrorCode.invalid_union);if(!t)return null;let n=t.params.errors;if(n.length===0)return null;let r=n.map(e=>({issues:e,score:e.reduce((e,t)=>Math.max(e,t.path.length),0)*1e3-e.length}));return r.sort((e,t)=>t.score-e.score),r[0].issues}flatten(){let e=[],t=[],n=new Map;for(let r of this.issues)if(r.path.length===0)t.push(r.message);else{let t=JSON.stringify(r.path),i=n.get(t);i===void 0?(n.set(t,e.length),e.push({messages:[r.message],path:[...r.path]})):e[i].messages.push(r.message)}return{fieldErrors:e,formErrors:t}}flattenFirst(){let{fieldErrors:e,formErrors:t}=this.flatten();return{fieldErrors:e.map(e=>({message:e.messages[0],path:e.path})),formErrors:t}}format(){let e=s();for(let t of this.issues){if(t.path.length===0){e._errors.push(t.message);continue}let n=e;for(let e of t.path){let t=String(e),r=t===`_errors`?`_errors_`:t;Object.hasOwn(n,r)||(n[r]=s()),n=n[r]}n._errors.push(t.message)}return e}};exports.SpellError=a,exports.SpellValidationError=c,exports.errorsAt=i,exports.fail=t,exports.prependIssuePath=r,exports.resolveMessage=n;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import { ErrorCode, type Issue, type MessageFn } from './types';\n\n/* -------------------- Helpers -------------------- */\n\ntype IssueParams<C extends string> = Extract<Issue, { code: C }> extends { params: infer P } ? P : undefined;\n\n/**\n * Creates a single-error failure array. Use in validator functions instead of building the array manually.\n * Typed overloads ensure params match the given error code.\n */\nexport function fail<C extends ErrorCode>(code: C, message: string, params: IssueParams<C>): Issue[];\nexport function fail(code: string, message: string, params?: Record<string, unknown>): Issue[];\nexport function fail(code: string, message: string, params?: Record<string, unknown>): Issue[] {\n  return [{ code, message, params, path: [] } as Issue];\n}\n\n/** @internal */\nexport function resolveMessage<Ctx extends Record<string, unknown>>(msg: MessageFn<Ctx>, ctx: Ctx): string {\n  return typeof msg === 'function' ? msg(ctx) : msg;\n}\n\nexport function prependIssuePath(issues: Issue[], prefix: string | number): Issue[] {\n  return issues.map((issue) => ({ ...issue, path: [prefix, ...issue.path] }));\n}\n\n/* -------------------- FormattedErrors -------------------- */\n\nexport type FormattedErrors = {\n  _errors: string[];\n  [key: string]: FormattedErrors | string[];\n};\n\nexport function errorsAt(formatted: FormattedErrors, ...path: (string | number)[]): string[] {\n  let node: FormattedErrors | string[] = formatted;\n\n  for (const key of path) {\n    if (Array.isArray(node)) return [];\n\n    const safeKey = String(key) === '_errors' ? '_errors_' : String(key);\n\n    node = (node as FormattedErrors)[safeKey] ?? { _errors: [] };\n  }\n\n  return Array.isArray(node) ? node : (node as FormattedErrors)._errors;\n}\n\n/* -------------------- SpellError -------------------- */\n\n/** Base class for all spell errors. Use `instanceof SpellError` to catch any spell-originated error. */\nexport class SpellError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is SpellError {\n    return err instanceof SpellError;\n  }\n}\n\n/* -------------------- SpellValidationError -------------------- */\n\nfunction formatIssues(issues: Issue[]): string {\n  return issues\n    .map(({ code, message, path }) => {\n      const pathStr = path.length ? path.join('.') : 'value';\n\n      return `${pathStr}: ${message} [${code}]`;\n    })\n    .join('\\n');\n}\n\nexport type FlatError = { messages: string[]; path: (string | number)[] };\nexport type FlatErrorFirst = { message: string; path: (string | number)[] };\n\nfunction createFormattedErrors(): FormattedErrors {\n  const node = Object.create(null) as FormattedErrors;\n\n  node._errors = [];\n\n  return node;\n}\n\nexport class SpellValidationError extends SpellError {\n  readonly issues: Issue[];\n\n  constructor(issues: Issue[], cause?: unknown) {\n    super(formatIssues(issues), { cause });\n    this.issues = issues;\n  }\n\n  static is(err: unknown): err is SpellValidationError {\n    return err instanceof SpellValidationError;\n  }\n\n  /**\n   * Returns the union branch errors from the most-specific failing branch.\n   * Surfaces the branch with the fewest issues at the deepest path — the one\n   * that \"came closest\" to matching.\n   */\n  bestMatch(): Issue[] | null {\n    const unionIssue = this.issues.find(\n      (i): i is Extract<Issue, { code: 'invalid_union' }> => i.code === ErrorCode.invalid_union,\n    );\n\n    if (!unionIssue) return null;\n\n    const branches = unionIssue.params.errors;\n\n    if (branches.length === 0) return null;\n\n    const scored = branches.map((branchIssues) => {\n      const maxDepth = branchIssues.reduce((d, i) => Math.max(d, i.path.length), 0);\n\n      return { issues: branchIssues, score: maxDepth * 1000 - branchIssues.length };\n    });\n\n    scored.sort((a, b) => b.score - a.score);\n\n    return scored[0]!.issues;\n  }\n\n  flatten(): { fieldErrors: FlatError[]; formErrors: string[] } {\n    const fieldErrors: FlatError[] = [];\n    const formErrors: string[] = [];\n    const pathMap = new Map<string, number>();\n\n    for (const issue of this.issues) {\n      if (issue.path.length === 0) {\n        formErrors.push(issue.message);\n      } else {\n        const key = JSON.stringify(issue.path);\n        const existing = pathMap.get(key);\n\n        if (existing !== undefined) {\n          fieldErrors[existing]!.messages.push(issue.message);\n        } else {\n          pathMap.set(key, fieldErrors.length);\n          fieldErrors.push({ messages: [issue.message], path: [...issue.path] });\n        }\n      }\n    }\n\n    return { fieldErrors, formErrors };\n  }\n\n  flattenFirst(): { fieldErrors: FlatErrorFirst[]; formErrors: string[] } {\n    const { fieldErrors, formErrors } = this.flatten();\n\n    return {\n      fieldErrors: fieldErrors.map((fe) => ({ message: fe.messages[0]!, path: fe.path })),\n      formErrors,\n    };\n  }\n\n  format(): FormattedErrors {\n    const root = createFormattedErrors();\n\n    for (const issue of this.issues) {\n      if (issue.path.length === 0) {\n        root._errors.push(issue.message);\n        continue;\n      }\n\n      let node = root;\n\n      for (const segment of issue.path) {\n        const key = String(segment);\n\n        // '_errors' is the reserved internal field; treat it as a sibling key\n        // with a safe prefix to avoid collisions with the FormattedErrors shape.\n        const safeKey = key === '_errors' ? '_errors_' : key;\n\n        if (!Object.hasOwn(node, safeKey)) {\n          node[safeKey] = createFormattedErrors();\n        }\n\n        node = node[safeKey] as FormattedErrors;\n      }\n\n      node._errors.push(issue.message);\n    }\n\n    return root;\n  }\n}\n"],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,53 @@
+import { ErrorCode, type Issue } from './types';
+type IssueParams<C extends string> = Extract<Issue, {
+    code: C;
+}> extends {
+    params: infer P;
+} ? P : undefined;
+/**
+ * Creates a single-error failure array. Use in validator functions instead of building the array manually.
+ * Typed overloads ensure params match the given error code.
+ */
+export declare function fail<C extends ErrorCode>(code: C, message: string, params: IssueParams<C>): Issue[];
+export declare function fail(code: string, message: string, params?: Record<string, unknown>): Issue[];
+export declare function prependIssuePath(issues: Issue[], prefix: string | number): Issue[];
+export type FormattedErrors = {
+    _errors: string[];
+    [key: string]: FormattedErrors | string[];
+};
+export declare function errorsAt(formatted: FormattedErrors, ...path: (string | number)[]): string[];
+/** Base class for all spell errors. Use `instanceof SpellError` to catch any spell-originated error. */
+export declare class SpellError extends Error {
+    constructor(message: string, opts?: ErrorOptions);
+    static is(err: unknown): err is SpellError;
+}
+export type FlatError = {
+    messages: string[];
+    path: (string | number)[];
+};
+export type FlatErrorFirst = {
+    message: string;
+    path: (string | number)[];
+};
+export declare class SpellValidationError extends SpellError {
+    readonly issues: Issue[];
+    constructor(issues: Issue[], cause?: unknown);
+    static is(err: unknown): err is SpellValidationError;
+    /**
+     * Returns the union branch errors from the most-specific failing branch.
+     * Surfaces the branch with the fewest issues at the deepest path — the one
+     * that "came closest" to matching.
+     */
+    bestMatch(): Issue[] | null;
+    flatten(): {
+        fieldErrors: FlatError[];
+        formErrors: string[];
+    };
+    flattenFirst(): {
+        fieldErrors: FlatErrorFirst[];
+        formErrors: string[];
+    };
+    format(): FormattedErrors;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,KAAK,EAAkB,MAAM,SAAS,CAAC;AAIhE,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AAE7G;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;AACrG,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC;AAU/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,EAAE,CAElF;AAID,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,MAAM,EAAE,CAAC;CAC3C,CAAC;AAEF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAY3F;AAID,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAMhD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU;CAG3C;AAcD,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CAAE,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CAAE,CAAC;AAU5E,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBAEb,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO;IAK5C,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB;IAIpD;;;;OAIG;IACH,SAAS,IAAI,KAAK,EAAE,GAAG,IAAI;IAsB3B,OAAO,IAAI;QAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;IAwB7D,YAAY,IAAI;QAAE,WAAW,EAAE,cAAc,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;IASvE,MAAM,IAAI,eAAe;CA8B1B"}

package/dist/errors.js

@@ -0,0 +1,3 @@
+import{ErrorCode as e}from"./types.js";function t(e,t,n){return[{code:e,message:t,params:n,path:[]}]}function n(e,t){return typeof e==`function`?e(t):e}function r(e,t){return e.map(e=>({...e,path:[t,...e.path]}))}function i(e,...t){let n=e;for(let e of t){if(Array.isArray(n))return[];n=n[String(e)===`_errors`?`_errors_`:String(e)]??{_errors:[]}}return Array.isArray(n)?n:n._errors}var a=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}};function o(e){return e.map(({code:e,message:t,path:n})=>`${n.length?n.join(`.`):`value`}: ${t} [${e}]`).join(`
+`)}function s(){let e=Object.create(null);return e._errors=[],e}var c=class t extends a{issues;constructor(e,t){super(o(e),{cause:t}),this.issues=e}static is(e){return e instanceof t}bestMatch(){let t=this.issues.find(t=>t.code===e.invalid_union);if(!t)return null;let n=t.params.errors;if(n.length===0)return null;let r=n.map(e=>({issues:e,score:e.reduce((e,t)=>Math.max(e,t.path.length),0)*1e3-e.length}));return r.sort((e,t)=>t.score-e.score),r[0].issues}flatten(){let e=[],t=[],n=new Map;for(let r of this.issues)if(r.path.length===0)t.push(r.message);else{let t=JSON.stringify(r.path),i=n.get(t);i===void 0?(n.set(t,e.length),e.push({messages:[r.message],path:[...r.path]})):e[i].messages.push(r.message)}return{fieldErrors:e,formErrors:t}}flattenFirst(){let{fieldErrors:e,formErrors:t}=this.flatten();return{fieldErrors:e.map(e=>({message:e.messages[0],path:e.path})),formErrors:t}}format(){let e=s();for(let t of this.issues){if(t.path.length===0){e._errors.push(t.message);continue}let n=e;for(let e of t.path){let t=String(e),r=t===`_errors`?`_errors_`:t;Object.hasOwn(n,r)||(n[r]=s()),n=n[r]}n._errors.push(t.message)}return e}};export{a as SpellError,c as SpellValidationError,i as errorsAt,t as fail,r as prependIssuePath,n as resolveMessage};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import { ErrorCode, type Issue, type MessageFn } from './types';\n\n/* -------------------- Helpers -------------------- */\n\ntype IssueParams<C extends string> = Extract<Issue, { code: C }> extends { params: infer P } ? P : undefined;\n\n/**\n * Creates a single-error failure array. Use in validator functions instead of building the array manually.\n * Typed overloads ensure params match the given error code.\n */\nexport function fail<C extends ErrorCode>(code: C, message: string, params: IssueParams<C>): Issue[];\nexport function fail(code: string, message: string, params?: Record<string, unknown>): Issue[];\nexport function fail(code: string, message: string, params?: Record<string, unknown>): Issue[] {\n  return [{ code, message, params, path: [] } as Issue];\n}\n\n/** @internal */\nexport function resolveMessage<Ctx extends Record<string, unknown>>(msg: MessageFn<Ctx>, ctx: Ctx): string {\n  return typeof msg === 'function' ? msg(ctx) : msg;\n}\n\nexport function prependIssuePath(issues: Issue[], prefix: string | number): Issue[] {\n  return issues.map((issue) => ({ ...issue, path: [prefix, ...issue.path] }));\n}\n\n/* -------------------- FormattedErrors -------------------- */\n\nexport type FormattedErrors = {\n  _errors: string[];\n  [key: string]: FormattedErrors | string[];\n};\n\nexport function errorsAt(formatted: FormattedErrors, ...path: (string | number)[]): string[] {\n  let node: FormattedErrors | string[] = formatted;\n\n  for (const key of path) {\n    if (Array.isArray(node)) return [];\n\n    const safeKey = String(key) === '_errors' ? '_errors_' : String(key);\n\n    node = (node as FormattedErrors)[safeKey] ?? { _errors: [] };\n  }\n\n  return Array.isArray(node) ? node : (node as FormattedErrors)._errors;\n}\n\n/* -------------------- SpellError -------------------- */\n\n/** Base class for all spell errors. Use `instanceof SpellError` to catch any spell-originated error. */\nexport class SpellError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is SpellError {\n    return err instanceof SpellError;\n  }\n}\n\n/* -------------------- SpellValidationError -------------------- */\n\nfunction formatIssues(issues: Issue[]): string {\n  return issues\n    .map(({ code, message, path }) => {\n      const pathStr = path.length ? path.join('.') : 'value';\n\n      return `${pathStr}: ${message} [${code}]`;\n    })\n    .join('\\n');\n}\n\nexport type FlatError = { messages: string[]; path: (string | number)[] };\nexport type FlatErrorFirst = { message: string; path: (string | number)[] };\n\nfunction createFormattedErrors(): FormattedErrors {\n  const node = Object.create(null) as FormattedErrors;\n\n  node._errors = [];\n\n  return node;\n}\n\nexport class SpellValidationError extends SpellError {\n  readonly issues: Issue[];\n\n  constructor(issues: Issue[], cause?: unknown) {\n    super(formatIssues(issues), { cause });\n    this.issues = issues;\n  }\n\n  static is(err: unknown): err is SpellValidationError {\n    return err instanceof SpellValidationError;\n  }\n\n  /**\n   * Returns the union branch errors from the most-specific failing branch.\n   * Surfaces the branch with the fewest issues at the deepest path — the one\n   * that \"came closest\" to matching.\n   */\n  bestMatch(): Issue[] | null {\n    const unionIssue = this.issues.find(\n      (i): i is Extract<Issue, { code: 'invalid_union' }> => i.code === ErrorCode.invalid_union,\n    );\n\n    if (!unionIssue) return null;\n\n    const branches = unionIssue.params.errors;\n\n    if (branches.length === 0) return null;\n\n    const scored = branches.map((branchIssues) => {\n      const maxDepth = branchIssues.reduce((d, i) => Math.max(d, i.path.length), 0);\n\n      return { issues: branchIssues, score: maxDepth * 1000 - branchIssues.length };\n    });\n\n    scored.sort((a, b) => b.score - a.score);\n\n    return scored[0]!.issues;\n  }\n\n  flatten(): { fieldErrors: FlatError[]; formErrors: string[] } {\n    const fieldErrors: FlatError[] = [];\n    const formErrors: string[] = [];\n    const pathMap = new Map<string, number>();\n\n    for (const issue of this.issues) {\n      if (issue.path.length === 0) {\n        formErrors.push(issue.message);\n      } else {\n        const key = JSON.stringify(issue.path);\n        const existing = pathMap.get(key);\n\n        if (existing !== undefined) {\n          fieldErrors[existing]!.messages.push(issue.message);\n        } else {\n          pathMap.set(key, fieldErrors.length);\n          fieldErrors.push({ messages: [issue.message], path: [...issue.path] });\n        }\n      }\n    }\n\n    return { fieldErrors, formErrors };\n  }\n\n  flattenFirst(): { fieldErrors: FlatErrorFirst[]; formErrors: string[] } {\n    const { fieldErrors, formErrors } = this.flatten();\n\n    return {\n      fieldErrors: fieldErrors.map((fe) => ({ message: fe.messages[0]!, path: fe.path })),\n      formErrors,\n    };\n  }\n\n  format(): FormattedErrors {\n    const root = createFormattedErrors();\n\n    for (const issue of this.issues) {\n      if (issue.path.length === 0) {\n        root._errors.push(issue.message);\n        continue;\n      }\n\n      let node = root;\n\n      for (const segment of issue.path) {\n        const key = String(segment);\n\n        // '_errors' is the reserved internal field; treat it as a sibling key\n        // with a safe prefix to avoid collisions with the FormattedErrors shape.\n        const safeKey = key === '_errors' ? '_errors_' : key;\n\n        if (!Object.hasOwn(node, safeKey)) {\n          node[safeKey] = createFormattedErrors();\n        }\n\n        node = node[safeKey] as FormattedErrors;\n      }\n\n      node._errors.push(issue.message);\n    }\n\n    return root;\n  }\n}\n"],"mappings":"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"}

package/dist/formats.cjs

@@ -0,0 +1,2 @@
+function e(e){return/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/.test(e)}var t=new Set([`http`,`https`]);function n(e,n){try{let r=new URL(e);return(n?new Set(n.map(e=>e.toLowerCase())):t).has(r.protocol.replace(`:`,``).toLowerCase())}catch{return!1}}function r(e){return/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(e)}function i(e){if(!/^\d{4}-\d{2}-\d{2}$/.test(e))return!1;let t=new Date(e);return!Number.isNaN(t.getTime())&&t.toISOString().startsWith(e)}function a(e){return/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:\d{2})?$/.test(e)&&!Number.isNaN(new Date(e).getTime())}function o(e){if(/^(\d{1,3}\.){3}\d{1,3}$/.test(e))return e.split(`.`).every(e=>{let t=parseInt(e,10);return t>=0&&t<=255});try{return new URL(`http://[${e}]/`),!0}catch{return!1}}function s(e){return/^c[a-z0-9]{8,}$/.test(e)}function c(e){return/^[a-z][a-z0-9]{23}$/.test(e)}function l(e){return/^[0-7][0-9A-HJKMNP-TV-Z]{25}$/.test(e)}function u(e,t=21){return e.length===t&&/^[A-Za-z0-9_-]+$/.test(e)}function d(e){return/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$/.test(e)}function f(e){return e.length===0||e.length%4==1?!1:/^[A-Za-z0-9_-]*={0,2}$/.test(e)}function p(e){return/^[A-Fa-f0-9]+$/.test(e)}function m(e){return/^#(?:[A-Fa-f0-9]{3}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})$/.test(e)}function h(e){return/^\p{Extended_Pictographic}+$/u.test(e)}function g(e){return/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/.test(e)}function _(e){return/^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$/.test(e)}function v(e){return/^P(?=\d|T\d)(\d+Y)?(\d+M)?(\d+W)?(\d+D)?(T(\d+H)?(\d+M)?(\d+(?:\.\d+)?S)?)?$/.test(e)}function y(e){return/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/.test(e)}function b(e){return/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(e)}function x(e){return/^[-+]?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?$/i.test(e)}exports.isBase64=d,exports.isBase64url=f,exports.isCuid=s,exports.isCuid2=c,exports.isDuration=v,exports.isEmail=e,exports.isEmoji=h,exports.isHex=p,exports.isHexColor=m,exports.isIp=o,exports.isIsoDate=i,exports.isIsoDateTime=a,exports.isJwt=g,exports.isNanoid=u,exports.isNumeric=x,exports.isSemver=y,exports.isSlug=b,exports.isTime=_,exports.isUlid=l,exports.isUrl=n,exports.isUuid=r;
+//# sourceMappingURL=formats.cjs.map

package/dist/formats.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.cjs","names":[],"sources":["../src/formats.ts"],"sourcesContent":["/**\n * Pure string format validators.\n *\n * All functions take a `string` and return `boolean`. They are exported as part of the\n * public API so callers can use them independently of any Schema.\n *\n * ```ts\n * import { isEmail, isUuid } from '@vielzeug/spell';\n * isEmail('foo@bar.com'); // true\n * ```\n */\n\nexport function isEmail(v: string): boolean {\n  return /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/.test(v);\n}\n\nconst _DEFAULT_URL_PROTOCOLS = new Set(['http', 'https']);\n\nexport function isUrl(v: string, protocols?: readonly string[]): boolean {\n  try {\n    const parsed = new URL(v);\n    const allowed = protocols ? new Set(protocols.map((p) => p.toLowerCase())) : _DEFAULT_URL_PROTOCOLS;\n\n    return allowed.has(parsed.protocol.replace(':', '').toLowerCase());\n  } catch {\n    return false;\n  }\n}\n\nexport function isUuid(v: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(v);\n}\n\nexport function isIsoDate(v: string): boolean {\n  if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(v)) return false;\n\n  const d = new Date(v);\n\n  return !Number.isNaN(d.getTime()) && d.toISOString().startsWith(v);\n}\n\nexport function isIsoDateTime(v: string): boolean {\n  return (\n    /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:\\d{2})?$/.test(v) &&\n    !Number.isNaN(new Date(v).getTime())\n  );\n}\n\nexport function isIp(v: string): boolean {\n  // IPv4\n  if (/^(\\d{1,3}\\.){3}\\d{1,3}$/.test(v)) {\n    return v.split('.').every((o) => {\n      const n = parseInt(o, 10);\n\n      return n >= 0 && n <= 255;\n    });\n  }\n\n  // IPv6 — rely on URL parser\n  try {\n    new URL(`http://[${v}]/`);\n\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function isCuid(v: string): boolean {\n  return /^c[a-z0-9]{8,}$/.test(v);\n}\n\nexport function isCuid2(v: string): boolean {\n  return /^[a-z][a-z0-9]{23}$/.test(v);\n}\n\nexport function isUlid(v: string): boolean {\n  return /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/.test(v);\n}\n\n/**\n * Validates a NanoID string. The default NanoID length is 21 characters; pass a\n * custom length to validate IDs generated with non-default sizes.\n */\nexport function isNanoid(v: string, length = 21): boolean {\n  return v.length === length && /^[A-Za-z0-9_-]+$/.test(v);\n}\n\nexport function isBase64(v: string): boolean {\n  return /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$/.test(v);\n}\n\n/**\n * Validates a base64url-encoded string (RFC 4648 §5). Accepts unpadded and padded forms.\n * A string whose length % 4 === 1 is never valid base64url.\n */\nexport function isBase64url(v: string): boolean {\n  if (v.length === 0 || v.length % 4 === 1) return false;\n\n  return /^[A-Za-z0-9_-]*={0,2}$/.test(v);\n}\n\nexport function isHex(v: string): boolean {\n  return /^[A-Fa-f0-9]+$/.test(v);\n}\n\nexport function isHexColor(v: string): boolean {\n  return /^#(?:[A-Fa-f0-9]{3}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})$/.test(v);\n}\n\nexport function isEmoji(v: string): boolean {\n  return /^\\p{Extended_Pictographic}+$/u.test(v);\n}\n\nexport function isJwt(v: string): boolean {\n  return /^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$/.test(v);\n}\n\nexport function isTime(v: string): boolean {\n  return /^(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d)?$/.test(v);\n}\n\nexport function isDuration(v: string): boolean {\n  return /^P(?=\\d|T\\d)(\\d+Y)?(\\d+M)?(\\d+W)?(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+(?:\\.\\d+)?S)?)?$/.test(v);\n}\n\nexport function isSemver(v: string): boolean {\n  return /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?$/.test(\n    v,\n  );\n}\n\nexport function isSlug(v: string): boolean {\n  return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(v);\n}\n\nexport function isNumeric(v: string): boolean {\n  return /^[-+]?(?:\\d+\\.?\\d*|\\.\\d+)(?:e[-+]?\\d+)?$/i.test(v);\n}\n"],"mappings":"AAYA,SAAgB,EAAQ,EAAoB,CAC1C,MAAO,mDAAmD,KAAK,CAAC,CAClE,CAEA,IAAM,EAAyB,IAAI,IAAI,CAAC,OAAQ,OAAO,CAAC,EAExD,SAAgB,EAAM,EAAW,EAAwC,CACvE,GAAI,CACF,IAAM,EAAS,IAAI,IAAI,CAAC,EAGxB,OAFgB,EAAY,IAAI,IAAI,EAAU,IAAK,GAAM,EAAE,YAAY,CAAC,CAAC,EAAI,EAAA,CAE9D,IAAI,EAAO,SAAS,QAAQ,IAAK,EAAE,CAAC,CAAC,YAAY,CAAC,CACnE,MAAQ,CACN,MAAO,EACT,CACF,CAEA,SAAgB,EAAO,EAAoB,CACzC,MAAO,kEAAkE,KAAK,CAAC,CACjF,CAEA,SAAgB,EAAU,EAAoB,CAC5C,GAAI,CAAC,sBAAsB,KAAK,CAAC,EAAG,MAAO,GAE3C,IAAM,EAAI,IAAI,KAAK,CAAC,EAEpB,MAAO,CAAC,OAAO,MAAM,EAAE,QAAQ,CAAC,GAAK,EAAE,YAAY,CAAC,CAAC,WAAW,CAAC,CACnE,CAEA,SAAgB,EAAc,EAAoB,CAChD,MACE,6EAA6E,KAAK,CAAC,GACnF,CAAC,OAAO,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAEvC,CAEA,SAAgB,EAAK,EAAoB,CAEvC,GAAI,0BAA0B,KAAK,CAAC,EAClC,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,MAAO,GAAM,CAC/B,IAAM,EAAI,SAAS,EAAG,EAAE,EAExB,OAAO,GAAK,GAAK,GAAK,GACxB,CAAC,EAIH,GAAI,CAGF,OAFA,IAAI,IAAI,WAAW,EAAE,GAAG,EAEjB,EACT,MAAQ,CACN,MAAO,EACT,CACF,CAEA,SAAgB,EAAO,EAAoB,CACzC,MAAO,kBAAkB,KAAK,CAAC,CACjC,CAEA,SAAgB,EAAQ,EAAoB,CAC1C,MAAO,sBAAsB,KAAK,CAAC,CACrC,CAEA,SAAgB,EAAO,EAAoB,CACzC,MAAO,gCAAgC,KAAK,CAAC,CAC/C,CAMA,SAAgB,EAAS,EAAW,EAAS,GAAa,CACxD,OAAO,EAAE,SAAW,GAAU,mBAAmB,KAAK,CAAC,CACzD,CAEA,SAAgB,EAAS,EAAoB,CAC3C,MAAO,mFAAmF,KAAK,CAAC,CAClG,CAMA,SAAgB,EAAY,EAAoB,CAG9C,OAFI,EAAE,SAAW,GAAK,EAAE,OAAS,GAAM,EAAU,GAE1C,yBAAyB,KAAK,CAAC,CACxC,CAEA,SAAgB,EAAM,EAAoB,CACxC,MAAO,iBAAiB,KAAK,CAAC,CAChC,CAEA,SAAgB,EAAW,EAAoB,CAC7C,MAAO,sDAAsD,KAAK,CAAC,CACrE,CAEA,SAAgB,EAAQ,EAAoB,CAC1C,MAAO,gCAAgC,KAAK,CAAC,CAC/C,CAEA,SAAgB,EAAM,EAAoB,CACxC,MAAO,mDAAmD,KAAK,CAAC,CAClE,CAEA,SAAgB,EAAO,EAAoB,CACzC,MAAO,2CAA2C,KAAK,CAAC,CAC1D,CAEA,SAAgB,EAAW,EAAoB,CAC7C,MAAO,+EAA+E,KAAK,CAAC,CAC9F,CAEA,SAAgB,EAAS,EAAoB,CAC3C,MAAO,sLAAsL,KAC3L,CACF,CACF,CAEA,SAAgB,EAAO,EAAoB,CACzC,MAAO,6BAA6B,KAAK,CAAC,CAC5C,CAEA,SAAgB,EAAU,EAAoB,CAC5C,MAAO,4CAA4C,KAAK,CAAC,CAC3D"}

package/dist/formats.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure string format validators.
+ *
+ * All functions take a `string` and return `boolean`. They are exported as part of the
+ * public API so callers can use them independently of any Schema.
+ *
+ * ```ts
+ * import { isEmail, isUuid } from '@vielzeug/spell';
+ * isEmail('foo@bar.com'); // true
+ * ```
+ */
+export declare function isEmail(v: string): boolean;
+export declare function isUrl(v: string, protocols?: readonly string[]): boolean;
+export declare function isUuid(v: string): boolean;
+export declare function isIsoDate(v: string): boolean;
+export declare function isIsoDateTime(v: string): boolean;
+export declare function isIp(v: string): boolean;
+export declare function isCuid(v: string): boolean;
+export declare function isCuid2(v: string): boolean;
+export declare function isUlid(v: string): boolean;
+/**
+ * Validates a NanoID string. The default NanoID length is 21 characters; pass a
+ * custom length to validate IDs generated with non-default sizes.
+ */
+export declare function isNanoid(v: string, length?: number): boolean;
+export declare function isBase64(v: string): boolean;
+/**
+ * Validates a base64url-encoded string (RFC 4648 §5). Accepts unpadded and padded forms.
+ * A string whose length % 4 === 1 is never valid base64url.
+ */
+export declare function isBase64url(v: string): boolean;
+export declare function isHex(v: string): boolean;
+export declare function isHexColor(v: string): boolean;
+export declare function isEmoji(v: string): boolean;
+export declare function isJwt(v: string): boolean;
+export declare function isTime(v: string): boolean;
+export declare function isDuration(v: string): boolean;
+export declare function isSemver(v: string): boolean;
+export declare function isSlug(v: string): boolean;
+export declare function isNumeric(v: string): boolean;
+//# sourceMappingURL=formats.d.ts.map