@fukict/flux 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fukict Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/dist/Flux.d.ts

@@ -0,0 +1,60 @@
+import type { FluxInstance, FluxListener, FluxSelector, Unsubscribe } from './types';
+/**
+ * Flux state management class
+ *
+ * Responsibilities:
+ * 1. State storage
+ * 2. Subscription management
+ * 3. State reading
+ * 4. State update interface (called by external Actions)
+ */
+export declare class Flux<T> implements FluxInstance<T> {
+    /**
+     * Current state (internal storage)
+     */
+    private internalState;
+    /**
+     * State proxy (readonly, returned to external)
+     */
+    private stateProxy;
+    /**
+     * Subscription list
+     */
+    private subscriptions;
+    /**
+     * Constructor
+     * @param initialState Initial state
+     */
+    constructor(initialState: T);
+    /**
+     * Create readonly proxy
+     */
+    private createReadonlyProxy;
+    /**
+     * Get current state snapshot (readonly proxy)
+     */
+    getState(): T;
+    /**
+     * Update state
+     * @param newState New state (full replacement or partial update)
+     */
+    setState(newState: Partial<T> | T): void;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener: FluxListener<T>): Unsubscribe;
+    subscribe<S>(selector: FluxSelector<T, S>, listener: FluxListener<S>): Unsubscribe;
+    /**
+     * Notify all subscribers
+     */
+    private notify;
+    /**
+     * Determine if it's a partial update
+     */
+    private isPartialUpdate;
+    /**
+     * Shallow compare two values for equality
+     */
+    private shallowEqual;
+}
+//# sourceMappingURL=Flux.d.ts.map

package/dist/Flux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Flux.d.ts","sourceRoot":"","sources":["../src/Flux.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAWjB;;;;;;;;GAQG;AACH,qBAAa,IAAI,CAAC,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC7C;;OAEG;IACH,OAAO,CAAC,aAAa,CAAI;IAEzB;;OAEG;IACH,OAAO,CAAC,UAAU,CAAI;IAEtB;;OAEG;IACH,OAAO,CAAC,aAAa,CAAwC;IAE7D;;;OAGG;gBACS,YAAY,EAAE,CAAC;IAK3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiD3B;;OAEG;IACH,QAAQ,IAAI,CAAC;IAIb;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI;IAiBxC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW;IACjD,SAAS,CAAC,CAAC,EACT,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,WAAW;IAkCd;;OAEG;IACH,OAAO,CAAC,MAAM;IAgBd;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,YAAY;CAoCrB"}

package/dist/Flux.js

@@ -0,0 +1,181 @@
+/**
+ * Flux state management class
+ *
+ * Responsibilities:
+ * 1. State storage
+ * 2. Subscription management
+ * 3. State reading
+ * 4. State update interface (called by external Actions)
+ */
+export class Flux {
+    /**
+     * Current state (internal storage)
+     */
+    internalState;
+    /**
+     * State proxy (readonly, returned to external)
+     */
+    stateProxy;
+    /**
+     * Subscription list
+     */
+    subscriptions = new Set();
+    /**
+     * Constructor
+     * @param initialState Initial state
+     */
+    constructor(initialState) {
+        this.internalState = initialState;
+        this.stateProxy = this.createReadonlyProxy(initialState);
+    }
+    /**
+     * Create readonly proxy
+     */
+    createReadonlyProxy(state) {
+        return new Proxy(state, {
+            get(target, prop, receiver) {
+                const value = Reflect.get(target, prop, receiver);
+                // If value is an object, wrap it in readonly proxy too
+                if (value !== null && typeof value === 'object') {
+                    return new Proxy(value, {
+                        get: (t, p, r) => Reflect.get(t, p, r),
+                        set: () => {
+                            if (process.env.NODE_ENV !== 'production') {
+                                console.warn('[Flux] Direct state mutation is not allowed. Please use setState() method.');
+                            }
+                            return false;
+                        },
+                        deleteProperty: () => {
+                            if (process.env.NODE_ENV !== 'production') {
+                                console.warn('[Flux] Direct state mutation is not allowed. Please use setState() method.');
+                            }
+                            return false;
+                        },
+                    });
+                }
+                return value;
+            },
+            set: () => {
+                if (process.env.NODE_ENV !== 'production') {
+                    console.warn('[Flux] Direct state mutation is not allowed. Please use setState() method.');
+                }
+                return false;
+            },
+            deleteProperty: () => {
+                if (process.env.NODE_ENV !== 'production') {
+                    console.warn('[Flux] Direct state mutation is not allowed. Please use setState() method.');
+                }
+                return false;
+            },
+        });
+    }
+    /**
+     * Get current state snapshot (readonly proxy)
+     */
+    getState() {
+        return this.stateProxy;
+    }
+    /**
+     * Update state
+     * @param newState New state (full replacement or partial update)
+     */
+    setState(newState) {
+        // Determine if it's a full replacement or partial update
+        if (this.isPartialUpdate(newState)) {
+            // Partial update: shallow merge
+            this.internalState = { ...this.internalState, ...newState };
+        }
+        else {
+            // Full replacement
+            this.internalState = newState;
+        }
+        // Update proxy
+        this.stateProxy = this.createReadonlyProxy(this.internalState);
+        // Notify all subscribers
+        this.notify();
+    }
+    subscribe(selectorOrListener, listener) {
+        let subscription;
+        // Determine if it's a normal subscription or selector subscription
+        if (listener) {
+            // Selector subscription
+            const selector = selectorOrListener;
+            const initialValue = selector(this.internalState);
+            subscription = {
+                listener,
+                selector,
+                lastValue: initialValue,
+            };
+        }
+        else {
+            // Normal subscription
+            subscription = {
+                listener: selectorOrListener,
+            };
+        }
+        // Add to subscription list
+        this.subscriptions.add(subscription);
+        // Return unsubscribe function
+        return () => {
+            this.subscriptions.delete(subscription);
+        };
+    }
+    /**
+     * Notify all subscribers
+     */
+    notify() {
+        for (const subscription of this.subscriptions) {
+            if (subscription.selector) {
+                // Selector subscription: compare old and new values
+                const newValue = subscription.selector(this.internalState);
+                if (!this.shallowEqual(subscription.lastValue, newValue)) {
+                    subscription.lastValue = newValue;
+                    subscription.listener(newValue);
+                }
+            }
+            else {
+                // Normal subscription: notify directly (pass proxy)
+                subscription.listener(this.stateProxy);
+            }
+        }
+    }
+    /**
+     * Determine if it's a partial update
+     */
+    isPartialUpdate(newState) {
+        // Simple heuristic:
+        // If newState has fewer keys than current state, consider it a partial update
+        const newKeys = Object.keys(newState);
+        const stateKeys = Object.keys(this.internalState);
+        return newKeys.length < stateKeys.length;
+    }
+    /**
+     * Shallow compare two values for equality
+     */
+    shallowEqual(a, b) {
+        // Primitive type comparison
+        if (Object.is(a, b)) {
+            return true;
+        }
+        // null/undefined comparison
+        if (a == null || b == null) {
+            return false;
+        }
+        // Object shallow comparison
+        if (typeof a === 'object' && typeof b === 'object') {
+            const keysA = Object.keys(a);
+            const keysB = Object.keys(b);
+            if (keysA.length !== keysB.length) {
+                return false;
+            }
+            for (const key of keysA) {
+                if (!Object.is(a[key], b[key])) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=Flux.js.map

package/dist/Flux.js.map

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

package/dist/createFlux.d.ts

@@ -0,0 +1,26 @@
+import type { CreateFluxConfig, FluxStore } from './types';
+/**
+ * Factory function to create Flux Store
+ *
+ * @param config Configuration object
+ * @returns Flux Store object
+ *
+ * @example
+ * ```typescript
+ * const counterStore = createFlux({
+ *   state: { count: 0 },
+ *   actions: (flux) => ({
+ *     increment() {
+ *       const state = flux.getState();
+ *       flux.setState({ count: state.count + 1 });
+ *     }
+ *   })
+ * });
+ *
+ * // Usage
+ * counterStore.actions.increment();
+ * counterStore.subscribe((state) => console.log(state.count));
+ * ```
+ */
+export declare function createFlux<T, A = {}>(config: CreateFluxConfig<T, A>): FluxStore<T, A>;
+//# sourceMappingURL=createFlux.d.ts.map

package/dist/createFlux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFlux.d.ts","sourceRoot":"","sources":["../src/createFlux.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAClC,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAmBjB"}

package/dist/createFlux.js

@@ -0,0 +1,41 @@
+import { Flux } from './Flux';
+/**
+ * Factory function to create Flux Store
+ *
+ * @param config Configuration object
+ * @returns Flux Store object
+ *
+ * @example
+ * ```typescript
+ * const counterStore = createFlux({
+ *   state: { count: 0 },
+ *   actions: (flux) => ({
+ *     increment() {
+ *       const state = flux.getState();
+ *       flux.setState({ count: state.count + 1 });
+ *     }
+ *   })
+ * });
+ *
+ * // Usage
+ * counterStore.actions.increment();
+ * counterStore.subscribe((state) => console.log(state.count));
+ * ```
+ */
+export function createFlux(config) {
+    // Create Flux instance
+    const flux = new Flux(config.state);
+    // Create Actions (if provided)
+    const actions = (config.actions ? config.actions(flux) : {});
+    // Return unified interface
+    return {
+        flux,
+        actions,
+        // Shortcut methods: delegate to flux instance
+        getState: () => flux.getState(),
+        setState: newState => flux.setState(newState),
+        // subscribe method - TypeScript will infer the correct overload from FluxStore<T, A>
+        subscribe: flux.subscribe.bind(flux),
+    };
+}
+//# sourceMappingURL=createFlux.js.map

package/dist/createFlux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFlux.js","sourceRoot":"","sources":["../src/createFlux.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CACxB,MAA8B;IAE9B,uBAAuB;IACvB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvC,+BAA+B;IAC/B,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAM,CAAC;IAElE,2BAA2B;IAC3B,OAAO;QACL,IAAI;QACJ,OAAO;QAEP,8CAA8C;QAC9C,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAE7C,qFAAqF;QACrF,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fukict/flux - Minimal state management library for Fukict framework
+ *
+ * Core philosophy: Flux itself has no update permission, only provides subscription mechanism.
+ */
+export { Flux } from './Flux';
+export { createFlux } from './createFlux';
+export type { FluxListener, FluxSelector, Unsubscribe, CreateFluxConfig, FluxInstance, FluxStore, } from './types';
+//# 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;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @fukict/flux - Minimal state management library for Fukict framework
+ *
+ * Core philosophy: Flux itself has no update permission, only provides subscription mechanism.
+ */
+// 导出核心类
+export { Flux } from './Flux';
+// 导出工厂函数
+export { createFlux } from './createFlux';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Flux listener function type
+ */
+export type FluxListener<T> = (state: T) => void;
+/**
+ * Selector function type
+ */
+export type FluxSelector<T, S> = (state: T) => S;
+/**
+ * Unsubscribe function type
+ */
+export type Unsubscribe = () => void;
+/**
+ * createFlux configuration type
+ */
+export interface CreateFluxConfig<T, A> {
+    /**
+     * Initial state
+     */
+    state: T;
+    /**
+     * Actions definition (optional)
+     */
+    actions?: (flux: FluxInstance<T>) => A;
+}
+/**
+ * Flux instance interface (internal use)
+ */
+export interface FluxInstance<T> {
+    getState(): T;
+    setState(newState: Partial<T> | T): void;
+    subscribe(listener: FluxListener<T>): Unsubscribe;
+    subscribe<S>(selector: FluxSelector<T, S>, listener: FluxListener<S>): Unsubscribe;
+}
+/**
+ * createFlux return type
+ */
+export interface FluxStore<T, A> {
+    /**
+     * Flux instance
+     */
+    flux: FluxInstance<T>;
+    /**
+     * Actions object
+     */
+    actions: A;
+    /**
+     * Get current state (shortcut method)
+     */
+    getState(): T;
+    /**
+     * Update state (shortcut method)
+     */
+    setState(newState: Partial<T> | T): void;
+    /**
+     * Subscribe to state changes (shortcut method)
+     */
+    subscribe(listener: FluxListener<T>): Unsubscribe;
+    subscribe<S>(selector: FluxSelector<T, S>, listener: FluxListener<S>): Unsubscribe;
+}
+//# 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;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC;IACpC;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC;IAET;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,IAAI,CAAC,CAAC;IACd,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACzC,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAClD,SAAS,CAAC,CAAC,EACT,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,WAAW,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC;IAC7B;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,QAAQ,IAAI,CAAC,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAClD,SAAS,CAAC,CAAC,EACT,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,WAAW,CAAC;CAChB"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@fukict/flux",
+  "version": "0.1.0",
+  "description": "Minimal state management library for Fukict framework",
+  "keywords": [
+    "fukict",
+    "flux",
+    "state-management",
+    "store",
+    "reactive"
+  ],
+  "bugs": {
+    "url": "https://github.com/fukict/fukict/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fukict/fukict.git",
+    "directory": "packages/flux"
+  },
+  "license": "MIT",
+  "author": "Fukict Team",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsx ../../scripts/build-package.ts --pkg-name flux --no-watch",
+    "dev": "tsx ../../scripts/build-package.ts --pkg-name flux --watch",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  }
+}