sia-reactor 0.0.31 → 0.0.32

package/dist/adapters/react.cjs

@@ -1132,6 +1132,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 +1177,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-XNYVGOKB.js";
 import "../chunk-PLYS4CVP.js";
 import "../chunk-GD7HZBXA.js";
 import {
   getReactor
 } from "../chunk-AKQSBLBX.js";
-import "../chunk-RVYL3OLW.js";
+import "../chunk-RI45W4O6.js";
 import "../chunk-3OT72G7R.js";
 import {
   CTX,

package/dist/adapters/vanilla.cjs

@@ -878,6 +878,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 +939,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 +953,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-XNYVGOKB.js";
 import "../chunk-PLYS4CVP.js";
 import "../chunk-GD7HZBXA.js";
 import "../chunk-AKQSBLBX.js";
-import "../chunk-RVYL3OLW.js";
+import "../chunk-RI45W4O6.js";
 import "../chunk-3OT72G7R.js";
 import "../chunk-EZ4VRGYI.js";
 export {

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-XNYVGOKB.js}

@@ -9,7 +9,7 @@ import {
   formatKeyForDisplay,
   keyEventAllowed,
   parseForARIAKS
-} from "./chunk-RVYL3OLW.js";
+} from "./chunk-RI45W4O6.js";
 import {
   CTX,
   NIL,

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

@@ -1019,6 +1019,7 @@ var sia = (() => {
     fanoutOptsArr: () => fanoutOptsArr,
     formatKeyForDisplay: () => formatKeyForDisplay,
     formatKeyShortcutsForDisplay: () => formatKeyShortcutsForDisplay,
+    getActiveEl: () => getActiveEl,
     getAny: () => getAny,
     getTermsForKey: () => getTermsForKey,
     getTrailRecords: () => getTrailRecords,
@@ -1103,6 +1104,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 +1169,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 +1188,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.32",
   "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",