@t007/utils 0.0.7 → 0.0.9

package/README.md

@@ -20,6 +20,7 @@
   - [Usage](#usage)
   - [Author](#author)
   - [Acknowledgments](#acknowledgments)
+  - [Star History](#star-history)
 
 ---
 
@@ -97,4 +98,10 @@ await loadResource('https://cdn.example.com/styles.css, 'link');
 
 ## Acknowledgments
 
-The invisible backbone of the `@t007` ecosystem. Engineered to make complex DOM operations feel effortless.
+The invisible backbone of the `@t007` ecosystem. Engineered to make complex DOM operations feel effortless.
+
+## Star History
+
+If you find this project useful, please consider giving it a star! ⭐
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Tobi007-del/t007-tools&type=Date)](https://github.com/Tobi007-del/t007-tools)

package/dist/index.cjs

@@ -27,9 +27,19 @@ __export(index_exports, {
   createEl: () => createEl,
   guardAllMethods: () => guardAllMethods,
   guardMethod: () => guardMethod,
+  inBoolArrOpt: () => inBoolArrOpt,
   initScrollAssist: () => initScrollAssist,
   initVScrollerator: () => initVScrollerator,
+  isArr: () => isArr,
+  isDef: () => import_utils.isDef,
+  isFunc: () => isFunc,
+  isIter: () => isIter,
+  isNum: () => isNum,
+  isObj: () => import_utils2.isObj,
   isSameURL: () => isSameURL,
+  isStr: () => isStr,
+  isStrictObj: () => import_utils2.isStrictObj,
+  isSym: () => isSym,
   loadResource: () => loadResource,
   onAllMethods: () => onAllMethods,
   removeScrollAssist: () => removeScrollAssist,
@@ -37,12 +47,37 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/core/obj.ts
+var import_utils = require("sia-reactor/utils");
+var import_utils2 = require("sia-reactor/utils");
+function isSym(val) {
+  return "symbol" === typeof val;
+}
+function isNum(val) {
+  return "number" === typeof val;
+}
+function isStr(val) {
+  return "string" === typeof val;
+}
+function isArr(obj) {
+  return Array.isArray(obj);
+}
+function isIter(obj) {
+  return obj != null && "function" === typeof obj[Symbol.iterator];
+}
+function isFunc(val) {
+  return "function" === typeof val;
+}
+function inBoolArrOpt(opt, str) {
+  return opt?.includes?.(str) ?? opt;
+}
+
 // src/core/str.ts
 function uid(prefix = "") {
   return prefix + Date.now().toString(36) + "_" + performance.now().toString(36).replace(".", "") + "_" + Math.random().toString(36).slice(2);
 }
 function isSameURL(src1, src2) {
-  if (typeof src1 !== "string" || typeof src2 !== "string" || !src1 || !src2) return false;
+  if (!isStr(src1) || !isStr(src2) || !src1 || !src2) return false;
   try {
     const u1 = new URL(src1, window.location.href), u2 = new URL(src2, window.location.href);
     return decodeURIComponent(u1.origin + u1.pathname) === decodeURIComponent(u2.origin + u2.pathname);
@@ -70,7 +105,7 @@ function assignEl(el, props, dataset, styles) {
 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 ??= {};
-  if (req === VIRTUAL_RESOURCE || "symbol" === typeof req) return Promise.resolve();
+  if (req === VIRTUAL_RESOURCE || isSym(req)) return Promise.resolve();
   const src = req;
   if (w.t007._resourceCache[src]) return w.t007._resourceCache[src];
   const existing = type === "script" ? Array.prototype.find.call(w.document.scripts, (s) => isSameURL(s.src, src)) : type === "style" ? Array.prototype.find.call(w.document.styleSheets, (s) => isSameURL(s.href, src)) : null;
@@ -107,7 +142,7 @@ function onAllMethods(owner, callback) {
   while (proto && proto !== Object.prototype) {
     for (const method of Object.getOwnPropertyNames(proto)) {
       if (method === "constructor") continue;
-      if ("function" !== typeof Object.getOwnPropertyDescriptor(proto, method)?.value) continue;
+      if (isFunc(Object.getOwnPropertyDescriptor(proto, method)?.value)) continue;
       callback(method, owner);
     }
     proto = Object.getPrototypeOf(proto);
@@ -223,7 +258,7 @@ function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "tmg-video-c
 var removeScrollAssist = (el) => t007._scrollers.get(el)?.destroy();
 
 // src/index.ts
-if (typeof window !== "undefined") {
+if ((0, import_utils.isDef)(window)) {
   window.t007 ??= {};
   t007.VIRTUAL_RESOURCE = VIRTUAL_RESOURCE;
   window.T007_TOAST_JS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/toast@latest`;
@@ -242,9 +277,19 @@ if (typeof window !== "undefined") {
   createEl,
   guardAllMethods,
   guardMethod,
+  inBoolArrOpt,
   initScrollAssist,
   initVScrollerator,
+  isArr,
+  isDef,
+  isFunc,
+  isIter,
+  isNum,
+  isObj,
   isSameURL,
+  isStr,
+  isStrictObj,
+  isSym,
   loadResource,
   onAllMethods,
   removeScrollAssist,

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+export { isDef, isObj, isStrictObj } from 'sia-reactor/utils';
+
 interface ScrolleratorOptions {
     baseSpeed?: number;
     maxSpeed?: number;
@@ -50,6 +52,15 @@ declare global {
   var t007: T007Namespace;
 }
 
+declare function isSym<T = symbol>(val: any): val is T;
+declare function isNum<T = number>(val: any): val is T;
+declare function isStr<T = string>(val: any): val is T;
+declare function isArr<T = unknown>(obj: any): obj is T[];
+
+declare function isIter<T = unknown>(obj: any): obj is Iterable<T>;
+declare function isFunc<T = Function>(val: any): val is T;
+declare function inBoolArrOpt(opt: any, str: string): boolean;
+
 declare function clamp(min: number | undefined, val: number, max?: number): number;
 
 declare function uid(prefix?: string): string;
@@ -81,4 +92,4 @@ declare function bindAllMethods(owner: any): void;
 declare function guardAllMethods(owner: any, guardFn?: (fn: Function) => Function, bound?: boolean): void;
 declare function guardMethod<T extends Function>(fn: T, onError?: (e: any) => void): T;
 
-export { type Dataset, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, type Style, VIRTUAL_RESOURCE, assignEl, bindAllMethods, clamp, createEl, guardAllMethods, guardMethod, initScrollAssist, initVScrollerator, isSameURL, loadResource, onAllMethods, removeScrollAssist, uid };
+export { type Dataset, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, type Style, VIRTUAL_RESOURCE, assignEl, bindAllMethods, clamp, createEl, guardAllMethods, guardMethod, inBoolArrOpt, initScrollAssist, initVScrollerator, isArr, isFunc, isIter, isNum, isSameURL, isStr, isSym, loadResource, onAllMethods, removeScrollAssist, uid };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { isDef, isObj, isStrictObj } from 'sia-reactor/utils';
+
 interface ScrolleratorOptions {
     baseSpeed?: number;
     maxSpeed?: number;
@@ -50,6 +52,15 @@ declare global {
   var t007: T007Namespace;
 }
 
+declare function isSym<T = symbol>(val: any): val is T;
+declare function isNum<T = number>(val: any): val is T;
+declare function isStr<T = string>(val: any): val is T;
+declare function isArr<T = unknown>(obj: any): obj is T[];
+
+declare function isIter<T = unknown>(obj: any): obj is Iterable<T>;
+declare function isFunc<T = Function>(val: any): val is T;
+declare function inBoolArrOpt(opt: any, str: string): boolean;
+
 declare function clamp(min: number | undefined, val: number, max?: number): number;
 
 declare function uid(prefix?: string): string;
@@ -81,4 +92,4 @@ declare function bindAllMethods(owner: any): void;
 declare function guardAllMethods(owner: any, guardFn?: (fn: Function) => Function, bound?: boolean): void;
 declare function guardMethod<T extends Function>(fn: T, onError?: (e: any) => void): T;
 
-export { type Dataset, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, type Style, VIRTUAL_RESOURCE, assignEl, bindAllMethods, clamp, createEl, guardAllMethods, guardMethod, initScrollAssist, initVScrollerator, isSameURL, loadResource, onAllMethods, removeScrollAssist, uid };
+export { type Dataset, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, type Style, VIRTUAL_RESOURCE, assignEl, bindAllMethods, clamp, createEl, guardAllMethods, guardMethod, inBoolArrOpt, initScrollAssist, initVScrollerator, isArr, isFunc, isIter, isNum, isSameURL, isStr, isSym, loadResource, onAllMethods, removeScrollAssist, uid };

package/dist/index.js

@@ -1,9 +1,34 @@
+// src/core/obj.ts
+import { isDef } from "sia-reactor/utils";
+import { isObj, isStrictObj } from "sia-reactor/utils";
+function isSym(val) {
+  return "symbol" === typeof val;
+}
+function isNum(val) {
+  return "number" === typeof val;
+}
+function isStr(val) {
+  return "string" === typeof val;
+}
+function isArr(obj) {
+  return Array.isArray(obj);
+}
+function isIter(obj) {
+  return obj != null && "function" === typeof obj[Symbol.iterator];
+}
+function isFunc(val) {
+  return "function" === typeof val;
+}
+function inBoolArrOpt(opt, str) {
+  return opt?.includes?.(str) ?? opt;
+}
+
 // src/core/str.ts
 function uid(prefix = "") {
   return prefix + Date.now().toString(36) + "_" + performance.now().toString(36).replace(".", "") + "_" + Math.random().toString(36).slice(2);
 }
 function isSameURL(src1, src2) {
-  if (typeof src1 !== "string" || typeof src2 !== "string" || !src1 || !src2) return false;
+  if (!isStr(src1) || !isStr(src2) || !src1 || !src2) return false;
   try {
     const u1 = new URL(src1, window.location.href), u2 = new URL(src2, window.location.href);
     return decodeURIComponent(u1.origin + u1.pathname) === decodeURIComponent(u2.origin + u2.pathname);
@@ -31,7 +56,7 @@ function assignEl(el, props, dataset, styles) {
 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 ??= {};
-  if (req === VIRTUAL_RESOURCE || "symbol" === typeof req) return Promise.resolve();
+  if (req === VIRTUAL_RESOURCE || isSym(req)) return Promise.resolve();
   const src = req;
   if (w.t007._resourceCache[src]) return w.t007._resourceCache[src];
   const existing = type === "script" ? Array.prototype.find.call(w.document.scripts, (s) => isSameURL(s.src, src)) : type === "style" ? Array.prototype.find.call(w.document.styleSheets, (s) => isSameURL(s.href, src)) : null;
@@ -68,7 +93,7 @@ function onAllMethods(owner, callback) {
   while (proto && proto !== Object.prototype) {
     for (const method of Object.getOwnPropertyNames(proto)) {
       if (method === "constructor") continue;
-      if ("function" !== typeof Object.getOwnPropertyDescriptor(proto, method)?.value) continue;
+      if (isFunc(Object.getOwnPropertyDescriptor(proto, method)?.value)) continue;
       callback(method, owner);
     }
     proto = Object.getPrototypeOf(proto);
@@ -184,7 +209,7 @@ function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "tmg-video-c
 var removeScrollAssist = (el) => t007._scrollers.get(el)?.destroy();
 
 // src/index.ts
-if (typeof window !== "undefined") {
+if (isDef(window)) {
   window.t007 ??= {};
   t007.VIRTUAL_RESOURCE = VIRTUAL_RESOURCE;
   window.T007_TOAST_JS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/toast@latest`;
@@ -202,9 +227,19 @@ export {
   createEl,
   guardAllMethods,
   guardMethod,
+  inBoolArrOpt,
   initScrollAssist,
   initVScrollerator,
+  isArr,
+  isDef,
+  isFunc,
+  isIter,
+  isNum,
+  isObj,
   isSameURL,
+  isStr,
+  isStrictObj,
+  isSym,
   loadResource,
   onAllMethods,
   removeScrollAssist,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t007/utils",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "High-performance, zero-dependency utility functions for the t007 ecosystem.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",
@@ -43,5 +43,8 @@
     "dom-manipulation",
     "shared-logic",
     "performance"
-  ]
+  ],
+  "dependencies": {
+    "sia-reactor": "^0.0.10"
+  }
 }