福马JS
反应 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.md | h()、信号、控制流量、储存、组件、合成、传送门——以及四个未卫生的逃生舱门 |
| 文件/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/ 创建- app | npx @getforma/create-app – 脚手架 一个 Rust 服务器 + TypeScript 前端工程 |
许可证
麻省理工学院