@vlian/framework 1.0.0

package/dist/state/core/index.cjs

@@ -0,0 +1,32 @@
+/**
+ * 状态管理器核心模块导出
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get DerivedStateInstance () {
+        return _DerivedStateInstance.DerivedStateInstance;
+    },
+    get StateInstance () {
+        return _StateInstance.StateInstance;
+    },
+    get StateRegistry () {
+        return _StateRegistry.StateRegistry;
+    },
+    get StateScopeManager () {
+        return _StateScope.StateScopeManager;
+    }
+});
+const _StateInstance = require("./StateInstance");
+const _StateScope = require("./StateScope");
+const _StateRegistry = require("./StateRegistry");
+const _DerivedStateInstance = require("./DerivedStateInstance");
+
+//# sourceMappingURL=index.js.map

package/dist/state/core/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/state/core/index.ts"],"sourcesContent":["/**\n * 状态管理器核心模块导出\n */\n\nexport { StateInstance } from './StateInstance';\nexport { StateScopeManager } from './StateScope';\nexport { StateRegistry } from './StateRegistry';\nexport { DerivedStateInstance } from './DerivedStateInstance';\n"],"names":["DerivedStateInstance","StateInstance","StateRegistry","StateScopeManager"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QAKQA;eAAAA,0CAAoB;;QAHpBC;eAAAA,4BAAa;;QAEbC;eAAAA,4BAAa;;QADbC;eAAAA,6BAAiB;;;+BADI;4BACI;+BACJ;sCACO"}

package/dist/state/core/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 状态管理器核心模块导出
+ */
+export { StateInstance } from './StateInstance';
+export { StateScopeManager } from './StateScope';
+export { StateRegistry } from './StateRegistry';
+export { DerivedStateInstance } from './DerivedStateInstance';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/state/core/index.js

@@ -0,0 +1,8 @@
+/**
+ * 状态管理器核心模块导出
+ */ export { StateInstance } from "./StateInstance";
+export { StateScopeManager } from "./StateScope";
+export { StateRegistry } from "./StateRegistry";
+export { DerivedStateInstance } from "./DerivedStateInstance";
+
+//# sourceMappingURL=index.js.map

package/dist/state/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/state/core/index.ts"],"sourcesContent":["/**\n * 状态管理器核心模块导出\n */\n\nexport { StateInstance } from './StateInstance';\nexport { StateScopeManager } from './StateScope';\nexport { StateRegistry } from './StateRegistry';\nexport { DerivedStateInstance } from './DerivedStateInstance';\n"],"names":["StateInstance","StateScopeManager","StateRegistry","DerivedStateInstance"],"mappings":"AAAA;;CAEC,GAED,SAASA,aAAa,QAAQ,kBAAkB;AAChD,SAASC,iBAAiB,QAAQ,eAAe;AACjD,SAASC,aAAa,QAAQ,kBAAkB;AAChD,SAASC,oBAAoB,QAAQ,yBAAyB"}

package/dist/state/index.cjs

@@ -0,0 +1,32 @@
+/**
+ * 状态管理器模块统一导出
+ */ // 导出核心类型
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "StateManager", {
+    enumerable: true,
+    get: function() {
+        return _StateManager.StateManager;
+    }
+});
+_export_star(require("./types"), exports);
+_export_star(require("./core"), exports);
+_export_star(require("./adapters"), exports);
+const _StateManager = require("./StateManager");
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/state/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/state/index.ts"],"sourcesContent":["/**\n * 状态管理器模块统一导出\n */\n\n// 导出核心类型\nexport * from './types';\n\n// 导出核心实现\nexport * from './core';\n\n// 导出适配器\nexport * from './adapters';\n\n// 导出状态管理器\nexport { StateManager } from './StateManager';\nexport type { IStateManager } from './StateManager';\n"],"names":["StateManager"],"mappings":"AAAA;;CAEC,GAED,SAAS;;;;;+BAUAA;;;eAAAA,0BAAY;;;qBATP;qBAGA;qBAGA;8BAGe"}

package/dist/state/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 状态管理器模块统一导出
+ */
+export * from './types';
+export * from './core';
+export * from './adapters';
+export { StateManager } from './StateManager';
+export type { IStateManager } from './StateManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,12 @@
+/**
+ * 状态管理器模块统一导出
+ */ // 导出核心类型
+export * from "./types";
+// 导出核心实现
+export * from "./core";
+// 导出适配器
+export * from "./adapters";
+// 导出状态管理器
+export { StateManager } from "./StateManager";
+
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/state/index.ts"],"sourcesContent":["/**\n * 状态管理器模块统一导出\n */\n\n// 导出核心类型\nexport * from './types';\n\n// 导出核心实现\nexport * from './core';\n\n// 导出适配器\nexport * from './adapters';\n\n// 导出状态管理器\nexport { StateManager } from './StateManager';\nexport type { IStateManager } from './StateManager';\n"],"names":["StateManager"],"mappings":"AAAA;;CAEC,GAED,SAAS;AACT,cAAc,UAAU;AAExB,SAAS;AACT,cAAc,SAAS;AAEvB,QAAQ;AACR,cAAc,aAAa;AAE3B,UAAU;AACV,SAASA,YAAY,QAAQ,iBAAiB"}

package/dist/state/types.cjs

@@ -0,0 +1,14 @@
+/**
+ * 状态管理器类型定义
+ */ /**
+ * 状态更新函数类型
+ * 
+ * @template T - 状态值类型
+ * @param current - 当前状态值
+ * @returns 新的状态值
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=types.js.map

package/dist/state/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/state/types.ts"],"sourcesContent":["/**\n * 状态管理器类型定义\n */\n\n/**\n * 状态更新函数类型\n * \n * @template T - 状态值类型\n * @param current - 当前状态值\n * @returns 新的状态值\n */\nexport type StateUpdater<T> = (current: T) => T;\n\n/**\n * 状态订阅回调函数类型\n * \n * @template T - 状态值类型\n * @param value - 新的状态值\n * @param previous - 之前的状态值\n */\nexport type StateSubscriber<T> = (value: T, previous: T) => void;\n\n/**\n * 取消订阅函数类型\n */\nexport type Unsubscribe = () => void;\n\n/**\n * 状态作用域标识符\n */\nexport type StateScope = string | symbol;\n\n/**\n * 状态实例标识符\n */\nexport type StateInstanceId = string | symbol;\n\n/**\n * 状态实例配置选项\n */\nexport interface StateInstanceOptions {\n  /**\n   * 状态实例标识符\n   */\n  id?: StateInstanceId;\n  \n  /**\n   * 状态作用域\n   */\n  scope?: StateScope;\n  \n  /**\n   * 是否启用开发模式（用于调试）\n   */\n  devMode?: boolean;\n  \n  /**\n   * 状态变更时的中间件函数\n   */\n  middleware?: Array<(value: unknown, previous: unknown) => unknown>;\n}\n\n/**\n * 状态实例核心接口\n * \n * 这是状态管理器的最小抽象接口，不绑定任何具体实现\n * \n * @template T - 状态值类型\n */\nexport interface IStateInstance<T = unknown> {\n  /**\n   * 获取当前状态值\n   * \n   * @returns 当前状态值\n   */\n  get(): T;\n\n  /**\n   * 更新状态值\n   * \n   * @param value - 新的状态值或更新函数\n   */\n  set(value: T | StateUpdater<T>): void;\n\n  /**\n   * 订阅状态变化\n   * \n   * @param subscriber - 订阅回调函数\n   * @returns 取消订阅函数\n   */\n  subscribe(subscriber: StateSubscriber<T>): Unsubscribe;\n\n  /**\n   * 获取状态实例标识符\n   */\n  getId(): StateInstanceId;\n\n  /**\n   * 获取状态作用域\n   */\n  getScope(): StateScope | undefined;\n\n  /**\n   * 销毁状态实例，清理所有订阅和资源\n   */\n  destroy(): void;\n\n  /**\n   * 检查状态实例是否已销毁\n   */\n  isDestroyed(): boolean;\n}\n\n/**\n * 状态适配器接口\n * \n * 适配器负责将外部状态库映射到 Secra 状态抽象\n * \n * @template T - 状态值类型\n */\nexport interface IStateAdapter {\n  /**\n   * 创建状态实例\n   * \n   * @param initialValue - 初始状态值\n   * @param options - 状态实例配置选项\n   * @returns 状态实例\n   */\n  createInstance<T>(initialValue: T, options?: StateInstanceOptions): IStateInstance<T>;\n\n  /**\n   * 销毁适配器，清理所有资源\n   */\n  destroy(): void;\n\n  /**\n   * 获取适配器名称（用于调试和日志）\n   */\n  getName(): string;\n}\n\n/**\n * 状态注册表接口\n */\nexport interface IStateRegistry {\n  /**\n   * 注册状态实例\n   * \n   * @param instance - 状态实例\n   */\n  register(instance: IStateInstance): void;\n\n  /**\n   * 注销状态实例\n   * \n   * @param id - 状态实例标识符\n   */\n  unregister(id: StateInstanceId): void;\n\n  /**\n   * 根据标识符获取状态实例\n   * \n   * @param id - 状态实例标识符\n   * @returns 状态实例，如果不存在则返回 undefined\n   */\n  getInstance(id: StateInstanceId): IStateInstance | undefined;\n\n  /**\n   * 根据作用域获取所有状态实例\n   * \n   * @param scope - 状态作用域\n   * @returns 状态实例数组\n   */\n  getInstancesByScope(scope: StateScope): IStateInstance[];\n\n  /**\n   * 获取所有状态实例\n   * \n   * @returns 状态实例数组\n   */\n  getAllInstances(): IStateInstance[];\n\n  /**\n   * 销毁指定作用域的所有状态实例\n   * \n   * @param scope - 状态作用域\n   */\n  destroyScope(scope: StateScope): void;\n\n  /**\n   * 销毁所有状态实例\n   */\n  destroyAll(): void;\n\n  /**\n   * 获取注册表中的实例数量\n   */\n  size(): number;\n}\n\n/**\n * 派生状态配置\n */\nexport interface DerivedStateConfig<T, D extends readonly IStateInstance[]> {\n  /**\n   * 依赖的状态实例数组\n   */\n  dependencies: D;\n\n  /**\n   * 派生函数，根据依赖状态计算派生状态\n   * \n   * @param values - 依赖状态的当前值数组\n   * @returns 派生状态值\n   */\n  derive: (values: { [K in keyof D]: D[K] extends IStateInstance<infer V> ? V : never }) => T;\n\n  /**\n   * 是否启用相等性检查（避免不必要的更新）\n   */\n  equalityCheck?: (a: T, b: T) => boolean;\n}\n\n/**\n * 派生状态实例接口\n * \n * @template T - 派生状态值类型\n */\nexport interface IDerivedStateInstance<T = unknown> extends IStateInstance<T> {\n  /**\n   * 获取依赖的状态实例\n   */\n  getDependencies(): readonly IStateInstance[];\n\n  /**\n   * 手动重新计算派生状态\n   */\n  recompute(): void;\n}\n\n/**\n * 状态管理器配置选项\n */\nexport interface StateManagerOptions {\n  /**\n   * 默认状态适配器\n   */\n  defaultAdapter?: IStateAdapter;\n\n  /**\n   * 是否启用全局注册表\n   */\n  enableRegistry?: boolean;\n\n  /**\n   * 默认作用域\n   */\n  defaultScope?: StateScope;\n\n  /**\n   * 是否启用开发模式\n   */\n  devMode?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GAED;;;;;;CAMC"}

package/dist/state/types.d.ts

@@ -0,0 +1,231 @@
+/**
+ * 状态管理器类型定义
+ */
+/**
+ * 状态更新函数类型
+ *
+ * @template T - 状态值类型
+ * @param current - 当前状态值
+ * @returns 新的状态值
+ */
+export type StateUpdater<T> = (current: T) => T;
+/**
+ * 状态订阅回调函数类型
+ *
+ * @template T - 状态值类型
+ * @param value - 新的状态值
+ * @param previous - 之前的状态值
+ */
+export type StateSubscriber<T> = (value: T, previous: T) => void;
+/**
+ * 取消订阅函数类型
+ */
+export type Unsubscribe = () => void;
+/**
+ * 状态作用域标识符
+ */
+export type StateScope = string | symbol;
+/**
+ * 状态实例标识符
+ */
+export type StateInstanceId = string | symbol;
+/**
+ * 状态实例配置选项
+ */
+export interface StateInstanceOptions {
+    /**
+     * 状态实例标识符
+     */
+    id?: StateInstanceId;
+    /**
+     * 状态作用域
+     */
+    scope?: StateScope;
+    /**
+     * 是否启用开发模式（用于调试）
+     */
+    devMode?: boolean;
+    /**
+     * 状态变更时的中间件函数
+     */
+    middleware?: Array<(value: unknown, previous: unknown) => unknown>;
+}
+/**
+ * 状态实例核心接口
+ *
+ * 这是状态管理器的最小抽象接口，不绑定任何具体实现
+ *
+ * @template T - 状态值类型
+ */
+export interface IStateInstance<T = unknown> {
+    /**
+     * 获取当前状态值
+     *
+     * @returns 当前状态值
+     */
+    get(): T;
+    /**
+     * 更新状态值
+     *
+     * @param value - 新的状态值或更新函数
+     */
+    set(value: T | StateUpdater<T>): void;
+    /**
+     * 订阅状态变化
+     *
+     * @param subscriber - 订阅回调函数
+     * @returns 取消订阅函数
+     */
+    subscribe(subscriber: StateSubscriber<T>): Unsubscribe;
+    /**
+     * 获取状态实例标识符
+     */
+    getId(): StateInstanceId;
+    /**
+     * 获取状态作用域
+     */
+    getScope(): StateScope | undefined;
+    /**
+     * 销毁状态实例，清理所有订阅和资源
+     */
+    destroy(): void;
+    /**
+     * 检查状态实例是否已销毁
+     */
+    isDestroyed(): boolean;
+}
+/**
+ * 状态适配器接口
+ *
+ * 适配器负责将外部状态库映射到 Secra 状态抽象
+ *
+ * @template T - 状态值类型
+ */
+export interface IStateAdapter {
+    /**
+     * 创建状态实例
+     *
+     * @param initialValue - 初始状态值
+     * @param options - 状态实例配置选项
+     * @returns 状态实例
+     */
+    createInstance<T>(initialValue: T, options?: StateInstanceOptions): IStateInstance<T>;
+    /**
+     * 销毁适配器，清理所有资源
+     */
+    destroy(): void;
+    /**
+     * 获取适配器名称（用于调试和日志）
+     */
+    getName(): string;
+}
+/**
+ * 状态注册表接口
+ */
+export interface IStateRegistry {
+    /**
+     * 注册状态实例
+     *
+     * @param instance - 状态实例
+     */
+    register(instance: IStateInstance): void;
+    /**
+     * 注销状态实例
+     *
+     * @param id - 状态实例标识符
+     */
+    unregister(id: StateInstanceId): void;
+    /**
+     * 根据标识符获取状态实例
+     *
+     * @param id - 状态实例标识符
+     * @returns 状态实例，如果不存在则返回 undefined
+     */
+    getInstance(id: StateInstanceId): IStateInstance | undefined;
+    /**
+     * 根据作用域获取所有状态实例
+     *
+     * @param scope - 状态作用域
+     * @returns 状态实例数组
+     */
+    getInstancesByScope(scope: StateScope): IStateInstance[];
+    /**
+     * 获取所有状态实例
+     *
+     * @returns 状态实例数组
+     */
+    getAllInstances(): IStateInstance[];
+    /**
+     * 销毁指定作用域的所有状态实例
+     *
+     * @param scope - 状态作用域
+     */
+    destroyScope(scope: StateScope): void;
+    /**
+     * 销毁所有状态实例
+     */
+    destroyAll(): void;
+    /**
+     * 获取注册表中的实例数量
+     */
+    size(): number;
+}
+/**
+ * 派生状态配置
+ */
+export interface DerivedStateConfig<T, D extends readonly IStateInstance[]> {
+    /**
+     * 依赖的状态实例数组
+     */
+    dependencies: D;
+    /**
+     * 派生函数，根据依赖状态计算派生状态
+     *
+     * @param values - 依赖状态的当前值数组
+     * @returns 派生状态值
+     */
+    derive: (values: {
+        [K in keyof D]: D[K] extends IStateInstance<infer V> ? V : never;
+    }) => T;
+    /**
+     * 是否启用相等性检查（避免不必要的更新）
+     */
+    equalityCheck?: (a: T, b: T) => boolean;
+}
+/**
+ * 派生状态实例接口
+ *
+ * @template T - 派生状态值类型
+ */
+export interface IDerivedStateInstance<T = unknown> extends IStateInstance<T> {
+    /**
+     * 获取依赖的状态实例
+     */
+    getDependencies(): readonly IStateInstance[];
+    /**
+     * 手动重新计算派生状态
+     */
+    recompute(): void;
+}
+/**
+ * 状态管理器配置选项
+ */
+export interface StateManagerOptions {
+    /**
+     * 默认状态适配器
+     */
+    defaultAdapter?: IStateAdapter;
+    /**
+     * 是否启用全局注册表
+     */
+    enableRegistry?: boolean;
+    /**
+     * 默认作用域
+     */
+    defaultScope?: StateScope;
+    /**
+     * 是否启用开发模式
+     */
+    devMode?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/state/types.d.ts.map

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

package/dist/state/types.js

@@ -0,0 +1,13 @@
+/**
+ * 状态管理器类型定义
+ */ /**
+ * 状态更新函数类型
+ * 
+ * @template T - 状态值类型
+ * @param current - 当前状态值
+ * @returns 新的状态值
+ */ /**
+ * 状态管理器配置选项
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/state/types.ts"],"sourcesContent":["/**\n * 状态管理器类型定义\n */\n\n/**\n * 状态更新函数类型\n * \n * @template T - 状态值类型\n * @param current - 当前状态值\n * @returns 新的状态值\n */\nexport type StateUpdater<T> = (current: T) => T;\n\n/**\n * 状态订阅回调函数类型\n * \n * @template T - 状态值类型\n * @param value - 新的状态值\n * @param previous - 之前的状态值\n */\nexport type StateSubscriber<T> = (value: T, previous: T) => void;\n\n/**\n * 取消订阅函数类型\n */\nexport type Unsubscribe = () => void;\n\n/**\n * 状态作用域标识符\n */\nexport type StateScope = string | symbol;\n\n/**\n * 状态实例标识符\n */\nexport type StateInstanceId = string | symbol;\n\n/**\n * 状态实例配置选项\n */\nexport interface StateInstanceOptions {\n  /**\n   * 状态实例标识符\n   */\n  id?: StateInstanceId;\n  \n  /**\n   * 状态作用域\n   */\n  scope?: StateScope;\n  \n  /**\n   * 是否启用开发模式（用于调试）\n   */\n  devMode?: boolean;\n  \n  /**\n   * 状态变更时的中间件函数\n   */\n  middleware?: Array<(value: unknown, previous: unknown) => unknown>;\n}\n\n/**\n * 状态实例核心接口\n * \n * 这是状态管理器的最小抽象接口，不绑定任何具体实现\n * \n * @template T - 状态值类型\n */\nexport interface IStateInstance<T = unknown> {\n  /**\n   * 获取当前状态值\n   * \n   * @returns 当前状态值\n   */\n  get(): T;\n\n  /**\n   * 更新状态值\n   * \n   * @param value - 新的状态值或更新函数\n   */\n  set(value: T | StateUpdater<T>): void;\n\n  /**\n   * 订阅状态变化\n   * \n   * @param subscriber - 订阅回调函数\n   * @returns 取消订阅函数\n   */\n  subscribe(subscriber: StateSubscriber<T>): Unsubscribe;\n\n  /**\n   * 获取状态实例标识符\n   */\n  getId(): StateInstanceId;\n\n  /**\n   * 获取状态作用域\n   */\n  getScope(): StateScope | undefined;\n\n  /**\n   * 销毁状态实例，清理所有订阅和资源\n   */\n  destroy(): void;\n\n  /**\n   * 检查状态实例是否已销毁\n   */\n  isDestroyed(): boolean;\n}\n\n/**\n * 状态适配器接口\n * \n * 适配器负责将外部状态库映射到 Secra 状态抽象\n * \n * @template T - 状态值类型\n */\nexport interface IStateAdapter {\n  /**\n   * 创建状态实例\n   * \n   * @param initialValue - 初始状态值\n   * @param options - 状态实例配置选项\n   * @returns 状态实例\n   */\n  createInstance<T>(initialValue: T, options?: StateInstanceOptions): IStateInstance<T>;\n\n  /**\n   * 销毁适配器，清理所有资源\n   */\n  destroy(): void;\n\n  /**\n   * 获取适配器名称（用于调试和日志）\n   */\n  getName(): string;\n}\n\n/**\n * 状态注册表接口\n */\nexport interface IStateRegistry {\n  /**\n   * 注册状态实例\n   * \n   * @param instance - 状态实例\n   */\n  register(instance: IStateInstance): void;\n\n  /**\n   * 注销状态实例\n   * \n   * @param id - 状态实例标识符\n   */\n  unregister(id: StateInstanceId): void;\n\n  /**\n   * 根据标识符获取状态实例\n   * \n   * @param id - 状态实例标识符\n   * @returns 状态实例，如果不存在则返回 undefined\n   */\n  getInstance(id: StateInstanceId): IStateInstance | undefined;\n\n  /**\n   * 根据作用域获取所有状态实例\n   * \n   * @param scope - 状态作用域\n   * @returns 状态实例数组\n   */\n  getInstancesByScope(scope: StateScope): IStateInstance[];\n\n  /**\n   * 获取所有状态实例\n   * \n   * @returns 状态实例数组\n   */\n  getAllInstances(): IStateInstance[];\n\n  /**\n   * 销毁指定作用域的所有状态实例\n   * \n   * @param scope - 状态作用域\n   */\n  destroyScope(scope: StateScope): void;\n\n  /**\n   * 销毁所有状态实例\n   */\n  destroyAll(): void;\n\n  /**\n   * 获取注册表中的实例数量\n   */\n  size(): number;\n}\n\n/**\n * 派生状态配置\n */\nexport interface DerivedStateConfig<T, D extends readonly IStateInstance[]> {\n  /**\n   * 依赖的状态实例数组\n   */\n  dependencies: D;\n\n  /**\n   * 派生函数，根据依赖状态计算派生状态\n   * \n   * @param values - 依赖状态的当前值数组\n   * @returns 派生状态值\n   */\n  derive: (values: { [K in keyof D]: D[K] extends IStateInstance<infer V> ? V : never }) => T;\n\n  /**\n   * 是否启用相等性检查（避免不必要的更新）\n   */\n  equalityCheck?: (a: T, b: T) => boolean;\n}\n\n/**\n * 派生状态实例接口\n * \n * @template T - 派生状态值类型\n */\nexport interface IDerivedStateInstance<T = unknown> extends IStateInstance<T> {\n  /**\n   * 获取依赖的状态实例\n   */\n  getDependencies(): readonly IStateInstance[];\n\n  /**\n   * 手动重新计算派生状态\n   */\n  recompute(): void;\n}\n\n/**\n * 状态管理器配置选项\n */\nexport interface StateManagerOptions {\n  /**\n   * 默认状态适配器\n   */\n  defaultAdapter?: IStateAdapter;\n\n  /**\n   * 是否启用全局注册表\n   */\n  enableRegistry?: boolean;\n\n  /**\n   * 默认作用域\n   */\n  defaultScope?: StateScope;\n\n  /**\n   * 是否启用开发模式\n   */\n  devMode?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GAED;;;;;;CAMC,GAsOD;;CAEC,GACD,WAoBC"}

package/dist/types.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=types.js.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export type StorageOptions = {
+    prefix: string;
+    defaultExpire: number;
+    tableName?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["export type StorageOptions = {\n    prefix: string;\n    defaultExpire: number;\n    tableName?: string;\n};\n"],"names":[],"mappings":"AAAA,WAIE"}

package/dist/utils/analytics.cjs

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get AnalyticsService () {
+        return AnalyticsService;
+    },
+    get getAnalytics () {
+        return getAnalytics;
+    },
+    get initAnalytics () {
+        return initAnalytics;
+    }
+});
+const _logger = require("./logger");
+const _security = require("./security");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+let AnalyticsService = class AnalyticsService {
+    /**
+   * 启动批量上报定时器
+   */ startBatchTimer() {
+        if (this.batchTimer) {
+            return;
+        }
+        this.batchTimer = setInterval(()=>{
+            this.flush();
+        }, this.config.batchInterval);
+    }
+    /**
+   * 停止批量上报定时器
+   */ stopBatchTimer() {
+        if (this.batchTimer) {
+            clearInterval(this.batchTimer);
+            this.batchTimer = null;
+        }
+    }
+    /**
+   * 记录事件
+   */ track(event) {
+        if (!this.config.enabled) {
+            return;
+        }
+        // 采样检查
+        if (Math.random() > this.config.sampleRate) {
+            return;
+        }
+        // 匿名化处理
+        const anonymizedEvent = {
+            ...event,
+            timestamp: Date.now(),
+            properties: this.anonymizeProperties(event.properties)
+        };
+        // 添加到队列
+        this.eventQueue.push(anonymizedEvent);
+        // 立即上报单个事件
+        if (this.config.onEvent) {
+            this.config.onEvent(anonymizedEvent);
+        }
+        // 检查是否需要批量上报
+        if (this.eventQueue.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    /**
+   * 记录页面浏览
+   */ trackPageView(page, properties) {
+        this.track({
+            type: 'pageview',
+            name: 'page_view',
+            properties: {
+                page,
+                ...properties
+            }
+        });
+    }
+    /**
+   * 记录点击事件
+   */ trackClick(element, properties) {
+        this.track({
+            type: 'click',
+            name: 'click',
+            properties: {
+                element,
+                ...properties
+            }
+        });
+    }
+    /**
+   * 记录自定义事件
+   */ trackCustom(name, properties) {
+        this.track({
+            type: 'custom',
+            name,
+            properties
+        });
+    }
+    /**
+   * 记录错误事件
+   */ trackError(error, properties) {
+        this.track({
+            type: 'error',
+            name: 'error',
+            properties: {
+                errorName: error.name,
+                errorMessage: error.message,
+                errorStack: error.stack,
+                ...properties
+            }
+        });
+    }
+    /**
+   * 记录性能事件
+   */ trackPerformance(metrics, properties) {
+        this.track({
+            type: 'performance',
+            name: 'performance',
+            properties: {
+                ...metrics,
+                ...properties
+            }
+        });
+    }
+    /**
+   * 匿名化属性（使用深度脱敏）
+   */ anonymizeProperties(properties) {
+        if (!this.config.anonymize || !properties) {
+            return properties;
+        }
+        // 使用深度脱敏处理
+        return _security.SecurityUtils.deepSanitize(properties);
+    }
+    /**
+   * 刷新队列（批量上报）
+   */ flush() {
+        if (this.eventQueue.length === 0) {
+            return;
+        }
+        const events = [
+            ...this.eventQueue
+        ];
+        this.eventQueue = [];
+        if (this.config.onBatch) {
+            this.config.onBatch(events);
+        }
+        _logger.logger.debug(`分析服务批量上报 ${events.length} 个事件`);
+    }
+    /**
+   * 启用分析
+   */ enable() {
+        this.config.enabled = true;
+        this.startBatchTimer();
+    }
+    /**
+   * 禁用分析
+   */ disable() {
+        this.config.enabled = false;
+        this.stopBatchTimer();
+        this.flush();
+    }
+    /**
+   * 销毁服务
+   */ destroy() {
+        this.stopBatchTimer();
+        this.flush();
+    }
+    constructor(config = {}){
+        _define_property(this, "config", void 0);
+        _define_property(this, "eventQueue", []);
+        _define_property(this, "batchTimer", null);
+        this.config = {
+            enabled: config.enabled ?? true,
+            sampleRate: config.sampleRate ?? 1.0,
+            anonymize: config.anonymize ?? true,
+            onEvent: config.onEvent ?? (()=>{}),
+            onBatch: config.onBatch ?? (()=>{}),
+            batchSize: config.batchSize ?? 10,
+            batchInterval: config.batchInterval ?? 5000
+        };
+        if (this.config.enabled) {
+            this.startBatchTimer();
+        }
+    }
+};
+/**
+ * 默认分析服务实例
+ */ let defaultAnalyticsService = null;
+function initAnalytics(config) {
+    if (!defaultAnalyticsService) {
+        defaultAnalyticsService = new AnalyticsService(config);
+    }
+    return defaultAnalyticsService;
+}
+function getAnalytics() {
+    if (!defaultAnalyticsService) {
+        return initAnalytics();
+    }
+    return defaultAnalyticsService;
+}
+
+//# sourceMappingURL=analytics.js.map