文档 / 架构原理
架构原理
这一板块不讲"怎么用",讲"怎么运作"。从 init.js
注入运行时开始,到 vino()
返回真实 DOM 结束——中间发生了什么,以及为什么这样设计。
index.html
/static/init.css
/static/init.js
└─ window.jsx = (tag, props, ...childs) => HTMLElement
└─ globalThis._brk_ = { card, icon, opens, _load, ... }
└─ globalThis._brk_ = { card, icon, opens, _load, ... }
↓
<script>brk.render({ load: ... })</script>
↓
page.mjs
export const page = { vino }
└─ ESM 模块,由 brk._load 动态 import()
└─ 编译产物 ≈ 100% 应用代码
└─ 编译产物 ≈ 100% 应用代码
↓
brk._load(meta.load).then(v => ...)
↓
document
document.body.appendChild( v.page.vino({}) )
└─ vino() 返回一个 HTMLElement
└─ 之后的一切更新,由页面自己负责
└─ 之后的一切更新,由页面自己负责
// 运行时
框架真正干活的三块
01 / INIT RUNTIME
→
init 运行时
init.js 如何把 window.jsx 与 globalThis._brk_ 一次性注入,如何保证这一切在页面代码执行之前就绪。
整个运行时为什么能小于 10kb?
02 / JSX RUNTIME
→
jsx() 函数
手写的运行时核心。标签分派规则、cls / css / clk 的 DOM 映射、children 的深度展开,全在这一层。
jsx() 怎么区分原生标签和组件?
03 / TYPE SHELL
→
类型壳 @/brk
@/brk 是运行时的一行空壳 + 完整的类型定义。为什么这么设计,以及 TypeScript 是如何参与进来的。
为什么 import 的不是真模块?
// 协议
服务端与浏览器之间的两份约定
// 权衡
三个决定,构成了 brk 的全部形态
// 阅读前提
这个板块适合谁
如果你只是想用 brk 写页面,指南已经足够,不需要读这里。
架构原理是给两类人准备的:一是想贡献代码的人——需要知道运行时如何组织; 二是在选型、需要看到底的人——不想只信文档说"轻量",想自己判断这套架构是否合理。
板块里的每一页都会引用 init.js 的源码片段。你可以直接在浏览器里打开
/static/init.js
对着看。