mutts 1.0.9 → 1.0.11

package/src/reactive/buffer.ts

@@ -1,328 +0,0 @@
-import { FoolProof } from '../utils'
-import { cleanedBy } from '.'
-import { effect, untracked } from './effects'
-import { memoize } from './memoize'
-import { reactive } from './proxy'
-import type { cleanup, EffectAccess, EffectCleanup, EffectCloser, ScopedCallback } from './types'
-
-/**
- * Reactively attends to each entry of a collection or each key yielded by an
- * enumeration callback. For each key, an inner effect runs the callback. When a
- * key disappears, its inner effect is disposed. The callback may return a cleanup
- * (like a regular effect closer).
- *
- * Accepts arrays, records, Maps, Sets, or a raw `() => Iterable<Key>` callback.
- *
- * @example
- * ```typescript
- * // Record shorthand
- * attend(record, (key) => { console.log(key, record[key]) })
- *
- * // Array shorthand
- * attend(array, (index) => { console.log(index, array[index]) })
- *
- * // Raw enumeration callback
- * attend(() => Object.keys(record), (key) => { ... })
- * ```
- */
-export function attend<T>(
-	source: readonly T[],
-	callback: (index: number) => EffectCloser | void
-): ScopedCallback
-export function attend<K, V>(
-	source: Map<K, V>,
-	callback: (key: K) => EffectCloser | void
-): ScopedCallback
-export function attend<T>(
-	source: Set<T>,
-	callback: (value: T) => EffectCloser | void
-): ScopedCallback
-export function attend<S extends Record<PropertyKey, any>>(
-	source: S,
-	callback: (key: keyof S & string) => EffectCloser | void
-): ScopedCallback
-export function attend<Key>(
-	enumerate: () => Iterable<Key>,
-	callback: (key: Key) => EffectCloser | void
-): ScopedCallback
-export function attend(
-	source: any,
-	callback: (key: any) => EffectCloser | void
-): ScopedCallback {
-	const enumerate: () => Iterable<any> =
-		typeof source === 'function'
-			? source
-			: Array.isArray(source)
-				? () => Array.from({ length: source.length }, (_, i) => i)
-				: source instanceof Map
-					? () => source.keys()
-					: source instanceof Set
-						? () => source.values()
-						: () => Object.keys(source)
-
-	const keyEffects = new Map<any, ScopedCallback>()
-
-	const outer = effect(({ ascend }) => {
-		const keys = new Set<any>()
-		for (const key of enumerate()) keys.add(key)
-
-		for (const key of keys) {
-			if (keyEffects.has(key)) continue
-			keyEffects.set(key, ascend(() => effect(() => callback(key))))
-		}
-
-		for (const key of Array.from(keyEffects.keys())) {
-			if (!keys.has(key)) {
-				keyEffects.get(key)!()
-				keyEffects.delete(key)
-			}
-		}
-	})
-
-	return () => {
-		outer()
-		for (const stop of keyEffects.values()) stop()
-		keyEffects.clear()
-	}
-}
-
-/**
- * Result of a reactive scan, which is a reactive array of accumulated values
- * with an attached cleanup function.
- */
-export type ScanResult<Output> = readonly Output[] & { [cleanup]: ScopedCallback }
-
-/**
- * Perform a reactive scan over an array of items.
- *
- * This implementation is highly optimized for performance and fine-grained reactivity:
- * - **Incremental Updates**: Changes to an item only trigger re-computation from that
- *   point onwards in the result chain.
- * - **Move Optimization**: If items are moved within the array, their accumulated
- *   values are reused as long as their predecessor remains the same.
- * - **Duplicate Support**: Correctly handles multiple occurrences of the same object
- *   instance using an internal occurrence tracking mechanism.
- * - **Memory Efficient**: Uses `WeakMap` for caching intermediates, which are
- *   automatically cleared when source items are garbage collected.
- *
- * @example
- * ```typescript
- * const source = reactive([{ val: 1 }, { val: 2 }, { val: 3 }])
- * const sum = scan(source, (acc, item) => acc + item.val, 0)
- *
- * expect([...sum]).toEqual([1, 3, 6])
- *
- * // Modifying an item only re-computes subsequent sums
- * source[1].val = 10
- * expect([...sum]).toEqual([1, 11, 14])
- * ```
- *
- * @param source The source array of objects (will be made reactive)
- * @param callback The accumulator function called with (accumulator, currentItem)
- * @param initialValue The starting value for the accumulation
- * @returns A reactive array of accumulated values, with a [cleanup] property to stop the tracking
- */
-export function scan<Input extends object, Output>(
-	source: readonly Input[],
-	callback: (acc: Output, val: Input) => Output,
-	initialValue: Output
-): ScanResult<Output> {
-	const observedSource = reactive(source)
-	const result = reactive([] as Output[])
-
-	// Track effects for each index to dispose them when the array shrinks
-	const indexEffects = new Map<number, EffectCleanup>()
-	// Mapping from index to its current intermediate object
-	const indexToIntermediate = reactive([] as Intermediate[])
-	const intermediaries = new WeakMap<Input, Intermediate[]>()
-
-	class Intermediate {
-		public prev: Intermediate | undefined
-		constructor(
-			public val: Input,
-			prev: Intermediate | undefined
-		) {
-			this.prev = prev
-		}
-
-		@memoize
-		get acc(): Output {
-			const prevAcc = this.prev ? this.prev.acc : initialValue
-			return callback(prevAcc, this.val)
-		}
-	}
-
-	function disposeIndex(index: number) {
-		const stop = indexEffects.get(index)
-		if (stop) {
-			stop()
-			indexEffects.delete(index)
-			untracked(() => {
-				Reflect.deleteProperty(indexToIntermediate as any, index)
-				Reflect.deleteProperty(result as any, index)
-			})
-		}
-	}
-
-	const mainEffect = effect(function scanMainEffect({ ascend }) {
-		const length = observedSource.length
-		const occurrenceCount = new Map<Input, number>()
-		let prev: Intermediate | undefined
-
-		for (let i = 0; i < length; i++) {
-			const val = FoolProof.get(observedSource as any, i, observedSource) as Input
-
-			if (
-				!(val && (typeof val === 'object' || typeof val === 'function' || typeof val === 'symbol'))
-			) {
-				throw new Error('scan: items must be objects (WeakKey) for intermediate caching')
-			}
-
-			const count = occurrenceCount.get(val) ?? 0
-			occurrenceCount.set(val, count + 1)
-
-			let list = intermediaries.get(val)
-			if (!list) {
-				list = []
-				intermediaries.set(val, list)
-			}
-
-			let intermediate = list[count]
-			if (!intermediate) {
-				intermediate = reactive(new Intermediate(val, prev))
-				list[count] = intermediate
-			} else {
-				// Update the link.
-				if (untracked(() => intermediate.prev) !== prev) {
-					intermediate.prev = prev
-				}
-			}
-
-			// Update the reactive mapping for this index
-			if (indexToIntermediate[i] !== intermediate) {
-				indexToIntermediate[i] = intermediate
-			}
-
-			// If we don't have an effect for this index yet, create one
-			if (!indexEffects.has(i)) {
-				ascend(() => {
-					const index = i
-					const stop = effect(function scanIndexSyncEffect() {
-						const inter = indexToIntermediate[index]
-						if (inter) {
-							const accValue = inter.acc
-							untracked(() => {
-								result[index] = accValue
-							})
-						}
-					})
-					indexEffects.set(index, stop)
-				})
-			}
-
-			prev = intermediate
-		}
-
-		// Cleanup trailing indices
-		for (const index of Array.from(indexEffects.keys())) {
-			if (index >= length) disposeIndex(index)
-		}
-
-		// Ensure result length matches source length
-		untracked(() => {
-			if (result.length !== length) {
-				FoolProof.set(result as any, 'length', length, result)
-			}
-		})
-	})
-
-	return cleanedBy(result, (() => {
-		mainEffect()
-		for (const stop of indexEffects.values()) stop()
-		indexEffects.clear()
-	}) as EffectCleanup) as ScanResult<Output>
-}
-
-/**
- * Lifts a callback that returns an array into a reactive array that automatically
- * synchronizes with the source array returned by the callback.
- *
- * The returned reactive array will update whenever the callback's dependencies change,
- * efficiently syncing only the elements that differ from the previous result.
- *
- * @example
- * ```typescript
- * const items = reactive([1, 2, 3])
- * const doubled = lift(() => items.map(x => x * 2))
- *
- * console.log([...doubled]) // [2, 4, 6]
- *
- * items.push(4)
- * console.log([...doubled]) // [2, 4, 6, 8]
- * ```
- *
- * @param cb Callback function that returns an array
- * @returns A reactive array synchronized with the callback's result, with a [cleanup] property to stop tracking
- */
-export function lift<Output extends any[]>(
-	cb: (access: EffectAccess) => Output
-): Output & { [cleanup]: ScopedCallback }
-
-/**
- * Lifts a callback that returns an object into a reactive object that automatically
- * synchronizes with the source object returned by the callback.
- *
- * The returned reactive object will update whenever the callback's dependencies change,
- * efficiently syncing only the properties that differ from the previous result using
- * Object.assign(). Properties that no longer exist in the source are automatically removed.
- *
- * @example
- * ```typescript
- * const user = reactive({ name: 'John', age: 30 })
- * const profile = lift(() => ({
- *   displayName: user.name.toUpperCase(),
- *   isAdult: user.age >= 18,
- *   description: `${user.name} is ${user.age} years old`
- * }))
- *
- * console.log(profile.displayName) // JOHN
- * console.log(profile.isAdult) // true
- *
- * user.name = 'Jane'
- * console.log(profile.displayName) // JANE
- * console.log(profile.description) // Jane is 30 years old
- * ```
- *
- * @param cb Callback function that returns an object
- * @returns A reactive object synchronized with the callback's result, with a [cleanup] property to stop tracking
- */
-export function lift<Output extends object>(
-	cb: (access: EffectAccess) => Output
-): Output & { [cleanup]: ScopedCallback }
-export function lift<Output extends any[] | object>(
-	cb: (access: EffectAccess) => Output
-): Output & { [cleanup]: ScopedCallback } {
-	let result: Output
-	const liftCleanup = effect((access) => {
-		const source = cb(access)
-		if (!source || typeof source !== 'object')
-			throw new Error('lift callback must return an array or object')
-		if (!result) {
-			if (Array.isArray(source)) {
-				result = reactive([]) as Output
-			} else {
-				result = reactive({}) as Output
-			}
-		}
-		if (Array.isArray(source) && Array.isArray(result)) {
-			if (result.length !== source.length) result.length = source.length
-			for (let i = 0; i < source.length; i++) if (result[i] !== source[i]) result[i] = source[i]
-		} else if (!Array.isArray(source) && !Array.isArray(result)) {
-			Object.assign(result, source)
-			for (const key of Object.keys(result)) if (!(key in source)) delete result[key]
-		} else {
-			throw new Error('lift callback must return the same type as the previous result')
-		}
-	})
-	return cleanedBy(result as Output, liftCleanup)
-}

package/src/reactive/change.ts

@@ -1,131 +0,0 @@
-import { recordTriggerLink } from '../../debug/debug'
-import { bubbleUpChange, objectsWithDeepWatchers } from './deep-watch-state'
-import { getActiveEffect, isRunning } from './effect-context'
-import { batch, hasBatched, recordActivation } from './effects'
-import { unwrap } from './proxy-state'
-import { getEffectNode, watchers } from './registry'
-import { allProps, type EffectTrigger, type Evolution, optionCall, type State } from './types'
-
-const states = new WeakMap<object, State>()
-
-export function addState(obj: any, evolution: Evolution) {
-	obj = unwrap(obj)
-	const next = {}
-	const state = getState(obj)
-	if (state) Object.assign(state, { evolution, next })
-	states.set(obj, next)
-}
-
-/**
- * Gets the current state of a reactive object for evolution tracking
- * @param obj - The reactive object
- * @returns The current state object
- */
-export function getState(obj: any) {
-	obj = unwrap(obj)
-	let state = states.get(obj)
-	if (!state) {
-		state = {}
-		states.set(obj, state)
-	}
-	return state
-}
-
-export function collectEffects(
-	obj: any,
-	evolution: Evolution,
-	effects: Set<EffectTrigger>,
-	objectWatchers: Map<any, Set<EffectTrigger>>,
-	...keyChains: Iterable<any>[]
-) {
-	const sourceEffect = getActiveEffect()
-	for (const keys of keyChains)
-		for (const key of keys) {
-			const deps = objectWatchers.get(key)
-			// console.log(`[DEBUG] collectEffects: checking ${String(key)}. Found deps: ${deps ? deps.size : 'none'}`)
-			if (deps)
-				for (const effect of deps) {
-					// console.log(`[DEBUG] collectEffects: found dependency ${effect.name || 'anonymous'} for ${String(key)}`)
-					const runningChain = isRunning(effect)
-					if (runningChain) {
-						optionCall('skipRunningEffect', effect)
-						continue
-					}
-					if (!effects.has(effect)) {
-						effects.add(effect)
-						if (!hasBatched(effect)) recordActivation(effect, obj, evolution, key)
-					}
-					recordTriggerLink(sourceEffect, effect, obj, key, evolution)
-				}
-		}
-}
-
-/**
- * Triggers effects for a single property change
- * @param obj - The object that changed
- * @param evolution - The type of change
- * @param prop - The property that changed
- */
-export function touched1(obj: any, evolution: Evolution, prop: any) {
-	touched(obj, evolution, [prop])
-}
-
-/**
- * Triggers effects for property changes
- * @param obj - The object that changed
- * @param evolution - The type of change
- * @param props - The properties that changed
- */
-export function touched(obj: any, evolution: Evolution, props?: Iterable<any>) {
-	obj = unwrap(obj)
-	addState(obj, evolution)
-	const objectWatchers = watchers.get(obj)
-	if (objectWatchers) {
-		// Note: we have to collect effects to remove duplicates in the specific case when no batch is running
-		const effects = new Set<EffectTrigger>()
-		if (props) collectEffects(obj, evolution, effects, objectWatchers, [allProps], props)
-		else collectEffects(obj, evolution, effects, objectWatchers, objectWatchers.keys())
-		optionCall('touched', obj, evolution, props as any[] | undefined, effects)
-		batch(Array.from(effects))
-	}
-
-	// Bubble up changes if this object has deep watchers
-	if (objectsWithDeepWatchers.has(obj)) {
-		bubbleUpChange(obj, evolution)
-	}
-}
-
-/**
- * Triggers only opaque effects for property changes
- * Used by deep-touch to ensure opaque listeners are notified even when deep optimization is active
- */
-export function touchedOpaque(obj: any, evolution: Evolution, prop: any) {
-	obj = unwrap(obj)
-	const objectWatchers = watchers.get(obj)
-	if (!objectWatchers) return
-
-	const deps = objectWatchers.get(prop)
-	if (!deps) return
-
-	const effects = new Set<EffectTrigger>()
-	const sourceEffect = getActiveEffect()
-
-	for (const effect of deps) {
-		const node = getEffectNode(effect)
-		if (!node.isOpaque) continue
-
-		const runningChain = isRunning(effect)
-		if (runningChain) {
-			optionCall('skipRunningEffect', effect)
-			continue
-		}
-		effects.add(effect)
-		recordActivation(effect, obj, evolution, prop)
-		recordTriggerLink(sourceEffect, effect, obj, prop, evolution)
-	}
-
-	if (effects.size > 0) {
-		optionCall('touched', obj, evolution, [prop], effects)
-		batch(Array.from(effects))
-	}
-}