sia-reactor 0.0.19 → 0.0.21

package/dist/chunk-TFLYCXK4.js

@@ -0,0 +1,251 @@
+import {
+  reactive
+} from "./chunk-2WBPGSRL.js";
+import {
+  createEl,
+  formatKeyForDisplay,
+  keyEventAllowed,
+  parseForARIAKS
+} from "./chunk-5A44QFT6.js";
+import {
+  CTX,
+  NIL,
+  RAW,
+  canHandle,
+  nuke
+} from "./chunk-DP74DVRT.js";
+
+// src/ts/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;
+  }
+}
+
+// src/ts/adapters/vanilla/effect.ts
+function effect(callback, options) {
+  const atrkr = new Autotracker();
+  let destroyed = false;
+  (function execute() {
+    if (!destroyed) withTracker(atrkr, () => callback()), atrkr.callback(execute, options);
+  })();
+  return () => (destroyed = true, atrkr.destroy());
+}
+
+// src/ts/adapters/vanilla/TimeTravelOverlay.ts
+var keys = {
+  overrides: ["Ctrl+z", "Cmd+z", "Ctrl+y", "Cmd+y", "Ctrl+Shift+z", "Cmd+Shift+z", "Ctrl+g", "Cmd+g", ",", ".", "ArrowLeft", "ArrowRight", "Space", "Alt+Space", "Escape", "Delete", "e", "i", "c"],
+  shortcuts: { undo: ["Ctrl+z", "Cmd+z"], redo: ["Ctrl+y", "Cmd+y", "Ctrl+Shift+z", "Cmd+Shift+z"], genesis: ["Ctrl+g", "Cmd+g"], prevFrame: ",", nextFrame: ".", skipBwd: "ArrowLeft", skipFwd: "ArrowRight", playPause: "Space", rewind: "Alt+Space", closeOverlay: "Escape", clrHistory: "Delete", export: "e", import: "i", clear: "c" }
+};
+var TimeTravelOverlay = class _TimeTravelOverlay {
+  static count = 0;
+  index = _TimeTravelOverlay.count;
+  config;
+  state = reactive({ open: false, import: "" });
+  time;
+  els;
+  clups = [];
+  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, build = {}) {
+    this.time = time;
+    this.config = reactive({ title: `Time Travel Overlay ${this.index = ++_TimeTravelOverlay.count}`, ...build });
+    this.state.open = !!this.config.startOpen;
+    const s = this.time.state, host = createEl("div", { className: "tt-overlay-host" }), toggle = createEl("button", { className: "tt-overlay-toggle", type: "button", onclick: () => this.state.open = !this.state.open }), panel = createEl("aside", { className: "tt-overlay", ariaLabel: "time travel overlay" }), title = createEl("div", { className: "title" }), frame = createEl("span", { className: "muted" }), clrHistory = createEl("button", { textContent: `Clear History${formatKeyForDisplay(keys.shortcuts.clrHistory)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.clrHistory, false), onclick: () => (this.time.clear(), this.state.import = "") }), undo = createEl("button", { textContent: `Undo${formatKeyForDisplay(keys.shortcuts.undo[0])}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.undo, false), onclick: this.time.undo }), redo = createEl("button", { textContent: `Redo${formatKeyForDisplay(keys.shortcuts.redo[0])}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.redo, false), onclick: this.time.redo }), genesis = createEl("button", { textContent: `Genesis${formatKeyForDisplay(keys.shortcuts.genesis[0])}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.genesis, false), onclick: () => this.time.jumpTo(0) }), playPause = createEl("button", { onclick: () => this.time[s.paused ? "play" : "pause"](), ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.playPause, false) }), rewind = createEl("button", { textContent: `Rewind${formatKeyForDisplay(keys.shortcuts.rewind)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.rewind, false), onclick: this.time.rewind }), range = createEl("input", { type: "range", min: "0", max: "0", value: "0", title: "time travel frame", ariaLabel: "time travel frame", oninput: () => this.time.jumpTo(Number(range.value)) }), exp = createEl("button", { textContent: `Export${formatKeyForDisplay(keys.shortcuts.export)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.export, false), onclick: () => this.state.import = this.time.export(null, 2) }), imp = createEl("button", { textContent: `Import${formatKeyForDisplay(keys.shortcuts.import)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.import, false), onclick: () => this.state.import.trim().length && this.time.import(this.state.import) }), clr = createEl("button", { textContent: `Clear${formatKeyForDisplay(keys.shortcuts.clear)}`, ariaKeyShortcuts: parseForARIAKS(keys.shortcuts.clear, false), onclick: () => this.state.import = "" }), payload = createEl("textarea", { className: "tt-io", readOnly: true, placeholder: "current payload json", title: "current payload" }), io = createEl("textarea", { className: "tt-io", placeholder: "timeline payload json", oninput: () => this.state.import = io.value }), foot = createEl("p", { className: "tt-footnote", textContent: "Want this in your app? " }), link = createEl("a", { target: "_blank", rel: "noreferrer noopener", textContent: "sia-reactor", href: "https://www.npmjs.com/package/sia-reactor" }), box = createEl("div", { className: "tt-status-box" }), status = createEl("div", { className: "tt-status-row" }), row1 = createEl("div", { className: "tt-row" }), row2 = createEl("div", { className: "tt-row" }), row3 = createEl("div", { className: "tt-row" });
+    status.append((box.append(frame), box), clrHistory);
+    panel.append(title, status, (row1.append(undo, redo, genesis), row1), (row2.append(playPause, rewind), row2), payload, range, (row3.append(exp, imp, clr), row3), io, (foot.appendChild(link), foot));
+    host.append(toggle, panel);
+    this.els = { host, toggle, panel, title, frame, clrHistory, undo, redo, genesis, playPause, rewind, range, exp, imp, clr, payload, io };
+    this.keyup = (e) => {
+      const a = this.state.open && keyEventAllowed(e, keys);
+      a === "undo" ? this.time.undo() : a === "redo" ? this.time.redo() : a === "genesis" ? this.time.jumpTo(0) : a === "prevFrame" ? this.time.step(1, false) : a === "nextFrame" ? this.time.step(1, true) : a === "skipBwd" ? this.time.step(5, false) : a === "skipFwd" ? this.time.step(5, true) : 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() : a === "import" ? this.state.import.trim().length && this.time.import(this.state.import) : a === "clear" && (this.state.import = "");
+    };
+    window.addEventListener("keydown", this.keyup);
+    const sync = [
+      effect(() => this.config.color ? host.style.setProperty("--sia-tt-color", this.config.color) : host.style.removeProperty("--sia-tt-color")),
+      effect(() => {
+        if (this.config.devOnly && !CTX.isDevEnv) return void host.remove();
+        const dock = getDock(this.config.container);
+        if (host.parentNode !== dock) dock.appendChild(host);
+      }),
+      effect(() => toggle.textContent = `${(panel.hidden = !this.state.open) ? "Show" : "Hide"} ${title.textContent = this.config.title ?? ""}`),
+      effect(() => playPause.textContent = `${s.paused ? "Play" : "Pause"}${formatKeyForDisplay(keys.shortcuts.playPause)}`),
+      effect(() => {
+        frame.textContent = `Frame: ${s.currentFrame} / ${s.history.length}`;
+        range.disabled = clrHistory.disabled = !s.history.length;
+        genesis.disabled = rewind.disabled = undo.disabled = !s.currentFrame;
+        playPause.disabled = redo.disabled = s.currentFrame >= s.history.length;
+        range.max = String(s.history.length);
+        range.value = String(Math.min(s.currentFrame, s.history.length));
+        payload.value = JSON.stringify(s.currentFrame ? s.history[s.currentFrame - 1] : { type: "genesis", value: s.initialState }, null, 2);
+      }),
+      effect(() => {
+        clr.disabled = imp.disabled = !this.state.import.trim().length;
+        io.value !== this.state.import && (io.value = this.state.import);
+      })
+    ];
+    this.clups.push(...sync);
+  }
+  destroy() {
+    this.clups.forEach((fn) => fn());
+    this.keyup && window.removeEventListener("keydown", this.keyup);
+    this.els.host.remove();
+    nuke(this), --_TimeTravelOverlay.count;
+  }
+};
+function getDirChild(parent, className) {
+  for (const child of parent.children) if (child instanceof HTMLElement && child.classList.contains(className)) return child;
+}
+function getDock(container) {
+  const host = container && container !== document.documentElement ? container : document.body;
+  if (host !== document.body && getComputedStyle(host).position === "static") host.style.position = "relative";
+  const layer = getDirChild(host, "tt-overlay-layer") || createEl("div", { className: "tt-overlay-layer" }, void 0, { position: host === document.body ? "fixed" : "absolute" });
+  if (layer.parentElement !== host) host.appendChild(layer);
+  const dock = getDirChild(layer, "tt-overlay-dock") || createEl("div", { className: "tt-overlay-dock" });
+  return dock.parentElement !== layer && layer.appendChild(dock), dock;
+}
+
+export {
+  Autotracker,
+  withTracker,
+  effect,
+  TimeTravelOverlay
+};

package/dist/{index-C2hyIh0K.d.cts → index-Oie9hhE8.d.cts}

@@ -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;
 };
@@ -1065,4 +1069,4 @@ declare const NIL: any;
 /** Shared no-operation function. */
 declare const NOOP: () => void;
 
-export { type Payload as $, Autotracker as A, BaseReactorPlugin as B, CTX as C, type DeepKeys as D, type EffectOptions as E, EVT_WARN as F, type Getter as G, type GetterRecord as H, type Inert as I, INDIFFABLE as J, INERTIA as K, type Intent as L, type Listener as M, type ListenerOptions as N, type ListenerOptionsTuple as O, type Paths as P, type ListenerRecord as Q, Reactor as R, type Live as S, NIL as T, NOOP as U, type NoTraverse as V, type WildPaths as W, type PathBranch as X, type PathBranchValue as Y, type PathKey as Z, type PathLeaf as _, type REvent as a, type Primitive as a0, RAW as a1, REJECTABLE as a2, RTR_BATCH as a3, RTR_LOG as a4, type ReactivePreferences as a5, type ReactorBuild as a6, ReactorEvent as a7, SSVERSION as a8, type Setter as a9, stable as aA, state as aB, volatile as aC, type SetterRecord as aa, type Stable as ab, type State as ac, type StrictPathKey as ad, type SyncOptions as ae, type SyncOptionsTuple as af, TERMINATOR as ag, type Target as ah, type Unflatten as ai, type UnionToIntersection as aj, type UpdatePayload as ak, VERSION as al, type Volatile as am, type Watcher as an, type WatcherRecord as ao, getRaw as ap, getSnapshotVersion as aq, getVersion as ar, inert as as, intent as at, isInert as au, isIntent as av, isVolatile as aw, live as ax, methods as ay, reactive as az, type ReactorPluginConstructor as b, canHandle as c, deepClone as d, deleteAny as e, getTrailRecords as f, getAny as g, isObj as h, inAny as i, isPOJO as j, parseEvtOpts as k, type Reactive as l, mergeObjs as m, nuke as n, type PathValue as o, parseAnyObj as p, type ChildPaths as q, type DeepMerge as r, setAny as s, type DeepPartial as t, type DeepRequired as u, type Deleter as v, withTracker as w, type DeleterRecord as x, type DirectPayload as y, EVT_OPTS as z };
+export { type PathLeaf as $, Autotracker as A, BaseReactorPlugin as B, CTX as C, type DeepKeys as D, type EffectOptions as E, EVT_OPTS as F, EVT_WARN as G, type Getter as H, type Inert as I, type GetterRecord as J, INDIFFABLE as K, INERTIA as L, type Intent as M, type Listener as N, type ListenerOptions as O, type Paths as P, type ListenerOptionsTuple as Q, type Reactive as R, type ListenerRecord as S, type Live as T, NIL as U, NOOP as V, type WildPaths as W, type NoTraverse as X, type PathBranch as Y, type PathBranchValue as Z, type PathKey as _, type REvent as a, type Payload as a0, type Primitive as a1, RAW as a2, REJECTABLE as a3, RTR_BATCH as a4, RTR_LOG as a5, type ReactivePreferences as a6, ReactorEvent as a7, SSVERSION as a8, type Setter as a9, stable as aA, state as aB, volatile as aC, type SetterRecord as aa, type Stable as ab, type State as ac, type StrictPathKey as ad, type SyncOptions as ae, type SyncOptionsTuple as af, TERMINATOR as ag, type Target as ah, type Unflatten as ai, type UnionToIntersection as aj, type UpdatePayload as ak, VERSION as al, type Volatile as am, type Watcher as an, type WatcherRecord as ao, getRaw as ap, getSnapshotVersion as aq, getVersion as ar, inert as as, intent as at, isInert as au, isIntent as av, isVolatile as aw, live as ax, methods as ay, reactive as az, Reactor as b, type ReactorPluginConstructor as c, canHandle as d, deepClone as e, deleteAny as f, getAny as g, getTrailRecords as h, inAny as i, isObj as j, isPOJO as k, parseEvtOpts as l, mergeObjs as m, nuke as n, type ReactorBuild as o, parseAnyObj as p, type PathValue as q, type ChildPaths as r, setAny as s, type DeepMerge as t, type DeepPartial as u, type DeepRequired as v, withTracker as w, type Deleter as x, type DeleterRecord as y, type DirectPayload as z };

package/dist/{index-C2hyIh0K.d.ts → index-Oie9hhE8.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;
 };
@@ -1065,4 +1069,4 @@ declare const NIL: any;
 /** Shared no-operation function. */
 declare const NOOP: () => void;
 
-export { type Payload as $, Autotracker as A, BaseReactorPlugin as B, CTX as C, type DeepKeys as D, type EffectOptions as E, EVT_WARN as F, type Getter as G, type GetterRecord as H, type Inert as I, INDIFFABLE as J, INERTIA as K, type Intent as L, type Listener as M, type ListenerOptions as N, type ListenerOptionsTuple as O, type Paths as P, type ListenerRecord as Q, Reactor as R, type Live as S, NIL as T, NOOP as U, type NoTraverse as V, type WildPaths as W, type PathBranch as X, type PathBranchValue as Y, type PathKey as Z, type PathLeaf as _, type REvent as a, type Primitive as a0, RAW as a1, REJECTABLE as a2, RTR_BATCH as a3, RTR_LOG as a4, type ReactivePreferences as a5, type ReactorBuild as a6, ReactorEvent as a7, SSVERSION as a8, type Setter as a9, stable as aA, state as aB, volatile as aC, type SetterRecord as aa, type Stable as ab, type State as ac, type StrictPathKey as ad, type SyncOptions as ae, type SyncOptionsTuple as af, TERMINATOR as ag, type Target as ah, type Unflatten as ai, type UnionToIntersection as aj, type UpdatePayload as ak, VERSION as al, type Volatile as am, type Watcher as an, type WatcherRecord as ao, getRaw as ap, getSnapshotVersion as aq, getVersion as ar, inert as as, intent as at, isInert as au, isIntent as av, isVolatile as aw, live as ax, methods as ay, reactive as az, type ReactorPluginConstructor as b, canHandle as c, deepClone as d, deleteAny as e, getTrailRecords as f, getAny as g, isObj as h, inAny as i, isPOJO as j, parseEvtOpts as k, type Reactive as l, mergeObjs as m, nuke as n, type PathValue as o, parseAnyObj as p, type ChildPaths as q, type DeepMerge as r, setAny as s, type DeepPartial as t, type DeepRequired as u, type Deleter as v, withTracker as w, type DeleterRecord as x, type DirectPayload as y, EVT_OPTS as z };
+export { type PathLeaf as $, Autotracker as A, BaseReactorPlugin as B, CTX as C, type DeepKeys as D, type EffectOptions as E, EVT_OPTS as F, EVT_WARN as G, type Getter as H, type Inert as I, type GetterRecord as J, INDIFFABLE as K, INERTIA as L, type Intent as M, type Listener as N, type ListenerOptions as O, type Paths as P, type ListenerOptionsTuple as Q, type Reactive as R, type ListenerRecord as S, type Live as T, NIL as U, NOOP as V, type WildPaths as W, type NoTraverse as X, type PathBranch as Y, type PathBranchValue as Z, type PathKey as _, type REvent as a, type Payload as a0, type Primitive as a1, RAW as a2, REJECTABLE as a3, RTR_BATCH as a4, RTR_LOG as a5, type ReactivePreferences as a6, ReactorEvent as a7, SSVERSION as a8, type Setter as a9, stable as aA, state as aB, volatile as aC, type SetterRecord as aa, type Stable as ab, type State as ac, type StrictPathKey as ad, type SyncOptions as ae, type SyncOptionsTuple as af, TERMINATOR as ag, type Target as ah, type Unflatten as ai, type UnionToIntersection as aj, type UpdatePayload as ak, VERSION as al, type Volatile as am, type Watcher as an, type WatcherRecord as ao, getRaw as ap, getSnapshotVersion as aq, getVersion as ar, inert as as, intent as at, isInert as au, isIntent as av, isVolatile as aw, live as ax, methods as ay, reactive as az, Reactor as b, type ReactorPluginConstructor as c, canHandle as d, deepClone as e, deleteAny as f, getAny as g, getTrailRecords as h, inAny as i, isObj as j, isPOJO as k, parseEvtOpts as l, mergeObjs as m, nuke as n, type ReactorBuild as o, parseAnyObj as p, type PathValue as q, type ChildPaths as r, setAny as s, type DeepMerge as t, type DeepPartial as u, type DeepRequired as v, withTracker as w, type Deleter as x, type DeleterRecord as y, type DirectPayload as z };