@actuallab/fusion-react

中文文档
15.1.24发布于 2026/11/07MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2826

Fusion - hooks 和 UI 动作跟踪的反应集成

中文使用文档
文档目录6 节
  1. 安装
  2. 计算状态
  3. 使用可移动状态
  4. API 表面
  5. 文档
  6. 许可证

@ actuallab/ 聚变- react

npm Documentation License

执行插接的钩子 组合反应状态 反应状态 渲染寿命周期 — TypeScript 等同 ComputedStateComponent<T> 内 ActualLab.Fusion.Blazor。当服务器侧数据发生变化,无效状态到达客户端时, 您的组件重置 。 没有投票,没有人工订阅,没有商店接线.

安装

npm install @actuallab/fusion-react

同伴依赖 : 反应 ^19无害环境管理首先采用CJS的后退;船舶本身 .d.ts。 。 。 .

计算状态

import { useComputedState } from '@actuallab/fusion-react';

function TodoList({ api }: { api: ITodoApi }) {
    const { value, error, isInitial } = useComputedState(
        () => api.ListIds('~', 10),
        [api],
    );

    if (isInitial) return <p>Loading...</p>;
    if (error) return <p>Error: {String(error)}</p>;
    return <ul>{value?.map(id => <li key={id}>{id}</li>)}</ul>;
}

任何东西 computer 电话变成依赖,所以钩子重跑 当它有任何 无效. deps 像React's——改变它们 处理旧的 ComputedState 和建设 一个新的.

钩子是建立在 useSyncExternalStore,并创建和处置国家 内部 subscribe,在渲染过程中从未出现: 严格模式双峰和被丢弃的并发构件 两者都是安全的。 这也是为什么 state 实值 undefined 首先,先发制人 isInitial。 。 。 .

佩斯重算与 updateDelayer 选项 :

import { FixedDelayer, UIUpdateDelayer } from '@actuallab/fusion';

// 500 ms after invalidation…
useComputedState(() => api.GetSummary('~'), [api], { updateDelayer: FixedDelayer.get(500) });

// …but immediately while a UI action is running (or just finished)
useComputedState(() => api.GetSummary('~'), [api], { updateDelayer: UIUpdateDelayer.get(500) });

使用可移动状态

手动设定的被动值,既可以重置组件,也可以参与 聚合依赖图 :

import { useComputedState, useMutableState } from '@actuallab/fusion-react';

function SearchResults({ api }: { api: ISearchApi }) {
    const { value: query, set: setQuery, state: queryState } = useMutableState('');

    const { value: results } = useComputedState(
        () => {
            const q = queryState.use();  // registers the dependency
            return q ? api.Search(q) : [];
        },
        [api, queryState],
    );

    return (
        <>
            <input value={query ?? ''} onChange={e => setQuery(e.target.value)} />
            <ul>{results?.map(r => <li key={r.id}>{r.title}</li>)}</ul>
        </>
    );
}

value 读取通过 valueOrUndefined,因此它从不扔出——一个存储在 set(errorResult(e)) 表面为 error 并正常地重放,而不是卸下树.

API 表面

导出说明
useComputedState(computer, deps, options?)回返 { value, error, isInitial, state }
useMutableState(initial)回返 { value, error, set, state }
UIActionTracker, (中文(简体) ), uiActions, (中文(简体) ), UIUpdateDelayer从 @actuallab/fusion 为方便起见

对于连接状态的横幅, 双 RpcPeerStateMonitor 从 @actuallab/rpc 一个平地 useState + 键 useEffect ——见: 文档。 。 。 .

文档

许可证

麻省理工学院——见 自由主义。 。 。 .

版本与发布记录

@actuallab/fusion-react 共发布 54 个版本,首次发布于 2026/02/18;过去 12 个月发布了 54 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
15.1.24latest2026/11/07今天
15.1.222026/11/07今天
15.1.152026/11/07今天
15.1.112026/11/07今天
15.1.62026/11/07今天
15.0.212026/10/2414 天前

关于 @actuallab/fusion-react 的常见问题

@actuallab/fusion-react 是什么?

Fusion - hooks 和 UI 动作跟踪的反应集成

如何安装 @actuallab/fusion-react?

在项目目录运行 npm install @actuallab/fusion-react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@actuallab/fusion-react 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@actuallab/fusion-react 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@actuallab/fusion-react 可以商用吗?

@actuallab/fusion-react 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@actuallab/fusion-react 的下载量有多少?

根据 npm 官方下载统计,@actuallab/fusion-react 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,826 次,日均约 94 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@actuallab/fusion-react 还在维护吗?

最新版本 15.1.24 发布于 2026/11/07(今天);至今共发布 54 个版本,其中过去 12 个月发布了 54 个;首次发布于 2026/02/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。