@hamak/ui-store-api 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc -p tsconfig.json

package/dist/api/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API Interfaces Export
+ */
+export * from './store-manager';
+export * from './middleware-registry';
+export * from './reducer-registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,6 @@
+/**
+ * API Interfaces Export
+ */
+export * from './store-manager';
+export * from './middleware-registry';
+export * from './reducer-registry';

package/dist/api/middleware-registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Middleware Registry Interface
+ * Extension point for plugins to contribute middleware
+ */
+import type { Middleware } from 'redux';
+import type { MiddlewareRegistration } from '../types';
+export interface IMiddlewareRegistry {
+    /**
+     * Register a middleware
+     */
+    register(registration: MiddlewareRegistration): void;
+    /**
+     * Unregister a middleware by ID
+     */
+    unregister(id: string): void;
+    /**
+     * Get all middleware in priority order
+     */
+    getAll(): Middleware[];
+    /**
+     * Check if middleware is registered
+     */
+    has(id: string): boolean;
+    /**
+     * Get middleware registration info
+     */
+    getInfo(id: string): MiddlewareRegistration | undefined;
+    /**
+     * Get all registrations with metadata
+     */
+    getAllRegistrations(): MiddlewareRegistration[];
+}
+//# sourceMappingURL=middleware-registry.d.ts.map

package/dist/api/middleware-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-registry.d.ts","sourceRoot":"","sources":["../../src/api/middleware-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,MAAM,IAAI,UAAU,EAAE,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAAC;IAExD;;OAEG;IACH,mBAAmB,IAAI,sBAAsB,EAAE,CAAC;CACjD"}

package/dist/api/middleware-registry.js

@@ -0,0 +1,5 @@
+/**
+ * Middleware Registry Interface
+ * Extension point for plugins to contribute middleware
+ */
+export {};

package/dist/api/reducer-registry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Reducer Registry Interface
+ * Allows dynamic reducer registration and hot replacement
+ */
+import type { Reducer } from 'redux';
+import type { ReducerMap, ReducerRegistration } from '../types';
+export interface IReducerRegistry {
+    /**
+     * Register a reducer for a state slice key
+     * @param key - State slice key
+     * @param reducer - Reducer function
+     * @param replace - Whether to replace existing reducer (default: false)
+     */
+    register(key: string, reducer: Reducer, replace?: boolean): void;
+    /**
+     * Unregister a reducer
+     * @param key - State slice key
+     */
+    unregister(key: string): void;
+    /**
+     * Get all registered reducers
+     */
+    getAll(): ReducerMap;
+    /**
+     * Get combined root reducer
+     */
+    getCombinedReducer(): Reducer;
+    /**
+     * Check if reducer is registered
+     */
+    has(key: string): boolean;
+    /**
+     * Get reducer registration info
+     */
+    getInfo(key: string): ReducerRegistration | undefined;
+    /**
+     * Get all registrations with metadata
+     */
+    getAllRegistrations(): ReducerRegistration[];
+}
+//# sourceMappingURL=reducer-registry.d.ts.map

package/dist/api/reducer-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer-registry.d.ts","sourceRoot":"","sources":["../../src/api/reducer-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,MAAM,IAAI,UAAU,CAAC;IAErB;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAEtD;;OAEG;IACH,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC9C"}

package/dist/api/reducer-registry.js

@@ -0,0 +1,5 @@
+/**
+ * Reducer Registry Interface
+ * Allows dynamic reducer registration and hot replacement
+ */
+export {};

package/dist/api/store-manager.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Store Manager Interface
+ * Main orchestrator for Redux store management
+ */
+import type { Store, Reducer, Action } from 'redux';
+import type { StoreConfig, RootState, AppAction } from '../types';
+import type { IMiddlewareRegistry } from './middleware-registry';
+import type { IReducerRegistry } from './reducer-registry';
+export interface IStoreManager {
+    /**
+     * Get the Redux store instance
+     * @throws Error if store is not initialized
+     */
+    getStore(): Store<RootState, AppAction>;
+    /**
+     * Check if store is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Initialize the store
+     * Should be called after all plugins have registered middleware/reducers
+     * @internal - Called by plugin framework during activation
+     */
+    initialize(config?: StoreConfig): Store<RootState, AppAction>;
+    /**
+     * Get middleware registry (for plugin contributions)
+     */
+    getMiddlewareRegistry(): IMiddlewareRegistry;
+    /**
+     * Get reducer registry (for dynamic reducers)
+     */
+    getReducerRegistry(): IReducerRegistry;
+    /**
+     * Dispatch an action
+     */
+    dispatch<A extends Action>(action: A): A;
+    /**
+     * Get current state
+     */
+    getState<S = RootState>(): S;
+    /**
+     * Subscribe to state changes
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Replace the root reducer (for hot module replacement)
+     */
+    replaceReducer(nextReducer: Reducer<RootState, AppAction>): void;
+    /**
+     * Destroy the store and clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=store-manager.d.ts.map

package/dist/api/store-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-manager.d.ts","sourceRoot":"","sources":["../../src/api/store-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAExC;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;;;OAIG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAE9D;;OAEG;IACH,qBAAqB,IAAI,mBAAmB,CAAC;IAE7C;;OAEG;IACH,kBAAkB,IAAI,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5C;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IAEjE;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/api/store-manager.js

@@ -0,0 +1,5 @@
+/**
+ * Store Manager Interface
+ * Main orchestrator for Redux store management
+ */
+export {};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * UI Store API
+ * Public interfaces, types, and tokens for Redux state management
+ */
+export * from './types';
+export * from './api';
+export * from './tokens';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * UI Store API
+ * Public interfaces, types, and tokens for Redux state management
+ */
+export * from './types';
+export * from './api';
+export * from './tokens';

package/dist/tokens/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tokens Export
+ */
+export * from './service-tokens';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC"}

package/dist/tokens/index.js

@@ -0,0 +1,4 @@
+/**
+ * Tokens Export
+ */
+export * from './service-tokens';

package/dist/tokens/service-tokens.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dependency Injection Tokens
+ * Used for service resolution in the microkernel
+ */
+export declare const STORE_MANAGER_TOKEN: unique symbol;
+export declare const MIDDLEWARE_REGISTRY_TOKEN: unique symbol;
+export declare const REDUCER_REGISTRY_TOKEN: unique symbol;
+//# sourceMappingURL=service-tokens.d.ts.map

package/dist/tokens/service-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-tokens.d.ts","sourceRoot":"","sources":["../../src/tokens/service-tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,eAAyB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,eAA+B,CAAC;AACtE,eAAO,MAAM,sBAAsB,eAA4B,CAAC"}

package/dist/tokens/service-tokens.js

@@ -0,0 +1,7 @@
+/**
+ * Dependency Injection Tokens
+ * Used for service resolution in the microkernel
+ */
+export const STORE_MANAGER_TOKEN = Symbol('StoreManager');
+export const MIDDLEWARE_REGISTRY_TOKEN = Symbol('MiddlewareRegistry');
+export const REDUCER_REGISTRY_TOKEN = Symbol('ReducerRegistry');

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Type Definitions Export
+ */
+export * from './store-types';
+export * from './middleware-types';
+export * from './reducer-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * Type Definitions Export
+ */
+export * from './store-types';
+export * from './middleware-types';
+export * from './reducer-types';

package/dist/types/middleware-types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Middleware Type Definitions
+ */
+import type { Middleware } from 'redux';
+/**
+ * Middleware registration with metadata
+ */
+export interface MiddlewareRegistration {
+    /** Unique identifier for this middleware */
+    id: string;
+    /** The Redux middleware function */
+    middleware: Middleware;
+    /** Execution priority (higher = runs earlier). Default: 0 */
+    priority?: number;
+    /** Plugin that registered this middleware */
+    plugin?: string;
+    /** Optional description for debugging */
+    description?: string;
+    /** Whether this middleware can be disabled */
+    optional?: boolean;
+}
+/**
+ * Middleware configuration
+ */
+export interface MiddlewareConfig {
+    /** Middleware IDs to disable */
+    disabled?: string[];
+    /** Override priorities for specific middleware */
+    priorities?: Record<string, number>;
+}
+//# sourceMappingURL=middleware-types.d.ts.map

package/dist/types/middleware-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-types.d.ts","sourceRoot":"","sources":["../../src/types/middleware-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,UAAU,EAAE,UAAU,CAAC;IAEvB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

package/dist/types/middleware-types.js

@@ -0,0 +1,4 @@
+/**
+ * Middleware Type Definitions
+ */
+export {};

package/dist/types/reducer-types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Reducer Type Definitions
+ */
+import type { Reducer } from 'redux';
+/**
+ * Reducer registration metadata
+ */
+export interface ReducerRegistration {
+    /** State slice key */
+    key: string;
+    /** The reducer function */
+    reducer: Reducer;
+    /** Plugin that registered this reducer */
+    plugin?: string;
+    /** Timestamp of registration */
+    registeredAt: Date;
+}
+/**
+ * Reducer map type
+ */
+export type ReducerMap = Record<string, Reducer>;
+//# sourceMappingURL=reducer-types.d.ts.map

package/dist/types/reducer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer-types.d.ts","sourceRoot":"","sources":["../../src/types/reducer-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IAEZ,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/types/reducer-types.js

@@ -0,0 +1,4 @@
+/**
+ * Reducer Type Definitions
+ */
+export {};

package/dist/types/store-types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Store Type Definitions
+ */
+import type { Store, Action, StoreEnhancer } from 'redux';
+/**
+ * Store configuration
+ */
+export interface StoreConfig {
+    /** Enable Redux DevTools integration */
+    devTools?: boolean;
+    /** Initial/preloaded state */
+    preloadedState?: any;
+    /** Additional store enhancers */
+    enhancers?: StoreEnhancer[];
+    /** Persistence configuration */
+    persistence?: {
+        /** Enable state persistence */
+        enabled: boolean;
+        /** Storage key prefix */
+        key?: string;
+        /** Storage type */
+        storage?: 'localStorage' | 'sessionStorage' | 'indexedDB';
+        /** Keys to persist (whitelist) */
+        whitelist?: string[];
+        /** Keys to ignore (blacklist) */
+        blacklist?: string[];
+    };
+}
+/**
+ * Root state shape (can be extended by applications)
+ */
+export interface RootState {
+    [key: string]: any;
+}
+/**
+ * Standard action shape following FSA (Flux Standard Action)
+ */
+export interface AppAction<T = any> extends Action<string> {
+    type: string;
+    payload?: T;
+    error?: boolean;
+    meta?: any;
+    [key: string]: any;
+}
+/**
+ * Store instance type
+ */
+export type AppStore = Store<RootState, AppAction>;
+//# sourceMappingURL=store-types.d.ts.map

package/dist/types/store-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-types.d.ts","sourceRoot":"","sources":["../../src/types/store-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,GAAG,CAAC;IAErB,iCAAiC;IACjC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAE5B,gCAAgC;IAChC,WAAW,CAAC,EAAE;QACZ,+BAA+B;QAC/B,OAAO,EAAE,OAAO,CAAC;QACjB,yBAAyB;QACzB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,mBAAmB;QACnB,OAAO,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,WAAW,CAAC;QAC1D,kCAAkC;QAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,iCAAiC;QACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,MAAM,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC"}

package/dist/types/store-types.js

@@ -0,0 +1,4 @@
+/**
+ * Store Type Definitions
+ */
+export {};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@hamak/ui-store-api",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "UI Store API - Redux store interfaces and contracts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amah/app-framework.git",
+    "directory": "packages/ui-store/ui-store-api"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "redux": "^5.0.1"
+  },
+  "devDependencies": {
+    "typescript": "~5.4.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/api/index.ts

@@ -0,0 +1,7 @@
+/**
+ * API Interfaces Export
+ */
+
+export * from './store-manager';
+export * from './middleware-registry';
+export * from './reducer-registry';

package/src/api/middleware-registry.ts

@@ -0,0 +1,39 @@
+/**
+ * Middleware Registry Interface
+ * Extension point for plugins to contribute middleware
+ */
+
+import type { Middleware } from 'redux';
+import type { MiddlewareRegistration } from '../types';
+
+export interface IMiddlewareRegistry {
+  /**
+   * Register a middleware
+   */
+  register(registration: MiddlewareRegistration): void;
+
+  /**
+   * Unregister a middleware by ID
+   */
+  unregister(id: string): void;
+
+  /**
+   * Get all middleware in priority order
+   */
+  getAll(): Middleware[];
+
+  /**
+   * Check if middleware is registered
+   */
+  has(id: string): boolean;
+
+  /**
+   * Get middleware registration info
+   */
+  getInfo(id: string): MiddlewareRegistration | undefined;
+
+  /**
+   * Get all registrations with metadata
+   */
+  getAllRegistrations(): MiddlewareRegistration[];
+}

package/src/api/reducer-registry.ts

@@ -0,0 +1,48 @@
+/**
+ * Reducer Registry Interface
+ * Allows dynamic reducer registration and hot replacement
+ */
+
+import type { Reducer } from 'redux';
+import type { ReducerMap, ReducerRegistration } from '../types';
+
+export interface IReducerRegistry {
+  /**
+   * Register a reducer for a state slice key
+   * @param key - State slice key
+   * @param reducer - Reducer function
+   * @param replace - Whether to replace existing reducer (default: false)
+   */
+  register(key: string, reducer: Reducer, replace?: boolean): void;
+
+  /**
+   * Unregister a reducer
+   * @param key - State slice key
+   */
+  unregister(key: string): void;
+
+  /**
+   * Get all registered reducers
+   */
+  getAll(): ReducerMap;
+
+  /**
+   * Get combined root reducer
+   */
+  getCombinedReducer(): Reducer;
+
+  /**
+   * Check if reducer is registered
+   */
+  has(key: string): boolean;
+
+  /**
+   * Get reducer registration info
+   */
+  getInfo(key: string): ReducerRegistration | undefined;
+
+  /**
+   * Get all registrations with metadata
+   */
+  getAllRegistrations(): ReducerRegistration[];
+}

package/src/api/store-manager.ts

@@ -0,0 +1,65 @@
+/**
+ * Store Manager Interface
+ * Main orchestrator for Redux store management
+ */
+
+import type { Store, Reducer, Action } from 'redux';
+import type { StoreConfig, RootState, AppAction } from '../types';
+import type { IMiddlewareRegistry } from './middleware-registry';
+import type { IReducerRegistry } from './reducer-registry';
+
+export interface IStoreManager {
+  /**
+   * Get the Redux store instance
+   * @throws Error if store is not initialized
+   */
+  getStore(): Store<RootState, AppAction>;
+
+  /**
+   * Check if store is initialized
+   */
+  isInitialized(): boolean;
+
+  /**
+   * Initialize the store
+   * Should be called after all plugins have registered middleware/reducers
+   * @internal - Called by plugin framework during activation
+   */
+  initialize(config?: StoreConfig): Store<RootState, AppAction>;
+
+  /**
+   * Get middleware registry (for plugin contributions)
+   */
+  getMiddlewareRegistry(): IMiddlewareRegistry;
+
+  /**
+   * Get reducer registry (for dynamic reducers)
+   */
+  getReducerRegistry(): IReducerRegistry;
+
+  /**
+   * Dispatch an action
+   */
+  dispatch<A extends Action>(action: A): A;
+
+  /**
+   * Get current state
+   */
+  getState<S = RootState>(): S;
+
+  /**
+   * Subscribe to state changes
+   * @returns Unsubscribe function
+   */
+  subscribe(listener: () => void): () => void;
+
+  /**
+   * Replace the root reducer (for hot module replacement)
+   */
+  replaceReducer(nextReducer: Reducer<RootState, AppAction>): void;
+
+  /**
+   * Destroy the store and clean up resources
+   */
+  destroy(): void;
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * UI Store API
+ * Public interfaces, types, and tokens for Redux state management
+ */
+
+export * from './types';
+export * from './api';
+export * from './tokens';

package/src/tokens/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Tokens Export
+ */
+
+export * from './service-tokens';

package/src/tokens/service-tokens.ts

@@ -0,0 +1,8 @@
+/**
+ * Dependency Injection Tokens
+ * Used for service resolution in the microkernel
+ */
+
+export const STORE_MANAGER_TOKEN = Symbol('StoreManager');
+export const MIDDLEWARE_REGISTRY_TOKEN = Symbol('MiddlewareRegistry');
+export const REDUCER_REGISTRY_TOKEN = Symbol('ReducerRegistry');

package/src/types/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Type Definitions Export
+ */
+
+export * from './store-types';
+export * from './middleware-types';
+export * from './reducer-types';

package/src/types/middleware-types.ts

@@ -0,0 +1,39 @@
+/**
+ * Middleware Type Definitions
+ */
+
+import type { Middleware } from 'redux';
+
+/**
+ * Middleware registration with metadata
+ */
+export interface MiddlewareRegistration {
+  /** Unique identifier for this middleware */
+  id: string;
+
+  /** The Redux middleware function */
+  middleware: Middleware;
+
+  /** Execution priority (higher = runs earlier). Default: 0 */
+  priority?: number;
+
+  /** Plugin that registered this middleware */
+  plugin?: string;
+
+  /** Optional description for debugging */
+  description?: string;
+
+  /** Whether this middleware can be disabled */
+  optional?: boolean;
+}
+
+/**
+ * Middleware configuration
+ */
+export interface MiddlewareConfig {
+  /** Middleware IDs to disable */
+  disabled?: string[];
+
+  /** Override priorities for specific middleware */
+  priorities?: Record<string, number>;
+}

package/src/types/reducer-types.ts

@@ -0,0 +1,27 @@
+/**
+ * Reducer Type Definitions
+ */
+
+import type { Reducer } from 'redux';
+
+/**
+ * Reducer registration metadata
+ */
+export interface ReducerRegistration {
+  /** State slice key */
+  key: string;
+
+  /** The reducer function */
+  reducer: Reducer;
+
+  /** Plugin that registered this reducer */
+  plugin?: string;
+
+  /** Timestamp of registration */
+  registeredAt: Date;
+}
+
+/**
+ * Reducer map type
+ */
+export type ReducerMap = Record<string, Reducer>;

package/src/types/store-types.ts

@@ -0,0 +1,56 @@
+/**
+ * Store Type Definitions
+ */
+
+import type { Store, Reducer, Action, StoreEnhancer } from 'redux';
+
+/**
+ * Store configuration
+ */
+export interface StoreConfig {
+  /** Enable Redux DevTools integration */
+  devTools?: boolean;
+
+  /** Initial/preloaded state */
+  preloadedState?: any;
+
+  /** Additional store enhancers */
+  enhancers?: StoreEnhancer[];
+
+  /** Persistence configuration */
+  persistence?: {
+    /** Enable state persistence */
+    enabled: boolean;
+    /** Storage key prefix */
+    key?: string;
+    /** Storage type */
+    storage?: 'localStorage' | 'sessionStorage' | 'indexedDB';
+    /** Keys to persist (whitelist) */
+    whitelist?: string[];
+    /** Keys to ignore (blacklist) */
+    blacklist?: string[];
+  };
+}
+
+/**
+ * Root state shape (can be extended by applications)
+ */
+export interface RootState {
+  [key: string]: any;
+}
+
+/**
+ * Standard action shape following FSA (Flux Standard Action)
+ */
+export interface AppAction<T = any> extends Action<string> {
+  type: string;
+  payload?: T;
+  error?: boolean;
+  meta?: any;
+  [key: string]: any;
+}
+
+/**
+ * Store instance type
+ */
+export type AppStore = Store<RootState, AppAction>;

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "strict": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "allowImportingTsExtensions": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}