@composy/store-core 0.0.1

package/es/types/subscription.d.ts

@@ -0,0 +1,158 @@
+/**
+ * 订阅系统类型定义
+ *
+ * @module types/subscription
+ */
+import type { StateTree, StoreId } from './store';
+/**
+ * 订阅回调类型
+ * @template T - 数据类型
+ */
+export type Subscriber<T = unknown> = (value: T, oldValue?: T) => void;
+/**
+ * 取消订阅函数类型
+ */
+export type Unsubscribe = () => void;
+/**
+ * 订阅选项
+ */
+export interface SubscriptionOptions {
+    /** 是否立即执行 */
+    immediate?: boolean;
+    /** 是否在 store 销毁后保持订阅 */
+    detached?: boolean;
+}
+/**
+ * 发布订阅管理器接口
+ */
+export interface PubSub<T = unknown> {
+    /**
+     * 订阅
+     * @param callback - 回调函数
+     * @param options - 订阅选项
+     * @returns 取消订阅函数
+     */
+    subscribe: (callback: Subscriber<T>, options?: SubscriptionOptions) => Unsubscribe;
+    /**
+     * 发布
+     * @param value - 新值
+     * @param oldValue - 旧值
+     */
+    publish: (value: T, oldValue?: T) => void;
+    /**
+     * 清空所有订阅
+     */
+    clear: () => void;
+    /**
+     * 获取订阅者数量
+     */
+    size: () => number;
+}
+/**
+ * 事件类型
+ */
+export type EventType = 'store:created' | 'store:disposed' | 'state:changed' | 'action:called' | 'action:completed' | 'action:error' | 'plugin:installed' | 'plugin:uninstalled';
+/**
+ * 事件数据
+ */
+export interface EventData {
+    /** 事件类型 */
+    type: EventType;
+    /** Store ID */
+    storeId?: StoreId;
+    /** 事件数据 */
+    payload?: unknown;
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 事件监听器类型
+ */
+export type EventListener = (data: EventData) => void;
+/**
+ * 事件总线接口
+ */
+export interface EventBus {
+    /**
+     * 监听事件
+     * @param type - 事件类型
+     * @param listener - 监听器
+     * @returns 取消监听函数
+     */
+    on: (type: EventType | '*', listener: EventListener) => Unsubscribe;
+    /**
+     * 监听一次
+     * @param type - 事件类型
+     * @param listener - 监听器
+     * @returns 取消监听函数
+     */
+    once: (type: EventType, listener: EventListener) => Unsubscribe;
+    /**
+     * 取消监听
+     * @param type - 事件类型
+     * @param listener - 监听器
+     */
+    off: (type: EventType | '*', listener?: EventListener) => void;
+    /**
+     * 发送事件
+     * @param type - 事件类型
+     * @param payload - 事件数据
+     */
+    emit: (type: EventType, payload?: unknown) => void;
+    /**
+     * 清空所有监听器
+     */
+    clear: () => void;
+}
+/**
+ * 选择器函数类型
+ * @template S - 状态类型
+ * @template R - 返回值类型
+ */
+export type Selector<S extends StateTree, R> = (state: S) => R;
+/**
+ * 选择器订阅选项
+ */
+export interface SelectorOptions<R> {
+    /** 是否立即执行 */
+    immediate?: boolean;
+    /** 相等性比较函数 */
+    equalityFn?: (a: R, b: R) => boolean;
+}
+/**
+ * 批量更新上下文
+ */
+export interface BatchContext {
+    /** 是否正在批量更新 */
+    isBatching: boolean;
+    /** 待更新的 Store ID 列表 */
+    pendingStores: Set<StoreId>;
+}
+/**
+ * 批量更新管理器接口
+ */
+export interface BatchManager {
+    /**
+     * 开始批量更新
+     */
+    start: () => void;
+    /**
+     * 结束批量更新并通知所有订阅者
+     */
+    end: () => void;
+    /**
+     * 标记 Store 需要更新
+     * @param storeId - Store ID
+     */
+    markDirty: (storeId: StoreId) => void;
+    /**
+     * 在批量上下文中执行
+     * @param fn - 执行函数
+     */
+    batch: <T>(fn: () => T) => T;
+    /**
+     * 是否正在批量更新
+     */
+    isBatching: () => boolean;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/es/types/subscription.d.ts.map

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

package/es/types/subscription.js

@@ -0,0 +1,10 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+/*! End of @composy/store-core | Powered by @composy/builder */

package/es/types/utility.d.ts

@@ -0,0 +1,312 @@
+/**
+ * 工具类型定义
+ *
+ * 提供常用的类型工具，用于增强类型安全
+ * @module types/utility
+ */
+/**
+ * 深度部分类型
+ *
+ * 将对象的所有属性（包括嵌套属性）设为可选
+ *
+ * @template T - 原始类型
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   name: string
+ *   address: { city: string; zip: string }
+ * }
+ *
+ * type PartialUser = DeepPartial<User>
+ * // { name?: string; address?: { city?: string; zip?: string } }
+ * ```
+ */
+export type DeepPartial<T> = T extends object ? T extends Array<infer U> ? Array<DeepPartial<U>> : T extends Map<infer K, infer V> ? Map<DeepPartial<K>, DeepPartial<V>> : T extends Set<infer U> ? Set<DeepPartial<U>> : T extends Function ? T : {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/**
+ * 深度只读类型
+ *
+ * 将对象的所有属性（包括嵌套属性）设为只读
+ *
+ * @template T - 原始类型
+ *
+ * @example
+ * ```typescript
+ * interface Config {
+ *   api: { url: string; timeout: number }
+ * }
+ *
+ * type ReadonlyConfig = DeepReadonly<Config>
+ * // { readonly api: { readonly url: string; readonly timeout: number } }
+ * ```
+ */
+export type DeepReadonly<T> = T extends object ? T extends Array<infer U> ? ReadonlyArray<DeepReadonly<U>> : T extends Map<infer K, infer V> ? ReadonlyMap<DeepReadonly<K>, DeepReadonly<V>> : T extends Set<infer U> ? ReadonlySet<DeepReadonly<U>> : T extends Function ? T : {
+    readonly [P in keyof T]: DeepReadonly<T[P]>;
+} : T;
+/**
+ * 只读 Map 类型
+ */
+type ReadonlyMap<K, V> = Omit<Map<K, V>, 'set' | 'delete' | 'clear'>;
+/**
+ * 只读 Set 类型
+ */
+type ReadonlySet<T> = Omit<Set<T>, 'add' | 'delete' | 'clear'>;
+/**
+ * 获取对象的所有路径
+ *
+ * @template T - 对象类型
+ *
+ * @example
+ * ```typescript
+ * interface State {
+ *   user: { name: string; age: number }
+ *   settings: { theme: string }
+ * }
+ *
+ * type Paths = PathsOf<State>
+ * // 'user' | 'user.name' | 'user.age' | 'settings' | 'settings.theme'
+ * ```
+ */
+export type PathsOf<T, Prefix extends string = ''> = T extends object ? T extends Array<unknown> ? Prefix : {
+    [K in keyof T & string]: K extends string ? Prefix extends '' ? K | PathsOf<T[K], K> : `${Prefix}.${K}` | PathsOf<T[K], `${Prefix}.${K}`> : never;
+}[keyof T & string] : Prefix;
+/**
+ * 根据路径获取类型
+ *
+ * @template T - 对象类型
+ * @template P - 路径字符串
+ *
+ * @example
+ * ```typescript
+ * interface State {
+ *   user: { name: string; age: number }
+ * }
+ *
+ * type UserName = PathValue<State, 'user.name'> // string
+ * type User = PathValue<State, 'user'> // { name: string; age: number }
+ * ```
+ */
+export type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? PathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+/**
+ * 提取函数的参数类型
+ *
+ * @template T - 函数类型
+ */
+export type ArgumentsOf<T extends (...args: unknown[]) => unknown> = T extends (...args: infer P) => unknown ? P : never;
+/**
+ * 提取函数的返回类型（异步函数自动解包 Promise）
+ *
+ * @template T - 函数类型
+ */
+export type AsyncReturnType<T extends (...args: unknown[]) => unknown> = T extends (...args: unknown[]) => Promise<infer R> ? R : T extends (...args: unknown[]) => infer R ? R : never;
+/**
+ * 非空类型
+ *
+ * 从类型中排除 null 和 undefined
+ *
+ * @template T - 原始类型
+ */
+export type NonNullable<T> = T extends null | undefined ? never : T;
+/**
+ * 可为 null 的类型
+ *
+ * @template T - 原始类型
+ */
+export type Nullable<T> = T | null;
+/**
+ * 可选的类型
+ *
+ * @template T - 原始类型
+ */
+export type Optional<T> = T | undefined;
+/**
+ * 品牌类型
+ *
+ * 用于创建名义类型系统
+ *
+ * @template T - 基础类型
+ * @template Brand - 品牌标识
+ *
+ * @example
+ * ```typescript
+ * type UserId = Brand<string, 'UserId'>
+ * type PostId = Brand<string, 'PostId'>
+ *
+ * // UserId 和 PostId 不能互相赋值，即使底层都是 string
+ * ```
+ */
+export type Brand<T, Brand extends string> = T & {
+    __brand: Brand;
+};
+/**
+ * 严格对象类型
+ *
+ * 确保对象不包含多余的属性
+ *
+ * @template T - 期望类型
+ * @template Actual - 实际类型
+ */
+export type Exact<T, Actual extends T> = T & {
+    [K in keyof Actual]: K extends keyof T ? T[K] : never;
+};
+/**
+ * 获取对象的必需键
+ *
+ * @template T - 对象类型
+ */
+export type RequiredKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? never : K;
+}[keyof T];
+/**
+ * 获取对象的可选键
+ *
+ * @template T - 对象类型
+ */
+export type OptionalKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? K : never;
+}[keyof T];
+/**
+ * 选择对象的部分属性设为必需
+ *
+ * @template T - 对象类型
+ * @template K - 需要设为必需的键
+ */
+export type RequireKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * 选择对象的部分属性设为可选
+ *
+ * @template T - 对象类型
+ * @template K - 需要设为可选的键
+ */
+export type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * 合并两个类型
+ *
+ * 第二个类型的属性会覆盖第一个类型
+ *
+ * @template T - 第一个类型
+ * @template U - 第二个类型
+ */
+export type Merge<T, U> = Omit<T, keyof U> & U;
+/**
+ * 获取两个类型的公共键
+ *
+ * @template T - 第一个类型
+ * @template U - 第二个类型
+ */
+export type CommonKeys<T, U> = keyof T & keyof U;
+/**
+ * 函数类型
+ */
+export type AnyFunction = (...args: unknown[]) => unknown;
+/**
+ * 异步函数类型
+ */
+export type AsyncFunction = (...args: unknown[]) => Promise<unknown>;
+/**
+ * 类类型
+ *
+ * @template T - 实例类型
+ */
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+/**
+ * 抽象类类型
+ *
+ * @template T - 实例类型
+ */
+export type AbstractConstructor<T = unknown> = abstract new (...args: unknown[]) => T;
+/**
+ * 确保类型不为 never
+ *
+ * @template T - 待检查类型
+ */
+export type IsNever<T> = [T] extends [never] ? true : false;
+/**
+ * 确保类型是数组
+ *
+ * @template T - 待检查类型
+ */
+export type IsArray<T> = T extends unknown[] ? true : false;
+/**
+ * 确保类型是对象（非数组、非函数）
+ *
+ * @template T - 待检查类型
+ */
+export type IsPlainObject<T> = T extends object ? T extends Function ? false : T extends unknown[] ? false : true : false;
+/**
+ * 值类型为指定类型的键
+ *
+ * @template T - 对象类型
+ * @template V - 值类型
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: number
+ *   name: string
+ *   age: number
+ * }
+ *
+ * type NumberKeys = KeysOfType<User, number> // 'id' | 'age'
+ * ```
+ */
+export type KeysOfType<T, V> = {
+    [K in keyof T]: T[K] extends V ? K : never;
+}[keyof T];
+/**
+ * 排除值类型为指定类型的键
+ *
+ * @template T - 对象类型
+ * @template V - 要排除的值类型
+ */
+export type KeysExcludeType<T, V> = {
+    [K in keyof T]: T[K] extends V ? never : K;
+}[keyof T];
+/**
+ * 仅保留值类型为指定类型的属性
+ *
+ * @template T - 对象类型
+ * @template V - 值类型
+ */
+export type PickByType<T, V> = Pick<T, KeysOfType<T, V>>;
+/**
+ * 排除值类型为指定类型的属性
+ *
+ * @template T - 对象类型
+ * @template V - 要排除的值类型
+ */
+export type OmitByType<T, V> = Pick<T, KeysExcludeType<T, V>>;
+/**
+ * 提取 Promise 的值类型
+ *
+ * @template T - Promise 类型
+ */
+export type Awaited<T> = T extends Promise<infer U> ? Awaited<U> : T;
+/**
+ * 联合类型转交叉类型
+ *
+ * @template U - 联合类型
+ */
+export type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * 元组类型转联合类型
+ *
+ * @template T - 元组类型
+ */
+export type TupleToUnion<T extends unknown[]> = T[number];
+/**
+ * 字符串字面量首字母大写
+ *
+ * @template S - 字符串类型
+ */
+export type Capitalize<S extends string> = S extends `${infer F}${infer R}` ? `${Uppercase<F>}${R}` : S;
+/**
+ * 字符串字面量首字母小写
+ *
+ * @template S - 字符串类型
+ */
+export type Uncapitalize<S extends string> = S extends `${infer F}${infer R}` ? `${Lowercase<F>}${R}` : S;
+export {};
+//# sourceMappingURL=utility.d.ts.map

package/es/types/utility.d.ts.map

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

package/es/types/utility.js

@@ -0,0 +1,10 @@
+/*!
+* ***********************************
+* @composy/store-core v0.0.1      *
+* Built with rollup               *
+* Build time: 2024-08-17 11:27:33 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+/*! End of @composy/store-core | Powered by @composy/builder */

package/es/utils/debounce-throttle.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 防抖和节流工具函数
+ *
+ * 提供性能优化的防抖、节流功能
+ * @module utils/debounce-throttle
+ */
+/**
+ * 防抖函数返回类型
+ */
+export interface DebouncedFunction<T extends (...args: never[]) => void> {
+    (...args: Parameters<T>): void;
+    /** 取消待执行的调用 */
+    cancel: () => void;
+    /** 立即执行待处理的调用 */
+    flush: () => void;
+    /** 是否有待处理的调用 */
+    pending: () => boolean;
+}
+/**
+ * 节流函数返回类型
+ */
+export interface ThrottledFunction<T extends (...args: never[]) => void> {
+    (...args: Parameters<T>): void;
+    /** 取消待执行的调用 */
+    cancel: () => void;
+}
+/**
+ * 创建防抖函数
+ *
+ * 在连续调用停止后，延迟指定时间执行函数
+ *
+ * @template T - 函数类型
+ * @param fn - 需要防抖的函数
+ * @param delay - 延迟时间（毫秒）
+ * @param immediate - 是否在首次调用时立即执行
+ * @returns 防抖后的函数
+ *
+ * @example
+ * ```typescript
+ * const debouncedSearch = debounce((query: string) => {
+ *   fetchResults(query)
+ * }, 300)
+ *
+ * // 连续调用只会在最后一次调用后 300ms 执行
+ * debouncedSearch('a')
+ * debouncedSearch('ab')
+ * debouncedSearch('abc') // 只有这次会触发
+ *
+ * // 取消待执行的调用
+ * debouncedSearch.cancel()
+ * ```
+ */
+export declare function debounce<T extends (...args: never[]) => void>(fn: T, delay: number, immediate?: boolean): DebouncedFunction<T>;
+/**
+ * 创建节流函数
+ *
+ * 在指定时间间隔内最多执行一次函数
+ *
+ * @template T - 函数类型
+ * @param fn - 需要节流的函数
+ * @param interval - 间隔时间（毫秒）
+ * @param options - 节流选项
+ * @param options.leading - 是否在时间窗开始时立即执行
+ * @param options.trailing - 是否在时间窗结束时补执行最后一次调用
+ * @returns 节流后的函数
+ *
+ * @example
+ * ```typescript
+ * const throttledUpdate = throttle((x: number, y: number) => {
+ *   updatePosition(x, y)
+ * }, 100)
+ *
+ * // 在 100ms 内多次调用，只会执行一次
+ * window.addEventListener('mousemove', (e) => {
+ *   throttledUpdate(e.clientX, e.clientY)
+ * })
+ *
+ * // 取消
+ * throttledUpdate.cancel()
+ * ```
+ */
+export declare function throttle<T extends (...args: never[]) => void>(fn: T, interval: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+}): ThrottledFunction<T>;
+//# sourceMappingURL=debounce-throttle.d.ts.map

package/es/utils/debounce-throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce-throttle.d.ts","sourceRoot":"","sources":["../../src/utils/debounce-throttle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI;IACrE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC9B,eAAe;IACf,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,iBAAiB;IACjB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,gBAAgB;IAChB,OAAO,EAAE,MAAM,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI;IACrE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC9B,eAAe;IACf,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAC3D,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,EACb,SAAS,UAAQ,GAChB,iBAAiB,CAAC,CAAC,CAAC,CA+CtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAC3D,EAAE,EAAE,CAAC,EACL,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,iBAAiB,CAAC,CAAC,CAAC,CA6CtB"}

package/es/utils/debounce-throttle.js

@@ -0,0 +1,86 @@
+/*!
+* ***********************************
+* @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/debounce-throttle.ts
+function debounce(fn, delay, immediate = false) {
+	let timer = null;
+	let lastArgs = null;
+	const debounced = ((...args) => {
+		lastArgs = args;
+		if (timer) clearTimeout(timer);
+		if (immediate && !timer) {
+			fn(...args);
+			timer = setTimeout(() => {
+				timer = null;
+				lastArgs = null;
+			}, delay);
+		} else timer = setTimeout(() => {
+			fn(...args);
+			timer = null;
+			lastArgs = null;
+		}, delay);
+	});
+	debounced.cancel = () => {
+		if (timer) {
+			clearTimeout(timer);
+			timer = null;
+			lastArgs = null;
+		}
+	};
+	debounced.flush = () => {
+		if (timer && lastArgs) {
+			clearTimeout(timer);
+			fn(...lastArgs);
+			timer = null;
+			lastArgs = null;
+		}
+	};
+	debounced.pending = () => timer !== null;
+	return debounced;
+}
+function throttle(fn, interval, options = {}) {
+	const { leading = true, trailing = true } = options;
+	let timer = null;
+	let lastTime = 0;
+	let lastArgs = null;
+	const throttled = ((...args) => {
+		const now = Date.now();
+		const remaining = interval - (now - lastTime);
+		lastArgs = args;
+		if (remaining <= 0 || remaining > interval) {
+			if (timer) {
+				clearTimeout(timer);
+				timer = null;
+			}
+			lastTime = now;
+			if (leading || lastTime !== 0) fn(...args);
+			lastArgs = null;
+		} else if (!timer && trailing) timer = setTimeout(() => {
+			lastTime = trailing ? Date.now() : 0;
+			timer = null;
+			if (lastArgs) {
+				fn(...lastArgs);
+				lastArgs = null;
+			}
+		}, remaining);
+	});
+	throttled.cancel = () => {
+		if (timer) {
+			clearTimeout(timer);
+			timer = null;
+		}
+		lastTime = 0;
+		lastArgs = null;
+	};
+	return throttled;
+}
+//#endregion
+export { debounce, throttle };
+/*! End of @composy/store-core | Powered by @composy/builder */
+//# sourceMappingURL=debounce-throttle.js.map