sia-reactor 0.0.25 → 0.0.26

package/README.md

@@ -5,8 +5,9 @@
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![NPM Version](https://img.shields.io/npm/v/sia-reactor.svg)](https://www.npmjs.com/package/sia-reactor)
 [![Bundle Size](https://img.shields.io/bundlephobia/minzip/sia-reactor)](https://bundlephobia.com/package/sia-reactor)
+[![Github](https://img.shields.io/badge/github-100000?style=for-the-badge&logo=github)](https://github.com/Tobi007-del/sia-reactor)
 
-[Live Demo & Benchmarks](https://tobi007-del.github.io/t007-tools/packages/sia-reactor/src/index.html) | [Report Bug](https://github.com/Tobi007-del/t007-tools/issues)
+[Live Demo & Benchmarks](https://tobi007-del.github.io/sia-reactor/src/index.html) | [Report Bug](https://github.com/Tobi007-del/sia-reactor/issues)
 
 [Chronicles](https://github.com/Tobi007-del/tmg-media-player/blob/main/CHRONICLES.md) | [Interaction Folklore](https://github.com/Tobi007-del/tmg-media-player/blob/main/FOLKLORE.md)
 
@@ -195,7 +196,7 @@ const data = reactive({
 
 ### React Hooks & Effects
 
-The engine provides native React bindings utilizing `useSyncExternalStore` and an internal `Autotracker` for concurrent-safe, surgically precise component re-renders. All hooks natively accept a `Reactor` instance, a `reactive()` proxy, or a plain object (which will be auto-wrapped on the fly). Just import, your editor will reveal more details.
+The engine provides native React bindings utilizing `useSyncExternalStore` and an internal `Autotracker` for concurrent-safe, surgically precise component re-renders. All hooks natively accept a `Reactor` instance, a `reactive()` proxy, or a plain object (which will be auto-wrapped on the fly). Just import, your editor will reveal more details all round.
 
 ```javascript
 import { reactive } from "sia-reactor";
@@ -230,7 +231,7 @@ const stopTracking = effect(() => console.log("User name changed to:", state.use
 
 ### Modules: The Extension Port
 
-The `Reactor` is designed to be a lightweight core. Extended capabilities are attached via Modules. It ships with a suite of powerful modules for common architectural needs.
+The `Reactor` is designed to be a lightweight core. Extended capabilities are attached via Modules. Use `.attach(target: Reactor | Reactive<T>, id)` to chain reactors then `.setup(target, id)` which the `Reactor.use()` also calls to init, the `id` param will be direct keys on the final object, pass dotted paths to manipulate the shape.
 
 #### The Persistence Module
 Automatically syncs your State to LocalStorage, SessionStorage, Memory or IndexedDB. Always use this module first to avoid re-initialization issues.
@@ -240,14 +241,20 @@ import { reactive, Reactor, getReactor } from "sia-reactor";
 import { PersistModule, LocalStorageAdapter, IndexedDBAdapter, SessionStorageAdapter, CookieAdapter, MemoryAdapter } from "sia-reactor/modules";
 
 const state = reactive({ theme: "dark", settings: { volume: 50, brightness: 30 } });
-const persist = new PersistModule({ // Plug it in. State is now automatically hydrated and throttled-saved.
-  key: "APP_PREFS",
-  paths: ["theme", "settings.brightness"],
-  throttle: 5000, 
-  fanout: true, // async hydration should use leaf writes to sync already initialized listeners.
+const persist = new PersistModule({
+  key: "APP_GLOBAL_STATE",
+  whitelist: ["theme", "settings.brightness"], // all paths if omitted, use object if multiple reactors
+  blacklist: ["settings.debug"], // optional excluded paths
+  throttle: 2500, // ms between saves
+  fanout: true, // async hydration use leaf writes to sync initialized listeners.
   adapter: new IndexedDBAdapter({ dbName: "Session", version: 1, onversionchange: () => location.reload(), useSnapshot: true }) // or `LocalStorageAdapter` (instance or signature)
-};
-state.use(persist, getReactor(state)));  // Put `Reactor` as second constructor arg if you want type inference, e.g. for the paths in the array.
+}, getReactor(state)); // `Reactor` in second arg for path inference
+state.use(persist); // calls `.setup()`, use after all attachments, `id` is the second param too.
+
+// Seperate attach sample if multiple reactors desired
+persist.attach(uiState, "ui").setup(appState, "app"); // or paths: "app.ui"
+persist.config.whitelist = { ui: ["settings.theme"], app: ["settings.volume"] }; // Multi-reactor filtering by id key. If you didn't pass ids, use implicit index keys: { "0": [...], "1": [...] }
+
 ```
 
 #### The Time Travel Module
@@ -258,7 +265,7 @@ import { TimeTravelModule } from "sia-reactor/modules";
 import { effect, TimeTravelOverlay } from "sia-reactor/adapters/vanilla";
 import "sia-reactor/css/time-travel-overlay.css";
 
-const time = new TimeTravelModule({ maxHistory: 300, loop: false, rate: 150 });
+const time = new TimeTravelModule({ maxHistory: 300, loop: false, rate: 150, whitelist: ["state.playing", "state.currentTime"] });
 state.use(time);
 
 // If persist uses an async adapter (e.g. IndexedDB), wait till after hydration:
@@ -531,7 +538,7 @@ S.I.A. Reactor synthesizes core concepts from the heavyweights of web and media
 
 No fancy screenshots here. True engineers look at performance metrics.
 
-To see the Reactor handle deep DAG mutations, DOM-style event routing, and microtask batching in real-time, visit the **[Live Demo](https://tobi007-del.github.io/t007-tools/packages/sia-reactor/src/index.html)**, open your DevTools console, and run the built-in Grand Master Stress Suite directly on your own CPU.
+To see the Reactor handle deep DAG mutations, DOM-style event routing, and microtask batching in real-time, visit the **[Live Demo](https://tobi007-del.github.io/sia-reactor/src/index.html)**, open your DevTools console, and run the built-in Grand Master Stress Suite directly on your own CPU.
 
 *NOTE: The reactor is progressively enhanced so it's performance depends on how you use it and the options you toggle, it's base form is incredibly light.*
 
@@ -540,7 +547,7 @@ To see the Reactor handle deep DAG mutations, DOM-style event routing, and micro
 ## Author
 
 - Architect & Developer - [Oketade Oluwatobiloba (Tobi007-del)](https://github.com/Tobi007-del)
-- Project - [t007-tools](https://github.com/Tobi007-del/t007-tools)
+- Project - [t007-tools](https://github.com/Tobi007-del/sia-reactor)
 
 ## Acknowledgments
 
@@ -550,6 +557,6 @@ Designed to bring absolute architectural dominance and rendering efficiency to c
 
 If you find this project useful, please consider giving it a star! ⭐
 
-[![Star History Chart](https://api.star-history.com/svg?repos=Tobi007-del/t007-tools&type=Date)](https://github.com/Tobi007-del/t007-tools)
+[![Star History Chart](https://api.star-history.com/svg?repos=Tobi007-del/sia-reactor&type=Date)](https://github.com/Tobi007-del/sia-reactor)
 
 **[⬆ Back to Top](#sia-reactor)**

package/dist/{TimeTravelOverlay-Bz2v9hov.d.cts → TimeTravelOverlay-_6k5wu1I.d.cts}

@@ -1,5 +1,5 @@
-import { d as Reactive } from './index-CB-IiZIB.cjs';
-import { m as TimeTravelModule } from './timeTravel-CEc3grUE.cjs';
+import { d as Reactive } from './index-2jKy98op.cjs';
+import { m as TimeTravelModule } from './timeTravel-DzgX8BKQ.cjs';
 
 /** Reactive options for the TimeTravel overlay instance. */
 interface TimeTravelOverlayConfig {

package/dist/{TimeTravelOverlay-CvTDJWpP.d.ts → TimeTravelOverlay-fun5VLIo.d.ts}

@@ -1,5 +1,5 @@
-import { d as Reactive } from './index-CB-IiZIB.js';
-import { m as TimeTravelModule } from './timeTravel-D7NiYqdD.js';
+import { d as Reactive } from './index-2jKy98op.js';
+import { m as TimeTravelModule } from './timeTravel-CsbQ8qhP.js';
 
 /** Reactive options for the TimeTravel overlay instance. */
 interface TimeTravelOverlayConfig {

package/dist/adapters/react.d.cts

@@ -1,7 +1,7 @@
-import { E as EffectOptions, R as Reactor, d as Reactive, v as ReactorBuild, D as DeepReadonly, W as WildPaths, e as PathValue } from '../index-CB-IiZIB.cjs';
+import { E as EffectOptions, R as Reactor, d as Reactive, v as ReactorBuild, D as DeepReadonly, W as WildPaths, e as PathValue } from '../index-2jKy98op.cjs';
 import { useLayoutEffect } from 'react';
-import { m as TimeTravelModule } from '../timeTravel-CEc3grUE.cjs';
-import { a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-Bz2v9hov.cjs';
+import { m as TimeTravelModule } from '../timeTravel-DzgX8BKQ.cjs';
+import { a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-_6k5wu1I.cjs';
 
 /**
  * Subscribes a component to desired Reactor state and returns it.

package/dist/adapters/react.d.ts

@@ -1,7 +1,7 @@
-import { E as EffectOptions, R as Reactor, d as Reactive, v as ReactorBuild, D as DeepReadonly, W as WildPaths, e as PathValue } from '../index-CB-IiZIB.js';
+import { E as EffectOptions, R as Reactor, d as Reactive, v as ReactorBuild, D as DeepReadonly, W as WildPaths, e as PathValue } from '../index-2jKy98op.js';
 import { useLayoutEffect } from 'react';
-import { m as TimeTravelModule } from '../timeTravel-D7NiYqdD.js';
-import { a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-CvTDJWpP.js';
+import { m as TimeTravelModule } from '../timeTravel-CsbQ8qhP.js';
+import { a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-fun5VLIo.js';
 
 /**
  * Subscribes a component to desired Reactor state and returns it.

package/dist/adapters/vanilla.d.cts

@@ -1,7 +1,7 @@
-import { E as EffectOptions } from '../index-CB-IiZIB.cjs';
-export { A as Autotracker, w as withTracker } from '../index-CB-IiZIB.cjs';
-export { T as TimeTravelOverlay, a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-Bz2v9hov.cjs';
-import '../timeTravel-CEc3grUE.cjs';
+import { E as EffectOptions } from '../index-2jKy98op.cjs';
+export { A as Autotracker, w as withTracker } from '../index-2jKy98op.cjs';
+export { T as TimeTravelOverlay, a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-_6k5wu1I.cjs';
+import '../timeTravel-DzgX8BKQ.cjs';
 
 /**
  * Runs a reactive side effect in vanilla JavaScript.

package/dist/adapters/vanilla.d.ts

@@ -1,7 +1,7 @@
-import { E as EffectOptions } from '../index-CB-IiZIB.js';
-export { A as Autotracker, w as withTracker } from '../index-CB-IiZIB.js';
-export { T as TimeTravelOverlay, a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-CvTDJWpP.js';
-import '../timeTravel-D7NiYqdD.js';
+import { E as EffectOptions } from '../index-2jKy98op.js';
+export { A as Autotracker, w as withTracker } from '../index-2jKy98op.js';
+export { T as TimeTravelOverlay, a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-fun5VLIo.js';
+import '../timeTravel-CsbQ8qhP.js';
 
 /**
  * Runs a reactive side effect in vanilla JavaScript.

package/dist/{index-CB-IiZIB.d.cts → index-2jKy98op.d.cts}

@@ -816,6 +816,7 @@ declare function deepClone<T>(obj: T, config?: {
 declare function nuke(target: any): void;
 
 type ReactorModuleId = string | number;
+type ModulePaths<P extends string = string> = P[] | Partial<Record<string, P[]>>;
 interface ReactorModuleConstructor<P extends BaseReactorModule = BaseReactorModule, T extends object = any> {
     new (rtr: Reactor<T>, config: any): P;
     moduleName: string;
@@ -873,6 +874,13 @@ declare abstract class BaseReactorModule<T extends object = any, Config = any, S
      * window.addEventListener("resize", this.guard(() => this.syncLayout(true)), { signal: this.signal });
      */
     guard: <Fn extends Function>(fn: Fn) => Fn;
+    /**
+     * Path resolution utility for modules, provides automatic reactor id resolution for multi-reactor setups.
+     * @param paths Paths to filter by, supports same formats as `ModulePaths`, will be resolved with the module's reactor id if applicable.
+     * @param target Reactor or reactor id to resolve paths for when using per-reactor path lists`.
+     * @returns Resolved paths array, defaults to `["*"]` if no paths are found using search criteria.
+     */
+    protected getPaths<P extends string = string>(paths?: ModulePaths<P>, target?: Reactor<any> | ReactorModuleId): P[];
 }
 
 /**
@@ -1195,4 +1203,4 @@ declare const NIL: any;
 /** Shared no-operation function. */
 declare const NOOP: () => void;
 
-export { type Live as $, Autotracker as A, BaseReactorModule as B, CTX as C, type DeepReadonly as D, type EffectOptions as E, type FanoutTuple as F, type DeepMerge as G, type DeepPartial as H, type Inert as I, type DeepRequired as J, type Deleter as K, type DeleterRecord as L, type DepthConfig as M, type DirectPayload as N, EVT_OPTS as O, type Paths as P, type Getter as Q, Reactor as R, type GetterRecord as S, INDIFFABLE as T, INERTIA as U, type Intent as V, type WildPaths as W, type Listener as X, type ListenerOptions as Y, type ListenerOptionsTuple as Z, type ListenerRecord as _, type REvent as a, type MaxDepth as a0, NIL as a1, NOOP as a2, type NextDepth as a3, type NoTraverse as a4, type PathBranch as a5, type PathBranchValue as a6, type PathDepth as a7, type PathKey as a8, type PathLeaf as a9, type WatcherRecord as aA, getRaw as aB, getSnapshotVersion as aC, getVersion as aD, inert as aE, intent as aF, isInert as aG, isIntent as aH, isVolatile as aI, live as aJ, methods as aK, reactive as aL, stable as aM, state as aN, volatile as aO, type Payload as aa, type PrevDepth as ab, type Primitive as ac, RAW as ad, REJECTABLE as ae, RTR_BATCH as af, RTR_LOG as ag, type ReactivePreferences as ah, ReactorEvent as ai, SSVERSION as aj, type Setter as ak, type SetterRecord as al, type Stable as am, type State as an, type StrictPathKey as ao, type SubtractDepth as ap, type SyncOptions as aq, type SyncOptionsTuple as ar, TERMINATOR as as, type Target as at, type Unflatten as au, type UnionToIntersection as av, type UpdatePayload as aw, VERSION as ax, type Volatile as ay, type Watcher as az, type ReactorModuleConstructor as b, type ReactorModuleId as c, type Reactive as d, type PathValue as e, arrRegex as f, canHandle as g, deepClone as h, deleteAny as i, fanout as j, fanoutOptsArr as k, getAny as l, getTrailRecords as m, inAny as n, isObj as o, isPOJO as p, mergeObjs as q, nuke as r, parseAnyObj as s, parseEvtOpts as t, setAny as u, type ReactorBuild as v, withTracker as w, type AddDepth as x, type ChildPaths as y, type DeepKeys as z };
+export { type ListenerRecord as $, Autotracker as A, BaseReactorModule as B, CTX as C, type DeepReadonly as D, type EffectOptions as E, type FanoutTuple as F, type DeepMerge as G, type DeepPartial as H, type Inert as I, type DeepRequired as J, type Deleter as K, type DeleterRecord as L, type ModulePaths as M, type DepthConfig as N, type DirectPayload as O, type Paths as P, EVT_OPTS as Q, Reactor as R, type Getter as S, type GetterRecord as T, INDIFFABLE as U, INERTIA as V, type WildPaths as W, type Intent as X, type Listener as Y, type ListenerOptions as Z, type ListenerOptionsTuple as _, type ReactorModuleId as a, type Live as a0, type MaxDepth as a1, NIL as a2, NOOP as a3, type NextDepth as a4, type NoTraverse as a5, type PathBranch as a6, type PathBranchValue as a7, type PathDepth as a8, type PathKey as a9, type Watcher as aA, type WatcherRecord as aB, getRaw as aC, getSnapshotVersion as aD, getVersion as aE, inert as aF, intent as aG, isInert as aH, isIntent as aI, isVolatile as aJ, live as aK, methods as aL, reactive as aM, stable as aN, state as aO, volatile as aP, type PathLeaf as aa, type Payload as ab, type PrevDepth as ac, type Primitive as ad, RAW as ae, REJECTABLE as af, RTR_BATCH as ag, RTR_LOG as ah, type ReactivePreferences as ai, ReactorEvent as aj, SSVERSION as ak, type Setter as al, type SetterRecord as am, type Stable as an, type State as ao, type StrictPathKey as ap, type SubtractDepth as aq, type SyncOptions as ar, type SyncOptionsTuple as as, TERMINATOR as at, type Target as au, type Unflatten as av, type UnionToIntersection as aw, type UpdatePayload as ax, VERSION as ay, type Volatile as az, type REvent as b, type ReactorModuleConstructor as c, type Reactive as d, type PathValue as e, arrRegex as f, canHandle as g, deepClone as h, deleteAny as i, fanout as j, fanoutOptsArr as k, getAny as l, getTrailRecords as m, inAny as n, isObj as o, isPOJO as p, mergeObjs as q, nuke as r, parseAnyObj as s, parseEvtOpts as t, setAny as u, type ReactorBuild as v, withTracker as w, type AddDepth as x, type ChildPaths as y, type DeepKeys as z };

package/dist/{index-CB-IiZIB.d.ts → index-2jKy98op.d.ts}

@@ -816,6 +816,7 @@ declare function deepClone<T>(obj: T, config?: {
 declare function nuke(target: any): void;
 
 type ReactorModuleId = string | number;
+type ModulePaths<P extends string = string> = P[] | Partial<Record<string, P[]>>;
 interface ReactorModuleConstructor<P extends BaseReactorModule = BaseReactorModule, T extends object = any> {
     new (rtr: Reactor<T>, config: any): P;
     moduleName: string;
@@ -873,6 +874,13 @@ declare abstract class BaseReactorModule<T extends object = any, Config = any, S
      * window.addEventListener("resize", this.guard(() => this.syncLayout(true)), { signal: this.signal });
      */
     guard: <Fn extends Function>(fn: Fn) => Fn;
+    /**
+     * Path resolution utility for modules, provides automatic reactor id resolution for multi-reactor setups.
+     * @param paths Paths to filter by, supports same formats as `ModulePaths`, will be resolved with the module's reactor id if applicable.
+     * @param target Reactor or reactor id to resolve paths for when using per-reactor path lists`.
+     * @returns Resolved paths array, defaults to `["*"]` if no paths are found using search criteria.
+     */
+    protected getPaths<P extends string = string>(paths?: ModulePaths<P>, target?: Reactor<any> | ReactorModuleId): P[];
 }
 
 /**
@@ -1195,4 +1203,4 @@ declare const NIL: any;
 /** Shared no-operation function. */
 declare const NOOP: () => void;
 
-export { type Live as $, Autotracker as A, BaseReactorModule as B, CTX as C, type DeepReadonly as D, type EffectOptions as E, type FanoutTuple as F, type DeepMerge as G, type DeepPartial as H, type Inert as I, type DeepRequired as J, type Deleter as K, type DeleterRecord as L, type DepthConfig as M, type DirectPayload as N, EVT_OPTS as O, type Paths as P, type Getter as Q, Reactor as R, type GetterRecord as S, INDIFFABLE as T, INERTIA as U, type Intent as V, type WildPaths as W, type Listener as X, type ListenerOptions as Y, type ListenerOptionsTuple as Z, type ListenerRecord as _, type REvent as a, type MaxDepth as a0, NIL as a1, NOOP as a2, type NextDepth as a3, type NoTraverse as a4, type PathBranch as a5, type PathBranchValue as a6, type PathDepth as a7, type PathKey as a8, type PathLeaf as a9, type WatcherRecord as aA, getRaw as aB, getSnapshotVersion as aC, getVersion as aD, inert as aE, intent as aF, isInert as aG, isIntent as aH, isVolatile as aI, live as aJ, methods as aK, reactive as aL, stable as aM, state as aN, volatile as aO, type Payload as aa, type PrevDepth as ab, type Primitive as ac, RAW as ad, REJECTABLE as ae, RTR_BATCH as af, RTR_LOG as ag, type ReactivePreferences as ah, ReactorEvent as ai, SSVERSION as aj, type Setter as ak, type SetterRecord as al, type Stable as am, type State as an, type StrictPathKey as ao, type SubtractDepth as ap, type SyncOptions as aq, type SyncOptionsTuple as ar, TERMINATOR as as, type Target as at, type Unflatten as au, type UnionToIntersection as av, type UpdatePayload as aw, VERSION as ax, type Volatile as ay, type Watcher as az, type ReactorModuleConstructor as b, type ReactorModuleId as c, type Reactive as d, type PathValue as e, arrRegex as f, canHandle as g, deepClone as h, deleteAny as i, fanout as j, fanoutOptsArr as k, getAny as l, getTrailRecords as m, inAny as n, isObj as o, isPOJO as p, mergeObjs as q, nuke as r, parseAnyObj as s, parseEvtOpts as t, setAny as u, type ReactorBuild as v, withTracker as w, type AddDepth as x, type ChildPaths as y, type DeepKeys as z };
+export { type ListenerRecord as $, Autotracker as A, BaseReactorModule as B, CTX as C, type DeepReadonly as D, type EffectOptions as E, type FanoutTuple as F, type DeepMerge as G, type DeepPartial as H, type Inert as I, type DeepRequired as J, type Deleter as K, type DeleterRecord as L, type ModulePaths as M, type DepthConfig as N, type DirectPayload as O, type Paths as P, EVT_OPTS as Q, Reactor as R, type Getter as S, type GetterRecord as T, INDIFFABLE as U, INERTIA as V, type WildPaths as W, type Intent as X, type Listener as Y, type ListenerOptions as Z, type ListenerOptionsTuple as _, type ReactorModuleId as a, type Live as a0, type MaxDepth as a1, NIL as a2, NOOP as a3, type NextDepth as a4, type NoTraverse as a5, type PathBranch as a6, type PathBranchValue as a7, type PathDepth as a8, type PathKey as a9, type Watcher as aA, type WatcherRecord as aB, getRaw as aC, getSnapshotVersion as aD, getVersion as aE, inert as aF, intent as aG, isInert as aH, isIntent as aI, isVolatile as aJ, live as aK, methods as aL, reactive as aM, stable as aN, state as aO, volatile as aP, type PathLeaf as aa, type Payload as ab, type PrevDepth as ac, type Primitive as ad, RAW as ae, REJECTABLE as af, RTR_BATCH as ag, RTR_LOG as ah, type ReactivePreferences as ai, ReactorEvent as aj, SSVERSION as ak, type Setter as al, type SetterRecord as am, type Stable as an, type State as ao, type StrictPathKey as ap, type SubtractDepth as aq, type SyncOptions as ar, type SyncOptionsTuple as as, TERMINATOR as at, type Target as au, type Unflatten as av, type UnionToIntersection as aw, type UpdatePayload as ax, VERSION as ay, type Volatile as az, type REvent as b, type ReactorModuleConstructor as c, type Reactive as d, type PathValue as e, arrRegex as f, canHandle as g, deepClone as h, deleteAny as i, fanout as j, fanoutOptsArr as k, getAny as l, getTrailRecords as m, inAny as n, isObj as o, isPOJO as p, mergeObjs as q, nuke as r, parseAnyObj as s, parseEvtOpts as t, setAny as u, type ReactorBuild as v, withTracker as w, type AddDepth as x, type ChildPaths as y, type DeepKeys as z };

package/dist/index.d.cts

@@ -1 +1 @@
-export { x as AddDepth, C as CTX, y as ChildPaths, z as DeepKeys, G as DeepMerge, H as DeepPartial, D as DeepReadonly, J as DeepRequired, K as Deleter, L as DeleterRecord, M as DepthConfig, N as DirectPayload, O as EVT_OPTS, E as EffectOptions, Q as Getter, S as GetterRecord, T as INDIFFABLE, U as INERTIA, I as Inert, V as Intent, X as Listener, Y as ListenerOptions, Z as ListenerOptionsTuple, _ as ListenerRecord, $ as Live, a0 as MaxDepth, a1 as NIL, a2 as NOOP, a3 as NextDepth, a4 as NoTraverse, a5 as PathBranch, a6 as PathBranchValue, a7 as PathDepth, a8 as PathKey, a9 as PathLeaf, e as PathValue, P as Paths, aa as Payload, ab as PrevDepth, ac as Primitive, ad as RAW, ae as REJECTABLE, a as REvent, af as RTR_BATCH, ag as RTR_LOG, d as Reactive, ah as ReactivePreferences, R as Reactor, v as ReactorBuild, ai as ReactorEvent, aj as SSVERSION, ak as Setter, al as SetterRecord, am as Stable, an as State, ao as StrictPathKey, ap as SubtractDepth, aq as SyncOptions, ar as SyncOptionsTuple, as as TERMINATOR, at as Target, au as Unflatten, av as UnionToIntersection, aw as UpdatePayload, ax as VERSION, ay as Volatile, az as Watcher, aA as WatcherRecord, W as WildPaths, aB as getRaw, aC as getSnapshotVersion, aD as getVersion, aE as inert, aF as intent, aG as isInert, aH as isIntent, aI as isVolatile, aJ as live, aK as methods, aL as reactive, aM as stable, aN as state, aO as volatile } from './index-CB-IiZIB.cjs';
+export { x as AddDepth, C as CTX, y as ChildPaths, z as DeepKeys, G as DeepMerge, H as DeepPartial, D as DeepReadonly, J as DeepRequired, K as Deleter, L as DeleterRecord, N as DepthConfig, O as DirectPayload, Q as EVT_OPTS, E as EffectOptions, S as Getter, T as GetterRecord, U as INDIFFABLE, V as INERTIA, I as Inert, X as Intent, Y as Listener, Z as ListenerOptions, _ as ListenerOptionsTuple, $ as ListenerRecord, a0 as Live, a1 as MaxDepth, a2 as NIL, a3 as NOOP, a4 as NextDepth, a5 as NoTraverse, a6 as PathBranch, a7 as PathBranchValue, a8 as PathDepth, a9 as PathKey, aa as PathLeaf, e as PathValue, P as Paths, ab as Payload, ac as PrevDepth, ad as Primitive, ae as RAW, af as REJECTABLE, b as REvent, ag as RTR_BATCH, ah as RTR_LOG, d as Reactive, ai as ReactivePreferences, R as Reactor, v as ReactorBuild, aj as ReactorEvent, ak as SSVERSION, al as Setter, am as SetterRecord, an as Stable, ao as State, ap as StrictPathKey, aq as SubtractDepth, ar as SyncOptions, as as SyncOptionsTuple, at as TERMINATOR, au as Target, av as Unflatten, aw as UnionToIntersection, ax as UpdatePayload, ay as VERSION, az as Volatile, aA as Watcher, aB as WatcherRecord, W as WildPaths, aC as getRaw, aD as getSnapshotVersion, aE as getVersion, aF as inert, aG as intent, aH as isInert, aI as isIntent, aJ as isVolatile, aK as live, aL as methods, aM as reactive, aN as stable, aO as state, aP as volatile } from './index-2jKy98op.cjs';

package/dist/index.d.ts

@@ -1 +1 @@
-export { x as AddDepth, C as CTX, y as ChildPaths, z as DeepKeys, G as DeepMerge, H as DeepPartial, D as DeepReadonly, J as DeepRequired, K as Deleter, L as DeleterRecord, M as DepthConfig, N as DirectPayload, O as EVT_OPTS, E as EffectOptions, Q as Getter, S as GetterRecord, T as INDIFFABLE, U as INERTIA, I as Inert, V as Intent, X as Listener, Y as ListenerOptions, Z as ListenerOptionsTuple, _ as ListenerRecord, $ as Live, a0 as MaxDepth, a1 as NIL, a2 as NOOP, a3 as NextDepth, a4 as NoTraverse, a5 as PathBranch, a6 as PathBranchValue, a7 as PathDepth, a8 as PathKey, a9 as PathLeaf, e as PathValue, P as Paths, aa as Payload, ab as PrevDepth, ac as Primitive, ad as RAW, ae as REJECTABLE, a as REvent, af as RTR_BATCH, ag as RTR_LOG, d as Reactive, ah as ReactivePreferences, R as Reactor, v as ReactorBuild, ai as ReactorEvent, aj as SSVERSION, ak as Setter, al as SetterRecord, am as Stable, an as State, ao as StrictPathKey, ap as SubtractDepth, aq as SyncOptions, ar as SyncOptionsTuple, as as TERMINATOR, at as Target, au as Unflatten, av as UnionToIntersection, aw as UpdatePayload, ax as VERSION, ay as Volatile, az as Watcher, aA as WatcherRecord, W as WildPaths, aB as getRaw, aC as getSnapshotVersion, aD as getVersion, aE as inert, aF as intent, aG as isInert, aH as isIntent, aI as isVolatile, aJ as live, aK as methods, aL as reactive, aM as stable, aN as state, aO as volatile } from './index-CB-IiZIB.js';
+export { x as AddDepth, C as CTX, y as ChildPaths, z as DeepKeys, G as DeepMerge, H as DeepPartial, D as DeepReadonly, J as DeepRequired, K as Deleter, L as DeleterRecord, N as DepthConfig, O as DirectPayload, Q as EVT_OPTS, E as EffectOptions, S as Getter, T as GetterRecord, U as INDIFFABLE, V as INERTIA, I as Inert, X as Intent, Y as Listener, Z as ListenerOptions, _ as ListenerOptionsTuple, $ as ListenerRecord, a0 as Live, a1 as MaxDepth, a2 as NIL, a3 as NOOP, a4 as NextDepth, a5 as NoTraverse, a6 as PathBranch, a7 as PathBranchValue, a8 as PathDepth, a9 as PathKey, aa as PathLeaf, e as PathValue, P as Paths, ab as Payload, ac as PrevDepth, ad as Primitive, ae as RAW, af as REJECTABLE, b as REvent, ag as RTR_BATCH, ah as RTR_LOG, d as Reactive, ai as ReactivePreferences, R as Reactor, v as ReactorBuild, aj as ReactorEvent, ak as SSVERSION, al as Setter, am as SetterRecord, an as Stable, ao as State, ap as StrictPathKey, aq as SubtractDepth, ar as SyncOptions, as as SyncOptionsTuple, at as TERMINATOR, au as Target, av as Unflatten, aw as UnionToIntersection, ax as UpdatePayload, ay as VERSION, az as Volatile, aA as Watcher, aB as WatcherRecord, W as WildPaths, aC as getRaw, aD as getSnapshotVersion, aE as getVersion, aF as inert, aG as intent, aH as isInert, aI as isIntent, aJ as isVolatile, aK as live, aL as methods, aM as reactive, aN as stable, aO as state, aP as volatile } from './index-2jKy98op.js';

package/dist/modules.cjs

@@ -1021,6 +1021,16 @@ var BaseReactorModule = class {
     return guardMethod(fn, (e) => this.rtrs.values().next().value?.log(`[Reactor "${this.name}" Module] Error: ${e}`));
   };
   // `()=>{}`: needs to be bounded even before initialization
+  /**
+   * Path resolution utility for modules, provides automatic reactor id resolution for multi-reactor setups.
+   * @param paths Paths to filter by, supports same formats as `ModulePaths`, will be resolved with the module's reactor id if applicable.
+   * @param target Reactor or reactor id to resolve paths for when using per-reactor path lists`.
+   * @returns Resolved paths array, defaults to `["*"]` if no paths are found using search criteria.
+   */
+  getPaths(paths, target) {
+    const rid = "object" === typeof target ? this.rids.get(target) : target;
+    return (paths && (Array.isArray(paths) ? paths : paths[String(rid)])) ?? wpArr;
+  }
 };
 
 // src/ts/utils/store.ts
@@ -1367,7 +1377,7 @@ var PersistModule = class extends BaseReactorModule {
   get payload() {
     let res = this.rtrs.size > 1 ? {} : void 0;
     for (const [rid, rtr] of this.rtrs) {
-      const snap = this.config.useSnapshot ? (this.config.useSnapshot === true && (rtr.config.referenceTracking = rtr.config.smartCloning = true), rtr.snapshot()) : rtr.core, val = this.config.paths ? this.config.paths.reduce((acc, p) => (setAny(acc, p, getAny(snap, p)), acc), {}) : snap;
+      const snap = this.config.useSnapshot ? (this.config.useSnapshot === true && (rtr.config.referenceTracking = rtr.config.smartCloning = true), rtr.snapshot()) : rtr.core, paths = this.getPaths(this.config.whitelist, rid), val = this.config.whitelist ? paths.reduce((acc, p) => (setAny(acc, p, getAny(snap, p)), acc), {}) : snap;
       this.rtrs.size > 1 ? setAny(res, rid, val) : res = val;
     }
     return res;
@@ -1380,10 +1390,10 @@ var PersistModule = class extends BaseReactorModule {
     "undefined" !== typeof document && document.addEventListener("visibilitychange", () => document.visibilityState === "hidden" && this.onDestroy(), { signal: this.signal });
     this.config.on("adapter", this.handleAdapter, { signal: this.signal, immediate: true });
     this.config.on("disabled", this.handleDisabled, { signal: this.signal, immediate: true });
-    this.config.on("paths", this.handlePaths, { signal: this.signal, immediate: true });
+    this.config.on("whitelist", this.handleWhitelist, { signal: this.signal, immediate: true });
   }
-  onAttach(rtr) {
-    for (const p of this.config.paths ?? wpArr) !this.config.disabled ? rtr.on(p, this.handleSave, { signal: this.signal, immediate: true }) : rtr.off(p, this.handleSave);
+  onAttach(rtr, rid) {
+    for (const p of this.getPaths(this.config.whitelist, rid)) !this.config.disabled ? rtr.on(p, this.save, { signal: this.signal, immediate: true }) : rtr.off(p, this.save);
   }
   async handleAdapter({ value = LocalStorageAdapter }) {
     const seq = ++this.hydrateSeq;
@@ -1397,27 +1407,29 @@ var PersistModule = class extends BaseReactorModule {
       saved = !isAsync ? saved : await saved;
       if (seq !== this.hydrateSeq || !saved) return;
       for (const [rid, rtr] of this.rtrs) {
+        const paths = this.getPaths(this.config.whitelist, rid);
         const entry = this.rtrs.size > 1 ? getAny(saved, rid) : saved;
         if (!entry) continue;
         const set = (p, news, olds) => (depth ? fanout : setAny)(rtr.core, p, merge ? mergeObjs(news, olds) : olds, depth ? { depth, crossRealms: rtr.config.crossRealms } : void 0);
-        for (const p of this.config.paths ?? wpArr) set(p, getAny(rtr.core, p), getAny(entry, p));
+        for (const p of this.config.whitelist ? paths : wpArr) set(p, getAny(rtr.core, p), getAny(entry, p));
       }
-      for (const rtr of this.rtrs.values()) rtr.tick(depth ? "*" : this.config.paths ?? "*");
+      for (const [rid, rtr] of this.rtrs) rtr.tick(depth ? "*" : this.config.whitelist ? this.getPaths(this.config.whitelist, rid) : "*");
     } finally {
       if (seq === this.hydrateSeq) this.state.hydrated = true;
     }
   }
   handleDisabled({ value }) {
-    for (const rtr of this.rtrs.values()) this.onAttach(rtr);
+    for (const [rid, rtr] of this.rtrs) this.onAttach(rtr, rid);
     value && this.adapter?.remove(this.config.key);
   }
-  handlePaths({ value: paths = wpArr, oldValue: prevs = wpArr }) {
-    for (const rtr of this.rtrs.values()) {
-      for (const p of prevs) rtr.off(p, this.handleSave);
-      for (const p of paths) rtr.off(p, this.handleSave), !this.config.disabled && rtr.on(p, this.handleSave, { signal: this.signal, immediate: true });
+  handleWhitelist({ value: paths, oldValue: prevs }) {
+    for (const [rid, rtr] of this.rtrs) {
+      for (const p of this.getPaths(prevs, rid)) rtr.off(p, this.save);
+      for (const p of this.getPaths(paths, rid)) rtr.off(p, this.save), !this.config.disabled && rtr.on(p, this.save, { signal: this.signal, immediate: true });
     }
   }
-  handleSave(e) {
+  save(e) {
+    if (this.config.blacklist && this.getPaths(this.config.blacklist, e.reactor).includes(e.path)) return;
     if (!this.state.hydrated) return e.stopImmediatePropagation();
     if (!this.saveTimeoutId) this.saveTimeoutId = setTimeout2(() => (this.adapter.set(this.config.key, this.payload), this.saveTimeoutId = 0), this.config.throttle, this.signal);
   }
@@ -1453,22 +1465,23 @@ var TimeTravelModule = class extends BaseReactorModule {
   wire() {
     this.lastTimestamp = performance.now();
     this.state.set("currentFrame", (v = 0) => clamp(0, v, this.state.history.length), { signal: this.signal, immediate: true });
-    this.config.on("paths", this.handlePaths, { signal: this.signal, immediate: true });
+    this.config.on("whitelist", this.handleWhitelist, { signal: this.signal, immediate: true });
     !this.state.paused && this.play();
   }
   onAttach(rtr, rid) {
     rtr.config.referenceTracking = rtr.config.smartCloning = rtr.config.eventTimeStamps = true;
     if (!this.state.history.length || !this.state.initialState[rid]) this.state.initialState[rid] = rtr.snapshot();
-    for (const p of this.config.paths ?? wpArr) rtr.on(p, this.record, { signal: this.signal });
+    for (const p of this.getPaths(this.config.whitelist, rid)) rtr.on(p, this.record, { signal: this.signal });
   }
-  handlePaths({ value: paths = wpArr, oldValue: prevs = wpArr }) {
-    for (const rtr of this.rtrs.values()) {
-      for (const p of prevs) rtr.off(p, this.record);
-      for (const p of paths) rtr.off(p, this.record), rtr.on(p, this.record, { signal: this.signal });
+  handleWhitelist({ value: paths, oldValue: prevs }) {
+    for (const [rid, rtr] of this.rtrs) {
+      for (const p of this.getPaths(prevs, rid)) rtr.off(p, this.record);
+      for (const p of this.getPaths(paths, rid)) rtr.off(p, this.record), rtr.on(p, this.record, { signal: this.signal });
     }
   }
   /** Chronicling the lifecycle of the system, Captures the essence of every mutation wave that bubbles up. */
   record(e, rid = this.rids.get(e.reactor)) {
+    if (this.getPaths(this.config.blacklist, rid).includes(e.path)) return;
     if (!this.state.paused) return;
     if (this.state.currentFrame < this.state.history.length) fanout(this.state, "history", this.state.history.slice(0, this.state.currentFrame), { atomic: true });
     if (this.state.history.length >= this.config.maxHistoryLength) fanout(this.state, "history", this.state.history.slice(1), { atomic: true });

package/dist/modules.d.cts

@@ -1,15 +1,19 @@
-import { P as Paths, I as Inert, F as FanoutTuple, B as BaseReactorModule, R as Reactor, a as REvent } from './index-CB-IiZIB.cjs';
-export { b as ReactorModuleConstructor, c as ReactorModuleId } from './index-CB-IiZIB.cjs';
-import { S as StorageAdapter, A as AsyncStorageAdapter, a as StorageAdapterConstructor, b as AsyncStorageAdapterConstructor } from './timeTravel-CEc3grUE.cjs';
-export { B as BaseStorageAdapter, C as COOKIE_ADAPTER_BUILD, c as CookieAdapter, d as CookieAdapterConfig, e as CookieOptions, H as HistoryEntry, I as INDEXED_DB_ADAPTER_BUILD, f as IndexedDBAdapter, g as IndexedDBAdapterConfig, J as JSONReplacer, h as JSONReviver, L as LocalStorageAdapter, M as MemoryAdapter, i as MemoryAdapterConfig, j as SessionStorageAdapter, k as StorageAdapterConfig, T as TIME_TRAVEL_MODULE_BUILD, l as TimeTravelConfig, m as TimeTravelModule, n as TimeTravelState } from './timeTravel-CEc3grUE.cjs';
+import { P as Paths, M as ModulePaths, I as Inert, F as FanoutTuple, B as BaseReactorModule, R as Reactor, a as ReactorModuleId, b as REvent } from './index-2jKy98op.cjs';
+export { c as ReactorModuleConstructor } from './index-2jKy98op.cjs';
+import { S as StorageAdapter, A as AsyncStorageAdapter, a as StorageAdapterConstructor, b as AsyncStorageAdapterConstructor } from './timeTravel-DzgX8BKQ.cjs';
+export { B as BaseStorageAdapter, C as COOKIE_ADAPTER_BUILD, c as CookieAdapter, d as CookieAdapterConfig, e as CookieOptions, H as HistoryEntry, I as INDEXED_DB_ADAPTER_BUILD, f as IndexedDBAdapter, g as IndexedDBAdapterConfig, J as JSONReplacer, h as JSONReviver, L as LocalStorageAdapter, M as MemoryAdapter, i as MemoryAdapterConfig, j as SessionStorageAdapter, k as StorageAdapterConfig, T as TIME_TRAVEL_MODULE_BUILD, l as TimeTravelConfig, m as TimeTravelModule, n as TimeTravelState } from './timeTravel-DzgX8BKQ.cjs';
 
 interface PersistConfig<T extends object, P extends Paths<T> = Paths<T>> {
     /** Whether the persistence is disabled and cleared */
     disabled: boolean;
     /** The key under which to store the persisted data */
     key: string;
-    /** Specific paths only, no need for "*"; instead don't pass anything */
-    paths: P[];
+    /** Whitelist paths only, no need for "*"; instead don't pass anything.
+     * - `P[]`: one shared path list for all attached reactors.
+     * - `Record<string, P[]>`: per-reactor path lists keyed by module reactor id. If you don't pass ids in `.attach()`, use implicit index keys (`"0"`, `"1"`, ...). */
+    whitelist: ModulePaths<P>;
+    /** Exclude filter for save-trigger paths. Checked only during save events. */
+    blacklist?: ModulePaths<P>;
     /** Storage adapter class or instance to use, can satisfy `instanceof` or just definition, cast to `any` if the latter */
     adapter: Inert<StorageAdapter> | Inert<AsyncStorageAdapter> | Inert<StorageAdapterConstructor> | Inert<AsyncStorageAdapterConstructor>;
     /** Throttle time for saving changes */
@@ -38,15 +42,15 @@ declare class PersistModule<T extends object = any, P extends Paths<T> = Paths<T
     get payload(): Record<string, any> | undefined;
     constructor(config?: Partial<PersistConfig<T, P>>, rtr?: Reactor<T>);
     wire(): void;
-    protected onAttach(rtr: Reactor<any>): void;
+    protected onAttach(rtr: Reactor<any>, rid: ReactorModuleId): void;
     protected handleAdapter({ value }: REvent<PersistConfig<T, P>, "adapter">): Promise<void>;
     protected handleDisabled({ value }: REvent<PersistConfig<T, P>, "disabled">): void;
-    protected handlePaths({ value: paths, oldValue: prevs }: REvent<PersistConfig<T, P>, "paths">): void;
-    protected handleSave(e: REvent<any, P>): void;
+    protected handleWhitelist({ value: paths, oldValue: prevs }: REvent<PersistConfig<T, P>, "whitelist">): void;
+    protected save(e: REvent<any, P>): void;
     /** Clears persisted payload for this module instance and drops any pending save. */
     clear(): void;
     protected onDestroy(): void;
 }
 declare const PERSIST_MODULE_BUILD: Partial<PersistConfig<any>>;
 
-export { AsyncStorageAdapter, AsyncStorageAdapterConstructor, BaseReactorModule, PERSIST_MODULE_BUILD, type PersistConfig, PersistModule, StorageAdapter, StorageAdapterConstructor };
+export { AsyncStorageAdapter, AsyncStorageAdapterConstructor, BaseReactorModule, ModulePaths, PERSIST_MODULE_BUILD, type PersistConfig, PersistModule, ReactorModuleId, StorageAdapter, StorageAdapterConstructor };

package/dist/modules.d.ts

@@ -1,15 +1,19 @@
-import { P as Paths, I as Inert, F as FanoutTuple, B as BaseReactorModule, R as Reactor, a as REvent } from './index-CB-IiZIB.js';
-export { b as ReactorModuleConstructor, c as ReactorModuleId } from './index-CB-IiZIB.js';
-import { S as StorageAdapter, A as AsyncStorageAdapter, a as StorageAdapterConstructor, b as AsyncStorageAdapterConstructor } from './timeTravel-D7NiYqdD.js';
-export { B as BaseStorageAdapter, C as COOKIE_ADAPTER_BUILD, c as CookieAdapter, d as CookieAdapterConfig, e as CookieOptions, H as HistoryEntry, I as INDEXED_DB_ADAPTER_BUILD, f as IndexedDBAdapter, g as IndexedDBAdapterConfig, J as JSONReplacer, h as JSONReviver, L as LocalStorageAdapter, M as MemoryAdapter, i as MemoryAdapterConfig, j as SessionStorageAdapter, k as StorageAdapterConfig, T as TIME_TRAVEL_MODULE_BUILD, l as TimeTravelConfig, m as TimeTravelModule, n as TimeTravelState } from './timeTravel-D7NiYqdD.js';
+import { P as Paths, M as ModulePaths, I as Inert, F as FanoutTuple, B as BaseReactorModule, R as Reactor, a as ReactorModuleId, b as REvent } from './index-2jKy98op.js';
+export { c as ReactorModuleConstructor } from './index-2jKy98op.js';
+import { S as StorageAdapter, A as AsyncStorageAdapter, a as StorageAdapterConstructor, b as AsyncStorageAdapterConstructor } from './timeTravel-CsbQ8qhP.js';
+export { B as BaseStorageAdapter, C as COOKIE_ADAPTER_BUILD, c as CookieAdapter, d as CookieAdapterConfig, e as CookieOptions, H as HistoryEntry, I as INDEXED_DB_ADAPTER_BUILD, f as IndexedDBAdapter, g as IndexedDBAdapterConfig, J as JSONReplacer, h as JSONReviver, L as LocalStorageAdapter, M as MemoryAdapter, i as MemoryAdapterConfig, j as SessionStorageAdapter, k as StorageAdapterConfig, T as TIME_TRAVEL_MODULE_BUILD, l as TimeTravelConfig, m as TimeTravelModule, n as TimeTravelState } from './timeTravel-CsbQ8qhP.js';
 
 interface PersistConfig<T extends object, P extends Paths<T> = Paths<T>> {
     /** Whether the persistence is disabled and cleared */
     disabled: boolean;
     /** The key under which to store the persisted data */
     key: string;
-    /** Specific paths only, no need for "*"; instead don't pass anything */
-    paths: P[];
+    /** Whitelist paths only, no need for "*"; instead don't pass anything.
+     * - `P[]`: one shared path list for all attached reactors.
+     * - `Record<string, P[]>`: per-reactor path lists keyed by module reactor id. If you don't pass ids in `.attach()`, use implicit index keys (`"0"`, `"1"`, ...). */
+    whitelist: ModulePaths<P>;
+    /** Exclude filter for save-trigger paths. Checked only during save events. */
+    blacklist?: ModulePaths<P>;
     /** Storage adapter class or instance to use, can satisfy `instanceof` or just definition, cast to `any` if the latter */
     adapter: Inert<StorageAdapter> | Inert<AsyncStorageAdapter> | Inert<StorageAdapterConstructor> | Inert<AsyncStorageAdapterConstructor>;
     /** Throttle time for saving changes */
@@ -38,15 +42,15 @@ declare class PersistModule<T extends object = any, P extends Paths<T> = Paths<T
     get payload(): Record<string, any> | undefined;
     constructor(config?: Partial<PersistConfig<T, P>>, rtr?: Reactor<T>);
     wire(): void;
-    protected onAttach(rtr: Reactor<any>): void;
+    protected onAttach(rtr: Reactor<any>, rid: ReactorModuleId): void;
     protected handleAdapter({ value }: REvent<PersistConfig<T, P>, "adapter">): Promise<void>;
     protected handleDisabled({ value }: REvent<PersistConfig<T, P>, "disabled">): void;
-    protected handlePaths({ value: paths, oldValue: prevs }: REvent<PersistConfig<T, P>, "paths">): void;
-    protected handleSave(e: REvent<any, P>): void;
+    protected handleWhitelist({ value: paths, oldValue: prevs }: REvent<PersistConfig<T, P>, "whitelist">): void;
+    protected save(e: REvent<any, P>): void;
     /** Clears persisted payload for this module instance and drops any pending save. */
     clear(): void;
     protected onDestroy(): void;
 }
 declare const PERSIST_MODULE_BUILD: Partial<PersistConfig<any>>;
 
-export { AsyncStorageAdapter, AsyncStorageAdapterConstructor, BaseReactorModule, PERSIST_MODULE_BUILD, type PersistConfig, PersistModule, StorageAdapter, StorageAdapterConstructor };
+export { AsyncStorageAdapter, AsyncStorageAdapterConstructor, BaseReactorModule, ModulePaths, PERSIST_MODULE_BUILD, type PersistConfig, PersistModule, ReactorModuleId, StorageAdapter, StorageAdapterConstructor };

package/dist/modules.js

@@ -88,6 +88,16 @@ var BaseReactorModule = class {
     return guardMethod(fn, (e) => this.rtrs.values().next().value?.log(`[Reactor "${this.name}" Module] Error: ${e}`));
   };
   // `()=>{}`: needs to be bounded even before initialization
+  /**
+   * Path resolution utility for modules, provides automatic reactor id resolution for multi-reactor setups.
+   * @param paths Paths to filter by, supports same formats as `ModulePaths`, will be resolved with the module's reactor id if applicable.
+   * @param target Reactor or reactor id to resolve paths for when using per-reactor path lists`.
+   * @returns Resolved paths array, defaults to `["*"]` if no paths are found using search criteria.
+   */
+  getPaths(paths, target) {
+    const rid = "object" === typeof target ? this.rids.get(target) : target;
+    return (paths && (Array.isArray(paths) ? paths : paths[String(rid)])) ?? wpArr;
+  }
 };
 
 // src/ts/utils/store.ts
@@ -424,7 +434,7 @@ var PersistModule = class extends BaseReactorModule {
   get payload() {
     let res = this.rtrs.size > 1 ? {} : void 0;
     for (const [rid, rtr] of this.rtrs) {
-      const snap = this.config.useSnapshot ? (this.config.useSnapshot === true && (rtr.config.referenceTracking = rtr.config.smartCloning = true), rtr.snapshot()) : rtr.core, val = this.config.paths ? this.config.paths.reduce((acc, p) => (setAny(acc, p, getAny(snap, p)), acc), {}) : snap;
+      const snap = this.config.useSnapshot ? (this.config.useSnapshot === true && (rtr.config.referenceTracking = rtr.config.smartCloning = true), rtr.snapshot()) : rtr.core, paths = this.getPaths(this.config.whitelist, rid), val = this.config.whitelist ? paths.reduce((acc, p) => (setAny(acc, p, getAny(snap, p)), acc), {}) : snap;
       this.rtrs.size > 1 ? setAny(res, rid, val) : res = val;
     }
     return res;
@@ -437,10 +447,10 @@ var PersistModule = class extends BaseReactorModule {
     "undefined" !== typeof document && document.addEventListener("visibilitychange", () => document.visibilityState === "hidden" && this.onDestroy(), { signal: this.signal });
     this.config.on("adapter", this.handleAdapter, { signal: this.signal, immediate: true });
     this.config.on("disabled", this.handleDisabled, { signal: this.signal, immediate: true });
-    this.config.on("paths", this.handlePaths, { signal: this.signal, immediate: true });
+    this.config.on("whitelist", this.handleWhitelist, { signal: this.signal, immediate: true });
   }
-  onAttach(rtr) {
-    for (const p of this.config.paths ?? wpArr) !this.config.disabled ? rtr.on(p, this.handleSave, { signal: this.signal, immediate: true }) : rtr.off(p, this.handleSave);
+  onAttach(rtr, rid) {
+    for (const p of this.getPaths(this.config.whitelist, rid)) !this.config.disabled ? rtr.on(p, this.save, { signal: this.signal, immediate: true }) : rtr.off(p, this.save);
   }
   async handleAdapter({ value = LocalStorageAdapter }) {
     const seq = ++this.hydrateSeq;
@@ -454,27 +464,29 @@ var PersistModule = class extends BaseReactorModule {
       saved = !isAsync ? saved : await saved;
       if (seq !== this.hydrateSeq || !saved) return;
       for (const [rid, rtr] of this.rtrs) {
+        const paths = this.getPaths(this.config.whitelist, rid);
         const entry = this.rtrs.size > 1 ? getAny(saved, rid) : saved;
         if (!entry) continue;
         const set = (p, news, olds) => (depth ? fanout : setAny)(rtr.core, p, merge ? mergeObjs(news, olds) : olds, depth ? { depth, crossRealms: rtr.config.crossRealms } : void 0);
-        for (const p of this.config.paths ?? wpArr) set(p, getAny(rtr.core, p), getAny(entry, p));
+        for (const p of this.config.whitelist ? paths : wpArr) set(p, getAny(rtr.core, p), getAny(entry, p));
       }
-      for (const rtr of this.rtrs.values()) rtr.tick(depth ? "*" : this.config.paths ?? "*");
+      for (const [rid, rtr] of this.rtrs) rtr.tick(depth ? "*" : this.config.whitelist ? this.getPaths(this.config.whitelist, rid) : "*");
     } finally {
       if (seq === this.hydrateSeq) this.state.hydrated = true;
     }
   }
   handleDisabled({ value }) {
-    for (const rtr of this.rtrs.values()) this.onAttach(rtr);
+    for (const [rid, rtr] of this.rtrs) this.onAttach(rtr, rid);
     value && this.adapter?.remove(this.config.key);
   }
-  handlePaths({ value: paths = wpArr, oldValue: prevs = wpArr }) {
-    for (const rtr of this.rtrs.values()) {
-      for (const p of prevs) rtr.off(p, this.handleSave);
-      for (const p of paths) rtr.off(p, this.handleSave), !this.config.disabled && rtr.on(p, this.handleSave, { signal: this.signal, immediate: true });
+  handleWhitelist({ value: paths, oldValue: prevs }) {
+    for (const [rid, rtr] of this.rtrs) {
+      for (const p of this.getPaths(prevs, rid)) rtr.off(p, this.save);
+      for (const p of this.getPaths(paths, rid)) rtr.off(p, this.save), !this.config.disabled && rtr.on(p, this.save, { signal: this.signal, immediate: true });
     }
   }
-  handleSave(e) {
+  save(e) {
+    if (this.config.blacklist && this.getPaths(this.config.blacklist, e.reactor).includes(e.path)) return;
     if (!this.state.hydrated) return e.stopImmediatePropagation();
     if (!this.saveTimeoutId) this.saveTimeoutId = setTimeout(() => (this.adapter.set(this.config.key, this.payload), this.saveTimeoutId = 0), this.config.throttle, this.signal);
   }
@@ -505,22 +517,23 @@ var TimeTravelModule = class extends BaseReactorModule {
   wire() {
     this.lastTimestamp = performance.now();
     this.state.set("currentFrame", (v = 0) => clamp(0, v, this.state.history.length), { signal: this.signal, immediate: true });
-    this.config.on("paths", this.handlePaths, { signal: this.signal, immediate: true });
+    this.config.on("whitelist", this.handleWhitelist, { signal: this.signal, immediate: true });
     !this.state.paused && this.play();
   }
   onAttach(rtr, rid) {
     rtr.config.referenceTracking = rtr.config.smartCloning = rtr.config.eventTimeStamps = true;
     if (!this.state.history.length || !this.state.initialState[rid]) this.state.initialState[rid] = rtr.snapshot();
-    for (const p of this.config.paths ?? wpArr) rtr.on(p, this.record, { signal: this.signal });
+    for (const p of this.getPaths(this.config.whitelist, rid)) rtr.on(p, this.record, { signal: this.signal });
   }
-  handlePaths({ value: paths = wpArr, oldValue: prevs = wpArr }) {
-    for (const rtr of this.rtrs.values()) {
-      for (const p of prevs) rtr.off(p, this.record);
-      for (const p of paths) rtr.off(p, this.record), rtr.on(p, this.record, { signal: this.signal });
+  handleWhitelist({ value: paths, oldValue: prevs }) {
+    for (const [rid, rtr] of this.rtrs) {
+      for (const p of this.getPaths(prevs, rid)) rtr.off(p, this.record);
+      for (const p of this.getPaths(paths, rid)) rtr.off(p, this.record), rtr.on(p, this.record, { signal: this.signal });
     }
   }
   /** Chronicling the lifecycle of the system, Captures the essence of every mutation wave that bubbles up. */
   record(e, rid = this.rids.get(e.reactor)) {
+    if (this.getPaths(this.config.blacklist, rid).includes(e.path)) return;
     if (!this.state.paused) return;
     if (this.state.currentFrame < this.state.history.length) fanout(this.state, "history", this.state.history.slice(0, this.state.currentFrame), { atomic: true });
     if (this.state.history.length >= this.config.maxHistoryLength) fanout(this.state, "history", this.state.history.slice(1), { atomic: true });

package/dist/super.d.ts

@@ -816,6 +816,7 @@ declare function deepClone<T>(obj: T, config?: {
 declare function nuke(target: any): void;
 
 type ReactorModuleId = string | number;
+type ModulePaths<P extends string = string> = P[] | Partial<Record<string, P[]>>;
 interface ReactorModuleConstructor<P extends BaseReactorModule = BaseReactorModule, T extends object = any> {
     new (rtr: Reactor<T>, config: any): P;
     moduleName: string;
@@ -873,6 +874,13 @@ declare abstract class BaseReactorModule<T extends object = any, Config = any, S
      * window.addEventListener("resize", this.guard(() => this.syncLayout(true)), { signal: this.signal });
      */
     guard: <Fn extends Function>(fn: Fn) => Fn;
+    /**
+     * Path resolution utility for modules, provides automatic reactor id resolution for multi-reactor setups.
+     * @param paths Paths to filter by, supports same formats as `ModulePaths`, will be resolved with the module's reactor id if applicable.
+     * @param target Reactor or reactor id to resolve paths for when using per-reactor path lists`.
+     * @returns Resolved paths array, defaults to `["*"]` if no paths are found using search criteria.
+     */
+    protected getPaths<P extends string = string>(paths?: ModulePaths<P>, target?: Reactor<any> | ReactorModuleId): P[];
 }
 
 /**
@@ -1686,8 +1694,12 @@ interface PersistConfig<T extends object, P extends Paths<T> = Paths<T>> {
     disabled: boolean;
     /** The key under which to store the persisted data */
     key: string;
-    /** Specific paths only, no need for "*"; instead don't pass anything */
-    paths: P[];
+    /** Whitelist paths only, no need for "*"; instead don't pass anything.
+     * - `P[]`: one shared path list for all attached reactors.
+     * - `Record<string, P[]>`: per-reactor path lists keyed by module reactor id. If you don't pass ids in `.attach()`, use implicit index keys (`"0"`, `"1"`, ...). */
+    whitelist: ModulePaths<P>;
+    /** Exclude filter for save-trigger paths. Checked only during save events. */
+    blacklist?: ModulePaths<P>;
     /** Storage adapter class or instance to use, can satisfy `instanceof` or just definition, cast to `any` if the latter */
     adapter: Inert<StorageAdapter> | Inert<AsyncStorageAdapter> | Inert<StorageAdapterConstructor> | Inert<AsyncStorageAdapterConstructor>;
     /** Throttle time for saving changes */
@@ -1716,11 +1728,11 @@ declare class PersistModule<T extends object = any, P extends Paths<T> = Paths<T
     get payload(): Record<string, any> | undefined;
     constructor(config?: Partial<PersistConfig<T, P>>, rtr?: Reactor<T>);
     wire(): void;
-    protected onAttach(rtr: Reactor<any>): void;
+    protected onAttach(rtr: Reactor<any>, rid: ReactorModuleId): void;
     protected handleAdapter({ value }: REvent<PersistConfig<T, P>, "adapter">): Promise<void>;
     protected handleDisabled({ value }: REvent<PersistConfig<T, P>, "disabled">): void;
-    protected handlePaths({ value: paths, oldValue: prevs }: REvent<PersistConfig<T, P>, "paths">): void;
-    protected handleSave(e: REvent<any, P>): void;
+    protected handleWhitelist({ value: paths, oldValue: prevs }: REvent<PersistConfig<T, P>, "whitelist">): void;
+    protected save(e: REvent<any, P>): void;
     /** Clears persisted payload for this module instance and drops any pending save. */
     clear(): void;
     protected onDestroy(): void;
@@ -1747,8 +1759,12 @@ interface HistoryEntry<T extends object = any, P extends Paths<T> = Paths<T>> {
     rid: ReactorModuleId;
 }
 interface TimeTravelConfig<T extends object, P extends Paths<T> = Paths<T>> {
-    /** Specific paths only, no "*"; instead don't pass anything */
-    paths: P[];
+    /** Whitelist paths only, no need for "*"; instead don't pass anything.
+     * - `P[]`: one shared path list for all attached reactors.
+     * - `Record<string, P[]>`: per-reactor path lists keyed by module reactor id. If you don't pass ids in `.attach()`, use implicit index keys (`"0"`, `"1"`, ...). */
+    whitelist: ModulePaths<P>;
+    /** Exclude filter for recorded paths. Checked only during record events. */
+    blacklist?: ModulePaths<P>;
     /** Maximum number of history entries to keep (Memory Cap), you lose replaying Sessions or the Genesis */
     maxHistoryLength: number;
     /** Max delay between events during playback (ms) */
@@ -1779,7 +1795,7 @@ declare class TimeTravelModule<T extends object = any, P extends Paths<T> = Path
     constructor(config?: Partial<TimeTravelConfig<T, P>>, rtr?: Reactor<T>);
     wire(): void;
     protected onAttach(rtr: Reactor<any>, rid: ReactorModuleId): void;
-    protected handlePaths({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<T, P>, "paths">): void;
+    protected handleWhitelist({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<T, P>, "whitelist">): void;
     /** Chronicling the lifecycle of the system, Captures the essence of every mutation wave that bubbles up. */
     protected record(e: REvent<any, P>, rid?: ReactorModuleId): void;
     /** Clears timeline history and resets playhead/genesis to the current reactor state. */
@@ -1831,6 +1847,7 @@ declare const modules_LocalStorageAdapter: typeof LocalStorageAdapter;
 type modules_MemoryAdapter = MemoryAdapter;
 declare const modules_MemoryAdapter: typeof MemoryAdapter;
 type modules_MemoryAdapterConfig = MemoryAdapterConfig;
+type modules_ModulePaths<P extends string = string> = ModulePaths<P>;
 declare const modules_PERSIST_MODULE_BUILD: typeof PERSIST_MODULE_BUILD;
 type modules_PersistConfig<T extends object, P extends Paths<T> = Paths<T>> = PersistConfig<T, P>;
 type modules_PersistModule<T extends object = any, P extends Paths<T> = Paths<T>> = PersistModule<T, P>;
@@ -1849,7 +1866,7 @@ type modules_TimeTravelModule<T extends object = any, P extends Paths<T> = Paths
 declare const modules_TimeTravelModule: typeof TimeTravelModule;
 type modules_TimeTravelState<T extends object, P extends Paths<T> = Paths<T>> = TimeTravelState<T, P>;
 declare namespace modules {
-  export { modules_AsyncStorageAdapter as AsyncStorageAdapter, type modules_AsyncStorageAdapterConstructor as AsyncStorageAdapterConstructor, modules_BaseReactorModule as BaseReactorModule, modules_BaseStorageAdapter as BaseStorageAdapter, modules_COOKIE_ADAPTER_BUILD as COOKIE_ADAPTER_BUILD, modules_CookieAdapter as CookieAdapter, type modules_CookieAdapterConfig as CookieAdapterConfig, type modules_CookieOptions as CookieOptions, type modules_HistoryEntry as HistoryEntry, modules_INDEXED_DB_ADAPTER_BUILD as INDEXED_DB_ADAPTER_BUILD, modules_IndexedDBAdapter as IndexedDBAdapter, type modules_IndexedDBAdapterConfig as IndexedDBAdapterConfig, type modules_JSONReplacer as JSONReplacer, type modules_JSONReviver as JSONReviver, modules_LocalStorageAdapter as LocalStorageAdapter, modules_MemoryAdapter as MemoryAdapter, type modules_MemoryAdapterConfig as MemoryAdapterConfig, modules_PERSIST_MODULE_BUILD as PERSIST_MODULE_BUILD, type modules_PersistConfig as PersistConfig, modules_PersistModule as PersistModule, type modules_ReactorModuleConstructor as ReactorModuleConstructor, type modules_ReactorModuleId as ReactorModuleId, modules_SessionStorageAdapter as SessionStorageAdapter, modules_StorageAdapter as StorageAdapter, type modules_StorageAdapterConfig as StorageAdapterConfig, type modules_StorageAdapterConstructor as StorageAdapterConstructor, modules_TIME_TRAVEL_MODULE_BUILD as TIME_TRAVEL_MODULE_BUILD, type modules_TimeTravelConfig as TimeTravelConfig, modules_TimeTravelModule as TimeTravelModule, type modules_TimeTravelState as TimeTravelState };
+  export { modules_AsyncStorageAdapter as AsyncStorageAdapter, type modules_AsyncStorageAdapterConstructor as AsyncStorageAdapterConstructor, modules_BaseReactorModule as BaseReactorModule, modules_BaseStorageAdapter as BaseStorageAdapter, modules_COOKIE_ADAPTER_BUILD as COOKIE_ADAPTER_BUILD, modules_CookieAdapter as CookieAdapter, type modules_CookieAdapterConfig as CookieAdapterConfig, type modules_CookieOptions as CookieOptions, type modules_HistoryEntry as HistoryEntry, modules_INDEXED_DB_ADAPTER_BUILD as INDEXED_DB_ADAPTER_BUILD, modules_IndexedDBAdapter as IndexedDBAdapter, type modules_IndexedDBAdapterConfig as IndexedDBAdapterConfig, type modules_JSONReplacer as JSONReplacer, type modules_JSONReviver as JSONReviver, modules_LocalStorageAdapter as LocalStorageAdapter, modules_MemoryAdapter as MemoryAdapter, type modules_MemoryAdapterConfig as MemoryAdapterConfig, type modules_ModulePaths as ModulePaths, modules_PERSIST_MODULE_BUILD as PERSIST_MODULE_BUILD, type modules_PersistConfig as PersistConfig, modules_PersistModule as PersistModule, type modules_ReactorModuleConstructor as ReactorModuleConstructor, type modules_ReactorModuleId as ReactorModuleId, modules_SessionStorageAdapter as SessionStorageAdapter, modules_StorageAdapter as StorageAdapter, type modules_StorageAdapterConfig as StorageAdapterConfig, type modules_StorageAdapterConstructor as StorageAdapterConstructor, modules_TIME_TRAVEL_MODULE_BUILD as TIME_TRAVEL_MODULE_BUILD, type modules_TimeTravelConfig as TimeTravelConfig, modules_TimeTravelModule as TimeTravelModule, type modules_TimeTravelState as TimeTravelState };
 }
 
 /**

package/dist/super.global.js

@@ -1256,6 +1256,16 @@ var sia = (() => {
       return guardMethod(fn, (e) => this.rtrs.values().next().value?.log(`[Reactor "${this.name}" Module] Error: ${e}`));
     };
     // `()=>{}`: needs to be bounded even before initialization
+    /**
+     * Path resolution utility for modules, provides automatic reactor id resolution for multi-reactor setups.
+     * @param paths Paths to filter by, supports same formats as `ModulePaths`, will be resolved with the module's reactor id if applicable.
+     * @param target Reactor or reactor id to resolve paths for when using per-reactor path lists`.
+     * @returns Resolved paths array, defaults to `["*"]` if no paths are found using search criteria.
+     */
+    getPaths(paths, target) {
+      const rid = "object" === typeof target ? this.rids.get(target) : target;
+      return (paths && (Array.isArray(paths) ? paths : paths[String(rid)])) ?? wpArr;
+    }
   };
 
   // src/ts/utils/store.ts
@@ -1592,7 +1602,7 @@ var sia = (() => {
     get payload() {
       let res = this.rtrs.size > 1 ? {} : void 0;
       for (const [rid, rtr] of this.rtrs) {
-        const snap = this.config.useSnapshot ? (this.config.useSnapshot === true && (rtr.config.referenceTracking = rtr.config.smartCloning = true), rtr.snapshot()) : rtr.core, val = this.config.paths ? this.config.paths.reduce((acc, p) => (setAny(acc, p, getAny(snap, p)), acc), {}) : snap;
+        const snap = this.config.useSnapshot ? (this.config.useSnapshot === true && (rtr.config.referenceTracking = rtr.config.smartCloning = true), rtr.snapshot()) : rtr.core, paths = this.getPaths(this.config.whitelist, rid), val = this.config.whitelist ? paths.reduce((acc, p) => (setAny(acc, p, getAny(snap, p)), acc), {}) : snap;
         this.rtrs.size > 1 ? setAny(res, rid, val) : res = val;
       }
       return res;
@@ -1605,10 +1615,10 @@ var sia = (() => {
       "undefined" !== typeof document && document.addEventListener("visibilitychange", () => document.visibilityState === "hidden" && this.onDestroy(), { signal: this.signal });
       this.config.on("adapter", this.handleAdapter, { signal: this.signal, immediate: true });
       this.config.on("disabled", this.handleDisabled, { signal: this.signal, immediate: true });
-      this.config.on("paths", this.handlePaths, { signal: this.signal, immediate: true });
+      this.config.on("whitelist", this.handleWhitelist, { signal: this.signal, immediate: true });
     }
-    onAttach(rtr) {
-      for (const p of this.config.paths ?? wpArr) !this.config.disabled ? rtr.on(p, this.handleSave, { signal: this.signal, immediate: true }) : rtr.off(p, this.handleSave);
+    onAttach(rtr, rid) {
+      for (const p of this.getPaths(this.config.whitelist, rid)) !this.config.disabled ? rtr.on(p, this.save, { signal: this.signal, immediate: true }) : rtr.off(p, this.save);
     }
     async handleAdapter({ value = LocalStorageAdapter }) {
       const seq = ++this.hydrateSeq;
@@ -1622,27 +1632,29 @@ var sia = (() => {
         saved = !isAsync ? saved : await saved;
         if (seq !== this.hydrateSeq || !saved) return;
         for (const [rid, rtr] of this.rtrs) {
+          const paths = this.getPaths(this.config.whitelist, rid);
           const entry = this.rtrs.size > 1 ? getAny(saved, rid) : saved;
           if (!entry) continue;
           const set = (p, news, olds) => (depth ? fanout : setAny)(rtr.core, p, merge ? mergeObjs(news, olds) : olds, depth ? { depth, crossRealms: rtr.config.crossRealms } : void 0);
-          for (const p of this.config.paths ?? wpArr) set(p, getAny(rtr.core, p), getAny(entry, p));
+          for (const p of this.config.whitelist ? paths : wpArr) set(p, getAny(rtr.core, p), getAny(entry, p));
         }
-        for (const rtr of this.rtrs.values()) rtr.tick(depth ? "*" : this.config.paths ?? "*");
+        for (const [rid, rtr] of this.rtrs) rtr.tick(depth ? "*" : this.config.whitelist ? this.getPaths(this.config.whitelist, rid) : "*");
       } finally {
         if (seq === this.hydrateSeq) this.state.hydrated = true;
       }
     }
     handleDisabled({ value }) {
-      for (const rtr of this.rtrs.values()) this.onAttach(rtr);
+      for (const [rid, rtr] of this.rtrs) this.onAttach(rtr, rid);
       value && this.adapter?.remove(this.config.key);
     }
-    handlePaths({ value: paths = wpArr, oldValue: prevs = wpArr }) {
-      for (const rtr of this.rtrs.values()) {
-        for (const p of prevs) rtr.off(p, this.handleSave);
-        for (const p of paths) rtr.off(p, this.handleSave), !this.config.disabled && rtr.on(p, this.handleSave, { signal: this.signal, immediate: true });
+    handleWhitelist({ value: paths, oldValue: prevs }) {
+      for (const [rid, rtr] of this.rtrs) {
+        for (const p of this.getPaths(prevs, rid)) rtr.off(p, this.save);
+        for (const p of this.getPaths(paths, rid)) rtr.off(p, this.save), !this.config.disabled && rtr.on(p, this.save, { signal: this.signal, immediate: true });
       }
     }
-    handleSave(e) {
+    save(e) {
+      if (this.config.blacklist && this.getPaths(this.config.blacklist, e.reactor).includes(e.path)) return;
       if (!this.state.hydrated) return e.stopImmediatePropagation();
       if (!this.saveTimeoutId) this.saveTimeoutId = setTimeout2(() => (this.adapter.set(this.config.key, this.payload), this.saveTimeoutId = 0), this.config.throttle, this.signal);
     }
@@ -1673,22 +1685,23 @@ var sia = (() => {
     wire() {
       this.lastTimestamp = performance.now();
       this.state.set("currentFrame", (v = 0) => clamp(0, v, this.state.history.length), { signal: this.signal, immediate: true });
-      this.config.on("paths", this.handlePaths, { signal: this.signal, immediate: true });
+      this.config.on("whitelist", this.handleWhitelist, { signal: this.signal, immediate: true });
       !this.state.paused && this.play();
     }
     onAttach(rtr, rid) {
       rtr.config.referenceTracking = rtr.config.smartCloning = rtr.config.eventTimeStamps = true;
       if (!this.state.history.length || !this.state.initialState[rid]) this.state.initialState[rid] = rtr.snapshot();
-      for (const p of this.config.paths ?? wpArr) rtr.on(p, this.record, { signal: this.signal });
+      for (const p of this.getPaths(this.config.whitelist, rid)) rtr.on(p, this.record, { signal: this.signal });
     }
-    handlePaths({ value: paths = wpArr, oldValue: prevs = wpArr }) {
-      for (const rtr of this.rtrs.values()) {
-        for (const p of prevs) rtr.off(p, this.record);
-        for (const p of paths) rtr.off(p, this.record), rtr.on(p, this.record, { signal: this.signal });
+    handleWhitelist({ value: paths, oldValue: prevs }) {
+      for (const [rid, rtr] of this.rtrs) {
+        for (const p of this.getPaths(prevs, rid)) rtr.off(p, this.record);
+        for (const p of this.getPaths(paths, rid)) rtr.off(p, this.record), rtr.on(p, this.record, { signal: this.signal });
       }
     }
     /** Chronicling the lifecycle of the system, Captures the essence of every mutation wave that bubbles up. */
     record(e, rid = this.rids.get(e.reactor)) {
+      if (this.getPaths(this.config.blacklist, rid).includes(e.path)) return;
       if (!this.state.paused) return;
       if (this.state.currentFrame < this.state.history.length) fanout(this.state, "history", this.state.history.slice(0, this.state.currentFrame), { atomic: true });
       if (this.state.history.length >= this.config.maxHistoryLength) fanout(this.state, "history", this.state.history.slice(1), { atomic: true });

package/dist/{timeTravel-CEc3grUE.d.cts → timeTravel-CsbQ8qhP.d.ts}

@@ -1,4 +1,4 @@
-import { P as Paths, e as PathValue, a as REvent, c as ReactorModuleId, B as BaseReactorModule, R as Reactor } from './index-CB-IiZIB.cjs';
+import { P as Paths, e as PathValue, b as REvent, a as ReactorModuleId, M as ModulePaths, B as BaseReactorModule, R as Reactor } from './index-2jKy98op.js';
 
 type JSONReplacer = ((this: any, key: string, value: any) => any) | (number | string)[] | null;
 type JSONReviver = ((this: any, key: string, value: any) => any) | undefined;
@@ -289,8 +289,12 @@ interface HistoryEntry<T extends object = any, P extends Paths<T> = Paths<T>> {
     rid: ReactorModuleId;
 }
 interface TimeTravelConfig<T extends object, P extends Paths<T> = Paths<T>> {
-    /** Specific paths only, no "*"; instead don't pass anything */
-    paths: P[];
+    /** Whitelist paths only, no need for "*"; instead don't pass anything.
+     * - `P[]`: one shared path list for all attached reactors.
+     * - `Record<string, P[]>`: per-reactor path lists keyed by module reactor id. If you don't pass ids in `.attach()`, use implicit index keys (`"0"`, `"1"`, ...). */
+    whitelist: ModulePaths<P>;
+    /** Exclude filter for recorded paths. Checked only during record events. */
+    blacklist?: ModulePaths<P>;
     /** Maximum number of history entries to keep (Memory Cap), you lose replaying Sessions or the Genesis */
     maxHistoryLength: number;
     /** Max delay between events during playback (ms) */
@@ -321,7 +325,7 @@ declare class TimeTravelModule<T extends object = any, P extends Paths<T> = Path
     constructor(config?: Partial<TimeTravelConfig<T, P>>, rtr?: Reactor<T>);
     wire(): void;
     protected onAttach(rtr: Reactor<any>, rid: ReactorModuleId): void;
-    protected handlePaths({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<T, P>, "paths">): void;
+    protected handleWhitelist({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<T, P>, "whitelist">): void;
     /** Chronicling the lifecycle of the system, Captures the essence of every mutation wave that bubbles up. */
     protected record(e: REvent<any, P>, rid?: ReactorModuleId): void;
     /** Clears timeline history and resets playhead/genesis to the current reactor state. */

package/dist/{timeTravel-D7NiYqdD.d.ts → timeTravel-DzgX8BKQ.d.cts}

@@ -1,4 +1,4 @@
-import { P as Paths, e as PathValue, a as REvent, c as ReactorModuleId, B as BaseReactorModule, R as Reactor } from './index-CB-IiZIB.js';
+import { P as Paths, e as PathValue, b as REvent, a as ReactorModuleId, M as ModulePaths, B as BaseReactorModule, R as Reactor } from './index-2jKy98op.cjs';
 
 type JSONReplacer = ((this: any, key: string, value: any) => any) | (number | string)[] | null;
 type JSONReviver = ((this: any, key: string, value: any) => any) | undefined;
@@ -289,8 +289,12 @@ interface HistoryEntry<T extends object = any, P extends Paths<T> = Paths<T>> {
     rid: ReactorModuleId;
 }
 interface TimeTravelConfig<T extends object, P extends Paths<T> = Paths<T>> {
-    /** Specific paths only, no "*"; instead don't pass anything */
-    paths: P[];
+    /** Whitelist paths only, no need for "*"; instead don't pass anything.
+     * - `P[]`: one shared path list for all attached reactors.
+     * - `Record<string, P[]>`: per-reactor path lists keyed by module reactor id. If you don't pass ids in `.attach()`, use implicit index keys (`"0"`, `"1"`, ...). */
+    whitelist: ModulePaths<P>;
+    /** Exclude filter for recorded paths. Checked only during record events. */
+    blacklist?: ModulePaths<P>;
     /** Maximum number of history entries to keep (Memory Cap), you lose replaying Sessions or the Genesis */
     maxHistoryLength: number;
     /** Max delay between events during playback (ms) */
@@ -321,7 +325,7 @@ declare class TimeTravelModule<T extends object = any, P extends Paths<T> = Path
     constructor(config?: Partial<TimeTravelConfig<T, P>>, rtr?: Reactor<T>);
     wire(): void;
     protected onAttach(rtr: Reactor<any>, rid: ReactorModuleId): void;
-    protected handlePaths({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<T, P>, "paths">): void;
+    protected handleWhitelist({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<T, P>, "whitelist">): void;
     /** Chronicling the lifecycle of the system, Captures the essence of every mutation wave that bubbles up. */
     protected record(e: REvent<any, P>, rid?: ReactorModuleId): void;
     /** Clears timeline history and resets playhead/genesis to the current reactor state. */

package/dist/utils.d.cts

@@ -1,4 +1,4 @@
-export { F as FanoutTuple, f as arrRegex, g as canHandle, h as deepClone, i as deleteAny, j as fanout, k as fanoutOptsArr, l as getAny, m as getTrailRecords, n as inAny, o as isObj, p as isPOJO, q as mergeObjs, r as nuke, s as parseAnyObj, t as parseEvtOpts, u as setAny } from './index-CB-IiZIB.cjs';
+export { F as FanoutTuple, f as arrRegex, g as canHandle, h as deepClone, i as deleteAny, j as fanout, k as fanoutOptsArr, l as getAny, m as getTrailRecords, n as inAny, o as isObj, p as isPOJO, q as mergeObjs, r as nuke, s as parseAnyObj, t as parseEvtOpts, u as setAny } from './index-2jKy98op.cjs';
 
 declare function clamp(min: number | undefined, val: number, max?: number): number;
 

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-export { F as FanoutTuple, f as arrRegex, g as canHandle, h as deepClone, i as deleteAny, j as fanout, k as fanoutOptsArr, l as getAny, m as getTrailRecords, n as inAny, o as isObj, p as isPOJO, q as mergeObjs, r as nuke, s as parseAnyObj, t as parseEvtOpts, u as setAny } from './index-CB-IiZIB.js';
+export { F as FanoutTuple, f as arrRegex, g as canHandle, h as deepClone, i as deleteAny, j as fanout, k as fanoutOptsArr, l as getAny, m as getTrailRecords, n as inAny, o as isObj, p as isPOJO, q as mergeObjs, r as nuke, s as parseAnyObj, t as parseEvtOpts, u as setAny } from './index-2jKy98op.js';
 
 declare function clamp(min: number | undefined, val: number, max?: number): number;
 

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "sia-reactor",
-  "version": "0.0.25",
+  "version": "0.0.26",
   "description": "The Programmable Data DOM. A high-performance State Intent Architecture (S.I.A.) Engine with zero-allocation loops, event propagation, and structural sharing.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Tobi007-del/t007-tools.git",
-    "directory": "packages/sia-reactor"
+    "url": "git+https://github.com/Tobi007-del/sia-reactor.git"
   },
-  "homepage": "https://github.com/Tobi007-del/tree/main/packages/sia-reactor#readme",
+  "homepage": "https://github.com/Tobi007-del/sia-reactor#readme",
   "bugs": {
     "url": "https://github.com/Tobi007-del/sia-reactor/issues"
   },
@@ -58,12 +57,14 @@
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",
-    "prepublishOnly": "shx cp ../../LICENSE .",
     "test": "vitest --reporter=verbose",
-    "test:run": "vitest run",
+    "test:run": "vitest run  --reporter=verbose",
     "demo": "vite --config demo/vite.config.ts",
     "demo:build": "vite build --config demo/vite.config.ts",
-    "demo:preview": "vite preview --config demo/vite.config.ts"
+    "demo:preview": "vite preview --config demo/vite.config.ts",
+    "change": "changeset",
+    "bump": "changeset version",
+    "release": "changeset publish"
   },
   "files": [
     "dist"
@@ -89,6 +90,8 @@
     "zero-dependency"
   ],
   "devDependencies": {
+    "@changesets/cli": "^2.30.0",
+    "@types/node": "^25.2.2",
     "@types/react-dom": "^18.0.0",
     "@vitejs/plugin-react": "^5.0.4",
     "@types/react": "^18.0.0",