@earendil-works/chord 0.86.1 → 0.87.0

package/dist/state/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../src/state/draft.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,KAAK,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACpF,CAAC,GACD,CAAC,SAAS,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GACzC,CAAC,GACD,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GACtC,CAAC,GACD,CAAC,SAAS,MAAM,GACf;IAAE,CAAC,UAAU,GAAG,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;CAAE,GAClE,CAAC,CAAC;AAER,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAChC,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAwBF,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAgCpH;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAEvF","sourcesContent":["/** A mutable transaction-scoped view of a JSON value, preserving tuple positions. */\nexport type Draft<T, Depth extends readonly unknown[] = []> = Depth[\"length\"] extends 8\n\t? T\n\t: T extends null | boolean | number | string\n\t\t? T\n\t\t: T extends (...args: never[]) => unknown\n\t\t\t? T\n\t\t\t: T extends object\n\t\t\t\t? { -readonly [Key in keyof T]: Draft<T[Key], [...Depth, unknown]> }\n\t\t\t\t: T;\n\nexport type ProduceMetadata<T> = {\n\tvalue: T;\n\towned: WeakSet<object>;\n};\n\ntype Container = Record<string, unknown> | unknown[];\n\ntype DraftState = {\n\tbase: Container;\n\tcontext: DraftContext;\n\tcopy: Container | undefined;\n\tmethods: Map<string, unknown> | undefined;\n\tproxy: object;\n\ttarget: unknown[] | undefined;\n};\n\ntype DraftContext = {\n\tactive: boolean;\n\tcreated: DraftState[];\n\towned: WeakSet<object>;\n\tproxies: WeakMap<object, DraftState>;\n\tstates: WeakMap<object, DraftState>;\n};\n\nconst RELEASED_BASE: Container = Object.freeze({});\nconst ARRAY_MUTATORS = new Set([\"push\", \"pop\", \"shift\", \"unshift\", \"splice\", \"sort\", \"reverse\", \"fill\", \"copyWithin\"]);\n\n/** Run a mutation recipe and return its value with transaction ownership metadata. */\nexport function produceWithMetadata<T extends object>(base: T, recipe: (draft: Draft<T>) => void): ProduceMetadata<T> {\n\tconst context: DraftContext = {\n\t\tactive: true,\n\t\tcreated: [],\n\t\towned: new WeakSet<object>(),\n\t\tproxies: new WeakMap<object, DraftState>(),\n\t\tstates: new WeakMap<object, DraftState>(),\n\t};\n\tconst root = getState(context, base as Container);\n\ttry {\n\t\tconst outcome = (recipe as (draft: Draft<T>) => unknown)(root.proxy as Draft<T>);\n\t\tif (isPromiseLike(outcome)) {\n\t\t\tvoid Promise.resolve(outcome).catch(() => undefined);\n\t\t\tthrow new TypeError(\"Replicated state change callbacks must be synchronous\");\n\t\t}\n\t\treturn {\n\t\t\tvalue: finalize(root, new Set<DraftState>(), new WeakMap<DraftState, Container>()) as T,\n\t\t\towned: context.owned,\n\t\t};\n\t} finally {\n\t\tcontext.active = false;\n\t\tfor (const state of context.created) {\n\t\t\tstate.base = RELEASED_BASE;\n\t\t\tstate.copy = undefined;\n\t\t\tstate.methods = undefined;\n\t\t\tstate.proxy = RELEASED_BASE;\n\t\t\tstate.target = undefined;\n\t\t}\n\t\tcontext.created.length = 0;\n\t\tcontext.proxies = new WeakMap();\n\t\tcontext.states = new WeakMap();\n\t}\n}\n\n/** Run a mutation recipe against a copy-on-write draft of `base`. */\nexport function produce<T extends object>(base: T, recipe: (draft: Draft<T>) => void): T {\n\treturn produceWithMetadata(base, recipe).value;\n}\n\nfunction getState(context: DraftContext, base: Container): DraftState {\n\tconst existing = context.states.get(base);\n\tif (existing !== undefined) return existing;\n\n\tconst target = Array.isArray(base) ? [] : undefined;\n\tif (target !== undefined) Reflect.set(target, \"length\", base.length);\n\tconst state: DraftState = {\n\t\tbase,\n\t\tcontext,\n\t\tcopy: undefined,\n\t\tmethods: undefined,\n\t\tproxy: target ?? {},\n\t\ttarget,\n\t};\n\tstate.proxy = new Proxy(target ?? state, createHandler(state));\n\tcontext.states.set(base, state);\n\tcontext.proxies.set(state.proxy, state);\n\tcontext.created.push(state);\n\treturn state;\n}\n\ntype DraftHandler = ProxyHandler<object> & { state: DraftState };\n\nconst handlerPrototype: ProxyHandler<object> = {\n\tdeleteProperty(this: DraftHandler, _target, property): boolean {\n\t\tconst state = this.state;\n\t\tassertStringWrite(property);\n\t\tconst current = currentValue(state);\n\t\tif (Array.isArray(current)) throw new TypeError(\"Draft arrays cannot contain holes\");\n\t\tif (!Object.hasOwn(current, property)) return true;\n\t\tconst deleted = Reflect.deleteProperty(ensureCopy(state), property);\n\t\tsyncArrayTarget(state);\n\t\treturn deleted;\n\t},\n\tdefineProperty(this: DraftHandler): never {\n\t\tassertActive(this.state.context);\n\t\tthrow new TypeError(\"Defining draft properties is not supported\");\n\t},\n\tget(this: DraftHandler, _target, property): unknown {\n\t\tconst state = this.state;\n\t\tconst current = currentValue(state);\n\t\tconst value = Reflect.get(current, property, state.proxy);\n\t\tif (Array.isArray(current) && typeof property === \"string\" && ARRAY_MUTATORS.has(property)) {\n\t\t\treturn arrayMutator(state, property, value);\n\t\t}\n\t\treturn draftValue(state.context, value);\n\t},\n\tgetOwnPropertyDescriptor(this: DraftHandler, _target, property): PropertyDescriptor | undefined {\n\t\tconst state = this.state;\n\t\tconst current = currentValue(state);\n\t\tconst descriptor = Reflect.getOwnPropertyDescriptor(current, property);\n\t\tif (descriptor === undefined) return undefined;\n\t\tif (Array.isArray(current) && property === \"length\") {\n\t\t\tsyncArrayTarget(state);\n\t\t\treturn Reflect.getOwnPropertyDescriptor(state.target!, property);\n\t\t}\n\t\treturn {\n\t\t\tconfigurable: true,\n\t\t\tenumerable: descriptor.enumerable,\n\t\t\tvalue: \"value\" in descriptor ? draftValue(state.context, descriptor.value) : undefined,\n\t\t\twritable: true,\n\t\t};\n\t},\n\tgetPrototypeOf(this: DraftHandler): object | null {\n\t\tassertActive(this.state.context);\n\t\treturn Object.getPrototypeOf(this.state.base);\n\t},\n\thas(this: DraftHandler, _target, property): boolean {\n\t\treturn Reflect.has(currentValue(this.state), property);\n\t},\n\tisExtensible(this: DraftHandler): boolean {\n\t\tassertActive(this.state.context);\n\t\treturn true;\n\t},\n\townKeys(this: DraftHandler): ArrayLike<string | symbol> {\n\t\treturn Reflect.ownKeys(currentValue(this.state));\n\t},\n\tpreventExtensions(this: DraftHandler): never {\n\t\tassertActive(this.state.context);\n\t\tthrow new TypeError(\"Drafts cannot be made non-extensible\");\n\t},\n\tset(this: DraftHandler, _target, property, value): boolean {\n\t\tconst state = this.state;\n\t\tassertStringWrite(property);\n\t\tconst current = currentValue(state);\n\t\tlet stored: unknown;\n\t\tif (isContainer(value)) {\n\t\t\tstored = cloneAssigned(value, state.context, new Set<object>());\n\t\t} else {\n\t\t\tassertJsonPrimitive(value);\n\t\t\tstored = value;\n\t\t}\n\t\tif (Object.hasOwn(current, property) && Object.is(Reflect.get(current, property), stored)) return true;\n\t\tconst copy = ensureCopy(state);\n\t\tif (Array.isArray(copy) && property === \"length\") {\n\t\t\tconst written = Reflect.set(copy, property, stored);\n\t\t\tsyncArrayTarget(state);\n\t\t\treturn written;\n\t\t}\n\t\tObject.defineProperty(copy, property, {\n\t\t\tvalue: stored,\n\t\t\twritable: true,\n\t\t\tenumerable: true,\n\t\t\tconfigurable: true,\n\t\t});\n\t\tsyncArrayTarget(state);\n\t\treturn true;\n\t},\n\tsetPrototypeOf(this: DraftHandler): never {\n\t\tassertActive(this.state.context);\n\t\tthrow new TypeError(\"Changing a draft prototype is not supported\");\n\t},\n};\n\nfunction createHandler(state: DraftState): ProxyHandler<object> {\n\tconst handler = Object.create(handlerPrototype) as DraftHandler;\n\thandler.state = state;\n\treturn handler;\n}\n\nfunction arrayMutator(state: DraftState, property: string, value: unknown): unknown {\n\tassertActive(state.context);\n\tconst cached = state.methods?.get(property);\n\tif (cached !== undefined) return cached;\n\tif (typeof value !== \"function\") return draftValue(state.context, value);\n\tconst wrapped = function (this: unknown, ...args: unknown[]): unknown {\n\t\tassertActive(state.context);\n\t\tconst receiver = isContainer(this) ? state.context.proxies.get(this) : undefined;\n\t\tif (receiver === undefined) return Reflect.apply(value, this, args);\n\t\tconst target = ensureCopy(receiver);\n\t\tif (!Array.isArray(target)) throw new TypeError(\"Array mutator receiver is not an array draft\");\n\t\ttry {\n\t\t\treturn mutateArray(receiver, target, property, args);\n\t\t} finally {\n\t\t\tsyncArrayTarget(receiver);\n\t\t}\n\t};\n\tif (state.methods === undefined) state.methods = new Map();\n\tstate.methods.set(property, wrapped);\n\treturn wrapped;\n}\n\nfunction mutateArray(state: DraftState, target: unknown[], property: string, args: unknown[]): unknown {\n\tconst { context } = state;\n\tswitch (property) {\n\t\tcase \"push\": {\n\t\t\tconst items = cloneArrayItems(args, context);\n\t\t\tfor (const item of items) defineArrayValue(target, target.length, item);\n\t\t\treturn target.length;\n\t\t}\n\t\tcase \"pop\": {\n\t\t\tif (target.length === 0) return undefined;\n\t\t\tconst index = target.length - 1;\n\t\t\tconst removed = target[index];\n\t\t\tReflect.deleteProperty(target, String(index));\n\t\t\ttarget.length = index;\n\t\t\treturn draftValue(context, removed);\n\t\t}\n\t\tcase \"shift\":\n\t\t\treturn draftValue(context, Reflect.apply(Array.prototype.shift, target, []));\n\t\tcase \"unshift\": {\n\t\t\tconst items = cloneArrayItems(args, context);\n\t\t\tif (hasInheritedGrowthIndex(target, target.length + items.length)) {\n\t\t\t\tspliceArray(target, items, 0, 0, context);\n\t\t\t\treturn target.length;\n\t\t\t}\n\t\t\treturn Reflect.apply(Array.prototype.unshift, target, items);\n\t\t}\n\t\tcase \"splice\": {\n\t\t\tconst length = target.length;\n\t\t\tconst start = args.length === 0 ? 0 : clampArrayIndex(toIntegerOrInfinity(args[0]), length);\n\t\t\tconst remove =\n\t\t\t\targs.length === 0\n\t\t\t\t\t? 0\n\t\t\t\t\t: args.length === 1\n\t\t\t\t\t\t? length - start\n\t\t\t\t\t\t: Math.min(Math.max(toIntegerOrInfinity(args[1]), 0), length - start);\n\t\t\tconst items = cloneArrayItems(args.slice(2), context);\n\t\t\tif (\n\t\t\t\t!mayRunCoercionCode(args[0]) &&\n\t\t\t\t!mayRunCoercionCode(args[1]) &&\n\t\t\t\t!hasInheritedGrowthIndex(target, length - remove + items.length)\n\t\t\t) {\n\t\t\t\tconst removed = Reflect.apply(Array.prototype.splice, target, [start, remove, ...items]) as unknown[];\n\t\t\t\treturn removed.map((item) => draftValue(context, item));\n\t\t\t}\n\t\t\treturn spliceArray(target, items, start, remove, context, length);\n\t\t}\n\t\tcase \"sort\": {\n\t\t\tconst comparator = args[0];\n\t\t\tif (comparator !== undefined && typeof comparator !== \"function\") {\n\t\t\t\tReflect.apply(Array.prototype.sort, target, args);\n\t\t\t} else {\n\t\t\t\tReflect.apply(Array.prototype.sort, target, [\n\t\t\t\t\t(left: unknown, right: unknown): number => {\n\t\t\t\t\t\tconst draftedLeft = draftValue(context, left);\n\t\t\t\t\t\tconst draftedRight = draftValue(context, right);\n\t\t\t\t\t\tif (typeof comparator === \"function\") {\n\t\t\t\t\t\t\treturn Reflect.apply(comparator, undefined, [draftedLeft, draftedRight]) as number;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst leftString = String(draftedLeft);\n\t\t\t\t\t\tconst rightString = String(draftedRight);\n\t\t\t\t\t\treturn leftString < rightString ? -1 : leftString > rightString ? 1 : 0;\n\t\t\t\t\t},\n\t\t\t\t]);\n\t\t\t}\n\t\t\treturn state.proxy;\n\t\t}\n\t\tcase \"reverse\":\n\t\t\tReflect.apply(Array.prototype.reverse, target, []);\n\t\t\treturn state.proxy;\n\t\tcase \"fill\": {\n\t\t\tconst length = target.length;\n\t\t\tconst start = args.length > 1 ? clampArrayIndex(toIntegerOrInfinity(args[1]), length) : 0;\n\t\t\tconst end =\n\t\t\t\targs.length > 2 && args[2] !== undefined ? clampArrayIndex(toIntegerOrInfinity(args[2]), length) : length;\n\t\t\tif (end <= start) return state.proxy;\n\t\t\tconst supplied = args[0];\n\t\t\tfor (let index = start; index < end; index++) {\n\t\t\t\tconst item = isContainer(supplied)\n\t\t\t\t\t? cloneAssigned(supplied, context, new Set<object>())\n\t\t\t\t\t: assertJsonPrimitive(supplied);\n\t\t\t\tdefineArrayValue(target, index, item);\n\t\t\t}\n\t\t\treturn state.proxy;\n\t\t}\n\t\tcase \"copyWithin\": {\n\t\t\tconst length = target.length;\n\t\t\tconst to = clampArrayIndex(toIntegerOrInfinity(args[0]), length);\n\t\t\tconst from = clampArrayIndex(toIntegerOrInfinity(args[1]), length);\n\t\t\tconst end =\n\t\t\t\targs.length > 2 && args[2] !== undefined ? clampArrayIndex(toIntegerOrInfinity(args[2]), length) : length;\n\t\t\tconst count = Math.min(Math.max(end - from, 0), length - to);\n\t\t\tconst source = target.slice(from, from + count);\n\t\t\tfor (let offset = 0; offset < count; offset++) {\n\t\t\t\tconst item = source[offset];\n\t\t\t\tconst itemState = isContainer(item) ? context.states.get(item) : undefined;\n\t\t\t\tconst current = (itemState?.proxy as Container | undefined) ?? item;\n\t\t\t\tconst copy = isContainer(current)\n\t\t\t\t\t? cloneAssigned(current, context, new Set<object>())\n\t\t\t\t\t: assertJsonPrimitive(current);\n\t\t\t\tdefineArrayValue(target, to + offset, copy);\n\t\t\t}\n\t\t\treturn state.proxy;\n\t\t}\n\t}\n\tthrow new TypeError(`Unsupported array mutator: ${property}`);\n}\n\nfunction cloneArrayItems(items: readonly unknown[], context: DraftContext): unknown[] {\n\treturn items.map((item) => {\n\t\tif (isContainer(item)) return cloneAssigned(item, context, new Set<object>());\n\t\tassertJsonPrimitive(item);\n\t\treturn item;\n\t});\n}\n\nfunction hasInheritedGrowthIndex(target: unknown[], nextLength: number): boolean {\n\tfor (let index = target.length; index < nextLength; index++) {\n\t\tif (index in target) return true;\n\t}\n\treturn false;\n}\n\nfunction mayRunCoercionCode(value: unknown): boolean {\n\treturn (typeof value === \"object\" && value !== null) || typeof value === \"function\";\n}\n\nfunction spliceArray(\n\ttarget: unknown[],\n\titems: readonly unknown[],\n\tindex: number,\n\tremove: number,\n\tcontext: DraftContext,\n\tlength = target.length,\n): unknown[] {\n\tconst removed = new Array<unknown>(remove);\n\tfor (let offset = 0; offset < remove; offset++) {\n\t\tconst source = index + offset;\n\t\tif (!(source in target)) continue;\n\t\tdefineArrayValue(removed, offset, draftValue(context, target[source]));\n\t}\n\tif (items.length < remove) {\n\t\tfor (let source = index + remove; source < length; source++) {\n\t\t\tdefineArrayValue(target, source - remove + items.length, target[source]);\n\t\t}\n\t} else if (items.length > remove) {\n\t\tfor (let source = length - 1; source >= index + remove; source--) {\n\t\t\tdefineArrayValue(target, source - remove + items.length, target[source]);\n\t\t}\n\t}\n\tfor (let offset = 0; offset < items.length; offset++) defineArrayValue(target, index + offset, items[offset]);\n\ttarget.length = length - remove + items.length;\n\treturn removed;\n}\n\nfunction defineArrayValue(target: unknown[], index: number, value: unknown): void {\n\tObject.defineProperty(target, index, {\n\t\tvalue,\n\t\twritable: true,\n\t\tenumerable: true,\n\t\tconfigurable: true,\n\t});\n}\n\nfunction toIntegerOrInfinity(value: unknown): number {\n\tconst number = +(value as unknown as number);\n\tif (Number.isNaN(number) || number === 0) return 0;\n\treturn Number.isFinite(number) ? Math.trunc(number) : number;\n}\n\nfunction clampArrayIndex(value: number, length: number): number {\n\tif (value === Number.NEGATIVE_INFINITY) return 0;\n\tif (value < 0) return Math.max(length + value, 0);\n\treturn Math.min(value, length);\n}\n\nfunction currentValue(state: DraftState): Container {\n\tassertActive(state.context);\n\treturn state.copy ?? state.base;\n}\n\nfunction ensureCopy(state: DraftState): Container {\n\tif (state.copy !== undefined) return state.copy;\n\tif (state.context.owned.has(state.base)) {\n\t\tstate.copy = state.base;\n\t} else {\n\t\tstate.copy = shallowOwnedCopy(state.base, state.context);\n\t}\n\treturn state.copy;\n}\n\nfunction shallowOwnedCopy(value: Container, context: DraftContext): Container {\n\tif (Array.isArray(value)) {\n\t\tconst copy = value.slice();\n\t\tcontext.owned.add(copy);\n\t\treturn copy;\n\t}\n\tconst copy = Object.create(Object.getPrototypeOf(value)) as Record<string, unknown>;\n\tfor (const key of Object.keys(value)) {\n\t\tObject.defineProperty(copy, key, {\n\t\t\tvalue: value[key],\n\t\t\twritable: true,\n\t\t\tenumerable: true,\n\t\t\tconfigurable: true,\n\t\t});\n\t}\n\tcontext.owned.add(copy);\n\treturn copy;\n}\n\nfunction cloneAssigned(value: Container, context: DraftContext, ancestors: Set<object>): Container {\n\tif (ancestors.has(value)) throw new TypeError(\"Assigned JSON values cannot contain cycles\");\n\tancestors.add(value);\n\ttry {\n\t\tif (Array.isArray(value)) {\n\t\t\tassertDenseArray(value);\n\t\t\tconst clone: unknown[] = [];\n\t\t\tcontext.owned.add(clone);\n\t\t\tfor (let index = 0; index < value.length; index++) {\n\t\t\t\tclone.push(cloneAssignedValue(Reflect.get(value, String(index)), context, ancestors));\n\t\t\t}\n\t\t\treturn clone;\n\t\t}\n\n\t\tconst prototype = Object.getPrototypeOf(value);\n\t\tif (prototype !== Object.prototype && prototype !== null) {\n\t\t\tthrow new TypeError(\"Assigned JSON containers must be plain objects or arrays\");\n\t\t}\n\t\tconst clone = Object.create(prototype) as Record<string, unknown>;\n\t\tcontext.owned.add(clone);\n\t\tfor (const key of Reflect.ownKeys(value)) {\n\t\t\tif (typeof key === \"symbol\") throw new TypeError(\"Assigned JSON objects cannot have symbol properties\");\n\t\t\tconst descriptor = Reflect.getOwnPropertyDescriptor(value, key);\n\t\t\tif (descriptor === undefined || !descriptor.enumerable || !(\"value\" in descriptor)) {\n\t\t\t\tthrow new TypeError(\"Assigned JSON objects must contain enumerable data properties\");\n\t\t\t}\n\t\t\tObject.defineProperty(clone, key, {\n\t\t\t\tvalue: cloneAssignedValue(descriptor.value, context, ancestors),\n\t\t\t\twritable: true,\n\t\t\t\tenumerable: true,\n\t\t\t\tconfigurable: true,\n\t\t\t});\n\t\t}\n\t\treturn clone;\n\t} finally {\n\t\tancestors.delete(value);\n\t}\n}\n\nfunction cloneAssignedValue(value: unknown, context: DraftContext, ancestors: Set<object>): unknown {\n\tif (isContainer(value)) return cloneAssigned(value, context, ancestors);\n\tassertJsonPrimitive(value);\n\treturn value;\n}\n\nfunction assertJsonPrimitive(value: unknown): null | boolean | number | string {\n\tif (value === undefined) throw new TypeError(\"Assigned values cannot be undefined\");\n\tif (\n\t\tvalue !== null &&\n\t\ttypeof value !== \"string\" &&\n\t\ttypeof value !== \"boolean\" &&\n\t\t!(typeof value === \"number\" && Number.isFinite(value))\n\t) {\n\t\tthrow new TypeError(\"Assigned values must be strict JSON values\");\n\t}\n\treturn value;\n}\n\nfunction draftValue(context: DraftContext, value: unknown): unknown {\n\tif (!isContainer(value)) return value;\n\treturn getState(context, value).proxy;\n}\n\nfunction isContainer(value: unknown): value is Container {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n\treturn (\n\t\t((typeof value === \"object\" && value !== null) || typeof value === \"function\") &&\n\t\ttypeof (value as { then?: unknown }).then === \"function\"\n\t);\n}\n\nfunction assertActive(context: DraftContext): void {\n\tif (!context.active) throw new TypeError(\"Cannot use a draft outside its change callback\");\n}\n\nfunction assertStringWrite(property: string | symbol): asserts property is string {\n\tif (typeof property === \"symbol\") throw new TypeError(\"Symbol writes are not supported\");\n}\n\nfunction syncArrayTarget(state: DraftState): void {\n\tconst current = currentValue(state);\n\tif (Array.isArray(current)) Reflect.set(state.target!, \"length\", current.length);\n}\n\nfunction finalize(\n\tstate: DraftState,\n\tfinalizing: Set<DraftState>,\n\tfinalized: WeakMap<DraftState, Container>,\n): Container {\n\tconst cached = finalized.get(state);\n\tif (cached !== undefined) return cached;\n\tif (finalizing.has(state)) throw new TypeError(\"Cyclic draft state is not supported\");\n\tfinalizing.add(state);\n\ttry {\n\t\tif (state.copy !== undefined && shallowEqual(state.base, state.copy)) state.copy = undefined;\n\t\tconst current = currentValue(state);\n\t\tlet result = current;\n\t\tfor (const key of Object.keys(current)) {\n\t\t\tconst value = Reflect.get(current, key);\n\t\t\tif (!isContainer(value)) continue;\n\t\t\tconst child = state.context.states.get(value);\n\t\t\tif (child === undefined) continue;\n\t\t\tconst finalizedChild = finalize(child, finalizing, finalized);\n\t\t\tif (finalizedChild === value) continue;\n\t\t\tif (result === state.base) result = shallowOwnedCopy(state.base, state.context);\n\t\t\tObject.defineProperty(result, key, {\n\t\t\t\tvalue: finalizedChild,\n\t\t\t\twritable: true,\n\t\t\t\tenumerable: true,\n\t\t\t\tconfigurable: true,\n\t\t\t});\n\t\t}\n\t\tif (state.copy !== undefined && Array.isArray(result)) assertDenseArray(result);\n\t\tfinalized.set(state, result);\n\t\treturn result;\n\t} finally {\n\t\tfinalizing.delete(state);\n\t}\n}\n\nfunction shallowEqual(left: Container, right: Container): boolean {\n\tif (Array.isArray(left) !== Array.isArray(right)) return false;\n\tif (Array.isArray(left) && Array.isArray(right) && left.length !== right.length) return false;\n\tconst leftKeys = Object.keys(left);\n\tconst rightKeys = Object.keys(right);\n\tif (leftKeys.length !== rightKeys.length) return false;\n\tconst leftRecord = left as Record<string, unknown>;\n\tconst rightRecord = right as Record<string, unknown>;\n\tfor (const key of leftKeys) {\n\t\tif (!Object.hasOwn(right, key) || !Object.is(leftRecord[key], rightRecord[key])) return false;\n\t}\n\treturn true;\n}\n\nfunction assertDenseArray(value: unknown[]): void {\n\tconst keys = Reflect.ownKeys(value);\n\tif (keys.length !== value.length + 1 || keys.some((key) => typeof key !== \"string\")) {\n\t\tthrow new TypeError(\"Draft arrays must be dense and contain only indexed entries\");\n\t}\n\tfor (let index = 0; index < value.length; index++) {\n\t\tif (!Object.hasOwn(value, index) || value[index] === undefined) {\n\t\t\tthrow new TypeError(\"Draft arrays cannot contain holes or undefined entries\");\n\t\t}\n\t}\n}\n"]}

package/dist/state/draft.js

@@ -0,0 +1,540 @@
+const RELEASED_BASE = Object.freeze({});
+const ARRAY_MUTATORS = new Set(["push", "pop", "shift", "unshift", "splice", "sort", "reverse", "fill", "copyWithin"]);
+/** Run a mutation recipe and return its value with transaction ownership metadata. */
+export function produceWithMetadata(base, recipe) {
+    const context = {
+        active: true,
+        created: [],
+        owned: new WeakSet(),
+        proxies: new WeakMap(),
+        states: new WeakMap(),
+    };
+    const root = getState(context, base);
+    try {
+        const outcome = recipe(root.proxy);
+        if (isPromiseLike(outcome)) {
+            void Promise.resolve(outcome).catch(() => undefined);
+            throw new TypeError("Replicated state change callbacks must be synchronous");
+        }
+        return {
+            value: finalize(root, new Set(), new WeakMap()),
+            owned: context.owned,
+        };
+    }
+    finally {
+        context.active = false;
+        for (const state of context.created) {
+            state.base = RELEASED_BASE;
+            state.copy = undefined;
+            state.methods = undefined;
+            state.proxy = RELEASED_BASE;
+            state.target = undefined;
+        }
+        context.created.length = 0;
+        context.proxies = new WeakMap();
+        context.states = new WeakMap();
+    }
+}
+/** Run a mutation recipe against a copy-on-write draft of `base`. */
+export function produce(base, recipe) {
+    return produceWithMetadata(base, recipe).value;
+}
+function getState(context, base) {
+    const existing = context.states.get(base);
+    if (existing !== undefined)
+        return existing;
+    const target = Array.isArray(base) ? [] : undefined;
+    if (target !== undefined)
+        Reflect.set(target, "length", base.length);
+    const state = {
+        base,
+        context,
+        copy: undefined,
+        methods: undefined,
+        proxy: target ?? {},
+        target,
+    };
+    state.proxy = new Proxy(target ?? state, createHandler(state));
+    context.states.set(base, state);
+    context.proxies.set(state.proxy, state);
+    context.created.push(state);
+    return state;
+}
+const handlerPrototype = {
+    deleteProperty(_target, property) {
+        const state = this.state;
+        assertStringWrite(property);
+        const current = currentValue(state);
+        if (Array.isArray(current))
+            throw new TypeError("Draft arrays cannot contain holes");
+        if (!Object.hasOwn(current, property))
+            return true;
+        const deleted = Reflect.deleteProperty(ensureCopy(state), property);
+        syncArrayTarget(state);
+        return deleted;
+    },
+    defineProperty() {
+        assertActive(this.state.context);
+        throw new TypeError("Defining draft properties is not supported");
+    },
+    get(_target, property) {
+        const state = this.state;
+        const current = currentValue(state);
+        const value = Reflect.get(current, property, state.proxy);
+        if (Array.isArray(current) && typeof property === "string" && ARRAY_MUTATORS.has(property)) {
+            return arrayMutator(state, property, value);
+        }
+        return draftValue(state.context, value);
+    },
+    getOwnPropertyDescriptor(_target, property) {
+        const state = this.state;
+        const current = currentValue(state);
+        const descriptor = Reflect.getOwnPropertyDescriptor(current, property);
+        if (descriptor === undefined)
+            return undefined;
+        if (Array.isArray(current) && property === "length") {
+            syncArrayTarget(state);
+            return Reflect.getOwnPropertyDescriptor(state.target, property);
+        }
+        return {
+            configurable: true,
+            enumerable: descriptor.enumerable,
+            value: "value" in descriptor ? draftValue(state.context, descriptor.value) : undefined,
+            writable: true,
+        };
+    },
+    getPrototypeOf() {
+        assertActive(this.state.context);
+        return Object.getPrototypeOf(this.state.base);
+    },
+    has(_target, property) {
+        return Reflect.has(currentValue(this.state), property);
+    },
+    isExtensible() {
+        assertActive(this.state.context);
+        return true;
+    },
+    ownKeys() {
+        return Reflect.ownKeys(currentValue(this.state));
+    },
+    preventExtensions() {
+        assertActive(this.state.context);
+        throw new TypeError("Drafts cannot be made non-extensible");
+    },
+    set(_target, property, value) {
+        const state = this.state;
+        assertStringWrite(property);
+        const current = currentValue(state);
+        let stored;
+        if (isContainer(value)) {
+            stored = cloneAssigned(value, state.context, new Set());
+        }
+        else {
+            assertJsonPrimitive(value);
+            stored = value;
+        }
+        if (Object.hasOwn(current, property) && Object.is(Reflect.get(current, property), stored))
+            return true;
+        const copy = ensureCopy(state);
+        if (Array.isArray(copy) && property === "length") {
+            const written = Reflect.set(copy, property, stored);
+            syncArrayTarget(state);
+            return written;
+        }
+        Object.defineProperty(copy, property, {
+            value: stored,
+            writable: true,
+            enumerable: true,
+            configurable: true,
+        });
+        syncArrayTarget(state);
+        return true;
+    },
+    setPrototypeOf() {
+        assertActive(this.state.context);
+        throw new TypeError("Changing a draft prototype is not supported");
+    },
+};
+function createHandler(state) {
+    const handler = Object.create(handlerPrototype);
+    handler.state = state;
+    return handler;
+}
+function arrayMutator(state, property, value) {
+    assertActive(state.context);
+    const cached = state.methods?.get(property);
+    if (cached !== undefined)
+        return cached;
+    if (typeof value !== "function")
+        return draftValue(state.context, value);
+    const wrapped = function (...args) {
+        assertActive(state.context);
+        const receiver = isContainer(this) ? state.context.proxies.get(this) : undefined;
+        if (receiver === undefined)
+            return Reflect.apply(value, this, args);
+        const target = ensureCopy(receiver);
+        if (!Array.isArray(target))
+            throw new TypeError("Array mutator receiver is not an array draft");
+        try {
+            return mutateArray(receiver, target, property, args);
+        }
+        finally {
+            syncArrayTarget(receiver);
+        }
+    };
+    if (state.methods === undefined)
+        state.methods = new Map();
+    state.methods.set(property, wrapped);
+    return wrapped;
+}
+function mutateArray(state, target, property, args) {
+    const { context } = state;
+    switch (property) {
+        case "push": {
+            const items = cloneArrayItems(args, context);
+            for (const item of items)
+                defineArrayValue(target, target.length, item);
+            return target.length;
+        }
+        case "pop": {
+            if (target.length === 0)
+                return undefined;
+            const index = target.length - 1;
+            const removed = target[index];
+            Reflect.deleteProperty(target, String(index));
+            target.length = index;
+            return draftValue(context, removed);
+        }
+        case "shift":
+            return draftValue(context, Reflect.apply(Array.prototype.shift, target, []));
+        case "unshift": {
+            const items = cloneArrayItems(args, context);
+            if (hasInheritedGrowthIndex(target, target.length + items.length)) {
+                spliceArray(target, items, 0, 0, context);
+                return target.length;
+            }
+            return Reflect.apply(Array.prototype.unshift, target, items);
+        }
+        case "splice": {
+            const length = target.length;
+            const start = args.length === 0 ? 0 : clampArrayIndex(toIntegerOrInfinity(args[0]), length);
+            const remove = args.length === 0
+                ? 0
+                : args.length === 1
+                    ? length - start
+                    : Math.min(Math.max(toIntegerOrInfinity(args[1]), 0), length - start);
+            const items = cloneArrayItems(args.slice(2), context);
+            if (!mayRunCoercionCode(args[0]) &&
+                !mayRunCoercionCode(args[1]) &&
+                !hasInheritedGrowthIndex(target, length - remove + items.length)) {
+                const removed = Reflect.apply(Array.prototype.splice, target, [start, remove, ...items]);
+                return removed.map((item) => draftValue(context, item));
+            }
+            return spliceArray(target, items, start, remove, context, length);
+        }
+        case "sort": {
+            const comparator = args[0];
+            if (comparator !== undefined && typeof comparator !== "function") {
+                Reflect.apply(Array.prototype.sort, target, args);
+            }
+            else {
+                Reflect.apply(Array.prototype.sort, target, [
+                    (left, right) => {
+                        const draftedLeft = draftValue(context, left);
+                        const draftedRight = draftValue(context, right);
+                        if (typeof comparator === "function") {
+                            return Reflect.apply(comparator, undefined, [draftedLeft, draftedRight]);
+                        }
+                        const leftString = String(draftedLeft);
+                        const rightString = String(draftedRight);
+                        return leftString < rightString ? -1 : leftString > rightString ? 1 : 0;
+                    },
+                ]);
+            }
+            return state.proxy;
+        }
+        case "reverse":
+            Reflect.apply(Array.prototype.reverse, target, []);
+            return state.proxy;
+        case "fill": {
+            const length = target.length;
+            const start = args.length > 1 ? clampArrayIndex(toIntegerOrInfinity(args[1]), length) : 0;
+            const end = args.length > 2 && args[2] !== undefined ? clampArrayIndex(toIntegerOrInfinity(args[2]), length) : length;
+            if (end <= start)
+                return state.proxy;
+            const supplied = args[0];
+            for (let index = start; index < end; index++) {
+                const item = isContainer(supplied)
+                    ? cloneAssigned(supplied, context, new Set())
+                    : assertJsonPrimitive(supplied);
+                defineArrayValue(target, index, item);
+            }
+            return state.proxy;
+        }
+        case "copyWithin": {
+            const length = target.length;
+            const to = clampArrayIndex(toIntegerOrInfinity(args[0]), length);
+            const from = clampArrayIndex(toIntegerOrInfinity(args[1]), length);
+            const end = args.length > 2 && args[2] !== undefined ? clampArrayIndex(toIntegerOrInfinity(args[2]), length) : length;
+            const count = Math.min(Math.max(end - from, 0), length - to);
+            const source = target.slice(from, from + count);
+            for (let offset = 0; offset < count; offset++) {
+                const item = source[offset];
+                const itemState = isContainer(item) ? context.states.get(item) : undefined;
+                const current = itemState?.proxy ?? item;
+                const copy = isContainer(current)
+                    ? cloneAssigned(current, context, new Set())
+                    : assertJsonPrimitive(current);
+                defineArrayValue(target, to + offset, copy);
+            }
+            return state.proxy;
+        }
+    }
+    throw new TypeError(`Unsupported array mutator: ${property}`);
+}
+function cloneArrayItems(items, context) {
+    return items.map((item) => {
+        if (isContainer(item))
+            return cloneAssigned(item, context, new Set());
+        assertJsonPrimitive(item);
+        return item;
+    });
+}
+function hasInheritedGrowthIndex(target, nextLength) {
+    for (let index = target.length; index < nextLength; index++) {
+        if (index in target)
+            return true;
+    }
+    return false;
+}
+function mayRunCoercionCode(value) {
+    return (typeof value === "object" && value !== null) || typeof value === "function";
+}
+function spliceArray(target, items, index, remove, context, length = target.length) {
+    const removed = new Array(remove);
+    for (let offset = 0; offset < remove; offset++) {
+        const source = index + offset;
+        if (!(source in target))
+            continue;
+        defineArrayValue(removed, offset, draftValue(context, target[source]));
+    }
+    if (items.length < remove) {
+        for (let source = index + remove; source < length; source++) {
+            defineArrayValue(target, source - remove + items.length, target[source]);
+        }
+    }
+    else if (items.length > remove) {
+        for (let source = length - 1; source >= index + remove; source--) {
+            defineArrayValue(target, source - remove + items.length, target[source]);
+        }
+    }
+    for (let offset = 0; offset < items.length; offset++)
+        defineArrayValue(target, index + offset, items[offset]);
+    target.length = length - remove + items.length;
+    return removed;
+}
+function defineArrayValue(target, index, value) {
+    Object.defineProperty(target, index, {
+        value,
+        writable: true,
+        enumerable: true,
+        configurable: true,
+    });
+}
+function toIntegerOrInfinity(value) {
+    const number = +value;
+    if (Number.isNaN(number) || number === 0)
+        return 0;
+    return Number.isFinite(number) ? Math.trunc(number) : number;
+}
+function clampArrayIndex(value, length) {
+    if (value === Number.NEGATIVE_INFINITY)
+        return 0;
+    if (value < 0)
+        return Math.max(length + value, 0);
+    return Math.min(value, length);
+}
+function currentValue(state) {
+    assertActive(state.context);
+    return state.copy ?? state.base;
+}
+function ensureCopy(state) {
+    if (state.copy !== undefined)
+        return state.copy;
+    if (state.context.owned.has(state.base)) {
+        state.copy = state.base;
+    }
+    else {
+        state.copy = shallowOwnedCopy(state.base, state.context);
+    }
+    return state.copy;
+}
+function shallowOwnedCopy(value, context) {
+    if (Array.isArray(value)) {
+        const copy = value.slice();
+        context.owned.add(copy);
+        return copy;
+    }
+    const copy = Object.create(Object.getPrototypeOf(value));
+    for (const key of Object.keys(value)) {
+        Object.defineProperty(copy, key, {
+            value: value[key],
+            writable: true,
+            enumerable: true,
+            configurable: true,
+        });
+    }
+    context.owned.add(copy);
+    return copy;
+}
+function cloneAssigned(value, context, ancestors) {
+    if (ancestors.has(value))
+        throw new TypeError("Assigned JSON values cannot contain cycles");
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            assertDenseArray(value);
+            const clone = [];
+            context.owned.add(clone);
+            for (let index = 0; index < value.length; index++) {
+                clone.push(cloneAssignedValue(Reflect.get(value, String(index)), context, ancestors));
+            }
+            return clone;
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError("Assigned JSON containers must be plain objects or arrays");
+        }
+        const clone = Object.create(prototype);
+        context.owned.add(clone);
+        for (const key of Reflect.ownKeys(value)) {
+            if (typeof key === "symbol")
+                throw new TypeError("Assigned JSON objects cannot have symbol properties");
+            const descriptor = Reflect.getOwnPropertyDescriptor(value, key);
+            if (descriptor === undefined || !descriptor.enumerable || !("value" in descriptor)) {
+                throw new TypeError("Assigned JSON objects must contain enumerable data properties");
+            }
+            Object.defineProperty(clone, key, {
+                value: cloneAssignedValue(descriptor.value, context, ancestors),
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        return clone;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function cloneAssignedValue(value, context, ancestors) {
+    if (isContainer(value))
+        return cloneAssigned(value, context, ancestors);
+    assertJsonPrimitive(value);
+    return value;
+}
+function assertJsonPrimitive(value) {
+    if (value === undefined)
+        throw new TypeError("Assigned values cannot be undefined");
+    if (value !== null &&
+        typeof value !== "string" &&
+        typeof value !== "boolean" &&
+        !(typeof value === "number" && Number.isFinite(value))) {
+        throw new TypeError("Assigned values must be strict JSON values");
+    }
+    return value;
+}
+function draftValue(context, value) {
+    if (!isContainer(value))
+        return value;
+    return getState(context, value).proxy;
+}
+function isContainer(value) {
+    return typeof value === "object" && value !== null;
+}
+function isPromiseLike(value) {
+    return (((typeof value === "object" && value !== null) || typeof value === "function") &&
+        typeof value.then === "function");
+}
+function assertActive(context) {
+    if (!context.active)
+        throw new TypeError("Cannot use a draft outside its change callback");
+}
+function assertStringWrite(property) {
+    if (typeof property === "symbol")
+        throw new TypeError("Symbol writes are not supported");
+}
+function syncArrayTarget(state) {
+    const current = currentValue(state);
+    if (Array.isArray(current))
+        Reflect.set(state.target, "length", current.length);
+}
+function finalize(state, finalizing, finalized) {
+    const cached = finalized.get(state);
+    if (cached !== undefined)
+        return cached;
+    if (finalizing.has(state))
+        throw new TypeError("Cyclic draft state is not supported");
+    finalizing.add(state);
+    try {
+        if (state.copy !== undefined && shallowEqual(state.base, state.copy))
+            state.copy = undefined;
+        const current = currentValue(state);
+        let result = current;
+        for (const key of Object.keys(current)) {
+            const value = Reflect.get(current, key);
+            if (!isContainer(value))
+                continue;
+            const child = state.context.states.get(value);
+            if (child === undefined)
+                continue;
+            const finalizedChild = finalize(child, finalizing, finalized);
+            if (finalizedChild === value)
+                continue;
+            if (result === state.base)
+                result = shallowOwnedCopy(state.base, state.context);
+            Object.defineProperty(result, key, {
+                value: finalizedChild,
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        if (state.copy !== undefined && Array.isArray(result))
+            assertDenseArray(result);
+        finalized.set(state, result);
+        return result;
+    }
+    finally {
+        finalizing.delete(state);
+    }
+}
+function shallowEqual(left, right) {
+    if (Array.isArray(left) !== Array.isArray(right))
+        return false;
+    if (Array.isArray(left) && Array.isArray(right) && left.length !== right.length)
+        return false;
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    if (leftKeys.length !== rightKeys.length)
+        return false;
+    const leftRecord = left;
+    const rightRecord = right;
+    for (const key of leftKeys) {
+        if (!Object.hasOwn(right, key) || !Object.is(leftRecord[key], rightRecord[key]))
+            return false;
+    }
+    return true;
+}
+function assertDenseArray(value) {
+    const keys = Reflect.ownKeys(value);
+    if (keys.length !== value.length + 1 || keys.some((key) => typeof key !== "string")) {
+        throw new TypeError("Draft arrays must be dense and contain only indexed entries");
+    }
+    for (let index = 0; index < value.length; index++) {
+        if (!Object.hasOwn(value, index) || value[index] === undefined) {
+            throw new TypeError("Draft arrays cannot contain holes or undefined entries");
+        }
+    }
+}
+//# sourceMappingURL=draft.js.map