@yh-ui/utils 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present YH-UI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/common.cjs

@@ -0,0 +1,150 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.toArray = exports.throttle = exports.sleep = exports.set = exports.retry = exports.kebabCase = exports.get = exports.generateId = exports.deepMerge = exports.deepClone = exports.debounce = exports.capitalize = exports.camelCase = void 0;
+let idCounter = 0;
+const generateId = (prefix = "yh") => {
+  return `${prefix}-${Date.now()}-${++idCounter}`;
+};
+exports.generateId = generateId;
+const debounce = (fn, delay) => {
+  let timer = null;
+  const debounced = (...args) => {
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => {
+      fn(...args);
+      timer = null;
+    }, delay);
+  };
+  debounced.cancel = () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = null;
+    }
+  };
+  return debounced;
+};
+exports.debounce = debounce;
+const throttle = (fn, delay) => {
+  let lastTime = 0;
+  let timer = null;
+  const throttled = (...args) => {
+    const now = Date.now();
+    const remaining = delay - (now - lastTime);
+    if (remaining <= 0) {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      fn(...args);
+      lastTime = now;
+    } else if (!timer) {
+      timer = setTimeout(() => {
+        fn(...args);
+        lastTime = Date.now();
+        timer = null;
+      }, remaining);
+    }
+  };
+  throttled.cancel = () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = null;
+    }
+    lastTime = 0;
+  };
+  return throttled;
+};
+exports.throttle = throttle;
+const deepClone = obj => {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (obj instanceof Date) return new Date(obj.getTime());
+  if (obj instanceof Array) {
+    return obj.map(item => deepClone(item));
+  }
+  if (obj instanceof Object) {
+    const copy = {};
+    Object.keys(obj).forEach(key => {
+      copy[key] = deepClone(obj[key]);
+    });
+    return copy;
+  }
+  return obj;
+};
+exports.deepClone = deepClone;
+const deepMerge = (target, ...sources) => {
+  if (!sources.length) return target;
+  const source = sources.shift();
+  if (source === void 0) return target;
+  for (const key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      const targetValue = target[key];
+      const sourceValue = source[key];
+      if (typeof targetValue === "object" && targetValue !== null && typeof sourceValue === "object" && sourceValue !== null && !Array.isArray(targetValue) && !Array.isArray(sourceValue)) {
+        target[key] = deepMerge({
+          ...targetValue
+        }, sourceValue);
+      } else {
+        target[key] = sourceValue;
+      }
+    }
+  }
+  return deepMerge(target, ...sources);
+};
+exports.deepMerge = deepMerge;
+const toArray = val => {
+  return Array.isArray(val) ? val : [val];
+};
+exports.toArray = toArray;
+const capitalize = str => {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+};
+exports.capitalize = capitalize;
+const kebabCase = str => {
+  return str.replace(/([A-Z])/g, "-$1").toLowerCase().replace(/^-/, "");
+};
+exports.kebabCase = kebabCase;
+const camelCase = str => {
+  return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+};
+exports.camelCase = camelCase;
+const sleep = ms => {
+  return new Promise(resolve => setTimeout(resolve, ms));
+};
+exports.sleep = sleep;
+const get = (obj, path, defaultValue) => {
+  const result = path.split(".").reduce((res, key) => {
+    if (res !== null && res !== void 0 && typeof res === "object") {
+      return res[key];
+    }
+    return void 0;
+  }, obj);
+  return result === void 0 ? defaultValue : result;
+};
+exports.get = get;
+const set = (obj, path, value) => {
+  if (Object(obj) !== obj) return obj;
+  const keys = path.split(".");
+  const lastKey = keys.pop();
+  const node = keys.reduce((res, key) => {
+    if (res[key] === void 0) res[key] = {};
+    return res[key];
+  }, obj);
+  node[lastKey] = value;
+  return obj;
+};
+exports.set = set;
+const retry = async (fn, retries = 3, delay = 1e3) => {
+  try {
+    return await fn();
+  } catch (error) {
+    if (retries > 0) {
+      await sleep(delay);
+      return retry(fn, retries - 1, delay);
+    }
+    throw error;
+  }
+};
+exports.retry = retry;

package/dist/common.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Common utilities
+ * @description 通用工具函数库，严格类型化
+ */
+export declare const generateId: (prefix?: string) => string;
+/**
+ * 函数类型定义
+ */
+type AnyFunction = (...args: unknown[]) => unknown;
+/**
+ * 防抖函数
+ */
+export declare const debounce: <T extends AnyFunction>(fn: T, delay: number) => ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+/**
+ * 节流函数
+ */
+export declare const throttle: <T extends AnyFunction>(fn: T, delay: number) => ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+/**
+ * 深拷贝
+ */
+export declare const deepClone: <T>(obj: T) => T;
+/**
+ * 深度合并对象
+ */
+export declare const deepMerge: <T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]) => T;
+/**
+ * 将值转换为数组
+ */
+export declare const toArray: <T>(val: T | T[]) => T[];
+/**
+ * 首字母大写
+ */
+export declare const capitalize: (str: string) => string;
+/**
+ * 转换为 kebab-case
+ */
+export declare const kebabCase: (str: string) => string;
+/**
+ * 转换为 camelCase
+ */
+export declare const camelCase: (str: string) => string;
+/**
+ * 休眠函数
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * 访问对象嵌套路径的值
+ */
+export declare const get: <T = unknown>(obj: Record<string, unknown>, path: string, defaultValue?: T) => T;
+/**
+ * 设置对象嵌套路径的值
+ */
+export declare const set: <T extends Record<string, unknown>>(obj: T, path: string, value: unknown) => T;
+/**
+ * 异步函数重试
+ */
+export declare const retry: <T>(fn: () => Promise<T>, retries?: number, delay?: number) => Promise<T>;
+export {};

package/dist/common.mjs

@@ -0,0 +1,135 @@
+let idCounter = 0;
+export const generateId = (prefix = "yh") => {
+  return `${prefix}-${Date.now()}-${++idCounter}`;
+};
+export const debounce = (fn, delay) => {
+  let timer = null;
+  const debounced = (...args) => {
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => {
+      fn(...args);
+      timer = null;
+    }, delay);
+  };
+  debounced.cancel = () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = null;
+    }
+  };
+  return debounced;
+};
+export const throttle = (fn, delay) => {
+  let lastTime = 0;
+  let timer = null;
+  const throttled = (...args) => {
+    const now = Date.now();
+    const remaining = delay - (now - lastTime);
+    if (remaining <= 0) {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      fn(...args);
+      lastTime = now;
+    } else if (!timer) {
+      timer = setTimeout(() => {
+        fn(...args);
+        lastTime = Date.now();
+        timer = null;
+      }, remaining);
+    }
+  };
+  throttled.cancel = () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = null;
+    }
+    lastTime = 0;
+  };
+  return throttled;
+};
+export const deepClone = (obj) => {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (obj instanceof Date) return new Date(obj.getTime());
+  if (obj instanceof Array) {
+    return obj.map((item) => deepClone(item));
+  }
+  if (obj instanceof Object) {
+    const copy = {};
+    Object.keys(obj).forEach((key) => {
+      copy[key] = deepClone(obj[key]);
+    });
+    return copy;
+  }
+  return obj;
+};
+export const deepMerge = (target, ...sources) => {
+  if (!sources.length) return target;
+  const source = sources.shift();
+  if (source === void 0) return target;
+  for (const key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      const targetValue = target[key];
+      const sourceValue = source[key];
+      if (typeof targetValue === "object" && targetValue !== null && typeof sourceValue === "object" && sourceValue !== null && !Array.isArray(targetValue) && !Array.isArray(sourceValue)) {
+        target[key] = deepMerge(
+          { ...targetValue },
+          sourceValue
+        );
+      } else {
+        target[key] = sourceValue;
+      }
+    }
+  }
+  return deepMerge(target, ...sources);
+};
+export const toArray = (val) => {
+  return Array.isArray(val) ? val : [val];
+};
+export const capitalize = (str) => {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+};
+export const kebabCase = (str) => {
+  return str.replace(/([A-Z])/g, "-$1").toLowerCase().replace(/^-/, "");
+};
+export const camelCase = (str) => {
+  return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+};
+export const sleep = (ms) => {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+};
+export const get = (obj, path, defaultValue) => {
+  const result = path.split(".").reduce((res, key) => {
+    if (res !== null && res !== void 0 && typeof res === "object") {
+      return res[key];
+    }
+    return void 0;
+  }, obj);
+  return result === void 0 ? defaultValue : result;
+};
+export const set = (obj, path, value) => {
+  if (Object(obj) !== obj) return obj;
+  const keys = path.split(".");
+  const lastKey = keys.pop();
+  const node = keys.reduce(
+    (res, key) => {
+      if (res[key] === void 0) res[key] = {};
+      return res[key];
+    },
+    obj
+  );
+  node[lastKey] = value;
+  return obj;
+};
+export const retry = async (fn, retries = 3, delay = 1e3) => {
+  try {
+    return await fn();
+  } catch (error) {
+    if (retries > 0) {
+      await sleep(delay);
+      return retry(fn, retries - 1, delay);
+    }
+    throw error;
+  }
+};

package/dist/dom.cjs

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.toggleClass = exports.setStyle = exports.removeClass = exports.isServer = exports.isInViewport = exports.isClient = exports.hasClass = exports.getStyle = exports.getScrollContainer = exports.addClass = void 0;
+const isClient = exports.isClient = typeof window !== "undefined";
+const isServer = exports.isServer = !isClient;
+const getStyle = (element, styleName) => {
+  if (!isClient || !element || !styleName) return "";
+  try {
+    const style = element.style[styleName];
+    if (style) return style;
+    const computed = document.defaultView?.getComputedStyle(element, "");
+    return computed ? computed[styleName] : "";
+  } catch {
+    return element.style[styleName];
+  }
+};
+exports.getStyle = getStyle;
+const setStyle = (element, styleName, value) => {
+  if (!element || !styleName) return;
+  if (typeof styleName === "object") {
+    Object.entries(styleName).forEach(([key, val]) => {
+      setStyle(element, key, val);
+    });
+  } else {
+    ;
+    element.style[styleName] = value ?? "";
+  }
+};
+exports.setStyle = setStyle;
+const hasClass = (el, cls) => {
+  if (!el || !cls) return false;
+  if (cls.includes(" ")) throw new Error("className should not contain space.");
+  return el.classList.contains(cls);
+};
+exports.hasClass = hasClass;
+const addClass = (el, cls) => {
+  if (!el || !cls.trim()) return;
+  el.classList.add(...cls.split(" ").filter(Boolean));
+};
+exports.addClass = addClass;
+const removeClass = (el, cls) => {
+  if (!el || !cls.trim()) return;
+  el.classList.remove(...cls.split(" ").filter(Boolean));
+};
+exports.removeClass = removeClass;
+const toggleClass = (el, cls, force) => {
+  if (!el || !cls.trim()) return;
+  el.classList.toggle(cls, force);
+};
+exports.toggleClass = toggleClass;
+const getScrollContainer = (el, isVertical) => {
+  if (!isClient) return void 0;
+  let parent = el;
+  while (parent) {
+    if ([document.documentElement, document.body].includes(parent)) {
+      return window;
+    }
+    const overflow = isVertical ? getStyle(parent, "overflowY") : getStyle(parent, "overflow");
+    if (/(scroll|auto)/.test(overflow)) {
+      return parent;
+    }
+    parent = parent.parentNode;
+  }
+  return void 0;
+};
+exports.getScrollContainer = getScrollContainer;
+const isInViewport = el => {
+  if (!isClient || !el) return false;
+  const rect = el.getBoundingClientRect();
+  return rect.top >= 0 && rect.left >= 0 && rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) && rect.right <= (window.innerWidth || document.documentElement.clientWidth);
+};
+exports.isInViewport = isInViewport;

package/dist/dom.d.ts

@@ -0,0 +1,43 @@
+/**
+ * DOM utilities
+ */
+/**
+ * 判断是否在浏览器环境
+ */
+export declare const isClient: boolean;
+/**
+ * 判断是否在服务端环境
+ */
+export declare const isServer: boolean;
+/**
+ * 获取元素的样式
+ */
+export declare const getStyle: (element: HTMLElement, styleName: string) => string;
+/**
+ * 设置元素的样式
+ */
+export declare const setStyle: (element: HTMLElement, styleName: string | Record<string, string>, value?: string) => void;
+/**
+ * 检查元素是否包含某个类名
+ */
+export declare const hasClass: (el: HTMLElement, cls: string) => boolean;
+/**
+ * 添加类名
+ */
+export declare const addClass: (el: HTMLElement, cls: string) => void;
+/**
+ * 移除类名
+ */
+export declare const removeClass: (el: HTMLElement, cls: string) => void;
+/**
+ * 切换类名
+ */
+export declare const toggleClass: (el: HTMLElement, cls: string, force?: boolean) => void;
+/**
+ * 获取滚动容器
+ */
+export declare const getScrollContainer: (el: HTMLElement, isVertical?: boolean) => HTMLElement | Window | undefined;
+/**
+ * 检查元素是否在视口中
+ */
+export declare const isInViewport: (el: HTMLElement) => boolean;

package/dist/dom.mjs

@@ -0,0 +1,61 @@
+export const isClient = typeof window !== "undefined";
+export const isServer = !isClient;
+export const getStyle = (element, styleName) => {
+  if (!isClient || !element || !styleName) return "";
+  try {
+    const style = element.style[styleName];
+    if (style) return style;
+    const computed = document.defaultView?.getComputedStyle(element, "");
+    return computed ? computed[styleName] : "";
+  } catch {
+    return element.style[styleName];
+  }
+};
+export const setStyle = (element, styleName, value) => {
+  if (!element || !styleName) return;
+  if (typeof styleName === "object") {
+    Object.entries(styleName).forEach(([key, val]) => {
+      setStyle(element, key, val);
+    });
+  } else {
+    ;
+    element.style[styleName] = value ?? "";
+  }
+};
+export const hasClass = (el, cls) => {
+  if (!el || !cls) return false;
+  if (cls.includes(" ")) throw new Error("className should not contain space.");
+  return el.classList.contains(cls);
+};
+export const addClass = (el, cls) => {
+  if (!el || !cls.trim()) return;
+  el.classList.add(...cls.split(" ").filter(Boolean));
+};
+export const removeClass = (el, cls) => {
+  if (!el || !cls.trim()) return;
+  el.classList.remove(...cls.split(" ").filter(Boolean));
+};
+export const toggleClass = (el, cls, force) => {
+  if (!el || !cls.trim()) return;
+  el.classList.toggle(cls, force);
+};
+export const getScrollContainer = (el, isVertical) => {
+  if (!isClient) return void 0;
+  let parent = el;
+  while (parent) {
+    if ([document.documentElement, document.body].includes(parent)) {
+      return window;
+    }
+    const overflow = isVertical ? getStyle(parent, "overflowY") : getStyle(parent, "overflow");
+    if (/(scroll|auto)/.test(overflow)) {
+      return parent;
+    }
+    parent = parent.parentNode;
+  }
+  return void 0;
+};
+export const isInViewport = (el) => {
+  if (!isClient || !el) return false;
+  const rect = el.getBoundingClientRect();
+  return rect.top >= 0 && rect.left >= 0 && rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) && rect.right <= (window.innerWidth || document.documentElement.clientWidth);
+};