@t007/utils 0.0.1

package/dist/index.cjs

@@ -0,0 +1,230 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  assignEl: () => assignEl,
+  bindAllMethods: () => bindAllMethods,
+  clamp: () => clamp,
+  createEl: () => createEl,
+  guardAllMethods: () => guardAllMethods,
+  guardMethod: () => guardMethod,
+  initScrollAssist: () => initScrollAssist,
+  initVScrollerator: () => initVScrollerator,
+  isSameURL: () => isSameURL,
+  loadResource: () => loadResource,
+  onAllMethods: () => onAllMethods,
+  removeScrollAssist: () => removeScrollAssist,
+  uid: () => uid
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/num.ts
+function clamp(min = 0, val, max = Infinity) {
+  return Math.min(Math.max(val, min), max);
+}
+
+// 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;
+  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);
+  } catch {
+    return src1.replace(/\\/g, "/").split("?")[0].trim() === src2.replace(/\\/g, "/").split("?")[0].trim();
+  }
+}
+
+// src/core/dom.ts
+function createEl(tag, props = {}, dataset = {}, styles = {}) {
+  return assignEl(tag ? document?.createElement(tag) : void 0, props, dataset, styles) ?? null;
+}
+function assignEl(el, props = {}, dataset = {}, styles = {}) {
+  if (!el) return;
+  for (const k of Object.keys(props)) if (props[k] !== void 0) el[k] = props[k];
+  for (const k of Object.keys(dataset)) if (dataset[k] !== void 0) el.dataset[k] = String(dataset[k]);
+  for (const k of Object.keys(styles)) if (styles[k] !== void 0) el.style[k] = styles[k];
+}
+function loadResource(src, type = "style", { module: module2, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, w = window) {
+  w.t007 ??= {}, w.t007._resourceCache ??= {};
+  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;
+  if (existing) return w.t007._resourceCache[src] = Promise.resolve(existing);
+  w.t007._resourceCache[src] = new Promise((resolve, reject) => {
+    (function tryLoad(remaining, el) {
+      const onerror = () => {
+        el?.remove?.();
+        if (remaining > 1) {
+          setTimeout(tryLoad, 1e3, remaining - 1);
+          console.warn(`Retrying ${type} load (${attempts - remaining + 1}): ${src}...`);
+        } else {
+          delete w.t007._resourceCache[src];
+          reject(new Error(`${type} load failed after ${attempts} attempts: ${src}`));
+        }
+      };
+      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 }) || "");
+      else reject(new Error(`Unsupported resource type: ${type}`));
+    })(attempts);
+  });
+  return w.t007._resourceCache[src];
+}
+
+// src/mixins/methodist.ts
+function onAllMethods(owner, callback) {
+  let proto = owner;
+  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;
+      callback(method, owner);
+    }
+    proto = Object.getPrototypeOf(proto);
+  }
+}
+function bindAllMethods(owner) {
+  onAllMethods(owner, (method, owner2) => {
+    owner2[method] = owner2[method].bind(owner2);
+  });
+}
+function guardAllMethods(owner, guardFn = guardMethod, bound = true) {
+  onAllMethods(owner, (method, owner2) => {
+    owner2[method] = guardFn(bound ? owner2[method].bind(owner2) : owner2[method]);
+  });
+}
+function guardMethod(fn, onError = (e) => console.error(e)) {
+  return ((...args) => {
+    try {
+      const result = fn(...args);
+      return result instanceof Promise ? result.catch((e) => onError(e)) : result;
+    } catch (e) {
+      onError(e);
+    }
+  });
+}
+
+// src/quirks/scroll.ts
+function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, baseRate = 16, lineHeight = 80, margin = 80, car = window } = {}) {
+  let linesPerSec = baseSpeed, accelId = null, lastTime = null;
+  const drive = (clientY, brake = false, offsetY = 0) => {
+    if (car !== window) clientY -= offsetY;
+    const now = performance.now(), speed = linesPerSec * lineHeight * ((lastTime ? now - lastTime : baseRate) / 1e3);
+    if (!brake && (clientY < margin || clientY > (car.innerHeight ?? car.offsetHeight) - margin)) {
+      accelId === null ? accelId = setTimeout(() => linesPerSec += 1, stepDelay) : linesPerSec > baseSpeed && (linesPerSec = Math.min(linesPerSec + 1, maxSpeed));
+      car.scrollBy?.(0, clientY < margin ? -speed : speed);
+    } else reset();
+    return lastTime = !brake ? now : null, speed;
+  };
+  const reset = () => (accelId && clearTimeout(accelId), accelId = null, linesPerSec = baseSpeed, lastTime = null);
+  return { drive, reset };
+}
+var _SCROLLERS = /* @__PURE__ */ new WeakMap();
+var _SCROLLER_R_OBSERVER = typeof window !== "undefined" ? new ResizeObserver((entries) => entries.forEach(({ target }) => _SCROLLERS.get(target)?.update())) : null;
+var _SCROLLER_M_OBSERVER = typeof window !== "undefined" ? new MutationObserver((entries) => {
+  const els = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    let node = entry.target instanceof Element ? entry.target : null;
+    while (node && !_SCROLLERS.has(node)) node = node.parentElement;
+    if (node) els.add(node);
+  }
+  for (const el of els) _SCROLLERS.get(el)?.update();
+}) : null;
+function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "tmg-video-controls-scroll-assist", vertical = true, horizontal = true } = {}) {
+  const parent = el?.parentElement;
+  if (!parent || _SCROLLERS.has(el)) return;
+  const assist = {};
+  let scrollId = null, last = performance.now(), assistWidth = 20, assistHeight = 20;
+  const update = () => {
+    const hasInteractive = !!parent.querySelector('button, a[href], input, select, textarea, [contenteditable="true"], [tabindex]:not([tabindex="-1"])');
+    if (horizontal) {
+      const w = assist.left?.offsetWidth || assistWidth, check = hasInteractive ? el.clientWidth < w * 2 : false;
+      assist.left.style.display = check ? "none" : el.scrollLeft > 0 ? "block" : "none";
+      assist.right.style.display = check ? "none" : el.scrollLeft + el.clientWidth < el.scrollWidth - 1 ? "block" : "none";
+      assistWidth = w;
+    }
+    if (vertical) {
+      const h = assist.up?.offsetHeight || assistHeight, check = hasInteractive ? el.clientHeight < h * 2 : false;
+      assist.up.style.display = check ? "none" : el.scrollTop > 0 ? "block" : "none";
+      assist.down.style.display = check ? "none" : el.scrollTop + el.clientHeight < el.scrollHeight - 1 ? "block" : "none";
+      assistHeight = h;
+    }
+  };
+  const scroll = (dir) => {
+    const frame = () => {
+      const now = performance.now(), dt = now - last;
+      last = now;
+      const d = pxPerSecond * dt / 1e3;
+      if (dir === "left") el.scrollLeft = Math.max(0, el.scrollLeft - d);
+      if (dir === "right") el.scrollLeft = Math.min(el.scrollWidth - el.clientWidth, el.scrollLeft + d);
+      if (dir === "up") el.scrollTop = Math.max(0, el.scrollTop - d);
+      if (dir === "down") el.scrollTop = Math.min(el.scrollHeight - el.clientHeight, el.scrollTop + d);
+      scrollId = requestAnimationFrame(frame);
+    };
+    last = performance.now();
+    frame();
+  };
+  const stop = () => (cancelAnimationFrame(scrollId ?? 0), scrollId = null);
+  const addAssist = (dir) => {
+    const div = 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));
+    dir === "left" || dir === "up" ? parent.insertBefore(div, el) : parent.append(div);
+    assist[dir] = div;
+  };
+  if (horizontal) ["left", "right"].forEach(addAssist);
+  if (vertical) ["up", "down"].forEach(addAssist);
+  el.addEventListener("scroll", update);
+  _SCROLLER_R_OBSERVER.observe(el);
+  _SCROLLER_M_OBSERVER.observe(el, { childList: true, subtree: true, characterData: true });
+  _SCROLLERS.set(el, {
+    update,
+    destroy() {
+      stop();
+      el.removeEventListener("scroll", update);
+      _SCROLLER_R_OBSERVER.unobserve(el);
+      _SCROLLERS.delete(el);
+      Object.values(assist).forEach((a) => a.remove());
+    }
+  });
+  update();
+  return _SCROLLERS.get(el);
+}
+var removeScrollAssist = (el) => _SCROLLERS.get(el)?.destroy();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assignEl,
+  bindAllMethods,
+  clamp,
+  createEl,
+  guardAllMethods,
+  guardMethod,
+  initScrollAssist,
+  initVScrollerator,
+  isSameURL,
+  loadResource,
+  onAllMethods,
+  removeScrollAssist,
+  uid
+});

package/dist/index.d.cts

@@ -0,0 +1,68 @@
+declare global {
+    interface T007Namespace {
+        _resourceCache: Partial<Record<string, Promise<HTMLElement | void>>>;
+    }
+    interface Window {
+        t007: T007Namespace;
+    }
+    var t007: T007Namespace;
+}
+
+declare function clamp(min: number | undefined, val: number, max?: number): number;
+
+declare function uid(prefix?: string): string;
+declare function isSameURL(src1: unknown, src2: unknown): boolean;
+
+type Dataset = Record<string, string | number>;
+type Style = Partial<CSSStyleDeclaration>;
+type ResourceType = "style" | "script" | string;
+type LoadResourceOptions = Partial<{
+    module: boolean;
+    media: string;
+    crossOrigin: "anonymous" | "use-credentials" | string | null;
+    integrity: string;
+    referrerPolicy: "no-referrer" | "origin" | "strict-origin-when-cross-origin" | string;
+    nonce: string;
+    fetchPriority: "high" | "low" | "auto";
+    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, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): void;
+declare function loadResource(src: string, type?: ResourceType, { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts, retryKey }?: LoadResourceOptions, w?: Window & typeof globalThis): Promise<HTMLElement | void>;
+
+declare function onAllMethods(owner: any, callback: (method: string, owner: any) => void): void;
+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;
+
+interface ScrolleratorOptions {
+    baseSpeed?: number;
+    maxSpeed?: number;
+    stepDelay?: number;
+    baseRate?: number;
+    lineHeight?: number;
+    margin?: number;
+    car?: Window | HTMLElement;
+}
+interface Scrollerator {
+    drive: (clientY: number, brake?: boolean, offsetY?: number) => number;
+    reset: () => void;
+}
+declare function initVScrollerator({ baseSpeed, maxSpeed, stepDelay, baseRate, lineHeight, margin, car }?: ScrolleratorOptions): Scrollerator;
+interface ScrollAssistControl {
+    update: () => void;
+    destroy: () => void;
+}
+interface ScrollAssistOptions {
+    pxPerSecond?: number;
+    assistClassName?: string;
+    vertical?: boolean;
+    horizontal?: boolean;
+}
+declare function initScrollAssist(el: HTMLElement, { pxPerSecond, assistClassName, vertical, horizontal }?: ScrollAssistOptions): ScrollAssistControl | void;
+declare const removeScrollAssist: (el: HTMLElement) => void | undefined;
+
+export { type Dataset, type LoadResourceOptions, type ResourceType, type Style, assignEl, bindAllMethods, clamp, createEl, guardAllMethods, guardMethod, initScrollAssist, initVScrollerator, isSameURL, loadResource, onAllMethods, removeScrollAssist, uid };

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+declare global {
+    interface T007Namespace {
+        _resourceCache: Partial<Record<string, Promise<HTMLElement | void>>>;
+    }
+    interface Window {
+        t007: T007Namespace;
+    }
+    var t007: T007Namespace;
+}
+
+declare function clamp(min: number | undefined, val: number, max?: number): number;
+
+declare function uid(prefix?: string): string;
+declare function isSameURL(src1: unknown, src2: unknown): boolean;
+
+type Dataset = Record<string, string | number>;
+type Style = Partial<CSSStyleDeclaration>;
+type ResourceType = "style" | "script" | string;
+type LoadResourceOptions = Partial<{
+    module: boolean;
+    media: string;
+    crossOrigin: "anonymous" | "use-credentials" | string | null;
+    integrity: string;
+    referrerPolicy: "no-referrer" | "origin" | "strict-origin-when-cross-origin" | string;
+    nonce: string;
+    fetchPriority: "high" | "low" | "auto";
+    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, props?: Partial<HTMLElement>, dataset?: Dataset, styles?: Style): void;
+declare function loadResource(src: string, type?: ResourceType, { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts, retryKey }?: LoadResourceOptions, w?: Window & typeof globalThis): Promise<HTMLElement | void>;
+
+declare function onAllMethods(owner: any, callback: (method: string, owner: any) => void): void;
+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;
+
+interface ScrolleratorOptions {
+    baseSpeed?: number;
+    maxSpeed?: number;
+    stepDelay?: number;
+    baseRate?: number;
+    lineHeight?: number;
+    margin?: number;
+    car?: Window | HTMLElement;
+}
+interface Scrollerator {
+    drive: (clientY: number, brake?: boolean, offsetY?: number) => number;
+    reset: () => void;
+}
+declare function initVScrollerator({ baseSpeed, maxSpeed, stepDelay, baseRate, lineHeight, margin, car }?: ScrolleratorOptions): Scrollerator;
+interface ScrollAssistControl {
+    update: () => void;
+    destroy: () => void;
+}
+interface ScrollAssistOptions {
+    pxPerSecond?: number;
+    assistClassName?: string;
+    vertical?: boolean;
+    horizontal?: boolean;
+}
+declare function initScrollAssist(el: HTMLElement, { pxPerSecond, assistClassName, vertical, horizontal }?: ScrollAssistOptions): ScrollAssistControl | void;
+declare const removeScrollAssist: (el: HTMLElement) => void | undefined;
+
+export { type Dataset, type LoadResourceOptions, type ResourceType, type Style, assignEl, bindAllMethods, clamp, createEl, guardAllMethods, guardMethod, initScrollAssist, initVScrollerator, isSameURL, loadResource, onAllMethods, removeScrollAssist, uid };

package/dist/index.js

@@ -0,0 +1,191 @@
+// src/core/num.ts
+function clamp(min = 0, val, max = Infinity) {
+  return Math.min(Math.max(val, min), max);
+}
+
+// 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;
+  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);
+  } catch {
+    return src1.replace(/\\/g, "/").split("?")[0].trim() === src2.replace(/\\/g, "/").split("?")[0].trim();
+  }
+}
+
+// src/core/dom.ts
+function createEl(tag, props = {}, dataset = {}, styles = {}) {
+  return assignEl(tag ? document?.createElement(tag) : void 0, props, dataset, styles) ?? null;
+}
+function assignEl(el, props = {}, dataset = {}, styles = {}) {
+  if (!el) return;
+  for (const k of Object.keys(props)) if (props[k] !== void 0) el[k] = props[k];
+  for (const k of Object.keys(dataset)) if (dataset[k] !== void 0) el.dataset[k] = String(dataset[k]);
+  for (const k of Object.keys(styles)) if (styles[k] !== void 0) el.style[k] = styles[k];
+}
+function loadResource(src, type = "style", { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, w = window) {
+  w.t007 ??= {}, w.t007._resourceCache ??= {};
+  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;
+  if (existing) return w.t007._resourceCache[src] = Promise.resolve(existing);
+  w.t007._resourceCache[src] = new Promise((resolve, reject) => {
+    (function tryLoad(remaining, el) {
+      const onerror = () => {
+        el?.remove?.();
+        if (remaining > 1) {
+          setTimeout(tryLoad, 1e3, remaining - 1);
+          console.warn(`Retrying ${type} load (${attempts - remaining + 1}): ${src}...`);
+        } else {
+          delete w.t007._resourceCache[src];
+          reject(new Error(`${type} load failed after ${attempts} attempts: ${src}`));
+        }
+      };
+      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: module ? "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 }) || "");
+      else reject(new Error(`Unsupported resource type: ${type}`));
+    })(attempts);
+  });
+  return w.t007._resourceCache[src];
+}
+
+// src/mixins/methodist.ts
+function onAllMethods(owner, callback) {
+  let proto = owner;
+  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;
+      callback(method, owner);
+    }
+    proto = Object.getPrototypeOf(proto);
+  }
+}
+function bindAllMethods(owner) {
+  onAllMethods(owner, (method, owner2) => {
+    owner2[method] = owner2[method].bind(owner2);
+  });
+}
+function guardAllMethods(owner, guardFn = guardMethod, bound = true) {
+  onAllMethods(owner, (method, owner2) => {
+    owner2[method] = guardFn(bound ? owner2[method].bind(owner2) : owner2[method]);
+  });
+}
+function guardMethod(fn, onError = (e) => console.error(e)) {
+  return ((...args) => {
+    try {
+      const result = fn(...args);
+      return result instanceof Promise ? result.catch((e) => onError(e)) : result;
+    } catch (e) {
+      onError(e);
+    }
+  });
+}
+
+// src/quirks/scroll.ts
+function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, baseRate = 16, lineHeight = 80, margin = 80, car = window } = {}) {
+  let linesPerSec = baseSpeed, accelId = null, lastTime = null;
+  const drive = (clientY, brake = false, offsetY = 0) => {
+    if (car !== window) clientY -= offsetY;
+    const now = performance.now(), speed = linesPerSec * lineHeight * ((lastTime ? now - lastTime : baseRate) / 1e3);
+    if (!brake && (clientY < margin || clientY > (car.innerHeight ?? car.offsetHeight) - margin)) {
+      accelId === null ? accelId = setTimeout(() => linesPerSec += 1, stepDelay) : linesPerSec > baseSpeed && (linesPerSec = Math.min(linesPerSec + 1, maxSpeed));
+      car.scrollBy?.(0, clientY < margin ? -speed : speed);
+    } else reset();
+    return lastTime = !brake ? now : null, speed;
+  };
+  const reset = () => (accelId && clearTimeout(accelId), accelId = null, linesPerSec = baseSpeed, lastTime = null);
+  return { drive, reset };
+}
+var _SCROLLERS = /* @__PURE__ */ new WeakMap();
+var _SCROLLER_R_OBSERVER = typeof window !== "undefined" ? new ResizeObserver((entries) => entries.forEach(({ target }) => _SCROLLERS.get(target)?.update())) : null;
+var _SCROLLER_M_OBSERVER = typeof window !== "undefined" ? new MutationObserver((entries) => {
+  const els = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    let node = entry.target instanceof Element ? entry.target : null;
+    while (node && !_SCROLLERS.has(node)) node = node.parentElement;
+    if (node) els.add(node);
+  }
+  for (const el of els) _SCROLLERS.get(el)?.update();
+}) : null;
+function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "tmg-video-controls-scroll-assist", vertical = true, horizontal = true } = {}) {
+  const parent = el?.parentElement;
+  if (!parent || _SCROLLERS.has(el)) return;
+  const assist = {};
+  let scrollId = null, last = performance.now(), assistWidth = 20, assistHeight = 20;
+  const update = () => {
+    const hasInteractive = !!parent.querySelector('button, a[href], input, select, textarea, [contenteditable="true"], [tabindex]:not([tabindex="-1"])');
+    if (horizontal) {
+      const w = assist.left?.offsetWidth || assistWidth, check = hasInteractive ? el.clientWidth < w * 2 : false;
+      assist.left.style.display = check ? "none" : el.scrollLeft > 0 ? "block" : "none";
+      assist.right.style.display = check ? "none" : el.scrollLeft + el.clientWidth < el.scrollWidth - 1 ? "block" : "none";
+      assistWidth = w;
+    }
+    if (vertical) {
+      const h = assist.up?.offsetHeight || assistHeight, check = hasInteractive ? el.clientHeight < h * 2 : false;
+      assist.up.style.display = check ? "none" : el.scrollTop > 0 ? "block" : "none";
+      assist.down.style.display = check ? "none" : el.scrollTop + el.clientHeight < el.scrollHeight - 1 ? "block" : "none";
+      assistHeight = h;
+    }
+  };
+  const scroll = (dir) => {
+    const frame = () => {
+      const now = performance.now(), dt = now - last;
+      last = now;
+      const d = pxPerSecond * dt / 1e3;
+      if (dir === "left") el.scrollLeft = Math.max(0, el.scrollLeft - d);
+      if (dir === "right") el.scrollLeft = Math.min(el.scrollWidth - el.clientWidth, el.scrollLeft + d);
+      if (dir === "up") el.scrollTop = Math.max(0, el.scrollTop - d);
+      if (dir === "down") el.scrollTop = Math.min(el.scrollHeight - el.clientHeight, el.scrollTop + d);
+      scrollId = requestAnimationFrame(frame);
+    };
+    last = performance.now();
+    frame();
+  };
+  const stop = () => (cancelAnimationFrame(scrollId ?? 0), scrollId = null);
+  const addAssist = (dir) => {
+    const div = 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));
+    dir === "left" || dir === "up" ? parent.insertBefore(div, el) : parent.append(div);
+    assist[dir] = div;
+  };
+  if (horizontal) ["left", "right"].forEach(addAssist);
+  if (vertical) ["up", "down"].forEach(addAssist);
+  el.addEventListener("scroll", update);
+  _SCROLLER_R_OBSERVER.observe(el);
+  _SCROLLER_M_OBSERVER.observe(el, { childList: true, subtree: true, characterData: true });
+  _SCROLLERS.set(el, {
+    update,
+    destroy() {
+      stop();
+      el.removeEventListener("scroll", update);
+      _SCROLLER_R_OBSERVER.unobserve(el);
+      _SCROLLERS.delete(el);
+      Object.values(assist).forEach((a) => a.remove());
+    }
+  });
+  update();
+  return _SCROLLERS.get(el);
+}
+var removeScrollAssist = (el) => _SCROLLERS.get(el)?.destroy();
+export {
+  assignEl,
+  bindAllMethods,
+  clamp,
+  createEl,
+  guardAllMethods,
+  guardMethod,
+  initScrollAssist,
+  initVScrollerator,
+  isSameURL,
+  loadResource,
+  onAllMethods,
+  removeScrollAssist,
+  uid
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@t007/utils",
+  "version": "0.0.1",
+  "description": "High-performance, zero-dependency utility functions for the t007 ecosystem.",
+  "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tobi007-del/t007-tools.git",
+    "directory": "packages/utils"
+  },
+  "homepage": "https://github.com/tobi007-del/t007-tools/tree/main/packages/utils#readme",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "t007",
+    "utils",
+    "helpers",
+    "dom-manipulation",
+    "ecosystem",
+    "zero-dependency",
+    "performance",
+    "shared-logic"
+  ]
+}