@vielzeug/forge 2.3.1 → 3.1.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(e){let t=``;for(let n of e)t+=typeof n==`number`?`[${n}]`:t?`.${n}`:n;return t}function l(e){return e.length>0?` at '${c(e)}'`:``}function u(t){throw new e.ForgeConfigError(`Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob${l(t)}.`)}function d(n,r=new Set,a=[]){if(n==null||typeof n==`string`||typeof n==`boolean`)return n;if(typeof n==`number`)return Number.isFinite(n)?n:u(a);if(typeof n!=`object`)return u(a);let c=n;if(o(n)===`[object Date]`&&typeof c.getTime==`function`){let e=c.getTime();return Number.isFinite(e)?Object.freeze(new Date(e)):u(a)}if(s(n))return n;if(r.has(n))throw new e.ForgeConfigError(`Form values must not contain circular references${l(a)}.`);r.add(n);try{if(Array.isArray(n)){let t=[];for(let i=0;i<n.length;i++){a.push(i);try{if(!Object.hasOwn(n,i))throw new e.ForgeConfigError(`Form arrays must not contain empty slots${l(a)}.`);t.push(d(n[i],r,a))}finally{a.pop()}}return Object.freeze(t)}if(!(0,t.isPlainObject)(n))return u(a);let o=Object.entries(n).map(([e,t])=>{i(e),a.push(e);try{return[e,d(t,r,a)]}finally{a.pop()}});return Object.freeze(Object.fromEntries(o))}finally{r.delete(n)}}function f(e,t=new WeakSet){if(e==null||typeof e==`string`||typeof e==`boolean`)return e;if(typeof e==`number`)return Number.isFinite(e)?e:void 0;if(typeof e!=`object`)return;let n=e,i=e;if(o(n)===`[object Date]`&&typeof i.getTime==`function`){let e=i.getTime();return Number.isFinite(e)?new Date(e):void 0}if(s(n))return e;if(!t.has(n)){t.add(n);try{if(Array.isArray(e)){let n=[];for(let r=0;r<e.length;r++)Object.hasOwn(e,r)&&n.push(f(e[r],t));return n}let i={};for(let[e,a]of Object.entries(n))r(e)||(i[e]=f(a,t));return i}finally{t.delete(n)}}}function p(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 m(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 h(n,r,o,s=[]){let[c,...l]=r;if(typeof c==`number`){if(a(c),!Array.isArray(n))throw new e.ForgeConfigError(`Cannot index ${c} because the current value is not an array.`);if(c<0||c>=n.length)throw new e.ForgeConfigError(`Index ${c} is out of range for array of length ${n.length}.`);if(l.length===0){let e=[...n];return e[c]=d(o,new Set,[...s,c]),Object.freeze(e)}let t=[...n];return t[c]=h(n[c],l,o,[...s,c]),Object.freeze(t)}if(i(c),!(0,t.isPlainObject)(n))throw new e.ForgeConfigError(`Cannot select '${c}' because the current value is not an object.`);if(l.length===0)return Object.freeze({...n,[c]:d(o,new Set,[...s,c])});let u=n[c];if(u!==void 0&&!(0,t.isPlainObject)(u)&&!Array.isArray(u))throw new e.ForgeConfigError(`Cannot select '${c}' because it is not an object or array.`);let f=u??{};return Object.freeze({...n,[c]:h(f,l,o,[...s,c])})}function g(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]=g(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]:g(l,s,o)})}function _(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=_((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 v(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 y(e){return Array.isArray(e)?Object.freeze(Object.fromEntries(e.map((e,n)=>[String(n),(0,t.isPlainObject)(e)||Array.isArray(e)?y(e):!0]))):(0,t.isPlainObject)(e)?Object.freeze(Object.fromEntries(Object.entries(e).map(([e,n])=>[e,(0,t.isPlainObject)(n)||Array.isArray(n)?y(n):!0]))):{}}function b(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 x(e,t){if(e){for(let n of e)if(b(n.path,t))return n.message}}exports.assertArrayIndex=a,exports.assertSafeKey=i,exports.findIssue=x,exports.formatValuePath=c,exports.hasAtPath=m,exports.immutable=d,exports.isRecord=t.isPlainObject,exports.isUnsafeKey=r,exports.pathEquals=b,exports.readAtPath=p,exports.readMeta=v,exports.resetAtPath=g,exports.toPlainValues=f,exports.touchAll=y,exports.writeAtPath=h,exports.writeMeta=_;
 //# 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":"iCAEA,IAAM,EAAa,IAAI,IAAI,CAAC,YAAa,cAAe,WAAW,CAAC,EAEpE,SAAgB,EAAY,EAAsB,CAChD,MAAO,CAAC,GAAO,EAAW,IAAI,CAAG,CACnC,CAgBA,SAAgB,EAAS,EAAsC,CAC7D,GAAsB,OAAO,GAAU,WAAnC,GAA+C,MAAM,QAAQ,CAAK,EAAG,MAAO,GAEhF,IAAM,EAAY,OAAO,eAAe,CAAK,EAE7C,OAAO,IAAc,OAAO,WAAa,IAAc,IACzD,CAEA,SAAgB,EAAc,EAAmB,CAC/C,GAAI,EAAY,CAAG,EAAG,MAAM,IAAI,EAAA,iBAAiB,sBAAsB,EAAI,GAAG,CAChF,CAEA,SAAS,EAAa,EAAyB,CAC7C,OACG,OAAO,KAAS,KAAe,aAAiB,MAChD,OAAO,KAAS,KAAe,aAAiB,MACjD,aAAiB,IAErB,CAEA,SAAgB,EAAa,EAAa,CACxC,GAAI,MAAM,QAAQ,CAAK,EAAG,OAAO,OAAO,OAAO,EAAM,IAAI,CAAS,CAAC,EAEnE,GAAsB,OAAO,GAAU,WAAnC,GAA+C,EAAa,CAAK,EAAG,OAAO,EAE/E,GAAI,CAAC,EAAS,CAAK,EACjB,MAAM,IAAI,EAAA,iBACR,6FACF,EAGF,OAAO,OAAO,OAAO,OAAO,YAAY,OAAO,QAAQ,CAAK,CAAC,CAAC,KAAK,CAAC,EAAK,KAAW,CAAC,EAAK,EAAU,CAAK,CAAC,CAAC,CAAC,CAAC,CAC/G,CAEA,SAAgB,EAAc,EAAgB,EAAmD,CAC/F,IAAI,EAAmB,EAEvB,IAAK,IAAM,KAAO,EAChB,GAAI,OAAO,GAAQ,SAAU,CAC3B,GAAI,CAAC,MAAM,QAAQ,CAAO,GAAK,EAAM,GAAK,GAAO,EAAQ,OAAQ,OAEjE,EAAU,EAAQ,EACpB,KAAO,CACL,GAAI,CAAC,EAAS,CAAO,GAAK,CAAC,OAAO,OAAO,EAAS,CAAG,EAAG,OAExD,EAAU,EAAQ,EACpB,CAGF,OAAO,CACT,CAEA,SAAgB,EAAU,EAAgB,EAA6C,CACrF,IAAI,EAAmB,EAEvB,IAAK,IAAM,KAAO,EAChB,GAAI,OAAO,GAAQ,SAAU,CAC3B,GAAI,CAAC,MAAM,QAAQ,CAAO,GAAK,EAAM,GAAK,GAAO,EAAQ,OAAQ,MAAO,GAExE,EAAU,EAAQ,EACpB,KAAO,CACL,GAAI,CAAC,EAAS,CAAO,GAAK,CAAC,OAAO,OAAO,EAAS,CAAG,EAAG,MAAO,GAE/D,EAAU,EAAQ,EACpB,CAGF,MAAO,EACT,CAEA,SAAgB,EAAiC,EAAU,EAAoC,EAAkB,CAC/G,GAAM,CAAC,EAAK,GAAG,GAAQ,EAEvB,GAAI,OAAO,GAAQ,SAAU,CAC3B,GAAI,CAAC,MAAM,QAAQ,CAAK,EACtB,MAAM,IAAI,EAAA,iBAAiB,gBAAgB,EAAI,4CAA4C,EAG7F,GAAI,EAAM,GAAK,GAAO,EAAM,OAC1B,MAAM,IAAI,EAAA,iBAAiB,SAAS,EAAI,uCAAuC,EAAM,OAAO,EAAE,EAGhG,GAAI,EAAK,SAAW,EAAG,CACrB,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAU,CAAI,EAEnB,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAY,EAAM,GAAmB,EAAM,CAAI,EAEpD,OAAO,OAAO,CAAI,CAC3B,CAIA,GAFA,EAAc,CAAG,EAEb,CAAC,EAAS,CAAK,EACjB,MAAM,IAAI,EAAA,iBAAiB,kBAAkB,EAAI,8CAA8C,EAGjG,GAAI,EAAK,SAAW,EAAG,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,EAAU,CAAI,CAAE,CAAC,EAEhF,IAAM,EAAQ,EAAM,GAEpB,GAAI,IAAU,IAAA,IAAa,CAAC,EAAS,CAAK,GAAK,CAAC,MAAM,QAAQ,CAAK,EACjE,MAAM,IAAI,EAAA,iBAAiB,kBAAkB,EAAI,wCAAwC,EAG3F,IAAM,EAAa,GAAS,CAAC,EAE7B,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,EAAY,EAAW,EAAM,CAAI,CAAE,CAAC,CAC9E,CAEA,SAAgB,EAAiC,EAAU,EAAa,EAAuC,CAC7G,GAAM,CAAC,EAAK,GAAG,GAAQ,EAEvB,GAAI,OAAO,GAAQ,SAAU,CAE3B,GADI,CAAC,MAAM,QAAQ,CAAK,GACpB,CAAC,MAAM,QAAQ,CAAQ,GAAK,GAAO,EAAS,QAAU,GAAO,EAAM,OAAQ,OAAO,EAEtF,GAAI,EAAK,SAAW,EAAG,CACrB,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAS,GAEd,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAY,EAAM,GAAmB,EAAS,GAAmB,CAAI,EAE1E,OAAO,OAAO,CAAI,CAC3B,CAEA,GAAI,CAAC,EAAS,CAAK,EAAG,OAAO,EAE7B,GAAI,EAAK,SAAW,EAAG,CACrB,GAAI,OAAO,OAAO,EAAU,CAAG,EAAG,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAO,EAAyB,EAAK,CAAC,EAE1G,GAAM,EAAG,GAAM,EAAU,GAAG,GAAS,EAErC,OAAO,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAiB,EAAyB,GAEhD,GAAI,CAAC,EAAS,CAAa,GAAK,CAAC,MAAM,QAAQ,CAAa,EAAG,CAC7D,GAAI,OAAO,OAAO,EAAU,CAAG,EAAG,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,CAAc,CAAC,EAEzF,GAAM,EAAG,GAAM,EAAU,GAAG,GAAS,EAErC,OAAO,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAe,EAAM,GACrB,EAAa,EAAS,CAAY,GAAK,MAAM,QAAQ,CAAY,EAAI,EAAe,CAAC,EAE3F,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,EAAY,EAAW,EAA4B,CAAI,CAAE,CAAC,CACpG,CAEA,SAAgB,EAAU,EAAgB,EAAoC,EAAyB,CACrG,GAAM,CAAC,EAAK,GAAG,GAAQ,EACjB,EAAY,OAAO,CAAG,EACtB,EAAiC,CAAE,GAAG,CAAK,EAEjD,GAAI,EAAK,SAAW,EACd,EAAM,EAAK,GAAa,GACvB,OAAO,EAAK,OACZ,CAEL,IAAM,EAAU,EADF,EAAS,EAAK,EAAU,EAAK,EAAK,GAA0B,CAAC,EAC1C,EAAM,CAAI,EAEvC,OAAO,KAAK,CAAO,CAAC,CAAC,SAAW,EAAG,OAAO,EAAK,GAC9C,EAAK,GAAa,CACzB,CAEA,OAAO,OAAO,OAAO,CAAI,CAC3B,CAEA,SAAgB,EAAS,EAAgB,EAA6C,CACpF,IAAI,EAAgC,EAEpC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAY,OAAO,CAAG,EAE5B,GAAI,CAAC,EAAS,CAAO,GAAK,CAAC,OAAO,OAAO,EAAS,CAAS,EAAG,MAAO,GAErE,EAAU,EAAQ,EACpB,CAEA,OAAO,IAAY,EACrB,CAEA,SAAgB,EAAS,EAA0B,CAcjD,OAbI,MAAM,QAAQ,CAAK,EACd,OAAO,OACZ,OAAO,YACL,EAAM,KAAK,EAAO,IAAM,CACtB,OAAO,CAAC,EACR,EAAS,CAAK,GAAK,MAAM,QAAQ,CAAK,EAAI,EAAS,CAAK,EAAK,EAC/D,CAAC,CACH,CACF,EAGG,EAAS,CAAK,EAEZ,OAAO,OACZ,OAAO,YACL,OAAO,QAAQ,CAAK,CAAC,CAAC,KAAK,CAAC,EAAK,KAAW,CAC1C,EACA,EAAS,CAAK,GAAK,MAAM,QAAQ,CAAK,EAAI,EAAS,CAAK,EAAK,EAC/D,CAAC,CACH,CACF,EAT6B,CAAC,CAUhC,CAEA,SAAgB,EAAU,EAAiB,EAAwD,CACjG,IAAM,EAAQ,EAAW,EAAQ,CAAI,EAErC,OAAO,OAAO,GAAU,SAAW,EAAQ,IAAA,EAC7C,CAEA,SAAS,EACP,EACA,EACA,EACwB,CACxB,GAAM,CAAC,EAAK,GAAG,GAAQ,EAEvB,GAAI,OAAO,GAAQ,SAAU,CAC3B,IAAM,EAAmB,MAAM,QAAQ,CAAI,EAAI,CAAC,GAAG,CAAI,EAAI,CAAC,EAQ5D,OANI,EAAK,SAAW,EACd,EAAI,KAAS,IAAA,KAAW,EAAI,GAAO,GAEvC,EAAI,GAAO,EAAe,EAAI,GAA4C,EAAM,CAAO,EAGlF,CACT,CAEA,GAAI,EAAY,CAAG,EAAG,OAAO,GAAQ,CAAC,EAEtC,IAAM,EAA2B,EAAS,CAAI,EAAI,CAAE,GAAG,CAAK,EAAI,CAAC,EAQjE,OANI,EAAK,SAAW,EACd,EAAO,KAAS,IAAA,KAAW,EAAO,GAAO,GAE7C,EAAO,GAAO,EAAe,EAAO,GAA4C,EAAM,CAAO,EAGxF,CACT,CAEA,SAAgB,EAAW,EAAiB,EAAoC,EAA4B,CAC1G,IAAM,EAAS,EAAe,EAAM,EAAM,CAAO,EAEjD,OAAO,EAAS,CAAM,EAAI,EAAS,CACrC,CAEA,SAAgB,EAAmB,EAA0B,CAC3D,GAAI,OAAO,GAAW,SAAU,OAAO,EAEvC,GAAI,MAAM,QAAQ,CAAM,EAAG,CACzB,IAAM,EAAa,EAAO,IAAK,GAAS,EAAgB,CAAI,CAAC,EAI7D,OAFI,EAAW,MAAO,GAAU,IAAU,IAAA,EAAS,EAAG,OAE/C,OAAO,OAAO,CAAU,CACjC,CAEA,GAAI,CAAC,EAAS,CAAM,EAAG,OAEvB,IAAM,EAAU,OAAO,QAAQ,CAAM,CAAC,CACnC,KAAK,CAAC,EAAK,KAAW,CAAC,EAAK,EAAgB,CAAK,CAAC,CAAU,CAAC,CAC7D,QAAQ,EAAG,KAAW,IAAU,IAAA,EAAS,EAE5C,OAAO,EAAQ,SAAW,EAAI,IAAA,GAAa,OAAO,OAAO,OAAO,YAAY,CAAO,CAAC,CACtF"}
+{"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\n/** Formats a value path as `list[0].name` for error messages. */\nexport function formatValuePath(path: readonly (string | number)[]): string {\n  let out = '';\n  for (const segment of path) {\n    if (typeof segment === 'number') out += `[${segment}]`;\n    else out += out ? `.${segment}` : segment;\n  }\n  return out;\n}\n\nfunction pathSuffix(path: readonly (string | number)[]): string {\n  return path.length > 0 ? ` at '${formatValuePath(path)}'` : '';\n}\n\nfunction invalidValue(path: readonly (string | number)[]): never {\n  throw new ForgeConfigError(\n    `Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob${pathSuffix(path)}.`,\n  );\n}\n\nexport function immutable<T>(value: T, ancestors = new Set<object>(), path: (string | number)[] = []): 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(path);\n  if (typeof value !== 'object') return invalidValue(path);\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(path);\n    return Object.freeze(new Date(time)) as T;\n  }\n\n  if (isBlobLeaf(value)) return value;\n  if (ancestors.has(value))\n    throw new ForgeConfigError(`Form values must not contain circular references${pathSuffix(path)}.`);\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        path.push(index);\n        try {\n          if (!Object.hasOwn(value, index))\n            throw new ForgeConfigError(`Form arrays must not contain empty slots${pathSuffix(path)}.`);\n          copy.push(immutable(value[index], ancestors, path));\n        } finally {\n          path.pop();\n        }\n      }\n      return Object.freeze(copy) as T;\n    }\n\n    if (!isRecord(value)) return invalidValue(path);\n    const entries = Object.entries(value).map(([key, child]) => {\n      assertSafeKey(key);\n      path.push(key);\n      try {\n        return [key, immutable(child, ancestors, path)] as const;\n      } finally {\n        path.pop();\n      }\n    });\n    return Object.freeze(Object.fromEntries(entries)) as T;\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\n/**\n * Deeply converts a value into the plain shape `immutable()` accepts: primitives pass\n * through, `Date` is cloned, `File`/`Blob` keep identity, arrays map, and class instances\n * flatten to their own enumerable entries. Use as the `normalize` option of `createForm`\n * to hold domain-model classes in form state.\n *\n * Lossy conversions, applied instead of the error `immutable()` would throw: `Map`, `Set`,\n * and other keyless built-ins flatten to `{}` (their entries live on the prototype); sparse\n * array slots are dropped, which shifts later indexes; `NaN`, `Infinity`, functions, and\n * circular branches become `undefined`. Normalize model classes, not arbitrary graphs.\n */\nexport function toPlainValues<T>(value: T, seen = new WeakSet<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 : (undefined as T);\n  if (typeof value !== 'object') return undefined as T;\n\n  const object = value as unknown as object;\n  const date = value as unknown as Date;\n  if (tag(object) === '[object Date]' && typeof date.getTime === 'function') {\n    const time = date.getTime();\n    return (Number.isFinite(time) ? new Date(time) : undefined) as T;\n  }\n  if (isBlobLeaf(object)) return value;\n  if (seen.has(object)) return undefined as T;\n\n  seen.add(object);\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)) copy.push(toPlainValues(value[index], seen));\n      }\n      return copy as T;\n    }\n\n    // Plain objects and class instances both flatten to own enumerable entries;\n    // unsafe keys are dropped so the result always passes immutable()'s key checks.\n    const copy: RecordValue = {};\n    for (const [key, child] of Object.entries(object)) {\n      if (isUnsafeKey(key)) continue;\n      copy[key] = toPlainValues(child, seen);\n    }\n    return copy as T;\n  } finally {\n    seen.delete(object);\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>(\n  value: T,\n  path: readonly (string | number)[],\n  next: unknown,\n  fullPath: readonly (string | number)[] = [],\n): 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, new Set<object>(), [...fullPath, key]);\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, [...fullPath, key]);\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)\n    return Object.freeze({ ...value, [key]: immutable(next, new Set<object>(), [...fullPath, key]) }) 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, [...fullPath, key]) }) 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,18 +9,31 @@ 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;
+/** Formats a value path as `list[0].name` for error messages. */
+export declare function formatValuePath(path: readonly (string | number)[]): string;
+export declare function immutable<T>(value: T, ancestors?: Set<object>, path?: (string | number)[]): T;
+/**
+ * Deeply converts a value into the plain shape `immutable()` accepts: primitives pass
+ * through, `Date` is cloned, `File`/`Blob` keep identity, arrays map, and class instances
+ * flatten to their own enumerable entries. Use as the `normalize` option of `createForm`
+ * to hold domain-model classes in form state.
+ *
+ * Lossy conversions, applied instead of the error `immutable()` would throw: `Map`, `Set`,
+ * and other keyless built-ins flatten to `{}` (their entries live on the prototype); sparse
+ * array slots are dropped, which shifts later indexes; `NaN`, `Infinity`, functions, and
+ * circular branches become `undefined`. Normalize model classes, not arbitrary graphs.
+ */
+export declare function toPlainValues<T>(value: T, seen?: WeakSet<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;
+export declare function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown, fullPath?: readonly (string | number)[]): T;
 export declare function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): 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;AAUD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAO1E;AAYD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,cAAoB,EAAE,IAAI,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GAAG,CAAC,CA+CvG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,kBAAwB,GAAG,CAAC,CAmC1E;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,EAC7C,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GAC1C,CAAC,CA8CH;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"}