Rust 与浏览器 WASM 接口#
核心已完整迁入 Cargo workspace,不需要 Node.js 或 npm。原 Node/TypeScript API 由 Rust 库和浏览器 WASM 入口接替。
use laymesh_core::engine::compile_file;let scene = compile_file("figure.lay")?;let svg = laymesh_render::render_svg(&scene)?;内存源码使用 compile_source(source, filename, Host),资源通过 Host.files 提供。原生 CLI 使用系统字体;WASM 使用宿主显式注册的字体,文档网站会注册随网页提供的正文字体。浏览器绑定提供 render(source, filename, files_json) 和 language_query(files_json, filename, method, offset, locale),使用同一解析、布局、字体与 SVG 实现;偏移量为 UTF-16。
Python/Jupyter 公共接口保持不变,调用本地原生程序;LAYMESH_CLI 可指定另一原生构建。
workflow#
本流程的完整源码与可执行验证文件列在功能覆盖清单。组合使用时请遵循本页的输入条件与限制。
从 Node 调用原生 CLI#
旧 TypeScript 包已经移除。Node 可通过标准库调用同一个原生程序,此示例不依赖 npm 包。命令参数单独传递,支持含空格的路径;资源仍相对 .lay 文件解析。
// Node uses the existing native CLI; there is no separate Node layout engine.import {execFileSync} from 'node:child_process';import {fileURLToPath} from 'node:url';const binary=process.env.LAYMESH_CLI||fileURLToPath(new URL('../../target/release/laymesh',import.meta.url));const source=process.argv[2]||fileURLToPath(new URL('../manual/line.lay',import.meta.url));const output=process.argv[3]||'figure.svg';execFileSync(binary,['validate',source],{stdio:'inherit'});execFileSync(binary,['render',source,'-o',output],{stdio:'inherit'});node examples/integration/render.mjs examples/manual/line.lay /tmp/figure.svg应用应处理子进程非零退出状态;LAYMESH_CLI 可选择其他原生构建。浏览器代码使用生成的浏览器 WASM 绑定,Node 程序不能依赖浏览器的字体加载流程。
浏览器 WASM 调用流程#
import init, {render, language_query} from "./wasm/laymesh_wasm.js";await init();const source = 'page=canvas(size=(60mm,40mm))\npage.add(rect(size=(30mm,20mm),fill="#087f8c"))';const filename = "/figure.lay";const result = JSON.parse(render(source, filename, "{}"));console.log(result.svg, result.inspection, result.warnings);const help = JSON.parse(language_query( JSON.stringify({[filename]: source}), filename, "hover", 7, "en"));console.log(help);render 返回 JSON,并非单独 SVG 字符串;资源参数是资源名到文本或字节数组的 JSON 映射。渲染文字前需注册实际字体字节;需要分开计时可用 prepare_render 返回的 job.svg()/inspection()。language_query 使用 UTF-16 偏移,静态分析不执行源码;失败时抛出包含诊断的 JS 异常。
原生 laymesh_render::render_export(&scene, extension, &ExportOptions) 提供与 CLI 相同的导出参数;ExportOptions::validate 可先校验。此接口仅启用 native 功能;浏览器 WASM 提供 SVG,也提供可复用的编译任务与 DisplayList 供 CanvasKit 绘制。导出格式与编码参数
交互绘制与动画#
浏览器实时预览使用 prepare_render 创建可复用任务,通过 draw_job 得到绘制任务。绘制任务提供 display_list 与 resource_bytes;时间采样得到对应动画帧,CanvasKit 绘制这些指令。render 的 SVG 返回值仍可用于静态集成;不能把它误认为全部浏览器绘制能力。宿主提供资源和字体,缺失资源通过实际编译请求补齐。语言服务偏移使用 UTF-16。
只读样式查询#
language_query 与原生 LSP 共享依赖索引。files_json 中提供本地 CSS 文本及未保存内容。definition 单个命中仍返回一个位置;多个 CSS 定义返回位置数组。以 filename="laymesh-library:/animate.css" 查询 stylesheetContent,返回 {uri,text,languageId:"css",readOnly:true};普通本地文件返回 null。
原生 LSP 通过 laymesh/stylesheetContent 接受 {uri} 并返回同一内容。内置定义使用虚拟 URI,避免跳到不存在的磁盘路径。
Object surfaces#
显示列表版本 3 携带 hint.surface3d、倒影与柔边参数;读取端兼容版本 1–3。共享浏览器渲染器调用 WASM 的 surface_texture_region(mesh_json, region, density) 选择纹理区域,再调用 raster_surface3d(mesh_json, rgba, texture_width, texture_height, region, width, height) 统一处理几何、遮挡和光照。内联 worker 宿主在 WASM 初始化后通过 setSurfaceRasterizer 注入这两个函数。升级时应同步编译器、播放、编辑器和导出运行时。同步 RenderJob.svg() 接口也会嵌入局部三维 PNG;交互预览使用 CanvasKit 提供二维纹理与页面合成。