@t007/utils 0.0.16 → 0.0.21

package/dist/index.cjs

@@ -21,15 +21,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   VIRTUAL_RESOURCE: () => VIRTUAL_RESOURCE,
-  assignEl: () => assignEl,
-  bindAllMethods: () => import_utils4.bindAllMethods,
+  assignEl: () => import_utils.assignEl,
+  bindAllMethods: () => import_utils6.bindAllMethods,
   bindCleanupToSignal: () => bindCleanupToSignal,
   breath: () => breath,
-  clamp: () => import_utils2.clamp,
-  createEl: () => createEl,
+  clamp: () => import_utils3.clamp,
+  cleanKeyCombo: () => import_utils5.cleanKeyCombo,
+  createEl: () => import_utils.createEl,
   deepBreath: () => deepBreath,
-  guardAllMethods: () => import_utils4.guardAllMethods,
-  guardMethod: () => import_utils4.guardMethod,
+  formatKeyForDisplay: () => import_utils5.formatKeyForDisplay,
+  formatKeyShortcutsForDisplay: () => import_utils5.formatKeyShortcutsForDisplay,
+  getTermsForKey: () => import_utils5.getTermsForKey,
+  guardAllMethods: () => import_utils6.guardAllMethods,
+  guardMethod: () => import_utils6.guardMethod,
   inBoolArrOpt: () => inBoolArrOpt,
   initScrollAssist: () => initScrollAssist,
   initVScrollerator: () => initVScrollerator,
@@ -39,39 +43,30 @@ __export(index_exports, {
   isFunc: () => isFunc,
   isIter: () => isIter,
   isNum: () => isNum,
-  isObj: () => import_utils.isObj,
+  isObj: () => import_utils2.isObj,
   isPOJO: () => isPOJO,
   isSameURL: () => isSameURL,
   isStr: () => isStr,
   isSym: () => isSym,
+  keyEventAllowed: () => import_utils5.keyEventAllowed,
   limited: () => limited,
   loadResource: () => loadResource,
+  matchKeys: () => import_utils5.matchKeys,
   mockAsync: () => mockAsync,
-  onAllMethods: () => import_utils4.onAllMethods,
+  onAllMethods: () => import_utils6.onAllMethods,
+  parseForARIAKS: () => import_utils5.parseForARIAKS,
+  parseKeyCombo: () => import_utils5.parseKeyCombo,
   removeScrollAssist: () => removeScrollAssist,
-  requestAnimationFrame: () => import_utils3.requestAnimationFrame,
-  setInterval: () => import_utils3.setInterval,
-  setTimeout: () => import_utils3.setTimeout,
+  requestAnimationFrame: () => import_utils4.requestAnimationFrame,
+  setInterval: () => import_utils4.setInterval,
+  setTimeout: () => import_utils4.setTimeout,
+  stringifyKeyEvent: () => import_utils5.stringifyKeyEvent,
   uid: () => uid
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/core/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];
-  }
-}
+var import_utils = require("sia-reactor/utils");
 var VIRTUAL_RESOURCE = /* @__PURE__ */ Symbol.for("T007_VIRTUAL_RESOURCE");
 function loadResource(req, type = "style", { module: module2, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, w = window) {
   w.t007 ??= {}, w.t007._resourceCache ??= {};
@@ -93,8 +88,8 @@ function loadResource(req, type = "style", { module: module2, media, crossOrigin
         }
       };
       const url = retryKey && remaining < attempts ? `${src}${src.includes("?") ? "&" : "?"}_${retryKey}=${Date.now()}` : src;
-      if (type === "script") w.document.body.append(el = createEl("script", { src: url, type: module2 ? "module" : "text/javascript", crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
-      else if (type === "style") w.document.head.append(el = createEl("link", { rel: "stylesheet", href: url, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
+      if (type === "script") w.document.body.append(el = (0, import_utils.createEl)("script", { src: url, type: module2 ? "module" : "text/javascript", crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
+      else if (type === "style") w.document.head.append(el = (0, import_utils.createEl)("link", { rel: "stylesheet", href: url, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
       else reject(new Error(`Unsupported resource type: ${type}`));
     })(attempts);
   });
@@ -102,7 +97,7 @@ function loadResource(req, type = "style", { module: module2, media, crossOrigin
 }
 
 // src/core/obj.ts
-var import_utils = require("sia-reactor/utils");
+var import_utils2 = require("sia-reactor/utils");
 function isDef(val) {
   return "undefined" !== typeof val;
 }
@@ -122,7 +117,7 @@ function isArr(obj) {
   return Array.isArray(obj);
 }
 function isPOJO(obj, crossRealms = false, typecheck = true) {
-  return (typecheck ? (0, import_utils.isObj)(obj, false) : true) && (crossRealms ? Object.prototype.toString.call(obj) === "[object Object]" : obj.constructor === Object);
+  return (typecheck ? (0, import_utils2.isObj)(obj, false) : true) && (crossRealms ? Object.prototype.toString.call(obj) === "[object Object]" : obj.constructor === Object);
 }
 function isIter(obj) {
   return obj != null && "function" === typeof obj[Symbol.iterator];
@@ -135,7 +130,7 @@ function inBoolArrOpt(opt, str) {
 }
 
 // src/core/num.ts
-var import_utils2 = require("sia-reactor/utils");
+var import_utils3 = require("sia-reactor/utils");
 
 // src/core/str.ts
 function uid(prefix = "") {
@@ -152,7 +147,7 @@ function isSameURL(src1, src2) {
 }
 
 // src/core/fn.ts
-var import_utils3 = require("sia-reactor/utils");
+var import_utils4 = require("sia-reactor/utils");
 function limited(FN_KEY, fn, opts = {}) {
   let count = 0, { key, maxTimes: max = 1 } = isStr(opts) ? { key: opts } : opts;
   const getReg = () => JSON.parse(localStorage.getItem(FN_KEY) || "{}"), setReg = (r) => localStorage.setItem(FN_KEY, JSON.stringify(r));
@@ -175,8 +170,11 @@ function bindCleanupToSignal(cleanup, signal) {
   return cleanup;
 }
 
-// src/core/methd.ts
-var import_utils4 = require("sia-reactor/utils");
+// src/core/keys.ts
+var import_utils5 = require("sia-reactor/utils");
+
+// src/mixins/methd.ts
+var import_utils6 = require("sia-reactor/utils");
 
 // src/quirks/scroll.ts
 function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, baseRate = 16, lineHeight = 80, margin = 80, car = window } = {}) {
@@ -240,7 +238,7 @@ function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "tmg-video-c
   };
   const stop = () => (cancelAnimationFrame(scrollId ?? 0), scrollId = null);
   const addAssist = (dir) => {
-    const div = createEl("div", { className: assistClassName }, { scrollDirection: dir }, { display: "none" });
+    const div = (0, import_utils.createEl)("div", { className: assistClassName }, { scrollDirection: dir }, { display: "none" });
     if (!div) return;
     ["pointerenter", "dragenter"].forEach((evt) => div.addEventListener(evt, () => scroll(dir)));
     ["pointerleave", "pointerup", "pointercancel", "dragleave", "dragend"].forEach((evt) => div.addEventListener(evt, stop));
@@ -285,8 +283,12 @@ if ("undefined" !== typeof window) {
   bindCleanupToSignal,
   breath,
   clamp,
+  cleanKeyCombo,
   createEl,
   deepBreath,
+  formatKeyForDisplay,
+  formatKeyShortcutsForDisplay,
+  getTermsForKey,
   guardAllMethods,
   guardMethod,
   inBoolArrOpt,
@@ -303,13 +305,18 @@ if ("undefined" !== typeof window) {
   isSameURL,
   isStr,
   isSym,
+  keyEventAllowed,
   limited,
   loadResource,
+  matchKeys,
   mockAsync,
   onAllMethods,
+  parseForARIAKS,
+  parseKeyCombo,
   removeScrollAssist,
   requestAnimationFrame,
   setInterval,
   setTimeout,
+  stringifyKeyEvent,
   uid
 });

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { bindAllMethods, clamp, guardAllMethods, guardMethod, isObj, onAllMethods, requestAnimationFrame, setInterval, setTimeout } from 'sia-reactor/utils';
+export { KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, isObj, keyEventAllowed, keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent } from 'sia-reactor/utils';
 
 interface ScrolleratorOptions {
     baseSpeed?: number;
@@ -84,8 +84,6 @@ declare const breath: (w?: Window & typeof globalThis) => Promise<unknown>;
 declare const deepBreath: (w?: Window & typeof globalThis) => Promise<unknown>;
 declare function bindCleanupToSignal<Cb extends () => any>(cleanup: Cb, signal?: AbortSignal): Cb;
 
-type Dataset = Record<string, string | number>;
-type Style = Partial<CSSStyleDeclaration>;
 type ResourceType = "style" | "script" | string;
 type LoadResourceOptions = Partial<{
     module: boolean;
@@ -98,11 +96,8 @@ type LoadResourceOptions = Partial<{
     attempts: number;
     retryKey: boolean | string;
 }>;
-declare function createEl<K extends keyof HTMLElementTagNameMap>(tag: K, props?: Partial<HTMLElementTagNameMap[K]>, dataset?: Dataset, styles?: Style): HTMLElementTagNameMap[K];
-declare function createEl(tag: string, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): HTMLElement | null;
-declare function assignEl<K extends keyof HTMLElementTagNameMap>(el?: HTMLElementTagNameMap[K], props?: Partial<HTMLElementTagNameMap[K]>, dataset?: Dataset, styles?: Style): void;
-declare function assignEl(el?: HTMLElement | null, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): void;
+
 declare const VIRTUAL_RESOURCE: unique symbol;
 declare function loadResource(req: string | symbol, type?: ResourceType, { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts, retryKey }?: LoadResourceOptions, w?: Window & typeof globalThis): Promise<HTMLElement | void>;
 
-export { type Dataset, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, type Style, VIRTUAL_RESOURCE, assignEl, bindCleanupToSignal, breath, createEl, deepBreath, inBoolArrOpt, initScrollAssist, initVScrollerator, isArr, isBool, isDef, isFunc, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, removeScrollAssist, uid };
+export { type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, inBoolArrOpt, initScrollAssist, initVScrollerator, isArr, isBool, isDef, isFunc, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, removeScrollAssist, uid };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { bindAllMethods, clamp, guardAllMethods, guardMethod, isObj, onAllMethods, requestAnimationFrame, setInterval, setTimeout } from 'sia-reactor/utils';
+export { KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, isObj, keyEventAllowed, keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent } from 'sia-reactor/utils';
 
 interface ScrolleratorOptions {
     baseSpeed?: number;
@@ -84,8 +84,6 @@ declare const breath: (w?: Window & typeof globalThis) => Promise<unknown>;
 declare const deepBreath: (w?: Window & typeof globalThis) => Promise<unknown>;
 declare function bindCleanupToSignal<Cb extends () => any>(cleanup: Cb, signal?: AbortSignal): Cb;
 
-type Dataset = Record<string, string | number>;
-type Style = Partial<CSSStyleDeclaration>;
 type ResourceType = "style" | "script" | string;
 type LoadResourceOptions = Partial<{
     module: boolean;
@@ -98,11 +96,8 @@ type LoadResourceOptions = Partial<{
     attempts: number;
     retryKey: boolean | string;
 }>;
-declare function createEl<K extends keyof HTMLElementTagNameMap>(tag: K, props?: Partial<HTMLElementTagNameMap[K]>, dataset?: Dataset, styles?: Style): HTMLElementTagNameMap[K];
-declare function createEl(tag: string, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): HTMLElement | null;
-declare function assignEl<K extends keyof HTMLElementTagNameMap>(el?: HTMLElementTagNameMap[K], props?: Partial<HTMLElementTagNameMap[K]>, dataset?: Dataset, styles?: Style): void;
-declare function assignEl(el?: HTMLElement | null, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): void;
+
 declare const VIRTUAL_RESOURCE: unique symbol;
 declare function loadResource(req: string | symbol, type?: ResourceType, { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts, retryKey }?: LoadResourceOptions, w?: Window & typeof globalThis): Promise<HTMLElement | void>;
 
-export { type Dataset, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, type Style, VIRTUAL_RESOURCE, assignEl, bindCleanupToSignal, breath, createEl, deepBreath, inBoolArrOpt, initScrollAssist, initVScrollerator, isArr, isBool, isDef, isFunc, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, removeScrollAssist, uid };
+export { type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, inBoolArrOpt, initScrollAssist, initVScrollerator, isArr, isBool, isDef, isFunc, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, removeScrollAssist, uid };

package/dist/index.js

@@ -1,19 +1,5 @@
 // src/core/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];
-  }
-}
+import { createEl, assignEl } from "sia-reactor/utils";
 var VIRTUAL_RESOURCE = /* @__PURE__ */ Symbol.for("T007_VIRTUAL_RESOURCE");
 function loadResource(req, type = "style", { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, w = window) {
   w.t007 ??= {}, w.t007._resourceCache ??= {};
@@ -117,7 +103,10 @@ function bindCleanupToSignal(cleanup, signal) {
   return cleanup;
 }
 
-// src/core/methd.ts
+// src/core/keys.ts
+import { parseKeyCombo, stringifyKeyEvent, cleanKeyCombo, matchKeys, getTermsForKey, keyEventAllowed, formatKeyForDisplay, formatKeyShortcutsForDisplay, parseForARIAKS } from "sia-reactor/utils";
+
+// src/mixins/methd.ts
 import { onAllMethods, bindAllMethods, guardAllMethods, guardMethod } from "sia-reactor/utils";
 
 // src/quirks/scroll.ts
@@ -226,8 +215,12 @@ export {
   bindCleanupToSignal,
   breath,
   clamp,
+  cleanKeyCombo,
   createEl,
   deepBreath,
+  formatKeyForDisplay,
+  formatKeyShortcutsForDisplay,
+  getTermsForKey,
   guardAllMethods,
   guardMethod,
   inBoolArrOpt,
@@ -244,13 +237,18 @@ export {
   isSameURL,
   isStr,
   isSym,
+  keyEventAllowed,
   limited,
   loadResource,
+  matchKeys,
   mockAsync,
   onAllMethods,
+  parseForARIAKS,
+  parseKeyCombo,
   removeScrollAssist,
   requestAnimationFrame2 as requestAnimationFrame,
   setInterval,
   setTimeout2 as setTimeout,
+  stringifyKeyEvent,
   uid
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t007/utils",
-  "version": "0.0.16",
+  "version": "0.0.21",
   "description": "High-performance, zero-dependency utility functions for the t007 ecosystem.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",
@@ -45,6 +45,6 @@
     "performance"
   ],
   "dependencies": {
-    "sia-reactor": "^0.0.16"
+    "sia-reactor": "^0.0.20"
   }
 }