@vielzeug/forge 1.3.1 → 1.4.0

package/dist/core/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","names":[],"sources":["../../src/core/notifier.ts"],"sourcesContent":["import { batch as rippleBatch, signal, watch, type Signal } from '@vielzeug/ripple';\n\nimport type { FieldState, FormState, SubscribeOptions, Unsubscribe } from '../types';\n\nimport { assertSafeKey } from '../_utils';\n\n/**\n * Everything needed to (re)compute fresh state on demand. Supplied by whoever owns the\n * actual field/validator Maps (`core/context.ts`, backing `core/fields.ts`) so this module\n * never touches those Maps directly — it only knows \"how to get current state\" and \"who's\n * listening,\" never \"where the state lives.\"\n */\nexport type NotifierDeps = {\n  buildFieldState(name: string): FieldState<unknown>;\n  computeState(): FormState;\n  /** Called once at the top of every requestNotify(), before state is recomputed — lets the\n   * caller drop its own memoized derived values (e.g. `values()`'s cached unflattened object). */\n  invalidateCaches(): void;\n};\n\n/**\n * Owns every signal, subscription, and derived-state cache a form needs to notify observers.\n * Extracted from the old shared `FormContext` god-object (see `core/context.ts`'s header\n * comment) — this is the one piece of that object with no real dependency on field values or\n * validators, only on \"what does current state look like\" (via `NotifierDeps`), so it's safe\n * to own its signals/caches privately instead of exposing them on a shared mutable bag.\n */\nexport function createNotifier(deps: NotifierDeps) {\n  const formStateSignal: Signal<FormState> = signal(deps.computeState());\n  const fieldSignals = new Map<string, Signal<FieldState<unknown>>>();\n  const fieldStateCache = new Map<string, FieldState<unknown>>();\n  const rippleSubs = new Set<{ dispose(): void }>();\n  let disposed = false;\n\n  function getOrCreateFieldSignal(key: string): Signal<FieldState<unknown>> {\n    let sig = fieldSignals.get(key);\n\n    if (!sig) {\n      sig = signal<FieldState<unknown>>(deps.buildFieldState(key), {\n        equals: (a, b) =>\n          a.value === b.value &&\n          a.error === b.error &&\n          a.hasError === b.hasError &&\n          a.touched === b.touched &&\n          a.dirty === b.dirty,\n      });\n      fieldSignals.set(key, sig);\n    }\n\n    return sig;\n  }\n\n  function getFieldSnapshot(name: string): FieldState<unknown> {\n    const cached = fieldStateCache.get(name);\n\n    if (cached) return cached;\n\n    const snap = Object.freeze(deps.buildFieldState(name));\n\n    fieldStateCache.set(name, snap);\n\n    return snap;\n  }\n\n  function getStateSnapshot(): FormState {\n    return formStateSignal.value;\n  }\n\n  /**\n   * Unified notification — a single write path for every mutation in the package.\n   * - `undefined` → full-form refresh (all field signals + form signal)\n   * - `string`    → single field + form signal\n   * - `Iterable`  → targeted set of fields + form signal\n   * `rippleBatch` deduplicates signal writes within the synchronous call stack.\n   */\n  function requestNotify(target?: string | Iterable<string>): void {\n    if (disposed) return;\n\n    deps.invalidateCaches();\n\n    if (target === undefined) {\n      fieldStateCache.clear();\n      rippleBatch(() => {\n        formStateSignal.value = deps.computeState();\n\n        for (const [name, sig] of fieldSignals) sig.value = deps.buildFieldState(name);\n      });\n    } else if (typeof target === 'string') {\n      fieldStateCache.delete(target);\n      rippleBatch(() => {\n        formStateSignal.value = deps.computeState();\n\n        const sig = fieldSignals.get(target);\n\n        if (sig) sig.value = deps.buildFieldState(target);\n      });\n    } else {\n      // Materialize before rippleBatch so the iterable isn't consumed inside the callback.\n      const fields = [...target];\n\n      for (const field of fields) fieldStateCache.delete(field);\n\n      rippleBatch(() => {\n        formStateSignal.value = deps.computeState();\n\n        for (const field of fields) {\n          const sig = fieldSignals.get(field);\n\n          if (sig) sig.value = deps.buildFieldState(field);\n        }\n      });\n    }\n  }\n\n  function subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    if (disposed) return () => {};\n\n    // Wrap listener so it always returns void — ripple watch throws on non-function returns.\n    const sub = watch(formStateSignal, (state) => {\n      listener(state);\n    });\n\n    rippleSubs.add(sub);\n\n    if (options?.sync) listener(formStateSignal.value);\n\n    return () => {\n      sub.dispose();\n      rippleSubs.delete(sub);\n    };\n  }\n\n  function subscribeField(\n    name: string,\n    listener: (state: FieldState<unknown>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe {\n    if (disposed) return () => {};\n\n    assertSafeKey(name);\n\n    const sig = getOrCreateFieldSignal(name);\n    const sub = watch(sig, (state) => {\n      listener(state);\n    });\n\n    rippleSubs.add(sub);\n\n    if (options?.sync) listener(sig.value);\n\n    return () => {\n      sub.dispose();\n      rippleSubs.delete(sub);\n    };\n  }\n\n  function dispose(): void {\n    disposed = true;\n\n    for (const sub of rippleSubs) sub.dispose();\n\n    rippleSubs.clear();\n    fieldSignals.clear();\n    fieldStateCache.clear();\n  }\n\n  return {\n    dispose,\n    getFieldSnapshot,\n    getOrCreateFieldSignal,\n    getStateSnapshot,\n    requestNotify,\n    subscribe,\n    subscribeField,\n  };\n}\n\nexport type Notifier = ReturnType<typeof createNotifier>;\n"],"mappings":";;;AA2BA,SAAgB,EAAe,GAAoB;CACjD,IAAM,IAAqC,EAAO,EAAK,aAAa,CAAC,GAC/D,oBAAe,IAAI,IAAyC,GAC5D,oBAAkB,IAAI,IAAiC,GACvD,oBAAa,IAAI,IAAyB,GAC5C,IAAW;CAEf,SAAS,EAAuB,GAA0C;EACxE,IAAI,IAAM,EAAa,IAAI,CAAG;EAc9B,OAZK,MACH,IAAM,EAA4B,EAAK,gBAAgB,CAAG,GAAG,EAC3D,SAAS,GAAG,MACV,EAAE,UAAU,EAAE,SACd,EAAE,UAAU,EAAE,SACd,EAAE,aAAa,EAAE,YACjB,EAAE,YAAY,EAAE,WAChB,EAAE,UAAU,EAAE,MAClB,CAAC,GACD,EAAa,IAAI,GAAK,CAAG,IAGpB;CACT;CAEA,SAAS,EAAiB,GAAmC;EAC3D,IAAM,IAAS,EAAgB,IAAI,CAAI;EAEvC,IAAI,GAAQ,OAAO;EAEnB,IAAM,IAAO,OAAO,OAAO,EAAK,gBAAgB,CAAI,CAAC;EAIrD,OAFA,EAAgB,IAAI,GAAM,CAAI,GAEvB;CACT;CAEA,SAAS,IAA8B;EACrC,OAAO,EAAgB;CACzB;CASA,SAAS,EAAc,GAA0C;EAC3D,QAIJ,IAFA,EAAK,iBAAiB,GAElB,MAAW,KAAA,GAEb,AADA,EAAgB,MAAM,GACtB,QAAkB;GAChB,EAAgB,QAAQ,EAAK,aAAa;GAE1C,KAAK,IAAM,CAAC,GAAM,MAAQ,GAAc,EAAI,QAAQ,EAAK,gBAAgB,CAAI;EAC/E,CAAC;OACI,IAAI,OAAO,KAAW,UAE3B,AADA,EAAgB,OAAO,CAAM,GAC7B,QAAkB;GAChB,EAAgB,QAAQ,EAAK,aAAa;GAE1C,IAAM,IAAM,EAAa,IAAI,CAAM;GAEnC,AAAI,MAAK,EAAI,QAAQ,EAAK,gBAAgB,CAAM;EAClD,CAAC;OACI;GAEL,IAAM,IAAS,CAAC,GAAG,CAAM;GAEzB,KAAK,IAAM,KAAS,GAAQ,EAAgB,OAAO,CAAK;GAExD,QAAkB;IAChB,EAAgB,QAAQ,EAAK,aAAa;IAE1C,KAAK,IAAM,KAAS,GAAQ;KAC1B,IAAM,IAAM,EAAa,IAAI,CAAK;KAElC,AAAI,MAAK,EAAI,QAAQ,EAAK,gBAAgB,CAAK;IACjD;GACF,CAAC;EACH;CACF;CAEA,SAAS,EAAU,GAAsC,GAAyC;EAChG,IAAI,GAAU,aAAa,CAAC;EAG5B,IAAM,IAAM,EAAM,IAAkB,MAAU;GAC5C,EAAS,CAAK;EAChB,CAAC;EAMD,OAJA,EAAW,IAAI,CAAG,GAEd,GAAS,QAAM,EAAS,EAAgB,KAAK,SAEpC;GAEX,AADA,EAAI,QAAQ,GACZ,EAAW,OAAO,CAAG;EACvB;CACF;CAEA,SAAS,EACP,GACA,GACA,GACa;EACb,IAAI,GAAU,aAAa,CAAC;EAE5B,EAAc,CAAI;EAElB,IAAM,IAAM,EAAuB,CAAI,GACjC,IAAM,EAAM,IAAM,MAAU;GAChC,EAAS,CAAK;EAChB,CAAC;EAMD,OAJA,EAAW,IAAI,CAAG,GAEd,GAAS,QAAM,EAAS,EAAI,KAAK,SAExB;GAEX,AADA,EAAI,QAAQ,GACZ,EAAW,OAAO,CAAG;EACvB;CACF;CAEA,SAAS,IAAgB;EACvB,IAAW;EAEX,KAAK,IAAM,KAAO,GAAY,EAAI,QAAQ;EAI1C,AAFA,EAAW,MAAM,GACjB,EAAa,MAAM,GACnB,EAAgB,MAAM;CACxB;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/core/observe.cjs

@@ -1,2 +1,2 @@
-const e=require("../_utils.cjs"),t=require("./asyncQueue.cjs");let n=require("@vielzeug/arsenal"),r=require("@vielzeug/ripple");function i(i,a){function o(e,t){if(i.disposed)return()=>{};let n=(0,r.watch)(i.formStateSignal,t=>{e(t)});return i.rippleSubs.add(n),t?.sync&&e(i.formStateSignal.value),()=>{n.dispose(),i.rippleSubs.delete(n)}}function s(t,n,a){if(i.disposed)return()=>{};let o=t;e.assertSafeKey(o);let s=i.getOrCreateFieldSignal(o),c=(0,r.watch)(s,e=>{n(e)});return i.rippleSubs.add(c),a?.sync&&n(s.value),()=>{c.dispose(),i.rippleSubs.delete(c)}}function c(t,r){i.ensureNotDisposed();let o=t;e.assertSafeKey(o);let s=r?.touchOnBlur??i.connectDefaults.touchOnBlur??!1,c=r?.validateOnBlur??i.connectDefaults.validateOnBlur??!1,l=r?.validateOnChange??i.connectDefaults.validateOnChange??!1,u=r?.validateOnTouch??i.connectDefaults.validateOnTouch??!1,d=r?.debounce??i.connectDefaults.debounce??0,f=null;function p(){d>0?(f!==null&&clearTimeout(f),f=setTimeout(()=>{f=null,!i.disposed&&a.validateFields([t]).catch(e=>{if(!(0,n.isAbortError)(e))throw e})},d)):a.validateFields([t]).catch(e=>{if(!(0,n.isAbortError)(e))throw e})}let m=!1;return{get dirty(){return i.dirty.has(o)},dispose(){m=!0,f!==null&&(clearTimeout(f),f=null)},get disposed(){return m},get error(){return i.fieldErrors.get(o)},onBlur:()=>{i.disposed||(s&&a.touch(t),c&&p())},onChange:e=>{i.disposed||(a.set(t,e),(l||u&&i.touched.has(o))&&p())},[Symbol.dispose](){this.dispose()},get touched(){return i.touched.has(o)},get value(){return i.store.get(o)}}}function l(){let e=t.createAsyncQueue(()=>n());e.push(i.getStateSnapshot());let n=o(t=>{e.push(t)});return i.disposeController.signal.addEventListener(`abort`,()=>e.terminate(),{once:!0}),e.iterator}return{connect:c,subscribe:o,subscribeField:s,[Symbol.asyncIterator]:l}}exports.createObserveOps=i;
+const e=require("../_utils.cjs"),t=require("./asyncQueue.cjs");let n=require("@vielzeug/arsenal");function r(r,i){function a(e,t){return r.subscribe(e,t)}function o(t,n,i){let a=t;return e.assertSafeKey(a),r.subscribeField(a,n,i)}function s(t,a){r.ensureNotDisposed(`connect`);let o=t;e.assertSafeKey(o);function s(e,t){return a?.[e]??i.connectDefaults[e]??t}let c=s(`touchOnBlur`,!1),l=s(`validateOnBlur`,!1),u=s(`validateOnChange`,!1),d=s(`validateOnTouch`,!1),f=s(`debounce`,0),p=null;function m(){f>0?(p!==null&&clearTimeout(p),p=setTimeout(()=>{p=null,!r.disposed&&i.validateFields([t]).catch(e=>{if(!(0,n.isAbortError)(e))throw e})},f)):i.validateFields([t]).catch(e=>{if(!(0,n.isAbortError)(e))throw e})}let h=!1;return{get dirty(){return r.dirty.has(o)},dispose(){h=!0,p!==null&&(clearTimeout(p),p=null)},get disposed(){return h},get error(){return r.fieldErrors.get(o)},onBlur:()=>{r.disposed||(c&&i.touch(t),l&&m())},onChange:e=>{r.disposed||(i.set(t,e),(u||d&&r.touched.has(o))&&m())},[Symbol.dispose](){this.dispose()},get touched(){return r.touched.has(o)},get value(){return r.store.get(o)}}}function c(){let e=t.createAsyncQueue(()=>n());e.push(r.getStateSnapshot());let n=a(t=>{e.push(t)});return r.disposeController.signal.addEventListener(`abort`,()=>e.terminate(),{once:!0}),e.iterator}return{connect:s,subscribe:a,subscribeField:o,[Symbol.asyncIterator]:c}}exports.createObserveOps=r;
 //# sourceMappingURL=observe.cjs.map

package/dist/core/observe.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"observe.cjs","names":[],"sources":["../../src/core/observe.ts"],"sourcesContent":["import { isAbortError } from '@vielzeug/arsenal';\nimport { watch } from '@vielzeug/ripple';\n\nimport type { FormContext } from './context';\nimport type { ValidationOps } from './validation';\nimport type { ValueOps } from './values';\n\nimport { assertSafeKey } from '../_utils';\nimport {\n  type ConnectionResult,\n  type ConnectOptions,\n  type FieldState,\n  type FlatKeyOf,\n  type FormState,\n  type SubscribeOptions,\n  type TypeAtPath,\n  type Unsubscribe,\n} from '../types';\nimport { createAsyncQueue } from './asyncQueue';\n\ntype ObserveDeps<TValues extends Record<string, unknown>> = Pick<ValueOps<TValues>, 'set' | 'touch'> &\n  Pick<ValidationOps<TValues>, 'validateFields'>;\n\n/**\n * Observation operations: `subscribe`/`subscribeField`, `connect` (per-binding debounce timer),\n * and the `[Symbol.asyncIterator]` implementation. Moved verbatim from `createForm()`'s\n * \"Subscriptions\", \"Connect\", and \"Async iterator\" sections.\n */\nexport function createObserveOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: ObserveDeps<TValues>,\n) {\n  function subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    if (ctx.disposed) return () => {};\n\n    // Wrap listener so it always returns void — ripple watch throws on non-function returns.\n    const sub = watch(ctx.formStateSignal, (state) => {\n      listener(state);\n    });\n\n    ctx.rippleSubs.add(sub);\n\n    if (options?.sync) listener(ctx.formStateSignal.value);\n\n    return () => {\n      sub.dispose();\n      ctx.rippleSubs.delete(sub);\n    };\n  }\n\n  function subscribeField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    listener: (state: FieldState<TypeAtPath<TValues, K>>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe {\n    if (ctx.disposed) return () => {};\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    const sig = ctx.getOrCreateFieldSignal(key);\n    // Wrap listener so it always returns void — ripple watch throws on non-function returns.\n    const sub = watch(sig, (state) => {\n      (listener as (state: FieldState<unknown>) => void)(state);\n    });\n\n    ctx.rippleSubs.add(sub);\n\n    if (options?.sync) listener(sig.value as FieldState<TypeAtPath<TValues, K>>);\n\n    return () => {\n      sub.dispose();\n      ctx.rippleSubs.delete(sub);\n    };\n  }\n\n  /* ======== R5: Connect — per-binding debounce timer ======== */\n\n  function connect<K extends FlatKeyOf<TValues>>(\n    name: K,\n    config?: ConnectOptions,\n  ): ConnectionResult<TypeAtPath<TValues, K>> {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    const touchOnBlur = config?.touchOnBlur ?? ctx.connectDefaults.touchOnBlur ?? false;\n    const validateOnBlur = config?.validateOnBlur ?? ctx.connectDefaults.validateOnBlur ?? false;\n    const validateOnChange = config?.validateOnChange ?? ctx.connectDefaults.validateOnChange ?? false;\n    const validateOnTouch = config?.validateOnTouch ?? ctx.connectDefaults.validateOnTouch ?? false;\n    const debounceMs = config?.debounce ?? ctx.connectDefaults.debounce ?? 0;\n\n    // R5: each connect() call owns its own timer — cancelling one binding never affects another.\n    let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n    function scheduleValidation(): void {\n      if (debounceMs > 0) {\n        if (debounceTimer !== null) clearTimeout(debounceTimer);\n\n        debounceTimer = setTimeout(() => {\n          debounceTimer = null;\n\n          if (ctx.disposed) return;\n\n          void deps.validateFields([name]).catch((err: unknown) => {\n            if (!isAbortError(err)) throw err;\n          });\n        }, debounceMs);\n      } else {\n        void deps.validateFields([name]).catch((err: unknown) => {\n          if (!isAbortError(err)) throw err;\n        });\n      }\n    }\n\n    let bindingDisposed = false;\n\n    return {\n      get dirty() {\n        return ctx.dirty.has(key);\n      },\n      /** Cancels this binding's own debounce timer. Does not affect other bindings for the same field. */\n      dispose() {\n        bindingDisposed = true;\n\n        if (debounceTimer !== null) {\n          clearTimeout(debounceTimer);\n          debounceTimer = null;\n        }\n      },\n      get disposed() {\n        return bindingDisposed;\n      },\n      get error() {\n        return ctx.fieldErrors.get(key);\n      },\n      onBlur: () => {\n        if (ctx.disposed) return;\n\n        if (touchOnBlur) deps.touch(name);\n\n        if (validateOnBlur) scheduleValidation();\n      },\n      onChange: (value: TypeAtPath<TValues, K>) => {\n        if (ctx.disposed) return;\n\n        deps.set(name, value);\n\n        const shouldValidate = validateOnChange || (validateOnTouch && ctx.touched.has(key));\n\n        if (shouldValidate) scheduleValidation();\n      },\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get touched() {\n        return ctx.touched.has(key);\n      },\n      get value() {\n        return ctx.store.get(key) as TypeAtPath<TValues, K>;\n      },\n    };\n  }\n\n  /* ======== Async iterator (for await...of form) ======== */\n\n  function createAsyncIterator(): AsyncIterableIterator<FormState> {\n    const queue = createAsyncQueue<FormState>(() => unsubscribe());\n\n    queue.push(ctx.getStateSnapshot());\n\n    const unsubscribe = subscribe((state) => {\n      queue.push(state);\n    });\n\n    ctx.disposeController.signal.addEventListener('abort', () => queue.terminate(), { once: true });\n\n    return queue.iterator;\n  }\n\n  return { connect, subscribe, subscribeField, [Symbol.asyncIterator]: createAsyncIterator };\n}\n"],"mappings":"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"}
+{"version":3,"file":"observe.cjs","names":[],"sources":["../../src/core/observe.ts"],"sourcesContent":["import { isAbortError } from '@vielzeug/arsenal';\n\nimport type { FormContext } from './context';\nimport type { FieldOps } from './fields';\n\nimport { assertSafeKey } from '../_utils';\nimport {\n  type ConnectionResult,\n  type ConnectOptions,\n  type FieldState,\n  type FlatKeyOf,\n  type FormState,\n  type SubscribeOptions,\n  type TypeAtPath,\n  type Unsubscribe,\n} from '../types';\nimport { createAsyncQueue } from './asyncQueue';\n\ntype ObserveDeps<TValues extends Record<string, unknown>> = Pick<\n  FieldOps<TValues>,\n  'set' | 'touch' | 'validateFields'\n> & {\n  /** Default `connect()` options — form-level, not part of the shared `FormContext` bag. */\n  connectDefaults: ConnectOptions;\n};\n\n/**\n * Observation operations: `subscribe`/`subscribeField` (thin pass-throughs to the notifier\n * owned by `FormContext`), `connect` (per-binding debounce timer), and the\n * `[Symbol.asyncIterator]` implementation.\n */\nexport function createObserveOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: ObserveDeps<TValues>,\n) {\n  function subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    return ctx.subscribe(listener, options);\n  }\n\n  function subscribeField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    listener: (state: FieldState<TypeAtPath<TValues, K>>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe {\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    return ctx.subscribeField(key, listener as (state: FieldState<unknown>) => void, options);\n  }\n\n  /* ======== R5: Connect — per-binding debounce timer ======== */\n\n  function connect<K extends FlatKeyOf<TValues>>(\n    name: K,\n    config?: ConnectOptions,\n  ): ConnectionResult<TypeAtPath<TValues, K>> {\n    ctx.ensureNotDisposed('connect');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    // Three-way fallback (per-call config -> form-level default -> hard default), one place\n    // instead of a copy-pasted `config?.x ?? deps.connectDefaults.x ?? fallback` per option.\n    function resolve<Opt extends keyof ConnectOptions>(option: Opt, fallback: NonNullable<ConnectOptions[Opt]>) {\n      return config?.[option] ?? deps.connectDefaults[option] ?? fallback;\n    }\n\n    const touchOnBlur = resolve('touchOnBlur', false);\n    const validateOnBlur = resolve('validateOnBlur', false);\n    const validateOnChange = resolve('validateOnChange', false);\n    const validateOnTouch = resolve('validateOnTouch', false);\n    const debounceMs = resolve('debounce', 0);\n\n    // R5: each connect() call owns its own timer — cancelling one binding never affects another.\n    let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n    function scheduleValidation(): void {\n      if (debounceMs > 0) {\n        if (debounceTimer !== null) clearTimeout(debounceTimer);\n\n        debounceTimer = setTimeout(() => {\n          debounceTimer = null;\n\n          if (ctx.disposed) return;\n\n          void deps.validateFields([name]).catch((err: unknown) => {\n            if (!isAbortError(err)) throw err;\n          });\n        }, debounceMs);\n      } else {\n        void deps.validateFields([name]).catch((err: unknown) => {\n          if (!isAbortError(err)) throw err;\n        });\n      }\n    }\n\n    let bindingDisposed = false;\n\n    return {\n      get dirty() {\n        return ctx.dirty.has(key);\n      },\n      /** Cancels this binding's own debounce timer. Does not affect other bindings for the same field. */\n      dispose() {\n        bindingDisposed = true;\n\n        if (debounceTimer !== null) {\n          clearTimeout(debounceTimer);\n          debounceTimer = null;\n        }\n      },\n      get disposed() {\n        return bindingDisposed;\n      },\n      get error() {\n        return ctx.fieldErrors.get(key);\n      },\n      onBlur: () => {\n        if (ctx.disposed) return;\n\n        if (touchOnBlur) deps.touch(name);\n\n        if (validateOnBlur) scheduleValidation();\n      },\n      onChange: (value: TypeAtPath<TValues, K>) => {\n        if (ctx.disposed) return;\n\n        deps.set(name, value);\n\n        const shouldValidate = validateOnChange || (validateOnTouch && ctx.touched.has(key));\n\n        if (shouldValidate) scheduleValidation();\n      },\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get touched() {\n        return ctx.touched.has(key);\n      },\n      get value() {\n        return ctx.store.get(key) as TypeAtPath<TValues, K>;\n      },\n    };\n  }\n\n  /* ======== Async iterator (for await...of form) ======== */\n\n  function createAsyncIterator(): AsyncIterableIterator<FormState> {\n    const queue = createAsyncQueue<FormState>(() => unsubscribe());\n\n    queue.push(ctx.getStateSnapshot());\n\n    const unsubscribe = subscribe((state) => {\n      queue.push(state);\n    });\n\n    ctx.disposeController.signal.addEventListener('abort', () => queue.terminate(), { once: true });\n\n    return queue.iterator;\n  }\n\n  return { connect, subscribe, subscribeField, [Symbol.asyncIterator]: createAsyncIterator };\n}\n"],"mappings":"kGA+BA,SAAgB,EACd,EACA,EACA,CACA,SAAS,EAAU,EAAsC,EAAyC,CAChG,OAAO,EAAI,UAAU,EAAU,CAAO,CACxC,CAEA,SAAS,EACP,EACA,EACA,EACa,CACb,IAAM,EAAM,EAIZ,OAFA,EAAA,cAAc,CAAG,EAEV,EAAI,eAAe,EAAK,EAAkD,CAAO,CAC1F,CAIA,SAAS,EACP,EACA,EAC0C,CAC1C,EAAI,kBAAkB,SAAS,EAE/B,IAAM,EAAM,EAEZ,EAAA,cAAc,CAAG,EAIjB,SAAS,EAA0C,EAAa,EAA4C,CAC1G,OAAO,IAAS,IAAW,EAAK,gBAAgB,IAAW,CAC7D,CAEA,IAAM,EAAc,EAAQ,cAAe,EAAK,EAC1C,EAAiB,EAAQ,iBAAkB,EAAK,EAChD,EAAmB,EAAQ,mBAAoB,EAAK,EACpD,EAAkB,EAAQ,kBAAmB,EAAK,EAClD,EAAa,EAAQ,WAAY,CAAC,EAGpC,EAAsD,KAE1D,SAAS,GAA2B,CAC9B,EAAa,GACX,IAAkB,MAAM,aAAa,CAAa,EAEtD,EAAgB,eAAiB,CAC/B,EAAgB,KAEZ,GAAI,UAER,EAAU,eAAe,CAAC,CAAI,CAAC,CAAC,CAAC,MAAO,GAAiB,CACvD,GAAI,EAAA,EAAA,EAAA,aAAA,CAAc,CAAG,EAAG,MAAM,CAChC,CAAC,CACH,EAAG,CAAU,GAEb,EAAU,eAAe,CAAC,CAAI,CAAC,CAAC,CAAC,MAAO,GAAiB,CACvD,GAAI,EAAA,EAAA,EAAA,aAAA,CAAc,CAAG,EAAG,MAAM,CAChC,CAAC,CAEL,CAEA,IAAI,EAAkB,GAEtB,MAAO,CACL,IAAI,OAAQ,CACV,OAAO,EAAI,MAAM,IAAI,CAAG,CAC1B,EAEA,SAAU,CACR,EAAkB,GAEd,IAAkB,OACpB,aAAa,CAAa,EAC1B,EAAgB,KAEpB,EACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,IAAI,OAAQ,CACV,OAAO,EAAI,YAAY,IAAI,CAAG,CAChC,EACA,WAAc,CACR,EAAI,WAEJ,GAAa,EAAK,MAAM,CAAI,EAE5B,GAAgB,EAAmB,EACzC,EACA,SAAW,GAAkC,CACvC,EAAI,WAER,EAAK,IAAI,EAAM,CAAK,GAEG,GAAqB,GAAmB,EAAI,QAAQ,IAAI,CAAG,IAE9D,EAAmB,EACzC,EACA,CAAC,OAAO,UAAW,CACjB,KAAK,QAAQ,CACf,EACA,IAAI,SAAU,CACZ,OAAO,EAAI,QAAQ,IAAI,CAAG,CAC5B,EACA,IAAI,OAAQ,CACV,OAAO,EAAI,MAAM,IAAI,CAAG,CAC1B,CACF,CACF,CAIA,SAAS,GAAwD,CAC/D,IAAM,EAAQ,EAAA,qBAAkC,EAAY,CAAC,EAE7D,EAAM,KAAK,EAAI,iBAAiB,CAAC,EAEjC,IAAM,EAAc,EAAW,GAAU,CACvC,EAAM,KAAK,CAAK,CAClB,CAAC,EAID,OAFA,EAAI,kBAAkB,OAAO,iBAAiB,YAAe,EAAM,UAAU,EAAG,CAAE,KAAM,EAAK,CAAC,EAEvF,EAAM,QACf,CAEA,MAAO,CAAE,UAAS,YAAW,kBAAiB,OAAO,eAAgB,CAAoB,CAC3F"}

package/dist/core/observe.d.ts

@@ -1,12 +1,14 @@
 import type { FormContext } from './context';
-import type { ValidationOps } from './validation';
-import type { ValueOps } from './values';
+import type { FieldOps } from './fields';
 import { type ConnectionResult, type ConnectOptions, type FieldState, type FlatKeyOf, type FormState, type SubscribeOptions, type TypeAtPath, type Unsubscribe } from '../types';
-type ObserveDeps<TValues extends Record<string, unknown>> = Pick<ValueOps<TValues>, 'set' | 'touch'> & Pick<ValidationOps<TValues>, 'validateFields'>;
+type ObserveDeps<TValues extends Record<string, unknown>> = Pick<FieldOps<TValues>, 'set' | 'touch' | 'validateFields'> & {
+    /** Default `connect()` options — form-level, not part of the shared `FormContext` bag. */
+    connectDefaults: ConnectOptions;
+};
 /**
- * Observation operations: `subscribe`/`subscribeField`, `connect` (per-binding debounce timer),
- * and the `[Symbol.asyncIterator]` implementation. Moved verbatim from `createForm()`'s
- * "Subscriptions", "Connect", and "Async iterator" sections.
+ * Observation operations: `subscribe`/`subscribeField` (thin pass-throughs to the notifier
+ * owned by `FormContext`), `connect` (per-binding debounce timer), and the
+ * `[Symbol.asyncIterator]` implementation.
  */
 export declare function createObserveOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>, deps: ObserveDeps<TValues>): {
     connect: <K extends FlatKeyOf<TValues>>(name: K, config?: ConnectOptions) => ConnectionResult<TypeAtPath<TValues, K>>;

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

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/core/observe.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAGlB,KAAK,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,GAClG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,EACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;cAiDT,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QACrC,CAAC,WACE,cAAc,KACtB,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;0BAlDd,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,YAAY,gBAAgB,KAAG,WAAW;qBAkBzE,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QAC5C,CAAC,YACG,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,YACnD,gBAAgB,KACzB,WAAW;kCAmHkB,qBAAqB,CAAC,SAAS,CAAC;EAejE"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/core/observe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAGlB,KAAK,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAC9D,QAAQ,CAAC,OAAO,CAAC,EACjB,KAAK,GAAG,OAAO,GAAG,gBAAgB,CACnC,GAAG;IACF,0FAA0F;IAC1F,eAAe,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,EACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;cAoBT,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QACrC,CAAC,WACE,cAAc,KACtB,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;0BArBd,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,YAAY,gBAAgB,KAAG,WAAW;qBAIzE,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QAC5C,CAAC,YACG,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,YACnD,gBAAgB,KACzB,WAAW;kCA0GkB,qBAAqB,CAAC,SAAS,CAAC;EAejE"}

package/dist/core/observe.js

@@ -1,90 +1,79 @@
 import { assertSafeKey as e } from "../_utils.js";
 import { createAsyncQueue as t } from "./asyncQueue.js";
 import { isAbortError as n } from "@vielzeug/arsenal";
-import { watch as r } from "@vielzeug/ripple";
 //#region src/core/observe.ts
-function i(i, a) {
-	function o(e, t) {
-		if (i.disposed) return () => {};
-		let n = r(i.formStateSignal, (t) => {
-			e(t);
-		});
-		return i.rippleSubs.add(n), t?.sync && e(i.formStateSignal.value), () => {
-			n.dispose(), i.rippleSubs.delete(n);
-		};
+function r(r, i) {
+	function a(e, t) {
+		return r.subscribe(e, t);
 	}
-	function s(t, n, a) {
-		if (i.disposed) return () => {};
-		let o = t;
-		e(o);
-		let s = i.getOrCreateFieldSignal(o), c = r(s, (e) => {
-			n(e);
-		});
-		return i.rippleSubs.add(c), a?.sync && n(s.value), () => {
-			c.dispose(), i.rippleSubs.delete(c);
-		};
+	function o(t, n, i) {
+		let a = t;
+		return e(a), r.subscribeField(a, n, i);
 	}
-	function c(t, r) {
-		i.ensureNotDisposed();
+	function s(t, a) {
+		r.ensureNotDisposed("connect");
 		let o = t;
 		e(o);
-		let s = r?.touchOnBlur ?? i.connectDefaults.touchOnBlur ?? !1, c = r?.validateOnBlur ?? i.connectDefaults.validateOnBlur ?? !1, l = r?.validateOnChange ?? i.connectDefaults.validateOnChange ?? !1, u = r?.validateOnTouch ?? i.connectDefaults.validateOnTouch ?? !1, d = r?.debounce ?? i.connectDefaults.debounce ?? 0, f = null;
-		function p() {
-			d > 0 ? (f !== null && clearTimeout(f), f = setTimeout(() => {
-				f = null, !i.disposed && a.validateFields([t]).catch((e) => {
+		function s(e, t) {
+			return a?.[e] ?? i.connectDefaults[e] ?? t;
+		}
+		let c = s("touchOnBlur", !1), l = s("validateOnBlur", !1), u = s("validateOnChange", !1), d = s("validateOnTouch", !1), f = s("debounce", 0), p = null;
+		function m() {
+			f > 0 ? (p !== null && clearTimeout(p), p = setTimeout(() => {
+				p = null, !r.disposed && i.validateFields([t]).catch((e) => {
 					if (!n(e)) throw e;
 				});
-			}, d)) : a.validateFields([t]).catch((e) => {
+			}, f)) : i.validateFields([t]).catch((e) => {
 				if (!n(e)) throw e;
 			});
 		}
-		let m = !1;
+		let h = !1;
 		return {
 			get dirty() {
-				return i.dirty.has(o);
+				return r.dirty.has(o);
 			},
 			dispose() {
-				m = !0, f !== null && (clearTimeout(f), f = null);
+				h = !0, p !== null && (clearTimeout(p), p = null);
 			},
 			get disposed() {
-				return m;
+				return h;
 			},
 			get error() {
-				return i.fieldErrors.get(o);
+				return r.fieldErrors.get(o);
 			},
 			onBlur: () => {
-				i.disposed || (s && a.touch(t), c && p());
+				r.disposed || (c && i.touch(t), l && m());
 			},
 			onChange: (e) => {
-				i.disposed || (a.set(t, e), (l || u && i.touched.has(o)) && p());
+				r.disposed || (i.set(t, e), (u || d && r.touched.has(o)) && m());
 			},
 			[Symbol.dispose]() {
 				this.dispose();
 			},
 			get touched() {
-				return i.touched.has(o);
+				return r.touched.has(o);
 			},
 			get value() {
-				return i.store.get(o);
+				return r.store.get(o);
 			}
 		};
 	}
-	function l() {
+	function c() {
 		let e = t(() => n());
-		e.push(i.getStateSnapshot());
-		let n = o((t) => {
+		e.push(r.getStateSnapshot());
+		let n = a((t) => {
 			e.push(t);
 		});
-		return i.disposeController.signal.addEventListener("abort", () => e.terminate(), { once: !0 }), e.iterator;
+		return r.disposeController.signal.addEventListener("abort", () => e.terminate(), { once: !0 }), e.iterator;
 	}
 	return {
-		connect: c,
-		subscribe: o,
-		subscribeField: s,
-		[Symbol.asyncIterator]: l
+		connect: s,
+		subscribe: a,
+		subscribeField: o,
+		[Symbol.asyncIterator]: c
 	};
 }
 //#endregion
-export { i as createObserveOps };
+export { r as createObserveOps };
 
 //# sourceMappingURL=observe.js.map

package/dist/core/observe.js.map

@@ -1 +1 @@
-{"version":3,"file":"observe.js","names":[],"sources":["../../src/core/observe.ts"],"sourcesContent":["import { isAbortError } from '@vielzeug/arsenal';\nimport { watch } from '@vielzeug/ripple';\n\nimport type { FormContext } from './context';\nimport type { ValidationOps } from './validation';\nimport type { ValueOps } from './values';\n\nimport { assertSafeKey } from '../_utils';\nimport {\n  type ConnectionResult,\n  type ConnectOptions,\n  type FieldState,\n  type FlatKeyOf,\n  type FormState,\n  type SubscribeOptions,\n  type TypeAtPath,\n  type Unsubscribe,\n} from '../types';\nimport { createAsyncQueue } from './asyncQueue';\n\ntype ObserveDeps<TValues extends Record<string, unknown>> = Pick<ValueOps<TValues>, 'set' | 'touch'> &\n  Pick<ValidationOps<TValues>, 'validateFields'>;\n\n/**\n * Observation operations: `subscribe`/`subscribeField`, `connect` (per-binding debounce timer),\n * and the `[Symbol.asyncIterator]` implementation. Moved verbatim from `createForm()`'s\n * \"Subscriptions\", \"Connect\", and \"Async iterator\" sections.\n */\nexport function createObserveOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: ObserveDeps<TValues>,\n) {\n  function subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    if (ctx.disposed) return () => {};\n\n    // Wrap listener so it always returns void — ripple watch throws on non-function returns.\n    const sub = watch(ctx.formStateSignal, (state) => {\n      listener(state);\n    });\n\n    ctx.rippleSubs.add(sub);\n\n    if (options?.sync) listener(ctx.formStateSignal.value);\n\n    return () => {\n      sub.dispose();\n      ctx.rippleSubs.delete(sub);\n    };\n  }\n\n  function subscribeField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    listener: (state: FieldState<TypeAtPath<TValues, K>>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe {\n    if (ctx.disposed) return () => {};\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    const sig = ctx.getOrCreateFieldSignal(key);\n    // Wrap listener so it always returns void — ripple watch throws on non-function returns.\n    const sub = watch(sig, (state) => {\n      (listener as (state: FieldState<unknown>) => void)(state);\n    });\n\n    ctx.rippleSubs.add(sub);\n\n    if (options?.sync) listener(sig.value as FieldState<TypeAtPath<TValues, K>>);\n\n    return () => {\n      sub.dispose();\n      ctx.rippleSubs.delete(sub);\n    };\n  }\n\n  /* ======== R5: Connect — per-binding debounce timer ======== */\n\n  function connect<K extends FlatKeyOf<TValues>>(\n    name: K,\n    config?: ConnectOptions,\n  ): ConnectionResult<TypeAtPath<TValues, K>> {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    const touchOnBlur = config?.touchOnBlur ?? ctx.connectDefaults.touchOnBlur ?? false;\n    const validateOnBlur = config?.validateOnBlur ?? ctx.connectDefaults.validateOnBlur ?? false;\n    const validateOnChange = config?.validateOnChange ?? ctx.connectDefaults.validateOnChange ?? false;\n    const validateOnTouch = config?.validateOnTouch ?? ctx.connectDefaults.validateOnTouch ?? false;\n    const debounceMs = config?.debounce ?? ctx.connectDefaults.debounce ?? 0;\n\n    // R5: each connect() call owns its own timer — cancelling one binding never affects another.\n    let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n    function scheduleValidation(): void {\n      if (debounceMs > 0) {\n        if (debounceTimer !== null) clearTimeout(debounceTimer);\n\n        debounceTimer = setTimeout(() => {\n          debounceTimer = null;\n\n          if (ctx.disposed) return;\n\n          void deps.validateFields([name]).catch((err: unknown) => {\n            if (!isAbortError(err)) throw err;\n          });\n        }, debounceMs);\n      } else {\n        void deps.validateFields([name]).catch((err: unknown) => {\n          if (!isAbortError(err)) throw err;\n        });\n      }\n    }\n\n    let bindingDisposed = false;\n\n    return {\n      get dirty() {\n        return ctx.dirty.has(key);\n      },\n      /** Cancels this binding's own debounce timer. Does not affect other bindings for the same field. */\n      dispose() {\n        bindingDisposed = true;\n\n        if (debounceTimer !== null) {\n          clearTimeout(debounceTimer);\n          debounceTimer = null;\n        }\n      },\n      get disposed() {\n        return bindingDisposed;\n      },\n      get error() {\n        return ctx.fieldErrors.get(key);\n      },\n      onBlur: () => {\n        if (ctx.disposed) return;\n\n        if (touchOnBlur) deps.touch(name);\n\n        if (validateOnBlur) scheduleValidation();\n      },\n      onChange: (value: TypeAtPath<TValues, K>) => {\n        if (ctx.disposed) return;\n\n        deps.set(name, value);\n\n        const shouldValidate = validateOnChange || (validateOnTouch && ctx.touched.has(key));\n\n        if (shouldValidate) scheduleValidation();\n      },\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get touched() {\n        return ctx.touched.has(key);\n      },\n      get value() {\n        return ctx.store.get(key) as TypeAtPath<TValues, K>;\n      },\n    };\n  }\n\n  /* ======== Async iterator (for await...of form) ======== */\n\n  function createAsyncIterator(): AsyncIterableIterator<FormState> {\n    const queue = createAsyncQueue<FormState>(() => unsubscribe());\n\n    queue.push(ctx.getStateSnapshot());\n\n    const unsubscribe = subscribe((state) => {\n      queue.push(state);\n    });\n\n    ctx.disposeController.signal.addEventListener('abort', () => queue.terminate(), { once: true });\n\n    return queue.iterator;\n  }\n\n  return { connect, subscribe, subscribeField, [Symbol.asyncIterator]: createAsyncIterator };\n}\n"],"mappings":"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"}
+{"version":3,"file":"observe.js","names":[],"sources":["../../src/core/observe.ts"],"sourcesContent":["import { isAbortError } from '@vielzeug/arsenal';\n\nimport type { FormContext } from './context';\nimport type { FieldOps } from './fields';\n\nimport { assertSafeKey } from '../_utils';\nimport {\n  type ConnectionResult,\n  type ConnectOptions,\n  type FieldState,\n  type FlatKeyOf,\n  type FormState,\n  type SubscribeOptions,\n  type TypeAtPath,\n  type Unsubscribe,\n} from '../types';\nimport { createAsyncQueue } from './asyncQueue';\n\ntype ObserveDeps<TValues extends Record<string, unknown>> = Pick<\n  FieldOps<TValues>,\n  'set' | 'touch' | 'validateFields'\n> & {\n  /** Default `connect()` options — form-level, not part of the shared `FormContext` bag. */\n  connectDefaults: ConnectOptions;\n};\n\n/**\n * Observation operations: `subscribe`/`subscribeField` (thin pass-throughs to the notifier\n * owned by `FormContext`), `connect` (per-binding debounce timer), and the\n * `[Symbol.asyncIterator]` implementation.\n */\nexport function createObserveOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: ObserveDeps<TValues>,\n) {\n  function subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    return ctx.subscribe(listener, options);\n  }\n\n  function subscribeField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    listener: (state: FieldState<TypeAtPath<TValues, K>>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe {\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    return ctx.subscribeField(key, listener as (state: FieldState<unknown>) => void, options);\n  }\n\n  /* ======== R5: Connect — per-binding debounce timer ======== */\n\n  function connect<K extends FlatKeyOf<TValues>>(\n    name: K,\n    config?: ConnectOptions,\n  ): ConnectionResult<TypeAtPath<TValues, K>> {\n    ctx.ensureNotDisposed('connect');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    // Three-way fallback (per-call config -> form-level default -> hard default), one place\n    // instead of a copy-pasted `config?.x ?? deps.connectDefaults.x ?? fallback` per option.\n    function resolve<Opt extends keyof ConnectOptions>(option: Opt, fallback: NonNullable<ConnectOptions[Opt]>) {\n      return config?.[option] ?? deps.connectDefaults[option] ?? fallback;\n    }\n\n    const touchOnBlur = resolve('touchOnBlur', false);\n    const validateOnBlur = resolve('validateOnBlur', false);\n    const validateOnChange = resolve('validateOnChange', false);\n    const validateOnTouch = resolve('validateOnTouch', false);\n    const debounceMs = resolve('debounce', 0);\n\n    // R5: each connect() call owns its own timer — cancelling one binding never affects another.\n    let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n    function scheduleValidation(): void {\n      if (debounceMs > 0) {\n        if (debounceTimer !== null) clearTimeout(debounceTimer);\n\n        debounceTimer = setTimeout(() => {\n          debounceTimer = null;\n\n          if (ctx.disposed) return;\n\n          void deps.validateFields([name]).catch((err: unknown) => {\n            if (!isAbortError(err)) throw err;\n          });\n        }, debounceMs);\n      } else {\n        void deps.validateFields([name]).catch((err: unknown) => {\n          if (!isAbortError(err)) throw err;\n        });\n      }\n    }\n\n    let bindingDisposed = false;\n\n    return {\n      get dirty() {\n        return ctx.dirty.has(key);\n      },\n      /** Cancels this binding's own debounce timer. Does not affect other bindings for the same field. */\n      dispose() {\n        bindingDisposed = true;\n\n        if (debounceTimer !== null) {\n          clearTimeout(debounceTimer);\n          debounceTimer = null;\n        }\n      },\n      get disposed() {\n        return bindingDisposed;\n      },\n      get error() {\n        return ctx.fieldErrors.get(key);\n      },\n      onBlur: () => {\n        if (ctx.disposed) return;\n\n        if (touchOnBlur) deps.touch(name);\n\n        if (validateOnBlur) scheduleValidation();\n      },\n      onChange: (value: TypeAtPath<TValues, K>) => {\n        if (ctx.disposed) return;\n\n        deps.set(name, value);\n\n        const shouldValidate = validateOnChange || (validateOnTouch && ctx.touched.has(key));\n\n        if (shouldValidate) scheduleValidation();\n      },\n      [Symbol.dispose]() {\n        this.dispose();\n      },\n      get touched() {\n        return ctx.touched.has(key);\n      },\n      get value() {\n        return ctx.store.get(key) as TypeAtPath<TValues, K>;\n      },\n    };\n  }\n\n  /* ======== Async iterator (for await...of form) ======== */\n\n  function createAsyncIterator(): AsyncIterableIterator<FormState> {\n    const queue = createAsyncQueue<FormState>(() => unsubscribe());\n\n    queue.push(ctx.getStateSnapshot());\n\n    const unsubscribe = subscribe((state) => {\n      queue.push(state);\n    });\n\n    ctx.disposeController.signal.addEventListener('abort', () => queue.terminate(), { once: true });\n\n    return queue.iterator;\n  }\n\n  return { connect, subscribe, subscribeField, [Symbol.asyncIterator]: createAsyncIterator };\n}\n"],"mappings":";;;;AA+BA,SAAgB,EACd,GACA,GACA;CACA,SAAS,EAAU,GAAsC,GAAyC;EAChG,OAAO,EAAI,UAAU,GAAU,CAAO;CACxC;CAEA,SAAS,EACP,GACA,GACA,GACa;EACb,IAAM,IAAM;EAIZ,OAFA,EAAc,CAAG,GAEV,EAAI,eAAe,GAAK,GAAkD,CAAO;CAC1F;CAIA,SAAS,EACP,GACA,GAC0C;EAC1C,EAAI,kBAAkB,SAAS;EAE/B,IAAM,IAAM;EAEZ,EAAc,CAAG;EAIjB,SAAS,EAA0C,GAAa,GAA4C;GAC1G,OAAO,IAAS,MAAW,EAAK,gBAAgB,MAAW;EAC7D;EAEA,IAAM,IAAc,EAAQ,eAAe,EAAK,GAC1C,IAAiB,EAAQ,kBAAkB,EAAK,GAChD,IAAmB,EAAQ,oBAAoB,EAAK,GACpD,IAAkB,EAAQ,mBAAmB,EAAK,GAClD,IAAa,EAAQ,YAAY,CAAC,GAGpC,IAAsD;EAE1D,SAAS,IAA2B;GAClC,AAAI,IAAa,KACX,MAAkB,QAAM,aAAa,CAAa,GAEtD,IAAgB,iBAAiB;IAC/B,IAAgB,MAEZ,GAAI,YAER,EAAU,eAAe,CAAC,CAAI,CAAC,CAAC,CAAC,OAAO,MAAiB;KACvD,IAAI,CAAC,EAAa,CAAG,GAAG,MAAM;IAChC,CAAC;GACH,GAAG,CAAU,KAEb,EAAU,eAAe,CAAC,CAAI,CAAC,CAAC,CAAC,OAAO,MAAiB;IACvD,IAAI,CAAC,EAAa,CAAG,GAAG,MAAM;GAChC,CAAC;EAEL;EAEA,IAAI,IAAkB;EAEtB,OAAO;GACL,IAAI,QAAQ;IACV,OAAO,EAAI,MAAM,IAAI,CAAG;GAC1B;GAEA,UAAU;IAGR,AAFA,IAAkB,IAEd,MAAkB,SACpB,aAAa,CAAa,GAC1B,IAAgB;GAEpB;GACA,IAAI,WAAW;IACb,OAAO;GACT;GACA,IAAI,QAAQ;IACV,OAAO,EAAI,YAAY,IAAI,CAAG;GAChC;GACA,cAAc;IACR,EAAI,aAEJ,KAAa,EAAK,MAAM,CAAI,GAE5B,KAAgB,EAAmB;GACzC;GACA,WAAW,MAAkC;IACvC,EAAI,aAER,EAAK,IAAI,GAAM,CAAK,IAEG,KAAqB,KAAmB,EAAI,QAAQ,IAAI,CAAG,MAE9D,EAAmB;GACzC;GACA,CAAC,OAAO,WAAW;IACjB,KAAK,QAAQ;GACf;GACA,IAAI,UAAU;IACZ,OAAO,EAAI,QAAQ,IAAI,CAAG;GAC5B;GACA,IAAI,QAAQ;IACV,OAAO,EAAI,MAAM,IAAI,CAAG;GAC1B;EACF;CACF;CAIA,SAAS,IAAwD;EAC/D,IAAM,IAAQ,QAAkC,EAAY,CAAC;EAE7D,EAAM,KAAK,EAAI,iBAAiB,CAAC;EAEjC,IAAM,IAAc,GAAW,MAAU;GACvC,EAAM,KAAK,CAAK;EAClB,CAAC;EAID,OAFA,EAAI,kBAAkB,OAAO,iBAAiB,eAAe,EAAM,UAAU,GAAG,EAAE,MAAM,GAAK,CAAC,GAEvF,EAAM;CACf;CAEA,OAAO;EAAE;EAAS;EAAW;GAAiB,OAAO,gBAAgB;CAAoB;AAC3F"}

package/dist/core/scope.cjs

@@ -1,2 +1,2 @@
-const e=require("../errors.cjs");require("../_utils.cjs");let t=require("@vielzeug/arsenal");function n(r,i){let a=`${i}.`;function o(e){return`${i}.${e}`}function s(e){return e===i||e.startsWith(a)}function c(e){return e.startsWith(a)?e.slice(a.length):e}function l(){let e=r.getStateSnapshot(),t=Object.fromEntries(Object.entries(e.errors).filter(([e])=>s(e)).map(([e,t])=>[c(e),t])),n=e.touchedFields.filter(s).map(c),i=e.validatingFields.filter(s).map(c),a=Object.keys(t).length===0,o=[...r.dirty].some(s),l=[...r.touched].some(s),u=i.length>0;return Object.freeze({errors:Object.freeze(t),isDirty:o,isLoading:e.isLoading,isSubmitting:e.isSubmitting,isTouched:l,isValid:a,isValidating:u,submitCount:e.submitCount,touchedFields:Object.freeze(n),validatingFields:Object.freeze(i)})}function u(){let e={};for(let[t,n]of r.store)t.startsWith(a)&&(e[t.slice(a.length)]=n);return(0,t.unflattenPaths)(e)}function d(){let e=new Set;for(let t of r.store.keys())s(t)&&e.add(c(t));for(let t of r.validators.keys())s(t)&&e.add(c(t));return Object.freeze([...e])}function f(){r.ensureNotDisposed();for(let e of r.store.keys())s(e)&&r.touched.add(e);for(let e of r.validators.keys())s(e)&&r.touched.add(e);r.requestNotify()}function p(){r.ensureNotDisposed();for(let e of[...r.touched])s(e)&&r.touched.delete(e);r.requestNotify()}function m(){r.ensureNotDisposed();for(let e of[...r.store.keys()])s(e)&&(r.fieldCtrls.get(e)?.abort(),r.fieldCtrls.delete(e),r.store.set(e,r.baseline.get(e)),r.dirty.delete(e),r.touched.delete(e),r.fieldErrors.delete(e)&&r.invalidateErrors());r.requestNotify()}function h(e){r.ensureNotDisposed();for(let e of[...r.fieldCtrls.keys()])s(e)&&(r.fieldCtrls.get(e)?.abort(),r.fieldCtrls.delete(e));let n=(0,t.flattenPaths)(e);for(let e of[...r.store.keys()])s(e)&&(r.store.delete(e),r.baseline.delete(e),r.dirty.delete(e),r.touched.delete(e),r.fieldErrors.delete(e));r.invalidateErrors();for(let[e,t]of Object.entries(n)){let n=o(e);r.store.set(n,t),r.baseline.set(n,t)}r.requestNotify()}function g(e){r.ensureNotDisposed();let n=(0,t.flattenPaths)(e),i=[];for(let[e,t]of Object.entries(n)){let n=o(e);r.baseline.set(n,t),r.store.set(n,t),r.dirty.delete(n),i.push(n)}r.requestNotify(i)}function _(e){r.ensureNotDisposed();for(let e of[...r.fieldErrors.keys()])s(e)&&r.fieldErrors.delete(e);if(e)for(let[t,n]of Object.entries(e))typeof n==`string`&&r.fieldErrors.set(o(t),n);r.invalidateErrors(),r.requestNotify()}async function v(e,t){if(r.ensureNotDisposed(),e!==void 0&&!Array.isArray(e)&&!(e instanceof AbortSignal)){let n=o(e);await r.runValidationCore([n],`partial`,t);let i=r.fieldErrors.get(n);return{errors:i===void 0?{}:{[e]:i},valid:i===void 0}}if(Array.isArray(e)){let n=e.map(e=>o(e));await r.runValidationCore(n,`partial`,t);let i={};for(let e of n){let t=r.fieldErrors.get(e);t!==void 0&&(i[c(e)]=t)}return{errors:i,valid:Object.keys(i).length===0}}let n=e,i=[...r.validators.keys()].filter(s);await r.runValidationCore(i,`partial`,n);let a={};for(let[e,t]of r.fieldErrors)s(e)&&(a[c(e)]=t);return{errors:a,valid:Object.keys(a).length===0}}async function y(t){if(r.ensureNotDisposed(),r.isSubmitting())throw new e.ForgeSubmitError(`submit() called while a submission is already in progress`);r.root.batch(()=>{r.incrementSubmitCount(),r.setSubmitting(!0),f()});try{let e=[...r.validators.keys()].filter(s);await r.runValidationCore(e,`partial`),r.ensureNotDisposed();let n={};for(let[e,t]of r.fieldErrors)s(e)&&(n[c(e)]=t);return Object.keys(n).length>0?{errors:n,ok:!1,type:`validation`}:{ok:!0,value:await t(u())}}finally{r.setSubmitting(!1),r.isDisposed()||r.requestNotify()}}function b(e,t){let n=null;return r.root.subscribe(()=>{let t=l();if(n){let e=n,r=Object.keys(t.errors),i=Object.keys(e.errors),a=r.length===i.length&&r.every(n=>t.errors[n]===e.errors[n]),o=t.touchedFields.length===e.touchedFields.length&&t.touchedFields.every((t,n)=>t===e.touchedFields[n]),s=t.validatingFields.length===e.validatingFields.length&&t.validatingFields.every((t,n)=>t===e.validatingFields[n]);if(t.isDirty===e.isDirty&&t.isLoading===e.isLoading&&t.isSubmitting===e.isSubmitting&&t.isTouched===e.isTouched&&t.isValid===e.isValid&&t.isValidating===e.isValidating&&t.submitCount===e.submitCount&&a&&o&&s)return}n=t,e(t)},t)}function x(){return{array(e){return r.root.array(o(e))},clearError(e){r.root.clearError(o(e))},connect(e,t){return r.root.connect(o(e),t)},field(e){return r.root.field(o(e))},get(e){return r.root.get(o(e))},register(e,t){return r.root.fields.register(o(e),t)},remove(e){r.root.fields.remove(o(e))},resetField(e){r.root.resetField(o(e))},set(e,t,n){r.root.set(o(e),t,n)},setError(e,t){r.root.setError(o(e),t)},setValidator(e,t){r.root.fields.setValidator(o(e),t)},subscribeField(e,t,n){return r.root.subscribeField(o(e),t,n)},touch(e){r.root.touch(o(e))},untouch(e){r.root.untouch(o(e))}}}let S=x();return{array:e=>S.array(e),batch:e=>r.root.batch(e),clearError:e=>S.clearError(e),connect:(e,t)=>S.connect(e,t),get disposalSignal(){return r.root.disposalSignal},dispose:()=>{},get disposed(){return r.isDisposed()},field:e=>S.field(e),fields:{list:d,register:(e,t)=>S.register(e,t),remove:e=>S.remove(e),setValidator:(e,t)=>S.setValidator(e,t)},get:e=>S.get(e),get isLoading(){return r.root.isLoading},get isSubmitting(){return r.root.isSubmitting},patch:g,replace:h,reset:m,resetErrors:_,resetField:e=>S.resetField(e),restore:e=>r.root.restore(e),scope:e=>n(r,o(e)),set:(e,t,n)=>S.set(e,t,n),setError:(e,t)=>S.setError(e,t),snapshot:()=>r.root.snapshot(),get state(){return l()},submit:y,submitOrThrow:async t=>{let n=await y(t);if(!n.ok)throw new e.ForgeValidationError(n.errors);return n.value},subscribe:(e,t)=>r.root.subscribe(e,t),subscribeField:(e,t,n)=>S.subscribeField(e,t,n),subscribeScoped:b,[Symbol.asyncIterator]:()=>r.root[Symbol.asyncIterator](),[Symbol.dispose](){this.dispose()},touch:e=>S.touch(e),touchAll:f,untouch:e=>S.untouch(e),untouchAll:p,validate:v,validateStream(e){let t=r.root.validateStream(e);return{async next(){for(;;){let e=await t.next();if(e.done)return e;if(s(e.value.field))return{done:!1,value:{error:e.value.error,field:c(e.value.field)}}}},return(){return t.return?t.return():Promise.resolve({done:!0,value:void 0})},[Symbol.asyncIterator](){return this}}},values:u}}exports.createScopedForm=n;
+const e=require("../errors.cjs");require("../_utils.cjs");let t=require("@vielzeug/arsenal");function n(r,i){let{ctx:a,fieldOps:o,root:s}=r,c=`${i}.`;function l(e){return`${i}.${e}`}function u(e){return e===i||e.startsWith(c)}function d(e){return e.startsWith(c)?e.slice(c.length):e}function f(){let e=a.getStateSnapshot(),t=Object.fromEntries(Object.entries(e.errors).filter(([e])=>u(e)).map(([e,t])=>[d(e),t])),n=e.touchedFields.filter(u).map(d),r=e.validatingFields.filter(u).map(d),i=Object.keys(t).length===0,o=[...a.dirty].some(u),s=[...a.touched].some(u),c=r.length>0;return Object.freeze({errors:Object.freeze(t),isDirty:o,isLoading:e.isLoading,isSubmitting:e.isSubmitting,isTouched:s,isValid:i,isValidating:c,submitCount:e.submitCount,touchedFields:Object.freeze(n),validatingFields:Object.freeze(r)})}function p(){let e={};for(let[t,n]of a.store)t.startsWith(c)&&(e[t.slice(c.length)]=n);return(0,t.unflattenPaths)(e)}function m(){let e=new Set;for(let t of a.store.keys())u(t)&&e.add(d(t));for(let t of a.validators.keys())u(t)&&e.add(d(t));return Object.freeze([...e])}function h(){a.ensureNotDisposed(`touchAll`),o.touchAllKeys(u),a.requestNotify()}function g(){a.ensureNotDisposed(`untouchAll`),o.untouchAllKeys(u),a.requestNotify()}function _(){a.ensureNotDisposed(`reset`),o.resetKeys(u),a.requestNotify()}function v(e){a.ensureNotDisposed(`replace`),o.replaceKeys(u,(0,t.flattenPaths)(e),l),a.requestNotify()}function y(e){a.ensureNotDisposed(`patch`),a.requestNotify(o.patchKeys(e,l))}function b(e){a.ensureNotDisposed(`resetErrors`),o.resetErrorsKeys(u,e??{},l),a.requestNotify()}async function x(e,t){if(a.ensureNotDisposed(`validate`),e!==void 0&&!Array.isArray(e)&&!(e instanceof AbortSignal)){let n=l(e);await o.runValidationCore([n],`partial`,t);let r=a.fieldErrors.get(n);return{errors:r===void 0?{}:{[e]:r},valid:r===void 0}}if(Array.isArray(e)){let n=e.map(e=>l(e));await o.runValidationCore(n,`partial`,t);let r={};for(let e of n){let t=a.fieldErrors.get(e);t!==void 0&&(r[d(e)]=t)}return{errors:r,valid:Object.keys(r).length===0}}let n=e,r=[...a.validators.keys()].filter(u);await o.runValidationCore(r,`partial`,n);let i={};for(let[e,t]of a.fieldErrors)u(e)&&(i[d(e)]=t);return{errors:i,valid:Object.keys(i).length===0}}async function S(t){if(a.ensureNotDisposed(`submit`),a.isSubmittingState)throw new e.ForgeSubmitError(`submit() called while a submission is already in progress`);a.batch(()=>{a.submitCount++,a.isSubmittingState=!0,h()});try{let e=[...a.validators.keys()].filter(u);await o.runValidationCore(e,`partial`),a.ensureNotDisposed(`submit`);let n={};for(let[e,t]of a.fieldErrors)u(e)&&(n[d(e)]=t);return Object.keys(n).length>0?{errors:n,ok:!1,type:`validation`}:{ok:!0,value:await t(p())}}finally{a.isSubmittingState=!1,a.disposed||a.requestNotify()}}function C(e,t){let n=null;return s.subscribe(()=>{let t=f();if(n){let e=n,r=Object.keys(t.errors),i=Object.keys(e.errors),a=r.length===i.length&&r.every(n=>t.errors[n]===e.errors[n]),o=t.touchedFields.length===e.touchedFields.length&&t.touchedFields.every((t,n)=>t===e.touchedFields[n]),s=t.validatingFields.length===e.validatingFields.length&&t.validatingFields.every((t,n)=>t===e.validatingFields[n]);if(t.isDirty===e.isDirty&&t.isLoading===e.isLoading&&t.isSubmitting===e.isSubmitting&&t.isTouched===e.isTouched&&t.isValid===e.isValid&&t.isValidating===e.isValidating&&t.submitCount===e.submitCount&&a&&o&&s)return}n=t,e(t)},t)}function w(){return{array(e){return s.array(l(e))},clearError(e){s.clearError(l(e))},connect(e,t){return s.connect(l(e),t)},field(e){return s.field(l(e))},get(e){return s.get(l(e))},register(e,t){return s.fields.register(l(e),t)},remove(e){s.fields.remove(l(e))},resetField(e){s.resetField(l(e))},set(e,t,n){s.set(l(e),t,n)},setError(e,t){s.setError(l(e),t)},setValidator(e,t){s.fields.setValidator(l(e),t)},subscribeField(e,t,n){return s.subscribeField(l(e),t,n)},touch(e){s.touch(l(e))},untouch(e){s.untouch(l(e))}}}let T=w();return{array:e=>T.array(e),batch:e=>s.batch(e),clearError:e=>T.clearError(e),connect:(e,t)=>T.connect(e,t),get disposalSignal(){return s.disposalSignal},dispose:()=>{},get disposed(){return a.disposed},field:e=>T.field(e),fields:{list:m,register:(e,t)=>T.register(e,t),remove:e=>T.remove(e),setValidator:(e,t)=>T.setValidator(e,t)},get:e=>T.get(e),history:{restore:e=>s.history.restore(e),snapshot:()=>s.history.snapshot()},get isLoading(){return s.isLoading},get isSubmitting(){return s.isSubmitting},patch:y,replace:v,reset:_,resetErrors:b,resetField:e=>T.resetField(e),scope:e=>n(r,l(e)),set:(e,t,n)=>T.set(e,t,n),setError:(e,t)=>T.setError(e,t),get state(){return f()},submit:S,submitOrThrow:async t=>{let n=await S(t);if(!n.ok)throw new e.ForgeValidationError(n.errors);return n.value},subscribe:C,subscribeField:(e,t,n)=>T.subscribeField(e,t,n),[Symbol.asyncIterator]:()=>s[Symbol.asyncIterator](),[Symbol.dispose](){this.dispose()},touch:e=>T.touch(e),touchAll:h,untouch:e=>T.untouch(e),untouchAll:g,validate:x,values:p}}exports.createScopedForm=n;
 //# sourceMappingURL=scope.cjs.map

package/dist/core/scope.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"scope.cjs","names":[],"sources":["../../src/core/scope.ts"],"sourcesContent":["import type {\n  ArrayField,\n  ConnectOptions,\n  ConnectionResult,\n  ErrorKeyOf,\n  FieldState,\n  FieldValidator,\n  FlatKeyOf,\n  Form,\n  FormSnapshot,\n  FormState,\n  MaybePromise,\n  RegisterFieldOptions,\n  ScopedValues,\n  SetOptions,\n  SubmitResult,\n  SubscribeOptions,\n  TypeAtPath,\n  Unsubscribe,\n  ValidateResult,\n} from '../types';\n\nimport { flattenValues, unflattenValues } from '../_utils';\nimport { ForgeSubmitError, ForgeValidationError } from '../errors';\n\n/**\n * R3: Slim ScopeContext — delegates simple operations through `root: Form<TValues>`.\n * Only the Maps/Sets needed for bulk scoped operations are passed directly.\n * @internal\n */\nexport interface ScopeContext<TValues extends Record<string, unknown> = Record<string, unknown>> {\n  /** The fully-featured root form — used for all simple one-field delegations. */\n  root: Form<TValues>;\n\n  /* ---- Shared mutable state (passed by reference, needed by bulk scoped ops) ---- */\n  store: Map<string, unknown>;\n  baseline: Map<string, unknown>;\n  validators: Map<string, FieldValidator<unknown>>;\n  fieldErrors: Map<string, string>;\n  touched: Set<string>;\n  dirty: Set<string>;\n  fieldCtrls: Map<string, AbortController>;\n\n  /* ---- Scalar state accessors ---- */\n  isSubmitting(): boolean;\n  setSubmitting(value: boolean): void;\n  incrementSubmitCount(): void;\n  isDisposed(): boolean;\n\n  /* ---- Core helpers ---- */\n  ensureNotDisposed(): void;\n  invalidateErrors(): void;\n  requestNotify(target?: string | Iterable<string>): void;\n  getStateSnapshot(): FormState;\n\n  /* ---- Validation core (needed for scoped validate/submit) ---- */\n  runValidationCore(\n    fields: string[],\n    scope: 'full' | 'partial',\n    signal?: AbortSignal,\n  ): Promise<ValidateResult & { aborted: boolean }>;\n}\n\n/**\n * Creates a scoped sub-form whose field paths are relative to `pfx`.\n * All simple single-field operations delegate to `ctx.root`.\n * Only prefix-aware bulk operations (submit, validate, replace, reset, etc.) contain custom code.\n */\nexport function createScopedForm<TValues extends Record<string, unknown>, P extends string>(\n  ctx: ScopeContext<TValues>,\n  pfx: P,\n): Form<ScopedValues<TValues, P>> {\n  const pfxDot = `${pfx}.`;\n\n  function pre(name: string): string {\n    return `${pfx}.${name}`;\n  }\n\n  function isScopedKey(key: string): boolean {\n    return key === pfx || key.startsWith(pfxDot);\n  }\n\n  function unscope(key: string): string {\n    return key.startsWith(pfxDot) ? key.slice(pfxDot.length) : key;\n  }\n\n  /* ---- Non-trivial scoped implementations ---- */\n\n  /**\n   * Compute a scoped projection of FormState from current raw Maps.\n   * Errors, touchedFields, validatingFields, isValid, isDirty, isTouched reflect only\n   * fields within the prefix. isSubmitting, isLoading, isValidating, submitCount are full-form.\n   */\n  function getScopedState(): FormState {\n    const rootState = ctx.getStateSnapshot();\n    const errors = Object.fromEntries(\n      Object.entries(rootState.errors)\n        .filter(([k]) => isScopedKey(k))\n        .map(([k, v]) => [unscope(k), v]),\n    );\n    const touchedFields = rootState.touchedFields.filter(isScopedKey).map(unscope);\n    const validatingFields = rootState.validatingFields.filter(isScopedKey).map(unscope);\n    const isValid = Object.keys(errors).length === 0;\n    const isDirty = [...ctx.dirty].some(isScopedKey);\n    const isTouched = [...ctx.touched].some(isScopedKey);\n    const isValidating = validatingFields.length > 0;\n\n    return Object.freeze({\n      errors: Object.freeze(errors) as FormState['errors'],\n      isDirty,\n      isLoading: rootState.isLoading,\n      isSubmitting: rootState.isSubmitting,\n      isTouched,\n      isValid,\n      isValidating,\n      submitCount: rootState.submitCount,\n      touchedFields: Object.freeze(touchedFields) as readonly string[],\n      validatingFields: Object.freeze(validatingFields) as readonly string[],\n    });\n  }\n\n  function scopedValues(): ScopedValues<TValues, P> {\n    const sub: Record<string, unknown> = {};\n\n    for (const [key, value] of ctx.store) {\n      if (key.startsWith(pfxDot)) sub[key.slice(pfxDot.length)] = value;\n    }\n\n    return unflattenValues(sub) as ScopedValues<TValues, P>;\n  }\n\n  /**\n   * Enumerate field paths within this scope's prefix, stripped to relative paths —\n   * matching `scope.state`'s relative-path convention, not `state.touchedFields`'s\n   * absolute-path convention. Same \"known field\" definition `scopedTouchAll()` uses.\n   */\n  function scopedListFields(): readonly string[] {\n    const known = new Set<string>();\n\n    for (const key of ctx.store.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    for (const key of ctx.validators.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    return Object.freeze([...known]);\n  }\n\n  function scopedTouchAll(): void {\n    ctx.ensureNotDisposed();\n\n    for (const name of ctx.store.keys()) {\n      if (isScopedKey(name)) ctx.touched.add(name);\n    }\n\n    for (const name of ctx.validators.keys()) {\n      if (isScopedKey(name)) ctx.touched.add(name);\n    }\n\n    ctx.requestNotify();\n  }\n\n  function scopedUntouchAll(): void {\n    ctx.ensureNotDisposed();\n\n    for (const name of [...ctx.touched]) {\n      if (isScopedKey(name)) ctx.touched.delete(name);\n    }\n\n    ctx.requestNotify();\n  }\n\n  function scopedReset(): void {\n    ctx.ensureNotDisposed();\n\n    for (const key of [...ctx.store.keys()]) {\n      if (!isScopedKey(key)) continue;\n\n      ctx.fieldCtrls.get(key)?.abort();\n      ctx.fieldCtrls.delete(key);\n      ctx.store.set(key, ctx.baseline.get(key));\n      ctx.dirty.delete(key);\n      ctx.touched.delete(key);\n\n      if (ctx.fieldErrors.delete(key)) ctx.invalidateErrors();\n    }\n\n    ctx.requestNotify();\n  }\n\n  function scopedReplace(newValues: ScopedValues<TValues, P>): void {\n    ctx.ensureNotDisposed();\n\n    for (const key of [...ctx.fieldCtrls.keys()]) {\n      if (isScopedKey(key)) {\n        ctx.fieldCtrls.get(key)?.abort();\n        ctx.fieldCtrls.delete(key);\n      }\n    }\n\n    const flat = flattenValues(newValues as Record<string, unknown>);\n\n    for (const key of [...ctx.store.keys()]) {\n      if (!isScopedKey(key)) continue;\n\n      ctx.store.delete(key);\n      ctx.baseline.delete(key);\n      ctx.dirty.delete(key);\n      ctx.touched.delete(key);\n      ctx.fieldErrors.delete(key);\n    }\n\n    ctx.invalidateErrors();\n\n    for (const [key, value] of Object.entries(flat)) {\n      const full = pre(key);\n\n      ctx.store.set(full, value);\n      ctx.baseline.set(full, value);\n    }\n\n    ctx.requestNotify();\n  }\n\n  function scopedPatch(partial: Record<string, unknown>): void {\n    ctx.ensureNotDisposed();\n\n    const flat = flattenValues(partial);\n    const changedKeys: string[] = [];\n\n    for (const [key, value] of Object.entries(flat)) {\n      const full = pre(key);\n\n      ctx.baseline.set(full, value);\n      ctx.store.set(full, value);\n      ctx.dirty.delete(full);\n      changedKeys.push(full);\n    }\n\n    ctx.requestNotify(changedKeys);\n  }\n\n  function scopedResetErrors(\n    nextErrors?: Partial<Record<ErrorKeyOf<ScopedValues<TValues, P>>, string | undefined>>,\n  ): void {\n    ctx.ensureNotDisposed();\n\n    for (const key of [...ctx.fieldErrors.keys()]) {\n      if (isScopedKey(key)) ctx.fieldErrors.delete(key);\n    }\n\n    if (nextErrors) {\n      for (const [key, message] of Object.entries(nextErrors)) {\n        if (typeof message === 'string') ctx.fieldErrors.set(pre(key), message);\n      }\n    }\n\n    ctx.invalidateErrors();\n    ctx.requestNotify();\n  }\n\n  async function scopedValidate(\n    nameOrFieldsOrSignal?: FlatKeyOf<ScopedValues<TValues, P>> | FlatKeyOf<ScopedValues<TValues, P>>[] | AbortSignal,\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed();\n\n    if (\n      nameOrFieldsOrSignal !== undefined &&\n      !Array.isArray(nameOrFieldsOrSignal) &&\n      !(nameOrFieldsOrSignal instanceof AbortSignal)\n    ) {\n      // validate(name) — single field\n      const prefixedName = pre(nameOrFieldsOrSignal as string) as FlatKeyOf<TValues>;\n\n      await ctx.runValidationCore([prefixedName as string], 'partial', signal);\n\n      const error = ctx.fieldErrors.get(prefixedName as string);\n\n      return {\n        errors: error !== undefined ? { [nameOrFieldsOrSignal as string]: error } : {},\n        valid: error === undefined,\n      };\n    }\n\n    if (Array.isArray(nameOrFieldsOrSignal)) {\n      // validate(fields[]) — specific subset\n      const prefixedFields = nameOrFieldsOrSignal.map((f) => pre(f as string)) as string[];\n\n      await ctx.runValidationCore(prefixedFields, 'partial', signal);\n\n      const errors: Record<string, string> = {};\n\n      for (const pf of prefixedFields) {\n        const msg = ctx.fieldErrors.get(pf);\n\n        if (msg !== undefined) errors[unscope(pf)] = msg;\n      }\n\n      return { errors, valid: Object.keys(errors).length === 0 };\n    }\n\n    // validate(signal?) — all scoped fields\n    const sig = nameOrFieldsOrSignal as AbortSignal | undefined;\n    const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n    await ctx.runValidationCore(fields, 'partial', sig);\n\n    const errors: Record<string, string> = {};\n\n    for (const [key, message] of ctx.fieldErrors) {\n      if (isScopedKey(key)) errors[unscope(key)] = message;\n    }\n\n    return { errors, valid: Object.keys(errors).length === 0 };\n  }\n\n  async function scopedSubmit<TResult>(\n    handler: (values: ScopedValues<TValues, P>) => MaybePromise<TResult>,\n  ): Promise<SubmitResult<TResult>> {\n    ctx.ensureNotDisposed();\n\n    if (ctx.isSubmitting()) throw new ForgeSubmitError('submit() called while a submission is already in progress');\n\n    ctx.root.batch(() => {\n      ctx.incrementSubmitCount();\n      ctx.setSubmitting(true);\n      scopedTouchAll();\n    });\n\n    try {\n      const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n      await ctx.runValidationCore(fields, 'partial');\n\n      ctx.ensureNotDisposed();\n\n      const errors: Record<string, string> = {};\n\n      for (const [key, message] of ctx.fieldErrors) {\n        if (isScopedKey(key)) errors[unscope(key)] = message;\n      }\n\n      if (Object.keys(errors).length > 0) {\n        return { errors, ok: false, type: 'validation' as const };\n      }\n\n      return { ok: true as const, value: await handler(scopedValues()) };\n    } finally {\n      ctx.setSubmitting(false);\n\n      if (!ctx.isDisposed()) ctx.requestNotify();\n    }\n  }\n\n  /**\n   * Subscribe filtered to scoped fields only.\n   * Errors, touchedFields, and validatingFields are remapped to relative paths.\n   * `isValid`, `isDirty`, and `isTouched` reflect only fields within this scope's prefix.\n   * `isSubmitting`, `isLoading`, `isValidating`, and `submitCount` reflect the full form.\n   *\n   * The listener fires only when the scoped projection changes — mutations outside this\n   * prefix do not fire the listener.\n   */\n  function subscribeScoped(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    // Track the previous scoped projection for equality comparison.\n    let prevState: FormState | null = null;\n\n    return ctx.root.subscribe(() => {\n      const next = getScopedState();\n\n      // Skip if no scoped-relevant state has changed.\n      if (prevState) {\n        const p = prevState;\n        const errKeys = Object.keys(next.errors);\n        const prevErrKeys = Object.keys(p.errors);\n        const errorsMatch =\n          errKeys.length === prevErrKeys.length && errKeys.every((k) => next.errors[k] === p.errors[k]);\n\n        const touchedMatch =\n          next.touchedFields.length === p.touchedFields.length &&\n          next.touchedFields.every((v, i) => v === p.touchedFields[i]);\n\n        const validatingMatch =\n          next.validatingFields.length === p.validatingFields.length &&\n          next.validatingFields.every((v, i) => v === p.validatingFields[i]);\n\n        const flagsMatch =\n          next.isDirty === p.isDirty &&\n          next.isLoading === p.isLoading &&\n          next.isSubmitting === p.isSubmitting &&\n          next.isTouched === p.isTouched &&\n          next.isValid === p.isValid &&\n          next.isValidating === p.isValidating &&\n          next.submitCount === p.submitCount;\n\n        if (flagsMatch && errorsMatch && touchedMatch && validatingMatch) return;\n      }\n\n      prevState = next;\n      listener(next);\n    }, options);\n  }\n\n  function createScopedAdapter() {\n    return {\n      array(name: string): ArrayField {\n        return ctx.root.array(pre(name) as FlatKeyOf<TValues>) as ArrayField;\n      },\n      clearError(name: string): void {\n        ctx.root.clearError(pre(name) as ErrorKeyOf<TValues>);\n      },\n      connect(name: string, config?: ConnectOptions): ConnectionResult<unknown> {\n        return ctx.root.connect(pre(name) as FlatKeyOf<TValues>, config) as ConnectionResult<unknown>;\n      },\n      field(name: string): FieldState<unknown> {\n        return ctx.root.field(pre(name) as FlatKeyOf<TValues>) as FieldState<unknown>;\n      },\n      get(name: string): unknown {\n        return ctx.root.get(pre(name) as FlatKeyOf<TValues>);\n      },\n      register(name: string, options?: RegisterFieldOptions<unknown>): Unsubscribe {\n        return ctx.root.fields.register(\n          pre(name) as FlatKeyOf<TValues>,\n          options as RegisterFieldOptions<TypeAtPath<TValues, FlatKeyOf<TValues>>>,\n        );\n      },\n      remove(name: string): void {\n        ctx.root.fields.remove(pre(name) as FlatKeyOf<TValues>);\n      },\n      resetField(name: string): void {\n        ctx.root.resetField(pre(name) as FlatKeyOf<TValues>);\n      },\n      set(name: string, value: unknown, options?: SetOptions): void {\n        ctx.root.set(pre(name) as FlatKeyOf<TValues>, value as TypeAtPath<TValues, FlatKeyOf<TValues>>, options);\n      },\n      setError(name: string, message: string): void {\n        ctx.root.setError(pre(name) as ErrorKeyOf<TValues>, message);\n      },\n      setValidator(name: string, validator?: FieldValidator): void {\n        ctx.root.fields.setValidator(pre(name) as FlatKeyOf<TValues>, validator);\n      },\n      subscribeField(\n        name: string,\n        listener: (state: FieldState<unknown>) => void,\n        options?: SubscribeOptions,\n      ): Unsubscribe {\n        return ctx.root.subscribeField(\n          pre(name) as FlatKeyOf<TValues>,\n          listener as (state: FieldState<TypeAtPath<TValues, FlatKeyOf<TValues>>>) => void,\n          options,\n        );\n      },\n      touch(name: string): void {\n        ctx.root.touch(pre(name) as FlatKeyOf<TValues>);\n      },\n      untouch(name: string): void {\n        ctx.root.untouch(pre(name) as FlatKeyOf<TValues>);\n      },\n    };\n  }\n\n  /* ---- Public scoped form object ---- */\n\n  type S = ScopedValues<TValues, P>;\n\n  const adapter = createScopedAdapter();\n\n  return {\n    array: (name) =>\n      adapter.array(name as string) as ArrayField<\n        TypeAtPath<S, typeof name> extends readonly (infer E)[] ? E : unknown\n      >,\n    batch: (fn) => ctx.root.batch(fn),\n    clearError: (name) => adapter.clearError(name as string),\n    connect: (name, config?) => adapter.connect(name as string, config) as ConnectionResult<TypeAtPath<S, typeof name>>,\n    get disposalSignal() {\n      return ctx.root.disposalSignal;\n    },\n    dispose: () => {\n      /* Scoped forms share lifecycle with parent — call parentForm.dispose() to tear down */\n    },\n    get disposed() {\n      return ctx.isDisposed();\n    },\n    field: (name) => adapter.field(name as string) as FieldState<TypeAtPath<S, typeof name>>,\n    fields: {\n      list: scopedListFields,\n      register: (name, options?) => adapter.register(name as string, options as RegisterFieldOptions<unknown>),\n      remove: (name) => adapter.remove(name as string),\n      setValidator: (name, validator?) => adapter.setValidator(name as string, validator),\n    },\n    get: (name) => adapter.get(name as string) as TypeAtPath<S, typeof name>,\n    get isLoading() {\n      return ctx.root.isLoading;\n    },\n    get isSubmitting() {\n      return ctx.root.isSubmitting;\n    },\n    patch: scopedPatch as Form<S>['patch'],\n    replace: scopedReplace as Form<S>['replace'],\n    reset: scopedReset,\n    resetErrors: scopedResetErrors as Form<S>['resetErrors'],\n    resetField: (name) => adapter.resetField(name as string),\n    // Cast is irreducible: FormSnapshot<ScopedValues<TValues,P>> and FormSnapshot<TValues> are\n    // structurally unrelated generic instantiations -- TS cannot verify one against the other.\n    restore: (snap) => ctx.root.restore(snap as FormSnapshot<TValues>),\n    scope: (subPrefix) => createScopedForm(ctx, pre(subPrefix as string)) as Form<ScopedValues<S, typeof subPrefix>>,\n    set: (name, value, options?: SetOptions) => adapter.set(name as string, value, options),\n    setError: (name, message) => adapter.setError(name as string, message),\n    // Cast is irreducible: FormSnapshot<TValues> and FormSnapshot<ScopedValues<TValues,P>> are\n    // structurally unrelated generic instantiations -- TS cannot verify one against the other.\n    snapshot: () => ctx.root.snapshot() as FormSnapshot<S>,\n    get state() {\n      return getScopedState();\n    },\n    submit: scopedSubmit as Form<S>['submit'],\n    submitOrThrow: async (handler) => {\n      const result = await scopedSubmit(handler);\n\n      if (!result.ok) throw new ForgeValidationError(result.errors as Record<string, string>);\n\n      return result.value;\n    },\n    subscribe: (listener, options?) => ctx.root.subscribe(listener, options),\n    subscribeField: (name, listener, options?) =>\n      adapter.subscribeField(name as string, listener as (state: FieldState<unknown>) => void, options),\n    subscribeScoped,\n    [Symbol.asyncIterator]: () => ctx.root[Symbol.asyncIterator](),\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n    touch: (name) => adapter.touch(name as string),\n    touchAll: scopedTouchAll,\n    untouch: (name) => adapter.untouch(name as string),\n    untouchAll: scopedUntouchAll,\n    validate: scopedValidate as Form<S>['validate'],\n    validateStream(signal?) {\n      const rootIter = ctx.root.validateStream(signal);\n\n      const iter: AsyncIterableIterator<{ error: string | undefined; field: string }> = {\n        async next() {\n          for (;;) {\n            const item = await rootIter.next();\n\n            if (item.done) return item;\n\n            if (isScopedKey(item.value.field))\n              return { done: false, value: { error: item.value.error, field: unscope(item.value.field) } };\n          }\n        },\n        return() {\n          return rootIter.return ? rootIter.return() : Promise.resolve({ done: true as const, value: undefined });\n        },\n        [Symbol.asyncIterator]() {\n          return this;\n        },\n      };\n\n      return iter;\n    },\n    values: scopedValues,\n  };\n}\n"],"mappings":"6FAoEA,SAAgB,EACd,EACA,EACgC,CAChC,IAAM,EAAS,GAAG,EAAI,GAEtB,SAAS,EAAI,EAAsB,CACjC,MAAO,GAAG,EAAI,GAAG,GACnB,CAEA,SAAS,EAAY,EAAsB,CACzC,OAAO,IAAQ,GAAO,EAAI,WAAW,CAAM,CAC7C,CAEA,SAAS,EAAQ,EAAqB,CACpC,OAAO,EAAI,WAAW,CAAM,EAAI,EAAI,MAAM,EAAO,MAAM,EAAI,CAC7D,CASA,SAAS,GAA4B,CACnC,IAAM,EAAY,EAAI,iBAAiB,EACjC,EAAS,OAAO,YACpB,OAAO,QAAQ,EAAU,MAAM,CAAC,CAC7B,QAAQ,CAAC,KAAO,EAAY,CAAC,CAAC,CAAC,CAC/B,KAAK,CAAC,EAAG,KAAO,CAAC,EAAQ,CAAC,EAAG,CAAC,CAAC,CACpC,EACM,EAAgB,EAAU,cAAc,OAAO,CAAW,CAAC,CAAC,IAAI,CAAO,EACvE,EAAmB,EAAU,iBAAiB,OAAO,CAAW,CAAC,CAAC,IAAI,CAAO,EAC7E,EAAU,OAAO,KAAK,CAAM,CAAC,CAAC,SAAW,EACzC,EAAU,CAAC,GAAG,EAAI,KAAK,CAAC,CAAC,KAAK,CAAW,EACzC,EAAY,CAAC,GAAG,EAAI,OAAO,CAAC,CAAC,KAAK,CAAW,EAC7C,EAAe,EAAiB,OAAS,EAE/C,OAAO,OAAO,OAAO,CACnB,OAAQ,OAAO,OAAO,CAAM,EAC5B,UACA,UAAW,EAAU,UACrB,aAAc,EAAU,aACxB,YACA,UACA,eACA,YAAa,EAAU,YACvB,cAAe,OAAO,OAAO,CAAa,EAC1C,iBAAkB,OAAO,OAAO,CAAgB,CAClD,CAAC,CACH,CAEA,SAAS,GAAyC,CAChD,IAAM,EAA+B,CAAC,EAEtC,IAAK,GAAM,CAAC,EAAK,KAAU,EAAI,MACzB,EAAI,WAAW,CAAM,IAAG,EAAI,EAAI,MAAM,EAAO,MAAM,GAAK,GAG9D,OAAA,EAAA,EAAA,eAAA,CAAuB,CAAG,CAC5B,CAOA,SAAS,GAAsC,CAC7C,IAAM,EAAQ,IAAI,IAElB,IAAK,IAAM,KAAO,EAAI,MAAM,KAAK,EAC3B,EAAY,CAAG,GAAG,EAAM,IAAI,EAAQ,CAAG,CAAC,EAG9C,IAAK,IAAM,KAAO,EAAI,WAAW,KAAK,EAChC,EAAY,CAAG,GAAG,EAAM,IAAI,EAAQ,CAAG,CAAC,EAG9C,OAAO,OAAO,OAAO,CAAC,GAAG,CAAK,CAAC,CACjC,CAEA,SAAS,GAAuB,CAC9B,EAAI,kBAAkB,EAEtB,IAAK,IAAM,KAAQ,EAAI,MAAM,KAAK,EAC5B,EAAY,CAAI,GAAG,EAAI,QAAQ,IAAI,CAAI,EAG7C,IAAK,IAAM,KAAQ,EAAI,WAAW,KAAK,EACjC,EAAY,CAAI,GAAG,EAAI,QAAQ,IAAI,CAAI,EAG7C,EAAI,cAAc,CACpB,CAEA,SAAS,GAAyB,CAChC,EAAI,kBAAkB,EAEtB,IAAK,IAAM,IAAQ,CAAC,GAAG,EAAI,OAAO,EAC5B,EAAY,CAAI,GAAG,EAAI,QAAQ,OAAO,CAAI,EAGhD,EAAI,cAAc,CACpB,CAEA,SAAS,GAAoB,CAC3B,EAAI,kBAAkB,EAEtB,IAAK,IAAM,IAAO,CAAC,GAAG,EAAI,MAAM,KAAK,CAAC,EAC/B,EAAY,CAAG,IAEpB,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,EAC/B,EAAI,WAAW,OAAO,CAAG,EACzB,EAAI,MAAM,IAAI,EAAK,EAAI,SAAS,IAAI,CAAG,CAAC,EACxC,EAAI,MAAM,OAAO,CAAG,EACpB,EAAI,QAAQ,OAAO,CAAG,EAElB,EAAI,YAAY,OAAO,CAAG,GAAG,EAAI,iBAAiB,GAGxD,EAAI,cAAc,CACpB,CAEA,SAAS,EAAc,EAA2C,CAChE,EAAI,kBAAkB,EAEtB,IAAK,IAAM,IAAO,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,EACrC,EAAY,CAAG,IACjB,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,EAC/B,EAAI,WAAW,OAAO,CAAG,GAI7B,IAAM,GAAA,EAAA,EAAA,aAAA,CAAqB,CAAoC,EAE/D,IAAK,IAAM,IAAO,CAAC,GAAG,EAAI,MAAM,KAAK,CAAC,EAC/B,EAAY,CAAG,IAEpB,EAAI,MAAM,OAAO,CAAG,EACpB,EAAI,SAAS,OAAO,CAAG,EACvB,EAAI,MAAM,OAAO,CAAG,EACpB,EAAI,QAAQ,OAAO,CAAG,EACtB,EAAI,YAAY,OAAO,CAAG,GAG5B,EAAI,iBAAiB,EAErB,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAI,EAAG,CAC/C,IAAM,EAAO,EAAI,CAAG,EAEpB,EAAI,MAAM,IAAI,EAAM,CAAK,EACzB,EAAI,SAAS,IAAI,EAAM,CAAK,CAC9B,CAEA,EAAI,cAAc,CACpB,CAEA,SAAS,EAAY,EAAwC,CAC3D,EAAI,kBAAkB,EAEtB,IAAM,GAAA,EAAA,EAAA,aAAA,CAAqB,CAAO,EAC5B,EAAwB,CAAC,EAE/B,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAI,EAAG,CAC/C,IAAM,EAAO,EAAI,CAAG,EAEpB,EAAI,SAAS,IAAI,EAAM,CAAK,EAC5B,EAAI,MAAM,IAAI,EAAM,CAAK,EACzB,EAAI,MAAM,OAAO,CAAI,EACrB,EAAY,KAAK,CAAI,CACvB,CAEA,EAAI,cAAc,CAAW,CAC/B,CAEA,SAAS,EACP,EACM,CACN,EAAI,kBAAkB,EAEtB,IAAK,IAAM,IAAO,CAAC,GAAG,EAAI,YAAY,KAAK,CAAC,EACtC,EAAY,CAAG,GAAG,EAAI,YAAY,OAAO,CAAG,EAGlD,GAAI,MACG,GAAM,CAAC,EAAK,KAAY,OAAO,QAAQ,CAAU,EAChD,OAAO,GAAY,UAAU,EAAI,YAAY,IAAI,EAAI,CAAG,EAAG,CAAO,EAI1E,EAAI,iBAAiB,EACrB,EAAI,cAAc,CACpB,CAEA,eAAe,EACb,EACA,EACyB,CAGzB,GAFA,EAAI,kBAAkB,EAGpB,IAAyB,IAAA,IACzB,CAAC,MAAM,QAAQ,CAAoB,GACnC,EAAE,aAAgC,aAClC,CAEA,IAAM,EAAe,EAAI,CAA8B,EAEvD,MAAM,EAAI,kBAAkB,CAAC,CAAsB,EAAG,UAAW,CAAM,EAEvE,IAAM,EAAQ,EAAI,YAAY,IAAI,CAAsB,EAExD,MAAO,CACL,OAAQ,IAAU,IAAA,GAA0D,CAAC,EAA/C,EAAG,GAAiC,CAAM,EACxE,MAAO,IAAU,IAAA,EACnB,CACF,CAEA,GAAI,MAAM,QAAQ,CAAoB,EAAG,CAEvC,IAAM,EAAiB,EAAqB,IAAK,GAAM,EAAI,CAAW,CAAC,EAEvE,MAAM,EAAI,kBAAkB,EAAgB,UAAW,CAAM,EAE7D,IAAM,EAAiC,CAAC,EAExC,IAAK,IAAM,KAAM,EAAgB,CAC/B,IAAM,EAAM,EAAI,YAAY,IAAI,CAAE,EAE9B,IAAQ,IAAA,KAAW,EAAO,EAAQ,CAAE,GAAK,EAC/C,CAEA,MAAO,CAAE,SAAQ,MAAO,OAAO,KAAK,CAAM,CAAC,CAAC,SAAW,CAAE,CAC3D,CAGA,IAAM,EAAM,EACN,EAAS,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,CAAC,CAAC,OAAO,CAAW,EAE5D,MAAM,EAAI,kBAAkB,EAAQ,UAAW,CAAG,EAElD,IAAM,EAAiC,CAAC,EAExC,IAAK,GAAM,CAAC,EAAK,KAAY,EAAI,YAC3B,EAAY,CAAG,IAAG,EAAO,EAAQ,CAAG,GAAK,GAG/C,MAAO,CAAE,SAAQ,MAAO,OAAO,KAAK,CAAM,CAAC,CAAC,SAAW,CAAE,CAC3D,CAEA,eAAe,EACb,EACgC,CAGhC,GAFA,EAAI,kBAAkB,EAElB,EAAI,aAAa,EAAG,MAAM,IAAI,EAAA,iBAAiB,2DAA2D,EAE9G,EAAI,KAAK,UAAY,CACnB,EAAI,qBAAqB,EACzB,EAAI,cAAc,EAAI,EACtB,EAAe,CACjB,CAAC,EAED,GAAI,CACF,IAAM,EAAS,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,CAAC,CAAC,OAAO,CAAW,EAE5D,MAAM,EAAI,kBAAkB,EAAQ,SAAS,EAE7C,EAAI,kBAAkB,EAEtB,IAAM,EAAiC,CAAC,EAExC,IAAK,GAAM,CAAC,EAAK,KAAY,EAAI,YAC3B,EAAY,CAAG,IAAG,EAAO,EAAQ,CAAG,GAAK,GAO/C,OAJI,OAAO,KAAK,CAAM,CAAC,CAAC,OAAS,EACxB,CAAE,SAAQ,GAAI,GAAO,KAAM,YAAsB,EAGnD,CAAE,GAAI,GAAe,MAAO,MAAM,EAAQ,EAAa,CAAC,CAAE,CACnE,QAAU,CACR,EAAI,cAAc,EAAK,EAElB,EAAI,WAAW,GAAG,EAAI,cAAc,CAC3C,CACF,CAWA,SAAS,EAAgB,EAAsC,EAAyC,CAEtG,IAAI,EAA8B,KAElC,OAAO,EAAI,KAAK,cAAgB,CAC9B,IAAM,EAAO,EAAe,EAG5B,GAAI,EAAW,CACb,IAAM,EAAI,EACJ,EAAU,OAAO,KAAK,EAAK,MAAM,EACjC,EAAc,OAAO,KAAK,EAAE,MAAM,EAClC,EACJ,EAAQ,SAAW,EAAY,QAAU,EAAQ,MAAO,GAAM,EAAK,OAAO,KAAO,EAAE,OAAO,EAAE,EAExF,EACJ,EAAK,cAAc,SAAW,EAAE,cAAc,QAC9C,EAAK,cAAc,OAAO,EAAG,IAAM,IAAM,EAAE,cAAc,EAAE,EAEvD,EACJ,EAAK,iBAAiB,SAAW,EAAE,iBAAiB,QACpD,EAAK,iBAAiB,OAAO,EAAG,IAAM,IAAM,EAAE,iBAAiB,EAAE,EAWnE,GARE,EAAK,UAAY,EAAE,SACnB,EAAK,YAAc,EAAE,WACrB,EAAK,eAAiB,EAAE,cACxB,EAAK,YAAc,EAAE,WACrB,EAAK,UAAY,EAAE,SACnB,EAAK,eAAiB,EAAE,cACxB,EAAK,cAAgB,EAAE,aAEP,GAAe,GAAgB,EAAiB,MACpE,CAEA,EAAY,EACZ,EAAS,CAAI,CACf,EAAG,CAAO,CACZ,CAEA,SAAS,GAAsB,CAC7B,MAAO,CACL,MAAM,EAA0B,CAC9B,OAAO,EAAI,KAAK,MAAM,EAAI,CAAI,CAAuB,CACvD,EACA,WAAW,EAAoB,CAC7B,EAAI,KAAK,WAAW,EAAI,CAAI,CAAwB,CACtD,EACA,QAAQ,EAAc,EAAoD,CACxE,OAAO,EAAI,KAAK,QAAQ,EAAI,CAAI,EAAyB,CAAM,CACjE,EACA,MAAM,EAAmC,CACvC,OAAO,EAAI,KAAK,MAAM,EAAI,CAAI,CAAuB,CACvD,EACA,IAAI,EAAuB,CACzB,OAAO,EAAI,KAAK,IAAI,EAAI,CAAI,CAAuB,CACrD,EACA,SAAS,EAAc,EAAsD,CAC3E,OAAO,EAAI,KAAK,OAAO,SACrB,EAAI,CAAI,EACR,CACF,CACF,EACA,OAAO,EAAoB,CACzB,EAAI,KAAK,OAAO,OAAO,EAAI,CAAI,CAAuB,CACxD,EACA,WAAW,EAAoB,CAC7B,EAAI,KAAK,WAAW,EAAI,CAAI,CAAuB,CACrD,EACA,IAAI,EAAc,EAAgB,EAA4B,CAC5D,EAAI,KAAK,IAAI,EAAI,CAAI,EAAyB,EAAkD,CAAO,CACzG,EACA,SAAS,EAAc,EAAuB,CAC5C,EAAI,KAAK,SAAS,EAAI,CAAI,EAA0B,CAAO,CAC7D,EACA,aAAa,EAAc,EAAkC,CAC3D,EAAI,KAAK,OAAO,aAAa,EAAI,CAAI,EAAyB,CAAS,CACzE,EACA,eACE,EACA,EACA,EACa,CACb,OAAO,EAAI,KAAK,eACd,EAAI,CAAI,EACR,EACA,CACF,CACF,EACA,MAAM,EAAoB,CACxB,EAAI,KAAK,MAAM,EAAI,CAAI,CAAuB,CAChD,EACA,QAAQ,EAAoB,CAC1B,EAAI,KAAK,QAAQ,EAAI,CAAI,CAAuB,CAClD,CACF,CACF,CAMA,IAAM,EAAU,EAAoB,EAEpC,MAAO,CACL,MAAQ,GACN,EAAQ,MAAM,CAAc,EAG9B,MAAQ,GAAO,EAAI,KAAK,MAAM,CAAE,EAChC,WAAa,GAAS,EAAQ,WAAW,CAAc,EACvD,SAAU,EAAM,IAAY,EAAQ,QAAQ,EAAgB,CAAM,EAClE,IAAI,gBAAiB,CACnB,OAAO,EAAI,KAAK,cAClB,EACA,YAAe,CAEf,EACA,IAAI,UAAW,CACb,OAAO,EAAI,WAAW,CACxB,EACA,MAAQ,GAAS,EAAQ,MAAM,CAAc,EAC7C,OAAQ,CACN,KAAM,EACN,UAAW,EAAM,IAAa,EAAQ,SAAS,EAAgB,CAAwC,EACvG,OAAS,GAAS,EAAQ,OAAO,CAAc,EAC/C,cAAe,EAAM,IAAe,EAAQ,aAAa,EAAgB,CAAS,CACpF,EACA,IAAM,GAAS,EAAQ,IAAI,CAAc,EACzC,IAAI,WAAY,CACd,OAAO,EAAI,KAAK,SAClB,EACA,IAAI,cAAe,CACjB,OAAO,EAAI,KAAK,YAClB,EACA,MAAO,EACP,QAAS,EACT,MAAO,EACP,YAAa,EACb,WAAa,GAAS,EAAQ,WAAW,CAAc,EAGvD,QAAU,GAAS,EAAI,KAAK,QAAQ,CAA6B,EACjE,MAAQ,GAAc,EAAiB,EAAK,EAAI,CAAmB,CAAC,EACpE,KAAM,EAAM,EAAO,IAAyB,EAAQ,IAAI,EAAgB,EAAO,CAAO,EACtF,UAAW,EAAM,IAAY,EAAQ,SAAS,EAAgB,CAAO,EAGrE,aAAgB,EAAI,KAAK,SAAS,EAClC,IAAI,OAAQ,CACV,OAAO,EAAe,CACxB,EACA,OAAQ,EACR,cAAe,KAAO,IAAY,CAChC,IAAM,EAAS,MAAM,EAAa,CAAO,EAEzC,GAAI,CAAC,EAAO,GAAI,MAAM,IAAI,EAAA,qBAAqB,EAAO,MAAgC,EAEtF,OAAO,EAAO,KAChB,EACA,WAAY,EAAU,IAAa,EAAI,KAAK,UAAU,EAAU,CAAO,EACvE,gBAAiB,EAAM,EAAU,IAC/B,EAAQ,eAAe,EAAgB,EAAkD,CAAO,EAClG,mBACC,OAAO,mBAAsB,EAAI,KAAK,OAAO,cAAc,CAAC,EAC7D,CAAC,OAAO,UAAW,CACjB,KAAK,QAAQ,CACf,EACA,MAAQ,GAAS,EAAQ,MAAM,CAAc,EAC7C,SAAU,EACV,QAAU,GAAS,EAAQ,QAAQ,CAAc,EACjD,WAAY,EACZ,SAAU,EACV,eAAe,EAAS,CACtB,IAAM,EAAW,EAAI,KAAK,eAAe,CAAM,EAqB/C,MAAO,CAlBL,MAAM,MAAO,CACX,OAAS,CACP,IAAM,EAAO,MAAM,EAAS,KAAK,EAEjC,GAAI,EAAK,KAAM,OAAO,EAEtB,GAAI,EAAY,EAAK,MAAM,KAAK,EAC9B,MAAO,CAAE,KAAM,GAAO,MAAO,CAAE,MAAO,EAAK,MAAM,MAAO,MAAO,EAAQ,EAAK,MAAM,KAAK,CAAE,CAAE,CAC/F,CACF,EACA,QAAS,CACP,OAAO,EAAS,OAAS,EAAS,OAAO,EAAI,QAAQ,QAAQ,CAAE,KAAM,GAAe,MAAO,IAAA,EAAU,CAAC,CACxG,EACA,CAAC,OAAO,gBAAiB,CACvB,OAAO,IACT,CAGK,CACT,EACA,OAAQ,CACV,CACF"}
+{"version":3,"file":"scope.cjs","names":[],"sources":["../../src/core/scope.ts"],"sourcesContent":["import type {\n  ArrayField,\n  ConnectOptions,\n  ConnectionResult,\n  ErrorKeyOf,\n  FieldState,\n  FieldValidator,\n  FlatKeyOf,\n  Form,\n  FormSnapshot,\n  FormState,\n  MaybePromise,\n  RegisterFieldOptions,\n  ScopedValues,\n  SetOptions,\n  SubmitResult,\n  SubscribeOptions,\n  TypeAtPath,\n  Unsubscribe,\n  ValidateResult,\n} from '../types';\nimport type { FormContext } from './context';\nimport type { FieldOps } from './fields';\n\nimport { flattenValues, unflattenValues } from '../_utils';\nimport { ForgeSubmitError, ForgeValidationError } from '../errors';\n\n/**\n * Everything a scoped sub-form needs from its parent. Deliberately just three members —\n * `ctx` (the same `FormContext` the root form's own ops read/write, not a copy of its\n * fields) and a narrow slice of `fieldOps`'s predicate-based bulk primitives\n * (`reset`/`replace`/`patch`/`touchAll`/`untouchAll`/`resetErrors`'s shared implementations,\n * plus `runValidationCore`). Bulk scoped operations call these with an `isScopedKey`\n * predicate instead of maintaining a second copy of each loop.\n * @internal\n */\nexport interface ScopeContext<TValues extends Record<string, unknown> = Record<string, unknown>> {\n  ctx: FormContext<TValues>;\n  fieldOps: Pick<\n    FieldOps<TValues>,\n    | 'patchKeys'\n    | 'replaceKeys'\n    | 'resetErrorsKeys'\n    | 'resetKeys'\n    | 'runValidationCore'\n    | 'touchAllKeys'\n    | 'untouchAllKeys'\n  >;\n  /** The fully-featured root form — used for all simple one-field delegations. */\n  root: Form<TValues>;\n}\n\n/**\n * Creates a scoped sub-form whose field paths are relative to `pfx`.\n * All simple single-field operations delegate to `scopeCtx.root`. Bulk operations\n * (reset, replace, patch, touchAll, untouchAll, resetErrors) call `scopeCtx.fieldOps`'s\n * shared predicate-based primitives with an `isScopedKey` filter. Only `validate`/`submit`\n * (which need to compute a scoped field-name subset before calling `runValidationCore`) and\n * the handful of read-only projections (`state`, `values`, `fields.list`) contain custom code.\n */\nexport function createScopedForm<TValues extends Record<string, unknown>, P extends string>(\n  scopeCtx: ScopeContext<TValues>,\n  pfx: P,\n): Form<ScopedValues<TValues, P>> {\n  const { ctx, fieldOps, root } = scopeCtx;\n  const pfxDot = `${pfx}.`;\n\n  function pre(name: string): string {\n    return `${pfx}.${name}`;\n  }\n\n  function isScopedKey(key: string): boolean {\n    return key === pfx || key.startsWith(pfxDot);\n  }\n\n  function unscope(key: string): string {\n    return key.startsWith(pfxDot) ? key.slice(pfxDot.length) : key;\n  }\n\n  /* ---- Non-trivial scoped implementations ---- */\n\n  /**\n   * Compute a scoped projection of FormState from current raw Maps.\n   * Errors, touchedFields, validatingFields, isValid, isDirty, isTouched reflect only\n   * fields within the prefix. isSubmitting, isLoading, isValidating, submitCount are full-form.\n   */\n  function getScopedState(): FormState {\n    const rootState = ctx.getStateSnapshot();\n    const errors = Object.fromEntries(\n      Object.entries(rootState.errors)\n        .filter(([k]) => isScopedKey(k))\n        .map(([k, v]) => [unscope(k), v]),\n    );\n    const touchedFields = rootState.touchedFields.filter(isScopedKey).map(unscope);\n    const validatingFields = rootState.validatingFields.filter(isScopedKey).map(unscope);\n    const isValid = Object.keys(errors).length === 0;\n    const isDirty = [...ctx.dirty].some(isScopedKey);\n    const isTouched = [...ctx.touched].some(isScopedKey);\n    const isValidating = validatingFields.length > 0;\n\n    return Object.freeze({\n      errors: Object.freeze(errors) as FormState['errors'],\n      isDirty,\n      isLoading: rootState.isLoading,\n      isSubmitting: rootState.isSubmitting,\n      isTouched,\n      isValid,\n      isValidating,\n      submitCount: rootState.submitCount,\n      touchedFields: Object.freeze(touchedFields) as readonly string[],\n      validatingFields: Object.freeze(validatingFields) as readonly string[],\n    });\n  }\n\n  function scopedValues(): ScopedValues<TValues, P> {\n    const sub: Record<string, unknown> = {};\n\n    for (const [key, value] of ctx.store) {\n      if (key.startsWith(pfxDot)) sub[key.slice(pfxDot.length)] = value;\n    }\n\n    return unflattenValues(sub) as ScopedValues<TValues, P>;\n  }\n\n  /**\n   * Enumerate field paths within this scope's prefix, stripped to relative paths —\n   * matching `scope.state`'s relative-path convention, not `state.touchedFields`'s\n   * absolute-path convention. Same \"known field\" definition `scopedTouchAll()` uses.\n   */\n  function scopedListFields(): readonly string[] {\n    const known = new Set<string>();\n\n    for (const key of ctx.store.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    for (const key of ctx.validators.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    return Object.freeze([...known]);\n  }\n\n  function scopedTouchAll(): void {\n    ctx.ensureNotDisposed('touchAll');\n    fieldOps.touchAllKeys(isScopedKey);\n    ctx.requestNotify();\n  }\n\n  function scopedUntouchAll(): void {\n    ctx.ensureNotDisposed('untouchAll');\n    fieldOps.untouchAllKeys(isScopedKey);\n    ctx.requestNotify();\n  }\n\n  function scopedReset(): void {\n    ctx.ensureNotDisposed('reset');\n    fieldOps.resetKeys(isScopedKey);\n    ctx.requestNotify();\n  }\n\n  function scopedReplace(newValues: ScopedValues<TValues, P>): void {\n    ctx.ensureNotDisposed('replace');\n    fieldOps.replaceKeys(isScopedKey, flattenValues(newValues as Record<string, unknown>), pre);\n    ctx.requestNotify();\n  }\n\n  function scopedPatch(partial: Record<string, unknown>): void {\n    ctx.ensureNotDisposed('patch');\n    ctx.requestNotify(fieldOps.patchKeys(partial, pre));\n  }\n\n  function scopedResetErrors(\n    nextErrors?: Partial<Record<ErrorKeyOf<ScopedValues<TValues, P>>, string | undefined>>,\n  ): void {\n    ctx.ensureNotDisposed('resetErrors');\n    fieldOps.resetErrorsKeys(isScopedKey, nextErrors ?? {}, pre);\n    ctx.requestNotify();\n  }\n\n  async function scopedValidate(\n    nameOrFieldsOrSignal?: FlatKeyOf<ScopedValues<TValues, P>> | FlatKeyOf<ScopedValues<TValues, P>>[] | AbortSignal,\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed('validate');\n\n    if (\n      nameOrFieldsOrSignal !== undefined &&\n      !Array.isArray(nameOrFieldsOrSignal) &&\n      !(nameOrFieldsOrSignal instanceof AbortSignal)\n    ) {\n      // validate(name) — single field\n      const prefixedName = pre(nameOrFieldsOrSignal as string) as FlatKeyOf<TValues>;\n\n      await fieldOps.runValidationCore([prefixedName as string], 'partial', signal);\n\n      const error = ctx.fieldErrors.get(prefixedName as string);\n\n      return {\n        errors: error !== undefined ? { [nameOrFieldsOrSignal as string]: error } : {},\n        valid: error === undefined,\n      };\n    }\n\n    if (Array.isArray(nameOrFieldsOrSignal)) {\n      // validate(fields[]) — specific subset\n      const prefixedFields = nameOrFieldsOrSignal.map((f) => pre(f as string)) as string[];\n\n      await fieldOps.runValidationCore(prefixedFields, 'partial', signal);\n\n      const errors: Record<string, string> = {};\n\n      for (const pf of prefixedFields) {\n        const msg = ctx.fieldErrors.get(pf);\n\n        if (msg !== undefined) errors[unscope(pf)] = msg;\n      }\n\n      return { errors, valid: Object.keys(errors).length === 0 };\n    }\n\n    // validate(signal?) — all scoped fields\n    const sig = nameOrFieldsOrSignal as AbortSignal | undefined;\n    const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n    await fieldOps.runValidationCore(fields, 'partial', sig);\n\n    const errors: Record<string, string> = {};\n\n    for (const [key, message] of ctx.fieldErrors) {\n      if (isScopedKey(key)) errors[unscope(key)] = message;\n    }\n\n    return { errors, valid: Object.keys(errors).length === 0 };\n  }\n\n  async function scopedSubmit<TResult>(\n    handler: (values: ScopedValues<TValues, P>) => MaybePromise<TResult>,\n  ): Promise<SubmitResult<TResult>> {\n    ctx.ensureNotDisposed('submit');\n\n    if (ctx.isSubmittingState) throw new ForgeSubmitError('submit() called while a submission is already in progress');\n\n    ctx.batch(() => {\n      ctx.submitCount++;\n      ctx.isSubmittingState = true;\n      scopedTouchAll();\n    });\n\n    try {\n      const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n      await fieldOps.runValidationCore(fields, 'partial');\n\n      ctx.ensureNotDisposed('submit');\n\n      const errors: Record<string, string> = {};\n\n      for (const [key, message] of ctx.fieldErrors) {\n        if (isScopedKey(key)) errors[unscope(key)] = message;\n      }\n\n      if (Object.keys(errors).length > 0) {\n        return { errors, ok: false, type: 'validation' as const };\n      }\n\n      return { ok: true as const, value: await handler(scopedValues()) };\n    } finally {\n      ctx.isSubmittingState = false;\n\n      if (!ctx.disposed) ctx.requestNotify();\n    }\n  }\n\n  /**\n   * Subscribe filtered to scoped fields only — this scoped form's `subscribe()` implementation.\n   * Errors, touchedFields, and validatingFields are remapped to relative paths.\n   * `isValid`, `isDirty`, and `isTouched` reflect only fields within this scope's prefix.\n   * `isSubmitting`, `isLoading`, `isValidating`, and `submitCount` reflect the full form.\n   *\n   * The listener fires only when the scoped projection changes — mutations outside this\n   * prefix do not fire the listener.\n   */\n  function scopedSubscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    // Track the previous scoped projection for equality comparison.\n    let prevState: FormState | null = null;\n\n    return root.subscribe(() => {\n      const next = getScopedState();\n\n      // Skip if no scoped-relevant state has changed.\n      if (prevState) {\n        const p = prevState;\n        const errKeys = Object.keys(next.errors);\n        const prevErrKeys = Object.keys(p.errors);\n        const errorsMatch =\n          errKeys.length === prevErrKeys.length && errKeys.every((k) => next.errors[k] === p.errors[k]);\n\n        const touchedMatch =\n          next.touchedFields.length === p.touchedFields.length &&\n          next.touchedFields.every((v, i) => v === p.touchedFields[i]);\n\n        const validatingMatch =\n          next.validatingFields.length === p.validatingFields.length &&\n          next.validatingFields.every((v, i) => v === p.validatingFields[i]);\n\n        const flagsMatch =\n          next.isDirty === p.isDirty &&\n          next.isLoading === p.isLoading &&\n          next.isSubmitting === p.isSubmitting &&\n          next.isTouched === p.isTouched &&\n          next.isValid === p.isValid &&\n          next.isValidating === p.isValidating &&\n          next.submitCount === p.submitCount;\n\n        if (flagsMatch && errorsMatch && touchedMatch && validatingMatch) return;\n      }\n\n      prevState = next;\n      listener(next);\n    }, options);\n  }\n\n  function createScopedAdapter() {\n    return {\n      array(name: string): ArrayField {\n        return root.array(pre(name) as FlatKeyOf<TValues>) as ArrayField;\n      },\n      clearError(name: string): void {\n        root.clearError(pre(name) as ErrorKeyOf<TValues>);\n      },\n      connect(name: string, config?: ConnectOptions): ConnectionResult<unknown> {\n        return root.connect(pre(name) as FlatKeyOf<TValues>, config) as ConnectionResult<unknown>;\n      },\n      field(name: string): FieldState<unknown> {\n        return root.field(pre(name) as FlatKeyOf<TValues>) as FieldState<unknown>;\n      },\n      get(name: string): unknown {\n        return root.get(pre(name) as FlatKeyOf<TValues>);\n      },\n      register(name: string, options?: RegisterFieldOptions<unknown>): Unsubscribe {\n        return root.fields.register(\n          pre(name) as FlatKeyOf<TValues>,\n          options as RegisterFieldOptions<TypeAtPath<TValues, FlatKeyOf<TValues>>>,\n        );\n      },\n      remove(name: string): void {\n        root.fields.remove(pre(name) as FlatKeyOf<TValues>);\n      },\n      resetField(name: string): void {\n        root.resetField(pre(name) as FlatKeyOf<TValues>);\n      },\n      set(name: string, value: unknown, options?: SetOptions): void {\n        root.set(pre(name) as FlatKeyOf<TValues>, value as TypeAtPath<TValues, FlatKeyOf<TValues>>, options);\n      },\n      setError(name: string, message: string): void {\n        root.setError(pre(name) as ErrorKeyOf<TValues>, message);\n      },\n      setValidator(name: string, validator?: FieldValidator): void {\n        root.fields.setValidator(pre(name) as FlatKeyOf<TValues>, validator);\n      },\n      subscribeField(\n        name: string,\n        listener: (state: FieldState<unknown>) => void,\n        options?: SubscribeOptions,\n      ): Unsubscribe {\n        return root.subscribeField(\n          pre(name) as FlatKeyOf<TValues>,\n          listener as (state: FieldState<TypeAtPath<TValues, FlatKeyOf<TValues>>>) => void,\n          options,\n        );\n      },\n      touch(name: string): void {\n        root.touch(pre(name) as FlatKeyOf<TValues>);\n      },\n      untouch(name: string): void {\n        root.untouch(pre(name) as FlatKeyOf<TValues>);\n      },\n    };\n  }\n\n  /* ---- Public scoped form object ---- */\n\n  type S = ScopedValues<TValues, P>;\n\n  const adapter = createScopedAdapter();\n\n  return {\n    array: (name) =>\n      adapter.array(name as string) as ArrayField<\n        TypeAtPath<S, typeof name> extends readonly (infer E)[] ? E : unknown\n      >,\n    batch: (fn) => root.batch(fn),\n    clearError: (name) => adapter.clearError(name as string),\n    connect: (name, config?) => adapter.connect(name as string, config) as ConnectionResult<TypeAtPath<S, typeof name>>,\n    get disposalSignal() {\n      return root.disposalSignal;\n    },\n    dispose: () => {\n      /* Scoped forms share lifecycle with parent — call parentForm.dispose() to tear down */\n    },\n    get disposed() {\n      return ctx.disposed;\n    },\n    field: (name) => adapter.field(name as string) as FieldState<TypeAtPath<S, typeof name>>,\n    fields: {\n      list: scopedListFields,\n      register: (name, options?) => adapter.register(name as string, options as RegisterFieldOptions<unknown>),\n      remove: (name) => adapter.remove(name as string),\n      setValidator: (name, validator?) => adapter.setValidator(name as string, validator),\n    },\n    get: (name) => adapter.get(name as string) as TypeAtPath<S, typeof name>,\n    history: {\n      // Casts are irreducible: FormSnapshot<S> and FormSnapshot<TValues> are structurally\n      // unrelated generic instantiations -- TS cannot verify one against the other.\n      restore: (snap) => root.history.restore(snap as FormSnapshot<TValues>),\n      snapshot: () => root.history.snapshot() as FormSnapshot<S>,\n    },\n    get isLoading() {\n      return root.isLoading;\n    },\n    get isSubmitting() {\n      return root.isSubmitting;\n    },\n    patch: scopedPatch as Form<S>['patch'],\n    replace: scopedReplace as Form<S>['replace'],\n    reset: scopedReset,\n    resetErrors: scopedResetErrors as Form<S>['resetErrors'],\n    resetField: (name) => adapter.resetField(name as string),\n    scope: (subPrefix) =>\n      createScopedForm(scopeCtx, pre(subPrefix as string)) as Form<ScopedValues<S, typeof subPrefix>>,\n    set: (name, value, options?: SetOptions) => adapter.set(name as string, value, options),\n    setError: (name, message) => adapter.setError(name as string, message),\n    get state() {\n      return getScopedState();\n    },\n    submit: scopedSubmit as Form<S>['submit'],\n    submitOrThrow: async (handler) => {\n      const result = await scopedSubmit(handler);\n\n      if (!result.ok) throw new ForgeValidationError(result.errors as Record<string, string>);\n\n      return result.value;\n    },\n    // Scoped forms filter+remap; on a root form this method is the unfiltered notifier pass-through.\n    subscribe: scopedSubscribe,\n    subscribeField: (name, listener, options?) =>\n      adapter.subscribeField(name as string, listener as (state: FieldState<unknown>) => void, options),\n    [Symbol.asyncIterator]: () => root[Symbol.asyncIterator](),\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n    touch: (name) => adapter.touch(name as string),\n    touchAll: scopedTouchAll,\n    untouch: (name) => adapter.untouch(name as string),\n    untouchAll: scopedUntouchAll,\n    validate: scopedValidate as Form<S>['validate'],\n    values: scopedValues,\n  };\n}\n"],"mappings":"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"}

package/dist/core/scope.d.ts

@@ -1,8 +1,11 @@
 import type { Form, ScopedValues } from '../types';
 /**
  * Creates a scoped sub-form whose field paths are relative to `pfx`.
- * All simple single-field operations delegate to `ctx.root`.
- * Only prefix-aware bulk operations (submit, validate, replace, reset, etc.) contain custom code.
+ * All simple single-field operations delegate to `scopeCtx.root`. Bulk operations
+ * (reset, replace, patch, touchAll, untouchAll, resetErrors) call `scopeCtx.fieldOps`'s
+ * shared predicate-based primitives with an `isScopedKey` filter. Only `validate`/`submit`
+ * (which need to compute a scoped field-name subset before calling `runValidationCore`) and
+ * the handful of read-only projections (`state`, `values`, `fields.list`) contain custom code.
  */
-export declare function createScopedForm<TValues extends Record<string, unknown>, P extends string>(ctx: ScopeContext<TValues>, pfx: P): Form<ScopedValues<TValues, P>>;
+export declare function createScopedForm<TValues extends Record<string, unknown>, P extends string>(scopeCtx: ScopeContext<TValues>, pfx: P): Form<ScopedValues<TValues, P>>;
 //# sourceMappingURL=scope.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/core/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,IAAI,EAKJ,YAAY,EAOb,MAAM,UAAU,CAAC;AA2ClB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,EACxF,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,EAC1B,GAAG,EAAE,CAAC,GACL,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CA8ehC"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/core/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,IAAI,EAKJ,YAAY,EAOb,MAAM,UAAU,CAAC;AAgClB;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,EACxF,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,EAC/B,GAAG,EAAE,CAAC,GACL,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CA4YhC"}