@composy/store-core 0.0.1

package/es/types/middleware.d.ts

@@ -0,0 +1,172 @@
+/**
+ * 中间件系统类型定义
+ *
+ * @module types/middleware
+ */
+import type { StateTree, StoreId } from './store';
+/**
+ * 中间件上下文
+ * @template S - 状态类型
+ */
+export interface MiddlewareContext<S extends StateTree = StateTree> {
+    /** Store ID */
+    storeId: StoreId;
+    /** 当前状态 */
+    state: S;
+    /** 操作类型 */
+    type: MiddlewareActionType;
+    /** 操作数据 */
+    payload?: unknown;
+    /** 元数据 */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 中间件操作类型
+ */
+export type MiddlewareActionType = 'state:init' | 'state:patch' | 'state:reset' | 'action:before' | 'action:after' | 'action:error';
+/**
+ * 中间件函数类型
+ * @template S - 状态类型
+ */
+export type MiddlewareFunction<S extends StateTree = StateTree> = (context: MiddlewareContext<S>, next: () => void | Promise<void>) => void | Promise<void>;
+/**
+ * 中间件接口
+ * @template S - 状态类型
+ */
+export interface Middleware<S extends StateTree = StateTree> {
+    /** 中间件名称 */
+    readonly name: string;
+    /** 中间件优先级（数字越小越先执行） */
+    readonly priority?: number;
+    /** 中间件处理函数 */
+    handler: MiddlewareFunction<S>;
+}
+/**
+ * 中间件管理器接口
+ */
+export interface MiddlewareManager {
+    /**
+     * 添加中间件
+     * @param middleware - 中间件实例
+     */
+    use: (middleware: Middleware) => void;
+    /**
+     * 移除中间件
+     * @param name - 中间件名称
+     */
+    remove: (name: string) => void;
+    /**
+     * 获取中间件
+     * @param name - 中间件名称
+     */
+    get: (name: string) => Middleware | undefined;
+    /**
+     * 是否存在中间件
+     * @param name - 中间件名称
+     */
+    has: (name: string) => boolean;
+    /**
+     * 执行中间件链
+     * @param context - 上下文
+     */
+    execute: (context: MiddlewareContext) => Promise<void>;
+    /**
+     * 获取所有中间件
+     */
+    getAll: () => Middleware[];
+    /**
+     * 清空所有中间件
+     */
+    clear: () => void;
+}
+/**
+ * 日志中间件选项
+ */
+export interface LoggerMiddlewareOptions {
+    /** 是否记录状态变化 */
+    logState?: boolean;
+    /** 是否记录 action */
+    logAction?: boolean;
+    /** 是否折叠日志 */
+    collapsed?: boolean;
+    /** 是否显示时间戳 */
+    timestamp?: boolean;
+    /** 日志级别 */
+    level?: 'log' | 'info' | 'warn' | 'debug';
+    /** 自定义日志器 */
+    logger?: {
+        log: (...args: unknown[]) => void;
+        info: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+        debug: (...args: unknown[]) => void;
+        error?: (...args: unknown[]) => void;
+        group?: (...args: unknown[]) => void;
+        groupCollapsed?: (...args: unknown[]) => void;
+        groupEnd?: () => void;
+    };
+    /** 自定义过滤器 */
+    filter?: (context: MiddlewareContext) => boolean;
+}
+/**
+ * 持久化中间件选项
+ */
+export interface PersistMiddlewareOptions {
+    /** 存储键名前缀 */
+    keyPrefix?: string;
+    /** 存储类型 */
+    storage?: 'localStorage' | 'sessionStorage';
+    /** 要持久化的 Store ID 列表（空则全部持久化） */
+    stores?: StoreId[];
+    /** 要持久化的状态路径 */
+    paths?: Record<StoreId, string[]>;
+    /** 序列化函数 */
+    serialize?: (value: unknown) => string;
+    /** 反序列化函数 */
+    deserialize?: (value: string) => unknown;
+    /** 防抖延迟（毫秒） */
+    debounce?: number;
+}
+/**
+ * 时间旅行中间件选项
+ */
+export interface TimeTravelMiddlewareOptions {
+    /** 最大历史记录数 */
+    maxHistory?: number;
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/**
+ * 时间旅行控制器
+ */
+export interface TimeTravelController {
+    /** 撤销 */
+    undo: () => void;
+    /** 重做 */
+    redo: () => void;
+    /** 跳转到指定历史 */
+    goto: (index: number) => void;
+    /** 获取历史记录 */
+    getHistory: () => StateSnapshot[];
+    /** 当前历史索引 */
+    getCurrentIndex: () => number;
+    /** 是否可撤销 */
+    canUndo: () => boolean;
+    /** 是否可重做 */
+    canRedo: () => boolean;
+    /** 清空历史 */
+    clear: () => void;
+}
+/**
+ * 状态快照
+ */
+export interface StateSnapshot {
+    /** 快照时间 */
+    timestamp: number;
+    /** 状态数据 */
+    state: StateTree;
+    /** 操作类型 */
+    type: MiddlewareActionType;
+    /** Store ID */
+    storeId: StoreId;
+}
+//# sourceMappingURL=middleware.d.ts.map

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

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

package/es/types/middleware.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/plugin.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 插件系统类型定义
+ *
+ * @module types/plugin
+ */
+import type { StateTree, StoreId } from './store';
+/**
+ * 插件上下文
+ */
+export interface PluginContext {
+    /** Store 管理器实例 */
+    storeManager: StoreManagerLike;
+    /** 当前 Store ID */
+    storeId: StoreId;
+    /** 当前 Store 实例 */
+    store: unknown;
+    /** 插件配置选项 */
+    options: Record<string, unknown>;
+}
+/**
+ * Store 管理器接口（简化版）
+ */
+export interface StoreManagerLike {
+    /** 获取 Store */
+    getStore: (id: StoreId) => unknown;
+    /** 是否存在 Store */
+    hasStore: (id: StoreId) => boolean;
+    /** 获取所有 Store ID */
+    getStoreIds: () => StoreId[];
+}
+/**
+ * 插件接口
+ * @template Options - 插件选项类型
+ */
+export interface StorePlugin<Options = Record<string, unknown>> {
+    /** 插件名称 */
+    readonly name: string;
+    /** 插件版本 */
+    readonly version?: string;
+    /** 插件描述 */
+    readonly description?: string;
+    /**
+     * 安装插件
+     * @param context - 插件上下文
+     * @param options - 插件选项
+     */
+    install: (context: PluginContext, options?: Options) => void | Promise<void>;
+    /**
+     * 卸载插件
+     * @param context - 插件上下文
+     */
+    uninstall?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * Store 创建时的钩子
+     * @param store - Store 实例
+     */
+    onStoreCreated?: (store: unknown) => void;
+    /**
+     * Store 销毁时的钩子
+     * @param store - Store 实例
+     */
+    onStoreDisposed?: (store: unknown) => void;
+    /**
+     * 状态变化时的钩子
+     * @param storeId - Store ID
+     * @param state - 新状态
+     * @param oldState - 旧状态
+     */
+    onStateChange?: <S extends StateTree>(storeId: StoreId, state: S, oldState: S) => void;
+}
+/**
+ * 插件工厂函数类型
+ * @template Options - 插件选项类型
+ */
+export type PluginFactory<Options = Record<string, unknown>> = (options?: Options) => StorePlugin<Options>;
+/**
+ * 定义插件选项
+ * @template Options - 插件选项类型
+ */
+export interface DefinePluginOptions<Options = Record<string, unknown>> {
+    /** 插件名称 */
+    name: string;
+    /** 插件版本 */
+    version?: string;
+    /** 插件描述 */
+    description?: string;
+    /** 安装函数 */
+    install: StorePlugin<Options>['install'];
+    /** 卸载函数 */
+    uninstall?: StorePlugin<Options>['uninstall'];
+    /** Store 创建钩子 */
+    onStoreCreated?: StorePlugin<Options>['onStoreCreated'];
+    /** Store 销毁钩子 */
+    onStoreDisposed?: StorePlugin<Options>['onStoreDisposed'];
+    /** 状态变化钩子 */
+    onStateChange?: StorePlugin<Options>['onStateChange'];
+}
+/**
+ * 插件管理器接口
+ */
+export interface PluginManager {
+    /**
+     * 注册插件
+     * @param plugin - 插件实例
+     * @param options - 插件选项
+     */
+    use: <Options>(plugin: StorePlugin<Options>, options?: Options) => void;
+    /**
+     * 移除插件
+     * @param name - 插件名称
+     */
+    remove: (name: string) => void;
+    /**
+     * 获取插件
+     * @param name - 插件名称
+     */
+    get: (name: string) => StorePlugin | undefined;
+    /**
+     * 是否已注册插件
+     * @param name - 插件名称
+     */
+    has: (name: string) => boolean;
+    /**
+     * 获取所有插件
+     */
+    getAll: () => Map<string, StorePlugin>;
+    /**
+     * 获取插件数量
+     */
+    size: () => number;
+    /**
+     * 清空所有插件
+     */
+    clear: () => void;
+}
+//# sourceMappingURL=plugin.d.ts.map

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

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

package/es/types/plugin.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/store.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Store 核心类型定义
+ *
+ * @module types/store
+ */
+/**
+ * 状态对象类型
+ */
+export type StateTree = Record<string | number | symbol, unknown>;
+/**
+ * Store ID 类型
+ */
+export type StoreId = string;
+/**
+ * Getter 函数类型
+ * @template S - 状态类型
+ * @template R - 返回值类型
+ */
+export type StoreGetter<S extends StateTree, R> = (state: S) => R;
+/**
+ * Getter 集合类型
+ * @template S - 状态类型
+ */
+export type StoreGetters<S extends StateTree> = Record<string, StoreGetter<S, unknown>>;
+/**
+ * Action 函数类型
+ *
+ * 允许 action 通过 `this` 访问当前 Store 实例；未使用 `this` 的普通函数依旧兼容。
+ */
+export type StoreAction = (...args: unknown[]) => unknown;
+/**
+ * Action 集合类型
+ */
+export type StoreActions = Record<string, StoreAction>;
+/**
+ * Store 定义选项
+ * @template Id - Store ID 类型
+ * @template S - 状态类型
+ * @template G - Getters 类型
+ * @template A - Actions 类型
+ */
+export interface StoreDefinition<Id extends StoreId = StoreId, S extends StateTree = StateTree, G extends StoreGetters<S> = StoreGetters<S>, A extends StoreActions = StoreActions> {
+    /** Store 唯一标识 */
+    id: Id;
+    /** 初始状态工厂函数 */
+    state: () => S;
+    /** Getters 定义 */
+    getters?: G;
+    /** Actions 定义 */
+    actions?: A;
+}
+/**
+ * Store 实例接口
+ * @template Id - Store ID 类型
+ * @template S - 状态类型
+ * @template G - Getters 类型
+ * @template A - Actions 类型
+ */
+export interface StoreInstance<Id extends StoreId = StoreId, S extends StateTree = StateTree, G extends StoreGetters<S> = StoreGetters<S>, A extends StoreActions = StoreActions> {
+    /** Store 唯一标识 */
+    $id: Id;
+    /** 当前状态 */
+    $state: S;
+    /** Getter 计算结果 */
+    getters: {
+        [K in keyof G]: ReturnType<G[K]>;
+    };
+    /** Action 方法集合 */
+    actions: A;
+    /**
+     * 重置状态到初始值
+     */
+    $reset: () => void;
+    /**
+     * 批量更新状态
+     * @param partialState - 部分状态或更新函数
+     */
+    $patch: (partialState: Partial<S> | ((state: S) => void)) => void;
+    /**
+     * 订阅状态变化
+     * @param callback - 回调函数
+     * @param options - 订阅选项
+     * @returns 取消订阅函数
+     */
+    $subscribe: (callback: StateSubscriber<S>, options?: SubscribeOptions) => () => void;
+    /**
+     * 订阅 action 调用
+     * @param callback - 回调函数
+     * @returns 取消订阅函数
+     */
+    $onAction: (callback: ActionSubscriber<A>) => () => void;
+    /**
+     * 销毁 store
+     */
+    $dispose: () => void;
+}
+/**
+ * 状态变化订阅器
+ * @template S - 状态类型
+ */
+export type StateSubscriber<S extends StateTree> = (mutation: StateMutation<S>, state: S) => void;
+/**
+ * 状态变化信息
+ * @template S - 状态类型
+ */
+export interface StateMutation<S extends StateTree> {
+    /** 变化类型 */
+    type: 'direct' | 'patch object' | 'patch function';
+    /** Store ID */
+    storeId: StoreId;
+    /** 变化的键路径 */
+    events?: string[];
+    /** 变化前的状态快照 */
+    oldState?: Partial<S>;
+}
+/**
+ * 订阅选项
+ */
+export interface SubscribeOptions {
+    /** 是否立即执行一次 */
+    immediate?: boolean;
+    /** 是否深度监听 */
+    deep?: boolean;
+    /** 是否在组件卸载后继续监听 */
+    detached?: boolean;
+}
+/**
+ * Action 订阅器
+ * @template A - Actions 类型
+ */
+export type ActionSubscriber<A extends StoreActions> = (context: ActionContext<A>) => void;
+/**
+ * Action 上下文
+ * @template A - Actions 类型
+ */
+export interface ActionContext<A extends StoreActions> {
+    /** Action 名称 */
+    name: keyof A;
+    /** Store ID */
+    storeId: StoreId;
+    /** 调用参数 */
+    args: unknown[];
+    /** 执行后回调，异步 action 会在 Promise resolve 后触发 */
+    after: (callback: (result: unknown) => void | Promise<void>) => void;
+    /** 错误回调，异步 action 会在 Promise reject 后触发 */
+    onError: (callback: (error: unknown) => void | Promise<void>) => void;
+}
+/**
+ * Store 配置选项
+ */
+export interface StoreOptions {
+    /** 是否启用严格模式（只能通过 action 修改状态） */
+    strict?: boolean;
+    /** 是否启用开发工具 */
+    devtools?: boolean;
+    /** 是否启用持久化 */
+    persist?: boolean;
+    /** 持久化配置 */
+    persistOptions?: PersistOptions;
+}
+/**
+ * 持久化选项
+ */
+export interface PersistOptions {
+    /** 存储键名 */
+    key?: string;
+    /** 存储类型 */
+    storage?: 'localStorage' | 'sessionStorage' | 'custom';
+    /** 自定义存储适配器 */
+    customStorage?: StorageAdapter;
+    /** 要持久化的路径 */
+    paths?: string[];
+    /** 序列化函数 */
+    serializer?: {
+        serialize: (value: unknown) => string;
+        deserialize: (value: string) => unknown;
+    };
+    /** 恢复前回调 */
+    beforeRestore?: (context: {
+        store: unknown;
+    }) => void;
+    /** 恢复后回调 */
+    afterRestore?: (context: {
+        store: unknown;
+    }) => void;
+}
+/**
+ * 存储适配器接口
+ */
+export interface StorageAdapter {
+    /** 获取数据 */
+    getItem: (key: string) => string | null | Promise<string | null>;
+    /** 设置数据 */
+    setItem: (key: string, value: string) => void | Promise<void>;
+    /** 删除数据 */
+    removeItem: (key: string) => void | Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/types/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAA;AAEjE;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAA;AAE5B;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;AAEjE;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;AAEvF;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAC9B,EAAE,SAAS,OAAO,GAAG,OAAO,EAC5B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAC3C,CAAC,SAAS,YAAY,GAAG,YAAY;IAErC,iBAAiB;IACjB,EAAE,EAAE,EAAE,CAAA;IACN,eAAe;IACf,KAAK,EAAE,MAAM,CAAC,CAAA;IACd,iBAAiB;IACjB,OAAO,CAAC,EAAE,CAAC,CAAA;IACX,iBAAiB;IACjB,OAAO,CAAC,EAAE,CAAC,CAAA;CACZ;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAC5B,EAAE,SAAS,OAAO,GAAG,OAAO,EAC5B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAC3C,CAAC,SAAS,YAAY,GAAG,YAAY;IAErC,iBAAiB;IACjB,GAAG,EAAE,EAAE,CAAA;IAEP,WAAW;IACX,MAAM,EAAE,CAAC,CAAA;IAET,kBAAkB;IAClB,OAAO,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAA;IAE7C,kBAAkB;IAClB,OAAO,EAAE,CAAC,CAAA;IAEV;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAA;IAElB;;;OAGG;IACH,MAAM,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAA;IAEjE;;;;;OAKG;IACH,UAAU,EAAE,CACV,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,gBAAgB,KACvB,MAAM,IAAI,CAAA;IAEf;;;;OAIG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAA;IAExD;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,SAAS,IAAI,CACjD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,KACL,IAAI,CAAA;AAET;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,SAAS;IAChD,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,gBAAgB,CAAA;IAClD,eAAe;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,mBAAmB;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;AAE1F;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,YAAY;IACnD,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC,CAAA;IACb,eAAe;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW;IACX,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,6CAA6C;IAC7C,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;IACpE,2CAA2C;IAC3C,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY;IACZ,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,QAAQ,CAAA;IACtD,eAAe;IACf,aAAa,CAAC,EAAE,cAAc,CAAA;IAC9B,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,YAAY;IACZ,UAAU,CAAC,EAAE;QACX,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;QACrC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KACxC,CAAA;IACD,YAAY;IACZ,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAA;IACrD,YAAY;IACZ,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAA;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAChE,WAAW;IACX,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,WAAW;IACX,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD"}

package/es/types/store.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 */