@yqg/simple 1.0.1 → 1.0.2

package/src/types/util/object.d.ts

@@ -0,0 +1,91 @@
+/*
+ * @Author: YQG Team
+ * @Date: 2024-12-19
+ * @Description: Type definitions for object utilities
+ */
+
+/**
+ * 评估属性值，如果是函数则执行
+ * @param value - 属性值或函数
+ * @param values - 传递给函数的参数
+ * @returns 评估后的值
+ */
+export function evalProp<T = any, V = any>(value: T | ((values: V) => T), values?: V): T;
+
+/**
+ * 根据键字符串从对象中提取值
+ * @param obj - 目标对象
+ * @param keyString - 键字符串，支持点号和方括号语法，如 'a.b.c' 或 'a[0].b'
+ * @returns 提取的值
+ */
+export function pickValue<T = any>(obj: any, keyString: string): T | undefined;
+
+/**
+ * 根据键字符串设置对象的值
+ * @param obj - 目标对象
+ * @param keyString - 键字符串，支持点号和方括号语法
+ * @param value - 要设置的值
+ * @returns 新对象
+ */
+export function setValue<T extends Record<string, any>>(obj: T, keyString: string, value: any): T;
+
+/**
+ * 展开对象的键
+ * @param origin - 原始对象
+ * @returns 展开后的对象
+ */
+export function spreadObjectKeys<T extends Record<string, any>>(origin: T): T;
+
+/**
+ * 将数字转换为字符串
+ * @param val - 数字或布尔值
+ * @returns 字符串或原值
+ */
+export function numbersToStr<T>(val: T | T[]): T extends number | boolean ? string : T;
+
+/**
+ * 是否为移动设备
+ */
+export const isMobile: boolean;
+
+/**
+ * 展开 Vue 组件属性
+ * @param props - 组件属性对象
+ * @returns 展开后的属性对象
+ */
+export function spreadProps(props?: {
+    class?: any;
+    style?: any;
+    ref?: any;
+    key?: any;
+    [key: string]: any;
+}): {
+    key?: any;
+    class?: any;
+    style?: any;
+    ref?: any;
+    props: Record<string, any>;
+};
+
+/**
+ * 向类名追加新类名
+ * @param className - 原类名
+ * @param appendix - 要追加的类名
+ * @returns 新类名
+ */
+export function appendClass(
+    className: string | Record<string, boolean> | string[] | undefined,
+    appendix: string
+): string | Record<string, boolean> | string[];
+
+/**
+ * 深度合并两个对象
+ * @param target - 目标对象
+ * @param source - 源对象
+ * @returns 合并后的新对象
+ */
+export function merge<T extends Record<string, any>, S extends Record<string, any>>(
+    target?: T,
+    source?: S
+): T & S;
+

package/src/types/util/storage.d.ts

@@ -0,0 +1,62 @@
+/*
+ * @Author: YQG Team
+ * @Date: 2024-12-19
+ * @Description: Type definitions for Storage class
+ */
+
+/**
+ * 存储类，封装 localStorage 或 sessionStorage
+ */
+export default class Storage {
+    /**
+     * 存储键名
+     */
+    key: string;
+
+    /**
+     * 是否使用 sessionStorage
+     */
+    useSessionStorage: boolean;
+
+    /**
+     * 存储对象
+     */
+    storage: Storage;
+
+    /**
+     * 创建存储实例
+     * @param key - 存储键名
+     * @param useSessionStorage - 是否使用 sessionStorage，默认为 false（使用 localStorage）
+     */
+    constructor(key: string, useSessionStorage?: boolean);
+
+    /**
+     * 设置存储值
+     * @param cache - 要存储的数据
+     */
+    set(cache: any): void;
+
+    /**
+     * 获取存储值
+     * @returns 存储的数据或 null
+     */
+    get<T = any>(): T | null;
+
+    /**
+     * 删除存储项
+     */
+    remove(): void;
+
+    /**
+     * 监听存储变化
+     * @param fn - 回调函数
+     */
+    on(fn: (event: StorageEvent) => void): void;
+
+    /**
+     * 取消监听
+     * @param needsRemove - 是否同时删除存储项
+     */
+    off(needsRemove?: boolean): void;
+}
+

package/src/types/util/swim-lane.d.ts

@@ -0,0 +1,15 @@
+/*
+ * @Author: YQG Team
+ * @Date: 2024-12-19
+ * @Description: Type definitions for swim lane storage
+ */
+
+import Storage from './storage.ts';
+
+/**
+ * 泳道存储实例
+ */
+declare const swimLaneStorage: Storage;
+
+export default swimLaneStorage;
+

package/src/types/util/tool.d.ts

@@ -0,0 +1,13 @@
+/*
+ * @Author: YQG Team
+ * @Date: 2024-12-19
+ * @Description: Type definitions for tool utilities
+ */
+
+/**
+ * 驼峰转换为下划线连接
+ * @param camelStr - 驼峰字符串，例如 camelStr
+ * @returns 下划线字符串，例如 camel_str
+ */
+export function camelCaseToUnderscore(camelStr: string): string;
+

package/src/util/tool.js

@@ -5,47 +5,6 @@
  * @Last Modified time: 2022-10-20 18:15:32
  */
 
-import CryptoJS from 'crypto-js';
-
-const CALL_SECRET = 'ainiliangwannian';
-/**
- * AES 解密
- * @param ciphertext, key
- * @returns utf8字符串
- */
-export const aesDecrypt = (ciphertext, key = CALL_SECRET) => {
-    if (ciphertext) {
-        const encodeKey = CryptoJS.enc.Utf8.parse(key);
-        const decrypted = CryptoJS.AES.decrypt(ciphertext, encodeKey, {
-            mode: CryptoJS.mode.ECB,
-            padding: CryptoJS.pad.Pkcs7
-        });
-
-        return decrypted.toString(CryptoJS.enc.Utf8);
-    }
-
-    return ciphertext;
-};
-
-/**
- * AES 加密
- * @param message, key
- * @returns 密码对象Base64字符串
- */
-export const aesEncrypt = (message, key = CALL_SECRET) => {
-    if (message) {
-        const encodeKey = CryptoJS.enc.Utf8.parse(key);
-        const ciphertext = CryptoJS.AES.encrypt(message, encodeKey, {
-            mode: CryptoJS.mode.ECB,
-            padding: CryptoJS.pad.Pkcs7
-        });
-
-        return ciphertext.toString();
-    }
-
-    return message;
-};
-
 const isString = value => (typeof value === 'string');
 /* 驼峰转换为下划线链接，例如camelStr => camel_str */
 export const camelCaseToUnderscore = camelStr => (