@getforma/core

中文文档
3.2.0发布于 2026/10/28MITTypeScriptESM + CJS构建来源已验证近 30 天下载 1万

真正的 DOM 反应库——细纹信号,岛屿建筑,SSR水分. 没有虚拟的DOM,没有抖动。 CDN HTML 运行时使用一个零 eval 的 CSP 安全允许列表表达式解释器. 套装大小由脚本/检查大小-mjs来测量.

中文使用文档
文档目录10 节
  1. 安装
  2. 三个用法
  3. 为什么福玛JS
  4. 计量,未断言
  5. 文档
  6. 福玛堆栈的一部分
  7. 前端( TypeScript)
  8. 后端( Rust)
  9. 完整框架
  10. 许可证

福马JS

CI npm Socket Badge License: MIT

反应 DOM 库有精细的纹理信号. 没有虚拟 DOM —— 信号只更新改变的 DOM 节点. 组件运行一次.

此所坐之处. 1个产品,1个寄存器,8个源包(包括可选路由器):

TS/JSX → @getforma/compiler → FMIR (binary) → forma-ir walker → HTML → @getforma/core adopts it
         packages/compiler                    crates/forma-ir          packages/core

你在这里: 客户端运行时间——信号, h(),岛屿,水合,和零建 HTML运行时间。 它完全靠自己运作;其余的堆栈是选入. 新来的? 读取 3.0 架构 先说 这个 Forma 工作空间 还装有编译器、建造管线、碎屑箱和脚手架.

import { createSignal, h, mount } from "@getforma/core";

const [count, setCount] = createSignal(0);

function Counter() {
  return (
    <button onClick={() => setCount((c) => c + 1)}>
      {() => `Clicked ${count()} times`}
    </button>
  );
}

mount(() => <Counter />, "#app");

无复出使. 无依赖数组 。 没有 useMemo按钮文本更新,因为它读取 count() 在反应函数内——树上没有其它东西被触动.


安装

安装协调的3.2.0核心 :

npm install @getforma/[email protected]

添加可选 路由器 用于客户端导航。 这个 路由指南 解释浏览器渲染、岛屿和 本地导航; 只使用核心的应用程序不需要路由器.

对于单独的平稳 2.1.0 运行时间,以下URL仅保留为 历史实例。 他们用的是旧的自动生命周期 而不是明确的 3.0 挂载合同如下。 对于目前的不建用途,请填写 dist/formajs-runtime.global.js 您已安装的合格软件包中的文物 :

<!-- jsDelivr (recommended) -->
<script src="https://cdn.jsdelivr.net/npm/@getforma/[email protected]/dist/formajs-runtime.global.js"></script>

<!-- unpkg -->
<script src="https://unpkg.com/@getforma/[email protected]/dist/formajs-runtime.global.js"></script>

生产: 将限定的版本而不是移动的 Dist- tag .

任何捆绑工的作品——Vite,esbuild,tsup,webpack,Rollup. FormaJS船舶标准无害环境管理和CJS通过 package.json 出口。 没有插件, 没有特殊配置 。 关于JSX,设定 jsx: "react", (中文(简体) ), jsxFactory: "h", (中文(简体) ), jsxFragmentFactory: "Fragment"。 。 。 .

按 npm run check:size fORMA-294 核心候选人名单 1d204ba4 在2026-10-25上(随后的选入决定更改了无核心运行时间字节). 脚本将真实的无害环境管理导入图走过,重磅共享块,如果任何条目超过其限制,则失败:

艺术击出CI 限制
@getforma/core 输入 + 每一块48.6 基贝(49 796 B)49 926 B (单位:千美元)
CDN HTML 运行时间 (formajs-runtime.global.js(中文(简体) )40.1 基贝(41,113 B)41 500个B级
CDN HTML 运行时间, 硬化(formajs-runtime-hardened.global.js(中文(简体) )39.4 基贝(40 384 B)40 500个B级
CDN 浏览器 ESM (forma.esm.js,内含外星信号)47.6 基贝(48 776 B)49,136 B (单位:千美元)
预览帧运行时间( E)formajs-frame.global.js,由服务器内置)38.9 基贝(39 867 B)4万个B

核心数字是: 无花草 - 这是一切 dist/index.js 停车 卸下你应用的进口船数量. @getforma/build 仍然拒绝Forma代码28,420 B gzip -9以上的路线. 这个 3.1 业绩决定 记录较早的效应交付费用。 分开 FORMA-294号决定 接受584 B的货包生长,只将货包上限从49,414 B提高到49,926 B. 可选帮助者本身被排除在主干之外;分割其共享的依赖性产生大部分的运输增加. 模板编译默认关闭,仍受每个路由预算的约束. 原始的失败测量仍然失败; 包封顶与路由预算分开 .

为了进行历史比较,3.0.0-dev建筑 91a50157 在2026-10-16测得48,602 B核,39,203 B运行时间,37,629 B硬化运行时间,48,836 B浏览器无害环境管理和38,687 B帧运行时间. 其计数器和指数化的SSSR航道测得福尔马码的26,213 B和28,071 B. 原28,100 B N2门和原50 ms N3 条件属于L-64决定;它们不会被3.1决定追溯更改. 核心和浏览器的无害环境管理数字从2.1.0的29,515 B和28,369 B增加到严格启动的岛屿(FORMA-104)和宣布的岛屿国家块(FORMA-103)。 所测量的大小可以改变;一个测试保持了当前表格的 CI 限制与门脚本一致.

经核实 src/__tests__/docs-truth.test.ts >"大小表引用 CI 门实际执行的限制"


三个用法

三个都共享相同的信号图和反应引擎. 选一个,或者混在一起.

看起来像什么需求
联合来文十<button onClick={…}>{() => count()}</button>装有JSX变换器的捆绑机
上标h("button", { onClick: fn }, () => count())捆绑器
HTML 运行时间<button data-on:click="{count++}">一个运行时脚本和一个明确的挂载调用

JSX汇编为 h() 相同功能,没有JSX特定的运行时间. HTML 运行时间绑定已审查的标记 mountMarkup() 给同样的信号。 装入脚本本身没有任何束缚.

<script src="/vendor/formajs-runtime.global.js"></script>
<main id="counter">
  <div data-forma-state='{ "count": 0 }'>
    <p data-text="{count}"></p>
    <button data-on:click="{count++}">+1</button>
    <button data-on:click="{count = 0}">Reset</button>
  </div>
</main>
<script src="/counter.js"></script>

counter.js 明确启动已审查的计数器( 在您的 CSP 下保留此脚本) :

const root = document.getElementById('counter');
const counter = FormaRuntime.mountMarkup(root, FormaRuntime.trustedHtml(root.innerHTML), { tier: 'reviewed' });
// counter.update(FormaRuntime.trustedHtml(nextMarkup)); counter.unmount();

除非有请求, 挂载不会允许获取、 外部 DOM 访问或导航 。 不需要建设步骤。 → 文件/HTML-RUNTIME.md 每个指令和表达语法.

经核实 src/__tests__/readme-examples.test.ts >"内幕计数器工作没有eval"


为什么福玛JS

组件运行一次. 没有虚拟 DOM 或组件树 diffing 。 密钥列表仍然对齐他们的行. h('div') 返回实际 HTMLDivElement。当一个信号改变时,只有读取它更新的具体文本节点或属性——而不是组件,而不是树.

精细有反应. 电源 异形符号 3.x. 信号图跟踪依赖性自动。 没有依赖数组, 没有 stale 关闭, 没有 useCallback 编号 : useMemo 仪式.

3个出入口,1个引擎. 对组件使用 JSX 或超标, 或明确挂载已审查的 HTML 标记 . 本地 SSR 还需要申报道具和编译器所认可的子集.

岛屿高于最高人民会议. 编译 activateIslands() 激活前验证每一个原始SSD区域:成功采用使得初始DOM写作为零,不匹配的拒绝不修复,而失败仍被隔离每个岛屿. 整个岛屿之间合作加载工作产量;等待 activateIslands() 用于完成所要求的负载。 递延触发因素(visible, (中文(简体) ), idle, (中文(简体) ), interaction装备后就绪;处置释放属于工作。 → 文件/印度地图

CSP -安全. HTML 运行时间用允许列表 AST 解释器来评价表达式. 无 eval()无 new Function()无 with() 每件运出的物品 ——没有选入倒计时错误地离开转接,因为倒计时被删除. 拒绝 scripts/verify-dist.mjs,将构建的文件作为最后一步 npm run build,由Playwright spec提供 旗舰固定在真正的CSP头下.

经核实 src/__tests__/runtime-csp-default.test.ts >"没有构建可以到达新的函数,有任意配置" 经核实 src/__tests__/build-artifacts.test.ts > “没有构建出新函数或带有( ) 瞄准镜包装器”

福马JS不是: 对路径、数据采集或国家管理有意见的框架。 这是一个反应DOM库。 你带来了建筑.

计量,未断言

npm run bench 运行热路套间 bench/数字——每个数字旁边都有跑到跑的噪音地层,因此以后的比较可以发现一个糟糕的下午的倒退——生活在其中 文件/实绩。它们是历史快乐的数字,而不是当前浏览器的时间。 严格采用现在使用连接的、匹配的固定装置和不同的交易;没有要求与旧的采用基准进行新的衡量或比较.

  • 写作会改变无所事事. 等值的写作从未达到效果,其成本级低于一个. 基准:长凳/反应. bench.ts > "写出一个CHANGING值,效果运行 (×500)"
  • batch() 崩溃重复写到一冲 . 写到100没有用 不同 信号,这是正确的结果. 依据: 长凳/反应. bench.ts > "一通信号,100个写作,分批(×30)"
  • 一个按键列表更新, 不更改密钥, 没有命令占用调和器的快速路径,并重排其中的一小部分. 基准为: single/list.bench.ts >"相同的密钥,相同的顺序——调和器快速路径"
  • 历史上采用的基准比公司社会责任控制便宜中,减去 HTML 解析。 这对退休的行走者进行了衡量;它没有确定严格的交易的当前成本. 基准:长凳/水合物.bench.ts > "一千万行:分析+通过数据形式键"
  • 历史基准比 eval 路径它替换 - 它需要没有 unsafe-eval 在你的CSP中. 基准为: single/expression.bench.ts > "8个依赖数的表达式:写出-评价-文本 (×20)"

文档

文档它的答案是什么
文件/API.mdh()、信号、控制流量、储存、组件、合成、传送门——以及四个未卫生的逃生舱门
文件/HTML-RUNTIME.md每个 data-* 指令和CSP安全表达语法及其限制
文件/印度地图将服务器发送到 HTML 中, 生成来自服务器数据的信号, 按键列表采纳
文件/CDN-AND-出口用于加载的 CDN 构建, 以及每个子路径导出包含的内容
文件/COMPARISONS.md和Solid的区别
文件/服务.md装运了试验相容性API并拆除了入境点
文件/实绩基准热道,有噪音地板
警卫 • 妇女 CSP.md (中文(简体) )威胁模式;在严格的内容-安全政策下运行
文档/README.md完整的文件索引,包括设计记录

实例: examples/ ——计数器,计数器jsx,csp,todo,数据表.


福玛堆栈的一部分

前端( TypeScript)

软件包说明
@ getforma/ 核心这个图书馆 - 反应DOM、信号、岛屿、安全部门改革水分
@ getforma/ 编译器FMIR 编译器和 重建 SSR 插件
@ getforma/ 构建生产管道——建造捆绑、内容散开、压缩、明细表

后端( Rust)

软件包说明
福玛尔FMIR 二进制格式 — 剖析器和本地 HTML 行走器
forma 服务器Axum 中间软件 — SSR 页面渲染, 资产服务, CSP 头

完整框架

软件包说明
@ getforma/ 创建- appnpx @getforma/create-app – 脚手架 一个 Rust 服务器 + TypeScript 前端工程

许可证

麻省理工学院

版本与发布记录

@getforma/core 共发布 45 个版本,首次发布于 2026/03/14;过去 12 个月发布了 45 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.2.0latest2026/10/2819 天前
3.2.0-rc.3next2026/10/2719 天前
3.2.0-rc.22026/10/2720 天前
3.2.0-rc.12026/10/2720 天前
3.1.02026/10/2620 天前
3.1.0-rc.32026/10/2621 天前

关于 @getforma/core 的常见问题

@getforma/core 是什么?

真正的 DOM 反应库——细纹信号,岛屿建筑,SSR水分. 没有虚拟的DOM,没有抖动。 CDN HTML 运行时使用一个零 eval 的 CSP 安全允许列表表达式解释器. 套装大小由脚本/检查大小-mjs来测量.

如何安装 @getforma/core?

在项目目录运行 npm install @getforma/core,或使用 pnpm add / yarn add / bun add。

@getforma/core 支持 TypeScript 吗?

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

@getforma/core 支持 ESM 还是 CommonJS?

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

@getforma/core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@getforma/core 可以商用吗?

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

@getforma/core 的下载量有多少?

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

@getforma/core 还在维护吗?

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