LessJS

English | 简体中文

Deno-first Web Components 框架。基于 Declarative Shadow DOM SSR/SSG + Island 升级：先输出可爬取、可缓存的 HTML，再按需升级交互组件。

特性

• SSG-first — 静态 HTML 输出，零 JS 首屏
• Declarative Shadow DOM — WHATWG 标准，无框架标记
• Island 升级 — 仅交互组件加载客户端 JS
• Universal WC Engine (v0.18.0) — 自动检测第三方 Web Component，4 级兼容性分类（ssr-capable / client-only / rejected / experimental-dom）
• validate-manifest CLI (v0.18.1) — 安装前验证 CEM manifest 兼容性
• less add 安全安装 (v0.18.2) — dry-run + 验证门禁 + 计划生成
• DOM 模拟实验 (v0.18.3) — Happy DOM 驱动的 client-only 组件 SSR 实验
• Renderer Protocol — 结构化渲染输出 + 错误分类 + DSD 指标
• 多适配器 — Lit / React / Vanilla 适配器
• Deno workspace — 纯 ESM，零 package.json

快速开始

deno run -A jsr:@lessjs/create my-app
cd my-app
deno task dev      # 开发服务器
deno task build    # SSG 构建

要求：Deno 2.7+ / 支持 Declarative Shadow DOM 的现代浏览器

包

包	职责
@lessjs/core	DSD 渲染器、Renderer Protocol、CEM 解析器、兼容性分类器、manifest 验证
@lessjs/adapter-vite	Vite 编排、路由扫描、SSG 管线、CEM 自动检测
@lessjs/adapter-lit	Lit TemplateResult → DSD HTML
@lessjs/adapter-react	React 适配器
@lessjs/adapter-vanilla	Vanilla JS 适配器
@lessjs/app	统一入口 lessjs()
@lessjs/content	Blog、Nav、Sitemap 插件
@lessjs/i18n	国际化路由
@lessjs/ui	Web Components 组件库
@lessjs/signals	Signals 辅助
@lessjs/rpc	Fetch RPC
@lessjs/create	项目脚手架 CLI

渲染管线

render() → RenderAdapter → renderDSD() → DSD HTML → SSG → 浏览器解析
                                                       ↓
                                            customElements.upgrade()
                                                       ↓
                                            dsd-interactive → 绑定 hydrateEvents

第三方包兼容性管线 (v0.18.x)

node_modules/*/custom-elements.json → CEM Parser → 4级分类器 → SSR admission
                                                          ↓
                                              less validate-manifest (CLI)
                                                          ↓
                                              less add (安全安装)

路线图

版本	目标	状态
v0.15	Renderer Kernel Protocol	✅ 完成
v0.16	WC Package Protocol	✅ 完成
v0.17	Ecosystem Entry + SSR边界	✅ 完成
v0.18	Universal WC Engine	当前
v0.18.0	CEM 解析器 + 4级分类 + 自动检测	✅ 完成
v0.18.1	validate-manifest CLI	✅ 完成
v0.18.2	less add 安全安装流	✅ 完成
v0.18.3	DOM 模拟实验（Happy DOM）	✅ 完成
v0.19	Registry Hub + Platform	📋 计划中
v1.0	API Freeze	🚀 远期

详见 ADR 文档 和 官方文档。

治理文档

docs/
├── adr/           架构决策记录
├── changelog/     版本变更日志
├── conventions/   编码规范
├── sop/           标准作业流程
└── status/        项目状态 + 审核归档

贡献

参见 CONTRIBUTING.md。

License

MIT