@reskin/core 0.0.21 → 0.1.0

package/bundles/reskin-core-utils.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('rxjs')) :
-    typeof define === 'function' && define.amd ? define('@reskin/core/utils', ['exports', 'rxjs'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.reskin = global.reskin || {}, global.reskin.core = global.reskin.core || {}, global.reskin.core.utils = {}), global.rxjs));
-})(this, (function (exports, rxjs) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('rxjs'), require('rxjs/operators')) :
+    typeof define === 'function' && define.amd ? define('@reskin/core/utils', ['exports', 'rxjs', 'rxjs/operators'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.reskin = global.reskin || {}, global.reskin.core = global.reskin.core || {}, global.reskin.core.utils = {}), global.rxjs, global.rxjs.operators));
+})(this, (function (exports, rxjs, operators) { 'use strict';
 
     /**
      * 默认前缀
@@ -12,160 +12,303 @@
      * 设置存储前缀
      *
      * 该函数用于更改全局存储前缀，影响后续所有存储操作的键名前缀。
-     * 存储前缀的更改可能会影响已存储的数据被正确识别和访问。
+     * 注意：更改前缀后，之前使用旧前缀存储的数据将无法访问。
      *
      * @param newPrefix 新的存储前缀字符串
+     *
+     * @example
+     * setStorePrefix('MY_APP_');
      */
     function setStorePrefix(newPrefix) {
         prefix = newPrefix;
     }
     /**
-     * 提供了一个用于缓存值的类，值可以被存储在浏览器的localStorage或sessionStorage中。
-     * 如果提供了过期时间，存储的值会在过期后自动移除。
+     * 提供了一个用于缓存值的类，值可以被存储在浏览器的 localStorage 或 sessionStorage 中。
+     * 支持过期时间设置，过期后数据会自动移除。
+     *
+     * @template T 存储数据的类型
+     *
+     * @example
+     * // 基础用法
+     * const userStore = new Store<User>('user', { name: '', age: 0 });
+     * userStore.set({ name: '张三', age: 25 });
+     * console.log(userStore.get()); // { name: '张三', age: 25 }
+     *
+     * @example
+     * // 使用 localStorage 并设置过期时间
+     * const tokenStore = new Store<string>('token', '', {
+     *   storageEngine: localStorage,
+     *   expires: 3600000 // 1小时后过期
+     * });
      */
     var Store = /** @class */ (function () {
         /**
-         * 初始化Store类的实例。
-         * @param key 缓存值的键名。
-         * @param defaultValue 初始值，默认值会被存储并返回直到设置新的值。
-         * @param options 配置选项，包括存储引擎和过期时间。
+         * 初始化 Store 类的实例
+         * @param key 缓存值的键名
+         * @param defaultValue 初始值，默认值会被存储并返回直到设置新的值
+         * @param options 配置选项，包括存储引擎和过期时间
          */
         function Store(key, defaultValue, options) {
+            this.key = key;
             this.value = defaultValue;
-            // 进行初始设置
-            this.storageKey = function () { return ("@" + prefix + "_" + key).toLocaleUpperCase(); };
-            var _a = options !== null && options !== void 0 ? options : {}, _b = _a.storageEngine, storageEngine = _b === void 0 ? sessionStorage : _b, expires = _a.expires;
+            var _b = options !== null && options !== void 0 ? options : {}, _c = _b.storageEngine, storageEngine = _c === void 0 ? sessionStorage : _c, expires = _b.expires;
             this.storage = storageEngine;
             this.expires = expires;
-            var storedValue = this.storage.getItem(this.storageKey());
-            if (storedValue) {
-                var _c = JSON.parse(storedValue), data = _c.data, expiry = _c.expiry;
-                // 判断是否过期，过期后删除key
+            // 尝试从存储中读取数据
+            this.loadFromStorage();
+        }
+        /**
+         * 生成存储键名
+         */
+        Store.prototype.getStorageKey = function () {
+            return ("@" + prefix + "_" + this.key).toLocaleUpperCase();
+        };
+        /**
+         * 从存储中加载数据
+         */
+        Store.prototype.loadFromStorage = function () {
+            try {
+                var storedValue = this.storage.getItem(this.getStorageKey());
+                if (!storedValue) {
+                    return;
+                }
+                var _b = JSON.parse(storedValue), data = _b.data, expiry = _b.expiry;
+                // 检查是否过期
                 if (!expiry || expiry > Date.now()) {
                     this.value = data;
                 }
                 else {
-                    this.storage.removeItem(this.storageKey());
+                    // 过期则删除
+                    this.clear();
                 }
             }
-        }
+            catch (error) {
+                console.error("\u4ECE\u5B58\u50A8\u4E2D\u8BFB\u53D6\u6570\u636E\u5931\u8D25 (key: " + this.getStorageKey() + "):", error);
+                // 数据损坏时清除
+                this.clear();
+            }
+        };
         /**
-         * 获取当前缓存的值。
-         * @returns 缓存的值。
+         * 获取当前缓存的值
+         * @returns 缓存的值
          */
         Store.prototype.get = function () {
             return this.value;
         };
         /**
-         * 设置新的缓存值。
-         * @param newValue 新的值。
+         * 设置新的缓存值
+         * @param newValue 新的值
          */
         Store.prototype.set = function (newValue) {
             this.value = newValue;
-            // 设置值时进行Storage设置
-            var value = JSON.stringify({
-                data: newValue,
-                expiry: this.expires ? Date.now() + this.expires : null,
-            });
-            this.storage.setItem(this.storageKey(), value);
+            try {
+                var storageData = {
+                    data: newValue,
+                    expiry: this.expires ? Date.now() + this.expires : null,
+                };
+                this.storage.setItem(this.getStorageKey(), JSON.stringify(storageData));
+            }
+            catch (error) {
+                console.error("\u5B58\u50A8\u6570\u636E\u5931\u8D25 (key: " + this.getStorageKey() + "):", error);
+            }
         };
         /**
-         * 使用提供的函数更新缓存的值。
-         * @param updateFn 一个接受当前值并返回新值的函数。
+         * 使用提供的函数更新缓存的值
+         * @param updateFn 一个接受当前值并返回新值的函数
+         *
+         * @example
+         * const countStore = new Store<number>('count', 0);
+         * countStore.update(count => count + 1);
          */
         Store.prototype.update = function (updateFn) {
             if (typeof updateFn === 'function') {
                 this.set(updateFn(this.value));
             }
         };
+        /**
+         * 清除缓存数据
+         */
+        Store.prototype.clear = function () {
+            try {
+                this.storage.removeItem(this.getStorageKey());
+            }
+            catch (error) {
+                console.error("\u6E05\u9664\u5B58\u50A8\u6570\u636E\u5931\u8D25 (key: " + this.getStorageKey() + "):", error);
+            }
+        };
+        /**
+         * 检查缓存是否存在且未过期
+         * @returns 如果缓存存在且未过期返回 true，否则返回 false
+         */
+        Store.prototype.has = function () {
+            try {
+                var storedValue = this.storage.getItem(this.getStorageKey());
+                if (!storedValue) {
+                    return false;
+                }
+                var expiry = JSON.parse(storedValue).expiry;
+                return !expiry || expiry > Date.now();
+            }
+            catch (_a) {
+                return false;
+            }
+        };
         return Store;
     }());
 
     /**
      * 深克隆一个对象或数组
      *
-     * 该函数通过递归方式深克隆输入的对象或数组，确保与原对象或数组隔离，不会相互影响
+     * 该函数通过递归方式深克隆输入的对象或数组，确保与原对象或数组隔离，不会相互影响。
+     * 支持克隆：普通对象、数组、Date、Map、Set、RegExp 等类型。
      *
      * @param source 需要克隆的源对象或数组
      * @returns 返回克隆后的对象或数组
+     *
+     * @example
+     * const obj = { a: 1, b: { c: 2 } };
+     * const cloned = deepClone(obj);
+     * cloned.b.c = 3;
+     * console.log(obj.b.c); // 输出: 2
      */
     function deepClone(source) {
-        // 如果源对象为null或不是对象类型，则直接返回源对象
+        // 处理 null 和基本类型
         if (source === null || typeof source !== 'object') {
             return source;
         }
-        // 如果源对象是数组，则创建一个新数组并递归克隆每个元素
+        // 处理 Date 对象
+        if (source instanceof Date) {
+            return new Date(source.getTime());
+        }
+        // 处理 RegExp 对象
+        if (source instanceof RegExp) {
+            return new RegExp(source.source, source.flags);
+        }
+        // 处理 Map 对象
+        if (source instanceof Map) {
+            var clonedMap_1 = new Map();
+            source.forEach(function (value, key) {
+                clonedMap_1.set(deepClone(key), deepClone(value));
+            });
+            return clonedMap_1;
+        }
+        // 处理 Set 对象
+        if (source instanceof Set) {
+            var clonedSet_1 = new Set();
+            source.forEach(function (value) {
+                clonedSet_1.add(deepClone(value));
+            });
+            return clonedSet_1;
+        }
+        // 处理数组
         if (Array.isArray(source)) {
-            var clonedArray = [];
-            for (var i = 0; i < source.length; i++) {
-                clonedArray[i] = deepClone(source[i]);
-            }
-            // 忽略类型检查器的警告，确保能够返回泛型T类型的数组
-            // @ts-ignore
-            return clonedArray;
+            return source.map(function (item) { return deepClone(item); });
         }
-        // 如果源对象是普通对象，则创建一个新的空对象并递归克隆每个属性
-        if (typeof source === 'object') {
-            var clonedObject = {};
-            for (var key in source) {
-                // 确保只处理对象自身的属性，避免原型链上的属性被克隆
-                // @ts-ignore
-                if (source.hasOwnProperty(key)) {
-                    clonedObject[key] = deepClone(source[key]);
-                }
-            }
-            // 忽略类型检查器的警告，确保能够返回泛型T类型的对象
-            return clonedObject;
+        // 处理普通对象
+        if (Object.prototype.toString.call(source) === '[object Object]') {
+            var clonedObject_1 = {};
+            Object.keys(source).forEach(function (key) {
+                clonedObject_1[key] = deepClone(source[key]);
+            });
+            return clonedObject_1;
         }
-        // 如果源对象是其他非对象类型，则直接返回源对象
+        // 其他类型直接返回（如函数、Symbol 等）
         return source;
     }
 
     /**
      * 监听元素的大小变化
      *
-     * 此函数创建了一个Observable，用于观察给定HTMLElement元素的大小变化它使用了ResizeObserver API来实现
-     * 当元素的大小发生变化时，会发出一个包含变化记录的数组
+     * 此函数创建了一个 Observable，用于观察给定 HTMLElement 元素的大小变化。
+     * 它使用了 ResizeObserver API 来实现，当元素的大小发生变化时，会发出一个包含变化记录的数组。
+     *
+     * @param element 需要观察大小变化的 HTMLElement 元素
+     * @param options 配置选项
+     * @returns 返回一个 Observable，其中包含 ResizeObserverEntry 的数组，用于记录每次大小变化的信息
      *
-     * @param element 需要观察大小变化的HTMLElement元素
-     * @returns 返回一个Observable，其中包含ResizeObserverEntry的数组，用于记录每次大小变化的信息
+     * @example
+     * // 基础用法
+     * const element = document.querySelector('.container');
+     * observeResize(element).subscribe(entries => {
+     *   const { width, height } = entries[0].contentRect;
+     *   console.log(`元素尺寸: ${width}x${height}`);
+     * });
+     *
+     * @example
+     * // 使用防抖优化性能
+     * observeResize(element, { debounce: 300 }).subscribe(entries => {
+     *   // 300ms 内的多次变化只会触发一次
+     *   console.log('元素大小已稳定');
+     * });
      */
-    function observeResize(element) {
-        return new rxjs.Observable(function (observer) {
-            // 创建ResizeObserver实例，当观察的目标元素大小发生变化时，会调用回调函数
+    function observeResize(element, options) {
+        var debounce = (options || {}).debounce;
+        var resize$ = new rxjs.Observable(function (observer) {
+            // 创建 ResizeObserver 实例，当观察的目标元素大小发生变化时，会调用回调函数
             var resizeObserver = new ResizeObserver(function (entries) {
                 observer.next(entries);
             });
             // 开始观察指定的元素
             resizeObserver.observe(element);
-            // 返回一个函数，用于在停止观察时调用，以清理资源
+            // 返回清理函数，用于在取消订阅时调用
             return function () {
-                // 停止观察指定的元素
                 resizeObserver.unobserve(element);
-                // 断开与所有目标的观察连接
                 resizeObserver.disconnect();
             };
         });
+        // 如果设置了防抖，则应用防抖操作符
+        return debounce ? resize$.pipe(operators.debounceTime(debounce)) : resize$;
     }
 
     /**
      * 表单验证
-     * @param form
+     *
+     * 遍历表单所有控件，标记为脏状态并触发验证。
+     * 如果表单验证通过，返回表单的原始值；否则返回 false。
+     *
+     * @param form Angular 表单组对象
+     * @param options 验证配置选项
+     * @returns 验证通过返回表单值，验证失败返回 false
+     *
+     * @example
+     * const result = formVerify(this.form);
+     * if (result) {
+     *   console.log('表单数据:', result);
+     * }
+     *
+     * @example
+     * // 自定义错误处理
+     * formVerify(this.form, {
+     *   logError: false,
+     *   onError: (fields) => {
+     *     this.message.error(`以下字段验证失败: ${fields.join(', ')}`);
+     *   }
+     * });
      */
-    function formVerify(form) {
-        var errList = [];
-        for (var key in form.controls) {
-            form.controls[key].markAsDirty();
-            form.controls[key].updateValueAndValidity();
-            if (form.controls[key].status !== 'VALID' && form.controls[key].status !== 'DISABLED') {
-                errList.push(key);
+    function formVerify(form, options) {
+        var _a = options || {}, _b = _a.logError, logError = _b === void 0 ? true : _b, onError = _a.onError;
+        var invalidFields = [];
+        // 遍历所有控件，标记为脏状态并更新验证状态
+        Object.keys(form.controls).forEach(function (key) {
+            var control = form.controls[key];
+            control.markAsDirty();
+            control.updateValueAndValidity();
+            // 收集验证失败的字段（排除禁用状态）
+            if (control.status !== 'VALID' && control.status !== 'DISABLED') {
+                invalidFields.push(key);
+            }
+        });
+        // 表单验证失败（排除全部禁用的情况）
+        if (form.status !== 'VALID' && form.status !== 'DISABLED') {
+            if (logError) {
+                console.error("\u8868\u5355\u9A8C\u8BC1\u5931\u8D25\uFF0C\u5B57\u6BB5: " + invalidFields.join(', '));
+            }
+            if (onError) {
+                onError(invalidFields);
             }
-        }
-        // 表单验证状态
-        if (form.status !== 'VALID') {
-            console.error("Form validation failed fields\uFF1A" + errList.join(','));
             return false;
         }
+        // 验证通过，返回表单原始值（包含禁用字段）
         return form.getRawValue();
     }
 

package/bundles/reskin-core-utils.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"reskin-core-utils.umd.js","sources":["../../../library/core/utils/store.ts","../../../library/core/utils/array.ts","../../../library/core/utils/dom.ts","../../../library/core/utils/form.ts","../../../library/core/utils/reskin-core-utils.ts"],"sourcesContent":["/**\r\n * 缓存配置信息\r\n */\r\nexport interface StoreOptions {\r\n    /**\r\n     * 缓存存储方式\r\n     */\r\n    storageEngine?: Storage;\r\n    /**\r\n     * 过期时间(毫秒)\r\n     */\r\n    expires?: number;\r\n}\r\n\r\n/**\r\n * 默认前缀\r\n */\r\nlet prefix: string = 'SK_';\r\n\r\n/**\r\n * 设置存储前缀\r\n *\r\n * 该函数用于更改全局存储前缀，影响后续所有存储操作的键名前缀。\r\n * 存储前缀的更改可能会影响已存储的数据被正确识别和访问。\r\n *\r\n * @param newPrefix 新的存储前缀字符串\r\n */\r\nexport function setStorePrefix(newPrefix: string) {\r\n    prefix = newPrefix;\r\n}\r\n\r\n/**\r\n * 提供了一个用于缓存值的类，值可以被存储在浏览器的localStorage或sessionStorage中。\r\n * 如果提供了过期时间，存储的值会在过期后自动移除。\r\n */\r\nexport class Store<T> {\r\n    private value: T;\r\n    private readonly storage: Storage;\r\n    private readonly expires?: number;\r\n    private readonly storageKey: () => string;\r\n\r\n    /**\r\n     * 初始化Store类的实例。\r\n     * @param key 缓存值的键名。\r\n     * @param defaultValue 初始值，默认值会被存储并返回直到设置新的值。\r\n     * @param options 配置选项，包括存储引擎和过期时间。\r\n     */\r\n    constructor(key: string, defaultValue: T, options?: StoreOptions) {\r\n        this.value = defaultValue;\r\n\r\n        // 进行初始设置\r\n        this.storageKey = () => `@${prefix}_${key}`.toLocaleUpperCase();\r\n        const { storageEngine = sessionStorage, expires } = options ?? {};\r\n        this.storage = storageEngine;\r\n        this.expires = expires;\r\n\r\n        const storedValue = this.storage.getItem(this.storageKey());\r\n        if (storedValue) {\r\n            const { data, expiry } = JSON.parse(storedValue);\r\n            // 判断是否过期，过期后删除key\r\n            if (!expiry || expiry > Date.now()) {\r\n                this.value = data;\r\n            } else {\r\n                this.storage.removeItem(this.storageKey());\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 获取当前缓存的值。\r\n     * @returns 缓存的值。\r\n     */\r\n    get(): T {\r\n        return this.value;\r\n    }\r\n\r\n    /**\r\n     * 设置新的缓存值。\r\n     * @param newValue 新的值。\r\n     */\r\n    set(newValue: T): void {\r\n        this.value = newValue;\r\n\r\n        // 设置值时进行Storage设置\r\n        const value = JSON.stringify({\r\n            data: newValue,\r\n            expiry: this.expires ? Date.now() + this.expires : null,\r\n        });\r\n        this.storage.setItem(this.storageKey(), value);\r\n    }\r\n\r\n    /**\r\n     * 使用提供的函数更新缓存的值。\r\n     * @param updateFn 一个接受当前值并返回新值的函数。\r\n     */\r\n    update(updateFn: (currentValue: T) => T): void {\r\n        if (typeof updateFn === 'function') {\r\n            this.set(updateFn(this.value));\r\n        }\r\n    }\r\n}\r\n","/**\r\n * 深克隆一个对象或数组\r\n *\r\n * 该函数通过递归方式深克隆输入的对象或数组，确保与原对象或数组隔离，不会相互影响\r\n *\r\n * @param source 需要克隆的源对象或数组\r\n * @returns 返回克隆后的对象或数组\r\n */\r\nexport function deepClone<T>(source: T): T {\r\n    // 如果源对象为null或不是对象类型，则直接返回源对象\r\n    if (source === null || typeof source !== 'object') {\r\n        return source;\r\n    }\r\n\r\n    // 如果源对象是数组，则创建一个新数组并递归克隆每个元素\r\n    if (Array.isArray(source)) {\r\n        const clonedArray = [];\r\n        for (let i = 0; i < source.length; i++) {\r\n            clonedArray[i] = deepClone(source[i]);\r\n        }\r\n        // 忽略类型检查器的警告，确保能够返回泛型T类型的数组\r\n        // @ts-ignore\r\n        return clonedArray as T;\r\n    }\r\n\r\n    // 如果源对象是普通对象，则创建一个新的空对象并递归克隆每个属性\r\n    if (typeof source === 'object') {\r\n        const clonedObject: Record<string, any> = {};\r\n        for (const key in source) {\r\n            // 确保只处理对象自身的属性，避免原型链上的属性被克隆\r\n            // @ts-ignore\r\n            if (source.hasOwnProperty(key)) {\r\n                clonedObject[key] = deepClone(source[key]);\r\n            }\r\n        }\r\n        // 忽略类型检查器的警告，确保能够返回泛型T类型的对象\r\n        return clonedObject as T;\r\n    }\r\n\r\n    // 如果源对象是其他非对象类型，则直接返回源对象\r\n    return source;\r\n}\r\n","import { Observable } from 'rxjs';\r\n\r\n/**\r\n * 监听元素的大小变化\r\n *\r\n * 此函数创建了一个Observable，用于观察给定HTMLElement元素的大小变化它使用了ResizeObserver API来实现\r\n * 当元素的大小发生变化时，会发出一个包含变化记录的数组\r\n *\r\n * @param element 需要观察大小变化的HTMLElement元素\r\n * @returns 返回一个Observable，其中包含ResizeObserverEntry的数组，用于记录每次大小变化的信息\r\n */\r\nexport function observeResize(element: HTMLElement): Observable<ResizeObserverEntry[]> {\r\n    return new Observable((observer) => {\r\n        // 创建ResizeObserver实例，当观察的目标元素大小发生变化时，会调用回调函数\r\n        const resizeObserver = new ResizeObserver((entries) => {\r\n            observer.next(entries);\r\n        });\r\n        // 开始观察指定的元素\r\n        resizeObserver.observe(element);\r\n        // 返回一个函数，用于在停止观察时调用，以清理资源\r\n        return () => {\r\n            // 停止观察指定的元素\r\n            resizeObserver.unobserve(element);\r\n            // 断开与所有目标的观察连接\r\n            resizeObserver.disconnect();\r\n        };\r\n    });\r\n}\r\n","import { FormGroup } from '@angular/forms';\r\n\r\n/**\r\n * 表单验证\r\n * @param form\r\n */\r\nexport function formVerify<T = Record<string, any>>(form: FormGroup): false | T {\r\n    const errList = [];\r\n    for (const key in form.controls) {\r\n        form.controls[key].markAsDirty();\r\n        form.controls[key].updateValueAndValidity();\r\n        if (form.controls[key].status !== 'VALID' && form.controls[key].status !== 'DISABLED') {\r\n            errList.push(key);\r\n        }\r\n    }\r\n    // 表单验证状态\r\n    if (form.status !== 'VALID') {\r\n        console.error(`Form validation failed fields：${errList.join(',')}`);\r\n        return false;\r\n    }\r\n    return form.getRawValue();\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":["Observable"],"mappings":"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"}
+{"version":3,"file":"reskin-core-utils.umd.js","sources":["../../../library/core/utils/store.ts","../../../library/core/utils/array.ts","../../../library/core/utils/dom.ts","../../../library/core/utils/form.ts","../../../library/core/utils/reskin-core-utils.ts"],"sourcesContent":["/**\r\n * 缓存配置信息\r\n */\r\nexport interface StoreOptions {\r\n    /**\r\n     * 缓存存储方式\r\n     * @default sessionStorage\r\n     */\r\n    storageEngine?: Storage;\r\n    /**\r\n     * 过期时间（毫秒）\r\n     * @default undefined (永不过期)\r\n     */\r\n    expires?: number;\r\n}\r\n\r\n/**\r\n * 存储数据结构\r\n */\r\ninterface StorageData<T> {\r\n    /**\r\n     * 实际存储的数据\r\n     */\r\n    data: T;\r\n    /**\r\n     * 过期时间戳（毫秒）\r\n     */\r\n    expiry: number | null;\r\n}\r\n\r\n/**\r\n * 默认前缀\r\n */\r\nlet prefix: string = 'SK_';\r\n\r\n/**\r\n * 设置存储前缀\r\n *\r\n * 该函数用于更改全局存储前缀，影响后续所有存储操作的键名前缀。\r\n * 注意：更改前缀后，之前使用旧前缀存储的数据将无法访问。\r\n *\r\n * @param newPrefix 新的存储前缀字符串\r\n *\r\n * @example\r\n * setStorePrefix('MY_APP_');\r\n */\r\nexport function setStorePrefix(newPrefix: string): void {\r\n    prefix = newPrefix;\r\n}\r\n\r\n/**\r\n * 提供了一个用于缓存值的类，值可以被存储在浏览器的 localStorage 或 sessionStorage 中。\r\n * 支持过期时间设置，过期后数据会自动移除。\r\n *\r\n * @template T 存储数据的类型\r\n *\r\n * @example\r\n * // 基础用法\r\n * const userStore = new Store<User>('user', { name: '', age: 0 });\r\n * userStore.set({ name: '张三', age: 25 });\r\n * console.log(userStore.get()); // { name: '张三', age: 25 }\r\n *\r\n * @example\r\n * // 使用 localStorage 并设置过期时间\r\n * const tokenStore = new Store<string>('token', '', {\r\n *   storageEngine: localStorage,\r\n *   expires: 3600000 // 1小时后过期\r\n * });\r\n */\r\nexport class Store<T> {\r\n    private value: T;\r\n    private readonly storage: Storage;\r\n    private readonly expires?: number;\r\n    private readonly key: string;\r\n\r\n    /**\r\n     * 初始化 Store 类的实例\r\n     * @param key 缓存值的键名\r\n     * @param defaultValue 初始值，默认值会被存储并返回直到设置新的值\r\n     * @param options 配置选项，包括存储引擎和过期时间\r\n     */\r\n    constructor(key: string, defaultValue: T, options?: StoreOptions) {\r\n        this.key = key;\r\n        this.value = defaultValue;\r\n\r\n        const { storageEngine = sessionStorage, expires } = options ?? {};\r\n        this.storage = storageEngine;\r\n        this.expires = expires;\r\n\r\n        // 尝试从存储中读取数据\r\n        this.loadFromStorage();\r\n    }\r\n\r\n    /**\r\n     * 生成存储键名\r\n     */\r\n    private getStorageKey(): string {\r\n        return `@${prefix}_${this.key}`.toLocaleUpperCase();\r\n    }\r\n\r\n    /**\r\n     * 从存储中加载数据\r\n     */\r\n    private loadFromStorage(): void {\r\n        try {\r\n            const storedValue = this.storage.getItem(this.getStorageKey());\r\n            if (!storedValue) {\r\n                return;\r\n            }\r\n\r\n            const { data, expiry } = JSON.parse(storedValue) as StorageData<T>;\r\n\r\n            // 检查是否过期\r\n            if (!expiry || expiry > Date.now()) {\r\n                this.value = data;\r\n            } else {\r\n                // 过期则删除\r\n                this.clear();\r\n            }\r\n        } catch (error) {\r\n            console.error(`从存储中读取数据失败 (key: ${this.getStorageKey()}):`, error);\r\n            // 数据损坏时清除\r\n            this.clear();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 获取当前缓存的值\r\n     * @returns 缓存的值\r\n     */\r\n    get(): T {\r\n        return this.value;\r\n    }\r\n\r\n    /**\r\n     * 设置新的缓存值\r\n     * @param newValue 新的值\r\n     */\r\n    set(newValue: T): void {\r\n        this.value = newValue;\r\n\r\n        try {\r\n            const storageData: StorageData<T> = {\r\n                data: newValue,\r\n                expiry: this.expires ? Date.now() + this.expires : null,\r\n            };\r\n            this.storage.setItem(this.getStorageKey(), JSON.stringify(storageData));\r\n        } catch (error) {\r\n            console.error(`存储数据失败 (key: ${this.getStorageKey()}):`, error);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 使用提供的函数更新缓存的值\r\n     * @param updateFn 一个接受当前值并返回新值的函数\r\n     *\r\n     * @example\r\n     * const countStore = new Store<number>('count', 0);\r\n     * countStore.update(count => count + 1);\r\n     */\r\n    update(updateFn: (currentValue: T) => T): void {\r\n        if (typeof updateFn === 'function') {\r\n            this.set(updateFn(this.value));\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 清除缓存数据\r\n     */\r\n    clear(): void {\r\n        try {\r\n            this.storage.removeItem(this.getStorageKey());\r\n        } catch (error) {\r\n            console.error(`清除存储数据失败 (key: ${this.getStorageKey()}):`, error);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * 检查缓存是否存在且未过期\r\n     * @returns 如果缓存存在且未过期返回 true，否则返回 false\r\n     */\r\n    has(): boolean {\r\n        try {\r\n            const storedValue = this.storage.getItem(this.getStorageKey());\r\n            if (!storedValue) {\r\n                return false;\r\n            }\r\n\r\n            const { expiry } = JSON.parse(storedValue) as StorageData<T>;\r\n            return !expiry || expiry > Date.now();\r\n        } catch {\r\n            return false;\r\n        }\r\n    }\r\n}\r\n","/**\r\n * 深克隆一个对象或数组\r\n *\r\n * 该函数通过递归方式深克隆输入的对象或数组，确保与原对象或数组隔离，不会相互影响。\r\n * 支持克隆：普通对象、数组、Date、Map、Set、RegExp 等类型。\r\n *\r\n * @param source 需要克隆的源对象或数组\r\n * @returns 返回克隆后的对象或数组\r\n *\r\n * @example\r\n * const obj = { a: 1, b: { c: 2 } };\r\n * const cloned = deepClone(obj);\r\n * cloned.b.c = 3;\r\n * console.log(obj.b.c); // 输出: 2\r\n */\r\nexport function deepClone<T>(source: T): T {\r\n    // 处理 null 和基本类型\r\n    if (source === null || typeof source !== 'object') {\r\n        return source;\r\n    }\r\n\r\n    // 处理 Date 对象\r\n    if (source instanceof Date) {\r\n        return new Date(source.getTime()) as unknown as T;\r\n    }\r\n\r\n    // 处理 RegExp 对象\r\n    if (source instanceof RegExp) {\r\n        return new RegExp(source.source, source.flags) as unknown as T;\r\n    }\r\n\r\n    // 处理 Map 对象\r\n    if (source instanceof Map) {\r\n        const clonedMap = new Map();\r\n        source.forEach((value, key) => {\r\n            clonedMap.set(deepClone(key), deepClone(value));\r\n        });\r\n        return clonedMap as unknown as T;\r\n    }\r\n\r\n    // 处理 Set 对象\r\n    if (source instanceof Set) {\r\n        const clonedSet = new Set();\r\n        source.forEach((value) => {\r\n            clonedSet.add(deepClone(value));\r\n        });\r\n        return clonedSet as unknown as T;\r\n    }\r\n\r\n    // 处理数组\r\n    if (Array.isArray(source)) {\r\n        return source.map((item) => deepClone(item)) as unknown as T;\r\n    }\r\n\r\n    // 处理普通对象\r\n    if (Object.prototype.toString.call(source) === '[object Object]') {\r\n        const clonedObject = {} as T;\r\n        Object.keys(source).forEach((key) => {\r\n            (clonedObject as any)[key] = deepClone((source as any)[key]);\r\n        });\r\n        return clonedObject;\r\n    }\r\n\r\n    // 其他类型直接返回（如函数、Symbol 等）\r\n    return source;\r\n}\r\n","import { Observable } from 'rxjs';\r\nimport { debounceTime } from 'rxjs/operators';\r\n\r\n/**\r\n * 监听元素大小变化的配置选项\r\n */\r\nexport interface ObserveResizeOptions {\r\n    /**\r\n     * 防抖延迟时间（毫秒）\r\n     * 设置后会对频繁的大小变化事件进行防抖处理\r\n     * @default undefined (不防抖)\r\n     */\r\n    debounce?: number;\r\n}\r\n\r\n/**\r\n * 监听元素的大小变化\r\n *\r\n * 此函数创建了一个 Observable，用于观察给定 HTMLElement 元素的大小变化。\r\n * 它使用了 ResizeObserver API 来实现，当元素的大小发生变化时，会发出一个包含变化记录的数组。\r\n *\r\n * @param element 需要观察大小变化的 HTMLElement 元素\r\n * @param options 配置选项\r\n * @returns 返回一个 Observable，其中包含 ResizeObserverEntry 的数组，用于记录每次大小变化的信息\r\n *\r\n * @example\r\n * // 基础用法\r\n * const element = document.querySelector('.container');\r\n * observeResize(element).subscribe(entries => {\r\n *   const { width, height } = entries[0].contentRect;\r\n *   console.log(`元素尺寸: ${width}x${height}`);\r\n * });\r\n *\r\n * @example\r\n * // 使用防抖优化性能\r\n * observeResize(element, { debounce: 300 }).subscribe(entries => {\r\n *   // 300ms 内的多次变化只会触发一次\r\n *   console.log('元素大小已稳定');\r\n * });\r\n */\r\nexport function observeResize(element: HTMLElement, options?: ObserveResizeOptions): Observable<ResizeObserverEntry[]> {\r\n    const { debounce } = options || {};\r\n\r\n    const resize$ = new Observable<ResizeObserverEntry[]>((observer) => {\r\n        // 创建 ResizeObserver 实例，当观察的目标元素大小发生变化时，会调用回调函数\r\n        const resizeObserver = new ResizeObserver((entries) => {\r\n            observer.next(entries);\r\n        });\r\n\r\n        // 开始观察指定的元素\r\n        resizeObserver.observe(element);\r\n\r\n        // 返回清理函数，用于在取消订阅时调用\r\n        return () => {\r\n            resizeObserver.unobserve(element);\r\n            resizeObserver.disconnect();\r\n        };\r\n    });\r\n\r\n    // 如果设置了防抖，则应用防抖操作符\r\n    return debounce ? resize$.pipe(debounceTime(debounce)) : resize$;\r\n}\r\n","import { FormGroup } from '@angular/forms';\r\n\r\n/**\r\n * 表单验证配置\r\n */\r\nexport interface FormVerifyOptions {\r\n    /**\r\n     * 是否在控制台输出错误信息\r\n     * @default true\r\n     */\r\n    logError?: boolean;\r\n    /**\r\n     * 自定义错误处理函数\r\n     */\r\n    onError?: (invalidFields: string[]) => void;\r\n}\r\n\r\n/**\r\n * 表单验证\r\n *\r\n * 遍历表单所有控件，标记为脏状态并触发验证。\r\n * 如果表单验证通过，返回表单的原始值；否则返回 false。\r\n *\r\n * @param form Angular 表单组对象\r\n * @param options 验证配置选项\r\n * @returns 验证通过返回表单值，验证失败返回 false\r\n *\r\n * @example\r\n * const result = formVerify(this.form);\r\n * if (result) {\r\n *   console.log('表单数据:', result);\r\n * }\r\n *\r\n * @example\r\n * // 自定义错误处理\r\n * formVerify(this.form, {\r\n *   logError: false,\r\n *   onError: (fields) => {\r\n *     this.message.error(`以下字段验证失败: ${fields.join(', ')}`);\r\n *   }\r\n * });\r\n */\r\nexport function formVerify<T = Record<string, any>>(form: FormGroup, options?: FormVerifyOptions): false | T {\r\n    const { logError = true, onError } = options || {};\r\n    const invalidFields: string[] = [];\r\n\r\n    // 遍历所有控件，标记为脏状态并更新验证状态\r\n    Object.keys(form.controls).forEach((key) => {\r\n        const control = form.controls[key];\r\n        control.markAsDirty();\r\n        control.updateValueAndValidity();\r\n\r\n        // 收集验证失败的字段（排除禁用状态）\r\n        if (control.status !== 'VALID' && control.status !== 'DISABLED') {\r\n            invalidFields.push(key);\r\n        }\r\n    });\r\n\r\n    // 表单验证失败（排除全部禁用的情况）\r\n    if (form.status !== 'VALID' && form.status !== 'DISABLED') {\r\n        if (logError) {\r\n            console.error(`表单验证失败，字段: ${invalidFields.join(', ')}`);\r\n        }\r\n        if (onError) {\r\n            onError(invalidFields);\r\n        }\r\n        return false;\r\n    }\r\n\r\n    // 验证通过，返回表单原始值（包含禁用字段）\r\n    return form.getRawValue();\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":["Observable","debounceTime"],"mappings":"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"}

package/directives/auth.directive.d.ts

@@ -1,25 +1,72 @@
 import { OnDestroy, TemplateRef, ViewContainerRef } from '@angular/core';
 import { RkMenuService } from '@reskin/core/services';
 import * as i0 from "@angular/core";
+/**
+ * 权限指令上下文
+ */
+export interface RkAuthContext<T = any> {
+    /** 隐式上下文，包含匹配的菜单数据 */
+    $implicit: T;
+    /** 权限验证状态 */
+    status: boolean;
+}
+/**
+ * 权限指令
+ * 根据权限标识符控制模板的显示与隐藏
+ *
+ * @example
+ * ```html
+ * <!-- 基础用法 -->
+ * <div *rkAuth="'user:edit'">有编辑权限才显示</div>
+ *
+ * <!-- 多个权限（或关系） -->
+ * <div *rkAuth="['user:edit', 'user:delete']">有任一权限即显示</div>
+ *
+ * <!-- 使用 then/else 模板 -->
+ * <ng-container *rkAuth="'user:edit'; then hasAuth; else noAuth"></ng-container>
+ * <ng-template #hasAuth let-menu>
+ *   <p>有权限，菜单信息：{{ menu | json }}</p>
+ * </ng-template>
+ * <ng-template #noAuth>
+ *   <p>无权限</p>
+ * </ng-template>
+ * ```
+ */
 export declare class RkAuthDirective implements OnDestroy {
-    private menu;
+    private menuService;
     private viewContainerRef;
     templateRef: TemplateRef<any>;
+    private condition;
+    private thenTemplateRef?;
+    private elseTemplateRef?;
+    private readonly destroy$;
     /**
-     * 传递多个标识符时，逗号分隔，匹配按"或者"运算
-     * @param condition
+     * 权限标识符
+     * 传递多个标识符时，匹配按"或"运算
      */
     set rkAuth(condition: string | string[]);
+    /**
+     * 有权限时显示的模板
+     */
     set rkAuthThen(templateRef: TemplateRef<any>);
+    /**
+     * 无权限时显示的模板
+     */
     set rkAuthElse(templateRef: TemplateRef<any>);
-    constructor(menu: RkMenuService, viewContainerRef: ViewContainerRef, templateRef: TemplateRef<any>);
-    private condition;
-    private thenTemplateRef?;
-    private elseTemplateRef?;
-    private authSubscription?;
+    constructor(menuService: RkMenuService, viewContainerRef: ViewContainerRef, templateRef: TemplateRef<any>);
     ngOnDestroy(): void;
+    /**
+     * 更新视图显示
+     */
     private updateView;
-    private hasAuth;
+    /**
+     * 渲染视图
+     */
+    private renderView;
+    /**
+     * 检查权限
+     */
+    private checkAuth;
     static ɵfac: i0.ɵɵFactoryDeclaration<RkAuthDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<RkAuthDirective, "[rkAuth]", never, { "rkAuth": "rkAuth"; "rkAuthThen": "rkAuthThen"; "rkAuthElse": "rkAuthElse"; }, {}, never>;
 }

package/directives/load.styles.directive.d.ts

@@ -1,15 +1,55 @@
 import { OnInit, OnDestroy, EventEmitter } from '@angular/core';
 import { ILoadResult, RkStyleLoaderService } from '@reskin/core/services';
 import * as i0 from "@angular/core";
+/**
+ * 样式按需加载指令
+ * 在指令初始化时加载指定的样式文件，销毁时自动卸载
+ *
+ * @example
+ * ```html
+ * <!-- 加载单个样式 -->
+ * <div [rkLoadStyles]="'assets/styles/theme.css'">内容</div>
+ *
+ * <!-- 加载多个样式 -->
+ * <div [rkLoadStyles]="['assets/styles/theme.css', 'assets/styles/components.css']">内容</div>
+ *
+ * <!-- 监听加载完成事件 -->
+ * <div [rkLoadStyles]="styleUrls" (stylesLoaded)="onLoaded($event)">内容</div>
+ * ```
+ */
 export declare class RkLoadStylesDirective implements OnInit, OnDestroy {
-    private styleLoader;
-    hrefs: string[] | string;
-    stylesLoaded: EventEmitter<ILoadResult[]>;
-    private subscription;
+    private styleLoaderService;
+    private readonly destroy$;
     private styleUrls;
-    constructor(styleLoader: RkStyleLoaderService);
+    /**
+     * 样式文件路径
+     * 可以是单个路径字符串或路径数组
+     */
+    hrefs: string | string[];
+    /**
+     * 样式加载完成事件
+     * 返回每个样式文件的加载结果
+     */
+    stylesLoaded: EventEmitter<ILoadResult[]>;
+    constructor(styleLoaderService: RkStyleLoaderService);
     ngOnInit(): void;
     ngOnDestroy(): void;
+    /**
+     * 加载样式文件
+     */
+    private loadStyles;
+    /**
+     * 卸载样式文件
+     */
+    private unloadStyles;
+    /**
+     * 标准化 hrefs 输入为数组
+     */
+    private normalizeHrefs;
+    /**
+     * 记录加载结果（仅在开发模式）
+     */
+    private logLoadResults;
     static ɵfac: i0.ɵɵFactoryDeclaration<RkLoadStylesDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<RkLoadStylesDirective, "[rkLoadStyles]", never, { "hrefs": "rkLoadStyles"; }, { "stylesLoaded": "stylesLoaded"; }, never>;
 }