sia-reactor 0.0.19 → 0.0.21

package/dist/plugins.js

@@ -1,13 +1,12 @@
 import {
   reactive
-} from "./chunk-KIQP7G7W.js";
+} from "./chunk-2WBPGSRL.js";
 import {
   clamp,
   guardAllMethods,
   guardMethod,
   setTimeout
-} from "./chunk-UQIMMJTY.js";
-import "./chunk-Q2AKMIHN.js";
+} from "./chunk-P37ADJMM.js";
 import {
   NOOP,
   deepClone,
@@ -17,9 +16,9 @@ import {
   isPOJO,
   mergeObjs,
   setAny
-} from "./chunk-4MJUBEI7.js";
+} from "./chunk-DP74DVRT.js";
 
-// src/plugins/base.ts
+// src/ts/plugins/base.ts
 var BaseReactorPlugin = class {
   static plugName;
   get name() {
@@ -57,7 +56,7 @@ var BaseReactorPlugin = class {
   // `()=>{}`: needs to be bounded even before initialization
 };
 
-// src/utils/store.ts
+// src/ts/utils/store.ts
 var BaseStorageAdapter = class {
   static name;
   config;
@@ -191,7 +190,7 @@ var IndexedDBAdapter = class extends AsyncStorageAdapter {
 };
 var INDEXED_DB_ADAPTER_BUILD = { dbName: "REACTOR_IDB", stores: ["VAULT"], version: 1, onidb: NOOP, onupgradeneeded: NOOP, onversionchange: NOOP, onsuccess: NOOP, onerror: NOOP, onblocked: NOOP };
 
-// src/plugins/persist.ts
+// src/ts/plugins/persist.ts
 var PersistPlugin = class extends BaseReactorPlugin {
   static plugName = "persist";
   adapter;
@@ -244,12 +243,13 @@ var PersistPlugin = class extends BaseReactorPlugin {
 };
 var PERSIST_PLUGIN_BUILD = { disabled: false, key: "REACTOR_STORE", throttle: 2500, useSnapshot: false };
 
-// src/plugins/timeTravel.ts
+// src/ts/plugins/timeTravel.ts
 var TimeTravelPlugin = class extends BaseReactorPlugin {
   static plugName = "timeTravel";
+  lastTimestamp = 0;
   playbackTimeoutId = -1;
   constructor(config, rtr) {
-    super({ ...TIME_TRAVEL_PLUGIN_BUILD, ...config }, rtr, { history: [], initialState: null, currentFrame: 0, paused: true });
+    super({ ...TIME_TRAVEL_PLUGIN_BUILD, ...config }, rtr, { initialState: null, history: [], currentFrame: 0, paused: true });
   }
   // ===========================================================================
   // THE FOUNDATION & WIRETAP (Passive Recording)
@@ -257,6 +257,7 @@ var TimeTravelPlugin = class extends BaseReactorPlugin {
   wire() {
     this.rtr.config.referenceTracking = this.rtr.config.smartCloning = this.rtr.config.eventTimeStamps = true;
     if (!this.state.history.length || this.state.initialState == null) this.state.initialState = this.rtr.snapshot();
+    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.handlePathsState, { signal: this.signal, immediate: true });
     !this.state.paused && this.play();
@@ -270,16 +271,17 @@ var TimeTravelPlugin = class extends BaseReactorPlugin {
     if (!this.state.paused) return;
     if (this.state.currentFrame < this.state.history.length) this.state.history = this.state.history.slice(0, this.state.currentFrame);
     if (this.state.history.length >= this.config.maxHistoryLength) this.state.history = this.state.history.slice(1);
-    this.state.history.push({ timestamp: e.timestamp ?? performance.now(), path: e.target.path, type: e.staticType, value: this.rtr.snapshot(false, e.target.value), oldValue: this.rtr.snapshot(false, e.target.oldValue), keyExisted: e.target.keyExisted, rejected: e.rejected });
+    this.state.history.push({ path: e.target.path, value: this.rtr.snapshot(false, e.target.value), oldValue: this.rtr.snapshot(false, e.target.oldValue), type: e.staticType, rejected: e.rejected, timedelta: e.timestamp - this.lastTimestamp, hadKey: e.target.hadKey });
     this.state.currentFrame = this.state.history.length;
+    this.lastTimestamp = e.timestamp;
   }
   /** Clears timeline history and resets playhead/genesis to the current reactor state. */
   clear() {
     this.pause();
     this.playbackTimeoutId = -1;
-    this.state.history = [];
-    this.state.currentFrame = 0;
+    this.state.history.length = this.state.currentFrame = 0;
     this.state.initialState = this.rtr.snapshot();
+    this.lastTimestamp = performance.now();
   }
   // ===========================================================================
   // THE TIME MACHINE (Manual Controls)
@@ -292,7 +294,7 @@ var TimeTravelPlugin = class extends BaseReactorPlugin {
       const e = this.state.history[forward ? this.state.currentFrame : this.state.currentFrame - 1];
       if (!e) break;
       if (forward) e.type === "delete" ? deleteAny(this.rtr.core, e.path) : setAny(this.rtr.core, e.path, deepClone(e.value, this.rtr.config));
-      else !e.keyExisted ? deleteAny(this.rtr.core, e.path) : setAny(this.rtr.core, e.path, deepClone(e.oldValue, this.rtr.config));
+      else !e.hadKey ? deleteAny(this.rtr.core, e.path) : setAny(this.rtr.core, e.path, deepClone(e.oldValue, this.rtr.config));
       forward ? this.state.currentFrame++ : this.state.currentFrame--;
       if (e.rejected) this.rtr.log(`[Reactor ${this.name} Plug] ${forward ? "Replaying" : "Reversing"} REJECTED intent at "${e.path}"`);
     }
@@ -315,9 +317,9 @@ var TimeTravelPlugin = class extends BaseReactorPlugin {
   async automove(forward = true) {
     this.state.paused = false;
     while ((forward ? this.state.currentFrame < this.state.history.length : this.state.currentFrame > 0) && !this.state.paused) {
-      const currIndex = forward ? this.state.currentFrame : this.state.currentFrame - 1, e = this.state.history[currIndex], nextE = this.state.history[forward ? currIndex + 1 : currIndex - 1], delay = nextE && e ? Math.abs(nextE.timestamp - e.timestamp) : 0;
+      const currIndex = forward ? this.state.currentFrame : this.state.currentFrame - 1, e = this.state.history[forward ? currIndex + 1 : currIndex - 1];
       this.jumpTo(this.state.currentFrame + (forward ? 1 : -1), true);
-      if (delay > 0) await new Promise((res) => this.playbackTimeoutId = setTimeout(() => res(0), clamp(0, delay, this.config.maxPlaybackDelay), this.signal));
+      if (e?.timedelta > 0) await new Promise((res) => this.playbackTimeoutId = setTimeout(() => res(0), Math.min(e.timedelta, this.config.maxPlaybackDelay), this.signal));
     }
     this.state.paused = true;
   }
@@ -331,21 +333,24 @@ var TimeTravelPlugin = class extends BaseReactorPlugin {
   // TELEMETRY & I/O (Session Import/Export)
   // ===========================================================================
   /** Exports the current session as a JSON string. */
-  export() {
-    return JSON.stringify(this.state);
+  export(replacer, space) {
+    try {
+      return JSON.stringify(this.state, replacer, space);
+    } catch (e) {
+      return this.rtr.log(`[Reactor ${this.name} Plug] Failed to export session`), "";
+    }
   }
   /** Imports a session from a JSON string, allowing you to replay or analyze past states. */
   import(json) {
     try {
       setAny(this.state, "*", JSON.parse(json));
+      this.lastTimestamp = performance.now();
       const resume = !this.state.paused, target = this.state.currentFrame;
       this.state.paused = false;
-      setAny(this.rtr.core, "*", deepClone(this.state.initialState, this.rtr.config));
-      this.rtr.tick();
-      this.state.currentFrame = 0;
-      this.jumpTo(target), resume && this.play();
+      setAny(this.rtr.core, "*", deepClone(this.state.initialState, this.rtr.config)), this.rtr.tick();
+      this.state.currentFrame = 0, this.jumpTo(target), resume && this.play();
     } catch (e) {
-      this.rtr.log(`[Reactor ${this.name} Plug] Failed to load session`, "error");
+      this.rtr.log(`[Reactor ${this.name} Plug] Failed to load session`);
     }
   }
 };

package/dist/styles/time-travel-overlay.css

@@ -0,0 +1,189 @@
+.tt-overlay-host {
+  --sia-tt-color: #e26e02;
+  --sia-tt-bg: rgb(from var(--sia-tt-color) calc((r * 0.09) + 6) calc((g * 0.08) + 7) calc((b * 0.1) + 10) / 0.66);
+  --sia-tt-bg-soft: rgb(from var(--sia-tt-color) calc((r * 0.11) + 9) calc((g * 0.1) + 9) calc((b * 0.12) + 12) / 0.64);
+  --sia-tt-line: hsl(from var(--sia-tt-color) h calc(s * 0.1) 24% / 0.6);
+  --sia-tt-text: rgb(from var(--sia-tt-color) calc((r * 0.2) + 218) calc((g * 0.11) + 214) calc((b * 0.09) + 214));
+  --sia-tt-muted: rgb(from var(--sia-tt-color) calc((r * 0.24) + 150) calc((g * 0.14) + 146) calc((b * 0.12) + 146));
+  --sia-tt-input-bg: rgb(from var(--sia-tt-color) calc((r * 0.08) + 8) calc((g * 0.07) + 8) calc((b * 0.09) + 10) / 0.66);
+  position: relative;
+}
+
+:where(.tt-overlay-host) *::selection {
+  color: currentColor;
+  background-color: var(--sia-tt-color);
+}
+.tt-overlay-host :is(*:focus-visible, #o#o#o#o#o) {
+  outline: 1.5px dashed var(--sia-tt-color);
+  outline-offset: 1px;
+  transition: none;
+}
+.tt-overlay input[type="range"]:focus-visible {
+  outline-offset: 1px;
+}
+
+.tt-overlay-layer {
+  inset: 0;
+  z-index: 60;
+  pointer-events: none;
+}
+
+.tt-overlay-dock {
+  position: absolute;
+  right: 18px;
+  bottom: 18px;
+  display: flex;
+  gap: 8px;
+  justify-content: flex-end;
+  pointer-events: auto;
+}
+
+.tt-overlay-toggle {
+  position: relative;
+  z-index: 1;
+  color: var(--sia-tt-text);
+  background: var(--sia-tt-bg-soft);
+  border: 1px solid var(--sia-tt-line);
+  border-radius: 8px;
+  font-size: 0.75rem;
+  line-height: 1.1;
+  padding: 5px 8px;
+  cursor: pointer;
+  pointer-events: auto;
+}
+
+.tt-overlay {
+  position: absolute;
+  right: 0;
+  bottom: calc(100% + 8px);
+  width: min(360px, calc(100vw - 50px));
+  background: var(--sia-tt-bg);
+  border: 1px solid var(--sia-tt-line);
+  border-radius: 12px;
+  padding: 12px;
+  display: grid;
+  gap: 8px;
+  z-index: 39;
+  color: var(--sia-tt-text);
+  -webkit-backdrop-filter: blur(6px);
+  backdrop-filter: blur(6px);
+  pointer-events: auto;
+  opacity: 1;
+  transform: translateY(0) scale(1);
+  transform-origin: right bottom;
+  visibility: visible;
+  transition: opacity 160ms ease, transform 180ms ease, visibility 0ms linear;
+}
+
+.tt-overlay[hidden] {
+  opacity: 0;
+  transform: translateY(6px) scale(0.985);
+  visibility: hidden;
+  pointer-events: none;
+  transition: opacity 140ms ease, transform 160ms ease, visibility 0ms linear 160ms;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .tt-overlay,
+  .tt-overlay[hidden] {
+    transition: none;
+  }
+}
+
+.tt-overlay .title {
+  color: var(--sia-tt-color);
+  font-weight: bold;
+}
+
+.tt-overlay button {
+  border: 1px solid var(--sia-tt-line);
+  background: var(--sia-tt-bg-soft);
+  color: var(--sia-tt-text);
+  border-radius: 8px;
+  padding: 5px 8px;
+  font-size: 0.75rem;
+  line-height: 1.1;
+  cursor: pointer;
+}
+
+.tt-overlay button:hover {
+  border-color: hsl(from var(--sia-tt-color) h calc(s * 0.35) 40% / 0.9);
+}
+
+.tt-overlay button:disabled {
+  opacity: 0.7;
+  cursor: not-allowed;
+  color: var(--sia-tt-muted);
+}
+
+.tt-status-row {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  justify-content: space-between;
+}
+
+.tt-status-row > button {
+  white-space: nowrap;
+}
+
+.tt-status-box {
+  display: grid;
+  gap: 4px;
+  flex: 1;
+  min-width: 0;
+}
+
+.tt-status-box .muted {
+  margin: 0;
+  font-size: 0.75rem;
+}
+
+.tt-row {
+  display: flex;
+  gap: 8px;
+  justify-content: center;
+}
+
+.tt-overlay input[type="range"] {
+  width: 100%;
+  height: 5px;
+  accent-color: var(--sia-tt-color);
+  border-radius: 8px;
+}
+
+.tt-io {
+  min-height: 84px;
+  max-height: calc((100vh - 318px) / 2);
+  resize: vertical;
+  border: 1px solid var(--sia-tt-line);
+  background: var(--sia-tt-input-bg);
+  color: var(--sia-tt-text);
+  font-size: 0.75rem;
+  border-radius: 8px;
+  padding: 8px;
+  scrollbar-width: thin;
+  scrollbar-color: var(--sia-tt-color) var(--sia-tt-bg-soft);
+}
+
+.tt-io::placeholder {
+  color: var(--sia-tt-muted);
+}
+
+.tt-footnote {
+  margin: 2px 2px 0;
+  font-size: 0.72rem;
+  line-height: 1.35;
+  color: var(--sia-tt-muted);
+  text-align: right;
+}
+
+.tt-footnote a {
+  color: var(--sia-tt-color);
+  text-decoration: none;
+  border-bottom: 1px solid var(--sia-tt-line);
+}
+
+.tt-footnote a:hover {
+  text-decoration: underline;
+}

package/dist/super.d.ts

@@ -172,7 +172,7 @@ type RDepth = 10; // current limit for state trees, observed ts max - 19; limit
 type RPrev = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19];
 
 /** Reactor method names exposed on objects returned by {@link reactive}. */
-declare const methods: readonly ["tick", "stall", "nostall", "get", "gonce", "noget", "set", "sonce", "noset", "delete", "donce", "nodelete", "watch", "wonce", "nowatch", "on", "once", "off", "cascade", "snapshot", "reset", "destroy"];
+declare const methods: readonly ["tick", "stall", "nostall", "get", "gonce", "noget", "set", "sonce", "noset", "delete", "donce", "nodelete", "watch", "wonce", "nowatch", "on", "once", "off", "snapshot", "cascade", "plugIn", "reset", "destroy"];
 type Method = (typeof methods)[number];
 type Prefix<P extends ReactivePreferences | undefined> = P extends {
     prefix?: infer X extends string;
@@ -203,6 +203,7 @@ type Reactive<T extends object, P extends ReactivePreferences | undefined = unde
 };
 /**
  * Attaches Reactor APIs to a state object and returns its reactive proxy.
+ * If an existing `reactive()` return value is passed, it is re-returned ignoring change in preferences.
  * @param target Source state object or an existing Reactor instance.
  * @param build Reactor initial configuration.
  * @param preferences Method naming preferences for exposed APIs.
@@ -326,7 +327,7 @@ interface Target<T, P extends WildPaths<T> = WildPaths<T>> {
    * Whether the key for the value existed on the parent object.
    * For accuracy on if `key` was in the `object` rather than checking `oldValue` against undefined
    */
-  keyExisted: boolean;
+  hadKey: boolean;
   /** Parent-branch value for the path. */
   object: PathBranchValue<T, P>;
 }
@@ -363,7 +364,7 @@ interface UpdatePayload<T, P extends WildPaths<T> = WildPaths<T>> extends BasePa
 }
 
 /** Event union with payload-aware overrides for `type`, `path`, and value fields (Creates the IDE magic). */
-type REvent<T, P extends WildPaths<T> = WildPaths<T>> =
+type REvent<T extends object, P extends WildPaths<T> = WildPaths<T>> =
   | (Omit<ReactorEvent<T, P>, OverrideEvtProp> &
       DirectPayload<T, P> &
       OverrideEvtPart<DirectPayload<T, P>>)
@@ -726,7 +727,7 @@ declare abstract class BaseReactorPlugin<T extends object = any, Config = any, S
     readonly signal: AbortSignal;
     rtr: Reactor<T>;
     config: Config extends object ? Reactive<Config> : Config;
-    state: State extends object ? Reactive<State> : State;
+    readonly state: State extends object ? Reactive<State> : State;
     constructor(config?: Config, rtr?: Reactor<T>, state?: State);
     /** Entry point called to initialize plugin wiring. */
     setup(rtr?: Reactor<T>): void;
@@ -768,13 +769,13 @@ declare class Reactor<T extends object> {
     protected listeners?: Map<WildPaths<T>, Array<ListenerRecord<T>>>;
     /**
      * Creates a new Reactor instance.
-     * @param object Initial state object.
+     * @param target Initial state target.
      * @param build Reactor bootstrap/build configuration.
      * @example
      * const rtr = new Reactor({ count: 0 });
      */
-    constructor(object?: T, build?: ReactorBuild<T>);
-    proxied<O extends object>(obj: O, rejectable?: boolean, indiffable?: boolean, parent?: object, key?: string, path?: string): O;
+    constructor(target?: T, build?: ReactorBuild<T>);
+    proxied<O extends object>(target: O, rejectable?: boolean, indiffable?: boolean, parent?: object, key?: string, path?: string): O;
     trace(target: object, path: string, paths?: string[], seen?: WeakSet<object>): Paths<T>[];
     protected link(target: any, parent: object, key: string, typecheck?: boolean, es?: (object | string)[]): boolean;
     protected unlink(target: any, parent: object, key: string): void;
@@ -814,7 +815,7 @@ declare class Reactor<T extends object> {
     getDepth(path: string, depth?: number): number;
     protected getContext<P extends WildPaths<T>>(path: P): Target<T, P>;
     protected bindSignal<Cb>(cord: GetterRecord<T> | SetterRecord<T> | DeleterRecord<T> | WatcherRecord<T> | ListenerRecord<T>, sig?: AbortSignal): Cb;
-    protected cloned(obj: any, raw: boolean, seen?: WeakMap<WeakKey, any>): any;
+    protected cloned<O>(target: O, raw: boolean, seen?: WeakMap<WeakKey, any>): O;
     protected syncAdd<P extends WildPaths<T>>(key: "get" | "set" | "delete" | "watch", path: P, cb: any, opts: SyncOptions | undefined, onImmediate?: (immediate: boolean | "auto") => void): () => boolean | undefined;
     protected syncDrop<P extends WildPaths<T>>(store: Map<WildPaths<T>, any[]> | undefined, path: P, cb: any): boolean | undefined;
     /**
@@ -930,7 +931,8 @@ declare class Reactor<T extends object> {
      * @example
      * const snap = rtr.snapshot(false, rtr.core.history.past);
      */
-    snapshot(raw?: boolean, branch?: T): T;
+    snapshot(raw?: boolean): T;
+    snapshot<B>(raw?: boolean, branch?: B): B;
     /**
      * Cascades object updates into direct child paths.
      * @param payload Event or payload source.
@@ -1032,6 +1034,8 @@ declare function withTracker<T>(tracker: Autotracker<any>, run: () => T, rtr?: R
 
 /** Global context object for sharing state across the reactor runtime. */
 declare const CTX: {
+    /** Flag indicating whether the application is running in development mode. */
+    isDevEnv: boolean;
     /** active `Autotracker` instance, override for automatic dependency collection on `Reactor` traps. */
     autotracker: Autotracker<any> | null;
 };
@@ -1233,11 +1237,20 @@ declare function formatKeyShortcutsForDisplay(keyShortcuts: Record<string, strin
  */
 declare function parseForARIAKS(s: string | string[], formatted?: boolean): string;
 
+type Dataset = Record<string, string | number>;
+type Style = Partial<CSSStyleDeclaration>;
+declare function createEl<K extends keyof HTMLElementTagNameMap>(tag: K, props?: Partial<HTMLElementTagNameMap[K]>, dataset?: Dataset, styles?: Style): HTMLElementTagNameMap[K];
+declare function createEl(tag: string, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): HTMLElement | null;
+declare function assignEl<K extends keyof HTMLElementTagNameMap>(el?: HTMLElementTagNameMap[K], props?: Partial<HTMLElementTagNameMap[K]>, dataset?: Dataset, styles?: Style): void;
+declare function assignEl(el?: HTMLElement | null, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): void;
+
 type utils_KeyStruct = KeyStruct;
+declare const utils_assignEl: typeof assignEl;
 declare const utils_bindAllMethods: typeof bindAllMethods;
 declare const utils_canHandle: typeof canHandle;
 declare const utils_clamp: typeof clamp;
 declare const utils_cleanKeyCombo: typeof cleanKeyCombo;
+declare const utils_createEl: typeof createEl;
 declare const utils_deepClone: typeof deepClone;
 declare const utils_deleteAny: typeof deleteAny;
 declare const utils_formatKeyForDisplay: typeof formatKeyForDisplay;
@@ -1266,7 +1279,7 @@ declare const utils_setInterval: typeof setInterval;
 declare const utils_setTimeout: typeof setTimeout;
 declare const utils_stringifyKeyEvent: typeof stringifyKeyEvent;
 declare namespace utils {
-  export { type utils_KeyStruct as KeyStruct, utils_bindAllMethods as bindAllMethods, utils_canHandle as canHandle, utils_clamp as clamp, utils_cleanKeyCombo as cleanKeyCombo, utils_deepClone as deepClone, utils_deleteAny as deleteAny, utils_formatKeyForDisplay as formatKeyForDisplay, utils_formatKeyShortcutsForDisplay as formatKeyShortcutsForDisplay, utils_getAny as getAny, utils_getTermsForKey as getTermsForKey, utils_getTrailRecords as getTrailRecords, utils_guardAllMethods as guardAllMethods, utils_guardMethod as guardMethod, utils_inAny as inAny, utils_isObj as isObj, utils_isPOJO as isPOJO, utils_keyEventAllowed as keyEventAllowed, type utils_keysSettings as keysSettings, utils_matchKeys as matchKeys, utils_mergeObjs as mergeObjs, utils_nuke as nuke, utils_onAllMethods as onAllMethods, utils_parseAnyObj as parseAnyObj, utils_parseEvtOpts as parseEvtOpts, utils_parseForARIAKS as parseForARIAKS, utils_parseKeyCombo as parseKeyCombo, utils_requestAnimationFrame as requestAnimationFrame, utils_setAny as setAny, utils_setInterval as setInterval, utils_setTimeout as setTimeout, utils_stringifyKeyEvent as stringifyKeyEvent };
+  export { type utils_KeyStruct as KeyStruct, utils_assignEl as assignEl, utils_bindAllMethods as bindAllMethods, utils_canHandle as canHandle, utils_clamp as clamp, utils_cleanKeyCombo as cleanKeyCombo, utils_createEl as createEl, utils_deepClone as deepClone, utils_deleteAny as deleteAny, utils_formatKeyForDisplay as formatKeyForDisplay, utils_formatKeyShortcutsForDisplay as formatKeyShortcutsForDisplay, utils_getAny as getAny, utils_getTermsForKey as getTermsForKey, utils_getTrailRecords as getTrailRecords, utils_guardAllMethods as guardAllMethods, utils_guardMethod as guardMethod, utils_inAny as inAny, utils_isObj as isObj, utils_isPOJO as isPOJO, utils_keyEventAllowed as keyEventAllowed, type utils_keysSettings as keysSettings, utils_matchKeys as matchKeys, utils_mergeObjs as mergeObjs, utils_nuke as nuke, utils_onAllMethods as onAllMethods, utils_parseAnyObj as parseAnyObj, utils_parseEvtOpts as parseEvtOpts, utils_parseForARIAKS as parseForARIAKS, utils_parseKeyCombo as parseKeyCombo, utils_requestAnimationFrame as requestAnimationFrame, utils_setAny as setAny, utils_setInterval as setInterval, utils_setTimeout as setTimeout, utils_stringifyKeyEvent as stringifyKeyEvent };
 }
 
 interface StorageAdapterConfig {
@@ -1378,22 +1391,22 @@ declare const PERSIST_PLUGIN_BUILD: Partial<PersistConfig<any>>;
 
 /** The DNA of a specific moment in time, Records the 'Desire' (Intent) or the 'Fact' (State). */
 interface HistoryEntry {
-    /**  Was it a 'set' or a 'delete' surgery? */
-    type: REvent<any, any>["staticType"];
     /** The surgical address in the Reactor */
     path: string;
     /** The data payload at that moment */
     value: any;
     /** The "Undo" antidote (Previous value), if applicable */
     oldValue: any;
-    /** Did the key for the value exist on its parent object? */
-    keyExisted: boolean;
+    /**  Was it a 'set' or a 'delete' surgery? */
+    type: REvent<any, any>["staticType"];
     /** Did the Power Line disapprove?; why? */
     rejected: string;
     /** For chronological re-enactment */
-    timestamp: number;
+    timedelta: number;
+    /** Did the key for the value exist on its parent object? */
+    hadKey: boolean;
 }
-interface TimeTravelConfig<T extends object = any> {
+interface TimeTravelConfig$1<T extends object = any> {
     /** Specific paths only, no "*"; instead don't pass anything */
     paths?: Paths<T>[];
     /** Maximum number of history entries to keep (Memory Cap), you lose replaying Sessions or the Genesis */
@@ -1402,10 +1415,10 @@ interface TimeTravelConfig<T extends object = any> {
     maxPlaybackDelay: number;
 }
 interface TimeTravelState {
-    /** The "Timeline" of mutations (Chronological Log) */
-    history: HistoryEntry[];
     /** The "Genesis" snapshot (Raw Data) */
     initialState: any;
+    /** The "Timeline" of mutations (Chronological Log) */
+    history: HistoryEntry[];
     /** The manual playhead (Index in the Timeline) */
     currentFrame: number;
     /** Whether playback is currently paused (Automatic Replay) */
@@ -1415,12 +1428,13 @@ interface TimeTravelState {
  * The Flight Recorder (Black Box).
  * - Implements S.I.A. logic to allow playback, teleportation, redos and undos.
  */
-declare class TimeTravelPlugin<T extends object = any> extends BaseReactorPlugin<T, TimeTravelConfig<T>, TimeTravelState> {
+declare class TimeTravelPlugin<T extends object = any> extends BaseReactorPlugin<T, TimeTravelConfig$1<T>, TimeTravelState> {
     static readonly plugName = "timeTravel";
+    protected lastTimestamp: number;
     protected playbackTimeoutId: number;
-    constructor(config?: Partial<TimeTravelConfig<T>>, rtr?: Reactor<T>);
+    constructor(config?: Partial<TimeTravelConfig$1<T>>, rtr?: Reactor<T>);
     wire(): void;
-    protected handlePathsState({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<T>, "paths">): void;
+    protected handlePathsState({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig$1<T>, "paths">): void;
     /** Chronicling the lifecycle of the system, Captures the essence of every mutation wave that bubbles up. */
     protected record(e: REvent<T, any>): void;
     /** Clears timeline history and resets playhead/genesis to the current reactor state. */
@@ -1442,11 +1456,11 @@ declare class TimeTravelPlugin<T extends object = any> extends BaseReactorPlugin
     /** Pauses the live VCR playback. */
     pause: () => void;
     /** Exports the current session as a JSON string. */
-    export(): string;
+    export(replacer?: ((this: any, key: string, value: any) => any) | (number | string)[] | null, space?: string | number): string;
     /** Imports a session from a JSON string, allowing you to replay or analyze past states. */
     import(json: string): void;
 }
-declare const TIME_TRAVEL_PLUGIN_BUILD: Partial<TimeTravelConfig>;
+declare const TIME_TRAVEL_PLUGIN_BUILD: Partial<TimeTravelConfig$1>;
 
 type plugins_AsyncStorageAdapterConstructor<Config extends StorageAdapterConfig = StorageAdapterConfig> = AsyncStorageAdapterConstructor<Config>;
 type plugins_BaseReactorPlugin<T extends object = any, Config = any, State = any> = BaseReactorPlugin<T, Config, State>;
@@ -1473,12 +1487,11 @@ declare const plugins_StorageAdapter: typeof StorageAdapter;
 type plugins_StorageAdapterConfig = StorageAdapterConfig;
 type plugins_StorageAdapterConstructor<Config extends StorageAdapterConfig = StorageAdapterConfig> = StorageAdapterConstructor<Config>;
 declare const plugins_TIME_TRAVEL_PLUGIN_BUILD: typeof TIME_TRAVEL_PLUGIN_BUILD;
-type plugins_TimeTravelConfig<T extends object = any> = TimeTravelConfig<T>;
 type plugins_TimeTravelPlugin<T extends object = any> = TimeTravelPlugin<T>;
 declare const plugins_TimeTravelPlugin: typeof TimeTravelPlugin;
 type plugins_TimeTravelState = TimeTravelState;
 declare namespace plugins {
-  export { type plugins_AsyncStorageAdapterConstructor as AsyncStorageAdapterConstructor, plugins_BaseReactorPlugin as BaseReactorPlugin, plugins_BaseStorageAdapter as BaseStorageAdapter, type plugins_HistoryEntry as HistoryEntry, plugins_INDEXED_DB_ADAPTER_BUILD as INDEXED_DB_ADAPTER_BUILD, plugins_IndexedDBAdapter as IndexedDBAdapter, type plugins_IndexedDBAdapterConfig as IndexedDBAdapterConfig, plugins_LocalStorageAdapter as LocalStorageAdapter, plugins_MemoryStorageAdapter as MemoryStorageAdapter, type plugins_MemoryStorageAdapterConfig as MemoryStorageAdapterConfig, plugins_PERSIST_PLUGIN_BUILD as PERSIST_PLUGIN_BUILD, type plugins_PersistConfig as PersistConfig, plugins_PersistPlugin as PersistPlugin, type plugins_ReactorPluginConstructor as ReactorPluginConstructor, plugins_StorageAdapter as StorageAdapter, type plugins_StorageAdapterConfig as StorageAdapterConfig, type plugins_StorageAdapterConstructor as StorageAdapterConstructor, plugins_TIME_TRAVEL_PLUGIN_BUILD as TIME_TRAVEL_PLUGIN_BUILD, type plugins_TimeTravelConfig as TimeTravelConfig, plugins_TimeTravelPlugin as TimeTravelPlugin, type plugins_TimeTravelState as TimeTravelState };
+  export { type plugins_AsyncStorageAdapterConstructor as AsyncStorageAdapterConstructor, plugins_BaseReactorPlugin as BaseReactorPlugin, plugins_BaseStorageAdapter as BaseStorageAdapter, type plugins_HistoryEntry as HistoryEntry, plugins_INDEXED_DB_ADAPTER_BUILD as INDEXED_DB_ADAPTER_BUILD, plugins_IndexedDBAdapter as IndexedDBAdapter, type plugins_IndexedDBAdapterConfig as IndexedDBAdapterConfig, plugins_LocalStorageAdapter as LocalStorageAdapter, plugins_MemoryStorageAdapter as MemoryStorageAdapter, type plugins_MemoryStorageAdapterConfig as MemoryStorageAdapterConfig, plugins_PERSIST_PLUGIN_BUILD as PERSIST_PLUGIN_BUILD, type plugins_PersistConfig as PersistConfig, plugins_PersistPlugin as PersistPlugin, type plugins_ReactorPluginConstructor as ReactorPluginConstructor, plugins_StorageAdapter as StorageAdapter, type plugins_StorageAdapterConfig as StorageAdapterConfig, type plugins_StorageAdapterConstructor as StorageAdapterConstructor, plugins_TIME_TRAVEL_PLUGIN_BUILD as TIME_TRAVEL_PLUGIN_BUILD, type TimeTravelConfig$1 as TimeTravelConfig, plugins_TimeTravelPlugin as TimeTravelPlugin, type plugins_TimeTravelState as TimeTravelState };
 }
 
 /**
@@ -1493,12 +1506,52 @@ declare namespace plugins {
  */
 declare function effect(callback: () => void, options?: EffectOptions): () => void;
 
+/** Reactive options for the TimeTravel overlay instance. */
+interface TimeTravelConfig {
+    /** Header text shown at the top of the overlay panel. */
+    title: string;
+    /** Accent color used to derive panel theme variables. */
+    color: string;
+    /** Shows the overlay only in development when true. */
+    devOnly: boolean;
+    /** Initial open state applied when the overlay is created. */
+    startOpen: boolean;
+    /** Container element that owns the overlay layer and dock. */
+    container: HTMLElement;
+}
+/** Vanilla overlay controller for visual time-travel controls and timeline I/O.
+ * Mounts a docked HUD into the configured container, syncs its UI with plugin state, and forwards keyboard/button actions to the TimeTravelPlugin.
+ * Supports reactive `config` updates (title/color/container/devOnly) and maintains local overlay UI state (`open` and `import` payload text).
+ */
+declare class TimeTravelOverlay {
+    static count: number;
+    index: number;
+    config: TimeTravelConfig;
+    readonly state: Reactive<{
+        open: boolean;
+        import: string;
+    }, undefined>;
+    readonly time: TimeTravelPlugin;
+    readonly els: Record<string, HTMLElement>;
+    private clups;
+    private keyup?;
+    /** Creates a docked TimeTravel overlay bound to a plugin instance.
+     * @param time TimeTravel plugin instance that owns timeline operations.
+     * @param build Optional initial overlay config overrides.
+     */
+    constructor(time: TimeTravelPlugin, build?: Partial<TimeTravelConfig>);
+    destroy(): void;
+}
+
 type vanilla_Autotracker<T extends object> = Autotracker<T>;
 declare const vanilla_Autotracker: typeof Autotracker;
+type vanilla_TimeTravelConfig = TimeTravelConfig;
+type vanilla_TimeTravelOverlay = TimeTravelOverlay;
+declare const vanilla_TimeTravelOverlay: typeof TimeTravelOverlay;
 declare const vanilla_effect: typeof effect;
 declare const vanilla_withTracker: typeof withTracker;
 declare namespace vanilla {
-  export { vanilla_Autotracker as Autotracker, vanilla_effect as effect, vanilla_withTracker as withTracker };
+  export { vanilla_Autotracker as Autotracker, type vanilla_TimeTravelConfig as TimeTravelConfig, vanilla_TimeTravelOverlay as TimeTravelOverlay, vanilla_effect as effect, vanilla_withTracker as withTracker };
 }
 
 declare const adapters: {