sia-reactor 0.0.55 → 0.0.56

package/README.md

@@ -167,7 +167,7 @@ All methods are available on `Reactor` instances or objects wrapped in `reactive
 
 #### **Listeners (Asynchronous/Batched UI Observers)**
 - **`on(path, callback, options)` <-> `off(path, callback, options)`**: Attach DOM-style event listeners that respect `depth`. Supports `{ capture: true, depth: 1, once: true, init: true }`.
-- **`once(path, callback, options)`**: Fires once and self-destructs, others have too: `sonce(...)`, `gonce(...)`, `donce(...)`, `wonce(...)`.
+- **`once(path, callback, options)`**: Fires once and self-destructs, watch has too: `wonce(...)`.
 
 #### **Lifecycle & Utilities**
 - **`tick(path)`**: Forces a synchronous flush of the batch queue for a specific path.
@@ -419,7 +419,7 @@ The `target` and `currentTarget` objects give you absolute surgical awareness of
 }
 ```
 
-#### The Power of the `TERMINATOR` (Symbol.for("S.I.A_TERMINATOR"))
+#### The Power of the `TERMINATOR` (Symbol.for("SIA_TERMINATOR"))
 Because `set` and `delete` mediators execute *before* the memory is written, you have the power to alter reality or stop it entirely using the `TERMINATOR` symbol.
 
 ```javascript
@@ -524,7 +524,7 @@ rtr.on("todos", (e: REvent<User, "todos", 1>) => {
 #### 1. Transactions & Grouping
 By default, every mutation is recorded as a single frame. For UI gestures like dragging a slider, you want to group hundreds of rapid mutations into a single Undo/Redo step for the `TimeTravelModule`. 
 
-Transactions natively support **deep nesting** and preserve your semantic labels. When paired with `createTxPathMerger`, duplicate paths inside these envelopes are compressed in-flight with zero overhead.
+Transactions natively support **deep nesting** and preserve your semantic labels. When paired with `createTxPathMerger`, duplicate paths inside these envelopes are compressed in-flight.
 
 ```javascript
 import { transaction, startTx, endTx } from "sia-reactor/modules";
@@ -617,10 +617,15 @@ silence(() => {
   player.state.volume = 100; 
 }); // Useful for internal side-effects that shouldn't ruin the undo/redo history.
 
-// 2. Custom Meta Injection: Injects data seamlessly into the ReactorEvent payload for listeners to read.
+// 2. The Force Wrapper: Executes mutations that bypasses equality checks. same as withMeta({ forced: true }, () => ...)
+force(() => {
+  player.state.volume = 100; 
+}); // Useful for internal side-effects that must force-sync.
+
+// 3. Custom Meta Injection: Injects data seamlessly into the ReactorEvent payload for listeners to read.
 withMeta({ customSource: "gamepad" }, () => {
   player.intent.playing = true;
-});
+}); // startMeta & endMeta under the hood
 
 player.on("intent.playing", (e) => {
   console.log(e.customSource); // "gamepad"

package/dist/{TimeTravelConsole-BWRXxYp0.d.ts → TimeTravelConsole-Cof4tji7.d.ts}

@@ -1,23 +1,23 @@
-import { W as Reactive } from './consts-CV83gskZ.js';
-import { g as TimeTravelModule } from './index-COpS7d1h.js';
+import { W as Reactive } from './consts-RJWw9ugh.js';
+import { h as TimeTravelModule } from './index-CwE3FzCU.js';
 
-/** Reactive options for the TimeTravel overlay instance. */
+/** Reactive options for the TimeTravel console instance. */
 interface TimeTravelConsoleConfig {
-    /** Header text shown at the top of the overlay panel. */
+    /** Header text shown at the top of the console panel. */
     title: string;
     /** Accent color used to derive panel theme variables. */
     color: string;
-    /** Shows the overlay only in development when true. */
+    /** Shows the console only in development when true. */
     devOnly: boolean;
-    /** Initial open state applied when the overlay is created. */
+    /** Initial open state applied when the console is created. */
     startOpen: boolean;
-    /** Container element that owns the overlay layer and dock. */
+    /** Container element that owns the console layer and dock. */
     container?: HTMLElement;
 }
 /**
- * - Vanilla overlay controller for visual time-travel controls and timeline I/O.
+ * - Vanilla console controller for visual time-travel controls and timeline I/O.
  * - Mounts a docked HUD into the configured container, syncs its UI with module state, and forwards keyboard/button actions to the TimeTravelModule.
- * Supports reactive `config` updates (title/color/container/devOnly) and maintains local overlay UI state (`open` and `import` payload text).
+ * Supports reactive `config` updates (title/color/container/devOnly) and maintains local console UI state (`open` and `import` payload text).
  */
 declare class TimeTravelConsole {
     static count: number;
@@ -32,9 +32,9 @@ declare class TimeTravelConsole {
     readonly host: HTMLElement;
     private clups;
     private keydown;
-    /** Creates a docked TimeTravel overlay bound to a module instance.
+    /** Creates a docked TimeTravel console overlay bound to a module instance.
      * @param time TimeTravel module instance that owns timeline operations.
-     * @param build Optional initial overlay config overrides.
+     * @param build Optional initial console config overrides.
      */
     constructor(time: TimeTravelModule, build?: Partial<TimeTravelConsoleConfig>);
     destroy(): void;

package/dist/{TimeTravelConsole-Dt-W-sLq.d.cts → TimeTravelConsole-CrTYhT1B.d.cts}

@@ -1,23 +1,23 @@
-import { W as Reactive } from './consts-CV83gskZ.cjs';
-import { g as TimeTravelModule } from './index-CgFQ_rTz.cjs';
+import { W as Reactive } from './consts-RJWw9ugh.cjs';
+import { h as TimeTravelModule } from './index-Cc5CaM9q.cjs';
 
-/** Reactive options for the TimeTravel overlay instance. */
+/** Reactive options for the TimeTravel console instance. */
 interface TimeTravelConsoleConfig {
-    /** Header text shown at the top of the overlay panel. */
+    /** Header text shown at the top of the console panel. */
     title: string;
     /** Accent color used to derive panel theme variables. */
     color: string;
-    /** Shows the overlay only in development when true. */
+    /** Shows the console only in development when true. */
     devOnly: boolean;
-    /** Initial open state applied when the overlay is created. */
+    /** Initial open state applied when the console is created. */
     startOpen: boolean;
-    /** Container element that owns the overlay layer and dock. */
+    /** Container element that owns the console layer and dock. */
     container?: HTMLElement;
 }
 /**
- * - Vanilla overlay controller for visual time-travel controls and timeline I/O.
+ * - Vanilla console controller for visual time-travel controls and timeline I/O.
  * - Mounts a docked HUD into the configured container, syncs its UI with module state, and forwards keyboard/button actions to the TimeTravelModule.
- * Supports reactive `config` updates (title/color/container/devOnly) and maintains local overlay UI state (`open` and `import` payload text).
+ * Supports reactive `config` updates (title/color/container/devOnly) and maintains local console UI state (`open` and `import` payload text).
  */
 declare class TimeTravelConsole {
     static count: number;
@@ -32,9 +32,9 @@ declare class TimeTravelConsole {
     readonly host: HTMLElement;
     private clups;
     private keydown;
-    /** Creates a docked TimeTravel overlay bound to a module instance.
+    /** Creates a docked TimeTravel console overlay bound to a module instance.
      * @param time TimeTravel module instance that owns timeline operations.
-     * @param build Optional initial overlay config overrides.
+     * @param build Optional initial console config overrides.
      */
     constructor(time: TimeTravelModule, build?: Partial<TimeTravelConsoleConfig>);
     destroy(): void;

package/dist/adapters/react.cjs

@@ -40,15 +40,15 @@ var import_react = require("react");
 var useISOLayoutEffect = "undefined" !== typeof window ? import_react.useLayoutEffect : import_react.useEffect;
 
 // src/ts/core/consts.ts
-var RAW = /* @__PURE__ */ Symbol.for("S.I.A_RAW");
-var INERTIA = /* @__PURE__ */ Symbol.for("S.I.A_INERTIA");
-var REJECTABLE = /* @__PURE__ */ Symbol.for("S.I.A_REJECTABLE");
-var INDIFFABLE = /* @__PURE__ */ Symbol.for("S.I.A_INDIFFABLE");
-var TERMINATOR = /* @__PURE__ */ Symbol.for("S.I.A_TERMINATOR");
-var VERSION = /* @__PURE__ */ Symbol.for("S.I.A_VERSION");
-var SSVERSION = /* @__PURE__ */ Symbol.for("S.I.A_SNAPSHOT_VERSION");
+var RAW = /* @__PURE__ */ Symbol.for("SIA_RAW");
+var INERTIA = /* @__PURE__ */ Symbol.for("SIA_INERTIA");
+var REJECTABLE = /* @__PURE__ */ Symbol.for("SIA_REJECTABLE");
+var INDIFFABLE = /* @__PURE__ */ Symbol.for("SIA_INDIFFABLE");
+var TERMINATOR = /* @__PURE__ */ Symbol.for("SIA_TERMINATOR");
+var VERSION = /* @__PURE__ */ Symbol.for("SIA_VERSION");
+var SSVERSION = /* @__PURE__ */ Symbol.for("SIA_SNAPSHOT_VERSION");
 var RTR_BATCH = "undefined" !== typeof window ? ("undefined" !== typeof queueMicrotask ? queueMicrotask : setTimeout).bind(window) : "undefined" !== typeof process && process.nextTick ? process.nextTick : setTimeout;
-var RTR_LOG = console.log.bind(console, "[S.I.A Reactor]");
+var RTR_LOG = console.log.bind(console, "[SIA Reactor]");
 var EVT_OPTS = { LISTENER: ["capture", "depth", "once", "signal", "init"], MEDIATOR: ["lazy", "signal", "init"] };
 var NIL = Object.freeze({});
 var NOOP = () => {
@@ -61,8 +61,6 @@ try {
 var CTX_BUILD = {
   /** Flag indicating whether the application is running in development mode. */
   isDevEnv,
-  /** Flag indicating whether an operation is bypassing checks so reactors can allow all writes. */
-  usingForce: false,
   /** Active `Autotracker` instance, override for automatic dependency collection on `Reactor` traps. */
   autotracker: null,
   /** Extensible meta context for payloads and cross-cutting concerns. */
@@ -79,7 +77,24 @@ var CTX_BUILD = {
     batchingFunction: RTR_BATCH
   }
 };
-var CTX = globalThis[/* @__PURE__ */ Symbol.for("S.I.A_CTX")] ??= CTX_BUILD;
+var CTX = globalThis[/* @__PURE__ */ Symbol.for("SIA_CTX")] ??= CTX_BUILD;
+
+// src/ts/utils/meta.ts
+function resetMeta(key) {
+  if (!CTX.meta) return;
+  delete CTX.meta[key];
+  for (const _ in CTX.meta) return;
+  CTX.meta = null;
+}
+function force(task, bool = true) {
+  const prev = CTX.meta?.forced;
+  (CTX.meta ??= {}).forced = bool;
+  try {
+    return task();
+  } finally {
+    prev !== void 0 ? CTX.meta.forced = prev : resetMeta("forced");
+  }
+}
 
 // src/ts/utils/obj.ts
 var arrRegex = /^([^\[\]]+)\[(\d+)\]$/;
@@ -174,15 +189,6 @@ function getDepth(path, depth = !path ? 0 : 1) {
 function parseEvtOpts(options, opts, boolOpt = opts[0], result = {}) {
   return Object.assign(result, "boolean" === typeof options ? { [boolOpt]: options } : options), result;
 }
-function force(task, bool = true) {
-  const prev = CTX.usingForce;
-  CTX.usingForce = bool;
-  try {
-    return task();
-  } finally {
-    CTX.usingForce = prev;
-  }
-}
 function getTrailRecords(obj, path, reverse = false) {
   const parts = path.split("."), chain = [["*", obj, obj]];
   for (let acc = "", currObj = obj, i = 0, len = parts.length; i < len; i++) {
@@ -388,7 +394,7 @@ var Reactor = class {
           safeValue = value?.[RAW] || value;
           unchanged = this.config.equalityFunction(safeValue, safeOldValue);
         }
-        if (!indiffable && unchanged && !CTX.usingForce && keyStr !== "length") return this.log(`\u{1F504} [\`set\` Trap] Unchanged for "${keyStr}" on [${paths}]`), true;
+        if (!indiffable && unchanged && !CTX.meta?.forced && keyStr !== "length") return this.log(`\u{1F504} [\`set\` Trap] Unchanged for "${keyStr}" on [${paths}]`), true;
         if (this.config.set) terminated = (value = this.config.set(object, key2, value, oldValue, receiver, paths)) === TERMINATOR;
         if (this.setters) {
           const wildcords = this.setters.get("*");
@@ -712,10 +718,6 @@ var Reactor = class {
   get(path, callback, options) {
     return this.onSync("get", path, callback, options, () => getPath(this.core, path));
   }
-  /** Registers a get mediator for a path that only triggers once. */
-  gonce(path, callback, options) {
-    return this.get(path, callback, { ...parseEvtOpts(options, EVT_OPTS.MEDIATOR), once: true });
-  }
   /**
    * Removes a get mediator for a path.
    * @param path Path or wildcard path.
@@ -737,10 +739,6 @@ var Reactor = class {
   set(path, callback, options) {
     return this.onSync("set", path, callback, options, () => (force(() => setPath(this.core, path, getPath(this.core, path))), this.tick(path)));
   }
-  /** Registers a set mediator for a path that only triggers once. */
-  sonce(path, callback, options) {
-    return this.set(path, callback, Object.assign(parseEvtOpts(options, EVT_OPTS.MEDIATOR), { once: true }));
-  }
   /**
    * Removes a set mediator for a path.
    * @param path Path or wildcard path.
@@ -762,10 +760,6 @@ var Reactor = class {
   delete(path, callback, options) {
     return this.onSync("delete", path, callback, options, () => deletePath(this.core, path));
   }
-  /** Registers a delete mediator for a path that only triggers once. */
-  donce(path, callback, options) {
-    return this.delete(path, callback, Object.assign(parseEvtOpts(options, EVT_OPTS.MEDIATOR), { once: true }));
-  }
   /**
    * Removes a delete mediator for a path.
    * @param path Path or wildcard path.
@@ -890,7 +884,7 @@ var Reactor = class {
 };
 
 // src/ts/core/mixins.ts
-var methods = ["tick", "stall", "nostall", "get", "gonce", "noget", "set", "sonce", "noset", "delete", "donce", "nodelete", "watch", "wonce", "nowatch", "on", "once", "off", "snapshot", "use", "reset", "destroy"];
+var methods = ["tick", "stall", "nostall", "get", "noget", "set", "noset", "delete", "nodelete", "watch", "wonce", "nowatch", "on", "once", "off", "snapshot", "use", "reset", "destroy"];
 function reactive(target, build, preferences = NIL) {
   if ("__Reactor__" in target) return target;
   const descriptors = {}, rtr = getReactor(target, true, build), locks = { enumerable: false, configurable: true, writable: false }, hasAffix = !!(preferences.prefix || preferences.suffix);
@@ -1057,8 +1051,7 @@ function useReactor(target, options = NIL, build) {
   const versionRef = (0, import_react2.useRef)(0), tgtRef = (0, import_react2.useRef)(), rtrRef = (0, import_react2.useRef)(), rtr = tgtRef.current !== target || !rtrRef.current ? (tgtRef.current = target, rtrRef.current = getReactor(target, true, build)) : rtrRef.current, atrkrRef = (0, import_react2.useRef)(), prevTrkr = CTX.autotracker, atrkr = CTX.autotracker = atrkrRef.current ||= new Autotracker(), optsRef = (0, import_react2.useRef)(options), notifyRef = (0, import_react2.useRef)(NOOP);
   optsRef.current = options;
   atrkr.unblock(rtr), queueMicrotask(() => CTX.autotracker === atrkr && (CTX.autotracker = prevTrkr));
-  const subscribe = (0, import_react2.useCallback)((notify) => atrkr.callback(notifyRef.current = () => (versionRef.current++, notify())), [atrkr]);
-  const getSnapshot = (0, import_react2.useCallback)(() => versionRef.current, []);
+  const getSnapshot = (0, import_react2.useCallback)(() => versionRef.current, []), subscribe = (0, import_react2.useCallback)((notify) => atrkr.callback(notifyRef.current = () => (versionRef.current++, notify())), [atrkr]);
   (0, import_react2.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return useISOLayoutEffect(() => (CTX.autotracker = prevTrkr, atrkr.callback(notifyRef.current, optsRef.current)), [atrkr]), rtr.core;
 }
@@ -1066,8 +1059,7 @@ function useAnyReactor(options = NIL) {
   const versionRef = (0, import_react2.useRef)(0), atrkrRef = (0, import_react2.useRef)(), prevTrkr = CTX.autotracker, atrkr = CTX.autotracker = atrkrRef.current ||= new Autotracker(), optsRef = (0, import_react2.useRef)(options), notifyRef = (0, import_react2.useRef)(NOOP);
   optsRef.current = options;
   atrkr.unblock(), queueMicrotask(() => CTX.autotracker === atrkr && (CTX.autotracker = prevTrkr));
-  const subscribe = (0, import_react2.useCallback)((notify) => atrkr.callback(notifyRef.current = () => (versionRef.current++, notify())), [atrkr]);
-  const getSnapshot = (0, import_react2.useCallback)(() => versionRef.current, []);
+  const getSnapshot = (0, import_react2.useCallback)(() => versionRef.current, []), subscribe = (0, import_react2.useCallback)((notify) => atrkr.callback(notifyRef.current = () => (versionRef.current++, notify())), [atrkr]);
   (0, import_react2.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   useISOLayoutEffect(() => (CTX.autotracker = prevTrkr, atrkr.callback(notifyRef.current, optsRef.current)), [atrkr]);
 }
@@ -1075,10 +1067,7 @@ function useReactorSnapshot(target, options, build = { referenceTracking: true,
   const tgtRef = (0, import_react2.useRef)(), rtrRef = (0, import_react2.useRef)(), rtr = tgtRef.current !== target || !rtrRef.current ? (tgtRef.current = target, rtrRef.current = getReactor(target, true, build)) : rtrRef.current, atrkrRef = (0, import_react2.useRef)(), atrkrRtrRef = (0, import_react2.useRef)(), atrkr = atrkrRtrRef.current !== rtr || !atrkrRef.current ? (atrkrRtrRef.current = rtr, atrkrRef.current = new Autotracker(rtr)) : atrkrRef.current, notifyRef = (0, import_react2.useRef)(NOOP), optsRef = (0, import_react2.useRef)(options);
   rtr.config.referenceTracking = rtr.config.smartCloning = true;
   optsRef.current = options;
-  const subscribe = (0, import_react2.useCallback)((notify) => (atrkr.callback(notifyRef.current = notify, optsRef.current), () => atrkr.cleanup()), [atrkr]);
-  const getSnapshot = () => rtr.snapshot();
-  const snapshot = (0, import_react2.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
-  const proxy = (0, import_react2.useMemo)(() => atrkr.tracked(snapshot), [atrkr, snapshot]);
+  const getSnapshot = () => rtr.snapshot(), subscribe = (0, import_react2.useCallback)((notify) => (atrkr.callback(notifyRef.current = notify, optsRef.current), () => atrkr.cleanup()), [atrkr]), snapshot = (0, import_react2.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot), proxy = (0, import_react2.useMemo)(() => atrkr.tracked(snapshot), [atrkr, snapshot]);
   return useISOLayoutEffect(() => atrkr.callback(notifyRef.current, optsRef.current), [atrkr, proxy]), proxy;
 }
 
@@ -1087,35 +1076,29 @@ var import_react3 = require("react");
 function useSelector(target, sel, eq = Object.is, options = NIL, build) {
   const rtrRef = (0, import_react3.useRef)(), tgtRef = (0, import_react3.useRef)(), rtr = tgtRef.current !== target || !rtrRef.current ? (tgtRef.current = target, rtrRef.current = getReactor(target, true, build)) : rtrRef.current, atrkrRef = (0, import_react3.useRef)(), atrkr = atrkrRef.current ||= new Autotracker(), notifyRef = (0, import_react3.useRef)(NOOP), sliceRef = (0, import_react3.useRef)(), selRef = (0, import_react3.useRef)(sel), eqRef = (0, import_react3.useRef)(eq), optsRef = (0, import_react3.useRef)(options);
   selRef.current = sel, eqRef.current = eq, optsRef.current = options;
-  const subscribe = (0, import_react3.useCallback)((notify) => atrkr.callback(notifyRef.current = notify, optsRef.current), [atrkr]);
   const getSnapshot = (0, import_react3.useCallback)(() => {
     const next = withTracker(atrkr, () => selRef.current(rtr.core), rtr);
     return eqRef.current(sliceRef.current, next) ? sliceRef.current : sliceRef.current = next;
-  }, [atrkr, rtr]);
-  const slice = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  }, [atrkr, rtr]), subscribe = (0, import_react3.useCallback)((notify) => atrkr.callback(notifyRef.current = notify, optsRef.current), [atrkr]), slice = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return useISOLayoutEffect(() => atrkr.callback(notifyRef.current, optsRef.current), [atrkr, slice]), slice;
 }
 function useAnySelector(sel, eq = Object.is, options = NIL) {
   const atrkrRef = (0, import_react3.useRef)(), atrkr = atrkrRef.current ||= new Autotracker(), notifyRef = (0, import_react3.useRef)(NOOP), sliceRef = (0, import_react3.useRef)(), selRef = (0, import_react3.useRef)(sel), eqRef = (0, import_react3.useRef)(eq), optsRef = (0, import_react3.useRef)(options);
   selRef.current = sel, eqRef.current = eq, optsRef.current = options;
-  const subscribe = (0, import_react3.useCallback)((notify) => atrkr.callback(notifyRef.current = notify, optsRef.current), [atrkr]);
   const getSnapshot = (0, import_react3.useCallback)(() => {
     const next = withTracker(atrkr, () => selRef.current());
     return eqRef.current(sliceRef.current, next) ? sliceRef.current : sliceRef.current = next;
-  }, [atrkr]);
-  const slice = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  }, [atrkr]), subscribe = (0, import_react3.useCallback)((notify) => atrkr.callback(notifyRef.current = notify, optsRef.current), [atrkr]), slice = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return useISOLayoutEffect(() => atrkr.callback(notifyRef.current, optsRef.current), [atrkr, slice]), slice;
 }
 function useSelectorSnapshot(target, sel, eq = Object.is, options, build = { referenceTracking: true, smartCloning: true }) {
   const tgtRef = (0, import_react3.useRef)(), rtrRef = (0, import_react3.useRef)(), rtr = tgtRef.current !== target || !rtrRef.current ? (tgtRef.current = target, rtrRef.current = getReactor(target, true, build)) : rtrRef.current, atrkrRef = (0, import_react3.useRef)(), atrkrRtrRef = (0, import_react3.useRef)(), atrkr = atrkrRtrRef.current !== rtr || !atrkrRef.current ? (atrkrRtrRef.current = rtr, atrkrRef.current = new Autotracker(rtr)) : atrkrRef.current, notifyRef = (0, import_react3.useRef)(NOOP), sliceRef = (0, import_react3.useRef)(), selRef = (0, import_react3.useRef)(sel), eqRef = (0, import_react3.useRef)(eq), optsRef = (0, import_react3.useRef)(options);
   rtr.config.referenceTracking = rtr.config.smartCloning = true;
   optsRef.current = options, selRef.current = sel, eqRef.current = eq;
-  const subscribe = (0, import_react3.useCallback)((notify) => (atrkr.callback(notifyRef.current = notify, optsRef.current), () => atrkr.cleanup()), [atrkr]);
   const getSnapshot = (0, import_react3.useCallback)(() => {
     const next = selRef.current(atrkr.tracked(rtr.snapshot()));
     return eqRef.current(sliceRef.current, next) ? sliceRef.current : sliceRef.current = next;
-  }, [atrkr]);
-  const slice = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+  }, [atrkr]), subscribe = (0, import_react3.useCallback)((notify) => (atrkr.callback(notifyRef.current = notify, optsRef.current), () => atrkr.cleanup()), [atrkr]), slice = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return useISOLayoutEffect(() => atrkr.callback(notifyRef.current, optsRef.current), [atrkr, slice]), slice;
 }
 
@@ -1124,8 +1107,7 @@ var import_react4 = require("react");
 function usePath(target, path, options = NIL, build) {
   const versionRef = (0, import_react4.useRef)(0), tgtRef = (0, import_react4.useRef)(), rtrRef = (0, import_react4.useRef)(), rtr = tgtRef.current !== target || !rtrRef.current ? (tgtRef.current = target, rtrRef.current = getReactor(target, true, build)) : rtrRef.current, optsRef = (0, import_react4.useRef)(options);
   optsRef.current = options;
-  const subscribe = (0, import_react4.useCallback)((notify) => rtr[optsRef.current.sync ? "watch" : "on"](path, () => (versionRef.current++, notify()), optsRef.current), [rtr, path]);
-  const getSnapshot = (0, import_react4.useCallback)(() => versionRef.current, []);
+  const getSnapshot = (0, import_react4.useCallback)(() => versionRef.current, []), subscribe = (0, import_react4.useCallback)((notify) => rtr[optsRef.current.sync ? "watch" : "on"](path, () => (versionRef.current++, notify()), optsRef.current), [rtr, path]);
   (0, import_react4.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   return getPath(rtr.core, path);
 }
@@ -1257,8 +1239,9 @@ function effect(callback, options = NIL) {
 // src/ts/adapters/vanilla/TimeTravelConsole.ts
 var keys = {
   blocks: KEYS_BLOCKS,
-  // overrides: ["Space", "Home", "End", "Escape", "Delete"], // Playing "God"
-  shortcuts: { undo: ["Ctrl+z", "Cmd+z"], redo: ["Ctrl+y", "Ctrl+Shift+z", "Cmd+Shift+z"], genesis: "Home", trackUntrack: "t", ending: "End", playPause: "Space", rewind: "Shift+Space", closeOverlay: "Escape", clrHistory: "Delete", export: "e", import: "i", clear: "c" }
+  whitelist: ["Escape"],
+  // overrides: ["Space", "Home", "End", "Escape", "Delete"], // Playing "God" now
+  shortcuts: { undo: ["Ctrl+z", "Cmd+z"], redo: ["Ctrl+y", "Ctrl+Shift+z", "Cmd+Shift+z"], genesis: "Home", trackUntrack: "t", ending: "End", playPause: "Space", rewind: "Shift+Space", prune: "Insert", reset: "Delete", export: "e", import: "i", clear: "x", copy: "c", toggle: "Ctrl + `" }
 };
 var TimeTravelConsole = class _TimeTravelConsole {
   static count = 0;
@@ -1269,22 +1252,24 @@ var TimeTravelConsole = class _TimeTravelConsole {
   host;
   clups = [];
   keydown;
-  /** Creates a docked TimeTravel overlay bound to a module instance.
+  /** Creates a docked TimeTravel console overlay bound to a module instance.
    * @param time TimeTravel module instance that owns timeline operations.
-   * @param build Optional initial overlay config overrides.
+   * @param build Optional initial console config overrides.
    */
   constructor(time, build = { devOnly: true }) {
     this.time = time;
     this.config = reactive({ title: `Time Travel Console ${this.index = ++_TimeTravelConsole.count}`, ...build });
     this.state.open = !!this.config.startOpen;
     let wlLive = false, blLive = false;
-    const s = this.time.state, host = this.host = createEl("div", { className: "sia-tt-console-host" }), toggle = createEl("button", { className: "sia-tt-console-toggle", type: "button", onclick: () => this.state.open = !this.state.open }), panel = createEl("aside", { className: "sia-tt-console", ariaLabel: "time travel overlay" }), title = createEl("div", { className: "title" }), frame = createEl("span", { className: "muted" }), clrHistory = createEl("button", { textContent: `Clear History${formatKeyTooltip(keys.shortcuts.clrHistory)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.clrHistory), onclick: () => (this.time.clear(), this.state.import = "") }), undo = createEl("button", { textContent: `Undo${formatKeyTooltip(keys.shortcuts.undo[0])}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.undo), onclick: () => this.time.undo(this.state.stride) }), redo = createEl("button", { textContent: `Redo${formatKeyTooltip(keys.shortcuts.redo[0])}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.redo), onclick: () => this.time.redo(this.state.stride) }), genesis = createEl("button", { textContent: `Genesis${formatKeyTooltip(keys.shortcuts.genesis)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.genesis), onclick: () => this.time.jumpTo(0) }), playPause = createEl("button", { onclick: () => this.time[s.paused ? "play" : "pause"](), ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.playPause) }), rewind = createEl("button", { textContent: `Rewind${formatKeyTooltip(keys.shortcuts.rewind)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.rewind), onclick: this.time.rewind }), trackUntrack = createEl("button", { onclick: () => this.time[s.tracking ? "untrack" : "track"](), ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.trackUntrack) }), range = createEl("input", { type: "range", min: "0", title: "time travel frame", ariaLabel: "time travel frame", oninput: () => this.time.jumpTo(Number(range.value)) }), exp = createEl("button", { textContent: `Export${formatKeyTooltip(keys.shortcuts.export)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.export), onclick: () => this.state.import = this.time.export(null, 2) }), imp = createEl("button", { textContent: `Import${formatKeyTooltip(keys.shortcuts.import)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.import), onclick: () => this.state.import.trim().length && this.time.import(this.state.import) }), clr = createEl("button", { textContent: `Clear${formatKeyTooltip(keys.shortcuts.clear)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.clear), onclick: () => this.state.import = "" }), payload = createEl("textarea", { className: "sia-tt-io", readOnly: true, placeholder: "current payload json", title: "Current History Entry" }), io = createEl("textarea", { className: "sia-tt-io", placeholder: "timeline payload json", title: "Time History", oninput: () => this.state.import = io.value }), foot = createEl("p", { className: "sia-tt-footnote", innerHTML: "<span>Try this in your app? </span>" }), link = createEl("a", { target: "_blank", rel: "noreferrer noopener", textContent: "sia-reactor", href: "https://www.npmjs.com/package/sia-reactor" }), box = createEl("div", { className: "sia-tt-status-box" }), status = createEl("div", { className: "sia-tt-status-row" }), filters = createEl("div", { className: "sia-tt-status-row" }), filterBox = createEl("div", { className: "sia-tt-status-box" }), whitelistLabel = createEl("span", { className: "muted", textContent: "Whitelist:" }), blacklistLabel = createEl("span", { className: "muted", textContent: "Blacklist:" }), whitelist = createEl("input", { className: "sia-tt-filter-input sia-tt-io", placeholder: 'a.b, c.d or {"0":["a.b"]}', title: "Whitelist paths", onfocus: () => wlLive = true, onblur: () => (wlLive = false, whitelist.value = formatPaths(this.time.config.whitelist, "*")), oninput: (_, parsed = parsePaths(whitelist.value)) => parsed !== null && (this.time.config.whitelist = parsed) }), blacklist = createEl("input", { className: "sia-tt-filter-input sia-tt-io", placeholder: 'a.b, c.d or {"0":["a.b"]}', title: "Blacklist paths", onfocus: () => blLive = true, onblur: () => (blLive = false, blacklist.value = formatPaths(this.time.config.blacklist, "")), oninput: (_, parsed = parsePaths(blacklist.value, true)) => parsed !== null && (this.time.config.blacklist = parsed) }), speed = createEl("select", { className: "sia-tt-speed", title: "Playback Speed", onchange: () => this.time.config.playbackRate = Number(speed.value) }), stride = createEl("input", { className: "sia-tt-stride sia-tt-button sia-tt-mini-input", type: "number", min: "1", title: "Skip Stride i.e. how many steps count as one unit", oninput: () => this.state.stride = Math.max(1, Number(stride.value) || 1) }), stats = createEl("span", { className: "sia-tt-stats" }), limit = createEl("input", { className: "sia-tt-limit sia-tt-mini-input sia-tt-button", type: "number", min: "1", title: "Maximum number of history entries kept in memory before older entries are discarded.", oninput: () => this.time.config.limit = Math.max(1, Number(limit.value) || 1) }), delay = createEl("input", { className: "sia-tt-delay sia-tt-mini-input sia-tt-button", type: "number", min: "0", step: "50", title: "Maximum playback delay between timeline frames in milliseconds.", oninput: () => this.time.config.maxPlaybackDelay = Math.max(0, Number(delay.value) || 0) }), read = createEl("label", { className: "sia-tt-check", title: "When recording intent mutations, read previous values from the matching state path instead of the intent path. Useful for accurate undo reconstruction of intent-driven flows." }), readBox = createEl("input", { type: "checkbox", checked: !!this.time.config.mirrorReads, onchange: () => this.time.config.mirrorReads = readBox.checked }), write = createEl("label", { className: "sia-tt-check", title: "During playback and teleportation, mirror state writes into matching intent paths to re-enact the recorded history. Useful for accurate reconstruction of the whole session." }), writeBox = createEl("input", { type: "checkbox", checked: !!this.time.config.mirrorWrites, onchange: () => this.time.config.mirrorWrites = writeBox.checked }), filterRow1 = createEl("div", { className: "sia-tt-filter-row" }), filterRow2 = createEl("div", { className: "sia-tt-filter-row" }), row1 = createEl("div", { className: "sia-tt-row" }), row2 = createEl("div", { className: "sia-tt-row" }), row3 = createEl("div", { className: "sia-tt-row" }), row4 = createEl("div", { className: "sia-tt-row" }), row5 = createEl("div", { className: "sia-tt-row sia-tt-config-row" });
+    const s = this.time.state, host = this.host = createEl("div", { className: "sia-tt-console-host" }), toggle = createEl("button", { className: "sia-tt-console-toggle", type: "button", title: `Toggle Overlay${formatKeyTooltip(keys.shortcuts.toggle)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.toggle), onclick: () => this.state.open = !this.state.open }), panel = createEl("aside", { className: "sia-tt-console", ariaLabel: "time travel console" }), title = createEl("div", { className: "title" }), frame = createEl("span", { className: "muted" }), prune = createEl("button", { textContent: `Prune${formatKeyTooltip(keys.shortcuts.prune)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.prune), onclick: () => this.time.prune() }), reset = createEl("button", { textContent: `Reset${formatKeyTooltip(keys.shortcuts.reset)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.reset), onclick: () => (this.time.reset(), this.state.import = "") }), undo = createEl("button", { textContent: `Undo${formatKeyTooltip(keys.shortcuts.undo[0])}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.undo), onclick: () => this.time.undo(this.state.stride) }), redo = createEl("button", { textContent: `Redo${formatKeyTooltip(keys.shortcuts.redo[0])}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.redo), onclick: () => this.time.redo(this.state.stride) }), genesis = createEl("button", { textContent: `Genesis${formatKeyTooltip(keys.shortcuts.genesis)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.genesis), onclick: () => this.time.jumpTo(0) }), playPause = createEl("button", { onclick: () => this.time[s.paused ? "play" : "pause"](), ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.playPause) }), rewind = createEl("button", { textContent: `Rewind${formatKeyTooltip(keys.shortcuts.rewind)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.rewind), onclick: this.time.rewind }), trackUntrack = createEl("button", { onclick: () => this.time[s.tracking ? "untrack" : "track"](), ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.trackUntrack) }), range = createEl("input", { type: "range", min: "0", title: "time travel frame", ariaLabel: "time travel frame", oninput: () => this.time.jumpTo(Number(range.value)) }), exp = createEl("button", { textContent: `Export${formatKeyTooltip(keys.shortcuts.export)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.export), onclick: () => this.state.import = this.time.export(null, 2) }), imp = createEl("button", { textContent: `Import${formatKeyTooltip(keys.shortcuts.import)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.import), onclick: () => this.state.import.trim().length && this.time.import(this.state.import) }), clr = createEl("button", { textContent: `Clear${formatKeyTooltip(keys.shortcuts.clear)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.clear), onclick: () => this.state.import = "" }), copy = createEl("button", { textContent: `Copy${formatKeyTooltip(keys.shortcuts.copy)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.copy), onclick: () => this.state.import.trim().length && navigator.clipboard?.writeText(this.state.import).catch?.(() => {
+    }) }), payload = createEl("textarea", { className: "sia-tt-io", readOnly: true, placeholder: "current payload json", title: "Current History Entry" }), io = createEl("textarea", { className: "sia-tt-io", placeholder: "timeline payload json", title: "Time History", oninput: () => this.state.import = io.value }), foot = createEl("p", { className: "sia-tt-footnote", innerHTML: "<span>Try this in your app? </span>" }), link = createEl("a", { target: "_blank", rel: "noreferrer noopener", textContent: "sia-reactor", href: "https://www.npmjs.com/package/sia-reactor" }), box = createEl("div", { className: "sia-tt-status-box" }), status = createEl("div", { className: "sia-tt-status-row" }), filters = createEl("div", { className: "sia-tt-status-row" }), filterBox = createEl("div", { className: "sia-tt-status-box" }), whitelistLabel = createEl("span", { className: "muted", textContent: "Whitelist:" }), blacklistLabel = createEl("span", { className: "muted", textContent: "Blacklist:" }), whitelist = createEl("input", { className: "sia-tt-filter-input sia-tt-io", placeholder: 'a.b, c.d or {"0":["a.b"]}', title: "Whitelist paths", onfocus: () => wlLive = true, onblur: () => (wlLive = false, whitelist.value = formatPaths(this.time.config.whitelist, "*")), oninput: (_, parsed = parsePaths(whitelist.value)) => parsed !== null && (this.time.config.whitelist = parsed) }), blacklist = createEl("input", { className: "sia-tt-filter-input sia-tt-io", placeholder: 'a.b, c.d or {"0":["a.b"]}', title: "Blacklist paths", onfocus: () => blLive = true, onblur: () => (blLive = false, blacklist.value = formatPaths(this.time.config.blacklist, "")), oninput: (_, parsed = parsePaths(blacklist.value, true)) => parsed !== null && (this.time.config.blacklist = parsed) }), speed = createEl("select", { className: "sia-tt-speed", title: "Playback Speed", onchange: () => this.time.state.playbackRate = Number(speed.value) }), stride = createEl("input", { className: "sia-tt-stride sia-tt-button sia-tt-mini-input", type: "number", min: "1", title: "Skip Stride i.e. how many steps count as one unit", oninput: () => this.state.stride = Math.max(1, Number(stride.value) || 1) }), stats = createEl("span", { className: "sia-tt-stats" }), limit = createEl("input", { className: "sia-tt-limit sia-tt-mini-input sia-tt-button", type: "number", min: "1", title: "Maximum number of history entries kept in memory before older entries are discarded.", oninput: () => this.time.config.limit = Math.max(1, Number(limit.value) || 1) }), delay = createEl("input", { className: "sia-tt-delay sia-tt-mini-input sia-tt-button", type: "number", min: "0", step: "50", title: "Maximum playback delay between timeline frames in milliseconds.", oninput: () => this.time.config.maxPlaybackDelay = Math.max(0, Number(delay.value) || 0) }), read = createEl("label", { className: "sia-tt-check", title: "When recording intent mutations, read previous values from the matching state path instead of the intent path. Useful for accurate undo reconstruction of intent-driven flows." }), readBox = createEl("input", { type: "checkbox", checked: !!this.time.config.mirrorReads, onchange: () => this.time.config.mirrorReads = readBox.checked }), write = createEl("label", { className: "sia-tt-check", title: "During playback and teleportation, mirror state writes into matching intent paths to re-enact the recorded history. Useful for accurate reconstruction of the whole session." }), writeBox = createEl("input", { type: "checkbox", checked: !!this.time.config.mirrorWrites, onchange: () => this.time.config.mirrorWrites = writeBox.checked }), filterRow1 = createEl("div", { className: "sia-tt-filter-row" }), filterRow2 = createEl("div", { className: "sia-tt-filter-row" }), row1 = createEl("div", { className: "sia-tt-row" }), row2 = createEl("div", { className: "sia-tt-row" }), row3 = createEl("div", { className: "sia-tt-row" }), row4 = createEl("div", { className: "sia-tt-row" }), row5 = createEl("div", { className: "sia-tt-row sia-tt-config-row" });
     speed.append(...[0.25, 0.5, 0.75, 1, 1.25, 1.5, 2, 4, 8, 16, 32].map((v) => createEl("option", { value: String(v), textContent: `${v}x` })));
-    status.append((box.append(frame), box), clrHistory);
+    status.append((box.append(frame), box), prune, reset);
     filters.append((filterBox.append((filterRow1.append(whitelistLabel, whitelist), filterRow1), (filterRow2.append(blacklistLabel, blacklist), filterRow2)), filterBox));
-    panel.append(title, status, (row1.append(playPause, rewind, genesis), row1), (row2.append(undo, redo, trackUntrack, stride), row2), payload, (row3.append(speed, range), row3), filters, (row4.append(exp, imp, clr), row4), io, (row5.append(delay, limit, (read.append(readBox, " Read Mirror"), read), (write.append(writeBox, " Write Mirror"), write)), row5), (foot.prepend(stats), foot.append(link), foot));
+    panel.append(title, status, (row1.append(playPause, rewind, genesis), row1), (row2.append(undo, redo, trackUntrack, stride), row2), payload, (row3.append(speed, range), row3), filters, (row4.append(exp, imp, copy, clr), row4), io, (row5.append(delay, limit, (read.append(readBox, " Read Mirror"), read), (write.append(writeBox, " Write Mirror"), write)), row5), (foot.prepend(stats), foot.append(link), foot));
     this.host.append(toggle, panel);
-    this.keydown = (e, can = this.state.open && (this.config.devOnly ? CTX.isDevEnv : true), a = can && keyEventAllowed(e, keys)) => (a && (e.preventDefault(), e.stopImmediatePropagation()), a === "undo" ? this.time.undo(this.state.stride) : a === "redo" ? this.time.redo(this.state.stride) : a === "genesis" ? this.time.jumpTo(0) : a === "trackUntrack" ? this.time[s.tracking ? "untrack" : "track"]() : a === "ending" ? this.time.jumpTo(s.history.length) : a === "rewind" ? this.time.rewind() : a === "playPause" ? this.time[s.paused ? "play" : "pause"]() : a === "clrHistory" ? this.time.clear() : a === "closeOverlay" ? this.state.open = false : a === "export" ? this.state.import = this.time.export(null, 2) : a === "import" ? this.state.import.trim().length && this.time.import(this.state.import) : a === "clear" && (this.state.import = ""));
+    this.keydown = (e, can = this.config.devOnly ? CTX.isDevEnv : true, a = can && keyEventAllowed(e, keys), will = a === "toggle" || a && this.state.open) => will && (e.preventDefault(), e.stopImmediatePropagation(), a === "toggle" ? this.state.open = !this.state.open : a === "escape" ? this.state.open = false : a === "undo" ? this.time.undo(this.state.stride) : a === "redo" ? this.time.redo(this.state.stride) : a === "genesis" ? this.time.jumpTo(0) : a === "trackUntrack" ? this.time[s.tracking ? "untrack" : "track"]() : a === "ending" ? this.time.jumpTo(s.history.length) : a === "rewind" ? this.time.rewind() : a === "playPause" ? this.time[s.paused ? "play" : "pause"]() : a === "prune" ? this.time.prune() : a === "reset" ? this.time.reset() : a === "export" ? this.state.import = this.time.export(null, 2) : a === "import" ? this.state.import.trim().length && this.time.import(this.state.import) : a === "clear" ? this.state.import = "" : a === "copy" && this.state.import.trim().length && navigator.clipboard?.writeText(this.state.import).catch?.(() => {
+    }));
     window.addEventListener("keydown", this.keydown, { capture: true });
     const sync = [
       effect(() => this.config.color ? host.style.setProperty("--sia-tt-color", this.config.color) : host.style.removeProperty("--sia-tt-color")),
@@ -1298,7 +1283,7 @@ var TimeTravelConsole = class _TimeTravelConsole {
       effect(() => trackUntrack.textContent = `${s.tracking ? "Untrack" : "Track"}${formatKeyTooltip(keys.shortcuts.trackUntrack)}`),
       effect((sets = 0, txs = 0) => {
         range.max = String(s.history.length);
-        range.disabled = clrHistory.disabled = !s.history.length;
+        range.disabled = reset.disabled = !s.history.length;
         for (let i = 0, len = s.history.length; i < len; i++) {
           const frame2 = s.history[i];
           "nodes" in frame2 ? txs++ : frame2.type === "set" && sets++;
@@ -1308,16 +1293,17 @@ var TimeTravelConsole = class _TimeTravelConsole {
       effect(() => {
         frame.textContent = `Frame: ${s.currentFrame} / ${s.history.length}`;
         genesis.disabled = undo.disabled = !this.time.canUndo;
+        redo.disabled = prune.disabled = !this.time.canRedo;
+        playPause.disabled = s.paused && redo.disabled;
         rewind.disabled = !s.paused || !s.currentFrame;
-        playPause.disabled = redo.disabled = !this.time.canRedo;
         range.value = String(Math.min(s.currentFrame, s.history.length));
         payload.value = JSON.stringify(s.currentFrame ? s.history[s.currentFrame - 1] : { genesis: true, value: s.initialState }, null, 2);
       }),
       effect(() => {
-        clr.disabled = imp.disabled = !this.state.import.trim().length;
+        clr.disabled = copy.disabled = imp.disabled = !this.state.import.trim().length;
         io.value !== this.state.import && (io.value = this.state.import);
       }),
-      effect((v = String(this.time.config.playbackRate)) => v !== speed.value && (speed.value = v)),
+      effect((v = String(s.playbackRate)) => v !== speed.value && (speed.value = v)),
       effect((v = String(this.state.stride)) => v !== stride.value && (stride.value = v)),
       effect((v = String(this.time.config.limit)) => v !== limit.value && (limit.value = v)),
       effect((v = String(this.time.config.maxPlaybackDelay)) => v !== delay.value && (delay.value = v)),