@vlian/framework 1.2.63 → 2.0.1

package/dist/state/StateManager.d.ts

@@ -1,120 +0,0 @@
-/**
- * 状态管理器主类
- *
- * 这是状态管理器的核心入口，提供统一的状态管理 API
- */
-import type { IStateInstance, IStateAdapter, IStateRegistry, StateInstanceOptions, StateManagerOptions, StateScope, DerivedStateConfig, IDerivedStateInstance } from './types';
-/**
- * 状态管理器实现
- */
-export declare class StateManager implements IStateManager {
-    /**
-     * 默认适配器
-     */
-    private readonly adapter;
-    /**
-     * 状态注册表（如果启用）
-     */
-    private readonly registry;
-    /**
-     * 默认作用域
-     */
-    private readonly defaultScope?;
-    /**
-     * 是否启用开发模式
-     */
-    private readonly devMode;
-    /**
-     * 是否已销毁
-     */
-    private destroyed;
-    /**
-     * 构造函数
-     *
-     * @param options - 状态管理器配置选项
-     */
-    constructor(options?: StateManagerOptions);
-    /**
-     * 创建状态实例
-     */
-    createState<T = unknown>(initialValue: T, options?: StateInstanceOptions): IStateInstance<T>;
-    /**
-     * 创建派生状态
-     */
-    createDerivedState<T, D extends readonly IStateInstance[]>(config: DerivedStateConfig<T, D>, options?: {
-        id?: string | symbol;
-        scope?: StateScope;
-    }): IDerivedStateInstance<T>;
-    /**
-     * 获取状态实例（如果启用了注册表）
-     */
-    getState(id: string | symbol): IStateInstance | undefined;
-    /**
-     * 根据作用域获取所有状态实例
-     */
-    getStatesByScope(scope: StateScope): IStateInstance[];
-    /**
-     * 获取所有状态实例
-     */
-    getAllStates(): IStateInstance[];
-    /**
-     * 销毁指定作用域的所有状态实例
-     */
-    destroyScope(scope: StateScope): void;
-    /**
-     * 销毁状态管理器
-     */
-    destroy(): void;
-    /**
-     * 检查状态管理器是否已销毁
-     */
-    isDestroyed(): boolean;
-    /**
-     * 获取当前使用的适配器
-     */
-    getAdapter(): IStateAdapter;
-    /**
-     * 获取注册表（如果启用）
-     */
-    getRegistry(): IStateRegistry | null;
-}
-/**
- * 状态管理器接口
- */
-export interface IStateManager {
-    /**
-     * 创建状态实例
-     */
-    createState<T = unknown>(initialValue: T, options?: StateInstanceOptions): IStateInstance<T>;
-    /**
-     * 创建派生状态
-     */
-    createDerivedState<T, D extends readonly IStateInstance[]>(config: DerivedStateConfig<T, D>, options?: {
-        id?: string | symbol;
-        scope?: StateScope;
-    }): IDerivedStateInstance<T>;
-    /**
-     * 获取状态实例
-     */
-    getState(id: string | symbol): IStateInstance | undefined;
-    /**
-     * 根据作用域获取所有状态实例
-     */
-    getStatesByScope(scope: StateScope): IStateInstance[];
-    /**
-     * 获取所有状态实例
-     */
-    getAllStates(): IStateInstance[];
-    /**
-     * 销毁指定作用域的所有状态实例
-     */
-    destroyScope(scope: StateScope): void;
-    /**
-     * 销毁状态管理器
-     */
-    destroy(): void;
-    /**
-     * 检查状态管理器是否已销毁
-     */
-    isDestroyed(): boolean;
-}

package/dist/state/StateManager.js

@@ -1 +0,0 @@
-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}import{AdapterFactory}from"./adapters/AdapterFactory";import{StateRegistry}from"./core/StateRegistry";import{DerivedStateInstance}from"./core/DerivedStateInstance";export class StateManager{createState(initialValue,options){if(this.destroyed){throw new Error("StateManager has been destroyed")}const mergedOptions={...options,scope:options?.scope??this.defaultScope,devMode:options?.devMode??this.devMode};const instance=this.adapter.createInstance(initialValue,mergedOptions);if(this.registry){this.registry.register(instance)}return instance}createDerivedState(config,options){if(this.destroyed){throw new Error("StateManager has been destroyed")}const mergedOptions={...options,scope:options?.scope??this.defaultScope};const instance=new DerivedStateInstance(config,mergedOptions);if(this.registry){this.registry.register(instance)}return instance}getState(id){if(!this.registry){throw new Error("Registry is not enabled. Enable it in StateManagerOptions.")}return this.registry.getInstance(id)}getStatesByScope(scope){if(!this.registry){throw new Error("Registry is not enabled. Enable it in StateManagerOptions.")}return this.registry.getInstancesByScope(scope)}getAllStates(){if(!this.registry){throw new Error("Registry is not enabled. Enable it in StateManagerOptions.")}return this.registry.getAllInstances()}destroyScope(scope){if(!this.registry){throw new Error("Registry is not enabled. Enable it in StateManagerOptions.")}this.registry.destroyScope(scope)}destroy(){if(this.destroyed){return}this.destroyed=true;if(this.registry){this.registry.destroyAll()}this.adapter.destroy();if(this.devMode){console.debug("[StateManager] Destroyed")}}isDestroyed(){return this.destroyed}getAdapter(){return this.adapter}getRegistry(){return this.registry}constructor(options={}){_define_property(this,"adapter",void 0);_define_property(this,"registry",void 0);_define_property(this,"defaultScope",void 0);_define_property(this,"devMode",void 0);_define_property(this,"destroyed",false);this.adapter=options.defaultAdapter??AdapterFactory.getDefaultAdapter();this.defaultScope=options.defaultScope;this.devMode=options.devMode??false;this.registry=options.enableRegistry!==false?new StateRegistry:null;if(this.devMode){console.debug("[StateManager] Initialized",{adapter:this.adapter.getName(),registryEnabled:!!this.registry,defaultScope:this.defaultScope})}}}

package/dist/state/adapters/AdapterFactory.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"AdapterFactory",{enumerable:true,get:function(){return AdapterFactory}});const _DefaultAdapter=require("./DefaultAdapter");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 AdapterFactory=class AdapterFactory{static getDefaultAdapter(){if(!this.defaultAdapter){this.defaultAdapter=new _DefaultAdapter.DefaultAdapter}return this.defaultAdapter}static createAdapter(adapterName){if(!adapterName){return this.getDefaultAdapter()}const factory=this.customAdapters.get(adapterName);if(!factory){throw new Error(`Adapter "${adapterName}" not found. Available adapters: ${Array.from(this.customAdapters.keys()).join(", ")}`)}return factory()}static registerAdapter(name,factory){if(this.customAdapters.has(name)){console.warn(`[AdapterFactory] Adapter "${name}" already registered, replacing...`)}this.customAdapters.set(name,factory)}static unregisterAdapter(name){this.customAdapters.delete(name)}static getRegisteredAdapters(){return Array.from(this.customAdapters.keys())}static reset(){if(this.defaultAdapter){this.defaultAdapter.destroy();this.defaultAdapter=null}this.customAdapters.clear()}};_define_property(AdapterFactory,"defaultAdapter",null);_define_property(AdapterFactory,"customAdapters",new Map);

package/dist/state/adapters/AdapterFactory.d.ts

@@ -1,51 +0,0 @@
-/**
- * 状态适配器工厂
- */
-import type { IStateAdapter } from '../types';
-/**
- * 适配器工厂
- *
- * 负责创建和管理状态适配器实例
- */
-export declare class AdapterFactory {
-    /**
-     * 默认适配器实例
-     */
-    private static defaultAdapter;
-    /**
-     * 自定义适配器映射
-     */
-    private static customAdapters;
-    /**
-     * 获取默认适配器
-     */
-    static getDefaultAdapter(): IStateAdapter;
-    /**
-     * 创建适配器实例
-     *
-     * @param adapterName - 适配器名称，如果不提供则使用默认适配器
-     * @returns 适配器实例
-     */
-    static createAdapter(adapterName?: string): IStateAdapter;
-    /**
-     * 注册自定义适配器
-     *
-     * @param name - 适配器名称
-     * @param factory - 适配器工厂函数
-     */
-    static registerAdapter(name: string, factory: () => IStateAdapter): void;
-    /**
-     * 注销适配器
-     *
-     * @param name - 适配器名称
-     */
-    static unregisterAdapter(name: string): void;
-    /**
-     * 获取所有已注册的适配器名称
-     */
-    static getRegisteredAdapters(): string[];
-    /**
-     * 重置工厂（主要用于测试）
-     */
-    static reset(): void;
-}

package/dist/state/adapters/AdapterFactory.js

@@ -1 +0,0 @@
-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}import{DefaultAdapter}from"./DefaultAdapter";export class AdapterFactory{static getDefaultAdapter(){if(!this.defaultAdapter){this.defaultAdapter=new DefaultAdapter}return this.defaultAdapter}static createAdapter(adapterName){if(!adapterName){return this.getDefaultAdapter()}const factory=this.customAdapters.get(adapterName);if(!factory){throw new Error(`Adapter "${adapterName}" not found. Available adapters: ${Array.from(this.customAdapters.keys()).join(", ")}`)}return factory()}static registerAdapter(name,factory){if(this.customAdapters.has(name)){console.warn(`[AdapterFactory] Adapter "${name}" already registered, replacing...`)}this.customAdapters.set(name,factory)}static unregisterAdapter(name){this.customAdapters.delete(name)}static getRegisteredAdapters(){return Array.from(this.customAdapters.keys())}static reset(){if(this.defaultAdapter){this.defaultAdapter.destroy();this.defaultAdapter=null}this.customAdapters.clear()}}_define_property(AdapterFactory,"defaultAdapter",null);_define_property(AdapterFactory,"customAdapters",new Map);

package/dist/state/adapters/DefaultAdapter.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"DefaultAdapter",{enumerable:true,get:function(){return DefaultAdapter}});const _StateInstance=require("../core/StateInstance");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 DefaultAdapter=class DefaultAdapter{createInstance(initialValue,options){if(this.destroyed){throw new Error("Adapter has been destroyed")}const instance=new _StateInstance.StateInstance(initialValue,{id:options?.id,scope:options?.scope,devMode:options?.devMode,middleware:options?.middleware});this.instances.add(instance);return instance}destroy(){if(this.destroyed){return}for(const instance of this.instances){instance.destroy()}this.instances.clear();this.destroyed=true}getName(){return this.name}constructor(){_define_property(this,"name","DefaultAdapter");_define_property(this,"destroyed",false);_define_property(this,"instances",new Set)}};

package/dist/state/adapters/DefaultAdapter.d.ts

@@ -1,38 +0,0 @@
-/**
- * 默认状态适配器
- *
- * 这是 Secra Framework 内置的默认状态适配器实现
- * 不依赖任何外部状态管理库，提供基础的状态管理能力
- */
-import type { IStateAdapter, IStateInstance, StateInstanceOptions } from '../types';
-/**
- * 默认状态适配器
- *
- * 使用框架内置的 StateInstance 实现
- */
-export declare class DefaultAdapter implements IStateAdapter {
-    /**
-     * 适配器名称
-     */
-    private readonly name;
-    /**
-     * 是否已销毁
-     */
-    private destroyed;
-    /**
-     * 创建的状态实例集合（用于销毁时清理）
-     */
-    private readonly instances;
-    /**
-     * 创建状态实例
-     */
-    createInstance<T>(initialValue: T, options?: StateInstanceOptions): IStateInstance<T>;
-    /**
-     * 销毁适配器
-     */
-    destroy(): void;
-    /**
-     * 获取适配器名称
-     */
-    getName(): string;
-}

package/dist/state/adapters/DefaultAdapter.js

@@ -1 +0,0 @@
-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}import{StateInstance}from"../core/StateInstance";export class DefaultAdapter{createInstance(initialValue,options){if(this.destroyed){throw new Error("Adapter has been destroyed")}const instance=new StateInstance(initialValue,{id:options?.id,scope:options?.scope,devMode:options?.devMode,middleware:options?.middleware});this.instances.add(instance);return instance}destroy(){if(this.destroyed){return}for(const instance of this.instances){instance.destroy()}this.instances.clear();this.destroyed=true}getName(){return this.name}constructor(){_define_property(this,"name","DefaultAdapter");_define_property(this,"destroyed",false);_define_property(this,"instances",new Set)}}

package/dist/state/adapters/ReduxAdapter.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"ReduxAdapter",{enumerable:true,get:function(){return ReduxAdapter}});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 ReduxStateInstance=class ReduxStateInstance{get(){if(this.destroyed){throw new Error(`ReduxStateInstance ${String(this.id)} has been destroyed`)}const state=this.store.getState();return state[this.sliceName]??this.previousValue}set(valueOrUpdater){if(this.destroyed){throw new Error(`ReduxStateInstance ${String(this.id)} has been destroyed`)}const currentValue=this.get();let newValue;if(typeof valueOrUpdater==="function"){newValue=valueOrUpdater(currentValue)}else{newValue=valueOrUpdater}let processedValue=newValue;for(const middleware of this.middleware){processedValue=middleware(processedValue,currentValue)}if(processedValue===currentValue){return}this.previousValue=currentValue;const action=this.actions.setValue(processedValue);this.store.dispatch(action);if(this.devMode){console.debug(`[ReduxStateInstance] Updated: ${String(this.id)}`,{previous:currentValue,current:processedValue,action})}}subscribe(subscriber){if(this.destroyed){throw new Error(`ReduxStateInstance ${String(this.id)} has been destroyed`)}this.subscribers.add(subscriber);if(this.devMode){console.debug(`[ReduxStateInstance] Subscribed: ${String(this.id)}`,{subscriberCount:this.subscribers.size})}return()=>{this.subscribers.delete(subscriber);if(this.devMode){console.debug(`[ReduxStateInstance] Unsubscribed: ${String(this.id)}`,{subscriberCount:this.subscribers.size})}}}getId(){return this.id}getScope(){return this.scope}destroy(){if(this.destroyed){return}this.destroyed=true;if(this.unsubscribeStore){this.unsubscribeStore();this.unsubscribeStore=undefined}this.subscribers.clear();if(this.devMode){console.debug(`[ReduxStateInstance] Destroyed: ${String(this.id)}`)}}isDestroyed(){return this.destroyed}notifySubscribers(){if(this.destroyed){return}try{const currentValue=this.get();if(currentValue===this.previousValue){return}const previousValue=this.previousValue;this.previousValue=currentValue;const subscribers=Array.from(this.subscribers);for(const subscriber of subscribers){try{subscriber(currentValue,previousValue)}catch(error){console.error(`[ReduxStateInstance] Error in subscriber for ${String(this.id)}:`,error)}}}catch(error){console.error(`[ReduxStateInstance] Error getting state for ${String(this.id)}:`,error)}}constructor(store,sliceName,actions,initialValue,options={}){_define_property(this,"id",void 0);_define_property(this,"scope",void 0);_define_property(this,"store",void 0);_define_property(this,"sliceName",void 0);_define_property(this,"actions",void 0);_define_property(this,"subscribers",new Set);_define_property(this,"unsubscribeStore",void 0);_define_property(this,"destroyed",false);_define_property(this,"devMode",void 0);_define_property(this,"middleware",void 0);_define_property(this,"previousValue",void 0);this.store=store;this.sliceName=sliceName;this.actions=actions;this.id=options.id??Symbol("ReduxStateInstance");this.scope=options.scope;this.devMode=options.devMode??false;this.middleware=options.middleware??[];this.previousValue=initialValue;this.unsubscribeStore=this.store.subscribe(()=>{this.notifySubscribers()});if(this.devMode){console.debug(`[ReduxStateInstance] Created: ${String(this.id)}`,{scope:this.scope,sliceName:this.sliceName,initialValue})}}};let DynamicReducerManager=class DynamicReducerManager{addReducer(key,reducer){this.reducers.set(key,reducer)}removeReducer(key){this.reducers.delete(key)}getRootReducer(){return this.rootReducer}hasReducer(key){return this.reducers.has(key)}constructor(){_define_property(this,"reducers",new Map);_define_property(this,"rootReducer",void 0);this.rootReducer=(state,action)=>{const stateRecord=state??{};const newState={...stateRecord};for(const[key,reducer]of this.reducers.entries()){newState[key]=reducer(stateRecord[key],action)}return newState}}};let ReduxAdapter=class ReduxAdapter{checkReduxAvailable(){}getOrCreateStore(){if(this.store){return this.store}try{const{configureStore}=require("@reduxjs/toolkit");this.store=configureStore({reducer:this.reducerManager.getRootReducer(),devTools:this.devMode,middleware:undefined});if(this.devMode){console.debug("[ReduxAdapter] Redux store created")}return this.store}catch(error){throw new Error("ReduxAdapter requires @reduxjs/toolkit to be installed. "+"Please install it: npm install @reduxjs/toolkit\n"+`Original error: ${error instanceof Error?error.message:String(error)}`)}}createSlice(sliceName,initialValue){try{const{createSlice}=require("@reduxjs/toolkit");const slice=createSlice({name:sliceName,initialState:initialValue,reducers:{setValue:(_state,action)=>{return action.payload??initialValue}}});return slice}catch(error){throw new Error("ReduxAdapter requires @reduxjs/toolkit to be installed. "+"Please install it: npm install @reduxjs/toolkit\n"+`Original error: ${error instanceof Error?error.message:String(error)}`)}}createInstance(initialValue,options){if(this.destroyed){throw new Error("ReduxAdapter has been destroyed")}const store=this.getOrCreateStore();const sliceName=options?.id?`secra_${String(options.id)}`:`secra_slice_${++this.sliceCounter}`;const slice=this.createSlice(sliceName,initialValue);if(!this.reducerManager.hasReducer(sliceName)){this.reducerManager.addReducer(sliceName,slice.reducer);store.replaceReducer(this.reducerManager.getRootReducer())}const instance=new ReduxStateInstance(store,sliceName,slice.actions,initialValue,{id:options?.id,scope:options?.scope,devMode:options?.devMode??this.devMode,middleware:options?.middleware});this.instances.add(instance);this.sliceToInstance.set(sliceName,instance);if(this.devMode){console.debug(`[ReduxAdapter] Created instance: ${String(instance.getId())}`,{sliceName,scope:options?.scope})}return instance}destroy(){if(this.destroyed){return}for(const instance of this.instances){instance.destroy()}for(const sliceName of this.sliceToInstance.keys()){this.reducerManager.removeReducer(sliceName)}if(this.store){this.store.replaceReducer(this.reducerManager.getRootReducer())}this.instances.clear();this.sliceToInstance.clear();this.store=null;this.destroyed=true;if(this.devMode){console.debug("[ReduxAdapter] Destroyed")}}getName(){return this.name}constructor(options){_define_property(this,"name","ReduxAdapter");_define_property(this,"destroyed",false);_define_property(this,"instances",new Set);_define_property(this,"store",null);_define_property(this,"sliceCounter",0);_define_property(this,"sliceToInstance",new Map);_define_property(this,"reducerManager",void 0);_define_property(this,"devMode",void 0);this.devMode=options?.devMode??false;this.reducerManager=new DynamicReducerManager;this.store=options?.store??null;this.checkReduxAvailable()}};

package/dist/state/adapters/ReduxAdapter.d.ts

@@ -1,129 +0,0 @@
-/**
- * Redux Toolkit 适配器
- *
- * 将 Redux Toolkit store 映射到 Secra 状态抽象
- *
- * 使用说明：
- * 1. 需要安装 @reduxjs/toolkit 作为 peerDependency
- * 2. 每个状态实例对应一个 Redux slice
- * 3. 支持 Redux DevTools 集成（如果可用）
- * 4. 支持中间件和开发模式
- *
- * @example
- * ```typescript
- * import { ReduxAdapter } from '@vlian/framework/state';
- *
- * const adapter = new ReduxAdapter({ devMode: true });
- * const state = adapter.createInstance(0, { id: 'counter' });
- *
- * state.set(1);
- * console.log(state.get()); // 1
- * ```
- */
-import type { IStateAdapter, IStateInstance, StateInstanceOptions } from '../types';
-/**
- * Redux 相关类型定义（如果 Redux 不可用，这些类型将用于类型检查）
- */
-type ReduxStore = {
-    dispatch: (action: unknown) => unknown;
-    getState: () => Record<string, unknown>;
-    subscribe: (listener: () => void) => () => void;
-    replaceReducer: (nextReducer: (state: unknown, action: unknown) => unknown) => void;
-};
-/**
- * Redux Toolkit 适配器配置选项
- */
-export interface ReduxAdapterOptions {
-    /**
-     * 是否启用开发模式
-     */
-    devMode?: boolean;
-    /**
-     * 自定义 Redux store（可选）
-     * 如果不提供，将创建一个新的 store
-     */
-    store?: ReduxStore;
-    /**
-     * Redux store 配置选项（仅在创建新 store 时使用）
-     */
-    storeConfig?: {
-        /**
-         * 是否启用 Redux DevTools
-         */
-        devTools?: boolean;
-        /**
-         * Redux 中间件数组
-         */
-        middleware?: unknown[];
-    };
-}
-/**
- * Redux Toolkit 适配器
- *
- * 将 Redux Toolkit store 映射到 Secra 状态抽象
- */
-export declare class ReduxAdapter implements IStateAdapter {
-    /**
-     * 适配器名称
-     */
-    private readonly name;
-    /**
-     * 是否已销毁
-     */
-    private destroyed;
-    /**
-     * 创建的状态实例集合
-     */
-    private readonly instances;
-    /**
-     * Redux store 实例
-     */
-    private store;
-    /**
-     * Redux slice 名称计数器（用于生成唯一的 slice 名称）
-     */
-    private sliceCounter;
-    /**
-     * Redux slice 名称到状态实例的映射
-     */
-    private readonly sliceToInstance;
-    /**
-     * 动态 reducer 管理器
-     */
-    private readonly reducerManager;
-    /**
-     * 是否启用开发模式
-     */
-    private readonly devMode;
-    /**
-     * 构造函数
-     *
-     * @param options - 适配器配置选项
-     */
-    constructor(options?: ReduxAdapterOptions);
-    /**
-     * 检查 Redux 是否可用
-     */
-    private checkReduxAvailable;
-    /**
-     * 获取或创建 Redux store
-     */
-    private getOrCreateStore;
-    /**
-     * 创建 Redux slice
-     */
-    private createSlice;
-    /**
-     * 创建状态实例
-     */
-    createInstance<T = unknown>(initialValue: T, options?: StateInstanceOptions): IStateInstance<T>;
-    /**
-     * 销毁适配器
-     */
-    destroy(): void;
-    /**
-     * 获取适配器名称
-     */
-    getName(): string;
-}
-export {};

package/dist/state/adapters/ReduxAdapter.js

@@ -1 +0,0 @@
-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 ReduxStateInstance=class ReduxStateInstance{get(){if(this.destroyed){throw new Error(`ReduxStateInstance ${String(this.id)} has been destroyed`)}const state=this.store.getState();return state[this.sliceName]??this.previousValue}set(valueOrUpdater){if(this.destroyed){throw new Error(`ReduxStateInstance ${String(this.id)} has been destroyed`)}const currentValue=this.get();let newValue;if(typeof valueOrUpdater==="function"){newValue=valueOrUpdater(currentValue)}else{newValue=valueOrUpdater}let processedValue=newValue;for(const middleware of this.middleware){processedValue=middleware(processedValue,currentValue)}if(processedValue===currentValue){return}this.previousValue=currentValue;const action=this.actions.setValue(processedValue);this.store.dispatch(action);if(this.devMode){console.debug(`[ReduxStateInstance] Updated: ${String(this.id)}`,{previous:currentValue,current:processedValue,action})}}subscribe(subscriber){if(this.destroyed){throw new Error(`ReduxStateInstance ${String(this.id)} has been destroyed`)}this.subscribers.add(subscriber);if(this.devMode){console.debug(`[ReduxStateInstance] Subscribed: ${String(this.id)}`,{subscriberCount:this.subscribers.size})}return()=>{this.subscribers.delete(subscriber);if(this.devMode){console.debug(`[ReduxStateInstance] Unsubscribed: ${String(this.id)}`,{subscriberCount:this.subscribers.size})}}}getId(){return this.id}getScope(){return this.scope}destroy(){if(this.destroyed){return}this.destroyed=true;if(this.unsubscribeStore){this.unsubscribeStore();this.unsubscribeStore=undefined}this.subscribers.clear();if(this.devMode){console.debug(`[ReduxStateInstance] Destroyed: ${String(this.id)}`)}}isDestroyed(){return this.destroyed}notifySubscribers(){if(this.destroyed){return}try{const currentValue=this.get();if(currentValue===this.previousValue){return}const previousValue=this.previousValue;this.previousValue=currentValue;const subscribers=Array.from(this.subscribers);for(const subscriber of subscribers){try{subscriber(currentValue,previousValue)}catch(error){console.error(`[ReduxStateInstance] Error in subscriber for ${String(this.id)}:`,error)}}}catch(error){console.error(`[ReduxStateInstance] Error getting state for ${String(this.id)}:`,error)}}constructor(store,sliceName,actions,initialValue,options={}){_define_property(this,"id",void 0);_define_property(this,"scope",void 0);_define_property(this,"store",void 0);_define_property(this,"sliceName",void 0);_define_property(this,"actions",void 0);_define_property(this,"subscribers",new Set);_define_property(this,"unsubscribeStore",void 0);_define_property(this,"destroyed",false);_define_property(this,"devMode",void 0);_define_property(this,"middleware",void 0);_define_property(this,"previousValue",void 0);this.store=store;this.sliceName=sliceName;this.actions=actions;this.id=options.id??Symbol("ReduxStateInstance");this.scope=options.scope;this.devMode=options.devMode??false;this.middleware=options.middleware??[];this.previousValue=initialValue;this.unsubscribeStore=this.store.subscribe(()=>{this.notifySubscribers()});if(this.devMode){console.debug(`[ReduxStateInstance] Created: ${String(this.id)}`,{scope:this.scope,sliceName:this.sliceName,initialValue})}}};let DynamicReducerManager=class DynamicReducerManager{addReducer(key,reducer){this.reducers.set(key,reducer)}removeReducer(key){this.reducers.delete(key)}getRootReducer(){return this.rootReducer}hasReducer(key){return this.reducers.has(key)}constructor(){_define_property(this,"reducers",new Map);_define_property(this,"rootReducer",void 0);this.rootReducer=(state,action)=>{const stateRecord=state??{};const newState={...stateRecord};for(const[key,reducer]of this.reducers.entries()){newState[key]=reducer(stateRecord[key],action)}return newState}}};export class ReduxAdapter{checkReduxAvailable(){}getOrCreateStore(){if(this.store){return this.store}try{const{configureStore}=require("@reduxjs/toolkit");this.store=configureStore({reducer:this.reducerManager.getRootReducer(),devTools:this.devMode,middleware:undefined});if(this.devMode){console.debug("[ReduxAdapter] Redux store created")}return this.store}catch(error){throw new Error("ReduxAdapter requires @reduxjs/toolkit to be installed. "+"Please install it: npm install @reduxjs/toolkit\n"+`Original error: ${error instanceof Error?error.message:String(error)}`)}}createSlice(sliceName,initialValue){try{const{createSlice}=require("@reduxjs/toolkit");const slice=createSlice({name:sliceName,initialState:initialValue,reducers:{setValue:(_state,action)=>{return action.payload??initialValue}}});return slice}catch(error){throw new Error("ReduxAdapter requires @reduxjs/toolkit to be installed. "+"Please install it: npm install @reduxjs/toolkit\n"+`Original error: ${error instanceof Error?error.message:String(error)}`)}}createInstance(initialValue,options){if(this.destroyed){throw new Error("ReduxAdapter has been destroyed")}const store=this.getOrCreateStore();const sliceName=options?.id?`secra_${String(options.id)}`:`secra_slice_${++this.sliceCounter}`;const slice=this.createSlice(sliceName,initialValue);if(!this.reducerManager.hasReducer(sliceName)){this.reducerManager.addReducer(sliceName,slice.reducer);store.replaceReducer(this.reducerManager.getRootReducer())}const instance=new ReduxStateInstance(store,sliceName,slice.actions,initialValue,{id:options?.id,scope:options?.scope,devMode:options?.devMode??this.devMode,middleware:options?.middleware});this.instances.add(instance);this.sliceToInstance.set(sliceName,instance);if(this.devMode){console.debug(`[ReduxAdapter] Created instance: ${String(instance.getId())}`,{sliceName,scope:options?.scope})}return instance}destroy(){if(this.destroyed){return}for(const instance of this.instances){instance.destroy()}for(const sliceName of this.sliceToInstance.keys()){this.reducerManager.removeReducer(sliceName)}if(this.store){this.store.replaceReducer(this.reducerManager.getRootReducer())}this.instances.clear();this.sliceToInstance.clear();this.store=null;this.destroyed=true;if(this.devMode){console.debug("[ReduxAdapter] Destroyed")}}getName(){return this.name}constructor(options){_define_property(this,"name","ReduxAdapter");_define_property(this,"destroyed",false);_define_property(this,"instances",new Set);_define_property(this,"store",null);_define_property(this,"sliceCounter",0);_define_property(this,"sliceToInstance",new Map);_define_property(this,"reducerManager",void 0);_define_property(this,"devMode",void 0);this.devMode=options?.devMode??false;this.reducerManager=new DynamicReducerManager;this.store=options?.store??null;this.checkReduxAvailable()}}

package/dist/state/adapters/ZustandAdapter.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"ZustandAdapter",{enumerable:true,get:function(){return ZustandAdapter}});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 ZustandAdapter=class ZustandAdapter{createInstance(_initialValue,_options){if(this.destroyed){throw new Error("Adapter has been destroyed")}throw new Error("ZustandAdapter is a placeholder implementation. "+"To use Zustand, you need to:\n"+"1. Install zustand\n"+"2. Implement a complete Zustand store integration\n"+"3. Map Zustand store methods to IStateInstance interface\n"+"See docs/state-manager.md for implementation guide.")}destroy(){if(this.destroyed){return}for(const instance of this.instances){instance.destroy()}this.instances.clear();this.destroyed=true}getName(){return this.name}constructor(){_define_property(this,"name","ZustandAdapter");_define_property(this,"destroyed",false);_define_property(this,"instances",new Set)}};

package/dist/state/adapters/ZustandAdapter.d.ts

@@ -1,46 +0,0 @@
-/**
- * Zustand 适配器（占位实现）
- *
- * 这是一个适配器接口示例，展示如何将 Zustand 集成到 Secra 状态管理器
- *
- * ⚠️ 注意：这是一个占位实现，实际使用时需要安装 zustand 依赖
- */
-import type { IStateAdapter, IStateInstance, StateInstanceOptions } from '../types';
-/**
- * Zustand 适配器
- *
- * 将 Zustand store 映射到 Secra 状态抽象
- *
- * ⚠️ 这是一个占位实现，实际使用时需要：
- * 1. 安装 zustand
- * 2. 实现完整的 Zustand store 集成
- * 3. 将 Zustand store 的方法映射到 IStateInstance 接口
- */
-export declare class ZustandAdapter implements IStateAdapter {
-    /**
-     * 适配器名称
-     */
-    private readonly name;
-    /**
-     * 是否已销毁
-     */
-    private destroyed;
-    /**
-     * 创建的状态实例集合
-     */
-    private readonly instances;
-    /**
-     * 创建状态实例
-     *
-     * ⚠️ 占位实现：实际使用时需要创建 Zustand store 并映射到 IStateInstance
-     */
-    createInstance<T>(_initialValue: T, _options?: StateInstanceOptions): IStateInstance<T>;
-    /**
-     * 销毁适配器
-     */
-    destroy(): void;
-    /**
-     * 获取适配器名称
-     */
-    getName(): string;
-}

package/dist/state/adapters/ZustandAdapter.js

@@ -1 +0,0 @@
-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}export class ZustandAdapter{createInstance(_initialValue,_options){if(this.destroyed){throw new Error("Adapter has been destroyed")}throw new Error("ZustandAdapter is a placeholder implementation. "+"To use Zustand, you need to:\n"+"1. Install zustand\n"+"2. Implement a complete Zustand store integration\n"+"3. Map Zustand store methods to IStateInstance interface\n"+"See docs/state-manager.md for implementation guide.")}destroy(){if(this.destroyed){return}for(const instance of this.instances){instance.destroy()}this.instances.clear();this.destroyed=true}getName(){return this.name}constructor(){_define_property(this,"name","ZustandAdapter");_define_property(this,"destroyed",false);_define_property(this,"instances",new Set)}}

package/dist/state/adapters/index.cjs

@@ -1 +0,0 @@
-"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 AdapterFactory(){return _AdapterFactory.AdapterFactory},get DefaultAdapter(){return _DefaultAdapter.DefaultAdapter},get ReduxAdapter(){return _ReduxAdapter.ReduxAdapter},get ZustandAdapter(){return _ZustandAdapter.ZustandAdapter}});const _DefaultAdapter=require("./DefaultAdapter");const _AdapterFactory=require("./AdapterFactory");const _ReduxAdapter=require("./ReduxAdapter");const _ZustandAdapter=require("./ZustandAdapter");_export_star(require("./types"),exports);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}

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

@@ -1,8 +0,0 @@
-/**
- * 状态适配器模块导出
- */
-export { DefaultAdapter } from './DefaultAdapter';
-export { AdapterFactory } from './AdapterFactory';
-export { ReduxAdapter, type ReduxAdapterOptions } from './ReduxAdapter';
-export { ZustandAdapter } from './ZustandAdapter';
-export * from './types';

package/dist/state/adapters/index.js

@@ -1 +0,0 @@
-export{DefaultAdapter}from"./DefaultAdapter";export{AdapterFactory}from"./AdapterFactory";export{ReduxAdapter}from"./ReduxAdapter";export{ZustandAdapter}from"./ZustandAdapter";export*from"./types";

package/dist/state/adapters/types.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("../types"),exports);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}

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

@@ -1,4 +0,0 @@
-/**
- * 状态适配器类型定义
- */
-export * from '../types';

package/dist/state/adapters/types.js

@@ -1 +0,0 @@
-export*from"../types";

package/dist/state/core/DerivedStateInstance.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"DerivedStateInstance",{enumerable:true,get:function(){return DerivedStateInstance}});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 DerivedStateInstance=class DerivedStateInstance{get(){if(this.destroyed){throw new Error(`DerivedStateInstance ${String(this.id)} has been destroyed`)}return this.value}set(_valueOrUpdater){throw new Error("Derived state cannot be set directly. Modify the dependency states instead.")}subscribe(subscriber){if(this.destroyed){throw new Error(`DerivedStateInstance ${String(this.id)} has been destroyed`)}this.subscribers.add(subscriber);return()=>{this.subscribers.delete(subscriber)}}getId(){return this.id}getScope(){return this.scope}getDependencies(){return this.config.dependencies}recompute(){if(this.destroyed||this.recomputing){return}this.recomputing=true;try{const dependencyValues=this.config.dependencies.map(dep=>dep.get());const newValue=this.config.derive(dependencyValues);const hasChanged=this.config.equalityCheck?!this.config.equalityCheck(this.value,newValue):this.value!==newValue;if(hasChanged){const previousValue=this.value;this.value=newValue;this.notifySubscribers(this.value,previousValue)}}catch(error){console.error(`[DerivedStateInstance] Error recomputing ${String(this.id)}:`,error)}finally{this.recomputing=false}}destroy(){if(this.destroyed){return}this.destroyed=true;for(const unsubscribe of this.dependencyUnsubscribes){unsubscribe()}this.dependencyUnsubscribes.length=0;this.subscribers.clear()}isDestroyed(){return this.destroyed}setupDependencies(){for(const dependency of this.config.dependencies){const unsubscribe=dependency.subscribe(()=>{this.recompute()});this.dependencyUnsubscribes.push(unsubscribe)}}notifySubscribers(value,previous){const subscribers=Array.from(this.subscribers);for(const subscriber of subscribers){try{subscriber(value,previous)}catch(error){console.error(`[DerivedStateInstance] Error in subscriber for ${String(this.id)}:`,error)}}}constructor(config,options={}){_define_property(this,"id",void 0);_define_property(this,"scope",void 0);_define_property(this,"config",void 0);_define_property(this,"value",void 0);_define_property(this,"subscribers",new Set);_define_property(this,"dependencyUnsubscribes",[]);_define_property(this,"destroyed",false);_define_property(this,"recomputing",false);this.config=config;this.id=options.id??Symbol("DerivedStateInstance");this.scope=options.scope;this.setupDependencies();this.recompute()}};

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

@@ -1,100 +0,0 @@
-/**
- * 派生状态实例实现
- */
-import type { IDerivedStateInstance, IStateInstance, DerivedStateConfig, StateInstanceId, StateScope, StateSubscriber, StateUpdater, Unsubscribe } from '../types';
-/**
- * 派生状态实例
- *
- * 派生状态不直接存储值，而是基于依赖状态自动计算
- *
- * @template T - 派生状态值类型
- * @template D - 依赖状态实例数组类型
- */
-export declare class DerivedStateInstance<T, D extends readonly IStateInstance[]> implements IDerivedStateInstance<T> {
-    /**
-     * 状态实例标识符
-     */
-    private readonly id;
-    /**
-     * 状态作用域
-     */
-    private readonly scope?;
-    /**
-     * 派生状态配置
-     */
-    private readonly config;
-    /**
-     * 当前派生值
-     */
-    private value;
-    /**
-     * 订阅者集合
-     */
-    private readonly subscribers;
-    /**
-     * 依赖状态的取消订阅函数数组
-     */
-    private readonly dependencyUnsubscribes;
-    /**
-     * 是否已销毁
-     */
-    private destroyed;
-    /**
-     * 是否正在重新计算
-     */
-    private recomputing;
-    /**
-     * 构造函数
-     *
-     * @param config - 派生状态配置
-     * @param options - 状态实例配置选项
-     */
-    constructor(config: DerivedStateConfig<T, D>, options?: {
-        id?: StateInstanceId;
-        scope?: StateScope;
-    });
-    /**
-     * 获取当前状态值
-     */
-    get(): T;
-    /**
-     * 派生状态不支持直接设置值
-     */
-    set(_valueOrUpdater: T | StateUpdater<T>): void;
-    /**
-     * 订阅状态变化
-     */
-    subscribe(subscriber: StateSubscriber<T>): Unsubscribe;
-    /**
-     * 获取状态实例标识符
-     */
-    getId(): StateInstanceId;
-    /**
-     * 获取状态作用域
-     */
-    getScope(): StateScope | undefined;
-    /**
-     * 获取依赖的状态实例
-     */
-    getDependencies(): readonly IStateInstance[];
-    /**
-     * 手动重新计算派生状态
-     */
-    recompute(): void;
-    /**
-     * 销毁状态实例
-     */
-    destroy(): void;
-    /**
-     * 检查状态实例是否已销毁
-     */
-    isDestroyed(): boolean;
-    /**
-     * 设置依赖状态订阅
-     */
-    private setupDependencies;
-    /**
-     * 通知所有订阅者
-     */
-    private notifySubscribers;
-}

package/dist/state/core/DerivedStateInstance.js

@@ -1 +0,0 @@
-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}export class DerivedStateInstance{get(){if(this.destroyed){throw new Error(`DerivedStateInstance ${String(this.id)} has been destroyed`)}return this.value}set(_valueOrUpdater){throw new Error("Derived state cannot be set directly. Modify the dependency states instead.")}subscribe(subscriber){if(this.destroyed){throw new Error(`DerivedStateInstance ${String(this.id)} has been destroyed`)}this.subscribers.add(subscriber);return()=>{this.subscribers.delete(subscriber)}}getId(){return this.id}getScope(){return this.scope}getDependencies(){return this.config.dependencies}recompute(){if(this.destroyed||this.recomputing){return}this.recomputing=true;try{const dependencyValues=this.config.dependencies.map(dep=>dep.get());const newValue=this.config.derive(dependencyValues);const hasChanged=this.config.equalityCheck?!this.config.equalityCheck(this.value,newValue):this.value!==newValue;if(hasChanged){const previousValue=this.value;this.value=newValue;this.notifySubscribers(this.value,previousValue)}}catch(error){console.error(`[DerivedStateInstance] Error recomputing ${String(this.id)}:`,error)}finally{this.recomputing=false}}destroy(){if(this.destroyed){return}this.destroyed=true;for(const unsubscribe of this.dependencyUnsubscribes){unsubscribe()}this.dependencyUnsubscribes.length=0;this.subscribers.clear()}isDestroyed(){return this.destroyed}setupDependencies(){for(const dependency of this.config.dependencies){const unsubscribe=dependency.subscribe(()=>{this.recompute()});this.dependencyUnsubscribes.push(unsubscribe)}}notifySubscribers(value,previous){const subscribers=Array.from(this.subscribers);for(const subscriber of subscribers){try{subscriber(value,previous)}catch(error){console.error(`[DerivedStateInstance] Error in subscriber for ${String(this.id)}:`,error)}}}constructor(config,options={}){_define_property(this,"id",void 0);_define_property(this,"scope",void 0);_define_property(this,"config",void 0);_define_property(this,"value",void 0);_define_property(this,"subscribers",new Set);_define_property(this,"dependencyUnsubscribes",[]);_define_property(this,"destroyed",false);_define_property(this,"recomputing",false);this.config=config;this.id=options.id??Symbol("DerivedStateInstance");this.scope=options.scope;this.setupDependencies();this.recompute()}}

package/dist/state/core/StateInstance.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"StateInstance",{enumerable:true,get:function(){return StateInstance}});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 StateInstance=class StateInstance{get(){if(this.destroyed){throw new Error(`StateInstance ${String(this.id)} has been destroyed`)}return this.value}set(valueOrUpdater){if(this.destroyed){throw new Error(`StateInstance ${String(this.id)} has been destroyed`)}const previousValue=this.value;let newValue;if(typeof valueOrUpdater==="function"){newValue=valueOrUpdater(this.value)}else{newValue=valueOrUpdater}let processedValue=newValue;for(const middleware of this.middleware){processedValue=middleware(processedValue,previousValue)}if(processedValue===this.value){return}this.value=processedValue;if(this.devMode){console.debug(`[StateInstance] Updated: ${String(this.id)}`,{previous:previousValue,current:this.value})}this.notifySubscribers(this.value,previousValue)}subscribe(subscriber){if(this.destroyed){throw new Error(`StateInstance ${String(this.id)} has been destroyed`)}this.subscribers.add(subscriber);if(this.devMode){console.debug(`[StateInstance] Subscribed: ${String(this.id)}`,{subscriberCount:this.subscribers.size})}return()=>{this.subscribers.delete(subscriber);if(this.devMode){console.debug(`[StateInstance] Unsubscribed: ${String(this.id)}`,{subscriberCount:this.subscribers.size})}}}getId(){return this.id}getScope(){return this.scope}destroy(){if(this.destroyed){return}this.destroyed=true;this.subscribers.clear();this.value=undefined;if(this.devMode){console.debug(`[StateInstance] Destroyed: ${String(this.id)}`)}}isDestroyed(){return this.destroyed}notifySubscribers(value,previous){const subscribers=Array.from(this.subscribers);for(const subscriber of subscribers){try{subscriber(value,previous)}catch(error){console.error(`[StateInstance] Error in subscriber for ${String(this.id)}:`,error)}}}constructor(initialValue,options={}){_define_property(this,"id",void 0);_define_property(this,"scope",void 0);_define_property(this,"value",void 0);_define_property(this,"subscribers",new Set);_define_property(this,"destroyed",false);_define_property(this,"devMode",void 0);_define_property(this,"middleware",void 0);this.value=initialValue;this.id=options.id??Symbol("StateInstance");this.scope=options.scope;this.devMode=options.devMode??false;this.middleware=options.middleware??[];if(this.devMode){console.debug(`[StateInstance] Created: ${String(this.id)}`,{scope:this.scope,initialValue:this.value})}}};