@composy/store-core 0.0.1

package/lib/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/package.json

@@ -0,0 +1,155 @@
+{
+  "name": "@composy/store-core",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "框架无关的状态管理核心库 - 提供状态管理抽象层、插件系统、中间件机制",
+  "author": "ldesign",
+  "license": "MIT",
+  "keywords": [
+    "state-management",
+    "store",
+    "typescript",
+    "framework-agnostic",
+    "reactive",
+    "plugin",
+    "middleware"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./es/index.d.ts",
+      "import": "./es/index.js",
+      "require": "./lib/index.cjs",
+      "default": "./es/index.js"
+    },
+    "./core": {
+      "types": "./es/core/index.d.ts",
+      "import": "./es/core/index.js",
+      "require": "./lib/core/index.cjs",
+      "default": "./es/core/index.js"
+    },
+    "./core/*": {
+      "types": "./es/core/*.d.ts",
+      "import": "./es/core/*.js",
+      "require": "./lib/core/*.cjs",
+      "default": "./es/core/*.js"
+    },
+    "./engine": {
+      "types": "./es/engine/index.d.ts",
+      "import": "./es/engine/index.js",
+      "require": "./lib/engine/index.cjs",
+      "default": "./es/engine/index.js"
+    },
+    "./engine/*": {
+      "types": "./es/engine/*.d.ts",
+      "import": "./es/engine/*.js",
+      "require": "./lib/engine/*.cjs",
+      "default": "./es/engine/*.js"
+    },
+    "./errors": {
+      "types": "./es/errors/index.d.ts",
+      "import": "./es/errors/index.js",
+      "require": "./lib/errors/index.cjs",
+      "default": "./es/errors/index.js"
+    },
+    "./errors/*": {
+      "types": "./es/errors/*.d.ts",
+      "import": "./es/errors/*.js",
+      "require": "./lib/errors/*.cjs",
+      "default": "./es/errors/*.js"
+    },
+    "./middleware": {
+      "types": "./es/middleware/index.d.ts",
+      "import": "./es/middleware/index.js",
+      "require": "./lib/middleware/index.cjs",
+      "default": "./es/middleware/index.js"
+    },
+    "./middleware/*": {
+      "types": "./es/middleware/*.d.ts",
+      "import": "./es/middleware/*.js",
+      "require": "./lib/middleware/*.cjs",
+      "default": "./es/middleware/*.js"
+    },
+    "./plugins": {
+      "types": "./es/plugins/index.d.ts",
+      "import": "./es/plugins/index.js",
+      "require": "./lib/plugins/index.cjs",
+      "default": "./es/plugins/index.js"
+    },
+    "./plugins/*": {
+      "types": "./es/plugins/*.d.ts",
+      "import": "./es/plugins/*.js",
+      "require": "./lib/plugins/*.cjs",
+      "default": "./es/plugins/*.js"
+    },
+    "./types": {
+      "types": "./es/types/index.d.ts",
+      "import": "./es/types/index.js",
+      "require": "./lib/types/index.cjs",
+      "default": "./es/types/index.js"
+    },
+    "./types/*": {
+      "types": "./es/types/*.d.ts",
+      "import": "./es/types/*.js",
+      "require": "./lib/types/*.cjs",
+      "default": "./es/types/*.js"
+    },
+    "./utils": {
+      "types": "./es/utils/index.d.ts",
+      "import": "./es/utils/index.js",
+      "require": "./lib/utils/index.cjs",
+      "default": "./es/utils/index.js"
+    },
+    "./utils/*": {
+      "types": "./es/utils/*.d.ts",
+      "import": "./es/utils/*.js",
+      "require": "./lib/utils/*.cjs",
+      "default": "./es/utils/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./lib/index.cjs",
+  "module": "./es/index.js",
+  "unpkg": "./dist/index.min.js",
+  "jsdelivr": "./dist/index.min.js",
+  "types": "./es/index.d.ts",
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "dist",
+    "es",
+    "esm",
+    "lib"
+  ],
+  "scripts": {
+    "build": "ldesign-builder build",
+    "build:watch": "ldesign-builder build --watch",
+    "clean": "rimraf es esm lib dist",
+    "dev": "ldesign-builder build --watch",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "ltesting run:unit",
+    "test:coverage": "ltesting run:unit --coverage",
+    "test:run": "ltesting run:unit",
+    "type-check": "tsc --noEmit",
+    "test:watch": "ltesting run:unit --watch",
+    "test:changed": "ltesting run:unit --changed",
+    "test:failed": "ltesting run:unit --failed",
+    "test:ui": "ltesting dashboard"
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "9.1.0",
+    "@composy/builder": "^0.0.1",
+    "@composy/testing": "^0.0.1",
+    "@types/node": "26.1.1",
+    "eslint": "10.7.0",
+    "typescript": "5.9.3"
+  },
+  "typings": "./es/index.d.ts",
+  "browser": "./dist/index.js"
+}