@composy/store-core 0.0.1

package/es/utils/debounce-throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce-throttle.js","names":[],"sources":["../../src/utils/debounce-throttle.ts"],"sourcesContent":["/**\n * 防抖和节流工具函数\n *\n * 提供性能优化的防抖、节流功能\n * @module utils/debounce-throttle\n */\n\n/**\n * 防抖函数返回类型\n */\nexport interface DebouncedFunction<T extends (...args: never[]) => void> {\n  (...args: Parameters<T>): void\n  /** 取消待执行的调用 */\n  cancel: () => void\n  /** 立即执行待处理的调用 */\n  flush: () => void\n  /** 是否有待处理的调用 */\n  pending: () => boolean\n}\n\n/**\n * 节流函数返回类型\n */\nexport interface ThrottledFunction<T extends (...args: never[]) => void> {\n  (...args: Parameters<T>): void\n  /** 取消待执行的调用 */\n  cancel: () => void\n}\n\n/**\n * 创建防抖函数\n *\n * 在连续调用停止后，延迟指定时间执行函数\n *\n * @template T - 函数类型\n * @param fn - 需要防抖的函数\n * @param delay - 延迟时间（毫秒）\n * @param immediate - 是否在首次调用时立即执行\n * @returns 防抖后的函数\n *\n * @example\n * ```typescript\n * const debouncedSearch = debounce((query: string) => {\n *   fetchResults(query)\n * }, 300)\n *\n * // 连续调用只会在最后一次调用后 300ms 执行\n * debouncedSearch('a')\n * debouncedSearch('ab')\n * debouncedSearch('abc') // 只有这次会触发\n *\n * // 取消待执行的调用\n * debouncedSearch.cancel()\n * ```\n */\nexport function debounce<T extends (...args: never[]) => void>(\n  fn: T,\n  delay: number,\n  immediate = false,\n): DebouncedFunction<T> {\n  let timer: ReturnType<typeof setTimeout> | null = null\n  let lastArgs: Parameters<T> | null = null\n\n  const debounced = ((...args: Parameters<T>) => {\n    lastArgs = args\n\n    if (timer) {\n      clearTimeout(timer)\n    }\n\n    if (immediate && !timer) {\n      fn(...args)\n      timer = setTimeout(() => {\n        timer = null\n        lastArgs = null\n      }, delay)\n    }\n    else {\n      timer = setTimeout(() => {\n        fn(...args)\n        timer = null\n        lastArgs = null\n      }, delay)\n    }\n  }) as DebouncedFunction<T>\n\n  debounced.cancel = () => {\n    if (timer) {\n      clearTimeout(timer)\n      timer = null\n      lastArgs = null\n    }\n  }\n\n  debounced.flush = () => {\n    if (timer && lastArgs) {\n      clearTimeout(timer)\n      fn(...lastArgs)\n      timer = null\n      lastArgs = null\n    }\n  }\n\n  debounced.pending = () => timer !== null\n\n  return debounced\n}\n\n/**\n * 创建节流函数\n *\n * 在指定时间间隔内最多执行一次函数\n *\n * @template T - 函数类型\n * @param fn - 需要节流的函数\n * @param interval - 间隔时间（毫秒）\n * @param options - 节流选项\n * @param options.leading - 是否在时间窗开始时立即执行\n * @param options.trailing - 是否在时间窗结束时补执行最后一次调用\n * @returns 节流后的函数\n *\n * @example\n * ```typescript\n * const throttledUpdate = throttle((x: number, y: number) => {\n *   updatePosition(x, y)\n * }, 100)\n *\n * // 在 100ms 内多次调用，只会执行一次\n * window.addEventListener('mousemove', (e) => {\n *   throttledUpdate(e.clientX, e.clientY)\n * })\n *\n * // 取消\n * throttledUpdate.cancel()\n * ```\n */\nexport function throttle<T extends (...args: never[]) => void>(\n  fn: T,\n  interval: number,\n  options: { leading?: boolean, trailing?: boolean } = {},\n): ThrottledFunction<T> {\n  const { leading = true, trailing = true } = options\n  let timer: ReturnType<typeof setTimeout> | null = null\n  let lastTime = 0\n  let lastArgs: Parameters<T> | null = null\n\n  const throttled = ((...args: Parameters<T>) => {\n    const now = Date.now()\n    const remaining = interval - (now - lastTime)\n\n    lastArgs = args\n\n    if (remaining <= 0 || remaining > interval) {\n      if (timer) {\n        clearTimeout(timer)\n        timer = null\n      }\n      lastTime = now\n      if (leading || lastTime !== 0) {\n        fn(...args)\n      }\n      lastArgs = null\n    }\n    else if (!timer && trailing) {\n      timer = setTimeout(() => {\n        lastTime = trailing ? Date.now() : 0\n        timer = null\n        if (lastArgs) {\n          fn(...lastArgs)\n          lastArgs = null\n        }\n      }, remaining)\n    }\n  }) as ThrottledFunction<T>\n\n  throttled.cancel = () => {\n    if (timer) {\n      clearTimeout(timer)\n      timer = null\n    }\n    lastTime = 0\n    lastArgs = null\n  }\n\n  return throttled\n}\n"],"mappings":";;;;;;;;;;AAuDO,SAAS,SACd,IACA,OACA,YAAY,OACU;CACtB,IAAI,QAA8C;CAClD,IAAI,WAAiC;CAErC,MAAM,cAAa,GAAI,SAAwB;EAC7C,WAAW;EAEX,IAAI,OACF,aAAa,KAAK;EAGpB,IAAI,aAAa,CAAC,OAAO;GACvB,GAAG,GAAG,IAAI;GACV,QAAQ,iBAAiB;IACvB,QAAQ;IACR,WAAW;GACb,GAAG,KAAK;EACV,OAEE,QAAQ,iBAAiB;GACvB,GAAG,GAAG,IAAI;GACV,QAAQ;GACR,WAAW;EACb,GAAG,KAAK;CAEZ;CAEA,UAAU,eAAe;EACvB,IAAI,OAAO;GACT,aAAa,KAAK;GAClB,QAAQ;GACR,WAAW;EACb;CACF;CAEA,UAAU,cAAc;EACtB,IAAI,SAAS,UAAU;GACrB,aAAa,KAAK;GAClB,GAAG,GAAG,QAAQ;GACd,QAAQ;GACR,WAAW;EACb;CACF;CAEA,UAAU,gBAAgB,UAAU;CAEpC,OAAO;AACT;AA8BO,SAAS,SACd,IACA,UACA,UAAqD,CAAC,GAChC;CACtB,MAAM,EAAE,UAAU,MAAM,WAAW,SAAS;CAC5C,IAAI,QAA8C;CAClD,IAAI,WAAW;CACf,IAAI,WAAiC;CAErC,MAAM,cAAa,GAAI,SAAwB;EAC7C,MAAM,MAAM,KAAK,IAAI;EACrB,MAAM,YAAY,YAAY,MAAM;EAEpC,WAAW;EAEX,IAAI,aAAa,KAAK,YAAY,UAAU;GAC1C,IAAI,OAAO;IACT,aAAa,KAAK;IAClB,QAAQ;GACV;GACA,WAAW;GACX,IAAI,WAAW,aAAa,GAC1B,GAAG,GAAG,IAAI;GAEZ,WAAW;EACb,OAAA,IACS,CAAC,SAAS,UACjB,QAAQ,iBAAiB;GACvB,WAAW,WAAW,KAAK,IAAI,IAAI;GACnC,QAAQ;GACR,IAAI,UAAU;IACZ,GAAG,GAAG,QAAQ;IACd,WAAW;GACb;EACF,GAAG,SAAS;CAEhB;CAEA,UAAU,eAAe;EACvB,IAAI,OAAO;GACT,aAAa,KAAK;GAClB,QAAQ;EACV;EACA,WAAW;EACX,WAAW;CACb;CAEA,OAAO;AACT"}

package/es/utils/deep-clone.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 深拷贝工具
+ *
+ * 提供高性能的深拷贝、浅拷贝和深度合并功能
+ * @module utils/deep-clone
+ */
+/**
+ * 判断是否为对象
+ *
+ * @param value - 待检查的值
+ * @returns 是否为对象
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * 判断是否为普通对象（非数组、非内置对象）
+ *
+ * @param value - 待检查的值
+ * @returns 是否为普通对象
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * 深拷贝配置选项
+ */
+export interface DeepCloneOptions {
+    /** 是否优先使用 structuredClone（默认 true） */
+    useStructuredClone?: boolean;
+    /** 是否克隆函数（默认 false，函数保持引用） */
+    cloneFunctions?: boolean;
+    /** 是否克隆 Symbol 属性（默认 false） */
+    cloneSymbols?: boolean;
+    /** 最大深度（默认无限制） */
+    maxDepth?: number;
+    /** 自定义克隆器 */
+    customCloner?: <T>(value: T, clone: <U>(v: U) => U) => T | undefined;
+}
+/**
+ * 深拷贝
+ *
+ * 高性能深拷贝实现，优先使用原生 structuredClone（如果可用）
+ *
+ * @template T - 值类型
+ * @param value - 要拷贝的值
+ * @param options - 配置选项
+ * @returns 拷贝后的值
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: { c: 2 } }
+ * const cloned = deepClone(obj)
+ * cloned.b.c = 3
+ * console.log(obj.b.c) // 2
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // 带配置的深拷贝
+ * const cloned = deepClone(obj, {
+ *   maxDepth: 5,
+ *   cloneSymbols: true
+ * })
+ * ```
+ */
+export declare function deepClone<T>(value: T, options?: DeepCloneOptions): T;
+/**
+ * 浅拷贝
+ *
+ * @template T - 值类型
+ * @param value - 要拷贝的值
+ * @returns 拷贝后的值
+ *
+ * @example
+ * ```typescript
+ * const arr = [1, 2, { a: 3 }]
+ * const cloned = shallowClone(arr)
+ * cloned[2].a = 4
+ * console.log(arr[2].a) // 4 (浅拷贝，嵌套对象共享引用)
+ * ```
+ */
+export declare function shallowClone<T>(value: T): T;
+/**
+ * 深度合并配置选项
+ */
+export interface DeepMergeOptions {
+    /** 数组合并策略：'replace' 替换 | 'concat' 连接 | 'merge' 按索引合并 */
+    arrayStrategy?: 'replace' | 'concat' | 'merge';
+    /** 是否克隆源对象（默认 true） */
+    clone?: boolean;
+    /** 最大深度 */
+    maxDepth?: number;
+}
+/**
+ * 深度合并对象
+ *
+ * 将多个源对象深度合并到目标对象
+ *
+ * @template T - 目标对象类型
+ * @param target - 目标对象
+ * @param sources - 源对象列表
+ * @returns 合并后的对象
+ *
+ * @example
+ * ```typescript
+ * const target = { a: 1, b: { c: 2 } }
+ * const source = { b: { d: 3 }, e: 4 }
+ * const result = deepMerge(target, source)
+ * // { a: 1, b: { c: 2, d: 3 }, e: 4 }
+ * ```
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Array<Partial<T>>): T;
+/**
+ * 带配置的深度合并
+ *
+ * @template T - 目标对象类型
+ * @param target - 目标对象
+ * @param options - 合并配置
+ * @param sources - 源对象列表
+ * @returns 合并后的对象
+ */
+export declare function deepMergeWithOptions<T extends Record<string, unknown>>(target: T, options: DeepMergeOptions, ...sources: Array<Partial<T>>): T;
+/**
+ * 比较两个值是否深度相等
+ *
+ * @param a - 第一个值
+ * @param b - 第二个值
+ * @returns 是否相等
+ *
+ * @example
+ * ```typescript
+ * deepEqual({ a: 1 }, { a: 1 }) // true
+ * deepEqual([1, 2], [1, 2]) // true
+ * deepEqual({ a: { b: 1 } }, { a: { b: 2 } }) // false
+ * ```
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * 冻结对象（深度）
+ *
+ * @template T - 对象类型
+ * @param obj - 要冻结的对象
+ * @returns 冻结后的对象
+ */
+export declare function deepFreeze<T extends object>(obj: T): Readonly<T>;
+//# sourceMappingURL=deep-clone.d.ts.map

package/es/utils/deep-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-clone.d.ts","sourceRoot":"","sources":["../../src/utils/deep-clone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAmCD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,8BAA8B;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa;IACb,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;CACrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,CAAC,CAiJxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAqB3C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,aAAa,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC9C,uBAAuB;IACvB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,CAAC,EACT,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5B,CAAC,CAEH;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,gBAAgB,EACzB,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5B,CAAC,CAwEH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAmEzD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAWhE"}

package/es/utils/deep-clone.js

@@ -0,0 +1,193 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+//#region src/utils/deep-clone.ts
+const hasOwnProperty = Object.prototype.hasOwnProperty;
+function hasOwnKey(value, key) {
+	return hasOwnProperty.call(value, key);
+}
+function isObject(value) {
+	return value !== null && typeof value === "object";
+}
+function isPlainObject(value) {
+	if (!isObject(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === null || proto === Object.prototype;
+}
+function isStructuredCloneable(value) {
+	if (value === null || value === void 0) return true;
+	if (typeof value === "boolean" || typeof value === "number" || typeof value === "string") return true;
+	if (typeof value === "bigint") return true;
+	if (typeof value === "function" || typeof value === "symbol") return false;
+	if (value instanceof Date || value instanceof RegExp) return true;
+	if (value instanceof ArrayBuffer || value instanceof DataView) return true;
+	if (value instanceof Map || value instanceof Set) return true;
+	if (ArrayBuffer.isView(value)) return true;
+	if (Array.isArray(value)) return value.every((item) => isStructuredCloneable(item));
+	if (isPlainObject(value)) return Object.values(value).every((v) => isStructuredCloneable(v));
+	return false;
+}
+function deepClone(value, options = {}) {
+	const { useStructuredClone: preferStructuredClone = true, cloneFunctions = false, cloneSymbols = false, maxDepth = Infinity, customCloner } = options;
+	if (preferStructuredClone && typeof structuredClone === "function" && isStructuredCloneable(value)) try {
+		return structuredClone(value);
+	} catch {}
+	const cache = /* @__PURE__ */ new WeakMap();
+	function cloneInternal(val, depth) {
+		if (val === null || val === void 0) return val;
+		if (typeof val === "boolean" || typeof val === "number" || typeof val === "string") return val;
+		if (typeof val === "bigint") return val;
+		if (typeof val === "symbol") return cloneSymbols ? Symbol(val.description) : val;
+		if (typeof val === "function") return cloneFunctions ? val.bind({}) : val;
+		if (depth > maxDepth) return val;
+		if (customCloner) {
+			const customResult = customCloner(val, (v) => cloneInternal(v, depth + 1));
+			if (customResult !== void 0) return customResult;
+		}
+		if (typeof val === "object" && val !== null) {
+			if (cache.has(val)) return cache.get(val);
+		}
+		if (val instanceof Date) return new Date(val.getTime());
+		if (val instanceof RegExp) {
+			const result = new RegExp(val.source, val.flags);
+			result.lastIndex = val.lastIndex;
+			return result;
+		}
+		if (val instanceof Error) {
+			const result = new val.constructor(val.message);
+			result.stack = val.stack;
+			result.name = val.name;
+			return result;
+		}
+		if (val instanceof Map) {
+			const result = /* @__PURE__ */ new Map();
+			cache.set(val, result);
+			val.forEach((v, k) => {
+				result.set(cloneInternal(k, depth + 1), cloneInternal(v, depth + 1));
+			});
+			return result;
+		}
+		if (val instanceof Set) {
+			const result = /* @__PURE__ */ new Set();
+			cache.set(val, result);
+			val.forEach((v) => {
+				result.add(cloneInternal(v, depth + 1));
+			});
+			return result;
+		}
+		if (val instanceof ArrayBuffer) return val.slice(0);
+		if (ArrayBuffer.isView(val) && !(val instanceof DataView)) {
+			const TypedArrayConstructor = val.constructor;
+			return new TypedArrayConstructor(val.buffer.slice(0));
+		}
+		if (Array.isArray(val)) {
+			const result = [];
+			cache.set(val, result);
+			for (let i = 0; i < val.length; i++) result[i] = cloneInternal(val[i], depth + 1);
+			return result;
+		}
+		if (isPlainObject(val)) {
+			const result = {};
+			cache.set(val, result);
+			const keys = Object.keys(val);
+			for (const key of keys) result[key] = cloneInternal(val[key], depth + 1);
+			if (cloneSymbols) {
+				const symbolKeys = Object.getOwnPropertySymbols(val);
+				for (const sym of symbolKeys) result[sym] = cloneInternal(val[sym], depth + 1);
+			}
+			return result;
+		}
+		return val;
+	}
+	return cloneInternal(value, 0);
+}
+function shallowClone(value) {
+	if (value === null || value === void 0) return value;
+	if (typeof value !== "object") return value;
+	if (Array.isArray(value)) return [...value];
+	if (value instanceof Map) return new Map(value);
+	if (value instanceof Set) return new Set(value);
+	if (value instanceof Date) return new Date(value.getTime());
+	return { ...value };
+}
+function deepMerge(target, ...sources) {
+	return deepMergeWithOptions(target, {}, ...sources);
+}
+function deepMergeWithOptions(target, options, ...sources) {
+	const { arrayStrategy = "replace", clone = true, maxDepth = Infinity } = options;
+	function mergeInternal(targetObj, sourceObj, depth) {
+		if (depth > maxDepth) return targetObj;
+		for (const key of Object.keys(sourceObj)) {
+			const sourceValue = sourceObj[key];
+			const targetValue = targetObj[key];
+			if (Array.isArray(sourceValue)) if (arrayStrategy === "concat" && Array.isArray(targetValue)) targetObj[key] = [...targetValue, ...sourceValue];
+			else if (arrayStrategy === "merge" && Array.isArray(targetValue)) {
+				const result2 = [...targetValue];
+				sourceValue.forEach((item, index) => {
+					if (isPlainObject(item) && isPlainObject(result2[index])) result2[index] = mergeInternal(result2[index], item, depth + 1);
+					else result2[index] = clone ? deepClone(item) : item;
+				});
+				targetObj[key] = result2;
+			} else targetObj[key] = clone ? deepClone(sourceValue) : sourceValue;
+			else if (isPlainObject(sourceValue)) if (isPlainObject(targetValue)) targetObj[key] = mergeInternal(targetValue, sourceValue, depth + 1);
+			else targetObj[key] = clone ? deepClone(sourceValue) : sourceValue;
+			else targetObj[key] = clone && isObject(sourceValue) ? deepClone(sourceValue) : sourceValue;
+		}
+		return targetObj;
+	}
+	let result = target;
+	for (const source of sources) if (source !== null && source !== void 0) result = mergeInternal(result, source, 0);
+	return result;
+}
+function deepEqual(a, b) {
+	if (a === b) return true;
+	if (a === null || b === null || a === void 0 || b === void 0) return a === b;
+	if (typeof a !== typeof b) return false;
+	if (typeof a !== "object") return a === b;
+	if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();
+	if (a instanceof RegExp && b instanceof RegExp) return a.source === b.source && a.flags === b.flags;
+	if (a instanceof Map && b instanceof Map) {
+		if (a.size !== b.size) return false;
+		for (const [key, value] of a) if (!b.has(key) || !deepEqual(value, b.get(key))) return false;
+		return true;
+	}
+	if (a instanceof Set && b instanceof Set) {
+		if (a.size !== b.size) return false;
+		for (const value of a) if (!b.has(value)) return false;
+		return true;
+	}
+	if (Array.isArray(a) && Array.isArray(b)) {
+		if (a.length !== b.length) return false;
+		for (let i = 0; i < a.length; i++) if (!deepEqual(a[i], b[i])) return false;
+		return true;
+	}
+	if (isPlainObject(a) && isPlainObject(b)) {
+		const keysA = Object.keys(a);
+		const keysB = Object.keys(b);
+		if (keysA.length !== keysB.length) return false;
+		for (const key of keysA) {
+			if (!hasOwnKey(b, key)) return false;
+			if (!deepEqual(a[key], b[key])) return false;
+		}
+		return true;
+	}
+	return false;
+}
+function deepFreeze(obj) {
+	const propNames = Object.getOwnPropertyNames(obj);
+	for (const name of propNames) {
+		const value = obj[name];
+		if (value && typeof value === "object") deepFreeze(value);
+	}
+	return Object.freeze(obj);
+}
+//#endregion
+export { deepClone, deepEqual, deepFreeze, deepMerge, deepMergeWithOptions, isObject, isPlainObject, shallowClone };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=deep-clone.js.map

package/es/utils/deep-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-clone.js","names":["result"],"sources":["../../src/utils/deep-clone.ts"],"sourcesContent":["/**\n * 深拷贝工具\n *\n * 提供高性能的深拷贝、浅拷贝和深度合并功能\n * @module utils/deep-clone\n */\n\nconst hasOwnProperty = Object.prototype.hasOwnProperty\n\nfunction hasOwnKey(value: object, key: PropertyKey): boolean {\n  return hasOwnProperty.call(value, key)\n}\n\n/**\n * 判断是否为对象\n *\n * @param value - 待检查的值\n * @returns 是否为对象\n */\nexport function isObject(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object'\n}\n\n/**\n * 判断是否为普通对象（非数组、非内置对象）\n *\n * @param value - 待检查的值\n * @returns 是否为普通对象\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (!isObject(value)) return false\n  const proto = Object.getPrototypeOf(value)\n  return proto === null || proto === Object.prototype\n}\n\n/**\n * 判断值是否可以被 structuredClone 处理\n *\n * @param value - 待检查的值\n * @returns 是否可以使用 structuredClone\n */\nfunction isStructuredCloneable(value: unknown): boolean {\n  // 基础类型\n  if (value === null || value === undefined) return true\n  if (typeof value === 'boolean' || typeof value === 'number' || typeof value === 'string') return true\n  if (typeof value === 'bigint') return true\n\n  // 函数和 Symbol 不可克隆\n  if (typeof value === 'function' || typeof value === 'symbol') return false\n\n  // 内置可克隆对象\n  if (value instanceof Date || value instanceof RegExp) return true\n  if (value instanceof ArrayBuffer || value instanceof DataView) return true\n  if (value instanceof Map || value instanceof Set) return true\n  if (ArrayBuffer.isView(value)) return true\n\n  // 普通对象和数组递归检查\n  if (Array.isArray(value)) {\n    return value.every(item => isStructuredCloneable(item))\n  }\n\n  if (isPlainObject(value)) {\n    return Object.values(value).every(v => isStructuredCloneable(v))\n  }\n\n  return false\n}\n\n/**\n * 深拷贝配置选项\n */\nexport interface DeepCloneOptions {\n  /** 是否优先使用 structuredClone（默认 true） */\n  useStructuredClone?: boolean\n  /** 是否克隆函数（默认 false，函数保持引用） */\n  cloneFunctions?: boolean\n  /** 是否克隆 Symbol 属性（默认 false） */\n  cloneSymbols?: boolean\n  /** 最大深度（默认无限制） */\n  maxDepth?: number\n  /** 自定义克隆器 */\n  customCloner?: <T>(value: T, clone: <U>(v: U) => U) => T | undefined\n}\n\n/**\n * 深拷贝\n *\n * 高性能深拷贝实现，优先使用原生 structuredClone（如果可用）\n *\n * @template T - 值类型\n * @param value - 要拷贝的值\n * @param options - 配置选项\n * @returns 拷贝后的值\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: { c: 2 } }\n * const cloned = deepClone(obj)\n * cloned.b.c = 3\n * console.log(obj.b.c) // 2\n * ```\n *\n * @example\n * ```typescript\n * // 带配置的深拷贝\n * const cloned = deepClone(obj, {\n *   maxDepth: 5,\n *   cloneSymbols: true\n * })\n * ```\n */\nexport function deepClone<T>(value: T, options: DeepCloneOptions = {}): T {\n  const {\n    useStructuredClone: preferStructuredClone = true,\n    cloneFunctions = false,\n    cloneSymbols = false,\n    maxDepth = Infinity,\n    customCloner,\n  } = options\n\n  // 尝试使用 structuredClone（性能更好）\n  if (preferStructuredClone && typeof structuredClone === 'function' && isStructuredCloneable(value)) {\n    try {\n      return structuredClone(value)\n    }\n    catch {\n      // structuredClone 失败，回退到手动实现\n    }\n  }\n\n  const cache = new WeakMap<object, unknown>()\n\n  function cloneInternal<U>(val: U, depth: number): U {\n    // 基础类型直接返回\n    if (val === null || val === undefined) return val\n    if (typeof val === 'boolean' || typeof val === 'number' || typeof val === 'string') return val\n    if (typeof val === 'bigint') return val\n\n    // Symbol 处理\n    if (typeof val === 'symbol') {\n      return cloneSymbols ? Symbol(val.description) as U : val\n    }\n\n    // 函数处理\n    if (typeof val === 'function') {\n      return cloneFunctions ? (val.bind({}) as U) : val\n    }\n\n    // 深度检查\n    if (depth > maxDepth) {\n      return val\n    }\n\n    // 自定义克隆器\n    if (customCloner) {\n      const customResult = customCloner(val, v => cloneInternal(v, depth + 1))\n      if (customResult !== undefined) {\n        return customResult\n      }\n    }\n\n    // 检查循环引用\n    if (typeof val === 'object' && val !== null) {\n      if (cache.has(val)) {\n        return cache.get(val) as U\n      }\n    }\n\n    // 处理日期\n    if (val instanceof Date) {\n      return new Date(val.getTime()) as U\n    }\n\n    // 处理正则\n    if (val instanceof RegExp) {\n      const result = new RegExp(val.source, val.flags)\n      ;(result as RegExp).lastIndex = val.lastIndex\n      return result as U\n    }\n\n    // 处理 Error\n    if (val instanceof Error) {\n      const result = new (val.constructor as ErrorConstructor)(val.message)\n      result.stack = val.stack\n      result.name = val.name\n      return result as U\n    }\n\n    // 处理 Map\n    if (val instanceof Map) {\n      const result = new Map()\n      cache.set(val, result)\n      val.forEach((v, k) => {\n        result.set(cloneInternal(k, depth + 1), cloneInternal(v, depth + 1))\n      })\n      return result as U\n    }\n\n    // 处理 Set\n    if (val instanceof Set) {\n      const result = new Set()\n      cache.set(val, result)\n      val.forEach((v) => {\n        result.add(cloneInternal(v, depth + 1))\n      })\n      return result as U\n    }\n\n    // 处理 ArrayBuffer\n    if (val instanceof ArrayBuffer) {\n      return val.slice(0) as U\n    }\n\n    // 处理 TypedArray\n    if (ArrayBuffer.isView(val) && !(val instanceof DataView)) {\n      const TypedArrayConstructor = val.constructor as new (buffer: ArrayBuffer) => typeof val\n      return new TypedArrayConstructor((val as unknown as { buffer: ArrayBuffer }).buffer.slice(0)) as U\n    }\n\n    // 处理数组\n    if (Array.isArray(val)) {\n      const result: unknown[] = []\n      cache.set(val, result)\n      for (let i = 0; i < val.length; i++) {\n        result[i] = cloneInternal(val[i], depth + 1)\n      }\n      return result as U\n    }\n\n    // 处理普通对象\n    if (isPlainObject(val)) {\n      const result: Record<string | symbol, unknown> = {}\n      cache.set(val, result)\n\n      // 克隆字符串键\n      const keys = Object.keys(val)\n      for (const key of keys) {\n        result[key] = cloneInternal((val as Record<string, unknown>)[key], depth + 1)\n      }\n\n      // 克隆 Symbol 键\n      if (cloneSymbols) {\n        const symbolKeys = Object.getOwnPropertySymbols(val)\n        for (const sym of symbolKeys) {\n          result[sym] = cloneInternal((val as Record<symbol, unknown>)[sym], depth + 1)\n        }\n      }\n\n      return result as U\n    }\n\n    // 其他对象类型（如自定义类实例）直接返回\n    return val\n  }\n\n  return cloneInternal(value, 0)\n}\n\n/**\n * 浅拷贝\n *\n * @template T - 值类型\n * @param value - 要拷贝的值\n * @returns 拷贝后的值\n *\n * @example\n * ```typescript\n * const arr = [1, 2, { a: 3 }]\n * const cloned = shallowClone(arr)\n * cloned[2].a = 4\n * console.log(arr[2].a) // 4 (浅拷贝，嵌套对象共享引用)\n * ```\n */\nexport function shallowClone<T>(value: T): T {\n  if (value === null || value === undefined) return value\n  if (typeof value !== 'object') return value\n\n  if (Array.isArray(value)) {\n    return [...value] as T\n  }\n\n  if (value instanceof Map) {\n    return new Map(value) as T\n  }\n\n  if (value instanceof Set) {\n    return new Set(value) as T\n  }\n\n  if (value instanceof Date) {\n    return new Date(value.getTime()) as T\n  }\n\n  return { ...value }\n}\n\n/**\n * 深度合并配置选项\n */\nexport interface DeepMergeOptions {\n  /** 数组合并策略：'replace' 替换 | 'concat' 连接 | 'merge' 按索引合并 */\n  arrayStrategy?: 'replace' | 'concat' | 'merge'\n  /** 是否克隆源对象（默认 true） */\n  clone?: boolean\n  /** 最大深度 */\n  maxDepth?: number\n}\n\n/**\n * 深度合并对象\n *\n * 将多个源对象深度合并到目标对象\n *\n * @template T - 目标对象类型\n * @param target - 目标对象\n * @param sources - 源对象列表\n * @returns 合并后的对象\n *\n * @example\n * ```typescript\n * const target = { a: 1, b: { c: 2 } }\n * const source = { b: { d: 3 }, e: 4 }\n * const result = deepMerge(target, source)\n * // { a: 1, b: { c: 2, d: 3 }, e: 4 }\n * ```\n */\nexport function deepMerge<T extends Record<string, unknown>>(\n  target: T,\n  ...sources: Array<Partial<T>>\n): T {\n  return deepMergeWithOptions(target, {}, ...sources)\n}\n\n/**\n * 带配置的深度合并\n *\n * @template T - 目标对象类型\n * @param target - 目标对象\n * @param options - 合并配置\n * @param sources - 源对象列表\n * @returns 合并后的对象\n */\nexport function deepMergeWithOptions<T extends Record<string, unknown>>(\n  target: T,\n  options: DeepMergeOptions,\n  ...sources: Array<Partial<T>>\n): T {\n  const {\n    arrayStrategy = 'replace',\n    clone = true,\n    maxDepth = Infinity,\n  } = options\n\n  function mergeInternal(\n    targetObj: Record<string, unknown>,\n    sourceObj: Record<string, unknown>,\n    depth: number,\n  ): Record<string, unknown> {\n    if (depth > maxDepth) {\n      return targetObj\n    }\n\n    for (const key of Object.keys(sourceObj)) {\n      const sourceValue = sourceObj[key]\n      const targetValue = targetObj[key]\n\n      // 处理数组\n      if (Array.isArray(sourceValue)) {\n        if (arrayStrategy === 'concat' && Array.isArray(targetValue)) {\n          targetObj[key] = [...targetValue, ...sourceValue]\n        }\n        else if (arrayStrategy === 'merge' && Array.isArray(targetValue)) {\n          const result = [...targetValue]\n          sourceValue.forEach((item, index) => {\n            if (isPlainObject(item) && isPlainObject(result[index])) {\n              result[index] = mergeInternal(result[index] as Record<string, unknown>, item, depth + 1)\n            }\n            else {\n              result[index] = clone ? deepClone(item) : item\n            }\n          })\n          targetObj[key] = result\n        }\n        else {\n          targetObj[key] = clone ? deepClone(sourceValue) : sourceValue\n        }\n      }\n      // 处理普通对象\n      else if (isPlainObject(sourceValue)) {\n        if (isPlainObject(targetValue)) {\n          targetObj[key] = mergeInternal(\n            targetValue as Record<string, unknown>,\n            sourceValue,\n            depth + 1,\n          )\n        }\n        else {\n          targetObj[key] = clone ? deepClone(sourceValue) : sourceValue\n        }\n      }\n      // 其他类型直接赋值\n      else {\n        targetObj[key] = clone && isObject(sourceValue) ? deepClone(sourceValue) : sourceValue\n      }\n    }\n\n    return targetObj\n  }\n\n  let result = target\n\n  for (const source of sources) {\n    if (source !== null && source !== undefined) {\n      result = mergeInternal(result, source, 0) as T\n    }\n  }\n\n  return result\n}\n\n/**\n * 比较两个值是否深度相等\n *\n * @param a - 第一个值\n * @param b - 第二个值\n * @returns 是否相等\n *\n * @example\n * ```typescript\n * deepEqual({ a: 1 }, { a: 1 }) // true\n * deepEqual([1, 2], [1, 2]) // true\n * deepEqual({ a: { b: 1 } }, { a: { b: 2 } }) // false\n * ```\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n  // 严格相等\n  if (a === b) return true\n\n  // null/undefined 检查\n  if (a === null || b === null || a === undefined || b === undefined) {\n    return a === b\n  }\n\n  // 类型不同\n  if (typeof a !== typeof b) return false\n\n  // 基础类型\n  if (typeof a !== 'object') return a === b\n\n  // 日期比较\n  if (a instanceof Date && b instanceof Date) {\n    return a.getTime() === b.getTime()\n  }\n\n  // 正则比较\n  if (a instanceof RegExp && b instanceof RegExp) {\n    return a.source === b.source && a.flags === b.flags\n  }\n\n  // Map 比较\n  if (a instanceof Map && b instanceof Map) {\n    if (a.size !== b.size) return false\n    for (const [key, value] of a) {\n      if (!b.has(key) || !deepEqual(value, b.get(key))) {\n        return false\n      }\n    }\n    return true\n  }\n\n  // Set 比较\n  if (a instanceof Set && b instanceof Set) {\n    if (a.size !== b.size) return false\n    for (const value of a) {\n      if (!b.has(value)) return false\n    }\n    return true\n  }\n\n  // 数组比较\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false\n    for (let i = 0; i < a.length; i++) {\n      if (!deepEqual(a[i], b[i])) return false\n    }\n    return true\n  }\n\n  // 对象比较\n  if (isPlainObject(a) && isPlainObject(b)) {\n    const keysA = Object.keys(a)\n    const keysB = Object.keys(b)\n    if (keysA.length !== keysB.length) return false\n    for (const key of keysA) {\n      if (!hasOwnKey(b, key)) return false\n      if (!deepEqual(a[key], b[key])) return false\n    }\n    return true\n  }\n\n  return false\n}\n\n/**\n * 冻结对象（深度）\n *\n * @template T - 对象类型\n * @param obj - 要冻结的对象\n * @returns 冻结后的对象\n */\nexport function deepFreeze<T extends object>(obj: T): Readonly<T> {\n  const propNames = Object.getOwnPropertyNames(obj)\n\n  for (const name of propNames) {\n    const value = (obj as Record<string, unknown>)[name]\n    if (value && typeof value === 'object') {\n      deepFreeze(value)\n    }\n  }\n\n  return Object.freeze(obj)\n}\n\n"],"mappings":";;;;;;;;;;AAOA,MAAM,iBAAiB,OAAO,UAAU;AAExC,SAAS,UAAU,OAAe,KAA2B;CAC3D,OAAO,eAAe,KAAK,OAAO,GAAG;AACvC;AAQO,SAAS,SAAS,OAAkD;CACzE,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C;AAQO,SAAS,cAAc,OAAkD;CAC9E,IAAI,CAAC,SAAS,KAAK,GAAG,OAAO;CAC7B,MAAM,QAAQ,OAAO,eAAe,KAAK;CACzC,OAAO,UAAU,QAAQ,UAAU,OAAO;AAC5C;AAQA,SAAS,sBAAsB,OAAyB;CAEtD,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,OAAO;CAClD,IAAI,OAAO,UAAU,aAAa,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU,OAAO;CACjG,IAAI,OAAO,UAAU,UAAU,OAAO;CAGtC,IAAI,OAAO,UAAU,cAAc,OAAO,UAAU,UAAU,OAAO;CAGrE,IAAI,iBAAiB,QAAQ,iBAAiB,QAAQ,OAAO;CAC7D,IAAI,iBAAiB,eAAe,iBAAiB,UAAU,OAAO;CACtE,IAAI,iBAAiB,OAAO,iBAAiB,KAAK,OAAO;CACzD,IAAI,YAAY,OAAO,KAAK,GAAG,OAAO;CAGtC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM,OAAM,SAAQ,sBAAsB,IAAI,CAAC;CAGxD,IAAI,cAAc,KAAK,GACrB,OAAO,OAAO,OAAO,KAAK,CAAA,CAAE,OAAM,MAAK,sBAAsB,CAAC,CAAC;CAGjE,OAAO;AACT;AA6CO,SAAS,UAAa,OAAU,UAA4B,CAAC,GAAM;CACxE,MAAM,EACJ,oBAAoB,wBAAwB,MAC5C,iBAAiB,OACjB,eAAe,OACf,WAAW,UACX,iBACE;CAGJ,IAAI,yBAAyB,OAAO,oBAAoB,cAAc,sBAAsB,KAAK,GAC/F,IAAI;EACF,OAAO,gBAAgB,KAAK;CAC9B,QACM,CAEN;CAGF,MAAM,wBAAQ,IAAI,QAAyB;CAE3C,SAAS,cAAiB,KAAQ,OAAkB;EAElD,IAAI,QAAQ,QAAQ,QAAQ,KAAA,GAAW,OAAO;EAC9C,IAAI,OAAO,QAAQ,aAAa,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAAU,OAAO;EAC3F,IAAI,OAAO,QAAQ,UAAU,OAAO;EAGpC,IAAI,OAAO,QAAQ,UACjB,OAAO,eAAe,OAAO,IAAI,WAAW,IAAS;EAIvD,IAAI,OAAO,QAAQ,YACjB,OAAO,iBAAkB,IAAI,KAAK,CAAC,CAAC,IAAU;EAIhD,IAAI,QAAQ,UACV,OAAO;EAIT,IAAI,cAAc;GAChB,MAAM,eAAe,aAAa,MAAK,MAAK,cAAc,GAAG,QAAQ,CAAC,CAAC;GACvE,IAAI,iBAAiB,KAAA,GACnB,OAAO;EAEX;EAGA,IAAI,OAAO,QAAQ,YAAY,QAAQ;OACjC,MAAM,IAAI,GAAG,GACf,OAAO,MAAM,IAAI,GAAG;EAAA;EAKxB,IAAI,eAAe,MACjB,OAAO,IAAI,KAAK,IAAI,QAAQ,CAAC;EAI/B,IAAI,eAAe,QAAQ;GACzB,MAAM,SAAS,IAAI,OAAO,IAAI,QAAQ,IAAI,KAAK;GAC7C,OAAkB,YAAY,IAAI;GACpC,OAAO;EACT;EAGA,IAAI,eAAe,OAAO;GACxB,MAAM,SAAS,IAAK,IAAI,YAAiC,IAAI,OAAO;GACpE,OAAO,QAAQ,IAAI;GACnB,OAAO,OAAO,IAAI;GAClB,OAAO;EACT;EAGA,IAAI,eAAe,KAAK;GACtB,MAAM,yBAAS,IAAI,IAAI;GACvB,MAAM,IAAI,KAAK,MAAM;GACrB,IAAI,SAAS,GAAG,MAAM;IACpB,OAAO,IAAI,cAAc,GAAG,QAAQ,CAAC,GAAG,cAAc,GAAG,QAAQ,CAAC,CAAC;GACrE,CAAC;GACD,OAAO;EACT;EAGA,IAAI,eAAe,KAAK;GACtB,MAAM,yBAAS,IAAI,IAAI;GACvB,MAAM,IAAI,KAAK,MAAM;GACrB,IAAI,SAAS,MAAM;IACjB,OAAO,IAAI,cAAc,GAAG,QAAQ,CAAC,CAAC;GACxC,CAAC;GACD,OAAO;EACT;EAGA,IAAI,eAAe,aACjB,OAAO,IAAI,MAAM,CAAC;EAIpB,IAAI,YAAY,OAAO,GAAG,KAAK,EAAE,eAAe,WAAW;GACzD,MAAM,wBAAwB,IAAI;GAClC,OAAO,IAAI,sBAAuB,IAA2C,OAAO,MAAM,CAAC,CAAC;EAC9F;EAGA,IAAI,MAAM,QAAQ,GAAG,GAAG;GACtB,MAAM,SAAoB,CAAC;GAC3B,MAAM,IAAI,KAAK,MAAM;GACrB,KAAA,IAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAC9B,OAAO,KAAK,cAAc,IAAI,IAAI,QAAQ,CAAC;GAE7C,OAAO;EACT;EAGA,IAAI,cAAc,GAAG,GAAG;GACtB,MAAM,SAA2C,CAAC;GAClD,MAAM,IAAI,KAAK,MAAM;GAGrB,MAAM,OAAO,OAAO,KAAK,GAAG;GAC5B,KAAA,MAAW,OAAO,MAChB,OAAO,OAAO,cAAe,IAAgC,MAAM,QAAQ,CAAC;GAI9E,IAAI,cAAc;IAChB,MAAM,aAAa,OAAO,sBAAsB,GAAG;IACnD,KAAA,MAAW,OAAO,YAChB,OAAO,OAAO,cAAe,IAAgC,MAAM,QAAQ,CAAC;GAEhF;GAEA,OAAO;EACT;EAGA,OAAO;CACT;CAEA,OAAO,cAAc,OAAO,CAAC;AAC/B;AAiBO,SAAS,aAAgB,OAAa;CAC3C,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,OAAO;CAClD,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,CAAC,GAAG,KAAK;CAGlB,IAAI,iBAAiB,KACnB,OAAO,IAAI,IAAI,KAAK;CAGtB,IAAI,iBAAiB,KACnB,OAAO,IAAI,IAAI,KAAK;CAGtB,IAAI,iBAAiB,MACnB,OAAO,IAAI,KAAK,MAAM,QAAQ,CAAC;CAGjC,OAAO,EAAE,GAAG,MAAM;AACpB;AAgCO,SAAS,UACd,QAAA,GACG,SACA;CACH,OAAO,qBAAqB,QAAQ,CAAC,GAAG,GAAG,OAAO;AACpD;AAWO,SAAS,qBACd,QACA,SAAA,GACG,SACA;CACH,MAAM,EACJ,gBAAgB,WAChB,QAAQ,MACR,WAAW,aACT;CAEJ,SAAS,cACP,WACA,WACA,OACyB;EACzB,IAAI,QAAQ,UACV,OAAO;EAGT,KAAA,MAAW,OAAO,OAAO,KAAK,SAAS,GAAG;GACxC,MAAM,cAAc,UAAU;GAC9B,MAAM,cAAc,UAAU;GAG9B,IAAI,MAAM,QAAQ,WAAW,GAC3B,IAAI,kBAAkB,YAAY,MAAM,QAAQ,WAAW,GACzD,UAAU,OAAO,CAAC,GAAG,aAAa,GAAG,WAAW;QAClD,IACS,kBAAkB,WAAW,MAAM,QAAQ,WAAW,GAAG;IAChE,MAAMA,UAAS,CAAC,GAAG,WAAW;IAC9B,YAAY,SAAS,MAAM,UAAU;KACnC,IAAI,cAAc,IAAI,KAAK,cAAcA,QAAO,MAAM,GACpDA,QAAO,SAAS,cAAcA,QAAO,QAAmC,MAAM,QAAQ,CAAC;UAGvFA,QAAO,SAAS,QAAQ,UAAU,IAAI,IAAI;IAE9C,CAAC;IACD,UAAU,OAAOA;GACnB,OAEE,UAAU,OAAO,QAAQ,UAAU,WAAW,IAAI;QAEtD,IAES,cAAc,WAAW,GAChC,IAAI,cAAc,WAAW,GAC3B,UAAU,OAAO,cACf,aACA,aACA,QAAQ,CACV;QAGA,UAAU,OAAO,QAAQ,UAAU,WAAW,IAAI;QAKpD,UAAU,OAAO,SAAS,SAAS,WAAW,IAAI,UAAU,WAAW,IAAI;EAE/E;EAEA,OAAO;CACT;CAEA,IAAI,SAAS;CAEb,KAAA,MAAW,UAAU,SACnB,IAAI,WAAW,QAAQ,WAAW,KAAA,GAChC,SAAS,cAAc,QAAQ,QAAQ,CAAC;CAI5C,OAAO;AACT;AAgBO,SAAS,UAAU,GAAY,GAAqB;CAEzD,IAAI,MAAM,GAAG,OAAO;CAGpB,IAAI,MAAM,QAAQ,MAAM,QAAQ,MAAM,KAAA,KAAa,MAAM,KAAA,GACvD,OAAO,MAAM;CAIf,IAAI,OAAO,MAAM,OAAO,GAAG,OAAO;CAGlC,IAAI,OAAO,MAAM,UAAU,OAAO,MAAM;CAGxC,IAAI,aAAa,QAAQ,aAAa,MACpC,OAAO,EAAE,QAAQ,MAAM,EAAE,QAAQ;CAInC,IAAI,aAAa,UAAU,aAAa,QACtC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE;CAIhD,IAAI,aAAa,OAAO,aAAa,KAAK;EACxC,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO;EAC9B,KAAA,MAAW,CAAC,KAAK,UAAU,GACzB,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,UAAU,OAAO,EAAE,IAAI,GAAG,CAAC,GAC7C,OAAO;EAGX,OAAO;CACT;CAGA,IAAI,aAAa,OAAO,aAAa,KAAK;EACxC,IAAI,EAAE,SAAS,EAAE,MAAM,OAAO;EAC9B,KAAA,MAAW,SAAS,GAClB,IAAI,CAAC,EAAE,IAAI,KAAK,GAAG,OAAO;EAE5B,OAAO;CACT;CAGA,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAAG;EACxC,IAAI,EAAE,WAAW,EAAE,QAAQ,OAAO;EAClC,KAAA,IAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAC5B,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO;EAErC,OAAO;CACT;CAGA,IAAI,cAAc,CAAC,KAAK,cAAc,CAAC,GAAG;EACxC,MAAM,QAAQ,OAAO,KAAK,CAAC;EAC3B,MAAM,QAAQ,OAAO,KAAK,CAAC;EAC3B,IAAI,MAAM,WAAW,MAAM,QAAQ,OAAO;EAC1C,KAAA,MAAW,OAAO,OAAO;GACvB,IAAI,CAAC,UAAU,GAAG,GAAG,GAAG,OAAO;GAC/B,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO;EACzC;EACA,OAAO;CACT;CAEA,OAAO;AACT;AASO,SAAS,WAA6B,KAAqB;CAChE,MAAM,YAAY,OAAO,oBAAoB,GAAG;CAEhD,KAAA,MAAW,QAAQ,WAAW;EAC5B,MAAM,QAAS,IAAgC;EAC/C,IAAI,SAAS,OAAO,UAAU,UAC5B,WAAW,KAAK;CAEpB;CAEA,OAAO,OAAO,OAAO,GAAG;AAC1B"}

package/es/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 工具函数模块
+ *
+ * 提供深拷贝、选择器、路径操作等工具函数
+ * @module utils
+ */
+export { debounce, throttle, } from './debounce-throttle';
+export type { DebouncedFunction, ThrottledFunction, } from './debounce-throttle';
+export { deepClone, deepEqual, deepFreeze, deepMerge, deepMergeWithOptions, isObject, isPlainObject, shallowClone, } from './deep-clone';
+export type { DeepCloneOptions, DeepMergeOptions, } from './deep-clone';
+export { combineSelectors, createCachedSelector, createMemoizedSelector, createSelector, createSelectorWithDeps, deleteByPath, getByPath, hasPath, setByPath, } from './selector';
+export type { MemoizedSelectorOptions, SelectorEqualityFn, } from './selector';
+//# sourceMappingURL=index.d.ts.map

package/es/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EACR,QAAQ,GACT,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,OAAO,EACP,SAAS,GACV,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/es/utils/index.js

@@ -0,0 +1,14 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { debounce, throttle } from "./debounce-throttle.js";
+import { deepClone, deepEqual, deepFreeze, deepMerge, deepMergeWithOptions, isObject, isPlainObject, shallowClone } from "./deep-clone.js";
+import { combineSelectors, createCachedSelector, createMemoizedSelector, createSelector, createSelectorWithDeps, deleteByPath, getByPath, hasPath, setByPath } from "./selector.js";
+export { combineSelectors, createCachedSelector, createMemoizedSelector, createSelector, createSelectorWithDeps, debounce, deepClone, deepEqual, deepFreeze, deepMerge, deepMergeWithOptions, deleteByPath, getByPath, hasPath, isObject, isPlainObject, setByPath, shallowClone, throttle };
+/*! End of @composy/store-core | Powered by @composy/builder */

package/es/utils/selector.d.ts

@@ -0,0 +1,213 @@
+/**
+ * 状态选择器工具
+ *
+ * 提供高性能的状态选择器和路径操作工具
+ * @module utils/selector
+ */
+import type { Selector, StateTree } from '../types';
+/**
+ * 选择器相等性比较函数类型
+ */
+export type SelectorEqualityFn<R> = (a: R, b: R) => boolean;
+/**
+ * 记忆化选择器配置选项
+ */
+export interface MemoizedSelectorOptions<R> {
+    /** 相等性比较函数 */
+    equalityFn?: SelectorEqualityFn<R>;
+    /** 最大缓存大小（默认 1） */
+    maxSize?: number;
+    /** 是否在开发模式下记录缓存命中率 */
+    trackHitRate?: boolean;
+}
+/**
+ * 创建记忆化选择器
+ *
+ * 基本的记忆化选择器，只缓存最后一次结果
+ *
+ * @template S - 状态类型
+ * @template R - 返回值类型
+ * @param selector - 选择器函数
+ * @param equalityFn - 相等性比较函数（默认使用 Object.is）
+ * @returns 记忆化的选择器
+ *
+ * @example
+ * ```typescript
+ * const selectTodos = createSelector(
+ *   (state: AppState) => state.todos,
+ * )
+ *
+ * const selectCompletedTodos = createSelector(
+ *   (state: AppState) => state.todos.filter(t => t.completed),
+ *   (a, b) => a.length === b.length && a.every((v, i) => v === b[i])
+ * )
+ * ```
+ */
+export declare function createSelector<S extends StateTree, R>(selector: Selector<S, R>, equalityFn?: SelectorEqualityFn<R>): Selector<S, R>;
+/**
+ * 创建带依赖的选择器
+ *
+ * 类似 reselect 的实现，支持多个输入选择器
+ *
+ * @template S - 状态类型
+ * @template Deps - 依赖结果类型
+ * @template R - 返回值类型
+ * @param dependencies - 依赖选择器数组
+ * @param combiner - 组合函数
+ * @param options - 配置选项
+ * @returns 记忆化的选择器
+ *
+ * @example
+ * ```typescript
+ * const selectVisibleTodos = createSelectorWithDeps(
+ *   [
+ *     (state) => state.todos,
+ *     (state) => state.visibilityFilter,
+ *   ],
+ *   (todos, filter) => {
+ *     switch (filter) {
+ *       case 'SHOW_COMPLETED': return todos.filter(t => t.completed)
+ *       case 'SHOW_ACTIVE': return todos.filter(t => !t.completed)
+ *       default: return todos
+ *     }
+ *   }
+ * )
+ * ```
+ */
+export declare function createSelectorWithDeps<S extends StateTree, Deps extends unknown[], R>(dependencies: {
+    [K in keyof Deps]: Selector<S, Deps[K]>;
+}, combiner: (...args: Deps) => R, options?: MemoizedSelectorOptions<R>): Selector<S, R>;
+/**
+ * 组合多个选择器
+ *
+ * 简单的选择器组合，不带记忆化
+ *
+ * @template S - 状态类型
+ * @template R - 结果类型数组
+ * @template C - 组合结果类型
+ * @param selectors - 选择器数组
+ * @param combiner - 组合函数
+ * @returns 组合后的选择器
+ *
+ * @example
+ * ```typescript
+ * const selectUserAndTodos = combineSelectors(
+ *   [
+ *     (state) => state.user,
+ *     (state) => state.todos,
+ *   ],
+ *   (user, todos) => ({ user, todos })
+ * )
+ * ```
+ */
+export declare function combineSelectors<S extends StateTree, R extends unknown[], C>(selectors: {
+    [K in keyof R]: Selector<S, R[K]>;
+}, combiner: (...results: R) => C): Selector<S, C>;
+/**
+ * 创建带高级缓存的选择器
+ *
+ * 支持多个缓存条目，使用 LRU 策略
+ *
+ * @template S - 状态类型
+ * @template R - 返回值类型
+ * @param selector - 选择器函数
+ * @param options - 配置选项
+ * @returns 带缓存的选择器
+ *
+ * @example
+ * ```typescript
+ * const selectFilteredItems = createCachedSelector(
+ *   (state, filter) => state.items.filter(item => item.type === filter),
+ *   { maxSize: 5 }
+ * )
+ * ```
+ */
+export declare function createCachedSelector<S extends StateTree, R>(selector: Selector<S, R>, options?: MemoizedSelectorOptions<R>): Selector<S, R> & {
+    clearCache: () => void;
+    getCacheSize: () => number;
+};
+/**
+ * 创建记忆化选择器（别名，同 createSelector）
+ *
+ * @template S - 状态类型
+ * @template R - 返回值类型
+ * @param selector - 选择器函数
+ * @param options - 配置选项
+ * @returns 记忆化的选择器
+ */
+export declare function createMemoizedSelector<S extends StateTree, R>(selector: Selector<S, R>, options?: MemoizedSelectorOptions<R>): Selector<S, R>;
+/**
+ * 获取嵌套对象的值
+ *
+ * 支持点表示法和数组索引
+ *
+ * @template T - 返回值类型
+ * @param obj - 对象
+ * @param path - 路径（支持 'a.b.c' 或 'a[0].b'）
+ * @param defaultValue - 默认值（当路径不存在时返回）
+ * @returns 值
+ *
+ * @example
+ * ```typescript
+ * const value = getByPath({ a: { b: { c: 1 } } }, 'a.b.c')
+ * // value: 1
+ *
+ * const arr = getByPath({ items: [{ name: 'test' }] }, 'items[0].name')
+ * // arr: 'test'
+ *
+ * const missing = getByPath({ a: 1 }, 'b.c', 'default')
+ * // missing: 'default'
+ * ```
+ */
+export declare function getByPath<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined;
+/**
+ * 设置嵌套对象的值
+ *
+ * 支持自动创建中间路径
+ *
+ * @param obj - 对象
+ * @param path - 路径
+ * @param value - 值
+ * @returns 是否成功
+ *
+ * @example
+ * ```typescript
+ * const obj = {}
+ * setByPath(obj, 'a.b.c', 1)
+ * // obj: { a: { b: { c: 1 } } }
+ *
+ * setByPath(obj, 'items[0].name', 'test')
+ * // obj: { a: { b: { c: 1 } }, items: [{ name: 'test' }] }
+ * ```
+ */
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): boolean;
+/**
+ * 删除嵌套对象的值
+ *
+ * @param obj - 对象
+ * @param path - 路径
+ * @returns 是否成功删除
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: { c: 1 } } }
+ * deleteByPath(obj, 'a.b.c')
+ * // obj: { a: { b: {} } }
+ * ```
+ */
+export declare function deleteByPath(obj: Record<string, unknown>, path: string): boolean;
+/**
+ * 检查嵌套对象中是否存在指定路径
+ *
+ * @param obj - 对象
+ * @param path - 路径
+ * @returns 是否存在
+ *
+ * @example
+ * ```typescript
+ * hasPath({ a: { b: 1 } }, 'a.b') // true
+ * hasPath({ a: { b: 1 } }, 'a.c') // false
+ * ```
+ */
+export declare function hasPath(obj: unknown, path: string): boolean;
+//# sourceMappingURL=selector.d.ts.map

package/es/utils/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/utils/selector.ts"],"names":[],"mappings":"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"}