sia-reactor 0.0.31 → 0.0.33

package/dist/adapters/react.cjs

@@ -666,9 +666,8 @@ var Reactor = class {
     if (cord) return cord.clup;
     let task;
     cord = { cb, once, clup: () => (lazy && this.nostall(task), this[`no${key}`](path, cb)) };
-    immediate && onImmediate(immediate);
     task = () => (cords ?? (store.set(path, cords = []), cords)).push(cord);
-    lazy ? this.stall(task) : task();
+    immediate && onImmediate(immediate), lazy ? this.stall(task) : task();
     return this.bindSignal(cord, signal);
   }
   dropSync(store, path, cb) {
@@ -766,7 +765,7 @@ var Reactor = class {
    * const cleanup = rtr.watch("user.name", (value) => console.log(value));
    */
   watch(path, callback, options) {
-    return this.addSync("watch", path, callback, options, (imm) => imm !== "auto" && inAny(this.core, path) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
+    return this.addSync("watch", path, callback, options, (imm) => (imm !== "auto" || inAny(this.core, path)) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
   }
   /** Registers a watcher for a path that only triggers once. */
   wonce(path, callback, options) {
@@ -1132,6 +1131,10 @@ function assignEl(el, props, dataset, styles) {
     for (const k of Object.keys(styles)) if (styles[k] !== void 0) el.style[k] = styles[k];
   }
 }
+function getActiveEl(root) {
+  const activeEl = (root ?? document).activeElement;
+  return !activeEl ? null : activeEl.shadowRoot ? getActiveEl(activeEl.shadowRoot) : activeEl;
+}
 
 // src/ts/utils/keys.ts
 function stringifyKeyEvent(e) {
@@ -1173,7 +1176,7 @@ function getTermsForKey(combo, settings) {
   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;
+  if (settings.disabled || (e.key === " " || e.key === "Enter") && getActiveEl(e.target?.ownerDocument)?.matches("button,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();

package/dist/adapters/react.js

@@ -2,13 +2,13 @@ import {
   Autotracker,
   TimeTravelOverlay,
   withTracker
-} from "../chunk-UYRDN3OX.js";
+} from "../chunk-UXQ5NJIO.js";
 import "../chunk-PLYS4CVP.js";
-import "../chunk-GD7HZBXA.js";
+import "../chunk-QPJNSYXT.js";
 import {
   getReactor
-} from "../chunk-AKQSBLBX.js";
-import "../chunk-RVYL3OLW.js";
+} from "../chunk-6HZSS2TX.js";
+import "../chunk-RI45W4O6.js";
 import "../chunk-3OT72G7R.js";
 import {
   CTX,

package/dist/adapters/vanilla.cjs

@@ -654,9 +654,8 @@ var Reactor = class {
     if (cord) return cord.clup;
     let task;
     cord = { cb, once, clup: () => (lazy && this.nostall(task), this[`no${key}`](path, cb)) };
-    immediate && onImmediate(immediate);
     task = () => (cords ?? (store.set(path, cords = []), cords)).push(cord);
-    lazy ? this.stall(task) : task();
+    immediate && onImmediate(immediate), lazy ? this.stall(task) : task();
     return this.bindSignal(cord, signal);
   }
   dropSync(store, path, cb) {
@@ -754,7 +753,7 @@ var Reactor = class {
    * const cleanup = rtr.watch("user.name", (value) => console.log(value));
    */
   watch(path, callback, options) {
-    return this.addSync("watch", path, callback, options, (imm) => imm !== "auto" && inAny(this.core, path) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
+    return this.addSync("watch", path, callback, options, (imm) => (imm !== "auto" || inAny(this.core, path)) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
   }
   /** Registers a watcher for a path that only triggers once. */
   wonce(path, callback, options) {
@@ -878,6 +877,27 @@ function getReactor(target, create = false, build) {
   return (target instanceof Reactor ? target : target.__Reactor__) || (create ? new Reactor(target, build) : void 0);
 }
 
+// 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];
+  }
+}
+function getActiveEl(root) {
+  const activeEl = (root ?? document).activeElement;
+  return !activeEl ? null : activeEl.shadowRoot ? getActiveEl(activeEl.shadowRoot) : activeEl;
+}
+
 // src/ts/utils/keys.ts
 function stringifyKeyEvent(e) {
   const parts = [];
@@ -918,7 +938,7 @@ function getTermsForKey(combo, settings) {
   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;
+  if (settings.disabled || (e.key === " " || e.key === "Enter") && getActiveEl(e.target?.ownerDocument)?.matches("button,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();
@@ -932,23 +952,6 @@ function parseForARIAKS(s, formatted = true) {
   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];
-  }
-}
-
 // src/ts/modules/base.ts
 var wpArr = ["*"];
 

package/dist/adapters/vanilla.js

@@ -3,11 +3,11 @@ import {
   TimeTravelOverlay,
   effect,
   withTracker
-} from "../chunk-UYRDN3OX.js";
+} from "../chunk-UXQ5NJIO.js";
 import "../chunk-PLYS4CVP.js";
-import "../chunk-GD7HZBXA.js";
-import "../chunk-AKQSBLBX.js";
-import "../chunk-RVYL3OLW.js";
+import "../chunk-QPJNSYXT.js";
+import "../chunk-6HZSS2TX.js";
+import "../chunk-RI45W4O6.js";
 import "../chunk-3OT72G7R.js";
 import "../chunk-EZ4VRGYI.js";
 export {

package/dist/{chunk-AKQSBLBX.js → chunk-6HZSS2TX.js}

@@ -510,9 +510,8 @@ var Reactor = class {
     if (cord) return cord.clup;
     let task;
     cord = { cb, once, clup: () => (lazy && this.nostall(task), this[`no${key}`](path, cb)) };
-    immediate && onImmediate(immediate);
     task = () => (cords ?? (store.set(path, cords = []), cords)).push(cord);
-    lazy ? this.stall(task) : task();
+    immediate && onImmediate(immediate), lazy ? this.stall(task) : task();
     return this.bindSignal(cord, signal);
   }
   dropSync(store, path, cb) {
@@ -610,7 +609,7 @@ var Reactor = class {
    * const cleanup = rtr.watch("user.name", (value) => console.log(value));
    */
   watch(path, callback, options) {
-    return this.addSync("watch", path, callback, options, (imm) => imm !== "auto" && inAny(this.core, path) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
+    return this.addSync("watch", path, callback, options, (imm) => (imm !== "auto" || inAny(this.core, path)) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
   }
   /** Registers a watcher for a path that only triggers once. */
   wonce(path, callback, options) {

package/dist/{chunk-GD7HZBXA.js → chunk-QPJNSYXT.js}

@@ -1,7 +1,7 @@
 import {
   getReactor,
   reactive
-} from "./chunk-AKQSBLBX.js";
+} from "./chunk-6HZSS2TX.js";
 import {
   guardAllMethods,
   guardMethod

package/dist/{chunk-RVYL3OLW.js → chunk-RI45W4O6.js}

@@ -1,3 +1,24 @@
+// 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];
+  }
+}
+function getActiveEl(root) {
+  const activeEl = (root ?? document).activeElement;
+  return !activeEl ? null : activeEl.shadowRoot ? getActiveEl(activeEl.shadowRoot) : activeEl;
+}
+
 // src/ts/utils/keys.ts
 function parseKeyCombo(combo) {
   const parts = cleanKeyCombo(combo).toLowerCase().split("+");
@@ -42,7 +63,7 @@ function getTermsForKey(combo, settings) {
   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;
+  if (settings.disabled || (e.key === " " || e.key === "Enter") && getActiveEl(e.target?.ownerDocument)?.matches("button,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();
@@ -61,24 +82,10 @@ function parseForARIAKS(s, formatted = true) {
   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];
-  }
-}
-
 export {
+  createEl,
+  assignEl,
+  getActiveEl,
   parseKeyCombo,
   stringifyKeyEvent,
   cleanKeyCombo,
@@ -87,7 +94,5 @@ export {
   keyEventAllowed,
   formatKeyForDisplay,
   formatKeyShortcutsForDisplay,
-  parseForARIAKS,
-  createEl,
-  assignEl
+  parseForARIAKS
 };

package/dist/{chunk-UYRDN3OX.js → chunk-UXQ5NJIO.js}

@@ -1,15 +1,15 @@
 import {
   wpArr
-} from "./chunk-GD7HZBXA.js";
+} from "./chunk-QPJNSYXT.js";
 import {
   reactive
-} from "./chunk-AKQSBLBX.js";
+} from "./chunk-6HZSS2TX.js";
 import {
   createEl,
   formatKeyForDisplay,
   keyEventAllowed,
   parseForARIAKS
-} from "./chunk-RVYL3OLW.js";
+} from "./chunk-RI45W4O6.js";
 import {
   CTX,
   NIL,

package/dist/index.cjs

@@ -679,9 +679,8 @@ var Reactor = class {
     if (cord) return cord.clup;
     let task;
     cord = { cb, once, clup: () => (lazy && this.nostall(task), this[`no${key}`](path, cb)) };
-    immediate && onImmediate(immediate);
     task = () => (cords ?? (store.set(path, cords = []), cords)).push(cord);
-    lazy ? this.stall(task) : task();
+    immediate && onImmediate(immediate), lazy ? this.stall(task) : task();
     return this.bindSignal(cord, signal);
   }
   dropSync(store, path, cb) {
@@ -779,7 +778,7 @@ var Reactor = class {
    * const cleanup = rtr.watch("user.name", (value) => console.log(value));
    */
   watch(path, callback, options) {
-    return this.addSync("watch", path, callback, options, (imm) => imm !== "auto" && inAny(this.core, path) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
+    return this.addSync("watch", path, callback, options, (imm) => (imm !== "auto" || inAny(this.core, path)) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
   }
   /** Registers a watcher for a path that only triggers once. */
   wonce(path, callback, options) {

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   stable,
   state,
   volatile
-} from "./chunk-AKQSBLBX.js";
+} from "./chunk-6HZSS2TX.js";
 import {
   CTX,
   EVT_OPTS,

package/dist/modules.cjs

@@ -716,9 +716,8 @@ var Reactor = class {
     if (cord) return cord.clup;
     let task;
     cord = { cb, once, clup: () => (lazy && this.nostall(task), this[`no${key}`](path, cb)) };
-    immediate && onImmediate(immediate);
     task = () => (cords ?? (store.set(path, cords = []), cords)).push(cord);
-    lazy ? this.stall(task) : task();
+    immediate && onImmediate(immediate), lazy ? this.stall(task) : task();
     return this.bindSignal(cord, signal);
   }
   dropSync(store, path, cb) {
@@ -816,7 +815,7 @@ var Reactor = class {
    * const cleanup = rtr.watch("user.name", (value) => console.log(value));
    */
   watch(path, callback, options) {
-    return this.addSync("watch", path, callback, options, (imm) => imm !== "auto" && inAny(this.core, path) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
+    return this.addSync("watch", path, callback, options, (imm) => (imm !== "auto" || inAny(this.core, path)) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
   }
   /** Registers a watcher for a path that only triggers once. */
   wonce(path, callback, options) {

package/dist/modules.js

@@ -5,8 +5,8 @@ import {
 import {
   BaseReactorModule,
   wpArr
-} from "./chunk-GD7HZBXA.js";
-import "./chunk-AKQSBLBX.js";
+} from "./chunk-QPJNSYXT.js";
+import "./chunk-6HZSS2TX.js";
 import "./chunk-3OT72G7R.js";
 import {
   NIL,

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

@@ -1,11 +1,12 @@
 .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);
+  --sia-brand-color: rgb(from var(--sia-tt-color) r g b / 1);
+  --sia-tt-bg: rgb(from var(--sia-brand-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-brand-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-brand-color) h calc(s * 0.1) 24% / 0.6);
+  --sia-tt-text: rgb(from var(--sia-brand-color) calc((r * 0.2) + 218) calc((g * 0.11) + 214) calc((b * 0.09) + 214));
+  --sia-tt-muted: rgb(from var(--sia-brand-color) calc((r * 0.24) + 150) calc((g * 0.14) + 146) calc((b * 0.12) + 146));
+  --sia-tt-input-bg: rgb(from var(--sia-brand-color) calc((r * 0.08) + 8) calc((g * 0.07) + 8) calc((b * 0.09) + 10) / 0.66);
   position: relative;
 }
 
@@ -21,15 +22,15 @@
   padding: 0;
   margin: 0;
   scrollbar-width: thin;
-  scrollbar-color: var(--sia-tt-color) transparent;
+  scrollbar-color: var(--sia-brand-color) transparent;
 }
 
 :where(.tt-overlay-host) *::selection {
   color: currentColor;
-  background-color: var(--sia-tt-color);
+  background-color: rgb(from var(--sia-brand-color) r g b / 0.25);
 }
 .tt-overlay-host :is(*:focus-visible, #o#o#o#o#o) {
-  outline: 1.5px dashed var(--sia-tt-color);
+  outline: 1.5px dashed var(--sia-brand-color);
   outline-offset: 1px;
   transition: none;
 }
@@ -106,7 +107,7 @@
 }
 
 .tt-overlay .title {
-  color: var(--sia-tt-color);
+  color: var(--sia-brand-color);
   font-weight: bold;
 }
 
@@ -122,7 +123,7 @@
 }
 
 .tt-overlay button:hover {
-  border-color: hsl(from var(--sia-tt-color) h calc(s * 0.35) 40% / 0.9);
+  border-color: hsl(from var(--sia-brand-color) h calc(s * 0.35) 40% / 0.9);
 }
 
 .tt-overlay button:disabled {
@@ -175,7 +176,7 @@
 .tt-overlay input[type="range"] {
   width: 100%;
   height: 5px;
-  accent-color: var(--sia-tt-color);
+  accent-color: var(--sia-brand-color);
   border-radius: 8px;
 }
 
@@ -218,7 +219,7 @@
 }
 
 .tt-footnote a {
-  color: var(--sia-tt-color);
+  color: var(--sia-brand-color);
   text-decoration: none;
   border-bottom: 1px solid var(--sia-tt-line);
 }

package/dist/super.d.ts

@@ -1365,7 +1365,7 @@ declare function getTermsForKey(combo: string, settings: keysSettings): {
  */
 declare function keyEventAllowed(e: KeyboardEvent, settings: keysSettings): false | string;
 /**
- * Formats one or many combos for human-readable UI labels.
+ * Formats one or many combos for human-readable UI labels, prepends " " for fluid appending.
  * @param combo Combo or combo list.
  * @returns Display label (for example: `" (ctrl+z) or (meta+z)"`).
  */
@@ -1394,10 +1394,30 @@ declare function parseForARIAKS(s: string | string[], formatted?: boolean): stri
 
 type Dataset = Record<string, string | number>;
 type Style = Partial<CSSStyleDeclaration>;
+/**
+ * Creates an HTML element with the specified tag and properties.
+ * @param tag The tag name of the element to create.
+ * @param props Optional properties to set on the element.
+ * @param dataset Optional dataset attributes for the element.
+ * @param styles Optional CSS styles for the element.
+ * @returns The created HTML element.
+ */
 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;
+/**
+ * Assigns properties, dataset attributes, and styles to an HTML element.
+ * @param el The HTML element to assign properties to.
+ * @param props Optional properties to set on the element.
+ * @param dataset Optional dataset attributes for the element.
+ * @param styles Optional CSS styles for the element.
+ */
 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;
+/** Get the currently active element, traversing into shadow roots if necessary.
+ * @param root Root node to start searching from, defaults to the main document.
+ * @returns The active element or null if none found.
+ */
+declare function getActiveEl(root?: Document | ShadowRoot | null): Element | null;
 
 type utils_FanoutTuple = FanoutTuple;
 type utils_KeyStruct = KeyStruct;
@@ -1414,6 +1434,7 @@ declare const utils_fanout: typeof fanout;
 declare const utils_fanoutOptsArr: typeof fanoutOptsArr;
 declare const utils_formatKeyForDisplay: typeof formatKeyForDisplay;
 declare const utils_formatKeyShortcutsForDisplay: typeof formatKeyShortcutsForDisplay;
+declare const utils_getActiveEl: typeof getActiveEl;
 declare const utils_getAny: typeof getAny;
 declare const utils_getTermsForKey: typeof getTermsForKey;
 declare const utils_getTrailRecords: typeof getTrailRecords;
@@ -1438,7 +1459,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_FanoutTuple as FanoutTuple, type utils_KeyStruct as KeyStruct, utils_arrRegex as arrRegex, 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_fanout as fanout, utils_fanoutOptsArr as fanoutOptsArr, 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_FanoutTuple as FanoutTuple, type utils_KeyStruct as KeyStruct, utils_arrRegex as arrRegex, 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_fanout as fanout, utils_fanoutOptsArr as fanoutOptsArr, utils_formatKeyForDisplay as formatKeyForDisplay, utils_formatKeyShortcutsForDisplay as formatKeyShortcutsForDisplay, utils_getActiveEl as getActiveEl, 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 };
 }
 
 type JSONReplacer = ((this: any, key: string, value: any) => any) | (number | string)[] | null;

package/dist/super.global.js

@@ -743,9 +743,8 @@ var sia = (() => {
       if (cord) return cord.clup;
       let task;
       cord = { cb, once, clup: () => (lazy && this.nostall(task), this[`no${key}`](path, cb)) };
-      immediate && onImmediate(immediate);
       task = () => (cords ?? (store.set(path, cords = []), cords)).push(cord);
-      lazy ? this.stall(task) : task();
+      immediate && onImmediate(immediate), lazy ? this.stall(task) : task();
       return this.bindSignal(cord, signal);
     }
     dropSync(store, path, cb) {
@@ -843,7 +842,7 @@ var sia = (() => {
      * const cleanup = rtr.watch("user.name", (value) => console.log(value));
      */
     watch(path, callback, options) {
-      return this.addSync("watch", path, callback, options, (imm) => imm !== "auto" && inAny(this.core, path) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
+      return this.addSync("watch", path, callback, options, (imm) => (imm !== "auto" || inAny(this.core, path)) && ((target) => callback(target.value, { type: "init", target, currentTarget: target, root: this.core, rejectable: false }))(this.getContext(path)));
     }
     /** Registers a watcher for a path that only triggers once. */
     wonce(path, callback, options) {
@@ -1019,6 +1018,7 @@ var sia = (() => {
     fanoutOptsArr: () => fanoutOptsArr,
     formatKeyForDisplay: () => formatKeyForDisplay,
     formatKeyShortcutsForDisplay: () => formatKeyShortcutsForDisplay,
+    getActiveEl: () => getActiveEl,
     getAny: () => getAny,
     getTermsForKey: () => getTermsForKey,
     getTrailRecords: () => getTrailRecords,
@@ -1103,6 +1103,27 @@ var sia = (() => {
     });
   }
 
+  // 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];
+    }
+  }
+  function getActiveEl(root) {
+    const activeEl = (root ?? document).activeElement;
+    return !activeEl ? null : activeEl.shadowRoot ? getActiveEl(activeEl.shadowRoot) : activeEl;
+  }
+
   // src/ts/utils/keys.ts
   function parseKeyCombo(combo) {
     const parts = cleanKeyCombo(combo).toLowerCase().split("+");
@@ -1147,7 +1168,7 @@ var sia = (() => {
     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;
+    if (settings.disabled || (e.key === " " || e.key === "Enter") && getActiveEl(e.target?.ownerDocument)?.matches("button,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();
@@ -1166,23 +1187,6 @@ var sia = (() => {
     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];
-    }
-  }
-
   // src/ts/modules.ts
   var modules_exports = {};
   __export(modules_exports, {

package/dist/utils.cjs

@@ -33,6 +33,7 @@ __export(utils_exports, {
   fanoutOptsArr: () => fanoutOptsArr,
   formatKeyForDisplay: () => formatKeyForDisplay,
   formatKeyShortcutsForDisplay: () => formatKeyShortcutsForDisplay,
+  getActiveEl: () => getActiveEl,
   getAny: () => getAny,
   getTermsForKey: () => getTermsForKey,
   getTrailRecords: () => getTrailRecords,
@@ -309,6 +310,27 @@ function guardMethod(fn, onError = (e) => console.error(e)) {
   });
 }
 
+// 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];
+  }
+}
+function getActiveEl(root) {
+  const activeEl = (root ?? document).activeElement;
+  return !activeEl ? null : activeEl.shadowRoot ? getActiveEl(activeEl.shadowRoot) : activeEl;
+}
+
 // src/ts/utils/keys.ts
 function parseKeyCombo(combo) {
   const parts = cleanKeyCombo(combo).toLowerCase().split("+");
@@ -353,7 +375,7 @@ function getTermsForKey(combo, settings) {
   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;
+  if (settings.disabled || (e.key === " " || e.key === "Enter") && getActiveEl(e.target?.ownerDocument)?.matches("button,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();
@@ -371,23 +393,6 @@ 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 = {
   arrRegex,
@@ -403,6 +408,7 @@ function assignEl(el, props, dataset, styles) {
   fanoutOptsArr,
   formatKeyForDisplay,
   formatKeyShortcutsForDisplay,
+  getActiveEl,
   getAny,
   getTermsForKey,
   getTrailRecords,

package/dist/utils.d.cts

@@ -141,7 +141,7 @@ declare function getTermsForKey(combo: string, settings: keysSettings): {
  */
 declare function keyEventAllowed(e: KeyboardEvent, settings: keysSettings): false | string;
 /**
- * Formats one or many combos for human-readable UI labels.
+ * Formats one or many combos for human-readable UI labels, prepends " " for fluid appending.
  * @param combo Combo or combo list.
  * @returns Display label (for example: `" (ctrl+z) or (meta+z)"`).
  */
@@ -170,9 +170,29 @@ declare function parseForARIAKS(s: string | string[], formatted?: boolean): stri
 
 type Dataset = Record<string, string | number>;
 type Style = Partial<CSSStyleDeclaration>;
+/**
+ * Creates an HTML element with the specified tag and properties.
+ * @param tag The tag name of the element to create.
+ * @param props Optional properties to set on the element.
+ * @param dataset Optional dataset attributes for the element.
+ * @param styles Optional CSS styles for the element.
+ * @returns The created HTML element.
+ */
 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;
+/**
+ * Assigns properties, dataset attributes, and styles to an HTML element.
+ * @param el The HTML element to assign properties to.
+ * @param props Optional properties to set on the element.
+ * @param dataset Optional dataset attributes for the element.
+ * @param styles Optional CSS styles for the element.
+ */
 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;
+/** Get the currently active element, traversing into shadow roots if necessary.
+ * @param root Root node to start searching from, defaults to the main document.
+ * @returns The active element or null if none found.
+ */
+declare function getActiveEl(root?: Document | ShadowRoot | null): Element | null;
 
-export { type KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };
+export { type KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getActiveEl, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };

package/dist/utils.d.ts

@@ -141,7 +141,7 @@ declare function getTermsForKey(combo: string, settings: keysSettings): {
  */
 declare function keyEventAllowed(e: KeyboardEvent, settings: keysSettings): false | string;
 /**
- * Formats one or many combos for human-readable UI labels.
+ * Formats one or many combos for human-readable UI labels, prepends " " for fluid appending.
  * @param combo Combo or combo list.
  * @returns Display label (for example: `" (ctrl+z) or (meta+z)"`).
  */
@@ -170,9 +170,29 @@ declare function parseForARIAKS(s: string | string[], formatted?: boolean): stri
 
 type Dataset = Record<string, string | number>;
 type Style = Partial<CSSStyleDeclaration>;
+/**
+ * Creates an HTML element with the specified tag and properties.
+ * @param tag The tag name of the element to create.
+ * @param props Optional properties to set on the element.
+ * @param dataset Optional dataset attributes for the element.
+ * @param styles Optional CSS styles for the element.
+ * @returns The created HTML element.
+ */
 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;
+/**
+ * Assigns properties, dataset attributes, and styles to an HTML element.
+ * @param el The HTML element to assign properties to.
+ * @param props Optional properties to set on the element.
+ * @param dataset Optional dataset attributes for the element.
+ * @param styles Optional CSS styles for the element.
+ */
 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;
+/** Get the currently active element, traversing into shadow roots if necessary.
+ * @param root Root node to start searching from, defaults to the main document.
+ * @returns The active element or null if none found.
+ */
+declare function getActiveEl(root?: Document | ShadowRoot | null): Element | null;
 
-export { type KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };
+export { type KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getActiveEl, getTermsForKey, guardAllMethods, guardMethod, keyEventAllowed, type keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent };

package/dist/utils.js

@@ -10,13 +10,14 @@ import {
   createEl,
   formatKeyForDisplay,
   formatKeyShortcutsForDisplay,
+  getActiveEl,
   getTermsForKey,
   keyEventAllowed,
   matchKeys,
   parseForARIAKS,
   parseKeyCombo,
   stringifyKeyEvent
-} from "./chunk-RVYL3OLW.js";
+} from "./chunk-RI45W4O6.js";
 import {
   bindAllMethods,
   guardAllMethods,
@@ -55,6 +56,7 @@ export {
   fanoutOptsArr,
   formatKeyForDisplay,
   formatKeyShortcutsForDisplay,
+  getActiveEl,
   getAny,
   getTermsForKey,
   getTrailRecords,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sia-reactor",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "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",