sia-reactor 0.0.35 → 0.0.37

package/README.md

@@ -1,6 +1,6 @@
 # sia-reactor
 
-> The Programmable Data DOM. A high-performance State & Intent Architecture (S.I.A.) Engine featuring zero-allocation loops, DOM-style event propagation, microtask batching, and structural sharing.
+> The Programmable Data DOM. A high-performance State & Intent Architecture (S.I.A.) engine that gives your data transactional mutation routing and multi-phase state observation.
 
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![NPM Version](https://img.shields.io/npm/v/sia-reactor.svg)](https://www.npmjs.com/package/sia-reactor)

package/dist/{TimeTravelConsole-BLDKZ0U1.d.ts → TimeTravelConsole-B1du_ohf.d.ts}

@@ -1,5 +1,5 @@
-import { R as Reactive } from './index-rWwvrfdn.js';
-import { T as TimeTravelModule } from './index-D_U8Nai1.js';
+import { R as Reactive } from './index-D0NxfxUv.js';
+import { T as TimeTravelModule } from './index-lo6ft5Zu.js';
 
 /** Reactive options for the TimeTravel overlay instance. */
 interface TimeTravelConsoleConfig {
@@ -12,7 +12,7 @@ interface TimeTravelConsoleConfig {
     /** Initial open state applied when the overlay is created. */
     startOpen: boolean;
     /** Container element that owns the overlay layer and dock. */
-    container: HTMLElement;
+    container?: HTMLElement;
 }
 /**
  * - Vanilla overlay controller for visual time-travel controls and timeline I/O.

package/dist/{TimeTravelConsole-zvu8eqTZ.d.cts → TimeTravelConsole-C9eSXGTz.d.cts}

@@ -1,5 +1,5 @@
-import { R as Reactive } from './index-rWwvrfdn.cjs';
-import { T as TimeTravelModule } from './index-CuLuFYu3.cjs';
+import { R as Reactive } from './index-D0NxfxUv.cjs';
+import { T as TimeTravelModule } from './index-CQNn1GIg.cjs';
 
 /** Reactive options for the TimeTravel overlay instance. */
 interface TimeTravelConsoleConfig {
@@ -12,7 +12,7 @@ interface TimeTravelConsoleConfig {
     /** Initial open state applied when the overlay is created. */
     startOpen: boolean;
     /** Container element that owns the overlay layer and dock. */
-    container: HTMLElement;
+    container?: HTMLElement;
 }
 /**
  * - Vanilla overlay controller for visual time-travel controls and timeline I/O.

package/dist/adapters/react.cjs

@@ -53,9 +53,14 @@ var EVT_OPTS = { LISTENER: ["capture", "depth", "once", "signal", "init"], MEDIA
 var NIL = Object.freeze({});
 var NOOP = () => {
 };
+var isDevEnv = false;
+try {
+  isDevEnv = process.env.NODE_ENV !== "production";
+} catch (e) {
+}
 var CTX = {
   /** Flag indicating whether the application is running in development mode. */
-  isDevEnv: "undefined" !== typeof process ? process.env.NODE_ENV !== "production" : true,
+  isDevEnv,
   /** Flag indicating whether an operation is bypassing checks so reactors can allow all writes. */
   usingForce: false,
   /** Active `Autotracker` instance, override for automatic dependency collection on `Reactor` traps. */
@@ -97,10 +102,10 @@ function getPath(source, key, separator = ".", keyFunc) {
     const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRegex);
     if (match) {
       const [, key3, iStr] = match;
-      if (!Array.isArray(currObj[key3]) || !(key3 in currObj)) return void 0;
+      if (!Array.isArray(currObj[key3]) || !(key3 in currObj)) return currObj[key3];
       currObj = currObj[key3][Number(iStr)];
     } else {
-      if (!isObj(currObj) || !(key2 in currObj)) return void 0;
+      if (!isObj(currObj) || !(key2 in currObj)) return currObj[key2];
       currObj = currObj[key2];
     }
   }
@@ -354,10 +359,10 @@ var Reactor = class {
     const proxy = new Proxy(target, {
       // Robust Proxy handler
       get: (object, key2, receiver) => {
-        if (key2 === RAW) return this.log(`\u{1F440} [Reactor \`get\` Trap] Peeked at ${object}`), object;
+        if (key2 === RAW) return this.log(`\u{1F440} [\`get\` Trap] Peeked at ${object}`), object;
         let value = !this.config.preserveContext ? object[key2] : Reflect.get(object, key2, receiver);
         const keyStr = String(key2), fullPath = path ? path + "." + keyStr : keyStr, paths = this.config.lineageTracing ? this.trace(object, keyStr) : fullPath;
-        this.log(`\u{1F50D} [Reactor \`get\` Trap] Initiated for "${keyStr}" on "${paths}"`), CTX.autotracker?.track(fullPath, this);
+        this.log(`\u{1F50D} [\`get\` Trap] Initiated for "${keyStr}" on [${paths}]`), CTX.autotracker?.track(fullPath, this);
         if (this.config.get) value = this.config.get(object, key2, value, receiver, paths);
         if (this.getters) {
           const wildcords = this.getters.get("*");
@@ -376,13 +381,13 @@ var Reactor = class {
       set: (object, key2, value, receiver) => {
         let unchanged, safeValue, safeOldValue, terminated = false;
         const keyStr = String(key2), fullPath = path ? path + "." + keyStr : keyStr, paths = this.config.lineageTracing ? this.trace(object, keyStr) : fullPath, loopLen = this.config.lineageTracing ? paths.length : 1, oldValue = !this.config.preserveContext ? object[key2] : Reflect.get(object, key2, receiver), hadKey = !this.config.preserveContext ? key2 in object : Reflect.has(object, key2);
-        this.log(`\u270F\uFE0F [Reactor \`set\` Trap] Initiated for "${keyStr}" on "${paths}"`), CTX.autotracker?.track(fullPath, this, true);
+        this.log(`\u270F\uFE0F [\`set\` Trap] Initiated for "${keyStr}" on [${paths}]`), CTX.autotracker?.track(fullPath, this, true);
         if (this.config.referenceTracking || !indiffable) {
           safeOldValue = oldValue?.[RAW] || oldValue;
           safeValue = value?.[RAW] || value;
           unchanged = this.config.equalityFunction(safeValue, safeOldValue);
         }
-        if (!indiffable && unchanged && !CTX.usingForce && keyStr !== "length") return this.log(`\u{1F504} [Reactor \`set\` Trap] Unchanged for "${keyStr}" on "${paths}"`), true;
+        if (!indiffable && unchanged && !CTX.usingForce && keyStr !== "length") return this.log(`\u{1F504} [\`set\` Trap] Unchanged for "${keyStr}" on [${paths}]`), true;
         if (this.config.set) terminated = (value = this.config.set(object, key2, value, oldValue, receiver, paths)) === TERMINATOR;
         if (this.setters) {
           const wildcords = this.setters.get("*");
@@ -400,9 +405,9 @@ var Reactor = class {
             if (!(terminated ||= payload.terminated)) value = result;
           }
         }
-        if (terminated) return this.log(`\u{1F6E1}\uFE0F [Reactor \`set\` Trap] Terminated for "${keyStr}" on "${paths}"`), true;
+        if (terminated) return this.log(`\u{1F6E1}\uFE0F [\`set\` Trap] Terminated for "${keyStr}" on [${paths}]`), true;
         const success = !this.config.preserveContext ? (object[key2] = value, true) : Reflect.set(object, key2, value, receiver);
-        if (!success) return this.log(`\u274C [Reactor \`set\` Trap] Failed for "${keyStr}" on "${paths}"`), false;
+        if (!success) return this.log(`\u274C [\`set\` Trap] Failed for "${keyStr}" on [${paths}]`), false;
         if (this.config.referenceTracking && !unchanged) this.config.smartCloning && this.stamp(object), this.unlink(safeOldValue, object, keyStr), this.link(safeValue, object, keyStr);
         if (this.watchers || this.listeners)
           for (let i = 0; i < loopLen; i++) {
@@ -414,7 +419,7 @@ var Reactor = class {
       deleteProperty: (object, key2) => {
         let value, receiver = this.proxyCache.get(object), terminated = false;
         const keyStr = String(key2), fullPath = path ? path + "." + keyStr : keyStr, paths = this.config.lineageTracing ? this.trace(object, keyStr) : fullPath, loopLen = this.config.lineageTracing ? paths.length : 1, oldValue = !this.config.preserveContext ? object[key2] : Reflect.get(object, key2, receiver), hadKey = !this.config.preserveContext ? key2 in object : Reflect.has(object, key2);
-        this.log(`\u{1F5D1}\uFE0F [Reactor \`deleteProperty\` Trap] Initiated for "${keyStr}" on "${paths}"`), CTX.autotracker?.track(fullPath, this, true);
+        this.log(`\u{1F5D1}\uFE0F [\`deleteProperty\` Trap] Initiated for "${keyStr}" on [${paths}]`), CTX.autotracker?.track(fullPath, this, true);
         if (this.config.deleteProperty) terminated = (value = this.config.deleteProperty(object, key2, oldValue, receiver, paths)) === TERMINATOR;
         if (this.deleters) {
           const wildcords = this.deleters.get("*");
@@ -431,9 +436,9 @@ var Reactor = class {
             if (!(terminated ||= payload.terminated)) value = result;
           }
         }
-        if (terminated) return this.log(`\u{1F6E1}\uFE0F [Reactor \`deleteProperty\` Trap] Terminated for "${keyStr}" on "${paths}"`), true;
+        if (terminated) return this.log(`\u{1F6E1}\uFE0F [\`deleteProperty\` Trap] Terminated for "${keyStr}" on [${paths}]`), true;
         const success = !this.config.preserveContext ? delete object[key2] : Reflect.deleteProperty(object, key2);
-        if (!success) return this.log(`\u274C [Reactor \`deleteProperty\` Trap] Failed for "${keyStr}" on "${paths}"`), false;
+        if (!success) return this.log(`\u274C [\`deleteProperty\` Trap] Failed for "${keyStr}" on [${paths}]`), false;
         if (this.config.referenceTracking) this.config.smartCloning && this.stamp(object), this.unlink(oldValue?.[RAW] || oldValue, object, keyStr);
         if (this.watchers || this.listeners)
           for (let i = 0; i < loopLen; i++) {
@@ -445,21 +450,21 @@ var Reactor = class {
       has: (object, key2) => {
         let has = !this.config.preserveContext ? key2 in object : Reflect.has(object, key2);
         const keyStr = String(key2), fullPath = path ? path + "." + keyStr : keyStr;
-        this.log(`\u2753 [Reactor \`has\` Trap] Initiated for "${keyStr}" on "${fullPath}"`), CTX.autotracker?.track(fullPath, this);
+        this.log(`\u2753 [\`has\` Trap] Initiated for "${keyStr}" on '${fullPath}'`), CTX.autotracker?.track(fullPath, this);
         if (this.config.has) has = this.config.has(object, key2, has, this.proxyCache.get(object), fullPath);
         return has;
       },
       getOwnPropertyDescriptor: (object, key2) => {
         let descriptor = !this.config.preserveContext ? Object.getOwnPropertyDescriptor(object, key2) : Reflect.getOwnPropertyDescriptor(object, key2);
         const keyStr = String(key2), fullPath = path ? path + "." + keyStr : keyStr;
-        this.log(`\u{1F4CB} [Reactor \`getOwnPropertyDescriptor\` Trap] Initiated for "${keyStr}" on "${fullPath}"`), CTX.autotracker?.track(fullPath, this);
+        this.log(`\u{1F4CB} [\`getOwnPropertyDescriptor\` Trap] Initiated for "${keyStr}" on '${fullPath}'`), CTX.autotracker?.track(fullPath, this);
         if (this.config.getOwnPropertyDescriptor) descriptor = this.config.getOwnPropertyDescriptor(object, key2, descriptor, this.proxyCache.get(object), this.config.lineageTracing ? this.trace(object, keyStr) : fullPath);
         return descriptor;
       },
       ownKeys: (object) => {
         let ownKeys = Reflect.ownKeys(object);
         const safePath = path || "*";
-        this.log(`\u{1F511} [Reactor \`ownKeys\` Trap] Initiated on "${safePath}"`), CTX.autotracker?.track(safePath, this);
+        this.log(`\u{1F511} [\`ownKeys\` Trap] Initiated on "${safePath}"`), CTX.autotracker?.track(safePath, this);
         if (this.config.ownKeys) ownKeys = this.config.ownKeys(object, ownKeys, this.proxyCache.get(object), safePath);
         return ownKeys;
       }
@@ -938,41 +943,44 @@ var Autotracker = class {
       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);
+        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);
+        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);
+        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}"`);
+        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}"`);
+        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}"`);
+        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}"`);
+        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) {
+  track(path, rtr = this.rtr, prune = false, strict = 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);
+    if (path.startsWith(this.lastPath + ".")) {
+      const child = path.slice(this.lastPath.length + 1);
+      (strict || !child.includes("Symbol(") && child !== "length" && !/^\d+$/.test(child)) && paths.delete(this.lastPath);
+    }
     return !prune && paths.add(this.lastPath = path), path;
   }
   /** Removes a path from the tracking set. */
@@ -1131,16 +1139,22 @@ var wpArr = ["*"];
 function createEl(tag, props, dataset, styles, el = tag ? document?.createElement(tag) : null) {
   return assignEl(el, props, dataset, styles);
 }
-function assignEl(el, props, dataset, styles) {
+function assignEl(el, props, dataset, styles, nodiff = true) {
   if (!el) return null;
   if (props) {
-    for (const k of Object.keys(props)) if (props[k] !== void 0) el[k] = props[k];
+    for (const k of Object.keys(props)) if (props[k] !== void 0) {
+      if (nodiff || el[k] !== props[k]) el[k] = props[k];
+    }
   }
   if (dataset) {
-    for (const k of Object.keys(dataset)) if (dataset[k] !== void 0) el.dataset[k] = String(dataset[k]);
+    for (const k of Object.keys(dataset)) if (dataset[k] !== void 0) {
+      if (nodiff || el.dataset[k] !== dataset[k]) 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];
+    for (const k of Object.keys(styles)) if (styles[k] !== void 0) {
+      if (nodiff || el.style[k] !== styles[k]) el.style[k] = styles[k];
+    }
   }
   return el;
 }
@@ -1193,7 +1207,7 @@ function keyEventAllowed(e, settings) {
   if (settings.disabled) return false;
   const activeEl = getActiveEl(e.target?.ownerDocument);
   if ((e.key === " " || e.key === "Enter") && activeEl?.matches("button,input[type='button'],input[type='submit']")) return false;
-  if (e.currentTarget !== activeEl && activeEl?.matches("input,textarea,[contenteditable]") && !(e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey)) return false;
+  if (e.currentTarget !== activeEl && activeEl?.matches("input,textarea,[contenteditable],[role]") && !(e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey)) return false;
   const combo = stringifyKeyEvent(e), { override, block, action, whitelisted } = getTermsForKey(combo, settings);
   if (block) return false;
   if (override) e.preventDefault();
@@ -1240,7 +1254,7 @@ var TimeTravelConsole = class _TimeTravelConsole {
    * @param time TimeTravel module instance that owns timeline operations.
    * @param build Optional initial overlay config overrides.
    */
-  constructor(time, build = {}) {
+  constructor(time, build = { devOnly: true }) {
     this.time = time;
     this.config = reactive({ title: `Time Travel Console ${this.index = ++_TimeTravelConsole.count}`, ...build });
     this.state.open = !!this.config.startOpen;

package/dist/adapters/react.d.cts

@@ -1,7 +1,7 @@
-import { E as EffectOptions, d as Reactor, R as Reactive, G as ReactorBuild, H as DeepReadonly, W as WildPaths, a as PathValue } from '../index-rWwvrfdn.cjs';
+import { E as EffectOptions, d as Reactor, R as Reactive, J as ReactorBuild, K as DeepReadonly, W as WildPaths, a as PathValue } from '../index-D0NxfxUv.cjs';
 import { useLayoutEffect } from 'react';
-import { T as TimeTravelModule } from '../index-CuLuFYu3.cjs';
-import { a as TimeTravelConsoleConfig } from '../TimeTravelConsole-zvu8eqTZ.cjs';
+import { T as TimeTravelModule } from '../index-CQNn1GIg.cjs';
+import { a as TimeTravelConsoleConfig } from '../TimeTravelConsole-C9eSXGTz.cjs';
 
 /**
  * Subscribes a component to desired Reactor state and returns it.

package/dist/adapters/react.d.ts

@@ -1,7 +1,7 @@
-import { E as EffectOptions, d as Reactor, R as Reactive, G as ReactorBuild, H as DeepReadonly, W as WildPaths, a as PathValue } from '../index-rWwvrfdn.js';
+import { E as EffectOptions, d as Reactor, R as Reactive, J as ReactorBuild, K as DeepReadonly, W as WildPaths, a as PathValue } from '../index-D0NxfxUv.js';
 import { useLayoutEffect } from 'react';
-import { T as TimeTravelModule } from '../index-D_U8Nai1.js';
-import { a as TimeTravelConsoleConfig } from '../TimeTravelConsole-BLDKZ0U1.js';
+import { T as TimeTravelModule } from '../index-lo6ft5Zu.js';
+import { a as TimeTravelConsoleConfig } from '../TimeTravelConsole-B1du_ohf.js';
 
 /**
  * Subscribes a component to desired Reactor state and returns it.

package/dist/adapters/react.js

@@ -2,18 +2,16 @@ import {
   Autotracker,
   TimeTravelConsole,
   withTracker
-} from "../chunk-4S44OX5N.js";
-import "../chunk-A3ZCYWWM.js";
-import {
-  getReactor
-} from "../chunk-OTBKVZ4L.js";
-import "../chunk-243U74PP.js";
+} from "../chunk-OFH4X3QD.js";
+import "../chunk-EA3LQVCI.js";
+import "../chunk-ORK3EGB6.js";
 import {
   CTX,
   NIL,
   NOOP,
-  getPath
-} from "../chunk-2ZYYYSZ4.js";
+  getPath,
+  getReactor
+} from "../chunk-WYSENFHG.js";
 
 // src/ts/adapters/react/hooks/useReactor.ts
 import { useRef, useCallback, useSyncExternalStore, useMemo } from "react";