sia-reactor 0.0.19 → 0.0.21

package/dist/timeTravel-B1vedDQc.d.ts

@@ -0,0 +1,76 @@
+import { a as REvent, P as Paths, B as BaseReactorPlugin, b as Reactor } from './index-Oie9hhE8.js';
+
+/** The DNA of a specific moment in time, Records the 'Desire' (Intent) or the 'Fact' (State). */
+interface HistoryEntry {
+    /** 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;
+    /**  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 */
+    timedelta: number;
+    /** Did the key for the value exist on its parent object? */
+    hadKey: boolean;
+}
+interface TimeTravelConfig<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 */
+    maxHistoryLength: number;
+    /** Max delay between events during playback (ms) */
+    maxPlaybackDelay: number;
+}
+interface TimeTravelState {
+    /** 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) */
+    paused: boolean;
+}
+/**
+ * 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> {
+    static readonly plugName = "timeTravel";
+    protected lastTimestamp: number;
+    protected playbackTimeoutId: number;
+    constructor(config?: Partial<TimeTravelConfig<T>>, rtr?: Reactor<T>);
+    wire(): void;
+    protected handlePathsState({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<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. */
+    clear(): void;
+    /** Instant state reconstruction (Teleport). Glides through deltas natively. */
+    jumpTo(index?: number, keepShield?: boolean): void;
+    /** Step through time, Moves the playhead and teleports the state. */
+    step(stride?: number, forward?: boolean): void;
+    /** Step back in time, Moves the playhead backward and teleports the state. */
+    undo: () => void;
+    /** Step forward in time, Restores previously undone actions. */
+    redo: () => void;
+    /** Core automove engine. Replays or rewinds the "Story" by respecting time gaps. */
+    automove(forward?: boolean): Promise<void>;
+    /** Start chronological re-enactment of the session. */
+    play: () => Promise<void>;
+    /** Start reverse chronological re-enactment of the session. */
+    rewind: () => Promise<void>;
+    /** Pauses the live VCR playback. */
+    pause: () => void;
+    /** Exports the current session as a JSON 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>;
+
+export { type HistoryEntry as H, TimeTravelPlugin as T, TIME_TRAVEL_PLUGIN_BUILD as a, type TimeTravelConfig as b, type TimeTravelState as c };

package/dist/timeTravel-WpgWmKu-.d.cts

@@ -0,0 +1,76 @@
+import { a as REvent, P as Paths, B as BaseReactorPlugin, b as Reactor } from './index-Oie9hhE8.cjs';
+
+/** The DNA of a specific moment in time, Records the 'Desire' (Intent) or the 'Fact' (State). */
+interface HistoryEntry {
+    /** 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;
+    /**  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 */
+    timedelta: number;
+    /** Did the key for the value exist on its parent object? */
+    hadKey: boolean;
+}
+interface TimeTravelConfig<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 */
+    maxHistoryLength: number;
+    /** Max delay between events during playback (ms) */
+    maxPlaybackDelay: number;
+}
+interface TimeTravelState {
+    /** 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) */
+    paused: boolean;
+}
+/**
+ * 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> {
+    static readonly plugName = "timeTravel";
+    protected lastTimestamp: number;
+    protected playbackTimeoutId: number;
+    constructor(config?: Partial<TimeTravelConfig<T>>, rtr?: Reactor<T>);
+    wire(): void;
+    protected handlePathsState({ value: paths, oldValue: prevs }: REvent<TimeTravelConfig<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. */
+    clear(): void;
+    /** Instant state reconstruction (Teleport). Glides through deltas natively. */
+    jumpTo(index?: number, keepShield?: boolean): void;
+    /** Step through time, Moves the playhead and teleports the state. */
+    step(stride?: number, forward?: boolean): void;
+    /** Step back in time, Moves the playhead backward and teleports the state. */
+    undo: () => void;
+    /** Step forward in time, Restores previously undone actions. */
+    redo: () => void;
+    /** Core automove engine. Replays or rewinds the "Story" by respecting time gaps. */
+    automove(forward?: boolean): Promise<void>;
+    /** Start chronological re-enactment of the session. */
+    play: () => Promise<void>;
+    /** Start reverse chronological re-enactment of the session. */
+    rewind: () => Promise<void>;
+    /** Pauses the live VCR playback. */
+    pause: () => void;
+    /** Exports the current session as a JSON 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>;
+
+export { type HistoryEntry as H, TimeTravelPlugin as T, TIME_TRAVEL_PLUGIN_BUILD as a, type TimeTravelConfig as b, type TimeTravelState as c };

package/dist/utils.cjs

@@ -17,13 +17,15 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/utils.ts
+// src/ts/utils.ts
 var utils_exports = {};
 __export(utils_exports, {
+  assignEl: () => assignEl,
   bindAllMethods: () => bindAllMethods,
   canHandle: () => canHandle,
   clamp: () => clamp,
   cleanKeyCombo: () => cleanKeyCombo,
+  createEl: () => createEl,
   deepClone: () => deepClone,
   deleteAny: () => deleteAny,
   formatKeyForDisplay: () => formatKeyForDisplay,
@@ -53,13 +55,19 @@ __export(utils_exports, {
 });
 module.exports = __toCommonJS(utils_exports);
 
-// src/core/consts.ts
+// src/ts/core/consts.ts
+var CTX = {
+  /** Flag indicating whether the application is running in development mode. */
+  isDevEnv: "undefined" !== typeof process ? process.env.NODE_ENV !== "production" : true,
+  /** active `Autotracker` instance, override for automatic dependency collection on `Reactor` traps. */
+  autotracker: null
+};
 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 EVT_WARN = console.warn.bind(console, "[S.I.A Event]");
 var NIL = Object.freeze({});
 
-// src/utils/obj.ts
+// src/ts/utils/obj.ts
 var arrRx = /^([^\[\]]+)\[(\d+)\]$/;
 function isObj(obj, arraycheck = true) {
   return "object" === typeof obj && obj !== null && (arraycheck ? !Array.isArray(obj) : true);
@@ -193,12 +201,12 @@ function nuke(target) {
   }
 }
 
-// src/utils/num.ts
+// src/ts/utils/num.ts
 function clamp(min = 0, val, max = Infinity) {
   return Math.min(Math.max(val, min), max);
 }
 
-// src/utils/fn.ts
+// src/ts/utils/fn.ts
 function setTimeout2(handler, timeout, ...args) {
   const sig = args[0] instanceof AbortSignal ? args.shift() : void 0;
   if (sig?.aborted) return -1;
@@ -220,7 +228,7 @@ function requestAnimationFrame(callback, sig, win = window) {
   return sig.addEventListener("abort", kill, { once: true }), id;
 }
 
-// src/utils/methd.ts
+// src/ts/utils/methd.ts
 function onAllMethods(owner, callback, skipOwn = true, nested = false) {
   let proto = owner;
   while (proto && proto !== Object.prototype) {
@@ -253,7 +261,7 @@ function guardMethod(fn, onError = (e) => console.error(e)) {
   });
 }
 
-// src/utils/keys.ts
+// src/ts/utils/keys.ts
 function parseKeyCombo(combo) {
   const parts = cleanKeyCombo(combo).toLowerCase().split("+");
   return { ctrlKey: parts.includes("ctrl"), shiftKey: parts.includes("shift"), altKey: parts.includes("alt"), metaKey: parts.includes("meta") || parts.includes("cmd"), key: parts.find((p) => !["ctrl", "shift", "alt", "meta", "cmd"].includes(p)) || "" };
@@ -315,12 +323,31 @@ function parseForARIAKS(s, formatted = true) {
   const m = { ctrl: "Control", cmd: "Meta", space: "Space", plus: "+" };
   return (formatted && !Array.isArray(s) ? s : formatKeyForDisplay(s)).toLowerCase().replace(/[()]/g, "").replace(/\bor\b/g, " ").replace(/\w+/g, (k) => m[k] || k).replace(/\s+/g, " ").trim();
 }
+
+// src/ts/utils/dom.ts
+function createEl(tag, props, dataset, styles, el = tag ? document?.createElement(tag) : null) {
+  return assignEl(el, props, dataset, styles), el;
+}
+function assignEl(el, props, dataset, styles) {
+  if (!el) return;
+  if (props) {
+    for (const k of Object.keys(props)) if (props[k] !== void 0) el[k] = props[k];
+  }
+  if (dataset) {
+    for (const k of Object.keys(dataset)) if (dataset[k] !== void 0) el.dataset[k] = String(dataset[k]);
+  }
+  if (styles) {
+    for (const k of Object.keys(styles)) if (styles[k] !== void 0) el.style[k] = styles[k];
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  assignEl,
   bindAllMethods,
   canHandle,
   clamp,
   cleanKeyCombo,
+  createEl,
   deepClone,
   deleteAny,
   formatKeyForDisplay,

package/dist/utils.d.cts

@@ -1,4 +1,4 @@
-export { c as canHandle, d as deepClone, e as deleteAny, g as getAny, f as getTrailRecords, i as inAny, h as isObj, j as isPOJO, m as mergeObjs, n as nuke, p as parseAnyObj, k as parseEvtOpts, s as setAny } from './index-C2hyIh0K.cjs';
+export { d as canHandle, e as deepClone, f as deleteAny, g as getAny, h as getTrailRecords, i as inAny, j as isObj, k as isPOJO, m as mergeObjs, n as nuke, p as parseAnyObj, l as parseEvtOpts, s as setAny } from './index-Oie9hhE8.cjs';
 
 declare function clamp(min: number | undefined, val: number, max?: number): number;
 
@@ -168,4 +168,11 @@ declare function formatKeyShortcutsForDisplay(keyShortcuts: Record<string, strin
  */
 declare function parseForARIAKS(s: string | string[], formatted?: boolean): string;
 
-export { type KeyStruct, bindAllMethods, clamp, cleanKeyCombo, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };
+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;
+
+export { type KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-export { c as canHandle, d as deepClone, e as deleteAny, g as getAny, f as getTrailRecords, i as inAny, h as isObj, j as isPOJO, m as mergeObjs, n as nuke, p as parseAnyObj, k as parseEvtOpts, s as setAny } from './index-C2hyIh0K.js';
+export { d as canHandle, e as deepClone, f as deleteAny, g as getAny, h as getTrailRecords, i as inAny, j as isObj, k as isPOJO, m as mergeObjs, n as nuke, p as parseAnyObj, l as parseEvtOpts, s as setAny } from './index-Oie9hhE8.js';
 
 declare function clamp(min: number | undefined, val: number, max?: number): number;
 
@@ -168,4 +168,11 @@ declare function formatKeyShortcutsForDisplay(keyShortcuts: Record<string, strin
  */
 declare function parseForARIAKS(s: string | string[], formatted?: boolean): string;
 
-export { type KeyStruct, bindAllMethods, clamp, cleanKeyCombo, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };
+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;
+
+export { type KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };

package/dist/utils.js

@@ -1,3 +1,16 @@
+import {
+  assignEl,
+  cleanKeyCombo,
+  createEl,
+  formatKeyForDisplay,
+  formatKeyShortcutsForDisplay,
+  getTermsForKey,
+  keyEventAllowed,
+  matchKeys,
+  parseForARIAKS,
+  parseKeyCombo,
+  stringifyKeyEvent
+} from "./chunk-5A44QFT6.js";
 import {
   bindAllMethods,
   clamp,
@@ -7,7 +20,7 @@ import {
   requestAnimationFrame,
   setInterval,
   setTimeout
-} from "./chunk-UQIMMJTY.js";
+} from "./chunk-P37ADJMM.js";
 import {
   canHandle,
   deepClone,
@@ -22,75 +35,14 @@ import {
   parseAnyObj,
   parseEvtOpts,
   setAny
-} from "./chunk-4MJUBEI7.js";
-
-// src/utils/keys.ts
-function parseKeyCombo(combo) {
-  const parts = cleanKeyCombo(combo).toLowerCase().split("+");
-  return { ctrlKey: parts.includes("ctrl"), shiftKey: parts.includes("shift"), altKey: parts.includes("alt"), metaKey: parts.includes("meta") || parts.includes("cmd"), key: parts.find((p) => !["ctrl", "shift", "alt", "meta", "cmd"].includes(p)) || "" };
-}
-function stringifyKeyEvent(e) {
-  const parts = [];
-  if (e.ctrlKey) parts.push("ctrl");
-  if (e.altKey) parts.push("alt");
-  if (e.shiftKey) parts.push("shift");
-  if (e.metaKey) parts.push("meta");
-  parts.push(e.key?.toLowerCase() ?? "");
-  return parts.join("+");
-}
-function cleanKeyCombo(combo) {
-  const clean = (combo2) => {
-    const m = ["ctrl", "alt", "shift", "meta"], alias = { cmd: "meta", space: " " };
-    if (combo2 === " " || combo2 === "+") return combo2;
-    combo2 = combo2.replace(/\+\s*\+$/, "+plus");
-    const p = combo2.toLowerCase().split("+").filter((k) => k !== "").map((k) => alias[k] || (k === "plus" ? "+" : k.trim() || " "));
-    return [...p.filter((k) => m.includes(k)).sort((a, b) => m.indexOf(a) - m.indexOf(b)), ...p.filter((k) => !m.includes(k)) || ""].join("+");
-  };
-  return Array.isArray(combo) ? combo.map(clean) : clean(combo);
-}
-function matchKeys(required, actual, strict = false) {
-  actual = cleanKeyCombo(actual);
-  const match = (required2, actual2) => {
-    required2 = cleanKeyCombo(required2);
-    if (strict) return required2 === actual2;
-    const reqKeys = required2.split("+"), actKeys = actual2.split("+");
-    return reqKeys.every((k) => actKeys.includes(k));
-  };
-  return Array.isArray(required) ? required.some((req) => match(req, actual)) : match(required, actual);
-}
-function getTermsForKey(combo, settings) {
-  const terms = { override: false, block: false, whitelisted: false, action: null }, { overrides = [], shortcuts = {}, blocks = [], strictMatches: s = false, whitelist = [] } = settings || {};
-  combo = cleanKeyCombo(combo);
-  if (matchKeys(overrides, combo, s)) terms.override = true;
-  if (matchKeys(blocks, combo, s)) terms.block = true;
-  if (matchKeys(whitelist, combo)) terms.whitelisted = true;
-  terms.action = Object.keys(shortcuts).find((key) => matchKeys(shortcuts[key], combo, s)) || null;
-  return terms;
-}
-function keyEventAllowed(e, settings) {
-  if (settings.disabled || (e.key === " " || e.key === "Enter") && (e.target?.ownerDocument || document).activeElement?.tagName === "BUTTON" || (e.target?.ownerDocument || document).activeElement?.matches("input,textarea,[contenteditable='true']")) return false;
-  const combo = stringifyKeyEvent(e), { override, block, action, whitelisted } = getTermsForKey(combo, settings);
-  if (block) return false;
-  if (override) e.preventDefault();
-  if (action) return action;
-  if (whitelisted) return e.key.toLowerCase();
-  return false;
-}
-var formatKeyForDisplay = (combo) => ` ${(Array.isArray(combo) ? combo : [combo]).map((c) => `(${cleanKeyCombo(c).replace(" ", "space")})`).join(" or ")}`;
-function formatKeyShortcutsForDisplay(keyShortcuts) {
-  const shortcuts = {};
-  for (const action of Object.keys(keyShortcuts)) shortcuts[action] = formatKeyForDisplay(keyShortcuts[action]);
-  return shortcuts;
-}
-function parseForARIAKS(s, formatted = true) {
-  const m = { ctrl: "Control", cmd: "Meta", space: "Space", plus: "+" };
-  return (formatted && !Array.isArray(s) ? s : formatKeyForDisplay(s)).toLowerCase().replace(/[()]/g, "").replace(/\bor\b/g, " ").replace(/\w+/g, (k) => m[k] || k).replace(/\s+/g, " ").trim();
-}
+} from "./chunk-DP74DVRT.js";
 export {
+  assignEl,
   bindAllMethods,
   canHandle,
   clamp,
   cleanKeyCombo,
+  createEl,
   deepClone,
   deleteAny,
   formatKeyForDisplay,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sia-reactor",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "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",
@@ -50,7 +50,8 @@
       "import": "./dist/adapters/react.js",
       "require": "./dist/adapters/react.cjs",
       "default": "./dist/adapters/react.js"
-    }
+    },
+    "./styles/time-travel-overlay.css": "./dist/styles/time-travel-overlay.css"
   },
   "publishConfig": {
     "access": "public"

package/dist/chunk-FGUCKMLH.js

@@ -1,154 +0,0 @@
-import {
-  CTX,
-  NIL,
-  RAW,
-  canHandle,
-  nuke
-} from "./chunk-4MJUBEI7.js";
-
-// src/adapters/autotracker.ts
-var Autotracker = class {
-  proxy;
-  deps = /* @__PURE__ */ new Map();
-  isTracking = true;
-  rtr;
-  /** only allows one reactor to autotrack when available */
-  autortr;
-  clups = [];
-  lastPath;
-  proxyCache = /* @__PURE__ */ new WeakMap();
-  /** @param rtr Reactor instance used for path subscriptions. */
-  constructor(rtr) {
-    this.autortr = this.rtr = rtr;
-  }
-  /**
-   * Starts a new tracking pass and returns a tracking proxy for `target` if `this` was instantiated with a `Reactor`.
-   * @param target Snapshot (or state branch) to track reads from.
-   * @returns Read-tracking proxy.
-   * @example
-   * const atrkr = new Autotracker(rtr);
-   * const state = atrkr.tracked(rtr.snapshot());
-   * const name = state.user.profile.name;
-   */
-  tracked(target) {
-    return this.unblock(), this.rtr ? this.proxy = this.proxied(target, "") : target;
-  }
-  proxied(obj, path) {
-    if (!obj || "object" !== typeof obj) return obj;
-    const cached = this.proxyCache.get(obj);
-    if (cached) return cached;
-    if (!canHandle(obj, this.rtr.config, false)) return obj;
-    const proxy = new Proxy(obj, {
-      // Minimal Proxy Handler
-      get: (object, key, receiver) => {
-        if (key === RAW) return this.rtr.log(`\u{1F440} [AutoTracker \`get\` Trap] Peeked at ${object}`), object;
-        const keyStr = String(key), fullPath = path ? `${path}.${keyStr}` : keyStr;
-        return this.rtr.log(`\u{1F50D} [AutoTracker \`get\` Trap] Initiated for "${keyStr}" on "${path}"`), this.track(fullPath), this.proxied(!this.rtr.config.preserveContext ? object[key] : Reflect.get(object, key, receiver), fullPath);
-      },
-      has: (object, key) => {
-        const keyStr = String(key), fullPath = path ? `${path}.${keyStr}` : keyStr;
-        return this.rtr.log(`\u2753 [AutoTracker \`has\` Trap] Initiated for "${keyStr}" on "${path}"`), this.track(fullPath), !this.rtr.config.preserveContext ? key in object : Reflect.has(object, key);
-      },
-      getOwnPropertyDescriptor: (object, key) => {
-        const keyStr = String(key), fullPath = path ? `${path}.${keyStr}` : keyStr;
-        return this.rtr.log(`\u{1F4CB} [AutoTracker \`getOwnPropertyDescriptor\` Trap] Initiated for "${keyStr}" on "${path}"`), this.track(fullPath), !this.rtr.config.preserveContext ? Object.getOwnPropertyDescriptor(object, key) : Reflect.getOwnPropertyDescriptor(object, key);
-      },
-      ownKeys: (object) => {
-        const safePath = path || "*";
-        return this.rtr.log(`\u{1F511} [AutoTracker \`ownKeys\` Trap] Initiated on "${safePath}"`), this.track(safePath), Reflect.ownKeys(object);
-      },
-      set: (_, key) => {
-        throw new Error(`\u{1F6E1}\uFE0F [AutoTracker \`set\` Trap] Blocked for "${String(key)}" on "${path}"`);
-      },
-      deleteProperty: (_, key) => {
-        throw new Error(`\u{1F6E1}\uFE0F [AutoTracker \`deleteProperty\` Trap] Blocked for "${String(key)}" on "${path}"`);
-      },
-      defineProperty: (_, key) => {
-        throw new Error(`\u{1F6E1}\uFE0F [AutoTracker \`defineProperty\` Trap] Blocked for "${String(key)}" on "${path}"`);
-      },
-      setPrototypeOf: (_, key) => {
-        throw new Error(`\u{1F6E1}\uFE0F [AutoTracker \`setPrototypeOf\` Trap] Blocked for "${String(key)}" on "${path}"`);
-      }
-    });
-    return this.proxyCache.set(obj, proxy), proxy;
-  }
-  /** Adds a path to the tracking set. */
-  track(path, rtr = this.rtr, prune = false) {
-    if (!this.isTracking || !path || this.autortr && this.autortr !== rtr) return path;
-    let paths = this.deps.get(rtr);
-    if (!prune && !paths) paths = (this.deps.set(rtr, paths = /* @__PURE__ */ new Set()), paths);
-    if (path.startsWith(this.lastPath + ".")) paths.delete(this.lastPath);
-    return !prune && paths.add(this.lastPath = path), path;
-  }
-  /** Removes a path from the tracking set. */
-  untrack(path, rtr = this.rtr) {
-    this.deps.get(rtr)?.delete(path);
-  }
-  /** Enables path tracking. */
-  unblock(rtr = this.rtr) {
-    this.deps.clear();
-    this.autortr = rtr;
-    this.isTracking = true;
-    this.lastPath = void 0;
-  }
-  /** Temporarily disables path tracking. */
-  block() {
-    this.autortr = void 0;
-    this.isTracking = false;
-  }
-  /**
-   * Subscribes an effect to tracked paths.
-   * Uses `watch` when `options.sync === true` (synchronous updates), otherwise
-   * uses `on` (batched/asynchronous listener wave).
-   * @param cb Effect callback.
-   * @param options Effect options.
-   * @returns Cleanup function for active subscriptions.
-   * @example
-   * const atrkr = new Autotracker(rtr);
-   * const view = atrkr.tracked(rtr.snapshot()); // tracked works if `rtr` was passed at instantiation
-   * view.user.name;
-   * const stop = atrkr.callback(() => console.log("changed")); // re-run after when ".user.name" changes
-   * @example Packaged Customization
-   * const atrkr = new Autotracker(); // no reactor passed
-   * withTracker(atrkr, () => state.user.name); // import `withTracker` first
-   * const stop = atrkr.callback(() => console.log("sync"), { sync: true }); // re-run immediately when ".user.name" changes, works on any path used from any reactor state
-   * @example Extensive customization
-   * atrkr.unblock();
-   * const prev = CTX.autotracker;
-   * CTX.autotracker = atrkr; // import CTX first
-   * state.user.name;
-   * CTX.autotracker = prev;
-   */
-  callback(cb, options = NIL) {
-    this.cleanup();
-    const method = options.sync ? "watch" : "on";
-    for (const [rtr, paths] of this.deps) {
-      if (!paths.size || paths.has("*")) rtr && this.clups.push(rtr[method]("*", cb, options));
-      else for (const path of paths) this.clups.push(rtr[method](path, cb, options));
-    }
-    return () => this.cleanup();
-  }
-  /** Clears active subscriptions and blocks tracking. */
-  cleanup() {
-    this.block();
-    for (let i = 0, len = this.clups.length; i < len; i++) this.clups[i]();
-    this.clups.length = 0;
-  }
-  destroy() {
-    this.deps.clear(), this.cleanup(), nuke(this);
-  }
-};
-function withTracker(tracker, run, rtr) {
-  const prev = CTX.autotracker;
-  CTX.autotracker = tracker;
-  try {
-    return tracker.unblock(rtr), run();
-  } finally {
-    CTX.autotracker = prev;
-  }
-}
-
-export {
-  Autotracker,
-  withTracker
-};

package/dist/chunk-KIQP7G7W.js

@@ -1,80 +0,0 @@
-import {
-  Reactor
-} from "./chunk-Q2AKMIHN.js";
-import {
-  INDIFFABLE,
-  INERTIA,
-  NIL,
-  RAW,
-  REJECTABLE,
-  SSVERSION,
-  VERSION
-} from "./chunk-4MJUBEI7.js";
-
-// src/core/mixins.ts
-var methods = ["tick", "stall", "nostall", "get", "gonce", "noget", "set", "sonce", "noset", "delete", "donce", "nodelete", "watch", "wonce", "nowatch", "on", "once", "off", "cascade", "snapshot", "reset", "destroy"];
-function reactive(target, build, preferences = NIL) {
-  if ("__Reactor__" in target) return target;
-  const descriptors = {}, rtr = target instanceof Reactor ? target : new Reactor(target, build), locks = { enumerable: false, configurable: true, writable: false }, hasAffix = !!(preferences.prefix || preferences.suffix);
-  for (let i = 0, len = methods.length; i < len; i++) {
-    let key = methods[i];
-    if (hasAffix) (preferences.whitelist?.includes(key) ?? true) && (key = `${preferences.prefix || ""}${key}${preferences.suffix || ""}`);
-    else if (preferences.whitelist?.includes(key)) continue;
-    descriptors[key] = { value: rtr[key].bind(rtr), ...locks };
-  }
-  descriptors["__Reactor__"] = { value: rtr, ...locks };
-  return Object.defineProperties(rtr.core, descriptors), rtr.core;
-}
-function inert(target) {
-  return getRaw(target)[INERTIA] = true, target;
-}
-function live(target) {
-  return delete getRaw(target)[INERTIA], target;
-}
-function isInert(target) {
-  return !!getRaw(target)[INERTIA];
-}
-function intent(target) {
-  return getRaw(target)[REJECTABLE] = true, target;
-}
-function state(target) {
-  return delete getRaw(target)[REJECTABLE], target;
-}
-function isIntent(target) {
-  return !!getRaw(target)[REJECTABLE];
-}
-function volatile(target) {
-  return getRaw(target)[INDIFFABLE] = true, target;
-}
-function stable(target) {
-  return delete getRaw(target)[INDIFFABLE], target;
-}
-function isVolatile(target) {
-  return !!getRaw(target)[INDIFFABLE];
-}
-function getRaw(target) {
-  return target?.[RAW] || target;
-}
-function getVersion(target) {
-  return getRaw(target)[VERSION] || 0;
-}
-function getSnapshotVersion(target) {
-  return getRaw(target)[SSVERSION] || 0;
-}
-
-export {
-  methods,
-  reactive,
-  inert,
-  live,
-  isInert,
-  intent,
-  state,
-  isIntent,
-  volatile,
-  stable,
-  isVolatile,
-  getRaw,
-  getVersion,
-  getSnapshotVersion
-};