mutts 1.0.6 → 1.0.8

package/dist/reactive/registry.d.ts

@@ -0,0 +1,20 @@
+import { type ScopedCallback } from './types';
+export declare const effectToReactiveObjects: WeakMap<ScopedCallback, Set<object>>;
+export declare const watchers: WeakMap<object, Map<any, Set<ScopedCallback>>>;
+export declare const effectChildren: WeakMap<ScopedCallback, Set<ScopedCallback>>;
+export declare const effectParent: WeakMap<ScopedCallback, ScopedCallback>;
+/**
+ * Marks a function with its root function for effect tracking
+ * Enforces strict unicity: A root function can only identify ONE function.
+ * @param fn - The function to mark
+ * @param root - The root function
+ * @returns The marked function
+ */
+export declare function markWithRoot<T extends Function>(fn: T, root: any): T;
+/**
+ * Gets the root function of a function for effect tracking
+ * @param fn - The function to get the root of
+ * @returns The root function
+ */
+export declare function getRoot<T extends Function | undefined>(fn: T): T;
+//# sourceMappingURL=registry.d.ts.map

package/dist/reactive/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/reactive/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAG3D,eAAO,MAAM,uBAAuB,sCAA6C,CAAA;AAGjF,eAAO,MAAM,QAAQ,gDAAuD,CAAA;AAG5E,eAAO,MAAM,cAAc,8CAAqD,CAAA;AAGhF,eAAO,MAAM,YAAY,yCAA4D,CAAA;AAKrF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,CAwBpE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,QAAQ,GAAG,SAAS,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAGhE"}

package/dist/reactive/set.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Reactive wrapper around JavaScript's WeakSet class
+ * Only tracks individual value operations, no size tracking (WeakSet limitation)
+ */
+export declare abstract class ReactiveWeakSet<T extends object> extends WeakSet<T> {
+    get [Symbol.toStringTag](): string;
+    add(value: T): this;
+    delete(value: T): boolean;
+    has(value: T): boolean;
+}
+/**
+ * Reactive wrapper around JavaScript's Set class
+ * Tracks size changes, individual value operations, and collection-wide operations
+ */
+export declare abstract class ReactiveSet<T> extends Set<T> {
+    get [Symbol.toStringTag](): string;
+    get size(): number;
+    add(value: T): this;
+    clear(): void;
+    delete(value: T): boolean;
+    has(value: T): boolean;
+    entries(): Generator<[T, T]>;
+    forEach(callbackfn: (value: T, value2: T, set: Set<T>) => void, thisArg?: any): void;
+    keys(): Generator<T>;
+    values(): Generator<T>;
+    [Symbol.iterator](): SetIterator<T>;
+}
+//# sourceMappingURL=set.d.ts.map

package/dist/reactive/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/reactive/set.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,8BAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;IACD,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAWnB,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAOzB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;CAItB;AAED;;;GAGG;AACH,8BAAsB,WAAW,CAAC,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;IAED,IAAI,IAAI,IAAI,MAAM,CAIjB;IAED,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAanB,KAAK,IAAI,IAAI;IAUb,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAWzB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAKtB,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAK5B,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,IAAI;IAKpF,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC;IAKpB,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC;IAKtB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC;CAiBnC"}

package/dist/reactive/tracking.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Marks a property as a dependency of the current effect
+ * @param obj - The object containing the property
+ * @param prop - The property name (defaults to allProps)
+ */
+export declare function dependant(obj: any, prop?: any): void;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/reactive/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/reactive/tracking.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,GAAE,GAAc,QA8BvD"}

package/dist/reactive/types.d.ts

@@ -0,0 +1,376 @@
+import { FunctionWrapper } from "../zone";
+/**
+ * Dependency access passed to user callbacks within effects/watch
+ * Provides functions to track dependencies and information about the effect execution
+ */
+export interface DependencyAccess {
+    /**
+     * Tracks dependencies in the current effect context
+     * Use this for normal dependency tracking within the effect
+     * @example
+     * ```typescript
+     * effect(({ tracked }) => {
+     *   // In async context, use tracked to restore dependency tracking
+     *   await someAsyncOperation()
+     *   const value = tracked(() => state.count) // Tracks state.count in this effect
+     * })
+     * ```
+     */
+    tracked: FunctionWrapper;
+    /**
+     * Tracks dependencies in the parent effect context
+     * Use this when child effects should track dependencies in the parent,
+     * allowing parent cleanup to manage child effects while dependencies trigger the parent
+     * @example
+     * ```typescript
+     * effect(({ ascend }) => {
+     *   const length = inputs.length
+     *   if (length > 0) {
+     *     ascend(() => {
+     *       // Dependencies here are tracked in the parent effect
+     *       inputs.forEach(item => console.log(item))
+     *     })
+     *   }
+     * })
+     * ```
+     */
+    ascend: FunctionWrapper;
+    /**
+     * Indicates whether the effect is running as a reaction (i.e. not the first call)
+     * - `false`: First execution when the effect is created
+     * - `true`: Subsequent executions triggered by dependency changes
+     * @example
+     * ```typescript
+     * effect(({ reaction }) => {
+     *   if (!reaction) {
+     *     console.log('Effect initialized')
+     *     // Setup code that should only run once
+     *   } else {
+     *     console.log('Effect re-ran due to dependency change')
+     *     // Code that runs on every update
+     *   }
+     * })
+     * ```
+     */
+    reaction: boolean;
+}
+/**
+ * Type for effect cleanup functions
+ */
+export type ScopedCallback = () => void;
+/**
+ * Async execution mode for effects
+ * - `cancel`: Cancel previous async execution when dependencies change (default)
+ * - `queue`: Queue next execution to run after current completes
+ * - `ignore`: Ignore new executions while async work is running
+ */
+export type AsyncExecutionMode = 'cancel' | 'queue' | 'ignore';
+/**
+ * Options for effect creation
+ */
+export interface EffectOptions {
+    /**
+     * How to handle async effect executions when dependencies change
+     * @default 'cancel'
+     */
+    asyncMode?: AsyncExecutionMode;
+    /**
+     * If true, this effect is "opaque" to deep optimizations: it sees the object reference itself
+     * and must be notified when it changes, regardless of deep content similarity.
+     * Use this for effects that depend on object identity (like memoize).
+     */
+    opaque?: boolean;
+}
+/**
+ * Type for property evolution events
+ */
+export type PropEvolution = {
+    type: 'set' | 'del' | 'add' | 'invalidate';
+    prop: any;
+};
+/**
+ * Type for collection operation evolution events
+ */
+export type BunchEvolution = {
+    type: 'bunch';
+    method: string;
+};
+export type Evolution = PropEvolution | BunchEvolution;
+type State = {
+    evolution: Evolution;
+    next: State;
+} | {};
+declare const nativeReactive: unique symbol;
+/**
+ * Symbol to mark individual objects as non-reactive
+ */
+export declare const nonReactiveMark: unique symbol;
+/**
+ * Symbol to mark class properties as non-reactive
+ */
+export declare const unreactiveProperties: unique symbol;
+/**
+ * Symbol representing all properties in reactive tracking
+ */
+export declare const allProps: unique symbol;
+/**
+ * Symbol for accessing projection information on reactive objects
+ */
+export declare const projectionInfo: unique symbol;
+/**
+ * Symbol to check if an effect is stopped
+ */
+export declare const stopped: unique symbol;
+/**
+ * Symbol to access effect cleanup function
+ */
+export declare const cleanup: unique symbol;
+/**
+ * Context for a running projection item effect
+ */
+export interface ProjectionContext {
+    source: any;
+    key?: any;
+    target: any;
+    depth: number;
+    parent?: ProjectionContext;
+}
+declare const rootFunction: unique symbol;
+/**
+ * Structured error codes for machine-readable diagnosis
+ */
+export declare enum ReactiveErrorCode {
+    CycleDetected = "CYCLE_DETECTED",
+    MaxDepthExceeded = "MAX_DEPTH_EXCEEDED",
+    MaxReactionExceeded = "MAX_REACTION_EXCEEDED",
+    WriteInComputed = "WRITE_IN_COMPUTED",
+    TrackingError = "TRACKING_ERROR",
+    BrokenEffects = "BROKEN_EFFECTS"
+}
+export type CycleDebugInfo = {
+    code: ReactiveErrorCode.CycleDetected;
+    cycle: string[];
+    details?: string;
+};
+export type MaxDepthDebugInfo = {
+    code: ReactiveErrorCode.MaxDepthExceeded;
+    depth: number;
+    chain: string[];
+};
+export type MaxReactionDebugInfo = {
+    code: ReactiveErrorCode.MaxReactionExceeded;
+    count: number;
+    effect: string;
+};
+export type BrokenEffectsDebugInfo = {
+    code: ReactiveErrorCode.BrokenEffects;
+    cause: any;
+};
+export type GenericDebugInfo = {
+    code: ReactiveErrorCode;
+    causalChain?: string[];
+    creationStack?: string;
+    [key: string]: any;
+};
+export type ReactiveDebugInfo = CycleDebugInfo | MaxDepthDebugInfo | MaxReactionDebugInfo | BrokenEffectsDebugInfo | GenericDebugInfo;
+/**
+ * Error class for reactive system errors
+ */
+export declare class ReactiveError extends Error {
+    debugInfo?: ReactiveDebugInfo;
+    constructor(message: string, debugInfo?: ReactiveDebugInfo);
+    get code(): ReactiveErrorCode | undefined;
+    get cause(): any;
+}
+/**
+ * Global options for the reactive system
+ */
+export declare const options: {
+    /**
+     * Debug purpose: called when an effect is entered
+     * @param effect - The effect that is entered
+     */
+    enter: (_effect: Function) => void;
+    /**
+     * Debug purpose: called when an effect is left
+     * @param effect - The effect that is left
+     */
+    leave: (_effect: Function) => void;
+    /**
+     * Debug purpose: called when an effect is chained
+     * @param target - The effect that is being triggered
+     * @param caller - The effect that is calling the target
+     */
+    chain: (_targets: Function[], _caller?: Function) => void;
+    /**
+     * Debug purpose: called when an effect chain is started
+     * @param target - The effect that is being triggered
+     */
+    beginChain: (_targets: Function[]) => void;
+    /**
+     * Debug purpose: called when an effect chain is ended
+     */
+    endChain: () => void;
+    garbageCollected: (_fn: Function) => void;
+    /**
+     * Debug purpose: called when an object is touched
+     * @param obj - The object that is touched
+     * @param evolution - The type of change
+     * @param props - The properties that changed
+     * @param deps - The dependencies that changed
+     */
+    touched: (_obj: any, _evolution: Evolution, _props?: any[], _deps?: Set<ScopedCallback>) => void;
+    /**
+     * Debug purpose: called when an effect is skipped because it's already running
+     * @param effect - The effect that is already running
+     * @param runningChain - The array of effects from the detected one to the currently running one
+     */
+    skipRunningEffect: (_effect: ScopedCallback) => void;
+    /**
+     * Debug purpose: maximum effect chain (like call stack max depth)
+     * Used to prevent infinite loops
+     * @default 100
+     */
+    maxEffectChain: number;
+    /**
+     * Maximum number of times an effect can be triggered by the same cause in a single batch
+     * Used to detect aggressive re-computation or infinite loops
+     * @default 10
+     */
+    maxTriggerPerBatch: number;
+    /**
+     * Debug purpose: maximum effect reaction (like call stack max depth)
+     * Used to prevent infinite loops
+     * @default 'throw'
+     */
+    maxEffectReaction: "throw" | "debug" | "warn";
+    /**
+     * Callback called when a memoization discrepancy is detected (debug only)
+     * When defined, memoized functions will run a second time (untracked) to verify consistency.
+     * If the untracked run returns a different value than the cached one, this callback is triggered.
+     *
+     * This is the primary tool for detecting missing reactive dependencies in computed values.
+     *
+     * @param cached - The value currently in the memoization cache
+     * @param fresh - The value obtained by re-running the function untracked
+     * @param fn - The memoized function itself
+     * @param args - Arguments passed to the function
+     *
+     * @example
+     * ```typescript
+     * reactiveOptions.onMemoizationDiscrepancy = (cached, fresh, fn, args) => {
+     *   throw new Error(`Memoization discrepancy in ${fn.name}!`);
+     * };
+     * ```
+     */
+    onMemoizationDiscrepancy: ((cached: any, fresh: any, fn: Function, args: any[], cause: "calculation" | "comparison") => void) | undefined;
+    /**
+     * How to handle cycles detected in effect batches.
+     *
+     * - `'none'` (Default): High-performance mode. Disables dependency graph maintenance and
+     *   Topological Sorting in favor of a simple FIFO queue. Use this for trustworthy, acyclic UI code.
+     *   Cycle detection is heuristic (uses execution counts).
+     *
+     * - `'throw'`: Traditional Topological Sorting. Guarantees dependency order and catches
+     *   circular dependencies mathematically before execution.
+     *
+     * - `'warn'`: Topological sorting, but logs a warning instead of throwing on cycles.
+     * - `'break'`: Topological sorting, but silently breaks cycles.
+     * - `'strict'`: Prevents cycle creation by checking the graph *during* dependency discovery.
+     *
+     * @default 'none'
+     */
+    cycleHandling: "none" | "throw" | "warn" | "break" | "strict";
+    /**
+     * Internal flag used by memoization discrepancy detector to avoid counting calls in tests
+     * @warning Do not modify this flag manually, this flag is given by the engine
+     */
+    isVerificationRun: boolean;
+    /**
+     * Maximum depth for deep watching traversal
+     * Used to prevent infinite recursion in circular references
+     * @default 100
+     */
+    maxDeepWatchDepth: number;
+    /**
+     * Only react on instance members modification (not inherited properties)
+     * For instance, do not track class methods
+     * @default true
+     */
+    instanceMembers: boolean;
+    /**
+     * Ignore accessors (getters and setters) and only track direct properties
+     * @default true
+     */
+    ignoreAccessors: boolean;
+    /**
+     * Enable recursive touching when objects with the same prototype are replaced
+     * When enabled, replacing an object with another of the same prototype triggers
+     * recursive diffing instead of notifying parent effects
+     * @default true
+     */
+    recursiveTouching: boolean;
+    /**
+     * Default async execution mode for effects that return Promises
+     * - 'cancel': Cancel previous async execution when dependencies change (default, enables async zone)
+     * - 'queue': Queue next execution to run after current completes (enables async zone)
+     * - 'ignore': Ignore new executions while async work is running (enables async zone)
+     * - false: Disable async zone and async mode handling (effects run concurrently)
+     *
+     * **When truthy:** Enables async zone (Promise.prototype wrapping) for automatic context
+     * preservation in Promise callbacks. Warning: This modifies Promise.prototype globally.
+     * Only enable if no other library modifies Promise.prototype.
+     *
+     * **When false:** Async zone is disabled. Use `tracked()` manually in Promise callbacks.
+     *
+     * Can be overridden per-effect via EffectOptions
+     * @default 'cancel'
+     */
+    asyncMode: AsyncExecutionMode | false;
+    warn: (...args: any[]) => void;
+    /**
+     * Configuration for the introspection system
+     */
+    introspection: {
+        /**
+         * Whether to keep a history of mutations for debugging
+         * @default false
+         */
+        enableHistory: boolean;
+        /**
+         * Number of mutations to keep in history
+         * @default 50
+         */
+        historySize: number;
+    };
+    /**
+     * Configuration for zone hooks - control which async APIs are hooked
+     * Each option controls whether the corresponding async API is wrapped to preserve effect context
+     * Only applies when asyncMode is enabled (truthy)
+     * @deprecated Should take all when we made sure PIXI.create, Game.create, ... are -> .root()
+     */
+    zones: {
+        /**
+         * Hook setTimeout to preserve effect context
+         * @default true
+         */
+        setTimeout: boolean;
+        /**
+         * Hook setInterval to preserve effect context
+         * @default true
+         */
+        setInterval: boolean;
+        /**
+         * Hook requestAnimationFrame (runs in untracked context when hooked)
+         * @default true
+         */
+        requestAnimationFrame: boolean;
+        /**
+         * Hook queueMicrotask to preserve effect context
+         * @default true
+         */
+        queueMicrotask: boolean;
+    };
+};
+export { type State, nativeReactive, rootFunction };
+//# sourceMappingURL=types.d.ts.map

package/dist/reactive/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reactive/types.ts"],"names":[],"mappings":"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"}

package/dist/std-decorators.d.ts

@@ -1,30 +1,29 @@
-import { LegacyPropertyDecorator, ModernGetterDecorator, ModernAccessorDecorator, ModernMethodDecorator, LegacyClassDecorator, ModernClassDecorator, ModernSetterDecorator, GenericClassDecorator } from './decorator.js';
-
+import { type GenericClassDecorator } from './decorator';
 /**
  * Decorator that caches the result of a getter method and only recomputes when dependencies change
  * Prevents circular dependencies and provides automatic cache invalidation
  */
-declare const cached: LegacyPropertyDecorator<any> & ModernGetterDecorator<any> & ModernAccessorDecorator<any>;
+export declare const cached: import("./decorator").LegacyPropertyDecorator<any> & import("./decorator").ModernGetterDecorator<any> & import("./decorator").ModernAccessorDecorator<any>;
 /**
  * Checks if a property is cached (has a cached value)
  * @param object - The object to check
  * @param propertyKey - The property key to check
  * @returns True if the property has a cached value
  */
-declare function isCached(object: Object, propertyKey: PropertyKey): boolean;
+export declare function isCached(object: Object, propertyKey: PropertyKey): boolean;
 /**
  * Caches a value for a property on an object
  * @param object - The object to cache the value on
  * @param propertyKey - The property key to cache
  * @param value - The value to cache
  */
-declare function cache(object: Object, propertyKey: PropertyKey, value: any): void;
+export declare function cache(object: Object, propertyKey: PropertyKey, value: any): void;
 /**
  * Creates a decorator that modifies property descriptors for specified properties
  * @param descriptor - The descriptor properties to apply
  * @returns A class decorator that applies the descriptor to specified properties
  */
-declare function describe(descriptor: {
+export declare function describe(descriptor: {
     enumerable?: boolean;
     configurable?: boolean;
     writable?: boolean;
@@ -33,7 +32,7 @@ declare function describe(descriptor: {
  * Decorator that marks methods, properties, or classes as deprecated
  * Provides warning messages when deprecated items are used
  */
-declare const deprecated: LegacyPropertyDecorator<any> & ModernMethodDecorator<any> & LegacyClassDecorator<new (...args: any[]) => any> & ModernClassDecorator<new (...args: any[]) => any> & ModernGetterDecorator<any> & ModernAccessorDecorator<any> & ModernSetterDecorator<any> & ((message: string) => LegacyPropertyDecorator<any> & ModernMethodDecorator<any> & LegacyClassDecorator<new (...args: any[]) => any> & ModernClassDecorator<new (...args: any[]) => any> & ModernGetterDecorator<any> & ModernAccessorDecorator<any> & ModernSetterDecorator<any>) & {
+export declare const deprecated: import("./decorator").LegacyPropertyDecorator<any> & import("./decorator").ModernMethodDecorator<any> & import("./decorator").LegacyClassDecorator<new (...args: any[]) => any> & import("./decorator").ModernClassDecorator<new (...args: any[]) => any> & import("./decorator").ModernGetterDecorator<any> & import("./decorator").ModernAccessorDecorator<any> & import("./decorator").ModernSetterDecorator<any> & ((message: string) => import("./decorator").LegacyPropertyDecorator<any> & import("./decorator").ModernMethodDecorator<any> & import("./decorator").LegacyClassDecorator<new (...args: any[]) => any> & import("./decorator").ModernClassDecorator<new (...args: any[]) => any> & import("./decorator").ModernGetterDecorator<any> & import("./decorator").ModernAccessorDecorator<any> & import("./decorator").ModernSetterDecorator<any>) & {
     warn: (target: any, propertyKey: PropertyKey, message?: string) => void;
 };
 /**
@@ -41,12 +40,11 @@ declare const deprecated: LegacyPropertyDecorator<any> & ModernMethodDecorator<a
  * @param delay - The delay in milliseconds
  * @returns A method decorator that debounces method calls
  */
-declare function debounce(delay: number): LegacyPropertyDecorator<any> & ModernMethodDecorator<any>;
+export declare function debounce(delay: number): import("./decorator").LegacyPropertyDecorator<any> & import("./decorator").ModernMethodDecorator<any>;
 /**
  * Creates a throttled method decorator that limits execution to once per delay period
  * @param delay - The delay in milliseconds
  * @returns A method decorator that throttles method calls
  */
-declare function throttle(delay: number): LegacyPropertyDecorator<any> & ModernMethodDecorator<any>;
-
-export { cache, cached, debounce, deprecated, describe, isCached, throttle };
+export declare function throttle(delay: number): import("./decorator").LegacyPropertyDecorator<any> & import("./decorator").ModernMethodDecorator<any>;
+//# sourceMappingURL=std-decorators.d.ts.map

package/dist/std-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"std-decorators.d.ts","sourceRoot":"","sources":["../src/std-decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAInE;;;GAGG;AACH,eAAO,MAAM,MAAM,4JAuBjB,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,WAEhE;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,QAEzE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE;IACpC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,IACQ,CAAC,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,KAAG,qBAAqB,CAAC,CAAC,CAAC,CAchE;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,oaA4BJ,MAAM;mBAgCR,GAAG,eAAe,WAAW,YAAY,MAAM;CAO/D,CAAA;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,yGAmBrC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,yGAiCrC"}

package/dist/utils.d.ts

@@ -0,0 +1,49 @@
+type ElementTypes<T extends readonly unknown[]> = {
+    [K in keyof T]: T[K] extends readonly (infer U)[] ? U : T[K];
+};
+/**
+ * Combines multiple arrays into an array of tuples, stopping at the shortest array length
+ * @param args - Arrays to zip together
+ * @returns Array of tuples containing elements from each input array
+ */
+export declare function zip<T extends (readonly unknown[])[]>(...args: T): ElementTypes<T>[];
+/**
+ * Checks if two arrays are strictly equal (shallow comparison)
+ * @param a - First value
+ * @param b - Second value
+ * @returns True if arrays are equal or values are strictly equal
+ */
+export declare function arrayEquals(a: any, b: any): boolean;
+/**
+ * Checks if a function is a constructor (class or constructor function)
+ * @param fn - The function to check
+ * @returns True if the function is a constructor
+ */
+export declare function isConstructor(fn: Function): boolean;
+/**
+ * Renames a function with a new name
+ * @param fct - The function to rename
+ * @param name - The new name for the function
+ * @returns The function with the new name
+ */
+export declare function renamed<F extends Function>(fct: F, name: string): F;
+export declare const FoolProof: {
+    get(obj: any, prop: any, receiver: any): any;
+    set(obj: any, prop: any, value: any, receiver: any): boolean;
+};
+export declare function isOwnAccessor(obj: any, prop: any): boolean;
+/**
+ * Deeply compares two values.
+ * For objects, compares prototypes with === and then own properties recursively.
+ * Uses a cache to handle circular references.
+ * @param a - First value
+ * @param b - Second value
+ * @param cache - Map for circular reference protection (internal use)
+ * @returns True if values are deeply equal
+ */
+export declare function deepCompare(a: any, b: any, cache?: Map<object, Set<object>>): boolean;
+export declare function contentRef(container: object): any;
+export declare function tag<T extends object>(name: string, obj: T): T;
+export declare function named<T extends Function>(name: string, fn: T): T;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IAAI;KAChD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC5D,CAAA;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAWnF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CAQnD;AA0BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAMnD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAMnE;AACD,eAAO,MAAM,SAAS;aACZ,GAAG,QAAQ,GAAG,YAAY,GAAG;aAK7B,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG;CAiBlD,CAAA;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,WAGhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,2BAAiC,GAAG,OAAO,CAqI3F;AAID,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,OAW3C;AAED,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAc7D;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAOhE"}

package/dist/zone.d.ts

@@ -0,0 +1,40 @@
+export declare abstract class AZone<T> {
+    abstract active?: T;
+    protected enter(value?: T): unknown;
+    protected leave(entered: unknown): void;
+    with<R>(value: T, fn: () => R): R;
+    root<R>(fn: () => R): R;
+    get zoned(): FunctionWrapper;
+}
+export type FunctionWrapper = <R>(fn?: () => R) => R;
+export declare class Zone<T> extends AZone<T> {
+    active: T | undefined;
+}
+type HistoryValue<T> = {
+    present: T | undefined;
+    history: Set<T>;
+};
+export declare class ZoneHistory<T> extends AZone<HistoryValue<T>> {
+    private controlled;
+    private history;
+    readonly present: AZone<T>;
+    has(value: T): boolean;
+    some(predicate: (value: T) => boolean): boolean;
+    constructor(controlled?: AZone<T>);
+    get active(): HistoryValue<T> | undefined;
+    set active(value: HistoryValue<T> | undefined);
+}
+export declare class ZoneAggregator extends AZone<Map<AZone<unknown>, unknown>> {
+    #private;
+    constructor(...zones: AZone<unknown>[]);
+    get active(): Map<AZone<unknown>, unknown> | undefined;
+    set active(value: Map<AZone<unknown>, unknown> | undefined);
+    enter(value?: Map<AZone<unknown>, unknown> | undefined): Map<AZone<unknown>, unknown>;
+    leave(entered: Map<AZone<unknown>, unknown>): void;
+    add(z: AZone<unknown>): void;
+    delete(z: AZone<unknown>): void;
+    clear(): void;
+}
+export declare const asyncZone: ZoneAggregator;
+export {};
+//# sourceMappingURL=zone.d.ts.map

package/dist/zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../src/zone.ts"],"names":[],"mappings":"AAUA,8BAAsB,KAAK,CAAC,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACnB,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,OAAO;IAKnC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAGvC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAYjC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAQvB,IAAI,KAAK,IAAI,eAAe,CAG3B;CACD;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;AAEpD,qBAAa,IAAI,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAA;CACrB;AACD,KAAK,YAAY,CAAC,CAAC,IAAI;IAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;CAAC,CAAA;AAChE,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAU7C,OAAO,CAAC,UAAU;IAT9B,OAAO,CAAC,OAAO,CAAe;IAC9B,SAAgB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IAC1B,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAGtB,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO;gBAIlC,UAAU,GAAE,KAAK,CAAC,CAAC,CAAiB;IAqBxD,IAAI,MAAM,IAGQ,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAD5C;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAG5C;CACD;AAED,qBAAa,cAAe,SAAQ,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;;gBAE1D,GAAG,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;IAItC,IAAI,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,CAKrD;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,EAEzD;IACD,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS;IAQtD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI;IAGlD,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAGrB,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAGxB,KAAK;CAGL;AAED,eAAO,MAAM,SAAS,gBAAqC,CAAA"}

package/docs/ai/api-reference.md

@@ -68,8 +68,6 @@ export interface Register<T, K extends PropertyKey = PropertyKey> extends Iterab
 }
 
 export declare function register<T, K extends PropertyKey = PropertyKey>(keyFn: (item: T) => K, initial?: Iterable<T>): Register<T, K>;
-export declare function mapped<T, U>(inputs: readonly T[], compute: (input: T, index: number, output: U[]) => U): readonly U[];
-export declare function reduced<T, U, R extends object = any>(inputs: readonly T[], compute: (input: T, factor: R) => readonly U[]): readonly U[];
 export declare function project<S, R>(source: S, apply: (access: any, target: any) => any): R;
 export declare function organized<S, T>(source: S, apply: (access: any, target: T) => any, baseTarget?: T): T;
 

package/docs/reactive/advanced.md

@@ -1161,10 +1161,6 @@ class Example {
 }
 ```
 
-### Working with `mapped()`
-
-Pair `memoize()` with [`mapped()`](#mapped) to keep derived array elements stable across reorders (see [Identity-preserving mapped arrays](#identity-preserving-mapped-arrays)). Memoizing the mapper ensures each input object is processed at most once and its derived state persists while the input reference lives.
-
 ## Debugging and Development
 
 The `mutts` reactive system includes built-in tools for troubleshooting complex dependency graphs and identifying performance bottlenecks.
@@ -1173,7 +1169,8 @@ For a full guide on debugging, including cycle detection and memoization discrep
 
 ### Quick Summary
 
-- **Cycle Detection**: Automatically catch circular dependencies via `reactiveOptions.cycleHandling`.
+- **Cycle Detection**: Automatically catch circular dependencies via `reactiveOptions.cycleHandling`. Note: Instant mathematical detection requires choosing a mode other than `'none'`.
+- **Flat Mode**: The default `reactiveOptions.cycleHandling = 'none'` provides maximum performance in high-frequency update scenarios by disabling graph maintenance.
 - **Memoization Discrepancy**: Detect "missing dependencies" by running computations twice during development using `reactiveOptions.onMemoizationDiscrepancy`.
 - **Global Hooks**: Use `reactiveOptions.touched`, `enter`, and `leave` to observe system activity.