@vielzeug/forge 2.2.1 → 2.3.1

package/dist/core/path.cjs

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

package/dist/core/path.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"path.cjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["import { ForgeConfigError } from '../errors';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\ntype ErrorNode = string | ErrorTree | ErrorArray;\nexport interface ErrorTree {\n  readonly [key: string]: ErrorNode;\n}\ntype ErrorArray = ErrorNode[];\ntype MutableErrorTree = Record<string, ErrorNode>;\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n  readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function isRecord(value: unknown): value is RecordValue {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\nexport function assertSafeKey(key: string): void {\n  if (!key || unsafeKeys.has(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nfunction isAtomicLeaf(value: unknown): boolean {\n  return (\n    (typeof Blob !== 'undefined' && value instanceof Blob) ||\n    (typeof File !== 'undefined' && value instanceof File) ||\n    value instanceof Date\n  );\n}\n\nexport function immutable<T>(value: T): T {\n  if (Array.isArray(value)) return Object.freeze(value.map(immutable)) as T;\n\n  if (value === null || typeof value !== 'object' || isAtomicLeaf(value)) return value;\n\n  if (!isRecord(value)) {\n    throw new ForgeConfigError(\n      'Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.',\n    );\n  }\n\n  return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, child]) => [key, immutable(child)]))) as T;\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (!Array.isArray(current) || key < 0 || key >= current.length) return undefined;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n      current = current[key];\n    }\n  }\n\n  return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (!Array.isArray(current) || key < 0 || key >= current.length) return false;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n      current = current[key];\n    }\n  }\n\n  return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    if (!Array.isArray(value)) {\n      throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n    }\n\n    if (key < 0 || key >= value.length) {\n      throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n    }\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = immutable(next);\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = writeAtPath(value[key] as TreeValue, rest, next);\n\n    return Object.freeze(copy) as T;\n  }\n\n  assertSafeKey(key);\n\n  if (!isRecord(value)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n  }\n\n  if (rest.length === 0) return Object.freeze({ ...value, [key]: immutable(next) }) as T;\n\n  const child = value[key];\n\n  if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n  }\n\n  const childTree = (child ?? {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    if (!Array.isArray(value)) return value;\n    if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = baseline[key];\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n    return Object.freeze(copy) as T;\n  }\n\n  if (!isRecord(value)) return value;\n\n  if (rest.length === 0) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const baselineChild = (baseline as RecordValue)[key];\n\n  if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const currentChild = value[key];\n  const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n  const [key, ...rest] = path;\n  const stringKey = String(key);\n  const copy: Record<string, MetaTree> = { ...meta };\n\n  if (rest.length === 0) {\n    if (next) copy[stringKey] = true;\n    else delete copy[stringKey];\n  } else {\n    const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n    const updated = writeMeta(child, rest, next);\n\n    if (Object.keys(updated).length === 0) delete copy[stringKey];\n    else copy[stringKey] = updated;\n  }\n\n  return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n  let current: MetaTree | undefined = meta;\n\n  for (const key of path) {\n    const stringKey = String(key);\n\n    if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n    current = current[stringKey] as MetaTree;\n  }\n\n  return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n  if (Array.isArray(value)) {\n    return Object.freeze(\n      Object.fromEntries(\n        value.map((child, i) => [\n          String(i),\n          isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n        ]),\n      ),\n    );\n  }\n\n  if (!isRecord(value)) return {};\n\n  return Object.freeze(\n    Object.fromEntries(\n      Object.entries(value).map(([key, child]) => [\n        key,\n        isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n      ]),\n    ),\n  );\n}\n\nexport function readError(errors: unknown, path: readonly (string | number)[]): string | undefined {\n  const error = readAtPath(errors, path);\n\n  return typeof error === 'string' ? error : undefined;\n}\n\nfunction writeErrorNode(\n  node: ErrorTree | ErrorArray | undefined,\n  path: readonly (string | number)[],\n  message: string,\n): ErrorTree | ErrorArray {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    const arr: ErrorNode[] = Array.isArray(node) ? [...node] : [];\n\n    if (rest.length === 0) {\n      if (arr[key] === undefined) arr[key] = message;\n    } else {\n      arr[key] = writeErrorNode(arr[key] as ErrorTree | ErrorArray | undefined, rest, message);\n    }\n\n    return arr;\n  }\n\n  if (!key || unsafeKeys.has(key)) return node ?? {};\n\n  const record: MutableErrorTree = isRecord(node) ? { ...node } : {};\n\n  if (rest.length === 0) {\n    if (record[key] === undefined) record[key] = message;\n  } else {\n    record[key] = writeErrorNode(record[key] as ErrorTree | ErrorArray | undefined, rest, message);\n  }\n\n  return record;\n}\n\nexport function writeError(tree: ErrorTree, path: readonly (string | number)[], message: string): ErrorTree {\n  const result = writeErrorNode(tree, path, message);\n\n  return isRecord(result) ? result : tree;\n}\n\nexport function normalizeErrors<T>(errors: T): T | undefined {\n  if (typeof errors === 'string') return errors;\n\n  if (Array.isArray(errors)) {\n    const normalized = errors.map((item) => normalizeErrors(item));\n\n    if (normalized.every((value) => value === undefined)) return undefined;\n\n    return Object.freeze(normalized) as T;\n  }\n\n  if (!isRecord(errors)) return undefined;\n\n  const entries = Object.entries(errors)\n    .map(([key, value]) => [key, normalizeErrors(value)] as const)\n    .filter(([, value]) => value !== undefined);\n\n  return entries.length === 0 ? undefined : (Object.freeze(Object.fromEntries(entries)) as T);\n}\n"],"mappings":"iCAEA,IAAM,EAAa,IAAI,IAAI,CAAC,YAAa,cAAe,WAAW,CAAC,EAgBpE,SAAgB,EAAS,EAAsC,CAC7D,GAAsB,OAAO,GAAU,WAAnC,GAA+C,MAAM,QAAQ,CAAK,EAAG,MAAO,GAEhF,IAAM,EAAY,OAAO,eAAe,CAAK,EAE7C,OAAO,IAAc,OAAO,WAAa,IAAc,IACzD,CAEA,SAAgB,EAAc,EAAmB,CAC/C,GAAI,CAAC,GAAO,EAAW,IAAI,CAAG,EAAG,MAAM,IAAI,EAAA,iBAAiB,sBAAsB,EAAI,GAAG,CAC3F,CAEA,SAAS,EAAa,EAAyB,CAC7C,OACG,OAAO,KAAS,KAAe,aAAiB,MAChD,OAAO,KAAS,KAAe,aAAiB,MACjD,aAAiB,IAErB,CAEA,SAAgB,EAAa,EAAa,CACxC,GAAI,MAAM,QAAQ,CAAK,EAAG,OAAO,OAAO,OAAO,EAAM,IAAI,CAAS,CAAC,EAEnE,GAAsB,OAAO,GAAU,WAAnC,GAA+C,EAAa,CAAK,EAAG,OAAO,EAE/E,GAAI,CAAC,EAAS,CAAK,EACjB,MAAM,IAAI,EAAA,iBACR,6FACF,EAGF,OAAO,OAAO,OAAO,OAAO,YAAY,OAAO,QAAQ,CAAK,CAAC,CAAC,KAAK,CAAC,EAAK,KAAW,CAAC,EAAK,EAAU,CAAK,CAAC,CAAC,CAAC,CAAC,CAC/G,CAEA,SAAgB,EAAc,EAAgB,EAAmD,CAC/F,IAAI,EAAmB,EAEvB,IAAK,IAAM,KAAO,EAChB,GAAI,OAAO,GAAQ,SAAU,CAC3B,GAAI,CAAC,MAAM,QAAQ,CAAO,GAAK,EAAM,GAAK,GAAO,EAAQ,OAAQ,OAEjE,EAAU,EAAQ,EACpB,KAAO,CACL,GAAI,CAAC,EAAS,CAAO,GAAK,CAAC,OAAO,OAAO,EAAS,CAAG,EAAG,OAExD,EAAU,EAAQ,EACpB,CAGF,OAAO,CACT,CAEA,SAAgB,EAAU,EAAgB,EAA6C,CACrF,IAAI,EAAmB,EAEvB,IAAK,IAAM,KAAO,EAChB,GAAI,OAAO,GAAQ,SAAU,CAC3B,GAAI,CAAC,MAAM,QAAQ,CAAO,GAAK,EAAM,GAAK,GAAO,EAAQ,OAAQ,MAAO,GAExE,EAAU,EAAQ,EACpB,KAAO,CACL,GAAI,CAAC,EAAS,CAAO,GAAK,CAAC,OAAO,OAAO,EAAS,CAAG,EAAG,MAAO,GAE/D,EAAU,EAAQ,EACpB,CAGF,MAAO,EACT,CAEA,SAAgB,EAAiC,EAAU,EAAoC,EAAkB,CAC/G,GAAM,CAAC,EAAK,GAAG,GAAQ,EAEvB,GAAI,OAAO,GAAQ,SAAU,CAC3B,GAAI,CAAC,MAAM,QAAQ,CAAK,EACtB,MAAM,IAAI,EAAA,iBAAiB,gBAAgB,EAAI,4CAA4C,EAG7F,GAAI,EAAM,GAAK,GAAO,EAAM,OAC1B,MAAM,IAAI,EAAA,iBAAiB,SAAS,EAAI,uCAAuC,EAAM,OAAO,EAAE,EAGhG,GAAI,EAAK,SAAW,EAAG,CACrB,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAU,CAAI,EAEnB,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAY,EAAM,GAAmB,EAAM,CAAI,EAEpD,OAAO,OAAO,CAAI,CAC3B,CAIA,GAFA,EAAc,CAAG,EAEb,CAAC,EAAS,CAAK,EACjB,MAAM,IAAI,EAAA,iBAAiB,kBAAkB,EAAI,8CAA8C,EAGjG,GAAI,EAAK,SAAW,EAAG,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,EAAU,CAAI,CAAE,CAAC,EAEhF,IAAM,EAAQ,EAAM,GAEpB,GAAI,IAAU,IAAA,IAAa,CAAC,EAAS,CAAK,GAAK,CAAC,MAAM,QAAQ,CAAK,EACjE,MAAM,IAAI,EAAA,iBAAiB,kBAAkB,EAAI,wCAAwC,EAG3F,IAAM,EAAa,GAAS,CAAC,EAE7B,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,EAAY,EAAW,EAAM,CAAI,CAAE,CAAC,CAC9E,CAEA,SAAgB,EAAiC,EAAU,EAAa,EAAuC,CAC7G,GAAM,CAAC,EAAK,GAAG,GAAQ,EAEvB,GAAI,OAAO,GAAQ,SAAU,CAE3B,GADI,CAAC,MAAM,QAAQ,CAAK,GACpB,CAAC,MAAM,QAAQ,CAAQ,GAAK,GAAO,EAAS,QAAU,GAAO,EAAM,OAAQ,OAAO,EAEtF,GAAI,EAAK,SAAW,EAAG,CACrB,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAS,GAEd,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAO,CAAC,GAAG,CAAK,EAItB,MAFA,GAAK,GAAO,EAAY,EAAM,GAAmB,EAAS,GAAmB,CAAI,EAE1E,OAAO,OAAO,CAAI,CAC3B,CAEA,GAAI,CAAC,EAAS,CAAK,EAAG,OAAO,EAE7B,GAAI,EAAK,SAAW,EAAG,CACrB,GAAI,OAAO,OAAO,EAAU,CAAG,EAAG,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAO,EAAyB,EAAK,CAAC,EAE1G,GAAM,EAAG,GAAM,EAAU,GAAG,GAAS,EAErC,OAAO,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAiB,EAAyB,GAEhD,GAAI,CAAC,EAAS,CAAa,GAAK,CAAC,MAAM,QAAQ,CAAa,EAAG,CAC7D,GAAI,OAAO,OAAO,EAAU,CAAG,EAAG,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,CAAc,CAAC,EAEzF,GAAM,EAAG,GAAM,EAAU,GAAG,GAAS,EAErC,OAAO,OAAO,OAAO,CAAI,CAC3B,CAEA,IAAM,EAAe,EAAM,GACrB,EAAa,EAAS,CAAY,GAAK,MAAM,QAAQ,CAAY,EAAI,EAAe,CAAC,EAE3F,OAAO,OAAO,OAAO,CAAE,GAAG,GAAQ,GAAM,EAAY,EAAW,EAA4B,CAAI,CAAE,CAAC,CACpG,CAEA,SAAgB,EAAU,EAAgB,EAAoC,EAAyB,CACrG,GAAM,CAAC,EAAK,GAAG,GAAQ,EACjB,EAAY,OAAO,CAAG,EACtB,EAAiC,CAAE,GAAG,CAAK,EAEjD,GAAI,EAAK,SAAW,EACd,EAAM,EAAK,GAAa,GACvB,OAAO,EAAK,OACZ,CAEL,IAAM,EAAU,EADF,EAAS,EAAK,EAAU,EAAK,EAAK,GAA0B,CAAC,EAC1C,EAAM,CAAI,EAEvC,OAAO,KAAK,CAAO,CAAC,CAAC,SAAW,EAAG,OAAO,EAAK,GAC9C,EAAK,GAAa,CACzB,CAEA,OAAO,OAAO,OAAO,CAAI,CAC3B,CAEA,SAAgB,EAAS,EAAgB,EAA6C,CACpF,IAAI,EAAgC,EAEpC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAY,OAAO,CAAG,EAE5B,GAAI,CAAC,EAAS,CAAO,GAAK,CAAC,OAAO,OAAO,EAAS,CAAS,EAAG,MAAO,GAErE,EAAU,EAAQ,EACpB,CAEA,OAAO,IAAY,EACrB,CAEA,SAAgB,EAAS,EAA0B,CAcjD,OAbI,MAAM,QAAQ,CAAK,EACd,OAAO,OACZ,OAAO,YACL,EAAM,KAAK,EAAO,IAAM,CACtB,OAAO,CAAC,EACR,EAAS,CAAK,GAAK,MAAM,QAAQ,CAAK,EAAI,EAAS,CAAK,EAAK,EAC/D,CAAC,CACH,CACF,EAGG,EAAS,CAAK,EAEZ,OAAO,OACZ,OAAO,YACL,OAAO,QAAQ,CAAK,CAAC,CAAC,KAAK,CAAC,EAAK,KAAW,CAC1C,EACA,EAAS,CAAK,GAAK,MAAM,QAAQ,CAAK,EAAI,EAAS,CAAK,EAAK,EAC/D,CAAC,CACH,CACF,EAT6B,CAAC,CAUhC,CAEA,SAAgB,EAAU,EAAiB,EAAwD,CACjG,IAAM,EAAQ,EAAW,EAAQ,CAAI,EAErC,OAAO,OAAO,GAAU,SAAW,EAAQ,IAAA,EAC7C,CAEA,SAAS,EACP,EACA,EACA,EACwB,CACxB,GAAM,CAAC,EAAK,GAAG,GAAQ,EAEvB,GAAI,OAAO,GAAQ,SAAU,CAC3B,IAAM,EAAmB,MAAM,QAAQ,CAAI,EAAI,CAAC,GAAG,CAAI,EAAI,CAAC,EAQ5D,OANI,EAAK,SAAW,EACd,EAAI,KAAS,IAAA,KAAW,EAAI,GAAO,GAEvC,EAAI,GAAO,EAAe,EAAI,GAA4C,EAAM,CAAO,EAGlF,CACT,CAEA,GAAI,CAAC,GAAO,EAAW,IAAI,CAAG,EAAG,OAAO,GAAQ,CAAC,EAEjD,IAAM,EAA2B,EAAS,CAAI,EAAI,CAAE,GAAG,CAAK,EAAI,CAAC,EAQjE,OANI,EAAK,SAAW,EACd,EAAO,KAAS,IAAA,KAAW,EAAO,GAAO,GAE7C,EAAO,GAAO,EAAe,EAAO,GAA4C,EAAM,CAAO,EAGxF,CACT,CAEA,SAAgB,EAAW,EAAiB,EAAoC,EAA4B,CAC1G,IAAM,EAAS,EAAe,EAAM,EAAM,CAAO,EAEjD,OAAO,EAAS,CAAM,EAAI,EAAS,CACrC,CAEA,SAAgB,EAAmB,EAA0B,CAC3D,GAAI,OAAO,GAAW,SAAU,OAAO,EAEvC,GAAI,MAAM,QAAQ,CAAM,EAAG,CACzB,IAAM,EAAa,EAAO,IAAK,GAAS,EAAgB,CAAI,CAAC,EAI7D,OAFI,EAAW,MAAO,GAAU,IAAU,IAAA,EAAS,EAAG,OAE/C,OAAO,OAAO,CAAU,CACjC,CAEA,GAAI,CAAC,EAAS,CAAM,EAAG,OAEvB,IAAM,EAAU,OAAO,QAAQ,CAAM,CAAC,CACnC,KAAK,CAAC,EAAK,KAAW,CAAC,EAAK,EAAgB,CAAK,CAAC,CAAU,CAAC,CAC7D,QAAQ,EAAG,KAAW,IAAU,IAAA,EAAS,EAE5C,OAAO,EAAQ,SAAW,EAAI,IAAA,GAAa,OAAO,OAAO,OAAO,YAAY,CAAO,CAAC,CACtF"}
+{"version":3,"file":"path.cjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["import { ForgeConfigError } from '../errors';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport function isUnsafeKey(key: string): boolean {\n  return !key || unsafeKeys.has(key);\n}\n\ntype ErrorNode = string | ErrorTree | ErrorArray;\nexport interface ErrorTree {\n  readonly [key: string]: ErrorNode;\n}\ntype ErrorArray = ErrorNode[];\ntype MutableErrorTree = Record<string, ErrorNode>;\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n  readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function isRecord(value: unknown): value is RecordValue {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\nexport function assertSafeKey(key: string): void {\n  if (isUnsafeKey(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nfunction isAtomicLeaf(value: unknown): boolean {\n  return (\n    (typeof Blob !== 'undefined' && value instanceof Blob) ||\n    (typeof File !== 'undefined' && value instanceof File) ||\n    value instanceof Date\n  );\n}\n\nexport function immutable<T>(value: T): T {\n  if (Array.isArray(value)) return Object.freeze(value.map(immutable)) as T;\n\n  if (value === null || typeof value !== 'object' || isAtomicLeaf(value)) return value;\n\n  if (!isRecord(value)) {\n    throw new ForgeConfigError(\n      'Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.',\n    );\n  }\n\n  return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, child]) => [key, immutable(child)]))) as T;\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (!Array.isArray(current) || key < 0 || key >= current.length) return undefined;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n      current = current[key];\n    }\n  }\n\n  return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n  let current: unknown = value;\n\n  for (const key of path) {\n    if (typeof key === 'number') {\n      if (!Array.isArray(current) || key < 0 || key >= current.length) return false;\n\n      current = current[key];\n    } else {\n      if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n      current = current[key];\n    }\n  }\n\n  return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    if (!Array.isArray(value)) {\n      throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n    }\n\n    if (key < 0 || key >= value.length) {\n      throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n    }\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = immutable(next);\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = writeAtPath(value[key] as TreeValue, rest, next);\n\n    return Object.freeze(copy) as T;\n  }\n\n  assertSafeKey(key);\n\n  if (!isRecord(value)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n  }\n\n  if (rest.length === 0) return Object.freeze({ ...value, [key]: immutable(next) }) as T;\n\n  const child = value[key];\n\n  if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n    throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n  }\n\n  const childTree = (child ?? {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    if (!Array.isArray(value)) return value;\n    if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n    if (rest.length === 0) {\n      const copy = [...value];\n\n      copy[key] = baseline[key];\n\n      return Object.freeze(copy) as T;\n    }\n\n    const copy = [...value];\n\n    copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n    return Object.freeze(copy) as T;\n  }\n\n  if (!isRecord(value)) return value;\n\n  if (rest.length === 0) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const baselineChild = (baseline as RecordValue)[key];\n\n  if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n    if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n    const { [key]: _removed, ...next } = value;\n\n    return Object.freeze(next) as T;\n  }\n\n  const currentChild = value[key];\n  const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n  return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n  const [key, ...rest] = path;\n  const stringKey = String(key);\n  const copy: Record<string, MetaTree> = { ...meta };\n\n  if (rest.length === 0) {\n    if (next) copy[stringKey] = true;\n    else delete copy[stringKey];\n  } else {\n    const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n    const updated = writeMeta(child, rest, next);\n\n    if (Object.keys(updated).length === 0) delete copy[stringKey];\n    else copy[stringKey] = updated;\n  }\n\n  return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n  let current: MetaTree | undefined = meta;\n\n  for (const key of path) {\n    const stringKey = String(key);\n\n    if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n    current = current[stringKey] as MetaTree;\n  }\n\n  return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n  if (Array.isArray(value)) {\n    return Object.freeze(\n      Object.fromEntries(\n        value.map((child, i) => [\n          String(i),\n          isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n        ]),\n      ),\n    );\n  }\n\n  if (!isRecord(value)) return {};\n\n  return Object.freeze(\n    Object.fromEntries(\n      Object.entries(value).map(([key, child]) => [\n        key,\n        isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n      ]),\n    ),\n  );\n}\n\nexport function readError(errors: unknown, path: readonly (string | number)[]): string | undefined {\n  const error = readAtPath(errors, path);\n\n  return typeof error === 'string' ? error : undefined;\n}\n\nfunction writeErrorNode(\n  node: ErrorTree | ErrorArray | undefined,\n  path: readonly (string | number)[],\n  message: string,\n): ErrorTree | ErrorArray {\n  const [key, ...rest] = path;\n\n  if (typeof key === 'number') {\n    const arr: ErrorNode[] = Array.isArray(node) ? [...node] : [];\n\n    if (rest.length === 0) {\n      if (arr[key] === undefined) arr[key] = message;\n    } else {\n      arr[key] = writeErrorNode(arr[key] as ErrorTree | ErrorArray | undefined, rest, message);\n    }\n\n    return arr;\n  }\n\n  if (isUnsafeKey(key)) return node ?? {};\n\n  const record: MutableErrorTree = isRecord(node) ? { ...node } : {};\n\n  if (rest.length === 0) {\n    if (record[key] === undefined) record[key] = message;\n  } else {\n    record[key] = writeErrorNode(record[key] as ErrorTree | ErrorArray | undefined, rest, message);\n  }\n\n  return record;\n}\n\nexport function writeError(tree: ErrorTree, path: readonly (string | number)[], message: string): ErrorTree {\n  const result = writeErrorNode(tree, path, message);\n\n  return isRecord(result) ? result : tree;\n}\n\nexport function normalizeErrors<T>(errors: T): T | undefined {\n  if (typeof errors === 'string') return errors;\n\n  if (Array.isArray(errors)) {\n    const normalized = errors.map((item) => normalizeErrors(item));\n\n    if (normalized.every((value) => value === undefined)) return undefined;\n\n    return Object.freeze(normalized) as T;\n  }\n\n  if (!isRecord(errors)) return undefined;\n\n  const entries = Object.entries(errors)\n    .map(([key, value]) => [key, normalizeErrors(value)] as const)\n    .filter(([, value]) => value !== undefined);\n\n  return entries.length === 0 ? undefined : (Object.freeze(Object.fromEntries(entries)) as T);\n}\n"],"mappings":"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"}

package/dist/core/path.d.ts

@@ -1,3 +1,4 @@
+export declare function isUnsafeKey(key: string): boolean;
 type ErrorNode = string | ErrorTree | ErrorArray;
 export interface ErrorTree {
     readonly [key: string]: ErrorNode;

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

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/core/path.ts"],"names":[],"mappings":"AAIA,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AACjD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AACD,KAAK,UAAU,GAAG,SAAS,EAAE,CAAC;AAE9B,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,KAAK,SAAS,GAAG,WAAW,GAAG,SAAS,OAAO,EAAE,CAAC;AAClD,KAAK,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAAC;AAChC,UAAU,QAAQ;IAChB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CAClC;AACD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEhC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAM7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAUD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAYxC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAgB/F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAgBrF;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CA4C/G;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,CA8C7G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAiBrG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAYpF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAsBjD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAIjG;AAkCD,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAI1G;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAkB3D"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/core/path.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AACjD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AACD,KAAK,UAAU,GAAG,SAAS,EAAE,CAAC;AAE9B,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,KAAK,SAAS,GAAG,WAAW,GAAG,SAAS,OAAO,EAAE,CAAC;AAClD,KAAK,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAAC;AAChC,UAAU,QAAQ;IAChB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CAClC;AACD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEhC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAM7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAUD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAYxC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAgB/F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAgBrF;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CA4C/G;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,CA8C7G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAiBrG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAYpF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAsBjD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAIjG;AAkCD,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAI1G;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAkB3D"}

package/dist/core/path.js

@@ -6,71 +6,74 @@ var t = /* @__PURE__ */ new Set([
 	"prototype"
 ]);
 function n(e) {
+	return !e || t.has(e);
+}
+function r(e) {
 	if (typeof e != "object" || !e || Array.isArray(e)) return !1;
 	let t = Object.getPrototypeOf(e);
 	return t === Object.prototype || t === null;
 }
-function r(n) {
-	if (!n || t.has(n)) throw new e(`Invalid field key '${n}'.`);
+function i(t) {
+	if (n(t)) throw new e(`Invalid field key '${t}'.`);
 }
-function i(e) {
+function a(e) {
 	return typeof Blob < "u" && e instanceof Blob || typeof File < "u" && e instanceof File || e instanceof Date;
 }
-function a(t) {
-	if (Array.isArray(t)) return Object.freeze(t.map(a));
-	if (typeof t != "object" || !t || i(t)) return t;
-	if (!n(t)) throw new e("Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.");
-	return Object.freeze(Object.fromEntries(Object.entries(t).map(([e, t]) => [e, a(t)])));
+function o(t) {
+	if (Array.isArray(t)) return Object.freeze(t.map(o));
+	if (typeof t != "object" || !t || a(t)) return t;
+	if (!r(t)) throw new e("Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.");
+	return Object.freeze(Object.fromEntries(Object.entries(t).map(([e, t]) => [e, o(t)])));
 }
-function o(e, t) {
-	let r = e;
+function s(e, t) {
+	let n = e;
 	for (let e of t) if (typeof e == "number") {
-		if (!Array.isArray(r) || e < 0 || e >= r.length) return;
-		r = r[e];
+		if (!Array.isArray(n) || e < 0 || e >= n.length) return;
+		n = n[e];
 	} else {
-		if (!n(r) || !Object.hasOwn(r, e)) return;
-		r = r[e];
+		if (!r(n) || !Object.hasOwn(n, e)) return;
+		n = n[e];
 	}
-	return r;
+	return n;
 }
-function s(e, t) {
-	let r = e;
+function c(e, t) {
+	let n = e;
 	for (let e of t) if (typeof e == "number") {
-		if (!Array.isArray(r) || e < 0 || e >= r.length) return !1;
-		r = r[e];
+		if (!Array.isArray(n) || e < 0 || e >= n.length) return !1;
+		n = n[e];
 	} else {
-		if (!n(r) || !Object.hasOwn(r, e)) return !1;
-		r = r[e];
+		if (!r(n) || !Object.hasOwn(n, e)) return !1;
+		n = n[e];
 	}
 	return !0;
 }
-function c(t, i, o) {
-	let [s, ...l] = i;
+function l(t, n, a) {
+	let [s, ...c] = n;
 	if (typeof s == "number") {
 		if (!Array.isArray(t)) throw new e(`Cannot index ${s} because the current value is not an array.`);
 		if (s < 0 || s >= t.length) throw new e(`Index ${s} is out of range for array of length ${t.length}.`);
-		if (l.length === 0) {
+		if (c.length === 0) {
 			let e = [...t];
-			return e[s] = a(o), Object.freeze(e);
+			return e[s] = o(a), Object.freeze(e);
 		}
 		let n = [...t];
-		return n[s] = c(t[s], l, o), Object.freeze(n);
+		return n[s] = l(t[s], c, a), Object.freeze(n);
 	}
-	if (r(s), !n(t)) throw new e(`Cannot select '${s}' because the current value is not an object.`);
-	if (l.length === 0) return Object.freeze({
+	if (i(s), !r(t)) throw new e(`Cannot select '${s}' because the current value is not an object.`);
+	if (c.length === 0) return Object.freeze({
 		...t,
-		[s]: a(o)
+		[s]: o(a)
 	});
 	let u = t[s];
-	if (u !== void 0 && !n(u) && !Array.isArray(u)) throw new e(`Cannot select '${s}' because it is not an object or array.`);
+	if (u !== void 0 && !r(u) && !Array.isArray(u)) throw new e(`Cannot select '${s}' because it is not an object or array.`);
 	let d = u ?? {};
 	return Object.freeze({
 		...t,
-		[s]: c(d, l, o)
+		[s]: l(d, c, a)
 	});
 }
-function l(e, t, r) {
-	let [i, ...a] = r;
+function u(e, t, n) {
+	let [i, ...a] = n;
 	if (typeof i == "number") {
 		if (!Array.isArray(e) || !Array.isArray(t) || i >= t.length || i >= e.length) return e;
 		if (a.length === 0) {
@@ -78,9 +81,9 @@ function l(e, t, r) {
 			return n[i] = t[i], Object.freeze(n);
 		}
 		let n = [...e];
-		return n[i] = l(e[i], t[i], a), Object.freeze(n);
+		return n[i] = u(e[i], t[i], a), Object.freeze(n);
 	}
-	if (!n(e)) return e;
+	if (!r(e)) return e;
 	if (a.length === 0) {
 		if (Object.hasOwn(t, i)) return Object.freeze({
 			...e,
@@ -90,7 +93,7 @@ function l(e, t, r) {
 		return Object.freeze(r);
 	}
 	let o = t[i];
-	if (!n(o) && !Array.isArray(o)) {
+	if (!r(o) && !Array.isArray(o)) {
 		if (Object.hasOwn(t, i)) return Object.freeze({
 			...e,
 			[i]: o
@@ -98,62 +101,62 @@ function l(e, t, r) {
 		let { [i]: n, ...r } = e;
 		return Object.freeze(r);
 	}
-	let s = e[i], c = n(s) || Array.isArray(s) ? s : {};
+	let s = e[i], c = r(s) || Array.isArray(s) ? s : {};
 	return Object.freeze({
 		...e,
-		[i]: l(c, o, a)
+		[i]: u(c, o, a)
 	});
 }
-function u(e, t, r) {
+function d(e, t, n) {
 	let [i, ...a] = t, o = String(i), s = { ...e };
-	if (a.length === 0) r ? s[o] = !0 : delete s[o];
+	if (a.length === 0) n ? s[o] = !0 : delete s[o];
 	else {
-		let t = u(n(e[o]) ? e[o] : {}, a, r);
+		let t = d(r(e[o]) ? e[o] : {}, a, n);
 		Object.keys(t).length === 0 ? delete s[o] : s[o] = t;
 	}
 	return Object.freeze(s);
 }
-function d(e, t) {
-	let r = e;
+function f(e, t) {
+	let n = e;
 	for (let e of t) {
 		let t = String(e);
-		if (!n(r) || !Object.hasOwn(r, t)) return !1;
-		r = r[t];
+		if (!r(n) || !Object.hasOwn(n, t)) return !1;
+		n = n[t];
 	}
-	return r === !0;
+	return n === !0;
 }
-function f(e) {
-	return Array.isArray(e) ? Object.freeze(Object.fromEntries(e.map((e, t) => [String(t), n(e) || Array.isArray(e) ? f(e) : !0]))) : n(e) ? Object.freeze(Object.fromEntries(Object.entries(e).map(([e, t]) => [e, n(t) || Array.isArray(t) ? f(t) : !0]))) : {};
+function p(e) {
+	return Array.isArray(e) ? Object.freeze(Object.fromEntries(e.map((e, t) => [String(t), r(e) || Array.isArray(e) ? p(e) : !0]))) : r(e) ? Object.freeze(Object.fromEntries(Object.entries(e).map(([e, t]) => [e, r(t) || Array.isArray(t) ? p(t) : !0]))) : {};
 }
-function p(e, t) {
-	let n = o(e, t);
+function m(e, t) {
+	let n = s(e, t);
 	return typeof n == "string" ? n : void 0;
 }
-function m(e, r, i) {
-	let [a, ...o] = r;
+function h(e, t, i) {
+	let [a, ...o] = t;
 	if (typeof a == "number") {
 		let t = Array.isArray(e) ? [...e] : [];
-		return o.length === 0 ? t[a] === void 0 && (t[a] = i) : t[a] = m(t[a], o, i), t;
+		return o.length === 0 ? t[a] === void 0 && (t[a] = i) : t[a] = h(t[a], o, i), t;
 	}
-	if (!a || t.has(a)) return e ?? {};
-	let s = n(e) ? { ...e } : {};
-	return o.length === 0 ? s[a] === void 0 && (s[a] = i) : s[a] = m(s[a], o, i), s;
+	if (n(a)) return e ?? {};
+	let s = r(e) ? { ...e } : {};
+	return o.length === 0 ? s[a] === void 0 && (s[a] = i) : s[a] = h(s[a], o, i), s;
 }
-function h(e, t, r) {
-	let i = m(e, t, r);
-	return n(i) ? i : e;
+function g(e, t, n) {
+	let i = h(e, t, n);
+	return r(i) ? i : e;
 }
-function g(e) {
+function _(e) {
 	if (typeof e == "string") return e;
 	if (Array.isArray(e)) {
-		let t = e.map((e) => g(e));
+		let t = e.map((e) => _(e));
 		return t.every((e) => e === void 0) ? void 0 : Object.freeze(t);
 	}
-	if (!n(e)) return;
-	let t = Object.entries(e).map(([e, t]) => [e, g(t)]).filter(([, e]) => e !== void 0);
+	if (!r(e)) return;
+	let t = Object.entries(e).map(([e, t]) => [e, _(t)]).filter(([, e]) => e !== void 0);
 	return t.length === 0 ? void 0 : Object.freeze(Object.fromEntries(t));
 }
 //#endregion
-export { r as assertSafeKey, s as hasAtPath, a as immutable, n as isRecord, g as normalizeErrors, o as readAtPath, p as readError, d as readMeta, l as resetAtPath, f as touchAll, c as writeAtPath, h as writeError, u as writeMeta };
+export { i as assertSafeKey, c as hasAtPath, o as immutable, r as isRecord, n as isUnsafeKey, _ as normalizeErrors, s as readAtPath, m as readError, f as readMeta, u as resetAtPath, p as touchAll, l as writeAtPath, g as writeError, d as writeMeta };
 
 //# sourceMappingURL=path.js.map

package/dist/core/path.js.map

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

package/dist/errors.cjs

@@ -1,2 +1,2 @@
-var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{constructor(e){super(e?`Cannot call ${e}() on a disposed form`:`Cannot modify a disposed form`)}},n=class extends e{},r=class extends e{},i=class extends e{};exports.ForgeConfigError=n,exports.ForgeDisposedError=t,exports.ForgeError=e,exports.ForgeSubmitError=r,exports.ForgeValidationError=i;
+var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{constructor(e){super(e?`Cannot call ${e}() on a disposed form`:`Cannot modify a disposed form`)}},n=class extends e{},r=class extends e{},i=class extends e{};exports.ForgeConfigError=n,exports.ForgeDisposedError=t,exports.ForgeError=e,exports.ForgeSubmitError=r,exports.ForgeValidationError=i;
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ForgeError {\n    return err instanceof ForgeError;\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  /** @param op The public method name that was called (e.g. `'set'`) — included in the\n   * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n  constructor(op?: string) {\n    super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAmB,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CAEA,OAAO,GAAG,EAAiC,CACzC,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAwC,CAAW,CAGjD,YAAY,EAAa,CACvB,MAAM,EAAK,eAAe,EAAG,uBAAyB,+BAA+B,CACvF,CACF,EAGa,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAA0C,CAAW,CAAC"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  /** @param op The public method name that was called (e.g. `'set'`) — included in the\n   * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n  constructor(op?: string) {\n    super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {}\n"],"mappings":"AACA,IAAa,EAAb,cAAgC,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,EAAb,cAAwC,CAAW,CAGjD,YAAY,EAAa,CACvB,MAAM,EAAK,eAAe,EAAG,uBAAyB,+BAA+B,CACvF,CACF,EAGa,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAA0C,CAAW,CAAC"}

package/dist/errors.d.ts

@@ -1,7 +1,6 @@
 /** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */
 export declare class ForgeError extends Error {
     constructor(message: string, opts?: ErrorOptions);
-    static is(err: unknown): err is ForgeError;
 }
 /** Thrown when any method is called on a disposed form. */
 export declare class ForgeDisposedError extends ForgeError {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAMhD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU;CAG3C;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,UAAU;IAChD;4FACwF;gBAC5E,EAAE,CAAC,EAAE,MAAM;CAGxB;AAED,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,gHAAgH;AAChH,qBAAa,oBAAqB,SAAQ,UAAU;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAKjD;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,UAAU;IAChD;4FACwF;gBAC5E,EAAE,CAAC,EAAE,MAAM;CAGxB;AAED,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,gHAAgH;AAChH,qBAAa,oBAAqB,SAAQ,UAAU;CAAG"}

package/dist/errors.js

@@ -1,11 +1,8 @@
 //#region src/errors.ts
-var e = class e extends Error {
+var e = class extends Error {
 	constructor(e, t) {
 		super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
 	}
-	static is(t) {
-		return t instanceof e;
-	}
 }, t = class extends e {
 	constructor(e) {
 		super(e ? `Cannot call ${e}() on a disposed form` : "Cannot modify a disposed form");

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ForgeError {\n    return err instanceof ForgeError;\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  /** @param op The public method name that was called (e.g. `'set'`) — included in the\n   * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n  constructor(op?: string) {\n    super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {}\n"],"mappings":";AACA,IAAa,IAAb,MAAa,UAAmB,MAAM;CACpC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;CAEA,OAAO,GAAG,GAAiC;EACzC,OAAO,aAAe;CACxB;AACF,GAGa,IAAb,cAAwC,EAAW;CAGjD,YAAY,GAAa;EACvB,MAAM,IAAK,eAAe,EAAG,yBAAyB,+BAA+B;CACvF;AACF,GAGa,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAA0C,EAAW,CAAC"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  /** @param op The public method name that was called (e.g. `'set'`) — included in the\n   * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n  constructor(op?: string) {\n    super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {}\n"],"mappings":";AACA,IAAa,IAAb,cAAgC,MAAM;CACpC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAGa,IAAb,cAAwC,EAAW;CAGjD,YAAY,GAAa;EACvB,MAAM,IAAK,eAAe,EAAG,yBAAyB,+BAA+B;CACvF;AACF,GAGa,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAA0C,EAAW,CAAC"}

package/dist/forge.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{constructor(e){super(e?`Cannot call ${e}() on a disposed form`:`Cannot modify a disposed form`)}},n=class extends e{},r=class extends e{},i=class extends e{},a=new Set([`__proto__`,`constructor`,`prototype`]);function o(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function s(e){if(!e||a.has(e))throw new n(`Invalid field key '${e}'.`)}function c(e){return typeof Blob<`u`&&e instanceof Blob||typeof File<`u`&&e instanceof File||e instanceof Date}function l(e){if(Array.isArray(e))return Object.freeze(e.map(l));if(typeof e!=`object`||!e||c(e))return e;if(!o(e))throw new n(`Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.`);return Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>[e,l(t)])))}function u(e,t){let n=e;for(let e of t)if(typeof e==`number`){if(!Array.isArray(n)||e<0||e>=n.length)return;n=n[e]}else{if(!o(n)||!Object.hasOwn(n,e))return;n=n[e]}return n}function d(e,t){let n=e;for(let e of t)if(typeof e==`number`){if(!Array.isArray(n)||e<0||e>=n.length)return!1;n=n[e]}else{if(!o(n)||!Object.hasOwn(n,e))return!1;n=n[e]}return!0}function f(e,t,r){let[i,...a]=t;if(typeof i==`number`){if(!Array.isArray(e))throw new n(`Cannot index ${i} because the current value is not an array.`);if(i<0||i>=e.length)throw new n(`Index ${i} is out of range for array of length ${e.length}.`);if(a.length===0){let t=[...e];return t[i]=l(r),Object.freeze(t)}let t=[...e];return t[i]=f(e[i],a,r),Object.freeze(t)}if(s(i),!o(e))throw new n(`Cannot select '${i}' because the current value is not an object.`);if(a.length===0)return Object.freeze({...e,[i]:l(r)});let c=e[i];if(c!==void 0&&!o(c)&&!Array.isArray(c))throw new n(`Cannot select '${i}' because it is not an object or array.`);let u=c??{};return Object.freeze({...e,[i]:f(u,a,r)})}function p(e,t,n){let[r,...i]=n;if(typeof r==`number`){if(!Array.isArray(e)||!Array.isArray(t)||r>=t.length||r>=e.length)return e;if(i.length===0){let n=[...e];return n[r]=t[r],Object.freeze(n)}let n=[...e];return n[r]=p(e[r],t[r],i),Object.freeze(n)}if(!o(e))return e;if(i.length===0){if(Object.hasOwn(t,r))return Object.freeze({...e,[r]:t[r]});let{[r]:n,...i}=e;return Object.freeze(i)}let a=t[r];if(!o(a)&&!Array.isArray(a)){if(Object.hasOwn(t,r))return Object.freeze({...e,[r]:a});let{[r]:n,...i}=e;return Object.freeze(i)}let s=e[r],c=o(s)||Array.isArray(s)?s:{};return Object.freeze({...e,[r]:p(c,a,i)})}function m(e,t,n){let[r,...i]=t,a=String(r),s={...e};if(i.length===0)n?s[a]=!0:delete s[a];else{let t=m(o(e[a])?e[a]:{},i,n);Object.keys(t).length===0?delete s[a]:s[a]=t}return Object.freeze(s)}function h(e,t){let n=e;for(let e of t){let t=String(e);if(!o(n)||!Object.hasOwn(n,t))return!1;n=n[t]}return n===!0}function g(e){return Array.isArray(e)?Object.freeze(Object.fromEntries(e.map((e,t)=>[String(t),o(e)||Array.isArray(e)?g(e):!0]))):o(e)?Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>[e,o(t)||Array.isArray(t)?g(t):!0]))):{}}function _(e,t){let n=u(e,t);return typeof n==`string`?n:void 0}function v(e){if(typeof e==`string`)return e;if(Array.isArray(e)){let t=e.map(e=>v(e));return t.every(e=>e===void 0)?void 0:Object.freeze(t)}if(!o(e))return;let t=Object.entries(e).map(([e,t])=>[e,v(t)]).filter(([,e])=>e!==void 0);return t.length===0?void 0:Object.freeze(Object.fromEntries(t))}function y(e,t){let n=u(e.value,t),r=u(e.baseline,t);return Object.freeze({dirty:n!==r||d(e.value,t)!==d(e.baseline,t),error:_(e.errors,t),touched:h(e.touched,t),value:n})}function b(e,t){return Object.assign({get dirty(){return y(t.readState(),e).dirty},get error(){return y(t.readState(),e).error},reset(){t.ensureActive(`field().reset`),t.abortValidation(),t.resetValue(e)},set(n){t.ensureActive(`field().set`),t.abortValidation();let r=u(t.readState().value,e),i=typeof n==`function`?n(r):n;t.setValue(e,i)},get state(){return y(t.readState(),e)},subscribe(n,r={}){t.ensureActive(`field().subscribe`);let i=y(t.readState(),e);return r.immediate&&n(i),t.addListener(()=>{let r=y(t.readState(),e);(r.value!==i.value||r.error!==i.error||r.touched!==i.touched||r.dirty!==i.dirty)&&(i=r,n(r))})},touch(){t.ensureActive(`field().touch`),t.setTouched(e,!0)},get touched(){return y(t.readState(),e).touched},get value(){return y(t.readState(),e).value}},{field(r){if(typeof r==`number`){let i=u(t.readState().value,e);if(i!==void 0&&!Array.isArray(i))throw new n(`Cannot index ${r} because the current field value is not an array.`);return b([...e,r],t)}s(r);let i=u(t.readState().value,e);if(i!==void 0&&!o(i))throw new n(`Cannot select '${r}' because the current field value is not an object.`);return b([...e,r],t)}})}function x(e){queueMicrotask(()=>{throw e})}function S(e){let t=new Set;function n(t){if(!e){x(t);return}try{e(t)}catch(e){x(e)}}return{add(e){return t.add(e),()=>t.delete(e)},clear(){t.clear()},notify(){for(let e of[...t])try{e()}catch(e){n(e)}}}}function C(e){return Object.freeze({errors:e.errors,formError:e.formError,hasErrors:e.formError!==void 0||e.errors!==void 0,submitCount:e.submitCount,submitting:e.isSubmitting,touched:Object.keys(e.touched).length>0,validating:e.isValidating,validity:e.validity})}function w(e){let a=l(e.initialValues),c=S(e.onSubscriberError),u=new AbortController,d=!1,h,_={baseline:a,errors:void 0,formError:void 0,isSubmitting:!1,isValidating:!1,submitCount:0,touched:{},validity:`unknown`,value:a};function y(e){if(d)throw new t(e)}function x(e){_=Object.freeze(e(_)),c.notify()}function w(){h?.abort()}let T={abortValidation:w,addListener:c.add,ensureActive:y,readState:()=>_,resetValue(e){x(t=>({...t,touched:m(t.touched,e,!1),validity:`unknown`,value:p(t.value,t.baseline,e)}))},setTouched(e,t){x(n=>({...n,touched:m(n.touched,e,t)}))},setValue(e,t){x(n=>({...n,validity:`unknown`,value:f(n.value,e,t)}))}};async function E(t){y(`validate`),w();let n=new AbortController,r=t?AbortSignal.any([n.signal,t]):n.signal;h=n,x(e=>({...e,isValidating:!0}));try{let t=e.validate?await e.validate(_.value,r):void 0;if(r.aborted||h!==n)return Object.freeze({status:`aborted`});let i=t?.fields?v(l(t.fields)):void 0,a=t?.formError,o=i===void 0&&a===void 0?`valid`:`invalid`;return x(e=>({...e,errors:i,formError:a,validity:o})),Object.freeze(o===`valid`?{status:`valid`}:{errors:i,formError:a,status:`invalid`})}catch(e){if(r.aborted||h!==n)return Object.freeze({status:`aborted`});throw new i(`Form validation failed.`,{cause:e})}finally{h===n&&(h=void 0,d||x(e=>({...e,isValidating:!1})))}}let D={get disposalSignal(){return u.signal},dispose(){d||(d=!0,u.abort(),w(),c.clear())},get disposed(){return d},field(e){if(s(e),!o(_.value))throw new n(`Form value must be an object.`);return b([e],T)},reset(e){y(`reset`),w();let t=e===void 0?_.baseline:l(e);x(e=>({...e,baseline:t,errors:void 0,formError:void 0,touched:{},validity:`unknown`,value:t}))},set(e){y(`set`),w();let t=typeof e==`function`?e(D.value):e;x(e=>({...e,errors:void 0,formError:void 0,validity:`unknown`,value:l(t)}))},get state(){return C(_)},async submit(e,t){if(y(`submit`),_.isSubmitting)throw new r(`submit() called while a submission is already in progress`);let n=t?AbortSignal.any([u.signal,t]):u.signal;x(e=>({...e,isSubmitting:!0,submitCount:e.submitCount+1,touched:g(e.value)}));try{let r=await E(t);if(r.status===`aborted`)return Object.freeze({status:`aborted`});if(r.status===`invalid`)return Object.freeze({errors:r.errors,formError:r.formError,status:`invalid`});try{return Object.freeze({status:`ok`,value:await e(D.value,n)})}catch(e){if(n.aborted)return Object.freeze({status:`aborted`});throw e}}finally{d||x(e=>({...e,isSubmitting:!1}))}},subscribe(e,t={}){return y(`subscribe`),t.immediate&&e(C(_)),c.add(()=>e(C(_)))},[Symbol.dispose](){D.dispose()},validate:E,get value(){return _.value}};return D}exports.ForgeConfigError=n,exports.ForgeDisposedError=t,exports.ForgeError=e,exports.ForgeSubmitError=r,exports.ForgeValidationError=i,exports.createForm=w;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{constructor(e){super(e?`Cannot call ${e}() on a disposed form`:`Cannot modify a disposed form`)}},n=class extends e{},r=class extends e{},i=class extends e{},a=new Set([`__proto__`,`constructor`,`prototype`]);function o(e){return!e||a.has(e)}function s(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function c(e){if(o(e))throw new n(`Invalid field key '${e}'.`)}function l(e){return typeof Blob<`u`&&e instanceof Blob||typeof File<`u`&&e instanceof File||e instanceof Date}function u(e){if(Array.isArray(e))return Object.freeze(e.map(u));if(typeof e!=`object`||!e||l(e))return e;if(!s(e))throw new n(`Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.`);return Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>[e,u(t)])))}function d(e,t){let n=e;for(let e of t)if(typeof e==`number`){if(!Array.isArray(n)||e<0||e>=n.length)return;n=n[e]}else{if(!s(n)||!Object.hasOwn(n,e))return;n=n[e]}return n}function f(e,t){let n=e;for(let e of t)if(typeof e==`number`){if(!Array.isArray(n)||e<0||e>=n.length)return!1;n=n[e]}else{if(!s(n)||!Object.hasOwn(n,e))return!1;n=n[e]}return!0}function p(e,t,r){let[i,...a]=t;if(typeof i==`number`){if(!Array.isArray(e))throw new n(`Cannot index ${i} because the current value is not an array.`);if(i<0||i>=e.length)throw new n(`Index ${i} is out of range for array of length ${e.length}.`);if(a.length===0){let t=[...e];return t[i]=u(r),Object.freeze(t)}let t=[...e];return t[i]=p(e[i],a,r),Object.freeze(t)}if(c(i),!s(e))throw new n(`Cannot select '${i}' because the current value is not an object.`);if(a.length===0)return Object.freeze({...e,[i]:u(r)});let o=e[i];if(o!==void 0&&!s(o)&&!Array.isArray(o))throw new n(`Cannot select '${i}' because it is not an object or array.`);let l=o??{};return Object.freeze({...e,[i]:p(l,a,r)})}function m(e,t,n){let[r,...i]=n;if(typeof r==`number`){if(!Array.isArray(e)||!Array.isArray(t)||r>=t.length||r>=e.length)return e;if(i.length===0){let n=[...e];return n[r]=t[r],Object.freeze(n)}let n=[...e];return n[r]=m(e[r],t[r],i),Object.freeze(n)}if(!s(e))return e;if(i.length===0){if(Object.hasOwn(t,r))return Object.freeze({...e,[r]:t[r]});let{[r]:n,...i}=e;return Object.freeze(i)}let a=t[r];if(!s(a)&&!Array.isArray(a)){if(Object.hasOwn(t,r))return Object.freeze({...e,[r]:a});let{[r]:n,...i}=e;return Object.freeze(i)}let o=e[r],c=s(o)||Array.isArray(o)?o:{};return Object.freeze({...e,[r]:m(c,a,i)})}function h(e,t,n){let[r,...i]=t,a=String(r),o={...e};if(i.length===0)n?o[a]=!0:delete o[a];else{let t=h(s(e[a])?e[a]:{},i,n);Object.keys(t).length===0?delete o[a]:o[a]=t}return Object.freeze(o)}function g(e,t){let n=e;for(let e of t){let t=String(e);if(!s(n)||!Object.hasOwn(n,t))return!1;n=n[t]}return n===!0}function _(e){return Array.isArray(e)?Object.freeze(Object.fromEntries(e.map((e,t)=>[String(t),s(e)||Array.isArray(e)?_(e):!0]))):s(e)?Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>[e,s(t)||Array.isArray(t)?_(t):!0]))):{}}function v(e,t){let n=d(e,t);return typeof n==`string`?n:void 0}function y(e){if(typeof e==`string`)return e;if(Array.isArray(e)){let t=e.map(e=>y(e));return t.every(e=>e===void 0)?void 0:Object.freeze(t)}if(!s(e))return;let t=Object.entries(e).map(([e,t])=>[e,y(t)]).filter(([,e])=>e!==void 0);return t.length===0?void 0:Object.freeze(Object.fromEntries(t))}function b(e,t){let n=d(e.value,t),r=d(e.baseline,t);return Object.freeze({dirty:n!==r||f(e.value,t)!==f(e.baseline,t),error:v(e.errors,t),touched:g(e.touched,t),value:n})}function x(e,t){return Object.assign({get dirty(){return b(t.readState(),e).dirty},get error(){return b(t.readState(),e).error},reset(){t.ensureActive(`field().reset`),t.abortValidation(),t.resetValue(e)},set(n){t.ensureActive(`field().set`),t.abortValidation();let r=d(t.readState().value,e),i=typeof n==`function`?n(r):n;t.setValue(e,i)},get state(){return b(t.readState(),e)},subscribe(n,r={}){t.ensureActive(`field().subscribe`);let i=b(t.readState(),e);return r.immediate&&n(i),t.addListener(()=>{let r=b(t.readState(),e);(r.value!==i.value||r.error!==i.error||r.touched!==i.touched||r.dirty!==i.dirty)&&(i=r,n(r))})},touch(){t.ensureActive(`field().touch`),t.setTouched(e,!0)},get touched(){return b(t.readState(),e).touched},get value(){return b(t.readState(),e).value}},{field(r){if(typeof r==`number`){let i=d(t.readState().value,e);if(i!==void 0&&!Array.isArray(i))throw new n(`Cannot index ${r} because the current field value is not an array.`);return x([...e,r],t)}c(r);let i=d(t.readState().value,e);if(i!==void 0&&!s(i))throw new n(`Cannot select '${r}' because the current field value is not an object.`);return x([...e,r],t)}})}function S(e){queueMicrotask(()=>{throw e})}function C(e){let t=new Set;function n(t){if(!e){S(t);return}try{e(t)}catch(e){S(e)}}return{add(e){return t.add(e),()=>t.delete(e)},clear(){t.clear()},notify(){for(let e of[...t])try{e()}catch(e){n(e)}}}}function w(e){return Object.freeze({errors:e.errors,formError:e.formError,hasErrors:e.formError!==void 0||e.errors!==void 0,submitCount:e.submitCount,submitting:e.isSubmitting,touched:Object.keys(e.touched).length>0,validating:e.isValidating,validity:e.validity})}function T(e){let a=u(e.initialValues),o=C(e.onSubscriberError),l=new AbortController,d=!1,f,g={baseline:a,errors:void 0,formError:void 0,isSubmitting:!1,isValidating:!1,submitCount:0,touched:{},validity:`unknown`,value:a};function v(e){if(d)throw new t(e)}function b(e){g=Object.freeze(e(g)),o.notify()}function S(){f?.abort()}let T={abortValidation:S,addListener:o.add,ensureActive:v,readState:()=>g,resetValue(e){b(t=>({...t,touched:h(t.touched,e,!1),validity:`unknown`,value:m(t.value,t.baseline,e)}))},setTouched(e,t){b(n=>({...n,touched:h(n.touched,e,t)}))},setValue(e,t){b(n=>({...n,validity:`unknown`,value:p(n.value,e,t)}))}};async function E(t){v(`validate`),S();let n=new AbortController,r=t?AbortSignal.any([n.signal,t]):n.signal;f=n,b(e=>({...e,isValidating:!0}));try{let t=e.validate?await e.validate(g.value,r):void 0;if(r.aborted||f!==n)return Object.freeze({status:`aborted`});let i=t?.fields?y(u(t.fields)):void 0,a=t?.formError,o=i===void 0&&a===void 0?`valid`:`invalid`;return b(e=>({...e,errors:i,formError:a,validity:o})),Object.freeze(o===`valid`?{status:`valid`}:{errors:i,formError:a,status:`invalid`})}catch(e){if(r.aborted||f!==n)return Object.freeze({status:`aborted`});throw new i(`Form validation failed.`,{cause:e})}finally{f===n&&(f=void 0,d||b(e=>({...e,isValidating:!1})))}}let D={get disposalSignal(){return l.signal},dispose(){d||(d=!0,l.abort(),S(),o.clear())},get disposed(){return d},field(e){if(c(e),!s(g.value))throw new n(`Form value must be an object.`);return x([e],T)},reset(e){v(`reset`),S();let t=e===void 0?g.baseline:u(e);b(e=>({...e,baseline:t,errors:void 0,formError:void 0,touched:{},validity:`unknown`,value:t}))},set(e){v(`set`),S();let t=typeof e==`function`?e(D.value):e;b(e=>({...e,errors:void 0,formError:void 0,validity:`unknown`,value:u(t)}))},get state(){return w(g)},async submit(e,t){if(v(`submit`),g.isSubmitting)throw new r(`submit() called while a submission is already in progress`);let n=t?AbortSignal.any([l.signal,t]):l.signal;b(e=>({...e,isSubmitting:!0,submitCount:e.submitCount+1,touched:_(e.value)}));try{let r=await E(t);if(r.status===`aborted`)return Object.freeze({status:`aborted`});if(r.status===`invalid`)return Object.freeze({errors:r.errors,formError:r.formError,status:`invalid`});try{return Object.freeze({status:`ok`,value:await e(D.value,n)})}catch(e){if(n.aborted)return Object.freeze({status:`aborted`});throw e}}finally{d||b(e=>({...e,isSubmitting:!1}))}},subscribe(e,t={}){return v(`subscribe`),t.immediate&&e(w(g)),o.add(()=>e(w(g)))},[Symbol.dispose](){D.dispose()},validate:E,get value(){return g.value}};return D}exports.ForgeConfigError=n,exports.ForgeDisposedError=t,exports.ForgeError=e,exports.ForgeSubmitError=r,exports.ForgeValidationError=i,exports.createForm=T;
 //# sourceMappingURL=forge.cjs.map