feat(runtime): add Buerli (ClassCAD) WASM kernel plugin

[rifont]

Summary

Adds the Buerli (ClassCAD) kernel as a first-party plugin to @taucad/runtime, using the WASM-only variant with no WebSocket connections. Users import from @buerli.io/classcad to access the Solid, Part, Assembly, Sketch, and Curve APIs powered by the ClassCAD engine running entirely in-browser via WebAssembly.

Changes

Kernel Implementation

• packages/runtime/src/kernels/buerli/buerli.kernel.ts — Full defineKernel implementation with WASM-only ClassCAD client initialization, module registration, bundler integration, geometry conversion to glTF, and export support
• packages/runtime/src/kernels/buerli/buerli.plugin.ts — Plugin factory with createKernelPlugin, detect pattern for @buerli.io/classcad imports

System Wiring

• Plugin factories (kernel-factories.ts), kernel exports (kernels-entry.ts), presets (presets.ts)
• package.json exports + publishConfig for ./kernels/buerli subpath
• tsdown.config.ts build entry, smoke ESM import test

Catalog & UI

• libs/types/src/constants/kernel.constants.ts — Added buerli to KernelBackend union and kernelConfigurations array
• apps/ui/app/constants/kernel-worker.constants.ts — Added buerli() to default kernel options
• apps/ui/app/environment.config.ts — Added optional CLASSCAD_WASM_KEY env var

AI Chat Prompts

• buerli.prompt.config.ts + buerli.prompt.example.ts — Prompt configuration and canonical example

Monaco IntelliSense

• libs/api-extractor/src/extract-buerli-types.ts — Self-contained type extraction script
• Registered in @taucad/api-extractor kernelTypeMaps array

Research & Documentation

• docs/research/buerli-classcad-kernel-integration.md — Research doc covering API surface, WASM runtime constraints, and test strategy
• Updated docs/policy/runtime-architecture-policy.md
• Tracked buerli-examples and buerligons repos via repos.yaml

Tests (40 passing)

Tests modeled after real buerli-examples patterns (Solid API, Part API, Sketch API):

Category	Count	What it validates
Kernel metadata & schema	2	Name, version, optional classcadKey
getDependencies	1	Bundler delegation
exportGeometry	4	GLB/GLTF export, unsupported format, no-geometry
getParameters (unit)	2	Bundle/execute failure propagation
createGeometry (unit)	3	Empty return, bundle failure, runtime error
getParameters (integration)	5	Solid/Part/Lego/Flange params via real bundler
Solid API patterns	5	Box, cylinder, subtraction, multi-solid, union
Part API patterns	3	CreatePart, MechanicalPart, Flange
Three.js toJSON conversion	2	Single + multi-geometry BufferGeometry
Parametric geometry	2	Default params, parameter override
Multi-file projects	2	Local imports, barrel exports
ArrayBuffer passthrough	1	Raw GLB binary
Empty geometry	2	Undefined return, empty array
Error handling	3	Syntax, runtime, type errors
Export pipeline	1	GLB output validation
Module resolution	2	Named + default imports

WASM Runtime Constraint

ClassCAD WASM uses Comlink + browser Web Workers and cannot run in Node.js/Vitest (ReferenceError: Worker is not defined). Tests validate the full kernel pipeline (module registration → bundling → execution → geometry conversion → GLB) using realistic geometry data structures matching what createBufferGeometry() returns in the browser.

See: docs/research/buerli-classcad-kernel-integration.md

Testing

• ✅ pnpm nx test runtime ./src/kernels/buerli/buerli.kernel.test.ts --watch=false — 40/40 pass
• ✅ pnpm nx test runtime ./src/testing/smoke-esm.test.ts --watch=false — 7/7 pass
• ✅ pnpm nx lint runtime --files='src/kernels/buerli/buerli.kernel.ts src/kernels/buerli/buerli.plugin.ts'
• ✅ pnpm nx lint runtime --files='src/kernels/buerli/buerli.kernel.test.ts'
• ✅ pnpm nx lint api --files='...', pnpm nx lint ui --files='...', pnpm nx lint types --files='...'
• ✅ pnpm nx typecheck types
• ⚠️ pnpm nx typecheck runtime — pre-existing opencascade WASM module errors only

  

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0f832c55-f090-4c97-a41b-5a1bd4eef132

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/add-buerli-kernel-58fa

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}