@vielzeug/forge 2.3.1 → 3.0.0

package/README.md

@@ -1,6 +1,14 @@
 # @vielzeug/forge
 
-> Immutable typed form state with focused fields and explicit full-form validation.
+> Typed form state, validation, submission
+
+## Installation
+
+```sh
+pnpm add @vielzeug/forge
+npm install @vielzeug/forge
+yarn add @vielzeug/forge
+```
 
 ## Quick Start
 
@@ -9,9 +17,10 @@ import { createForm } from '@vielzeug/forge';
 
 const form = createForm({
   initialValues: { profile: { email: '', name: '' } },
-  validate: (value) => ({
-    fields: { profile: { email: value.profile.email.includes('@') ? undefined : 'Enter a valid email' } },
-  }),
+  validate: (value) =>
+    value.profile.email.includes('@')
+      ? undefined
+      : [{ path: ['profile', 'email'], message: 'Enter a valid email' }],
 });
 
 const email = form.field('profile').field('email');
@@ -20,22 +29,14 @@ email.set('ada@example.com');
 const result = await form.submit((value) => saveProfile(value));
 ```
 
-`Form` owns one immutable value tree of primitives, plain objects, arrays, `Date`, `File`, and `Blob`. Object fields select child branches and array items support per-index field handles. One validator evaluates the whole form and returns `{ fields, formError }`.
-
-## Optional adapters
-
-- `@vielzeug/forge/dom` — explicit element binding; application owns validation timing.
-- `@vielzeug/forge/form-data` — `toFormData()` serializes nested values into `FormData`.
-- `@vielzeug/forge/spell` — typed `customValidator(schema)` adapter with per-union diagnostics.
-- `@vielzeug/forge/vault` — explicit `saveForm()` and `loadForm()` draft helpers.
-
 ## Documentation
 
 - [Overview](https://vielzeug.dev/forge/)
-- [Usage guide](https://vielzeug.dev/forge/usage)
-- [API reference](https://vielzeug.dev/forge/api)
+- [Usage Guide](https://vielzeug.dev/forge/usage)
+- [API Reference](https://vielzeug.dev/forge/api)
 - [Examples](https://vielzeug.dev/forge/examples)
+- [Migration Guide](https://vielzeug.dev/forge/migration)
 
 ## License
 
-MIT © Helmuth Saatkamp — part of the Vielzeug monorepo.
+MIT © [Helmuth Saatkamp](https://github.com/helmuthdu) — part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.

package/dist/_field.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs"),t=require("./core/path.cjs");function n(e,n){let r=t.readAtPath(e.value,n),i=t.readAtPath(e.baseline,n);return Object.freeze({dirty:r!==i||t.hasAtPath(e.value,n)!==t.hasAtPath(e.baseline,n),error:t.readError(e.errors,n),touched:t.readMeta(e.touched,n),value:r})}function r(i,a){return Object.assign({get dirty(){return n(a.readState(),i).dirty},get error(){return n(a.readState(),i).error},reset(){a.ensureActive(`field().reset`),a.abortValidation(),a.resetValue(i)},set(e){a.ensureActive(`field().set`),a.abortValidation();let n=t.readAtPath(a.readState().value,i),r=typeof e==`function`?e(n):e;a.setValue(i,r)},get state(){return n(a.readState(),i)},subscribe(e,t={}){a.ensureActive(`field().subscribe`);let r=n(a.readState(),i);return t.immediate&&e(r),a.addListener(()=>{let t=n(a.readState(),i);(t.value!==r.value||t.error!==r.error||t.touched!==r.touched||t.dirty!==r.dirty)&&(r=t,e(t))})},touch(){a.ensureActive(`field().touch`),a.setTouched(i,!0)},get touched(){return n(a.readState(),i).touched},get value(){return n(a.readState(),i).value}},{field(n){if(typeof n==`number`){let o=t.readAtPath(a.readState().value,i);if(o!==void 0&&!Array.isArray(o))throw new e.ForgeConfigError(`Cannot index ${n} because the current field value is not an array.`);return r([...i,n],a)}t.assertSafeKey(n);let o=t.readAtPath(a.readState().value,i);if(o!==void 0&&!t.isRecord(o))throw new e.ForgeConfigError(`Cannot select '${n}' because the current field value is not an object.`);return r([...i,n],a)}})}exports.createField=r;
+const e=require("./errors.cjs"),t=require("./core/path.cjs");let n=require("@vielzeug/arsenal");function r(e,r){let i=t.readAtPath(e.value,r),a=t.readAtPath(e.baseline,r);return Object.freeze({dirty:!(0,n.isEqual)(i,a)||t.hasAtPath(e.value,r)!==t.hasAtPath(e.baseline,r),error:t.findIssue(e.issues,r),touched:t.readMeta(e.touched,r),value:i})}function i(a,o){return Object.assign({get dirty(){return r(o.readState(),a).dirty},get error(){return r(o.readState(),a).error},reset(){o.ensureActive(`field().reset`),o.abortValidation(),o.resetValue(a)},set(e){o.ensureActive(`field().set`),o.abortValidation(),o.setValue(a,e)},get state(){return r(o.readState(),a)},subscribe(e,t={}){o.ensureActive(`field().subscribe`);let n=r(o.readState(),a);return t.immediate&&o.invokeListener(()=>e(n)),o.addListener(t=>{let i=r(t,a);(i.value!==n.value||i.error!==n.error||i.touched!==n.touched||i.dirty!==n.dirty)&&(n=i,e(i))})},touch(){o.ensureActive(`field().touch`),o.setTouched(a,!0)},get touched(){return r(o.readState(),a).touched},get value(){return r(o.readState(),a).value}},{field(r){if(typeof r==`number`){t.assertArrayIndex(r);let n=t.readAtPath(o.readState().value,a);if(n!==void 0&&!Array.isArray(n))throw new e.ForgeConfigError(`Cannot index ${r} because the current field value is not an array.`);return i([...a,r],o)}t.assertSafeKey(r);let s=t.readAtPath(o.readState().value,a);if(s!==void 0&&!(0,n.isPlainObject)(s))throw new e.ForgeConfigError(`Cannot select '${r}' because the current field value is not an object.`);return i([...a,r],o)}})}exports.createField=i;
 //# sourceMappingURL=_field.cjs.map

package/dist/_field.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_field.cjs","names":[],"sources":["../src/_field.ts"],"sourcesContent":["import { assertSafeKey, hasAtPath, isRecord, type MetaRoot, readAtPath, readError, readMeta } from './core/path';\nimport { ForgeConfigError } from './errors';\nimport type { Field, FieldState, ReadonlyDeep, SubscribeOptions, Unsubscribe } from './types';\n\nexport interface FieldAccess {\n  abortValidation(): void;\n  addListener(listener: () => void): Unsubscribe;\n  ensureActive(operation: string): void;\n  readState(): { baseline: unknown; errors: unknown; touched: MetaRoot; value: unknown };\n  resetValue(path: readonly (string | number)[]): void;\n  setTouched(path: readonly (string | number)[], touched: boolean): void;\n  setValue(path: readonly (string | number)[], next: unknown): void;\n}\n\nfunction makeFieldState<V>(\n  state: { baseline: unknown; errors: unknown; touched: MetaRoot; value: unknown },\n  path: readonly (string | number)[],\n): FieldState<V> {\n  const value = readAtPath<V>(state.value, path);\n  const baseline = readAtPath<V>(state.baseline, path);\n\n  return Object.freeze({\n    dirty: value !== baseline || hasAtPath(state.value, path) !== hasAtPath(state.baseline, path),\n    error: readError(state.errors, path),\n    touched: readMeta(state.touched, path),\n    value: value as ReadonlyDeep<V>,\n  });\n}\n\nexport function createField<V>(path: readonly (string | number)[], access: FieldAccess): Field<V> {\n  const common = {\n    get dirty() {\n      return makeFieldState<V>(access.readState(), path).dirty;\n    },\n    get error() {\n      return makeFieldState<V>(access.readState(), path).error;\n    },\n    reset() {\n      access.ensureActive('field().reset');\n      access.abortValidation();\n      access.resetValue(path);\n    },\n    set(next: V | ((previous: ReadonlyDeep<V>) => V)) {\n      access.ensureActive('field().set');\n      access.abortValidation();\n\n      const previous = readAtPath<V>(access.readState().value, path) as ReadonlyDeep<V>;\n      const value = typeof next === 'function' ? (next as (current: ReadonlyDeep<V>) => V)(previous) : next;\n\n      access.setValue(path, value);\n    },\n    get state() {\n      return makeFieldState<V>(access.readState(), path);\n    },\n    subscribe(listener: (state: FieldState<V>) => void, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n      access.ensureActive('field().subscribe');\n\n      let previous = makeFieldState<V>(access.readState(), path);\n\n      if (subscribeOptions.immediate) listener(previous);\n\n      const filtered = () => {\n        const next = makeFieldState<V>(access.readState(), path);\n\n        if (\n          next.value === previous.value &&\n          next.error === previous.error &&\n          next.touched === previous.touched &&\n          next.dirty === previous.dirty\n        ) {\n          return;\n        }\n\n        previous = next;\n        listener(next);\n      };\n\n      return access.addListener(filtered);\n    },\n    touch() {\n      access.ensureActive('field().touch');\n      access.setTouched(path, true);\n    },\n    get touched() {\n      return makeFieldState<V>(access.readState(), path).touched;\n    },\n    get value() {\n      return makeFieldState<V>(access.readState(), path).value;\n    },\n  };\n\n  return Object.assign(common, {\n    field(key: string | number): Field<unknown> {\n      if (typeof key === 'number') {\n        const currentVal = readAtPath(access.readState().value, path);\n\n        if (currentVal !== undefined && !Array.isArray(currentVal)) {\n          throw new ForgeConfigError(`Cannot index ${key} because the current field value is not an array.`);\n        }\n\n        return createField([...path, key], access);\n      }\n\n      assertSafeKey(key);\n\n      const currentVal = readAtPath(access.readState().value, path);\n\n      if (currentVal !== undefined && !isRecord(currentVal)) {\n        throw new ForgeConfigError(`Cannot select '${key}' because the current field value is not an object.`);\n      }\n\n      return createField([...path, key], access);\n    },\n  }) as unknown as Field<V>;\n}\n"],"mappings":"6DAcA,SAAS,EACP,EACA,EACe,CACf,IAAM,EAAQ,EAAA,WAAc,EAAM,MAAO,CAAI,EACvC,EAAW,EAAA,WAAc,EAAM,SAAU,CAAI,EAEnD,OAAO,OAAO,OAAO,CACnB,MAAO,IAAU,GAAY,EAAA,UAAU,EAAM,MAAO,CAAI,IAAM,EAAA,UAAU,EAAM,SAAU,CAAI,EAC5F,MAAO,EAAA,UAAU,EAAM,OAAQ,CAAI,EACnC,QAAS,EAAA,SAAS,EAAM,QAAS,CAAI,EAC9B,OACT,CAAC,CACH,CAEA,SAAgB,EAAe,EAAoC,EAA+B,CA8DhG,OAAO,OAAO,OAAO,CA5DnB,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,KACrD,EACA,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,KACrD,EACA,OAAQ,CACN,EAAO,aAAa,eAAe,EACnC,EAAO,gBAAgB,EACvB,EAAO,WAAW,CAAI,CACxB,EACA,IAAI,EAA8C,CAChD,EAAO,aAAa,aAAa,EACjC,EAAO,gBAAgB,EAEvB,IAAM,EAAW,EAAA,WAAc,EAAO,UAAU,CAAC,CAAC,MAAO,CAAI,EACvD,EAAQ,OAAO,GAAS,WAAc,EAAyC,CAAQ,EAAI,EAEjG,EAAO,SAAS,EAAM,CAAK,CAC7B,EACA,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CACnD,EACA,UAAU,EAA0C,EAAqC,CAAC,EAAgB,CACxG,EAAO,aAAa,mBAAmB,EAEvC,IAAI,EAAW,EAAkB,EAAO,UAAU,EAAG,CAAI,EAoBzD,OAlBI,EAAiB,WAAW,EAAS,CAAQ,EAkB1C,EAAO,gBAhBS,CACrB,IAAM,EAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,GAGrD,EAAK,QAAU,EAAS,OACxB,EAAK,QAAU,EAAS,OACxB,EAAK,UAAY,EAAS,SAC1B,EAAK,QAAU,EAAS,SAK1B,EAAW,EACX,EAAS,CAAI,EACf,CAEkC,CACpC,EACA,OAAQ,CACN,EAAO,aAAa,eAAe,EACnC,EAAO,WAAW,EAAM,EAAI,CAC9B,EACA,IAAI,SAAU,CACZ,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,OACrD,EACA,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,KACrD,CAGmB,EAAQ,CAC3B,MAAM,EAAsC,CAC1C,GAAI,OAAO,GAAQ,SAAU,CAC3B,IAAM,EAAa,EAAA,WAAW,EAAO,UAAU,CAAC,CAAC,MAAO,CAAI,EAE5D,GAAI,IAAe,IAAA,IAAa,CAAC,MAAM,QAAQ,CAAU,EACvD,MAAM,IAAI,EAAA,iBAAiB,gBAAgB,EAAI,kDAAkD,EAGnG,OAAO,EAAY,CAAC,GAAG,EAAM,CAAG,EAAG,CAAM,CAC3C,CAEA,EAAA,cAAc,CAAG,EAEjB,IAAM,EAAa,EAAA,WAAW,EAAO,UAAU,CAAC,CAAC,MAAO,CAAI,EAE5D,GAAI,IAAe,IAAA,IAAa,CAAC,EAAA,SAAS,CAAU,EAClD,MAAM,IAAI,EAAA,iBAAiB,kBAAkB,EAAI,oDAAoD,EAGvG,OAAO,EAAY,CAAC,GAAG,EAAM,CAAG,EAAG,CAAM,CAC3C,CACF,CAAC,CACH"}
+{"version":3,"file":"_field.cjs","names":[],"sources":["../src/_field.ts"],"sourcesContent":["import { isEqual } from '@vielzeug/arsenal';\n\nimport {\n  assertArrayIndex,\n  assertSafeKey,\n  findIssue,\n  hasAtPath,\n  isRecord,\n  type MetaRoot,\n  readAtPath,\n  readMeta,\n} from './core/path.js';\nimport { ForgeConfigError } from './errors.js';\nimport type { Field, FieldState, SubscribeOptions, Unsubscribe, ValidationIssue } from './types.js';\n\ntype FieldSourceState = {\n  baseline: unknown;\n  issues: readonly ValidationIssue[] | undefined;\n  touched: MetaRoot;\n  value: unknown;\n};\n\nexport interface FieldAccess {\n  abortValidation(): void;\n  addListener(listener: (state: FieldSourceState) => void): Unsubscribe;\n  ensureActive(operation: string): void;\n  invokeListener(listener: () => void): void;\n  readState(): FieldSourceState;\n  resetValue(path: readonly (string | number)[]): void;\n  setTouched(path: readonly (string | number)[], touched: boolean): void;\n  setValue(path: readonly (string | number)[], next: unknown | ((previous: unknown) => unknown)): void;\n}\n\nfunction makeFieldState<V>(state: FieldSourceState, path: readonly (string | number)[]): FieldState<V> {\n  const value = readAtPath<V>(state.value, path);\n  const baseline = readAtPath<V>(state.baseline, path);\n\n  return Object.freeze({\n    dirty: !isEqual(value, baseline) || hasAtPath(state.value, path) !== hasAtPath(state.baseline, path),\n    error: findIssue(state.issues, path),\n    touched: readMeta(state.touched, path),\n    value: value as FieldState<V>['value'],\n  });\n}\n\nexport function createField<V>(path: readonly (string | number)[], access: FieldAccess): Field<V> {\n  const common = {\n    get dirty() {\n      return makeFieldState<V>(access.readState(), path).dirty;\n    },\n    get error() {\n      return makeFieldState<V>(access.readState(), path).error;\n    },\n    reset() {\n      access.ensureActive('field().reset');\n      access.abortValidation();\n      access.resetValue(path);\n    },\n    set(next: V | ((previous: FieldState<V>['value']) => V)) {\n      access.ensureActive('field().set');\n      access.abortValidation();\n\n      access.setValue(path, next as unknown | ((previous: unknown) => unknown));\n    },\n    get state() {\n      return makeFieldState<V>(access.readState(), path);\n    },\n    subscribe(listener: (state: FieldState<V>) => void, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n      access.ensureActive('field().subscribe');\n\n      let previous = makeFieldState<V>(access.readState(), path);\n\n      if (subscribeOptions.immediate) access.invokeListener(() => listener(previous));\n\n      const filtered = (state: FieldSourceState) => {\n        const next = makeFieldState<V>(state, path);\n\n        if (\n          next.value === previous.value &&\n          next.error === previous.error &&\n          next.touched === previous.touched &&\n          next.dirty === previous.dirty\n        ) {\n          return;\n        }\n\n        previous = next;\n        listener(next);\n      };\n\n      return access.addListener(filtered);\n    },\n    touch() {\n      access.ensureActive('field().touch');\n      access.setTouched(path, true);\n    },\n    get touched() {\n      return makeFieldState<V>(access.readState(), path).touched;\n    },\n    get value() {\n      return makeFieldState<V>(access.readState(), path).value;\n    },\n  };\n\n  return Object.assign(common, {\n    field(key: string | number): Field<unknown> {\n      if (typeof key === 'number') {\n        assertArrayIndex(key);\n        const currentVal = readAtPath(access.readState().value, path);\n\n        if (currentVal !== undefined && !Array.isArray(currentVal)) {\n          throw new ForgeConfigError(`Cannot index ${key} because the current field value is not an array.`);\n        }\n\n        return createField([...path, key], access);\n      }\n\n      assertSafeKey(key);\n\n      const currentVal = readAtPath(access.readState().value, path);\n\n      if (currentVal !== undefined && !isRecord(currentVal)) {\n        throw new ForgeConfigError(`Cannot select '${key}' because the current field value is not an object.`);\n      }\n\n      return createField([...path, key], access);\n    },\n  }) as unknown as Field<V>;\n}\n"],"mappings":"gGAiCA,SAAS,EAAkB,EAAyB,EAAmD,CACrG,IAAM,EAAQ,EAAA,WAAc,EAAM,MAAO,CAAI,EACvC,EAAW,EAAA,WAAc,EAAM,SAAU,CAAI,EAEnD,OAAO,OAAO,OAAO,CACnB,MAAO,EAAA,EAAC,EAAA,QAAA,CAAQ,EAAO,CAAQ,GAAK,EAAA,UAAU,EAAM,MAAO,CAAI,IAAM,EAAA,UAAU,EAAM,SAAU,CAAI,EACnG,MAAO,EAAA,UAAU,EAAM,OAAQ,CAAI,EACnC,QAAS,EAAA,SAAS,EAAM,QAAS,CAAI,EAC9B,OACT,CAAC,CACH,CAEA,SAAgB,EAAe,EAAoC,EAA+B,CA2DhG,OAAO,OAAO,OAAO,CAzDnB,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,KACrD,EACA,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,KACrD,EACA,OAAQ,CACN,EAAO,aAAa,eAAe,EACnC,EAAO,gBAAgB,EACvB,EAAO,WAAW,CAAI,CACxB,EACA,IAAI,EAAqD,CACvD,EAAO,aAAa,aAAa,EACjC,EAAO,gBAAgB,EAEvB,EAAO,SAAS,EAAM,CAAkD,CAC1E,EACA,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CACnD,EACA,UAAU,EAA0C,EAAqC,CAAC,EAAgB,CACxG,EAAO,aAAa,mBAAmB,EAEvC,IAAI,EAAW,EAAkB,EAAO,UAAU,EAAG,CAAI,EAoBzD,OAlBI,EAAiB,WAAW,EAAO,mBAAqB,EAAS,CAAQ,CAAC,EAkBvE,EAAO,YAhBI,GAA4B,CAC5C,IAAM,EAAO,EAAkB,EAAO,CAAI,GAGxC,EAAK,QAAU,EAAS,OACxB,EAAK,QAAU,EAAS,OACxB,EAAK,UAAY,EAAS,SAC1B,EAAK,QAAU,EAAS,SAK1B,EAAW,EACX,EAAS,CAAI,EACf,CAEkC,CACpC,EACA,OAAQ,CACN,EAAO,aAAa,eAAe,EACnC,EAAO,WAAW,EAAM,EAAI,CAC9B,EACA,IAAI,SAAU,CACZ,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,OACrD,EACA,IAAI,OAAQ,CACV,OAAO,EAAkB,EAAO,UAAU,EAAG,CAAI,CAAC,CAAC,KACrD,CAGmB,EAAQ,CAC3B,MAAM,EAAsC,CAC1C,GAAI,OAAO,GAAQ,SAAU,CAC3B,EAAA,iBAAiB,CAAG,EACpB,IAAM,EAAa,EAAA,WAAW,EAAO,UAAU,CAAC,CAAC,MAAO,CAAI,EAE5D,GAAI,IAAe,IAAA,IAAa,CAAC,MAAM,QAAQ,CAAU,EACvD,MAAM,IAAI,EAAA,iBAAiB,gBAAgB,EAAI,kDAAkD,EAGnG,OAAO,EAAY,CAAC,GAAG,EAAM,CAAG,EAAG,CAAM,CAC3C,CAEA,EAAA,cAAc,CAAG,EAEjB,IAAM,EAAa,EAAA,WAAW,EAAO,UAAU,CAAC,CAAC,MAAO,CAAI,EAE5D,GAAI,IAAe,IAAA,IAAa,EAAA,EAAC,EAAA,cAAA,CAAS,CAAU,EAClD,MAAM,IAAI,EAAA,iBAAiB,kBAAkB,EAAI,oDAAoD,EAGvG,OAAO,EAAY,CAAC,GAAG,EAAM,CAAG,EAAG,CAAM,CAC3C,CACF,CAAC,CACH"}

package/dist/_field.d.ts

@@ -1,18 +1,21 @@
-import { type MetaRoot } from './core/path';
-import type { Field, Unsubscribe } from './types';
+import { type MetaRoot } from './core/path.js';
+import type { Field, Unsubscribe, ValidationIssue } from './types.js';
+type FieldSourceState = {
+    baseline: unknown;
+    issues: readonly ValidationIssue[] | undefined;
+    touched: MetaRoot;
+    value: unknown;
+};
 export interface FieldAccess {
     abortValidation(): void;
-    addListener(listener: () => void): Unsubscribe;
+    addListener(listener: (state: FieldSourceState) => void): Unsubscribe;
     ensureActive(operation: string): void;
-    readState(): {
-        baseline: unknown;
-        errors: unknown;
-        touched: MetaRoot;
-        value: unknown;
-    };
+    invokeListener(listener: () => void): void;
+    readState(): FieldSourceState;
     resetValue(path: readonly (string | number)[]): void;
     setTouched(path: readonly (string | number)[], touched: boolean): void;
-    setValue(path: readonly (string | number)[], next: unknown): void;
+    setValue(path: readonly (string | number)[], next: unknown | ((previous: unknown) => unknown)): void;
 }
 export declare function createField<V>(path: readonly (string | number)[], access: FieldAccess): Field<V>;
+export {};
 //# sourceMappingURL=_field.d.ts.map

package/dist/_field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_field.d.ts","sourceRoot":"","sources":["../src/_field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,QAAQ,EAAmC,MAAM,aAAa,CAAC;AAEjH,OAAO,KAAK,EAAE,KAAK,EAA8C,WAAW,EAAE,MAAM,SAAS,CAAC;AAE9F,MAAM,WAAW,WAAW;IAC1B,eAAe,IAAI,IAAI,CAAC;IACxB,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IAC/C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,SAAS,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IACvF,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACnE;AAiBD,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAqFhG"}
+{"version":3,"file":"_field.d.ts","sourceRoot":"","sources":["../src/_field.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,QAAQ,EAGd,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,KAAK,EAAgC,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpG,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,CAAC;IAC/C,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,eAAe,IAAI,IAAI,CAAC;IACxB,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,WAAW,CAAC;IACtE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC3C,SAAS,IAAI,gBAAgB,CAAC;IAC9B,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CACtG;AAcD,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAmFhG"}

package/dist/_field.js

@@ -1,64 +1,64 @@
 import { ForgeConfigError as e } from "./errors.js";
-import { assertSafeKey as t, hasAtPath as n, isRecord as r, readAtPath as i, readError as a, readMeta as o } from "./core/path.js";
+import { assertArrayIndex as t, assertSafeKey as n, findIssue as r, hasAtPath as i, isRecord as a, readAtPath as o, readMeta as s } from "./core/path.js";
+import { isEqual as c } from "@vielzeug/arsenal";
 //#region src/_field.ts
-function s(e, t) {
-	let r = i(e.value, t), s = i(e.baseline, t);
+function l(e, t) {
+	let n = o(e.value, t), a = o(e.baseline, t);
 	return Object.freeze({
-		dirty: r !== s || n(e.value, t) !== n(e.baseline, t),
-		error: a(e.errors, t),
-		touched: o(e.touched, t),
-		value: r
+		dirty: !c(n, a) || i(e.value, t) !== i(e.baseline, t),
+		error: r(e.issues, t),
+		touched: s(e.touched, t),
+		value: n
 	});
 }
-function c(n, a) {
+function u(r, i) {
 	return Object.assign({
 		get dirty() {
-			return s(a.readState(), n).dirty;
+			return l(i.readState(), r).dirty;
 		},
 		get error() {
-			return s(a.readState(), n).error;
+			return l(i.readState(), r).error;
 		},
 		reset() {
-			a.ensureActive("field().reset"), a.abortValidation(), a.resetValue(n);
+			i.ensureActive("field().reset"), i.abortValidation(), i.resetValue(r);
 		},
 		set(e) {
-			a.ensureActive("field().set"), a.abortValidation();
-			let t = i(a.readState().value, n), r = typeof e == "function" ? e(t) : e;
-			a.setValue(n, r);
+			i.ensureActive("field().set"), i.abortValidation(), i.setValue(r, e);
 		},
 		get state() {
-			return s(a.readState(), n);
+			return l(i.readState(), r);
 		},
 		subscribe(e, t = {}) {
-			a.ensureActive("field().subscribe");
-			let r = s(a.readState(), n);
-			return t.immediate && e(r), a.addListener(() => {
-				let t = s(a.readState(), n);
-				(t.value !== r.value || t.error !== r.error || t.touched !== r.touched || t.dirty !== r.dirty) && (r = t, e(t));
+			i.ensureActive("field().subscribe");
+			let n = l(i.readState(), r);
+			return t.immediate && i.invokeListener(() => e(n)), i.addListener((t) => {
+				let i = l(t, r);
+				(i.value !== n.value || i.error !== n.error || i.touched !== n.touched || i.dirty !== n.dirty) && (n = i, e(i));
 			});
 		},
 		touch() {
-			a.ensureActive("field().touch"), a.setTouched(n, !0);
+			i.ensureActive("field().touch"), i.setTouched(r, !0);
 		},
 		get touched() {
-			return s(a.readState(), n).touched;
+			return l(i.readState(), r).touched;
 		},
 		get value() {
-			return s(a.readState(), n).value;
+			return l(i.readState(), r).value;
 		}
-	}, { field(o) {
-		if (typeof o == "number") {
-			let t = i(a.readState().value, n);
-			if (t !== void 0 && !Array.isArray(t)) throw new e(`Cannot index ${o} because the current field value is not an array.`);
-			return c([...n, o], a);
+	}, { field(s) {
+		if (typeof s == "number") {
+			t(s);
+			let n = o(i.readState().value, r);
+			if (n !== void 0 && !Array.isArray(n)) throw new e(`Cannot index ${s} because the current field value is not an array.`);
+			return u([...r, s], i);
 		}
-		t(o);
-		let s = i(a.readState().value, n);
-		if (s !== void 0 && !r(s)) throw new e(`Cannot select '${o}' because the current field value is not an object.`);
-		return c([...n, o], a);
+		n(s);
+		let c = o(i.readState().value, r);
+		if (c !== void 0 && !a(c)) throw new e(`Cannot select '${s}' because the current field value is not an object.`);
+		return u([...r, s], i);
 	} });
 }
 //#endregion
-export { c as createField };
+export { u as createField };
 
 //# sourceMappingURL=_field.js.map

package/dist/_field.js.map

@@ -1 +1 @@
-{"version":3,"file":"_field.js","names":[],"sources":["../src/_field.ts"],"sourcesContent":["import { assertSafeKey, hasAtPath, isRecord, type MetaRoot, readAtPath, readError, readMeta } from './core/path';\nimport { ForgeConfigError } from './errors';\nimport type { Field, FieldState, ReadonlyDeep, SubscribeOptions, Unsubscribe } from './types';\n\nexport interface FieldAccess {\n  abortValidation(): void;\n  addListener(listener: () => void): Unsubscribe;\n  ensureActive(operation: string): void;\n  readState(): { baseline: unknown; errors: unknown; touched: MetaRoot; value: unknown };\n  resetValue(path: readonly (string | number)[]): void;\n  setTouched(path: readonly (string | number)[], touched: boolean): void;\n  setValue(path: readonly (string | number)[], next: unknown): void;\n}\n\nfunction makeFieldState<V>(\n  state: { baseline: unknown; errors: unknown; touched: MetaRoot; value: unknown },\n  path: readonly (string | number)[],\n): FieldState<V> {\n  const value = readAtPath<V>(state.value, path);\n  const baseline = readAtPath<V>(state.baseline, path);\n\n  return Object.freeze({\n    dirty: value !== baseline || hasAtPath(state.value, path) !== hasAtPath(state.baseline, path),\n    error: readError(state.errors, path),\n    touched: readMeta(state.touched, path),\n    value: value as ReadonlyDeep<V>,\n  });\n}\n\nexport function createField<V>(path: readonly (string | number)[], access: FieldAccess): Field<V> {\n  const common = {\n    get dirty() {\n      return makeFieldState<V>(access.readState(), path).dirty;\n    },\n    get error() {\n      return makeFieldState<V>(access.readState(), path).error;\n    },\n    reset() {\n      access.ensureActive('field().reset');\n      access.abortValidation();\n      access.resetValue(path);\n    },\n    set(next: V | ((previous: ReadonlyDeep<V>) => V)) {\n      access.ensureActive('field().set');\n      access.abortValidation();\n\n      const previous = readAtPath<V>(access.readState().value, path) as ReadonlyDeep<V>;\n      const value = typeof next === 'function' ? (next as (current: ReadonlyDeep<V>) => V)(previous) : next;\n\n      access.setValue(path, value);\n    },\n    get state() {\n      return makeFieldState<V>(access.readState(), path);\n    },\n    subscribe(listener: (state: FieldState<V>) => void, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n      access.ensureActive('field().subscribe');\n\n      let previous = makeFieldState<V>(access.readState(), path);\n\n      if (subscribeOptions.immediate) listener(previous);\n\n      const filtered = () => {\n        const next = makeFieldState<V>(access.readState(), path);\n\n        if (\n          next.value === previous.value &&\n          next.error === previous.error &&\n          next.touched === previous.touched &&\n          next.dirty === previous.dirty\n        ) {\n          return;\n        }\n\n        previous = next;\n        listener(next);\n      };\n\n      return access.addListener(filtered);\n    },\n    touch() {\n      access.ensureActive('field().touch');\n      access.setTouched(path, true);\n    },\n    get touched() {\n      return makeFieldState<V>(access.readState(), path).touched;\n    },\n    get value() {\n      return makeFieldState<V>(access.readState(), path).value;\n    },\n  };\n\n  return Object.assign(common, {\n    field(key: string | number): Field<unknown> {\n      if (typeof key === 'number') {\n        const currentVal = readAtPath(access.readState().value, path);\n\n        if (currentVal !== undefined && !Array.isArray(currentVal)) {\n          throw new ForgeConfigError(`Cannot index ${key} because the current field value is not an array.`);\n        }\n\n        return createField([...path, key], access);\n      }\n\n      assertSafeKey(key);\n\n      const currentVal = readAtPath(access.readState().value, path);\n\n      if (currentVal !== undefined && !isRecord(currentVal)) {\n        throw new ForgeConfigError(`Cannot select '${key}' because the current field value is not an object.`);\n      }\n\n      return createField([...path, key], access);\n    },\n  }) as unknown as Field<V>;\n}\n"],"mappings":";;;AAcA,SAAS,EACP,GACA,GACe;CACf,IAAM,IAAQ,EAAc,EAAM,OAAO,CAAI,GACvC,IAAW,EAAc,EAAM,UAAU,CAAI;CAEnD,OAAO,OAAO,OAAO;EACnB,OAAO,MAAU,KAAY,EAAU,EAAM,OAAO,CAAI,MAAM,EAAU,EAAM,UAAU,CAAI;EAC5F,OAAO,EAAU,EAAM,QAAQ,CAAI;EACnC,SAAS,EAAS,EAAM,SAAS,CAAI;EAC9B;CACT,CAAC;AACH;AAEA,SAAgB,EAAe,GAAoC,GAA+B;CA8DhG,OAAO,OAAO,OAAO;EA5DnB,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;EACA,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;EACA,QAAQ;GAGN,AAFA,EAAO,aAAa,eAAe,GACnC,EAAO,gBAAgB,GACvB,EAAO,WAAW,CAAI;EACxB;EACA,IAAI,GAA8C;GAEhD,AADA,EAAO,aAAa,aAAa,GACjC,EAAO,gBAAgB;GAEvB,IAAM,IAAW,EAAc,EAAO,UAAU,CAAC,CAAC,OAAO,CAAI,GACvD,IAAQ,OAAO,KAAS,aAAc,EAAyC,CAAQ,IAAI;GAEjG,EAAO,SAAS,GAAM,CAAK;EAC7B;EACA,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI;EACnD;EACA,UAAU,GAA0C,IAAqC,CAAC,GAAgB;GACxG,EAAO,aAAa,mBAAmB;GAEvC,IAAI,IAAW,EAAkB,EAAO,UAAU,GAAG,CAAI;GAoBzD,OAlBI,EAAiB,aAAW,EAAS,CAAQ,GAkB1C,EAAO,kBAhBS;IACrB,IAAM,IAAO,EAAkB,EAAO,UAAU,GAAG,CAAI;IAGrD,GAAK,UAAU,EAAS,SACxB,EAAK,UAAU,EAAS,SACxB,EAAK,YAAY,EAAS,WAC1B,EAAK,UAAU,EAAS,WAK1B,IAAW,GACX,EAAS,CAAI;GACf,CAEkC;EACpC;EACA,QAAQ;GAEN,AADA,EAAO,aAAa,eAAe,GACnC,EAAO,WAAW,GAAM,EAAI;EAC9B;EACA,IAAI,UAAU;GACZ,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;EACA,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;CAGmB,GAAQ,EAC3B,MAAM,GAAsC;EAC1C,IAAI,OAAO,KAAQ,UAAU;GAC3B,IAAM,IAAa,EAAW,EAAO,UAAU,CAAC,CAAC,OAAO,CAAI;GAE5D,IAAI,MAAe,KAAA,KAAa,CAAC,MAAM,QAAQ,CAAU,GACvD,MAAM,IAAI,EAAiB,gBAAgB,EAAI,kDAAkD;GAGnG,OAAO,EAAY,CAAC,GAAG,GAAM,CAAG,GAAG,CAAM;EAC3C;EAEA,EAAc,CAAG;EAEjB,IAAM,IAAa,EAAW,EAAO,UAAU,CAAC,CAAC,OAAO,CAAI;EAE5D,IAAI,MAAe,KAAA,KAAa,CAAC,EAAS,CAAU,GAClD,MAAM,IAAI,EAAiB,kBAAkB,EAAI,oDAAoD;EAGvG,OAAO,EAAY,CAAC,GAAG,GAAM,CAAG,GAAG,CAAM;CAC3C,EACF,CAAC;AACH"}
+{"version":3,"file":"_field.js","names":[],"sources":["../src/_field.ts"],"sourcesContent":["import { isEqual } from '@vielzeug/arsenal';\n\nimport {\n  assertArrayIndex,\n  assertSafeKey,\n  findIssue,\n  hasAtPath,\n  isRecord,\n  type MetaRoot,\n  readAtPath,\n  readMeta,\n} from './core/path.js';\nimport { ForgeConfigError } from './errors.js';\nimport type { Field, FieldState, SubscribeOptions, Unsubscribe, ValidationIssue } from './types.js';\n\ntype FieldSourceState = {\n  baseline: unknown;\n  issues: readonly ValidationIssue[] | undefined;\n  touched: MetaRoot;\n  value: unknown;\n};\n\nexport interface FieldAccess {\n  abortValidation(): void;\n  addListener(listener: (state: FieldSourceState) => void): Unsubscribe;\n  ensureActive(operation: string): void;\n  invokeListener(listener: () => void): void;\n  readState(): FieldSourceState;\n  resetValue(path: readonly (string | number)[]): void;\n  setTouched(path: readonly (string | number)[], touched: boolean): void;\n  setValue(path: readonly (string | number)[], next: unknown | ((previous: unknown) => unknown)): void;\n}\n\nfunction makeFieldState<V>(state: FieldSourceState, path: readonly (string | number)[]): FieldState<V> {\n  const value = readAtPath<V>(state.value, path);\n  const baseline = readAtPath<V>(state.baseline, path);\n\n  return Object.freeze({\n    dirty: !isEqual(value, baseline) || hasAtPath(state.value, path) !== hasAtPath(state.baseline, path),\n    error: findIssue(state.issues, path),\n    touched: readMeta(state.touched, path),\n    value: value as FieldState<V>['value'],\n  });\n}\n\nexport function createField<V>(path: readonly (string | number)[], access: FieldAccess): Field<V> {\n  const common = {\n    get dirty() {\n      return makeFieldState<V>(access.readState(), path).dirty;\n    },\n    get error() {\n      return makeFieldState<V>(access.readState(), path).error;\n    },\n    reset() {\n      access.ensureActive('field().reset');\n      access.abortValidation();\n      access.resetValue(path);\n    },\n    set(next: V | ((previous: FieldState<V>['value']) => V)) {\n      access.ensureActive('field().set');\n      access.abortValidation();\n\n      access.setValue(path, next as unknown | ((previous: unknown) => unknown));\n    },\n    get state() {\n      return makeFieldState<V>(access.readState(), path);\n    },\n    subscribe(listener: (state: FieldState<V>) => void, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n      access.ensureActive('field().subscribe');\n\n      let previous = makeFieldState<V>(access.readState(), path);\n\n      if (subscribeOptions.immediate) access.invokeListener(() => listener(previous));\n\n      const filtered = (state: FieldSourceState) => {\n        const next = makeFieldState<V>(state, path);\n\n        if (\n          next.value === previous.value &&\n          next.error === previous.error &&\n          next.touched === previous.touched &&\n          next.dirty === previous.dirty\n        ) {\n          return;\n        }\n\n        previous = next;\n        listener(next);\n      };\n\n      return access.addListener(filtered);\n    },\n    touch() {\n      access.ensureActive('field().touch');\n      access.setTouched(path, true);\n    },\n    get touched() {\n      return makeFieldState<V>(access.readState(), path).touched;\n    },\n    get value() {\n      return makeFieldState<V>(access.readState(), path).value;\n    },\n  };\n\n  return Object.assign(common, {\n    field(key: string | number): Field<unknown> {\n      if (typeof key === 'number') {\n        assertArrayIndex(key);\n        const currentVal = readAtPath(access.readState().value, path);\n\n        if (currentVal !== undefined && !Array.isArray(currentVal)) {\n          throw new ForgeConfigError(`Cannot index ${key} because the current field value is not an array.`);\n        }\n\n        return createField([...path, key], access);\n      }\n\n      assertSafeKey(key);\n\n      const currentVal = readAtPath(access.readState().value, path);\n\n      if (currentVal !== undefined && !isRecord(currentVal)) {\n        throw new ForgeConfigError(`Cannot select '${key}' because the current field value is not an object.`);\n      }\n\n      return createField([...path, key], access);\n    },\n  }) as unknown as Field<V>;\n}\n"],"mappings":";;;;AAiCA,SAAS,EAAkB,GAAyB,GAAmD;CACrG,IAAM,IAAQ,EAAc,EAAM,OAAO,CAAI,GACvC,IAAW,EAAc,EAAM,UAAU,CAAI;CAEnD,OAAO,OAAO,OAAO;EACnB,OAAO,CAAC,EAAQ,GAAO,CAAQ,KAAK,EAAU,EAAM,OAAO,CAAI,MAAM,EAAU,EAAM,UAAU,CAAI;EACnG,OAAO,EAAU,EAAM,QAAQ,CAAI;EACnC,SAAS,EAAS,EAAM,SAAS,CAAI;EAC9B;CACT,CAAC;AACH;AAEA,SAAgB,EAAe,GAAoC,GAA+B;CA2DhG,OAAO,OAAO,OAAO;EAzDnB,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;EACA,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;EACA,QAAQ;GAGN,AAFA,EAAO,aAAa,eAAe,GACnC,EAAO,gBAAgB,GACvB,EAAO,WAAW,CAAI;EACxB;EACA,IAAI,GAAqD;GAIvD,AAHA,EAAO,aAAa,aAAa,GACjC,EAAO,gBAAgB,GAEvB,EAAO,SAAS,GAAM,CAAkD;EAC1E;EACA,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI;EACnD;EACA,UAAU,GAA0C,IAAqC,CAAC,GAAgB;GACxG,EAAO,aAAa,mBAAmB;GAEvC,IAAI,IAAW,EAAkB,EAAO,UAAU,GAAG,CAAI;GAoBzD,OAlBI,EAAiB,aAAW,EAAO,qBAAqB,EAAS,CAAQ,CAAC,GAkBvE,EAAO,aAhBI,MAA4B;IAC5C,IAAM,IAAO,EAAkB,GAAO,CAAI;IAGxC,GAAK,UAAU,EAAS,SACxB,EAAK,UAAU,EAAS,SACxB,EAAK,YAAY,EAAS,WAC1B,EAAK,UAAU,EAAS,WAK1B,IAAW,GACX,EAAS,CAAI;GACf,CAEkC;EACpC;EACA,QAAQ;GAEN,AADA,EAAO,aAAa,eAAe,GACnC,EAAO,WAAW,GAAM,EAAI;EAC9B;EACA,IAAI,UAAU;GACZ,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;EACA,IAAI,QAAQ;GACV,OAAO,EAAkB,EAAO,UAAU,GAAG,CAAI,CAAC,CAAC;EACrD;CAGmB,GAAQ,EAC3B,MAAM,GAAsC;EAC1C,IAAI,OAAO,KAAQ,UAAU;GAC3B,EAAiB,CAAG;GACpB,IAAM,IAAa,EAAW,EAAO,UAAU,CAAC,CAAC,OAAO,CAAI;GAE5D,IAAI,MAAe,KAAA,KAAa,CAAC,MAAM,QAAQ,CAAU,GACvD,MAAM,IAAI,EAAiB,gBAAgB,EAAI,kDAAkD;GAGnG,OAAO,EAAY,CAAC,GAAG,GAAM,CAAG,GAAG,CAAM;EAC3C;EAEA,EAAc,CAAG;EAEjB,IAAM,IAAa,EAAW,EAAO,UAAU,CAAC,CAAC,OAAO,CAAI;EAE5D,IAAI,MAAe,KAAA,KAAa,CAAC,EAAS,CAAU,GAClD,MAAM,IAAI,EAAiB,kBAAkB,EAAI,oDAAoD;EAGvG,OAAO,EAAY,CAAC,GAAG,GAAM,CAAG,GAAG,CAAM;CAC3C,EACF,CAAC;AACH"}

package/dist/_notify.cjs

@@ -1,2 +1,2 @@
-function e(e){queueMicrotask(()=>{throw e})}function t(t){let n=new Set;function r(n){if(!t){e(n);return}try{t(n)}catch(t){e(t)}}return{add(e){return n.add(e),()=>n.delete(e)},clear(){n.clear()},notify(){for(let e of[...n])try{e()}catch(e){r(e)}}}}exports.createNotifier=t;
+function e(e){queueMicrotask(()=>{throw e})}function t(t){let n=new Set,r=[],i=!1;function a(n){if(!t){e(n);return}try{t(n)}catch(t){e(t)}}let o=e=>{try{e()}catch(e){a(e)}};return{add(e){return n.add(e),()=>n.delete(e)},call:o,clear(){n.clear(),r.length=0},notify(e){if(r.push(e),!i){i=!0;try{for(;r.length>0;){let e=r.shift();for(let t of[...n])n.has(t)&&o(()=>t(e))}}finally{i=!1}}}}}exports.createNotifier=t;
 //# sourceMappingURL=_notify.cjs.map

package/dist/_notify.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_notify.cjs","names":[],"sources":["../src/_notify.ts"],"sourcesContent":["import type { Unsubscribe } from './types';\n\nexport interface Notifier {\n  add(listener: () => void): Unsubscribe;\n  clear(): void;\n  notify(): void;\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error;\n  });\n}\n\nexport function createNotifier(onError?: (error: unknown) => void): Notifier {\n  const listeners = new Set<() => void>();\n\n  function reportError(error: unknown): void {\n    if (!onError) {\n      rethrowAsync(error);\n\n      return;\n    }\n\n    try {\n      onError(error);\n    } catch (reporterError) {\n      rethrowAsync(reporterError);\n    }\n  }\n\n  return {\n    add(listener) {\n      listeners.add(listener);\n\n      return () => listeners.delete(listener);\n    },\n    clear() {\n      listeners.clear();\n    },\n    notify() {\n      for (const listener of [...listeners]) {\n        try {\n          listener();\n        } catch (error) {\n          reportError(error);\n        }\n      }\n    },\n  };\n}\n"],"mappings":"AAQA,SAAS,EAAa,EAAsB,CAC1C,mBAAqB,CACnB,MAAM,CACR,CAAC,CACH,CAEA,SAAgB,EAAe,EAA8C,CAC3E,IAAM,EAAY,IAAI,IAEtB,SAAS,EAAY,EAAsB,CACzC,GAAI,CAAC,EAAS,CACZ,EAAa,CAAK,EAElB,MACF,CAEA,GAAI,CACF,EAAQ,CAAK,CACf,OAAS,EAAe,CACtB,EAAa,CAAa,CAC5B,CACF,CAEA,MAAO,CACL,IAAI,EAAU,CAGZ,OAFA,EAAU,IAAI,CAAQ,MAET,EAAU,OAAO,CAAQ,CACxC,EACA,OAAQ,CACN,EAAU,MAAM,CAClB,EACA,QAAS,CACP,IAAK,IAAM,IAAY,CAAC,GAAG,CAAS,EAClC,GAAI,CACF,EAAS,CACX,OAAS,EAAO,CACd,EAAY,CAAK,CACnB,CAEJ,CACF,CACF"}
+{"version":3,"file":"_notify.cjs","names":[],"sources":["../src/_notify.ts"],"sourcesContent":["import type { Unsubscribe } from './types.js';\n\nexport interface Notifier<T> {\n  add(listener: (value: T) => void): Unsubscribe;\n  call(listener: () => void): void;\n  clear(): void;\n  notify(value: T): void;\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error;\n  });\n}\n\nexport function createNotifier<T>(onError?: (error: unknown) => void): Notifier<T> {\n  const listeners = new Set<(value: T) => void>();\n  const pending: T[] = [];\n  let notifying = false;\n\n  function reportError(error: unknown): void {\n    if (!onError) {\n      rethrowAsync(error);\n      return;\n    }\n\n    try {\n      onError(error);\n    } catch (reporterError) {\n      rethrowAsync(reporterError);\n    }\n  }\n\n  const call = (listener: () => void): void => {\n    try {\n      listener();\n    } catch (error) {\n      reportError(error);\n    }\n  };\n\n  return {\n    add(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    call,\n    clear() {\n      listeners.clear();\n      pending.length = 0;\n    },\n    notify(value) {\n      pending.push(value);\n      if (notifying) return;\n\n      notifying = true;\n      try {\n        while (pending.length > 0) {\n          const next = pending.shift()!;\n          for (const listener of [...listeners]) {\n            if (listeners.has(listener)) call(() => listener(next));\n          }\n        }\n      } finally {\n        notifying = false;\n      }\n    },\n  };\n}\n"],"mappings":"AASA,SAAS,EAAa,EAAsB,CAC1C,mBAAqB,CACnB,MAAM,CACR,CAAC,CACH,CAEA,SAAgB,EAAkB,EAAiD,CACjF,IAAM,EAAY,IAAI,IAChB,EAAe,CAAC,EAClB,EAAY,GAEhB,SAAS,EAAY,EAAsB,CACzC,GAAI,CAAC,EAAS,CACZ,EAAa,CAAK,EAClB,MACF,CAEA,GAAI,CACF,EAAQ,CAAK,CACf,OAAS,EAAe,CACtB,EAAa,CAAa,CAC5B,CACF,CAEA,IAAM,EAAQ,GAA+B,CAC3C,GAAI,CACF,EAAS,CACX,OAAS,EAAO,CACd,EAAY,CAAK,CACnB,CACF,EAEA,MAAO,CACL,IAAI,EAAU,CAEZ,OADA,EAAU,IAAI,CAAQ,MACT,EAAU,OAAO,CAAQ,CACxC,EACA,OACA,OAAQ,CACN,EAAU,MAAM,EAChB,EAAQ,OAAS,CACnB,EACA,OAAO,EAAO,CACZ,KAAQ,KAAK,CAAK,EACd,GAEJ,GAAY,GACZ,GAAI,CACF,KAAO,EAAQ,OAAS,GAAG,CACzB,IAAM,EAAO,EAAQ,MAAM,EAC3B,IAAK,IAAM,IAAY,CAAC,GAAG,CAAS,EAC9B,EAAU,IAAI,CAAQ,GAAG,MAAW,EAAS,CAAI,CAAC,CAE1D,CACF,QAAU,CACR,EAAY,EACd,CAVY,CAWd,CACF,CACF"}

package/dist/_notify.d.ts

@@ -1,8 +1,9 @@
-import type { Unsubscribe } from './types';
-export interface Notifier {
-    add(listener: () => void): Unsubscribe;
+import type { Unsubscribe } from './types.js';
+export interface Notifier<T> {
+    add(listener: (value: T) => void): Unsubscribe;
+    call(listener: () => void): void;
     clear(): void;
-    notify(): void;
+    notify(value: T): void;
 }
-export declare function createNotifier(onError?: (error: unknown) => void): Notifier;
+export declare function createNotifier<T>(onError?: (error: unknown) => void): Notifier<T>;
 //# sourceMappingURL=_notify.d.ts.map

package/dist/_notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_notify.d.ts","sourceRoot":"","sources":["../src/_notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IACvC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;CAChB;AAQD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,QAAQ,CAoC3E"}
+{"version":3,"file":"_notify.d.ts","sourceRoot":"","sources":["../src/_notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IAC/C,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACxB;AAQD,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAqDjF"}

package/dist/_notify.js

@@ -5,8 +5,8 @@ function e(e) {
 	});
 }
 function t(t) {
-	let n = /* @__PURE__ */ new Set();
-	function r(n) {
+	let n = /* @__PURE__ */ new Set(), r = [], i = !1;
+	function a(n) {
 		if (!t) {
 			e(n);
 			return;
@@ -17,18 +17,32 @@ function t(t) {
 			e(t);
 		}
 	}
+	let o = (e) => {
+		try {
+			e();
+		} catch (e) {
+			a(e);
+		}
+	};
 	return {
 		add(e) {
 			return n.add(e), () => n.delete(e);
 		},
+		call: o,
 		clear() {
-			n.clear();
+			n.clear(), r.length = 0;
 		},
-		notify() {
-			for (let e of [...n]) try {
-				e();
-			} catch (e) {
-				r(e);
+		notify(e) {
+			if (r.push(e), !i) {
+				i = !0;
+				try {
+					for (; r.length > 0;) {
+						let e = r.shift();
+						for (let t of [...n]) n.has(t) && o(() => t(e));
+					}
+				} finally {
+					i = !1;
+				}
 			}
 		}
 	};

package/dist/_notify.js.map

@@ -1 +1 @@
-{"version":3,"file":"_notify.js","names":[],"sources":["../src/_notify.ts"],"sourcesContent":["import type { Unsubscribe } from './types';\n\nexport interface Notifier {\n  add(listener: () => void): Unsubscribe;\n  clear(): void;\n  notify(): void;\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error;\n  });\n}\n\nexport function createNotifier(onError?: (error: unknown) => void): Notifier {\n  const listeners = new Set<() => void>();\n\n  function reportError(error: unknown): void {\n    if (!onError) {\n      rethrowAsync(error);\n\n      return;\n    }\n\n    try {\n      onError(error);\n    } catch (reporterError) {\n      rethrowAsync(reporterError);\n    }\n  }\n\n  return {\n    add(listener) {\n      listeners.add(listener);\n\n      return () => listeners.delete(listener);\n    },\n    clear() {\n      listeners.clear();\n    },\n    notify() {\n      for (const listener of [...listeners]) {\n        try {\n          listener();\n        } catch (error) {\n          reportError(error);\n        }\n      }\n    },\n  };\n}\n"],"mappings":";AAQA,SAAS,EAAa,GAAsB;CAC1C,qBAAqB;EACnB,MAAM;CACR,CAAC;AACH;AAEA,SAAgB,EAAe,GAA8C;CAC3E,IAAM,oBAAY,IAAI,IAAgB;CAEtC,SAAS,EAAY,GAAsB;EACzC,IAAI,CAAC,GAAS;GACZ,EAAa,CAAK;GAElB;EACF;EAEA,IAAI;GACF,EAAQ,CAAK;EACf,SAAS,GAAe;GACtB,EAAa,CAAa;EAC5B;CACF;CAEA,OAAO;EACL,IAAI,GAAU;GAGZ,OAFA,EAAU,IAAI,CAAQ,SAET,EAAU,OAAO,CAAQ;EACxC;EACA,QAAQ;GACN,EAAU,MAAM;EAClB;EACA,SAAS;GACP,KAAK,IAAM,KAAY,CAAC,GAAG,CAAS,GAClC,IAAI;IACF,EAAS;GACX,SAAS,GAAO;IACd,EAAY,CAAK;GACnB;EAEJ;CACF;AACF"}
+{"version":3,"file":"_notify.js","names":[],"sources":["../src/_notify.ts"],"sourcesContent":["import type { Unsubscribe } from './types.js';\n\nexport interface Notifier<T> {\n  add(listener: (value: T) => void): Unsubscribe;\n  call(listener: () => void): void;\n  clear(): void;\n  notify(value: T): void;\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error;\n  });\n}\n\nexport function createNotifier<T>(onError?: (error: unknown) => void): Notifier<T> {\n  const listeners = new Set<(value: T) => void>();\n  const pending: T[] = [];\n  let notifying = false;\n\n  function reportError(error: unknown): void {\n    if (!onError) {\n      rethrowAsync(error);\n      return;\n    }\n\n    try {\n      onError(error);\n    } catch (reporterError) {\n      rethrowAsync(reporterError);\n    }\n  }\n\n  const call = (listener: () => void): void => {\n    try {\n      listener();\n    } catch (error) {\n      reportError(error);\n    }\n  };\n\n  return {\n    add(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    call,\n    clear() {\n      listeners.clear();\n      pending.length = 0;\n    },\n    notify(value) {\n      pending.push(value);\n      if (notifying) return;\n\n      notifying = true;\n      try {\n        while (pending.length > 0) {\n          const next = pending.shift()!;\n          for (const listener of [...listeners]) {\n            if (listeners.has(listener)) call(() => listener(next));\n          }\n        }\n      } finally {\n        notifying = false;\n      }\n    },\n  };\n}\n"],"mappings":";AASA,SAAS,EAAa,GAAsB;CAC1C,qBAAqB;EACnB,MAAM;CACR,CAAC;AACH;AAEA,SAAgB,EAAkB,GAAiD;CACjF,IAAM,oBAAY,IAAI,IAAwB,GACxC,IAAe,CAAC,GAClB,IAAY;CAEhB,SAAS,EAAY,GAAsB;EACzC,IAAI,CAAC,GAAS;GACZ,EAAa,CAAK;GAClB;EACF;EAEA,IAAI;GACF,EAAQ,CAAK;EACf,SAAS,GAAe;GACtB,EAAa,CAAa;EAC5B;CACF;CAEA,IAAM,KAAQ,MAA+B;EAC3C,IAAI;GACF,EAAS;EACX,SAAS,GAAO;GACd,EAAY,CAAK;EACnB;CACF;CAEA,OAAO;EACL,IAAI,GAAU;GAEZ,OADA,EAAU,IAAI,CAAQ,SACT,EAAU,OAAO,CAAQ;EACxC;EACA;EACA,QAAQ;GAEN,AADA,EAAU,MAAM,GAChB,EAAQ,SAAS;EACnB;EACA,OAAO,GAAO;GACZ,MAAQ,KAAK,CAAK,GACd,IAEJ;QAAY;IACZ,IAAI;KACF,OAAO,EAAQ,SAAS,IAAG;MACzB,IAAM,IAAO,EAAQ,MAAM;MAC3B,KAAK,IAAM,KAAY,CAAC,GAAG,CAAS,GAClC,AAAI,EAAU,IAAI,CAAQ,KAAG,QAAW,EAAS,CAAI,CAAC;KAE1D;IACF,UAAU;KACR,IAAY;IACd;GAVY;EAWd;CACF;AACF"}

package/dist/core/path.cjs

@@ -1,2 +1,2 @@
-const e=require("../errors.cjs");var t=new Set([`__proto__`,`constructor`,`prototype`]);function n(e){return!e||t.has(e)}function r(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function i(t){if(n(t))throw new e.ForgeConfigError(`Invalid field key '${t}'.`)}function a(e){return typeof Blob<`u`&&e instanceof Blob||typeof File<`u`&&e instanceof File||e instanceof Date}function o(t){if(Array.isArray(t))return Object.freeze(t.map(o));if(typeof t!=`object`||!t||a(t))return t;if(!r(t))throw new e.ForgeConfigError(`Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.`);return Object.freeze(Object.fromEntries(Object.entries(t).map(([e,t])=>[e,o(t)])))}function s(e,t){let n=e;for(let e of t)if(typeof e==`number`){if(!Array.isArray(n)||e<0||e>=n.length)return;n=n[e]}else{if(!r(n)||!Object.hasOwn(n,e))return;n=n[e]}return n}function c(e,t){let n=e;for(let e of t)if(typeof e==`number`){if(!Array.isArray(n)||e<0||e>=n.length)return!1;n=n[e]}else{if(!r(n)||!Object.hasOwn(n,e))return!1;n=n[e]}return!0}function l(t,n,a){let[s,...c]=n;if(typeof s==`number`){if(!Array.isArray(t))throw new e.ForgeConfigError(`Cannot index ${s} because the current value is not an array.`);if(s<0||s>=t.length)throw new e.ForgeConfigError(`Index ${s} is out of range for array of length ${t.length}.`);if(c.length===0){let e=[...t];return e[s]=o(a),Object.freeze(e)}let n=[...t];return n[s]=l(t[s],c,a),Object.freeze(n)}if(i(s),!r(t))throw new e.ForgeConfigError(`Cannot select '${s}' because the current value is not an object.`);if(c.length===0)return Object.freeze({...t,[s]:o(a)});let u=t[s];if(u!==void 0&&!r(u)&&!Array.isArray(u))throw new e.ForgeConfigError(`Cannot select '${s}' because it is not an object or array.`);let d=u??{};return Object.freeze({...t,[s]:l(d,c,a)})}function u(e,t,n){let[i,...a]=n;if(typeof i==`number`){if(!Array.isArray(e)||!Array.isArray(t)||i>=t.length||i>=e.length)return e;if(a.length===0){let n=[...e];return n[i]=t[i],Object.freeze(n)}let n=[...e];return n[i]=u(e[i],t[i],a),Object.freeze(n)}if(!r(e))return e;if(a.length===0){if(Object.hasOwn(t,i))return Object.freeze({...e,[i]:t[i]});let{[i]:n,...r}=e;return Object.freeze(r)}let o=t[i];if(!r(o)&&!Array.isArray(o)){if(Object.hasOwn(t,i))return Object.freeze({...e,[i]:o});let{[i]:n,...r}=e;return Object.freeze(r)}let s=e[i],c=r(s)||Array.isArray(s)?s:{};return Object.freeze({...e,[i]:u(c,o,a)})}function d(e,t,n){let[i,...a]=t,o=String(i),s={...e};if(a.length===0)n?s[o]=!0:delete s[o];else{let t=d(r(e[o])?e[o]:{},a,n);Object.keys(t).length===0?delete s[o]:s[o]=t}return Object.freeze(s)}function f(e,t){let n=e;for(let e of t){let t=String(e);if(!r(n)||!Object.hasOwn(n,t))return!1;n=n[t]}return n===!0}function p(e){return Array.isArray(e)?Object.freeze(Object.fromEntries(e.map((e,t)=>[String(t),r(e)||Array.isArray(e)?p(e):!0]))):r(e)?Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>[e,r(t)||Array.isArray(t)?p(t):!0]))):{}}function m(e,t){let n=s(e,t);return typeof n==`string`?n:void 0}function h(e,t,i){let[a,...o]=t;if(typeof a==`number`){let t=Array.isArray(e)?[...e]:[];return o.length===0?t[a]===void 0&&(t[a]=i):t[a]=h(t[a],o,i),t}if(n(a))return e??{};let s=r(e)?{...e}:{};return o.length===0?s[a]===void 0&&(s[a]=i):s[a]=h(s[a],o,i),s}function g(e,t,n){let i=h(e,t,n);return r(i)?i:e}function _(e){if(typeof e==`string`)return e;if(Array.isArray(e)){let t=e.map(e=>_(e));return t.every(e=>e===void 0)?void 0:Object.freeze(t)}if(!r(e))return;let t=Object.entries(e).map(([e,t])=>[e,_(t)]).filter(([,e])=>e!==void 0);return t.length===0?void 0:Object.freeze(Object.fromEntries(t))}exports.assertSafeKey=i,exports.hasAtPath=c,exports.immutable=o,exports.isRecord=r,exports.isUnsafeKey=n,exports.normalizeErrors=_,exports.readAtPath=s,exports.readError=m,exports.readMeta=f,exports.resetAtPath=u,exports.touchAll=p,exports.writeAtPath=l,exports.writeError=g,exports.writeMeta=d;
+const e=require("../errors.cjs");let t=require("@vielzeug/arsenal");var n=new Set([`__proto__`,`constructor`,`prototype`]);function r(e){return!e||n.has(e)}function i(t){if(r(t))throw new e.ForgeConfigError(`Invalid field key '${t}'.`)}function a(t){if(!Number.isSafeInteger(t)||t<0)throw new e.ForgeConfigError(`Invalid array index ${t}.`)}function o(e){return Object.prototype.toString.call(e)}function s(e){return o(e)===`[object Blob]`||o(e)===`[object File]`}function c(){throw new e.ForgeConfigError(`Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob.`)}function l(n,r=new Set){if(n==null||typeof n==`string`||typeof n==`boolean`)return n;if(typeof n==`number`)return Number.isFinite(n)?n:c();if(typeof n!=`object`)return c();let a=n;if(o(n)===`[object Date]`&&typeof a.getTime==`function`){let e=a.getTime();return Number.isFinite(e)?Object.freeze(new Date(e)):c()}if(s(n))return n;if(r.has(n))throw new e.ForgeConfigError(`Form values must not contain circular references.`);r.add(n);try{if(Array.isArray(n)){let t=[];for(let i=0;i<n.length;i++){if(!Object.hasOwn(n,i))throw new e.ForgeConfigError(`Form arrays must not contain empty slots.`);t.push(l(n[i],r))}return Object.freeze(t)}if(!(0,t.isPlainObject)(n))return c();let a=Object.entries(n).map(([e,t])=>(i(e),[e,l(t,r)]));return Object.freeze(Object.fromEntries(a))}finally{r.delete(n)}}function u(e,n){let r=e;for(let e of n)if(typeof e==`number`){if(!Array.isArray(r)||!Number.isSafeInteger(e)||e<0||e>=r.length||!Object.hasOwn(r,e))return;r=r[e]}else{if(!(0,t.isPlainObject)(r)||!Object.hasOwn(r,e))return;r=r[e]}return r}function d(e,n){let r=e;for(let e of n)if(typeof e==`number`){if(!Array.isArray(r)||!Number.isSafeInteger(e)||e<0||e>=r.length||!Object.hasOwn(r,e))return!1;r=r[e]}else{if(!(0,t.isPlainObject)(r)||!Object.hasOwn(r,e))return!1;r=r[e]}return!0}function f(n,r,o){let[s,...c]=r;if(typeof s==`number`){if(a(s),!Array.isArray(n))throw new e.ForgeConfigError(`Cannot index ${s} because the current value is not an array.`);if(s<0||s>=n.length)throw new e.ForgeConfigError(`Index ${s} is out of range for array of length ${n.length}.`);if(c.length===0){let e=[...n];return e[s]=l(o),Object.freeze(e)}let t=[...n];return t[s]=f(n[s],c,o),Object.freeze(t)}if(i(s),!(0,t.isPlainObject)(n))throw new e.ForgeConfigError(`Cannot select '${s}' because the current value is not an object.`);if(c.length===0)return Object.freeze({...n,[s]:l(o)});let u=n[s];if(u!==void 0&&!(0,t.isPlainObject)(u)&&!Array.isArray(u))throw new e.ForgeConfigError(`Cannot select '${s}' because it is not an object or array.`);let d=u??{};return Object.freeze({...n,[s]:f(d,c,o)})}function p(e,n,r){let[i,...o]=r;if(typeof i==`number`){if(a(i),!Array.isArray(e)||!Array.isArray(n)||i>=n.length||i>=e.length)return e;if(o.length===0){let t=[...e];return t[i]=n[i],Object.freeze(t)}let t=[...e];return t[i]=p(e[i],n[i],o),Object.freeze(t)}if(!(0,t.isPlainObject)(e))return e;if(o.length===0){if(Object.hasOwn(n,i))return Object.freeze({...e,[i]:n[i]});let{[i]:t,...r}=e;return Object.freeze(r)}let s=n[i];if(!(0,t.isPlainObject)(s)&&!Array.isArray(s)){if(Object.hasOwn(n,i))return Object.freeze({...e,[i]:s});let{[i]:t,...r}=e;return Object.freeze(r)}let c=e[i],l=(0,t.isPlainObject)(c)||Array.isArray(c)?c:{};return Object.freeze({...e,[i]:p(l,s,o)})}function m(e,n,r){let[i,...o]=n;typeof i==`number`&&a(i);let s=String(i),c={...e};if(o.length===0)r?c[s]=!0:delete c[s];else{let n=m((0,t.isPlainObject)(e[s])?e[s]:{},o,r);Object.keys(n).length===0?delete c[s]:c[s]=n}return Object.freeze(c)}function h(e,n){let r=e;for(let e of n){if(typeof e==`number`&&(!Number.isSafeInteger(e)||e<0))return!1;let n=String(e);if(!(0,t.isPlainObject)(r)||!Object.hasOwn(r,n))return!1;r=r[n]}return r===!0}function g(e){return Array.isArray(e)?Object.freeze(Object.fromEntries(e.map((e,n)=>[String(n),(0,t.isPlainObject)(e)||Array.isArray(e)?g(e):!0]))):(0,t.isPlainObject)(e)?Object.freeze(Object.fromEntries(Object.entries(e).map(([e,n])=>[e,(0,t.isPlainObject)(n)||Array.isArray(n)?g(n):!0]))):{}}function _(e,t){if(e.length!==t.length)return!1;for(let n=0;n<e.length;n++)if(e[n]!==t[n])return!1;return!0}function v(e,t){if(e){for(let n of e)if(_(n.path,t))return n.message}}exports.assertArrayIndex=a,exports.assertSafeKey=i,exports.findIssue=v,exports.hasAtPath=d,exports.immutable=l,exports.isRecord=t.isPlainObject,exports.isUnsafeKey=r,exports.pathEquals=_,exports.readAtPath=u,exports.readMeta=h,exports.resetAtPath=p,exports.touchAll=g,exports.writeAtPath=f,exports.writeMeta=m;
 //# sourceMappingURL=path.cjs.map

package/dist/core/path.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"path.cjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["import { ForgeConfigError } from '../errors';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport function isUnsafeKey(key: string): boolean {\n  return !key || unsafeKeys.has(key);\n}\n\ntype ErrorNode = string | ErrorTree | ErrorArray;\nexport interface ErrorTree {\n  readonly [key: string]: ErrorNode;\n}\ntype ErrorArray = ErrorNode[];\ntype MutableErrorTree = Record<string, ErrorNode>;\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n  readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function isRecord(value: unknown): value is RecordValue {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\nexport function assertSafeKey(key: string): void {\n  if (isUnsafeKey(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nfunction isAtomicLeaf(value: unknown): boolean {\n  return (\n    (typeof Blob !== 'undefined' && value instanceof Blob) ||\n    (typeof File !== 'undefined' && value instanceof File) ||\n    value instanceof Date\n  );\n}\n\nexport function immutable<T>(value: T): T {\n  if (Array.isArray(value)) return Object.freeze(value.map(immutable)) as T;\n\n  if (value === null || typeof value !== 'object' || isAtomicLeaf(value)) return value;\n\n  if (!isRecord(value)) {\n    throw new ForgeConfigError(\n      'Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.',\n    );\n  }\n\n  return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, child]) => [key, immutable(child)]))) as T;\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (!Array.isArray(current) || key < 0 || key >= current.length) return undefined;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n      current = current[key];\n    }\n  }\n\n  return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (!Array.isArray(current) || key < 0 || key >= current.length) return false;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n      current = current[key];\n    }\n  }\n\n  return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    if (!Array.isArray(value)) {\n      throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n    }\n\n    if (key < 0 || key >= value.length) {\n      throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n    }\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = immutable(next);\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = writeAtPath(value[key] as TreeValue, rest, next);\n\n    return Object.freeze(copy) as T;\n  }\n\n  assertSafeKey(key);\n\n  if (!isRecord(value)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n  }\n\n  if (rest.length === 0) return Object.freeze({ ...value, [key]: immutable(next) }) as T;\n\n  const child = value[key];\n\n  if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n  }\n\n  const childTree = (child ?? {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    if (!Array.isArray(value)) return value;\n    if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = baseline[key];\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n    return Object.freeze(copy) as T;\n  }\n\n  if (!isRecord(value)) return value;\n\n  if (rest.length === 0) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const baselineChild = (baseline as RecordValue)[key];\n\n  if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const currentChild = value[key];\n  const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n  const [key, ...rest] = path;\n  const stringKey = String(key);\n  const copy: Record<string, MetaTree> = { ...meta };\n\n  if (rest.length === 0) {\n    if (next) copy[stringKey] = true;\n    else delete copy[stringKey];\n  } else {\n    const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n    const updated = writeMeta(child, rest, next);\n\n    if (Object.keys(updated).length === 0) delete copy[stringKey];\n    else copy[stringKey] = updated;\n  }\n\n  return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n  let current: MetaTree | undefined = meta;\n\n  for (const key of path) {\n    const stringKey = String(key);\n\n    if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n    current = current[stringKey] as MetaTree;\n  }\n\n  return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n  if (Array.isArray(value)) {\n    return Object.freeze(\n      Object.fromEntries(\n        value.map((child, i) => [\n          String(i),\n          isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n        ]),\n      ),\n    );\n  }\n\n  if (!isRecord(value)) return {};\n\n  return Object.freeze(\n    Object.fromEntries(\n      Object.entries(value).map(([key, child]) => [\n        key,\n        isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n      ]),\n    ),\n  );\n}\n\nexport function readError(errors: unknown, path: readonly (string | number)[]): string | undefined {\n  const error = readAtPath(errors, path);\n\n  return typeof error === 'string' ? error : undefined;\n}\n\nfunction writeErrorNode(\n  node: ErrorTree | ErrorArray | undefined,\n  path: readonly (string | number)[],\n  message: string,\n): ErrorTree | ErrorArray {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    const arr: ErrorNode[] = Array.isArray(node) ? [...node] : [];\n\n    if (rest.length === 0) {\n      if (arr[key] === undefined) arr[key] = message;\n    } else {\n      arr[key] = writeErrorNode(arr[key] as ErrorTree | ErrorArray | undefined, rest, message);\n    }\n\n    return arr;\n  }\n\n  if (isUnsafeKey(key)) return node ?? {};\n\n  const record: MutableErrorTree = isRecord(node) ? { ...node } : {};\n\n  if (rest.length === 0) {\n    if (record[key] === undefined) record[key] = message;\n  } else {\n    record[key] = writeErrorNode(record[key] as ErrorTree | ErrorArray | undefined, rest, message);\n  }\n\n  return record;\n}\n\nexport function writeError(tree: ErrorTree, path: readonly (string | number)[], message: string): ErrorTree {\n  const result = writeErrorNode(tree, path, message);\n\n  return isRecord(result) ? result : tree;\n}\n\nexport function normalizeErrors<T>(errors: T): T | undefined {\n  if (typeof errors === 'string') return errors;\n\n  if (Array.isArray(errors)) {\n    const normalized = errors.map((item) => normalizeErrors(item));\n\n    if (normalized.every((value) => value === undefined)) return undefined;\n\n    return Object.freeze(normalized) as T;\n  }\n\n  if (!isRecord(errors)) return undefined;\n\n  const entries = Object.entries(errors)\n    .map(([key, value]) => [key, normalizeErrors(value)] as const)\n    .filter(([, value]) => value !== undefined);\n\n  return entries.length === 0 ? undefined : (Object.freeze(Object.fromEntries(entries)) as T);\n}\n"],"mappings":"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"}
+{"version":3,"file":"path.cjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["import { isPlainObject as isRecord } from '@vielzeug/arsenal';\n\nimport { ForgeConfigError } from '../errors.js';\nimport type { ValidationIssue } from '../types.js';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport { isRecord };\n\nexport function isUnsafeKey(key: string): boolean {\n  return !key || unsafeKeys.has(key);\n}\n\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n  readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function assertSafeKey(key: string): void {\n  if (isUnsafeKey(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nexport function assertArrayIndex(index: number): void {\n  if (!Number.isSafeInteger(index) || index < 0) throw new ForgeConfigError(`Invalid array index ${index}.`);\n}\n\nfunction tag(value: object): string {\n  return Object.prototype.toString.call(value);\n}\n\nfunction isBlobLeaf(value: object): boolean {\n  return tag(value) === '[object Blob]' || tag(value) === '[object File]';\n}\n\nfunction invalidValue(): never {\n  throw new ForgeConfigError(\n    'Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob.',\n  );\n}\n\nexport function immutable<T>(value: T, ancestors = new Set<object>()): T {\n  if (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean') return value;\n  if (typeof value === 'number') return Number.isFinite(value) ? value : invalidValue();\n  if (typeof value !== 'object') return invalidValue();\n\n  const date = value as unknown as Date;\n  if (tag(value) === '[object Date]' && typeof date.getTime === 'function') {\n    const time = date.getTime();\n    if (!Number.isFinite(time)) return invalidValue();\n    return Object.freeze(new Date(time)) as T;\n  }\n\n  if (isBlobLeaf(value)) return value;\n  if (ancestors.has(value)) throw new ForgeConfigError('Form values must not contain circular references.');\n\n  ancestors.add(value);\n  try {\n    if (Array.isArray(value)) {\n      const copy: unknown[] = [];\n      for (let index = 0; index < value.length; index++) {\n        if (!Object.hasOwn(value, index)) throw new ForgeConfigError('Form arrays must not contain empty slots.');\n        copy.push(immutable(value[index], ancestors));\n      }\n      return Object.freeze(copy) as T;\n    }\n\n    if (!isRecord(value)) return invalidValue();\n    const entries = Object.entries(value).map(([key, child]) => {\n      assertSafeKey(key);\n      return [key, immutable(child, ancestors)] as const;\n    });\n    return Object.freeze(Object.fromEntries(entries)) as T;\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (\n        !Array.isArray(current) ||\n        !Number.isSafeInteger(key) ||\n        key < 0 ||\n        key >= current.length ||\n        !Object.hasOwn(current, key)\n      )\n        return undefined;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n      current = current[key];\n    }\n  }\n\n  return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (\n        !Array.isArray(current) ||\n        !Number.isSafeInteger(key) ||\n        key < 0 ||\n        key >= current.length ||\n        !Object.hasOwn(current, key)\n      )\n        return false;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n      current = current[key];\n    }\n  }\n\n  return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    assertArrayIndex(key);\n    if (!Array.isArray(value)) {\n      throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n    }\n\n    if (key < 0 || key >= value.length) {\n      throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n    }\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = immutable(next);\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = writeAtPath(value[key] as TreeValue, rest, next);\n\n    return Object.freeze(copy) as T;\n  }\n\n  assertSafeKey(key);\n\n  if (!isRecord(value)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n  }\n\n  if (rest.length === 0) return Object.freeze({ ...value, [key]: immutable(next) }) as T;\n\n  const child = value[key];\n\n  if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n  }\n\n  const childTree = (child ?? {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    assertArrayIndex(key);\n    if (!Array.isArray(value)) return value;\n    if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = baseline[key];\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n    return Object.freeze(copy) as T;\n  }\n\n  if (!isRecord(value)) return value;\n\n  if (rest.length === 0) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const baselineChild = (baseline as RecordValue)[key];\n\n  if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const currentChild = value[key];\n  const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n  const [key, ...rest] = path;\n  if (typeof key === 'number') assertArrayIndex(key);\n  const stringKey = String(key);\n  const copy: Record<string, MetaTree> = { ...meta };\n\n  if (rest.length === 0) {\n    if (next) copy[stringKey] = true;\n    else delete copy[stringKey];\n  } else {\n    const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n    const updated = writeMeta(child, rest, next);\n\n    if (Object.keys(updated).length === 0) delete copy[stringKey];\n    else copy[stringKey] = updated;\n  }\n\n  return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n  let current: MetaTree | undefined = meta;\n\n  for (const key of path) {\n    if (typeof key === 'number' && (!Number.isSafeInteger(key) || key < 0)) return false;\n    const stringKey = String(key);\n\n    if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n    current = current[stringKey] as MetaTree;\n  }\n\n  return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n  if (Array.isArray(value)) {\n    return Object.freeze(\n      Object.fromEntries(\n        value.map((child, i) => [\n          String(i),\n          isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n        ]),\n      ),\n    );\n  }\n\n  if (!isRecord(value)) return {};\n\n  return Object.freeze(\n    Object.fromEntries(\n      Object.entries(value).map(([key, child]) => [\n        key,\n        isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n      ]),\n    ),\n  );\n}\n\nexport function pathEquals(a: readonly (string | number)[], b: readonly (string | number)[]): boolean {\n  if (a.length !== b.length) return false;\n\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false;\n  }\n\n  return true;\n}\n\n/** Derives a single field's error message from the flat issue list. */\nexport function findIssue(\n  issues: readonly ValidationIssue[] | undefined,\n  path: readonly (string | number)[],\n): string | undefined {\n  if (!issues) return undefined;\n\n  for (const issue of issues) {\n    if (pathEquals(issue.path, path)) return issue.message;\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}

package/dist/core/path.d.ts

@@ -1,9 +1,7 @@
+import { isPlainObject as isRecord } from '@vielzeug/arsenal';
+import type { ValidationIssue } from '../types.js';
+export { isRecord };
 export declare function isUnsafeKey(key: string): boolean;
-type ErrorNode = string | ErrorTree | ErrorArray;
-export interface ErrorTree {
-    readonly [key: string]: ErrorNode;
-}
-type ErrorArray = ErrorNode[];
 type RecordValue = Record<string, unknown>;
 type TreeValue = RecordValue | readonly unknown[];
 type MetaTree = true | MetaNode;
@@ -11,9 +9,9 @@ interface MetaNode {
     readonly [key: string]: MetaTree;
 }
 export type MetaRoot = MetaNode;
-export declare function isRecord(value: unknown): value is RecordValue;
 export declare function assertSafeKey(key: string): void;
-export declare function immutable<T>(value: T): T;
+export declare function assertArrayIndex(index: number): void;
+export declare function immutable<T>(value: T, ancestors?: Set<object>): T;
 export declare function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined;
 export declare function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean;
 export declare function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown): T;
@@ -21,8 +19,7 @@ export declare function resetAtPath<T extends TreeValue>(value: T, baseline: T,
 export declare function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot;
 export declare function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean;
 export declare function touchAll(value: unknown): MetaRoot;
-export declare function readError(errors: unknown, path: readonly (string | number)[]): string | undefined;
-export declare function writeError(tree: ErrorTree, path: readonly (string | number)[], message: string): ErrorTree;
-export declare function normalizeErrors<T>(errors: T): T | undefined;
-export {};
+export declare function pathEquals(a: readonly (string | number)[], b: readonly (string | number)[]): boolean;
+/** Derives a single field's error message from the flat issue list. */
+export declare function findIssue(issues: readonly ValidationIssue[] | undefined, path: readonly (string | number)[]): string | undefined;
 //# sourceMappingURL=path.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/core/path.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AACjD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AACD,KAAK,UAAU,GAAG,SAAS,EAAE,CAAC;AAE9B,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,KAAK,SAAS,GAAG,WAAW,GAAG,SAAS,OAAO,EAAE,CAAC;AAClD,KAAK,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAAC;AAChC,UAAU,QAAQ;IAChB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CAClC;AACD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEhC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAM7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAUD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAYxC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAgB/F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAgBrF;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CA4C/G;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,CA8C7G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAiBrG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAYpF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAsBjD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAIjG;AAkCD,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAI1G;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAkB3D"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/core/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,KAAK,SAAS,GAAG,WAAW,GAAG,SAAS,OAAO,EAAE,CAAC;AAClD,KAAK,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAAC;AAChC,UAAU,QAAQ;IAChB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CAClC;AACD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEhC,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEpD;AAgBD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,cAAoB,GAAG,CAAC,CAmCvE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAuB/F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAuBrF;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CA6C/G;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,CA+C7G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAkBrG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAapF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAsBjD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAQpG;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,EAC9C,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,MAAM,GAAG,SAAS,CAQpB"}