@slux/flux 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# @slux/flux
+
+## 0.1.0
+
+### Minor Changes
+
+- 首次公开发布 slux 的 25 个包，统一版本为 0.1.0。
+
+  - 提供框架无关的响应式核心与共享工具，以及 Store、Atom、Proxy、Flux、状态机和 RxJS 六种状态组织方式。
+  - 提供持久化、历史记录、跨标签页同步、遥测和开发工具五类 Store 扩展。
+  - 提供 React、Vue、Solid、Svelte、Angular、Preact、Ripple、Inferno、Octane、Vitarx、ActView 和 Viewfly 绑定。
+  - 提供各包文档与对应示例，并接入发布检查和文档部署工作流。
+
+### Patch Changes
+
+- Updated dependencies
+  - @slux/core@0.1.0
+  - @slux/shared@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 itmanyong
+
+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/README.md

@@ -1,3 +1,162 @@
-# Temporary Holding Version
+# @slux/flux
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+基于 `@slux/core` 的 reducer + dispatch 状态范式层。内部只持有一个 core `Signal<State>` 作为状态与通知源：`dispatch(action)` 同步经过中间件链与 reducer，把 reducer 返回的完整新状态写入该 signal；依赖追踪、批处理与相等性判定全部复用 core。**不依赖 Redux，也不是 Redux 的兼容实现**。
+
+## 特性与适用场景
+
+| 场景                                                       | 是否适合 | 说明                                                                       |
+| ---------------------------------------------------------- | -------- | -------------------------------------------------------------------------- |
+| 状态流转适合写成 `(state, action) => state`，action 可枚举 | 适合     | 状态与 action 类型由 `FluxReducer` 约束，reducer 返回完整新状态            |
+| 需要在派发前/后拦截、替换或阻断 action                     | 适合     | `options.middleware` 是独立的 dispatch 管道                                |
+| 想和 `computed` / `effect` / `batch` 组合                  | 适合     | `FluxStore` 满足 core 的 `Subscribable<State>`                             |
+| 需要细粒度字段订阅、浅合并、draft 草稿修改                 | 不适合   | 本包是整状态替换，见「关键语义与边界」；改用 `@slux/store` / `@slux/proxy` |
+| 需要 thunk、异步 action、内置持久化或时间旅行              | 不适合   | 本包不内置，异步完成后自行派发普通 action                                  |
+
+## 安装
+
+```sh
+pnpm add @slux/flux
+```
+
+| 项                 | 值                                                                     | 来源                     |
+| ------------------ | ---------------------------------------------------------------------- | ------------------------ |
+| 版本               | `0.1.0`                                                                | `package.json`           |
+| `dependencies`     | `@slux/core` `workspace:*`、`@slux/shared` `workspace:*`               | `package.json`           |
+| `peerDependencies` | 无                                                                     | `package.json`           |
+| 模块格式           | ESM（`dist/index.js`）+ CJS（`dist/index.cjs`），带 `.d.ts` / `.d.cts` | `package.json` `exports` |
+| 许可               | MIT                                                                    | `package.json`           |
+
+`@slux/core`、`@slux/shared` 是本包 `dependencies`，安装时一并带入；下文示例直接 `import` 了 `@slux/core` 的 `computed` / `batch`，**应用代码直接 import 的依赖应显式声明**，可写成 `pnpm add @slux/core @slux/flux`。Node.js 版本要求与跨包通用约定见仓库根 [README.md](../../README.md)。
+
+## 快速开始
+
+```ts
+import { batch, computed } from "@slux/core";
+import { createFluxStore, type FluxReducer } from "@slux/flux";
+
+type State = { count: number };
+type Action = { type: "add"; amount: number } | { type: "reset" };
+
+const reducer: FluxReducer<State, Action> = (state, action) => (action.type === "add" ? { count: state.count + action.amount } : { count: 0 });
+
+const store = createFluxStore(reducer, { count: 0 });
+const doubled = computed(() => store.get().count * 2);
+const stop = store.subscribe((state) => console.log("count:", state.count));
+
+batch(() => {
+  store.dispatch({ type: "add", amount: 1 });
+  store.dispatch({ type: "add", amount: 2 });
+}); // 订阅只收到 count: 3
+
+console.log(doubled.get()); // 6
+stop();
+store.destroy();
+```
+
+## 核心 API
+
+`createFluxStore<State, Action extends FluxAction>(reducer, initialState, options?): FluxStore<State, Action>`
+
+`FluxAction` 即 `{ readonly type: string }`。`reducer` 是 `(state, action) => State`，`initialState` 是初始状态，`options.middleware` 是可选的只读中间件数组。返回值满足 `Subscribable<State>`，可放进 core 的依赖图。
+
+### `FluxStore<State, Action>` 方法
+
+| 方法                  | 签名                                         | 行为                                                                                 |
+| --------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------ |
+| `get()`               | `() => State`                                | 返回当前状态；在 `computed` / `effect` 内读取会收集依赖                              |
+| `getState()`          | `() => State`                                | 与 `get()` 是同一个函数                                                              |
+| `getInitialState()`   | `() => State`                                | 返回创建时传入的初始状态引用，不随 `dispatch` 改变                                   |
+| `subscribe(callback)` | `(cb: (state: State) => void) => () => void` | 订阅**后续**变化，不立即调用；回调只接收当前状态（无 `prevState`）；返回幂等取消函数 |
+| `dispatch(action)`    | `(action: Action) => Action`                 | 同步经过中间件链与 reducer；默认返回原 action，中间件可返回另一个 `Action`           |
+| `destroy()`           | `() => void`                                 | 幂等；取消本实例全部订阅，之后 `dispatch` 被忽略、新增订阅为空实现，读取仍可用       |
+
+### 状态与 reducer 语义
+
+| 规则     | 说明                                                                                                                          |
+| -------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| 完整替换 | reducer 返回**完整新状态**，不浅合并旧字段、不接收可修改草稿、不应原地修改旧状态                                              |
+| 初始化   | 直接采用 `initialState`，**不会**用内部虚构 action 调用 reducer                                                               |
+| 状态类型 | 支持基础值、对象、`undefined` 与函数；函数状态通过 `source.set(() => nextState)` 作为返回值写入，不会被 core 当成 recipe 执行 |
+| 相等判定 | 沿用 core 默认 `Object.is`：`NaN` 视为相等、`0` 与 `-0` 视为不同；与旧状态相同则不通知                                        |
+
+### Dispatch 中间件
+
+`FluxMiddleware<State, Action>` 的形式是 `api => next => action => Action`。
+
+```ts
+import { createFluxStore, type FluxMiddleware } from "@slux/flux";
+
+type Action = { type: "add"; amount: number };
+const doublePositive: FluxMiddleware<number, Action> = () => (next) => (action) =>
+  action.amount <= 0 ? action : next({ ...action, amount: action.amount * 2 });
+
+const store = createFluxStore((state: number, action: Action) => state + action.amount, 0, { middleware: [doublePositive] });
+store.dispatch({ type: "add", amount: 2 }); // 4
+store.dispatch({ type: "add", amount: -1 }); // 被阻断，仍为 4
+```
+
+| 约定                   | 说明                                                                 |
+| ---------------------- | -------------------------------------------------------------------- |
+| `api.getState()`       | 读取当前状态                                                         |
+| `api.dispatch(action)` | 始终重新进入**完整**中间件链，不是从当前 `next` 之后开始             |
+| `next(action)`         | 交给下一环，最内层是 reducer 提交；省略 `next` 即阻断本次提交        |
+| 顺序                   | 数组第一项在最外层：`A before → B before → 写入 → B after → A after` |
+| 返回值                 | 中间件可拦截、替换 action 或返回另一个合法 `Action`                  |
+
+该契约与 `@slux/store` 的**状态写入中间件不兼容**，两者不能互换。中间件初始化期间禁止 `dispatch`（管道尚未组装完毕，会抛错）。本包不内置 thunk、异步 action 或持久化。
+
+## 关键语义与边界
+
+- **依赖收集**：`get()` / `getState()` 就是 core `signal.get`，在 `computed` / `effect` 内读取会收集依赖；**仅调用 `dispatch` 不会**把 `effect` 订阅到 Flux 状态。
+- **通知时机**：`dispatch → 中间件 → reducer → signal.set → core 通知`。`subscribe` 不立即调用回调；单次 `dispatch` 在返回前同步完成通知。
+- **批处理**：`@slux/core` 的 `batch` 可合并多次 `dispatch` 的通知；批内读取立即得到最新状态，批次结束只通知最终值。订阅回调没有 `prevState` 参数。
+- **错误**：
+  - reducer 抛错 → 不提交状态、不通知，`reducing` 锁在 `finally` 中释放，之后仍可正常派发。
+  - reducer 执行期间递归 `dispatch` → 抛 `Error("Cannot dispatch while the reducer is executing")`。
+  - 中间件初始化期间 `dispatch` → 抛 `Error("Cannot dispatch while middleware is initializing")`。
+  - 订阅回调抛错 → 不回滚已提交状态、不阻断其他回调，错误向调用方抛出。
+- **订阅回调可再次 `dispatch`**：通知阶段 `reducing` 已复位，新通知由 core 在当前轮结束后继续派发；监听器内 `destroy()` 可终止本轮余下通知。
+- **清理**：`destroy()` 取消本实例订阅、清除批内待派发通知；**外部创建的 `computed` / `effect` 仍由调用方清理**。销毁后 `dispatch` 静默忽略（返回原 action），异步任务不会自动取消，其完成后的 `dispatch` 无效。
+- **异步**：不内置 thunk 或异步 action；异步工作完成后派发普通 action 即可，中间件自行持有的外部资源由调用方清理。
+
+## 自动导入
+
+`createAutoImportApis(prefix?)` 返回 `unplugin-auto-import` 的 `ImportsMap`。登记清单以 `src/auto-import-api.ts` 的 `allImportApis` 为准，当前只有 `createFluxStore`，来源名为 `@slux/flux`（`createAutoImportApis` 本身不登记）。
+
+```ts
+import AutoImport from "unplugin-auto-import/vite";
+import { createAutoImportApis } from "@slux/flux";
+
+export default {
+  plugins: [AutoImport({ imports: [createAutoImportApis()] })],
+};
+```
+
+默认无前缀；传入**以小写字母结尾**的前缀时，别名会把 API 名首字母大写（如 `createAutoImportApis("u")` → `uCreateFluxStore`）。大小写规则由 `@slux/shared` 的 `generateBatchAutoImports` / `createAutoImports` 决定。
+
+## 类型导出
+
+以 `src/index.ts` 的 `export type` 为准，共 7 个：
+
+| 类型                               | 用途                                                                                                           |
+| ---------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `FluxAction`                       | `{ readonly type: string }`，action 的基础约束                                                                 |
+| `FluxReducer<State, Action>`       | `(state, action) => State`                                                                                     |
+| `FluxDispatch<Action>`             | `(action: Action) => Action`                                                                                   |
+| `FluxMiddlewareAPI<State, Action>` | 中间件可见的 `{ getState(): State; dispatch: FluxDispatch<Action> }`                                           |
+| `FluxMiddleware<State, Action>`    | `api => next => dispatch` 的中间件定义                                                                         |
+| `FluxStore<State, Action>`         | `createFluxStore` 返回类型：`Subscribable<State>` 加上 `getState` / `getInitialState` / `dispatch` / `destroy` |
+| `FluxStoreOptions<State, Action>`  | `{ readonly middleware?: readonly FluxMiddleware<State, Action>[] }`                                           |
+
+## 不适用的场景 / 与其他包分工
+
+- 与 `@slux/core`：core 是响应式运行时（signal / computed / effect / batch / Scope）；本包只叠加 reducer + dispatch 范式层。
+- 与 `@slux/store`：store 是「状态与 action 同对象 + 浅合并 + 状态写入中间件」；本包是「整状态替换 + dispatch 管道中间件」，**两套中间件契约互不兼容**。
+- 需要细粒度字段订阅或草稿式局部修改，用 `@slux/store` / `@slux/proxy`；需要 Redux DevTools、时间旅行不在本包范围。
+- 框架绑定只读本实例、写入仍走 `dispatch(action)` 等通用约定见仓库根 [README.md](../../README.md) 的「框架适配 · 通用约定」一节。
+
+## 版本、许可与反馈
+
+- 版本：`0.1.0`（`package.json`）。
+- 许可：MIT，见仓库根 [LICENSE](../../LICENSE)。
+- 问题反馈：`https://github.com/itmanyong/slux/issues`（`package.json` `bugs.url`）。

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,r,t)=>{var _=(r,t)=>{for(var _ in r)__webpack_require__.o(r,_)&&!__webpack_require__.o(e,_)&&Object.defineProperty(e,_,{enumerable:!0,[t]:r[_]})};_(r,"get"),_(t,"value")},__webpack_require__.o=(e,r)=>Object.prototype.hasOwnProperty.call(e,r),__webpack_require__.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{createAutoImportApis:()=>createAutoImportApis,createFluxStore:()=>createFluxStore});const core_namespaceObject=require("@slux/core");function createFluxStore(e,r,t){let _=(0,core_namespaceObject.signal)(r),o=r,a=new Set,c=!1,i=!1,p=!0,u=r=>{let t;if(c)return r;if(i)throw Error("Cannot dispatch while the reducer is executing");i=!0;try{t=e(o,r)}finally{i=!1}return o=t,"function"==typeof t?_.set(()=>t):_.set(t),r},s=e=>{if(c)return e;if(i)throw Error("Cannot dispatch while the reducer is executing");if(p)throw Error("Cannot dispatch while middleware is initializing");return u(e)},n={get:_.get,getState:_.get,getInitialState:()=>r,dispatch:s,subscribe(e){if(c)return()=>{};let r=_.subscribe(e),t=()=>{r(),a.delete(t)};return a.add(t),t},destroy(){if(!c)for(let e of(c=!0,a))e()}},l={getState:_.get,dispatch:s},b=(t?.middleware??[]).map(e=>e(l));for(let e=b.length-1;e>=0;e--)u=b[e](u);return p=!1,n}const shared_namespaceObject=require("@slux/shared"),allImportApis=["createFluxStore"],createAutoImportApis=(e="")=>(0,shared_namespaceObject.generateBatchAutoImports)([{prefix:e,fromName:"@slux/flux",imports:allImportApis}]);for(var __rspack_i in exports.createAutoImportApis=__webpack_exports__.createAutoImportApis,exports.createFluxStore=__webpack_exports__.createFluxStore,__webpack_exports__)-1===["createAutoImportApis","createFluxStore"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["webpack://webpack/runtime/define_property_getters","webpack://webpack/runtime/has_own_property","webpack://webpack/runtime/make_namespace_object","../src/create-flux-store.ts","../src/auto-import-api.ts"],"sourcesContent":["__webpack_require__.d = (exports, getters, values) => {\n\tvar define = (defs, kind) => {\n\t\tfor(var key in defs) {\n\t\t\tif(__webpack_require__.o(defs, key) && !__webpack_require__.o(exports, key)) {\n\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, [kind]: defs[key] });\n\t\t\t}\n\t\t}\n\t};\n\tdefine(getters, \"get\");\n\tdefine(values, \"value\");\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { signal } from \"@slux/core\";\nimport type { FluxAction, FluxDispatch, FluxReducer, FluxStore, FluxStoreOptions } from \"./types.js\";\n\nexport function createFluxStore<State, Action extends FluxAction>(\n  reducer: FluxReducer<State, Action>,\n  initialState: State,\n  options?: FluxStoreOptions<State, Action>,\n): FluxStore<State, Action> {\n  const source = signal(initialState);\n  let currentState = initialState;\n  const subscriptions = new Set<() => void>();\n  let destroyed = false;\n  let reducing = false;\n  let initializing = true;\n\n  const reduce: FluxDispatch<Action> = (action) => {\n    if (destroyed) return action;\n    if (reducing) throw new Error(\"Cannot dispatch while the reducer is executing\");\n    let nextState: State;\n    reducing = true;\n    try {\n      nextState = reducer(currentState, action);\n    } finally {\n      reducing = false;\n    }\n    currentState = nextState;\n    // 函数状态必须作为返回值写入，不能被 signal 当作 recipe 调用。\n    if (typeof nextState === \"function\") source.set(() => nextState);\n    else source.set(nextState);\n    return action;\n  };\n  let chain = reduce;\n  const dispatch: FluxDispatch<Action> = (action) => {\n    if (destroyed) return action;\n    if (reducing) throw new Error(\"Cannot dispatch while the reducer is executing\");\n    if (initializing) throw new Error(\"Cannot dispatch while middleware is initializing\");\n    return chain(action);\n  };\n  const api: FluxStore<State, Action> = {\n    get: source.get,\n    getState: source.get,\n    getInitialState: () => initialState,\n    dispatch,\n    subscribe(callback) {\n      if (destroyed) return () => {};\n      const unsubscribe = source.subscribe(callback);\n      const stop = () => {\n        unsubscribe();\n        subscriptions.delete(stop);\n      };\n      subscriptions.add(stop);\n      return stop;\n    },\n    destroy() {\n      if (destroyed) return;\n      destroyed = true;\n      for (const stop of subscriptions) stop();\n    },\n  };\n\n  const middlewareAPI = { getState: source.get, dispatch };\n  const middleware = (options?.middleware ?? []).map((entry) => entry(middlewareAPI));\n  for (let index = middleware.length - 1; index >= 0; index--) {\n    chain = middleware[index]!(chain);\n  }\n  initializing = false;\n  return api;\n}\n","import { generateBatchAutoImports } from \"@slux/shared\";\n\nconst allImportApis: string[] = [\"createFluxStore\"];\n\nexport const createAutoImportApis = (prefix: string = \"\") => {\n  return generateBatchAutoImports([\n    {\n      prefix,\n      fromName: \"@slux/flux\",\n      imports: allImportApis,\n    },\n  ]);\n};\n"],"names":["__webpack_require__","e","Object","Symbol","createFluxStore","reducer","initialState","options","source","signal","currentState","subscriptions","Set","destroyed","reducing","initializing","chain","action","nextState","Error","dispatch","api","callback","unsubscribe","stop","middlewareAPI","middleware","entry","index","allImportApis","createAutoImportApis","prefix","generateBatchAutoImports"],"mappings":"wPAAAA,CAAAA,oBAAoB,CAAC,CAAG,CAACC,EAAS,EAAS,KAC1C,IAAI,EAAS,CAAC,EAAM,KACnB,IAAI,IAAI,KAAO,EACXD,oBAAoB,CAAC,CAAC,EAAM,IAAQ,CAACA,oBAAoB,CAAC,CAACC,EAAS,IACtEC,OAAO,cAAc,CAACD,EAAS,EAAK,CAAE,WAAY,GAAM,CAAC,EAAK,CAAE,CAAI,CAAC,EAAI,AAAC,EAG7E,EACA,EAAO,EAAS,OAChB,EAAO,EAAQ,QAChB,ECVAD,oBAAoB,CAAC,CAAG,CAAC,EAAK,IAAUE,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,EAAK,GCClFF,oBAAoB,CAAC,CAAG,AAACC,IACrB,AAAkB,IAAlB,OAAOE,QAA0BA,OAAO,WAAW,EACrDD,OAAO,cAAc,CAACD,EAASE,OAAO,WAAW,CAAE,CAAE,MAAO,QAAS,GAEtED,OAAO,cAAc,CAACD,EAAS,aAAc,CAAE,MAAO,EAAK,EAC5D,E,sPCHO,SAASG,gBACdC,CAAmC,CACnCC,CAAmB,CACnBC,CAAyC,EAEzC,IAAMC,EAASC,AAAAA,GAAAA,qBAAAA,MAAAA,AAAAA,EAAOH,GAClBI,EAAeJ,EACbK,EAAgB,IAAIC,IACtBC,EAAY,GACZC,EAAW,GACXC,EAAe,GAkBfC,EAhBiC,AAACC,QAGhCC,EAFJ,GAAIL,EAAW,OAAOI,EACtB,GAAIH,EAAU,MAAM,AAAIK,MAAM,kDAE9BL,EAAW,GACX,GAAI,CACFI,EAAYb,EAAQK,EAAcO,EACpC,QAAU,CACRH,EAAW,EACb,CAKA,OAJAJ,EAAeQ,EAEX,AAAqB,YAArB,OAAOA,EAA0BV,EAAO,GAAG,CAAC,IAAMU,GACjDV,EAAO,GAAG,CAACU,GACTD,CACT,EAEMG,EAAiC,AAACH,IACtC,GAAIJ,EAAW,OAAOI,EACtB,GAAIH,EAAU,MAAM,AAAIK,MAAM,kDAC9B,GAAIJ,EAAc,MAAM,AAAII,MAAM,oDAClC,OAAOH,EAAMC,EACf,EACMI,EAAgC,CACpC,IAAKb,EAAO,GAAG,CACf,SAAUA,EAAO,GAAG,CACpB,gBAAiB,IAAMF,EACvBc,SAAAA,EACA,UAAUE,CAAQ,EAChB,GAAIT,EAAW,MAAO,KAAO,EAC7B,IAAMU,EAAcf,EAAO,SAAS,CAACc,GAC/BE,EAAO,KACXD,IACAZ,EAAc,MAAM,CAACa,EACvB,EAEA,OADAb,EAAc,GAAG,CAACa,GACXA,CACT,EACA,UACE,IAAIX,EAEJ,IAAK,IAAMW,KADXX,EAAY,GACOF,GAAea,GACpC,CACF,EAEMC,EAAgB,CAAE,SAAUjB,EAAO,GAAG,CAAEY,SAAAA,CAAS,EACjDM,EAAcnB,AAAAA,CAAAA,GAAS,YAAc,EAAC,EAAG,GAAG,CAAC,AAACoB,GAAUA,EAAMF,IACpE,IAAK,IAAIG,EAAQF,EAAW,MAAM,CAAG,EAAGE,GAAS,EAAGA,IAClDZ,EAAQU,CAAU,CAACE,EAAM,CAAEZ,GAG7B,OADAD,EAAe,GACRM,CACT,C,qDCjEMQ,cAA0B,CAAC,kBAAkB,CAEtCC,qBAAuB,CAACC,EAAiB,EAAE,GAC/CC,AAAAA,GAAAA,uBAAAA,wBAAAA,AAAAA,EAAyB,CAC9B,CACED,OAAAA,EACA,SAAU,aACV,QAASF,aACX,EACD,E"}

package/dist/index.d.cts

@@ -0,0 +1,36 @@
+import type { Subscribable } from '@slux/core';
+
+export declare const createAutoImportApis: (prefix?: string) => {
+    [x: string]: (string | [string, string])[];
+};
+
+export declare function createFluxStore<State, Action extends FluxAction>(reducer: FluxReducer<State, Action>, initialState: State, options?: FluxStoreOptions<State, Action>): FluxStore<State, Action>;
+
+export declare type FluxAction = {
+    readonly type: string;
+};
+
+export declare type FluxDispatch<Action extends FluxAction> = (action: Action) => Action;
+
+/** 独立的 dispatch 管道，与 @slux/store 的状态写入中间件不兼容。 */
+export declare type FluxMiddleware<State, Action extends FluxAction> = (api: FluxMiddlewareAPI<State, Action>) => (next: FluxDispatch<Action>) => FluxDispatch<Action>;
+
+export declare type FluxMiddlewareAPI<State, Action extends FluxAction> = {
+    getState(): State;
+    dispatch: FluxDispatch<Action>;
+};
+
+export declare type FluxReducer<State, Action extends FluxAction> = (state: State, action: Action) => State;
+
+export declare type FluxStore<State, Action extends FluxAction> = Subscribable<State> & {
+    getState(): State;
+    getInitialState(): State;
+    dispatch: FluxDispatch<Action>;
+    destroy(): void;
+};
+
+export declare type FluxStoreOptions<State, Action extends FluxAction> = {
+    readonly middleware?: readonly FluxMiddleware<State, Action>[];
+};
+
+export { }

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import type { Subscribable } from '@slux/core';
+
+export declare const createAutoImportApis: (prefix?: string) => {
+    [x: string]: (string | [string, string])[];
+};
+
+export declare function createFluxStore<State, Action extends FluxAction>(reducer: FluxReducer<State, Action>, initialState: State, options?: FluxStoreOptions<State, Action>): FluxStore<State, Action>;
+
+export declare type FluxAction = {
+    readonly type: string;
+};
+
+export declare type FluxDispatch<Action extends FluxAction> = (action: Action) => Action;
+
+/** 独立的 dispatch 管道，与 @slux/store 的状态写入中间件不兼容。 */
+export declare type FluxMiddleware<State, Action extends FluxAction> = (api: FluxMiddlewareAPI<State, Action>) => (next: FluxDispatch<Action>) => FluxDispatch<Action>;
+
+export declare type FluxMiddlewareAPI<State, Action extends FluxAction> = {
+    getState(): State;
+    dispatch: FluxDispatch<Action>;
+};
+
+export declare type FluxReducer<State, Action extends FluxAction> = (state: State, action: Action) => State;
+
+export declare type FluxStore<State, Action extends FluxAction> = Subscribable<State> & {
+    getState(): State;
+    getInitialState(): State;
+    dispatch: FluxDispatch<Action>;
+    destroy(): void;
+};
+
+export declare type FluxStoreOptions<State, Action extends FluxAction> = {
+    readonly middleware?: readonly FluxMiddleware<State, Action>[];
+};
+
+export { }

package/dist/index.js

@@ -0,0 +1,2 @@
+import{signal as e}from"@slux/core";import{generateBatchAutoImports as t}from"@slux/shared";function r(t,r,i){let o=e(r),n=r,l=new Set,u=!1,a=!1,s=!0,f=e=>{let r;if(u)return e;if(a)throw Error("Cannot dispatch while the reducer is executing");a=!0;try{r=t(n,e)}finally{a=!1}return n=r,"function"==typeof r?o.set(()=>r):o.set(r),e},c=e=>{if(u)return e;if(a)throw Error("Cannot dispatch while the reducer is executing");if(s)throw Error("Cannot dispatch while middleware is initializing");return f(e)},d={get:o.get,getState:o.get,getInitialState:()=>r,dispatch:c,subscribe(e){if(u)return()=>{};let t=o.subscribe(e),r=()=>{t(),l.delete(r)};return l.add(r),r},destroy(){if(!u)for(let e of(u=!0,l))e()}},h={getState:o.get,dispatch:c},g=(i?.middleware??[]).map(e=>e(h));for(let e=g.length-1;e>=0;e--)f=g[e](f);return s=!1,d}let i=["createFluxStore"],o=(e="")=>t([{prefix:e,fromName:"@slux/flux",imports:i}]);export{o as createAutoImportApis,r as createFluxStore};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/create-flux-store.ts","../src/auto-import-api.ts"],"sourcesContent":["import { signal } from \"@slux/core\";\nimport type { FluxAction, FluxDispatch, FluxReducer, FluxStore, FluxStoreOptions } from \"./types.js\";\n\nexport function createFluxStore<State, Action extends FluxAction>(\n  reducer: FluxReducer<State, Action>,\n  initialState: State,\n  options?: FluxStoreOptions<State, Action>,\n): FluxStore<State, Action> {\n  const source = signal(initialState);\n  let currentState = initialState;\n  const subscriptions = new Set<() => void>();\n  let destroyed = false;\n  let reducing = false;\n  let initializing = true;\n\n  const reduce: FluxDispatch<Action> = (action) => {\n    if (destroyed) return action;\n    if (reducing) throw new Error(\"Cannot dispatch while the reducer is executing\");\n    let nextState: State;\n    reducing = true;\n    try {\n      nextState = reducer(currentState, action);\n    } finally {\n      reducing = false;\n    }\n    currentState = nextState;\n    // 函数状态必须作为返回值写入，不能被 signal 当作 recipe 调用。\n    if (typeof nextState === \"function\") source.set(() => nextState);\n    else source.set(nextState);\n    return action;\n  };\n  let chain = reduce;\n  const dispatch: FluxDispatch<Action> = (action) => {\n    if (destroyed) return action;\n    if (reducing) throw new Error(\"Cannot dispatch while the reducer is executing\");\n    if (initializing) throw new Error(\"Cannot dispatch while middleware is initializing\");\n    return chain(action);\n  };\n  const api: FluxStore<State, Action> = {\n    get: source.get,\n    getState: source.get,\n    getInitialState: () => initialState,\n    dispatch,\n    subscribe(callback) {\n      if (destroyed) return () => {};\n      const unsubscribe = source.subscribe(callback);\n      const stop = () => {\n        unsubscribe();\n        subscriptions.delete(stop);\n      };\n      subscriptions.add(stop);\n      return stop;\n    },\n    destroy() {\n      if (destroyed) return;\n      destroyed = true;\n      for (const stop of subscriptions) stop();\n    },\n  };\n\n  const middlewareAPI = { getState: source.get, dispatch };\n  const middleware = (options?.middleware ?? []).map((entry) => entry(middlewareAPI));\n  for (let index = middleware.length - 1; index >= 0; index--) {\n    chain = middleware[index]!(chain);\n  }\n  initializing = false;\n  return api;\n}\n","import { generateBatchAutoImports } from \"@slux/shared\";\n\nconst allImportApis: string[] = [\"createFluxStore\"];\n\nexport const createAutoImportApis = (prefix: string = \"\") => {\n  return generateBatchAutoImports([\n    {\n      prefix,\n      fromName: \"@slux/flux\",\n      imports: allImportApis,\n    },\n  ]);\n};\n"],"names":["createFluxStore","reducer","initialState","options","source","signal","currentState","subscriptions","Set","destroyed","reducing","initializing","chain","action","nextState","Error","dispatch","api","callback","unsubscribe","stop","middlewareAPI","middleware","entry","index","allImportApis","createAutoImportApis","prefix","generateBatchAutoImports"],"mappings":"4FAGO,SAASA,EACdC,CAAmC,CACnCC,CAAmB,CACnBC,CAAyC,EAEzC,IAAMC,EAASC,EAAOH,GAClBI,EAAeJ,EACbK,EAAgB,IAAIC,IACtBC,EAAY,GACZC,EAAW,GACXC,EAAe,GAkBfC,EAhBiC,AAACC,QAGhCC,EAFJ,GAAIL,EAAW,OAAOI,EACtB,GAAIH,EAAU,MAAM,AAAIK,MAAM,kDAE9BL,EAAW,GACX,GAAI,CACFI,EAAYb,EAAQK,EAAcO,EACpC,QAAU,CACRH,EAAW,EACb,CAKA,OAJAJ,EAAeQ,EAEX,AAAqB,YAArB,OAAOA,EAA0BV,EAAO,GAAG,CAAC,IAAMU,GACjDV,EAAO,GAAG,CAACU,GACTD,CACT,EAEMG,EAAiC,AAACH,IACtC,GAAIJ,EAAW,OAAOI,EACtB,GAAIH,EAAU,MAAM,AAAIK,MAAM,kDAC9B,GAAIJ,EAAc,MAAM,AAAII,MAAM,oDAClC,OAAOH,EAAMC,EACf,EACMI,EAAgC,CACpC,IAAKb,EAAO,GAAG,CACf,SAAUA,EAAO,GAAG,CACpB,gBAAiB,IAAMF,EACvBc,SAAAA,EACA,UAAUE,CAAQ,EAChB,GAAIT,EAAW,MAAO,KAAO,EAC7B,IAAMU,EAAcf,EAAO,SAAS,CAACc,GAC/BE,EAAO,KACXD,IACAZ,EAAc,MAAM,CAACa,EACvB,EAEA,OADAb,EAAc,GAAG,CAACa,GACXA,CACT,EACA,UACE,IAAIX,EAEJ,IAAK,IAAMW,KADXX,EAAY,GACOF,GAAea,GACpC,CACF,EAEMC,EAAgB,CAAE,SAAUjB,EAAO,GAAG,CAAEY,SAAAA,CAAS,EACjDM,EAAcnB,AAAAA,CAAAA,GAAS,YAAc,EAAC,EAAG,GAAG,CAAC,AAACoB,GAAUA,EAAMF,IACpE,IAAK,IAAIG,EAAQF,EAAW,MAAM,CAAG,EAAGE,GAAS,EAAGA,IAClDZ,EAAQU,CAAU,CAACE,EAAM,CAAEZ,GAG7B,OADAD,EAAe,GACRM,CACT,CCjEA,IAAMQ,EAA0B,CAAC,kBAAkB,CAEtCC,EAAuB,CAACC,EAAiB,EAAE,GAC/CC,EAAyB,CAC9B,CACED,OAAAA,EACA,SAAU,aACV,QAASF,CACX,EACD,S"}

package/package.json

@@ -1,6 +1,69 @@
 {
   "name": "@slux/flux",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "基于 slux core 的 reducer 与 dispatch 范式层",
+  "sideEffects": false,
+  "keywords": [
+    "slux",
+    "flux",
+    "reducer",
+    "state-management"
+  ],
+  "author": "itmanyong <itmanyong@gmail.com>",
+  "contributors": [
+    "itmanyong <itmanyong@gmail.com>"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "homepage": "https://www.npmjs.com/package/@slux/flux",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itmanyong/slux.git",
+    "directory": "packages/flux"
+  },
+  "bugs": {
+    "url": "https://github.com/itmanyong/slux/issues"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "package.json"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@slux/core": "0.1.0",
+    "@slux/shared": "0.1.0"
+  },
+  "devDependencies": {
+    "rstack": "0.9.0",
+    "typescript": "7.1.0-beta"
+  },
+  "scripts": {
+    "dev": "rs lib -w",
+    "build": "rs lib",
+    "test": "rs test",
+    "lint": "rs lint",
+    "fmt": "rs fmt",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist node_modules .turbo"
+  }
 }