Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Document web SDK pocket view sample

Yuechen Li0eb3fe458379
diff --git a/demos/Aetherion.Helios/.gitignore b/demos/Aetherion.Helios/.gitignore
new file mode 100644
index 00000000..98de87d5
--- /dev/null
+++ b/demos/Aetherion.Helios/.gitignore
@@ -0,0 +1,5 @@
+node_modules/
+dist/
+*.tsbuildinfo
+vite.config.js
+vite.config.d.ts
diff --git a/demos/Aetherion.Helios/README.md b/demos/Aetherion.Helios/README.md
new file mode 100644
index 00000000..53e38706
--- /dev/null
+++ b/demos/Aetherion.Helios/README.md
@@ -0,0 +1,36 @@
+# Helios by Aetheris
+
+Helios is the deliberately bounded reference CAD editor for the public `@aetheris/cad` Web SDK. Firmament remains the model authority; Helios is an authoring, inspection, and presentation surface.
+
+## Run
+
+From this directory:
+
+```powershell
+npm run sdk:install
+npm run dev
+```
+
+`sdk:install` builds and packs the public SDK, then installs that tarball as an ordinary package dependency. Helios imports only `@aetheris/cad` and `@aetheris/cad/vite`; it does not import repository internals.
+
+## Architecture
+
+- `src/sdk/` is the replaceable runtime boundary. `WebSdkCadRuntime` is the X1 browser/WASM implementation.
+- `src/viewport/` consumes only `DisplayMesh`, preserving SDK definitions and occurrences. Ray hits go through `resolveSelection`; tree selections go through `selectionForEntity`.
+- `src/model-tree/` and `src/inspector/` render public semantic records and property schemas.
+- `src/source/` exposes authoritative Firmament text and normalized diagnostics.
+- `src/commands/` contains bounded, deterministic source-authoring helpers. It never constructs geometry.
+- `src/themes/` defines the reusable Mars and Sirius token sets.
+
+The browser runtime runs on the page thread in X1. Large rebuilds may temporarily block UI. Sheet metal is intentionally disabled because the public capability matrix does not qualify it for browser/WASM.
+
+## Qualification
+
+```powershell
+npm test
+npm run build
+```
+
+Chromium is the qualified baseline. The live qualification flow covers the bracket, semantic selection in both directions, valid and invalid property edits, last-valid-geometry retention, source rebuild, assembly hierarchy/occurrences, Mars/Sirius, fit/orbit/pan/zoom, and STEP export invocation.
+
+See [the public reference-editor guide](../../docs/public/web-sdk/reference-editor.md) and [Build Your Own CAD Frontend](../../docs/public/web-sdk/build-your-own-cad-frontend.md).
diff --git a/demos/Aetherion.Helios/index.html b/demos/Aetherion.Helios/index.html
new file mode 100644
index 00000000..e2645ca6
--- /dev/null
+++ b/demos/Aetherion.Helios/index.html
@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="description" content="Helios is a reference CAD editor built on the public Aetheris Web SDK." />
+ <title>Helios by Aetheris</title>
+ </head>
+ <body>
+ <div id="root"></div>
+ <script type="module" src="/src/main.tsx"></script>
+ </body>
+</html>
diff --git a/demos/Aetherion.Helios/package-lock.json b/demos/Aetherion.Helios/package-lock.json
new file mode 100644
index 00000000..6e74a67c
--- /dev/null
+++ b/demos/Aetherion.Helios/package-lock.json
@@ -0,0 +1,2431 @@
+{
+ "name": "@aetheris/helios",
+ "version": "0.1.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "@aetheris/helios",
+ "version": "0.1.0",
+ "dependencies": {
+ "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz",
+ "@vitejs/plugin-react": "latest",
+ "react": "latest",
+ "react-dom": "latest",
+ "three": "latest",
+ "typescript": "latest",
+ "vite": "latest"
+ },
+ "devDependencies": {
+ "@testing-library/jest-dom": "latest",
+ "@testing-library/react": "latest",
+ "@types/react": "latest",
+ "@types/react-dom": "latest",
+ "@types/three": "latest",
+ "jsdom": "latest",
+ "vitest": "latest"
+ }
+ },
+ "node_modules/@adobe/css-tools": {
+ "version": "4.5.0",
+ "resolved": "https://registry.npmjs.org/@adobe/css-tools/-/css-tools-4.5.0.tgz",
+ "integrity": "sha512-6OzddxPio9UiWTCemp4N8cYLV2ZN1ncRnV1cVGtve7dhPOtRkleRyx32GQCYSwDYgaHU3USMm84tNsvKzRCa1Q==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@aetheris/cad": {
+ "version": "2.0.0-preview.3",
+ "resolved": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz",
+ "integrity": "sha512-wuLetfhvqZLflQaWyL410pVMiOuNMKfXMBsdIkBV0bn5/u7GSFUBh70XtYEr5+RtnCdj5qCJIUK7fZJ7YJIQnw==",
+ "license": "AGPL-3.0-only",
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@asamuzakjp/css-color": {
+ "version": "6.0.7",
+ "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-6.0.7.tgz",
+ "integrity": "sha512-vC/bk1Lz7Tn/EfU9/apOTBk80/8dyGyWMowPoV1tJ52muDGsDqt2HPT2klrFUiY60MQmQv9q8yIht15JnBgDGw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@csstools/css-calc": "^3.3.0",
+ "@csstools/css-color-parser": "^4.1.10",
+ "@csstools/css-parser-algorithms": "^4.0.0",
+ "@csstools/css-tokenizer": "^4.0.0",
+ "lru-cache": "^11.5.2"
+ },
+ "engines": {
+ "node": "^22.13.0 || >=24.0.0"
+ }
+ },
+ "node_modules/@asamuzakjp/dom-selector": {
+ "version": "8.3.2",
+ "resolved": "https://registry.npmjs.org/@asamuzakjp/dom-selector/-/dom-selector-8.3.2.tgz",
+ "integrity": "sha512-93Z1N+BQNXysodoicpOIyNh2drHfz/CTf9nnT0FEx72GJcIiwgydD7tGAr78j41LsYn3hlRn+LdGPuBLn1Bl8Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "bidi-js": "^1.0.3",
+ "css-tree": "^3.2.1",
+ "is-potential-custom-element-name": "^1.0.1",
+ "lru-cache": "^11.5.2"
+ },
+ "engines": {
+ "node": "^22.13.0 || >=24.0.0"
+ }
+ },
+ "node_modules/@babel/code-frame": {
+ "version": "7.29.7",
+ "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
+ "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true,
+ "dependencies": {
+ "@babel/helper-validator-identifier": "^7.29.7",
+ "js-tokens": "^4.0.0",
+ "picocolors": "^1.1.1"
+ },
+ "engines": {
+ "node": ">=6.9.0"
+ }
+ },
+ "node_modules/@babel/helper-validator-identifier": {
+ "version": "7.29.7",
+ "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+ "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true,
+ "engines": {
+ "node": ">=6.9.0"
+ }
+ },
+ "node_modules/@babel/runtime": {
+ "version": "7.29.7",
+ "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz",
+ "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6.9.0"
+ }
+ },
+ "node_modules/@bramus/specificity": {
+ "version": "2.4.2",
+ "resolved": "https://registry.npmjs.org/@bramus/specificity/-/specificity-2.4.2.tgz",
+ "integrity": "sha512-ctxtJ/eA+t+6q2++vj5j7FYX3nRu311q1wfYH3xjlLOsczhlhxAg2FWNUXhpGvAw3BWo1xBcvOV6/YLc2r5FJw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "css-tree": "^3.0.0"
+ },
+ "bin": {
+ "specificity": "bin/cli.js"
+ }
+ },
+ "node_modules/@csstools/color-helpers": {
+ "version": "6.1.1",
+ "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-6.1.1.tgz",
+ "integrity": "sha512-gLNsunvwf3mCi5u5o46/Z/JcJMnhbHSaZ69rkgPzNM3J4s8hWwpPUQB6/tt0EDFyCiWzxANlx+2LJwpYj4zS1w==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/csstools"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/csstools"
+ }
+ ],
+ "license": "MIT-0",
+ "engines": {
+ "node": ">=20.19.0"
+ }
+ },
+ "node_modules/@csstools/css-calc": {
+ "version": "3.4.0",
+ "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-3.4.0.tgz",
+ "integrity": "sha512-XQKj5B7QiZcHiegCOCAzcAOJdhGgWOHbbu62h5e5mkHnn8lWcfiJhllkqWmxu5zWR9jucPHuo1iTB56P033hcg==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/csstools"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/csstools"
+ }
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=20.19.0"
+ },
+ "peerDependencies": {
+ "@csstools/css-parser-algorithms": "^4.0.0",
+ "@csstools/css-tokenizer": "^4.0.0"
+ }
+ },
+ "node_modules/@csstools/css-color-parser": {
+ "version": "4.2.3",
+ "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-4.2.3.tgz",
+ "integrity": "sha512-y4LpL+lmpuyKDiEFq2PnZUVFdAjsoB/qQJod79yLNokXyW7jewi+/WJ69EfItj8A2unWtxXnGjw6LYXgXu5ZjA==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/csstools"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/csstools"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "@csstools/color-helpers": "^6.1.1",
+ "@csstools/css-calc": "^3.4.0"
+ },
+ "engines": {
+ "node": ">=20.19.0"
+ },
+ "peerDependencies": {
+ "@csstools/css-parser-algorithms": "^4.0.0",
+ "@csstools/css-tokenizer": "^4.0.0"
+ }
+ },
+ "node_modules/@csstools/css-parser-algorithms": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-4.0.0.tgz",
+ "integrity": "sha512-+B87qS7fIG3L5h3qwJ/IFbjoVoOe/bpOdh9hAjXbvx0o8ImEmUsGXN0inFOnk2ChCFgqkkGFQ+TpM5rbhkKe4w==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/csstools"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/csstools"
+ }
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=20.19.0"
+ },
+ "peerDependencies": {
+ "@csstools/css-tokenizer": "^4.0.0"
+ }
+ },
+ "node_modules/@csstools/css-syntax-patches-for-csstree": {
+ "version": "1.1.14",
+ "resolved": "https://registry.npmjs.org/@csstools/css-syntax-patches-for-csstree/-/css-syntax-patches-for-csstree-1.1.14.tgz",
+ "integrity": "sha512-HpbVXyrofRXpHpgkNIjU/3EWR4WJvOkO3emNK/L6X/mTJU7bGUI3AkkpoTNXznQLp0KRjLHELTGeKI5dIkI9JQ==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/csstools"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/csstools"
+ }
+ ],
+ "license": "MIT-0",
+ "peerDependencies": {
+ "css-tree": "^3.2.1"
+ },
+ "peerDependenciesMeta": {
+ "css-tree": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@csstools/css-tokenizer": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-4.0.0.tgz",
+ "integrity": "sha512-QxULHAm7cNu72w97JUNCBFODFaXpbDg+dP8b/oWFAZ2MTRppA3U00Y2L1HqaS4J6yBqxwa/Y3nMBaxVKbB/NsA==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/csstools"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/csstools"
+ }
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=20.19.0"
+ }
+ },
+ "node_modules/@dimforge/rapier3d-compat": {
+ "version": "0.12.0",
+ "resolved": "https://registry.npmjs.org/@dimforge/rapier3d-compat/-/rapier3d-compat-0.12.0.tgz",
+ "integrity": "sha512-uekIGetywIgopfD97oDL5PfeezkFpNhwlzlaEYNOA0N6ghdsOvh/HYjSMek5Q2O1PYvRSDFcqFVJl4r4ZBwOow==",
+ "dev": true,
+ "license": "Apache-2.0"
+ },
+ "node_modules/@exodus/bytes": {
+ "version": "1.15.1",
+ "resolved": "https://registry.npmjs.org/@exodus/bytes/-/bytes-1.15.1.tgz",
+ "integrity": "sha512-S6mL0yNB/Abt9Ei4tq8gDhcczc4S3+vQ4ra7vxnAf+YHC02srtqxKKZghx2Dq6p0e66THKwR6r8N6P95wEty7Q==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+ },
+ "peerDependencies": {
+ "@noble/hashes": "^1.8.0 || ^2.0.0"
+ },
+ "peerDependenciesMeta": {
+ "@noble/hashes": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@jridgewell/resolve-uri": {
+ "version": "3.1.2",
+ "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+ "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6.0.0"
+ }
+ },
+ "node_modules/@jridgewell/sourcemap-codec": {
+ "version": "1.6.0",
+ "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz",
+ "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@jridgewell/trace-mapping": {
+ "version": "0.3.31",
+ "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+ "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/resolve-uri": "^3.1.0",
+ "@jridgewell/sourcemap-codec": "^1.4.14"
+ }
+ },
+ "node_modules/@oxc-project/types": {
+ "version": "0.150.0",
+ "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.150.0.tgz",
+ "integrity": "sha512-rDS5/31E9HfPl/CIzGrn0DOlvBbXFseQ5URJ9sYMfstbKLD/c6Gm9vmRzRGDdAXyOIL4zmO37lc9RIwYqVruZw==",
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/sponsors/oxc-project"
+ }
+ },
+ "node_modules/@rolldown/binding-android-arm-eabi": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.9.tgz",
+ "integrity": "sha512-tNISae1QEf/vkb3xkRcjV5SEdzPE97We5IVaa2Z8jSszQPZ8U60B/YCYpw4QI7VidYsBtKavczXf+DyDs9WGxw==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-android-arm64": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.9.tgz",
+ "integrity": "sha512-YC8YsI30o606GTZi0VyzYlsDKFP8W61i/QzayHDkLbNEz/IShqAmTa+hsJRj13xTHA0H+6fk4b2UmGn+Q/cMlg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-darwin-arm64": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.9.tgz",
+ "integrity": "sha512-IwhlH3qK5urrY8hZiEgGkHKEFN901p/p2bjxCxJlr4GyNnF7wYpUvK+Y43uaRYuC4hpfjzbR3SJC3arX1jGvmw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-darwin-x64": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.9.tgz",
+ "integrity": "sha512-XxpJfVzFh+jilRxIXUqcfYAYcunIc/XEzIizsOL1fcJee5Sf7H3mH8WlLmfHfluz5amqR88QQo9izKtmMlavAw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-freebsd-x64": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.9.tgz",
+ "integrity": "sha512-kSfvhmgeWyfkbT3p/1s5vSgboogoah2zkm9fX2zjg2hHxSV7T4KhMWRUUaRk4OXNqoD3QAUeRqLcs1aZOK4U1g==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-arm-gnueabihf": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.9.tgz",
+ "integrity": "sha512-1RVzG17pxqbTfYLC352JlLt6kKLG+6Hr30n8DlIJqsnV5luUDd2Qdx9Ayw1Cabfyb1K9k0jXEZ7evxkRoT+uiw==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-arm64-gnu": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.9.tgz",
+ "integrity": "sha512-BXqPvZ2drqVD+/Z8UpKwcs4Mp7grM+eGFku4CAEKrEtcbAsUpzREphK1sogCRZGreVPiMkiiBtw0n3TPteuqvw==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-arm64-musl": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.9.tgz",
+ "integrity": "sha512-11vWvo8YDwLzukt27J3aYDWU+gg2P7J+ZOmiJ0hkF5BXZDW7pVya7r40MXDy6ya0i9KamoENSVKIugvJNgFXIA==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-ppc64-gnu": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.9.tgz",
+ "integrity": "sha512-a1tijMkdwsIARtc0F39ApURROkf3NwqinI6TOiSSWCTR7dT96dffNvMUtDHnq64wKNTIZOIlzKrFvvFUznJiyw==",
+ "cpu": [
+ "ppc64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-s390x-gnu": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.9.tgz",
+ "integrity": "sha512-x6SQNdAvv4c3hWqTMaWuawzMX9myaCs/yEmlGsxJzkdClnHW7FbrjQuSiRDhuSYzEYoEMhsaJy9qHG/XNemJPQ==",
+ "cpu": [
+ "s390x"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-x64-gnu": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.9.tgz",
+ "integrity": "sha512-9s0AZ8BFK5/n7B/TBoa2yJE3gI3KURrbXcPBlsAsvjU4VeJKgE90y1YtNxyEUIcHPQkg6/yfF3qihUrcM/Kf0Q==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-x64-musl": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.9.tgz",
+ "integrity": "sha512-P7VWAmV+WdJluH7ovnRGoiv2i8To7GAZ+kGzfGup635cyL7SyYl3lSUaA3Gp5THf0n/Co5EyEqb2zbqq+nMOHQ==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-openharmony-arm64": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.9.tgz",
+ "integrity": "sha512-1qixtsE4BK8h+yS3BfmZ09UhA7O/N4IACva6YBr7EBvCJraByTuRcgOTaiA62Tm0vey3UcKXLOaoGHtYmNGEVg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openharmony"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-win32-arm64-msvc": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.9.tgz",
+ "integrity": "sha512-ok8IQjcEPs1AKZfuEUznVBrJw+gK4soq+bx8b1X2XoMqVClarc1q5JDmVtWXY1xfr6ZuHTAsPXHTgTrqKTZeww==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-win32-x64-msvc": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.9.tgz",
+ "integrity": "sha512-Ip2mXoU0hM0boq3Rf+ekuT653OROSo6aSYcPT1VHE4q52KvyxgFkQgrgb/IEsxOuvQ2fZZbs8khJAyCEPM24/g==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/pluginutils": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz",
+ "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==",
+ "license": "MIT"
+ },
+ "node_modules/@testing-library/dom": {
+ "version": "10.4.2",
+ "resolved": "https://registry.npmjs.org/@testing-library/dom/-/dom-10.4.2.tgz",
+ "integrity": "sha512-yzr2S9HyAIdhz2/6qHgbs665Q7PKVcDF05vsOlHPxG1mo36gKVesdYVeDLnXgfjJ03CrKRk08knc6+E/9m8v2Q==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true,
+ "dependencies": {
+ "@babel/code-frame": "^7.10.4",
+ "@babel/runtime": "^7.12.5",
+ "@types/aria-query": "^5.0.1",
+ "aria-query": "5.3.0",
+ "dom-accessibility-api": "^0.5.9",
+ "lz-string": "^1.5.0",
+ "picocolors": "1.1.1",
+ "pretty-format": "^27.0.2"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@testing-library/jest-dom": {
+ "version": "7.0.1",
+ "resolved": "https://registry.npmjs.org/@testing-library/jest-dom/-/jest-dom-7.0.1.tgz",
+ "integrity": "sha512-oMDTC3oA+6CXSO2JZnvOI7CA6oVub6kij5ggk9ohwye5slmkwxYDXcPOVxgMw/RQlticjtO0C1RZkR97HgrWMw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@adobe/css-tools": "^4.4.0",
+ "aria-query": "^5.0.0",
+ "css.escape": "^1.5.1",
+ "dom-accessibility-api": "^0.6.3",
+ "picocolors": "^1.1.1",
+ "redent": "^3.0.0"
+ },
+ "engines": {
+ "node": ">=22",
+ "npm": ">=6",
+ "yarn": ">=1"
+ },
+ "peerDependencies": {
+ "@testing-library/dom": ">=10 <11",
+ "vitest": ">= 0.32"
+ },
+ "peerDependenciesMeta": {
+ "vitest": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@testing-library/jest-dom/node_modules/dom-accessibility-api": {
+ "version": "0.6.3",
+ "resolved": "https://registry.npmjs.org/dom-accessibility-api/-/dom-accessibility-api-0.6.3.tgz",
+ "integrity": "sha512-7ZgogeTnjuHbo+ct10G9Ffp0mif17idi0IyWNVA/wcwcm7NPOD/WEHVP3n7n3MhXqxoIYm8d6MuZohYWIZ4T3w==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@testing-library/react": {
+ "version": "16.3.3",
+ "resolved": "https://registry.npmjs.org/@testing-library/react/-/react-16.3.3.tgz",
+ "integrity": "sha512-Uo193NgQbPMz6lrrhtRQQFcMC6Re/ELLFbbuVL30WDlZxlpZf9/lMHTAVxPRLw1q1iu9OJmR1c2BLiENRstdBg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@babel/runtime": "^7.12.5"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "peerDependencies": {
+ "@testing-library/dom": "^10.0.0",
+ "@types/react": "^18.0.0 || ^19.0.0",
+ "@types/react-dom": "^18.0.0 || ^19.0.0",
+ "react": "^18.0.0 || ^19.0.0",
+ "react-dom": "^18.0.0 || ^19.0.0"
+ },
+ "peerDependenciesMeta": {
+ "@types/react": {
+ "optional": true
+ },
+ "@types/react-dom": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@tweenjs/tween.js": {
+ "version": "23.1.3",
+ "resolved": "https://registry.npmjs.org/@tweenjs/tween.js/-/tween.js-23.1.3.tgz",
+ "integrity": "sha512-vJmvvwFxYuGnF2axRtPYocag6Clbb5YS7kLL+SO/TeVFzHqDIWrNKYtcsPMibjDx9O+bu+psAy9NKfWklassUA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@types/aria-query": {
+ "version": "5.0.4",
+ "resolved": "https://registry.npmjs.org/@types/aria-query/-/aria-query-5.0.4.tgz",
+ "integrity": "sha512-rfT93uj5s0PRL7EzccGMs3brplhcrghnDoV26NqKhCAS1hVo+WdNsPvE/yb6ilfr5hi2MEk6d5EWJTKdxg8jVw==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true
+ },
+ "node_modules/@types/chai": {
+ "version": "5.2.3",
+ "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz",
+ "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/deep-eql": "*",
+ "assertion-error": "^2.0.1"
+ }
+ },
+ "node_modules/@types/deep-eql": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz",
+ "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@types/estree": {
+ "version": "1.0.9",
+ "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+ "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@types/react": {
+ "version": "19.3.0",
+ "resolved": "https://registry.npmjs.org/@types/react/-/react-19.3.0.tgz",
+ "integrity": "sha512-N0rFCuH9YoxG9/m61l9MfpJKfmLOVU0em7ipIz6TRgSSkvReLB9vL85GB+yr8Bs5leqpvg96JSwF4ZS1s4viQg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "csstype": "^3.2.2"
+ }
+ },
+ "node_modules/@types/react-dom": {
+ "version": "19.3.0",
+ "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.3.0.tgz",
+ "integrity": "sha512-ZI7bU42mZXXKHn/qNLEw2IrbiINU7X5+vfgdixBHkCNpYWXjKgfQ/P+uyGb5CjOLB9UcnTeg3rylQtV2hym44Q==",
+ "dev": true,
+ "license": "MIT",
+ "peerDependencies": {
+ "@types/react": "^19.3.0"
+ }
+ },
+ "node_modules/@types/stats.js": {
+ "version": "0.17.4",
+ "resolved": "https://registry.npmjs.org/@types/stats.js/-/stats.js-0.17.4.tgz",
+ "integrity": "sha512-jIBvWWShCvlBqBNIZt0KAshWpvSjhkwkEu4ZUcASoAvhmrgAUI2t1dXrjSL4xXVLB4FznPrIsX3nKXFl/Dt4vA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@types/three": {
+ "version": "0.186.0",
+ "resolved": "https://registry.npmjs.org/@types/three/-/three-0.186.0.tgz",
+ "integrity": "sha512-mxYSBpDC+D0pLfSP6sW4WZTcT+nrtmZcimMqnVmy36Hte3XpeYSrvgg4TRdaM1GemGog1AWzI5qL2VoIfMXbJQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@dimforge/rapier3d-compat": "~0.12.0",
+ "@tweenjs/tween.js": "~23.1.3",
+ "@types/stats.js": "*",
+ "@types/webxr": ">=0.5.17",
+ "fflate": "~0.8.3",
+ "meshoptimizer": "~1.1.1"
+ }
+ },
+ "node_modules/@types/webxr": {
+ "version": "0.5.24",
+ "resolved": "https://registry.npmjs.org/@types/webxr/-/webxr-0.5.24.tgz",
+ "integrity": "sha512-h8fgEd/DpoS9CBrjEQXR+dIDraopAEfu4wYVNY2tEPwk60stPWhvZMf4Foo5FakuQ7HFZoa8WceaWFervK2Ovg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@typescript/typescript-aix-ppc64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-aix-ppc64/-/typescript-aix-ppc64-7.0.2.tgz",
+ "integrity": "sha512-MTKKkWB7p/0E9xi1d1tHtZ5PiLkGEMIq88pK2CubZjOsLtYTLqhgIgi6zepFa+9GHZ6h05NMCkQxGKiPXMxXtQ==",
+ "cpu": [
+ "ppc64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "aix"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-darwin-arm64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-darwin-arm64/-/typescript-darwin-arm64-7.0.2.tgz",
+ "integrity": "sha512-gowzar9MwS/aRWp6f3a4KUqzRjAZjOsmGNCM6LcTgXum+dBfgsBVMN+AgvOCCbguXyick6LJhpBszxMebJ8syA==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-darwin-x64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-darwin-x64/-/typescript-darwin-x64-7.0.2.tgz",
+ "integrity": "sha512-SZ9xZInqApNlNGc9s0W1VSsktYSOe9cFqNOIqmN1Gs8SmkjKZYFt017G4VwPxASInODuAdbTW7sXiFUf893RgA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-freebsd-arm64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-freebsd-arm64/-/typescript-freebsd-arm64-7.0.2.tgz",
+ "integrity": "sha512-W5NH4y/J0plIIS5b2xvTEkU7JFxyqdMAOgf+Ilhl0vHQXKO5dZoxd+C/jEtq56c4F3wk71RB4BMRQ2XdI+bwYQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-freebsd-x64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-freebsd-x64/-/typescript-freebsd-x64-7.0.2.tgz",
+ "integrity": "sha512-UMGDx5sTpzNw3WiPebH7l90IWfJggEd+egHt/q6p7/Cm3zqoV7VxkGXt+3DxPIw8CcmvAB0j3sVVfbhX+M4Tpw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-arm": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-arm/-/typescript-linux-arm-7.0.2.tgz",
+ "integrity": "sha512-gffT3xPz9sR7j/YJExkyPntrI0P2EP9XbOyWzth2/Gs0RstK+90RBcO0ncXoXy/beYll1SXw846Nf2zdnEz0QQ==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-arm64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-arm64/-/typescript-linux-arm64-7.0.2.tgz",
+ "integrity": "sha512-Qh4eU4/y3yDjnfjjyPYihMj5/ODIlmt+Bzu17OI+fiSRDW57QmU5SiN63exPRNJPKUzcc1INa1NXdrJ+MqHjUQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-loong64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-loong64/-/typescript-linux-loong64-7.0.2.tgz",
+ "integrity": "sha512-uEHck9i8hoAzXPiYRib1O7miOnz23SxIeVl6F4LXox+qov1K35jHcEW6VHKvZI+pyvl7fZEP4MCU5LYvIq1GuQ==",
+ "cpu": [
+ "loong64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-mips64el": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-mips64el/-/typescript-linux-mips64el-7.0.2.tgz",
+ "integrity": "sha512-R4KvAMnE43W5Qeqb0Ly56O3mWMWIAgsMyz36DCaycd5nbg/9kzm0liw3JocfRqyJY0KPmzFjbswozXyW0DnIYA==",
+ "cpu": [
+ "mips64el"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-ppc64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-ppc64/-/typescript-linux-ppc64-7.0.2.tgz",
+ "integrity": "sha512-DORx5b3sd/4S7eayxm4FQv+A7CrkUIGRaHiwI8oiHTAI1fAPWhF4J0vAlkC8biAlHSVVwxMQ3tjZ2/DVbnQiiA==",
+ "cpu": [
+ "ppc64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-riscv64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-riscv64/-/typescript-linux-riscv64-7.0.2.tgz",
+ "integrity": "sha512-wf0jqEDOjrPRnKwYRyyJDRo11KMbvMFrU+q4zqKyChODBzvlkbhNQfKvLxQCcwTpdDaXSHZTVuh0JoCrKCUMHQ==",
+ "cpu": [
+ "riscv64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-s390x": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-s390x/-/typescript-linux-s390x-7.0.2.tgz",
+ "integrity": "sha512-IkwJc3L7yhytWd/ewjyxNDfOmswCm9GWMJT/ue/dU4aZNbwZeYAetq42VyLmsmSjvoX7z74X6ZaYCtzAr0EuGw==",
+ "cpu": [
+ "s390x"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-linux-x64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-x64/-/typescript-linux-x64-7.0.2.tgz",
+ "integrity": "sha512-EYdf2cNg7rgCWJnxCdJ+F3V39O8ihb37eHAu1LK8oAFizgTQbPOK7zHHXbPt8rX24COqODXeI3sIf0fCXG7H/A==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-netbsd-arm64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-netbsd-arm64/-/typescript-netbsd-arm64-7.0.2.tgz",
+ "integrity": "sha512-+polYF4MF04aPpO5FTkHran9yUQDSXqy5GiSDKpsll5jy3l3+g9QLhpf39T+ePtefhXLOGrLl0QIjkQP6VnelA==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "netbsd"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-netbsd-x64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-netbsd-x64/-/typescript-netbsd-x64-7.0.2.tgz",
+ "integrity": "sha512-8YIT0EHM/3dq10ZOVF/A7pc/YSMtbcecct4rWtexrnSCHOPcpC2KTLXfTCR6vDpnSiY12heNb1GiN/wu+T/FyA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "netbsd"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-openbsd-arm64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-openbsd-arm64/-/typescript-openbsd-arm64-7.0.2.tgz",
+ "integrity": "sha512-APT8+ClYnuYm1u9+kgGXoMj2VzWzcymwh2gNSQVySHfkRDGOTVkoWLjCmOQSaO+PoqQ57B0flRp9SA+7GnnkzQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "openbsd"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-openbsd-x64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-openbsd-x64/-/typescript-openbsd-x64-7.0.2.tgz",
+ "integrity": "sha512-yX7s+Q0Dln0Dt9tEzZsAjXXR/+ytBM7AlglaqyeMPxQszJ1JhlJdZ6jLA+IzldHtflX81em7lDao1xXu+aRRkg==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "openbsd"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-sunos-x64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-sunos-x64/-/typescript-sunos-x64-7.0.2.tgz",
+ "integrity": "sha512-dLJDGaLZ1D4HPQn62u1n8mBDkJREwMsAkCdkwd4Ieqw+x3TUyTsqY0YiBCtE6H6OzzgGk3iuZ3vFWRS+E8/d1g==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "sunos"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-win32-arm64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-win32-arm64/-/typescript-win32-arm64-7.0.2.tgz",
+ "integrity": "sha512-Gyl1Vy6OsWesLzmq+EP0Fb7b4Nid5232AvcA2SFcdYreldpNtYFFofPjnt62y9hQy7VTaZp65ICJjuAQRaVcIQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@typescript/typescript-win32-x64": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/@typescript/typescript-win32-x64/-/typescript-win32-x64-7.0.2.tgz",
+ "integrity": "sha512-0BQ3HkAHHlKLSp1qRvf3SUhGpGsDuhB/jgFw75guyqbxJqEaS0Cw/VFO8i2nHglJUzQCRtMMR/IBAKE3ETMC4g==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=16.20.0"
+ }
+ },
+ "node_modules/@vitejs/plugin-react": {
+ "version": "6.1.1",
+ "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-6.1.1.tgz",
+ "integrity": "sha512-yxLaQV9gkhS8ezJqCM6+ndU7mDY6gqAg75NQ+0IjwEI8IYOmQCgkRwHKVSfWXW076DsqMo0Dk+0FK1U+M5RgFw==",
+ "license": "MIT",
+ "dependencies": {
+ "@rolldown/pluginutils": "^1.0.1"
+ },
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ },
+ "peerDependencies": {
+ "@rolldown/plugin-babel": "^0.1.7 || ^0.2.0",
+ "babel-plugin-react-compiler": "^1.0.0",
+ "oxc-transform-react": "^0.145.0",
+ "vite": "^8.0.0"
+ },
+ "peerDependenciesMeta": {
+ "@rolldown/plugin-babel": {
+ "optional": true
+ },
+ "babel-plugin-react-compiler": {
+ "optional": true
+ },
+ "oxc-transform-react": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@vitest/mocker": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-5.0.1.tgz",
+ "integrity": "sha512-6K1DoBNAPGvuOcSsGA4D6x+5zEEff/KmOOP3uetT2TrGpVfI+HRHRnJJfKi5ib/g1vx8IYHQD8s0pbJz8WQI7Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/trace-mapping": "0.3.31",
+ "@vitest/spy": "5.0.1",
+ "estree-walker": "^3.0.3",
+ "magic-string": "^1.2.3"
+ },
+ "funding": {
+ "url": "https://opencollective.com/vitest"
+ },
+ "peerDependencies": {
+ "msw": "^2.4.9",
+ "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+ },
+ "peerDependenciesMeta": {
+ "msw": {
+ "optional": true
+ },
+ "vite": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@vitest/spy": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-5.0.1.tgz",
+ "integrity": "sha512-rbto/mF/SGERxEgYOek7Xm6B9b+y+mVoo+f4b2LymYO8zM1b7uB5nHuhVMTP2hxdzgxvGiZYGxGIaMvL5y180Q==",
+ "dev": true,
+ "license": "MIT",
+ "funding": {
+ "url": "https://opencollective.com/vitest"
+ }
+ },
+ "node_modules/ansi-regex": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+ "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true,
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/ansi-styles": {
+ "version": "5.2.0",
+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz",
+ "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true,
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+ }
+ },
+ "node_modules/aria-query": {
+ "version": "5.3.0",
+ "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.0.tgz",
+ "integrity": "sha512-b0P0sZPKtyu8HkeRAfCq0IfURZK+SuwMjY1UXGBU27wpAiTwQAIlq56IbIO+ytk/JjS1fMR14ee5WBBfKi5J6A==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "dequal": "^2.0.3"
+ }
+ },
+ "node_modules/assertion-error": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
+ "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ }
+ },
+ "node_modules/bidi-js": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/bidi-js/-/bidi-js-1.1.0.tgz",
+ "integrity": "sha512-fX1Onk0tdVPC7obPWB5EbJ1z7NVhLq4m2xZLq2YXBkxzMXIGRpNMU88n0EPgWseKl12J7zXs7qrDxPK4sRs2fg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "require-from-string": "^2.0.2"
+ }
+ },
+ "node_modules/chai": {
+ "version": "6.2.2",
+ "resolved": "https://registry.npmjs.org/chai/-/chai-6.2.2.tgz",
+ "integrity": "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/css-tree": {
+ "version": "3.2.1",
+ "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz",
+ "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "mdn-data": "2.27.1",
+ "source-map-js": "^1.2.1"
+ },
+ "engines": {
+ "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0"
+ }
+ },
+ "node_modules/css.escape": {
+ "version": "1.5.1",
+ "resolved": "https://registry.npmjs.org/css.escape/-/css.escape-1.5.1.tgz",
+ "integrity": "sha512-YUifsXXuknHlUsmlgyY0PKzgPOr7/FjCePfHNt0jxm83wHZi44VDMQ7/fGNkjY3/jV1MC+1CmZbaHzugyeRtpg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/csstype": {
+ "version": "3.2.3",
+ "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+ "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/data-urls": {
+ "version": "7.0.0",
+ "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-7.0.0.tgz",
+ "integrity": "sha512-23XHcCF+coGYevirZceTVD7NdJOqVn+49IHyxgszm+JIiHLoB2TkmPtsYkNWT1pvRSGkc35L6NHs0yHkN2SumA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "whatwg-mimetype": "^5.0.0",
+ "whatwg-url": "^16.0.0"
+ },
+ "engines": {
+ "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+ }
+ },
+ "node_modules/data-urls/node_modules/whatwg-url": {
+ "version": "16.0.1",
+ "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-16.0.1.tgz",
+ "integrity": "sha512-1to4zXBxmXHV3IiSSEInrreIlu02vUOvrhxJJH5vcxYTBDAx51cqZiKdyTxlecdKNSjj8EcxGBxNf6Vg+945gw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@exodus/bytes": "^1.11.0",
+ "tr46": "^6.0.0",
+ "webidl-conversions": "^8.0.1"
+ },
+ "engines": {
+ "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+ }
+ },
+ "node_modules/decimal.js": {
+ "version": "10.6.0",
+ "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz",
+ "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/dequal": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
+ "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/detect-libc": {
+ "version": "2.1.2",
+ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/dom-accessibility-api": {
+ "version": "0.5.16",
+ "resolved": "https://registry.npmjs.org/dom-accessibility-api/-/dom-accessibility-api-0.5.16.tgz",
+ "integrity": "sha512-X7BJ2yElsnOJ30pZF4uIIDfBEVgF4XEBxL9Bxhy6dnrm5hkzqmsWHGTiHqRiITNhMyFLyAiWndIJP7Z1NTteDg==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true
+ },
+ "node_modules/entities": {
+ "version": "8.1.0",
+ "resolved": "https://registry.npmjs.org/entities/-/entities-8.1.0.tgz",
+ "integrity": "sha512-kxL7msIffSuh9aaFAMD7rxAIuTRMAHMeBtgHW2yUdWw732ZNh4MehkF2gdjvtdmikkaIP9bFDDJOPlsvm7avrA==",
+ "dev": true,
+ "license": "BSD-2-Clause",
+ "engines": {
+ "node": ">=20.19.0"
+ },
+ "funding": {
+ "url": "https://github.com/fb55/entities?sponsor=1"
+ }
+ },
+ "node_modules/es-module-lexer": {
+ "version": "2.3.2",
+ "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.3.2.tgz",
+ "integrity": "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/estree-walker": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+ "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0"
+ }
+ },
+ "node_modules/expect-type": {
+ "version": "1.4.0",
+ "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz",
+ "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=12.0.0"
+ }
+ },
+ "node_modules/fdir": {
+ "version": "6.5.0",
+ "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+ "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=12.0.0"
+ },
+ "peerDependencies": {
+ "picomatch": "^3 || ^4"
+ },
+ "peerDependenciesMeta": {
+ "picomatch": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/fflate": {
+ "version": "0.8.3",
+ "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.3.tgz",
+ "integrity": "sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/fsevents": {
+ "version": "2.3.3",
+ "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+ "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+ "hasInstallScript": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+ }
+ },
+ "node_modules/html-encoding-sniffer": {
+ "version": "6.0.0",
+ "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-6.0.0.tgz",
+ "integrity": "sha512-CV9TW3Y3f8/wT0BRFc1/KAVQ3TUHiXmaAb6VW9vtiMFf7SLoMd1PdAc4W3KFOFETBJUb90KatHqlsZMWV+R9Gg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@exodus/bytes": "^1.6.0"
+ },
+ "engines": {
+ "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+ }
+ },
+ "node_modules/indent-string": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz",
+ "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/is-potential-custom-element-name": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
+ "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/js-tokens": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+ "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true
+ },
+ "node_modules/jsdom": {
+ "version": "30.0.1",
+ "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-30.0.1.tgz",
+ "integrity": "sha512-52v7mUVUfNQVYYqE1lcdaymWL0njO7lTLUog6ZvW2U5KsbiLk/GnZlVJ+qx0xfNJZ6Gn+KSpPNE52vurbxZwrA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@asamuzakjp/css-color": "^6.0.5",
+ "@asamuzakjp/dom-selector": "^8.3.0",
+ "@bramus/specificity": "^2.4.2",
+ "@csstools/css-syntax-patches-for-csstree": "^1.1.7",
+ "@exodus/bytes": "^1.15.1",
+ "css-tree": "^3.2.1",
+ "data-urls": "^7.0.0",
+ "decimal.js": "^10.6.0",
+ "html-encoding-sniffer": "^6.0.0",
+ "is-potential-custom-element-name": "^1.0.1",
+ "lru-cache": "^11.5.2",
+ "parse5": "^8.0.1",
+ "saxes": "^6.0.0",
+ "symbol-tree": "^3.2.4",
+ "tough-cookie": "^6.0.2",
+ "undici": "^8.9.0",
+ "w3c-xmlserializer": "^5.0.0",
+ "webidl-conversions": "^8.0.1",
+ "whatwg-mimetype": "^5.0.0",
+ "whatwg-url": "^17.1.0",
+ "xml-name-validator": "^5.0.0"
+ },
+ "engines": {
+ "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+ },
+ "peerDependencies": {
+ "canvas": "^3.2.3"
+ },
+ "peerDependenciesMeta": {
+ "canvas": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/lightningcss": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz",
+ "integrity": "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==",
+ "license": "MPL-2.0",
+ "dependencies": {
+ "detect-libc": "^2.0.3"
+ },
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ },
+ "optionalDependencies": {
+ "lightningcss-android-arm64": "1.33.0",
+ "lightningcss-darwin-arm64": "1.33.0",
+ "lightningcss-darwin-x64": "1.33.0",
+ "lightningcss-freebsd-x64": "1.33.0",
+ "lightningcss-linux-arm-gnueabihf": "1.33.0",
+ "lightningcss-linux-arm64-gnu": "1.33.0",
+ "lightningcss-linux-arm64-musl": "1.33.0",
+ "lightningcss-linux-x64-gnu": "1.33.0",
+ "lightningcss-linux-x64-musl": "1.33.0",
+ "lightningcss-win32-arm64-msvc": "1.33.0",
+ "lightningcss-win32-x64-msvc": "1.33.0"
+ }
+ },
+ "node_modules/lightningcss-android-arm64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.33.0.tgz",
+ "integrity": "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-darwin-arm64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.33.0.tgz",
+ "integrity": "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-darwin-x64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.33.0.tgz",
+ "integrity": "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-freebsd-x64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.33.0.tgz",
+ "integrity": "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-arm-gnueabihf": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.33.0.tgz",
+ "integrity": "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-arm64-gnu": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.33.0.tgz",
+ "integrity": "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-arm64-musl": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.33.0.tgz",
+ "integrity": "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-x64-gnu": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.33.0.tgz",
+ "integrity": "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-x64-musl": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.33.0.tgz",
+ "integrity": "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-win32-arm64-msvc": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.33.0.tgz",
+ "integrity": "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-win32-x64-msvc": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.33.0.tgz",
+ "integrity": "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lru-cache": {
+ "version": "11.5.2",
+ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.2.tgz",
+ "integrity": "sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": "20 || >=22"
+ }
+ },
+ "node_modules/lz-string": {
+ "version": "1.5.0",
+ "resolved": "https://registry.npmjs.org/lz-string/-/lz-string-1.5.0.tgz",
+ "integrity": "sha512-h5bgJWpxJNswbU7qCrV0tIKQCaS3blPDrqKWx+QxzuzL1zGUzij9XCWLrSLsJPu5t+eWA/ycetzYAO5IOMcWAQ==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true,
+ "bin": {
+ "lz-string": "bin/bin.js"
+ }
+ },
+ "node_modules/magic-string": {
+ "version": "1.4.1",
+ "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.1.tgz",
+ "integrity": "sha512-8lyCu36ErXR0J9uaGKlKQoiLZKmtI63YGLE8G2o9jyRPdr4X47LusSOwgOJOzcVtp81fTAAjxR7BwKz682Jhow==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/sourcemap-codec": "^1.6.0"
+ }
+ },
+ "node_modules/mdn-data": {
+ "version": "2.27.1",
+ "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz",
+ "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==",
+ "dev": true,
+ "license": "CC0-1.0"
+ },
+ "node_modules/meshoptimizer": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/meshoptimizer/-/meshoptimizer-1.1.1.tgz",
+ "integrity": "sha512-oRFNWJRDA/WTrVj7NWvqa5HqE1t9MYDj2VaWirQCzCCrAd2GHrqR/sQezCxiWATPNlKTcRaPRHPJwIRoPBAp5g==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/min-indent": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/min-indent/-/min-indent-1.0.1.tgz",
+ "integrity": "sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=4"
+ }
+ },
+ "node_modules/nanoid": {
+ "version": "3.3.19",
+ "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.19.tgz",
+ "integrity": "sha512-Y2tUNy4ouw6tq5oDSKeQYGOyhkUBhNOcGV/02KC+6kd9eDGqdZd++mjMiIDilrBYvjEnCYvVtsuHCuP+okSfug==",
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "bin": {
+ "nanoid": "bin/nanoid.cjs"
+ },
+ "engines": {
+ "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+ }
+ },
+ "node_modules/obug": {
+ "version": "2.2.1",
+ "resolved": "https://registry.npmjs.org/obug/-/obug-2.2.1.tgz",
+ "integrity": "sha512-XrsrhT5sybtKI6wakr2SPOlGZWWYbUXZ7a0jT8/QOeAPau+1X/bSegNe5YR75oJmEZQbKningirmGOEJCIk61Q==",
+ "dev": true,
+ "funding": [
+ "https://github.com/sponsors/sxzz",
+ "https://opencollective.com/debug"
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=12.20.0"
+ }
+ },
+ "node_modules/parse5": {
+ "version": "8.0.1",
+ "resolved": "https://registry.npmjs.org/parse5/-/parse5-8.0.1.tgz",
+ "integrity": "sha512-z1e/HMG90obSGeidlli3hj7cbocou0/wa5HacvI3ASx34PecNjNQeaHNo5WIZpWofN9kgkqV1q5YvXe3F0FoPw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "entities": "^8.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/inikulin/parse5?sponsor=1"
+ }
+ },
+ "node_modules/picocolors": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+ "license": "ISC"
+ },
+ "node_modules/picomatch": {
+ "version": "4.0.7",
+ "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
+ "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/jonschlinkert"
+ }
+ },
+ "node_modules/postcss": {
+ "version": "8.5.28",
+ "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.28.tgz",
+ "integrity": "sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==",
+ "funding": [
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/postcss/"
+ },
+ {
+ "type": "tidelift",
+ "url": "https://tidelift.com/funding/github/npm/postcss"
+ },
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "nanoid": "^3.3.18",
+ "picocolors": "^1.1.1",
+ "source-map-js": "^1.2.1"
+ },
+ "engines": {
+ "node": "^10 || ^12 || >=14"
+ }
+ },
+ "node_modules/pretty-format": {
+ "version": "27.5.1",
+ "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-27.5.1.tgz",
+ "integrity": "sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true,
+ "dependencies": {
+ "ansi-regex": "^5.0.1",
+ "ansi-styles": "^5.0.0",
+ "react-is": "^17.0.1"
+ },
+ "engines": {
+ "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0"
+ }
+ },
+ "node_modules/punycode": {
+ "version": "2.3.1",
+ "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+ "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/react": {
+ "version": "19.3.0",
+ "resolved": "https://registry.npmjs.org/react/-/react-19.3.0.tgz",
+ "integrity": "sha512-E8LUcbtBWt20bbl2YoHfx4ZDBdxVTfOKtCZn9cDSJ4l6/nuoApcpIBcj47t2wZoVX8g2ZHuMHbiShgCR1T5Sog==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/react-dom": {
+ "version": "19.3.0",
+ "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.3.0.tgz",
+ "integrity": "sha512-JDk8dgif51OjFoDE70+OT9ICyYr+69HlmihNwp1+Nsfbna3t5sIiCa9ZJktDmQ4/1b/rn26hIAR2uYXDMr5r0Q==",
+ "license": "MIT",
+ "dependencies": {
+ "scheduler": "^0.28.0"
+ },
+ "peerDependencies": {
+ "react": "^19.3.0"
+ }
+ },
+ "node_modules/react-is": {
+ "version": "17.0.2",
+ "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",
+ "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==",
+ "dev": true,
+ "license": "MIT",
+ "peer": true
+ },
+ "node_modules/redent": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/redent/-/redent-3.0.0.tgz",
+ "integrity": "sha512-6tDA8g98We0zd0GvVeMT9arEOnTw9qM03L9cJXaCjrip1OO764RDBLBfrB4cwzNGDj5OA5ioymC9GkizgWJDUg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "indent-string": "^4.0.0",
+ "strip-indent": "^3.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/require-from-string": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+ "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/rolldown": {
+ "version": "1.2.9",
+ "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.9.tgz",
+ "integrity": "sha512-hx/Pv0N1haXRb11qkfnK5MXB/iqr7i0yjWQqmO9uHqZpBgQSqzc8UsSnEpalsh+j1I8qQ2CkXAkJC8Br3dKSlg==",
+ "license": "MIT",
+ "dependencies": {
+ "@oxc-project/types": "=0.150.0",
+ "@rolldown/pluginutils": "^1.0.0"
+ },
+ "bin": {
+ "rolldown": "bin/cli.mjs"
+ },
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ },
+ "optionalDependencies": {
+ "@rolldown/binding-android-arm-eabi": "1.2.9",
+ "@rolldown/binding-android-arm64": "1.2.9",
+ "@rolldown/binding-darwin-arm64": "1.2.9",
+ "@rolldown/binding-darwin-x64": "1.2.9",
+ "@rolldown/binding-freebsd-x64": "1.2.9",
+ "@rolldown/binding-linux-arm-gnueabihf": "1.2.9",
+ "@rolldown/binding-linux-arm64-gnu": "1.2.9",
+ "@rolldown/binding-linux-arm64-musl": "1.2.9",
+ "@rolldown/binding-linux-ppc64-gnu": "1.2.9",
+ "@rolldown/binding-linux-s390x-gnu": "1.2.9",
+ "@rolldown/binding-linux-x64-gnu": "1.2.9",
+ "@rolldown/binding-linux-x64-musl": "1.2.9",
+ "@rolldown/binding-openharmony-arm64": "1.2.9",
+ "@rolldown/binding-win32-arm64-msvc": "1.2.9",
+ "@rolldown/binding-win32-x64-msvc": "1.2.9"
+ }
+ },
+ "node_modules/saxes": {
+ "version": "6.0.0",
+ "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz",
+ "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "xmlchars": "^2.2.0"
+ },
+ "engines": {
+ "node": ">=v12.22.7"
+ }
+ },
+ "node_modules/scheduler": {
+ "version": "0.28.0",
+ "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.28.0.tgz",
+ "integrity": "sha512-juorfCmIkIw8tT+p5BXSm6PJjQF/ycEYmKyzURCIt/RaZIhL+PulbQ9Yu2z1HdOJDdqDTlxA1+xKBmHXJsczAw==",
+ "license": "MIT"
+ },
+ "node_modules/siginfo": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
+ "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/source-map-js": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+ "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+ "license": "BSD-3-Clause",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/stackback": {
+ "version": "0.0.2",
+ "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
+ "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/std-env": {
+ "version": "4.2.0",
+ "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.2.0.tgz",
+ "integrity": "sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/strip-indent": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-3.0.0.tgz",
+ "integrity": "sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "min-indent": "^1.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/symbol-tree": {
+ "version": "3.2.4",
+ "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
+ "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/three": {
+ "version": "0.186.0",
+ "resolved": "https://registry.npmjs.org/three/-/three-0.186.0.tgz",
+ "integrity": "sha512-cr/fIM2ddMSVbYVgkfD4jLJv7Fh/8ZTjvo+7gQeSVGUZHxpx9FDwoL5iC7hUz/LiRA8wMbqfnb90xKfm1/HHkQ==",
+ "license": "MIT"
+ },
+ "node_modules/tinybench": {
+ "version": "6.1.4",
+ "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-6.1.4.tgz",
+ "integrity": "sha512-9APumHG7r4yOk4X4WlkmE71aZcv1gvin1czO3OQ1U9iJcFA5Ja/ygyb0vPOVHTthFozUYs8CLoLUlM8grb2lTQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=20.0.0"
+ }
+ },
+ "node_modules/tinyexec": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.3.0.tgz",
+ "integrity": "sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/tinyglobby": {
+ "version": "0.2.17",
+ "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+ "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+ "license": "MIT",
+ "dependencies": {
+ "fdir": "^6.5.0",
+ "picomatch": "^4.0.4"
+ },
+ "engines": {
+ "node": ">=12.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/SuperchupuDev"
+ }
+ },
+ "node_modules/tldts": {
+ "version": "7.4.13",
+ "resolved": "https://registry.npmjs.org/tldts/-/tldts-7.4.13.tgz",
+ "integrity": "sha512-iHtaIWWIbMDkCeJdTBzZFGgbluE5J+oHlb2g7+oAz1S1gpuVpabRZdQyd471Vl8UUkcz2vXSL8xZH2kyCe8tfA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "tldts-core": "^7.4.13"
+ },
+ "bin": {
+ "tldts": "bin/cli.js"
+ }
+ },
+ "node_modules/tldts-core": {
+ "version": "7.4.13",
+ "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-7.4.13.tgz",
+ "integrity": "sha512-mbYsrih5FRtGxs3Usvl/PqwJsNpp+jsmrdFviiK02teHDG0/HebBG/pqCylje3kzgXYzuLoHJF/0mz9W53t8Xg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/tough-cookie": {
+ "version": "6.0.2",
+ "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-6.0.2.tgz",
+ "integrity": "sha512-exgYmnmL/sJpR3upZfXG5PoatXQii55xAiXGXzY+sROLZ/Y+SLcp9PgJNI9Vz37HpQ74WvDcLT8eqm+kV3FzrA==",
+ "dev": true,
+ "license": "BSD-3-Clause",
+ "dependencies": {
+ "tldts": "^7.0.5"
+ },
+ "engines": {
+ "node": ">=16"
+ }
+ },
+ "node_modules/tr46": {
+ "version": "6.0.0",
+ "resolved": "https://registry.npmjs.org/tr46/-/tr46-6.0.0.tgz",
+ "integrity": "sha512-bLVMLPtstlZ4iMQHpFHTR7GAGj2jxi8Dg0s2h2MafAE4uSWF98FC/3MomU51iQAMf8/qDUbKWf5GxuvvVcXEhw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "punycode": "^2.3.1"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/typescript": {
+ "version": "7.0.2",
+ "resolved": "https://registry.npmjs.org/typescript/-/typescript-7.0.2.tgz",
+ "integrity": "sha512-8FYau96o3NKOhbjKi/qNvG/W5jhzxkbdm5sj9AbZ/5T5sWqn3hJgLfGx27sRKZWTvyzCP8dLRBTf5tBTSRVUNA==",
+ "license": "Apache-2.0",
+ "bin": {
+ "tsc": "bin/tsc"
+ },
+ "engines": {
+ "node": ">=16.20.0"
+ },
+ "optionalDependencies": {
+ "@typescript/typescript-aix-ppc64": "7.0.2",
+ "@typescript/typescript-darwin-arm64": "7.0.2",
+ "@typescript/typescript-darwin-x64": "7.0.2",
+ "@typescript/typescript-freebsd-arm64": "7.0.2",
+ "@typescript/typescript-freebsd-x64": "7.0.2",
+ "@typescript/typescript-linux-arm": "7.0.2",
+ "@typescript/typescript-linux-arm64": "7.0.2",
+ "@typescript/typescript-linux-loong64": "7.0.2",
+ "@typescript/typescript-linux-mips64el": "7.0.2",
+ "@typescript/typescript-linux-ppc64": "7.0.2",
+ "@typescript/typescript-linux-riscv64": "7.0.2",
+ "@typescript/typescript-linux-s390x": "7.0.2",
+ "@typescript/typescript-linux-x64": "7.0.2",
+ "@typescript/typescript-netbsd-arm64": "7.0.2",
+ "@typescript/typescript-netbsd-x64": "7.0.2",
+ "@typescript/typescript-openbsd-arm64": "7.0.2",
+ "@typescript/typescript-openbsd-x64": "7.0.2",
+ "@typescript/typescript-sunos-x64": "7.0.2",
+ "@typescript/typescript-win32-arm64": "7.0.2",
+ "@typescript/typescript-win32-x64": "7.0.2"
+ }
+ },
+ "node_modules/undici": {
+ "version": "8.10.2",
+ "resolved": "https://registry.npmjs.org/undici/-/undici-8.10.2.tgz",
+ "integrity": "sha512-/y4/bH9YNU5hi9NIrpOuvGXFcxrj3CMrV+/AYpowAYTpHn8gX/XPFjNy766FPoYY0miQhdW977JFWKGNhBdwyQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=22.19.0"
+ }
+ },
+ "node_modules/vite": {
+ "version": "8.3.0",
+ "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.0.tgz",
+ "integrity": "sha512-lhZBVvEHefgE+HQZC9O7EBJgCU/nVzFNl7vkS4RE0APtWLP02/8QVIkQtzBxPquh7lq5/78NHipTj7ODQ6XuyQ==",
+ "license": "MIT",
+ "dependencies": {
+ "lightningcss": "^1.33.0",
+ "picomatch": "^4.0.7",
+ "postcss": "^8.5.28",
+ "rolldown": "~1.2.6",
+ "tinyglobby": "^0.2.17"
+ },
+ "bin": {
+ "vite": "bin/vite.js"
+ },
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ },
+ "funding": {
+ "url": "https://github.com/vitejs/vite?sponsor=1"
+ },
+ "optionalDependencies": {
+ "fsevents": "~2.3.3"
+ },
+ "peerDependencies": {
+ "@types/node": "^20.19.0 || >=22.12.0",
+ "@vitejs/devtools": "^0.7.1",
+ "esbuild": "^0.27.0 || ^0.28.0",
+ "jiti": ">=1.21.0",
+ "less": "^4.0.0",
+ "sass": "^1.70.0",
+ "sass-embedded": "^1.70.0",
+ "stylus": ">=0.54.8",
+ "sugarss": "^5.0.0",
+ "terser": "^5.16.0",
+ "tsx": "^4.8.1",
+ "yaml": "^2.4.2"
+ },
+ "peerDependenciesMeta": {
+ "@types/node": {
+ "optional": true
+ },
+ "@vitejs/devtools": {
+ "optional": true
+ },
+ "esbuild": {
+ "optional": true
+ },
+ "jiti": {
+ "optional": true
+ },
+ "less": {
+ "optional": true
+ },
+ "sass": {
+ "optional": true
+ },
+ "sass-embedded": {
+ "optional": true
+ },
+ "stylus": {
+ "optional": true
+ },
+ "sugarss": {
+ "optional": true
+ },
+ "terser": {
+ "optional": true
+ },
+ "tsx": {
+ "optional": true
+ },
+ "yaml": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/vitest": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/vitest/-/vitest-5.0.1.tgz",
+ "integrity": "sha512-iA95lQbKEkvrtTkdAgnWbXfbipWiiWe/hDl2P5tMi6WFwD76G0NxXAGp/M9EOcYupeGJRr6wppMc7CoA41TQjg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/chai": "^5.2.2",
+ "@vitest/mocker": "5.0.1",
+ "chai": "^6.2.2",
+ "es-module-lexer": "^2.3.2",
+ "expect-type": "^1.4.0",
+ "magic-string": "^1.2.3",
+ "obug": "^2.1.4",
+ "picomatch": "^4.0.7",
+ "std-env": "^4.2.0",
+ "tinybench": "6.1.4",
+ "tinyexec": "1.3.0",
+ "tinyglobby": "^0.2.17",
+ "why-is-node-running": "^2.3.0"
+ },
+ "bin": {
+ "vitest": "vitest.mjs"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.0.0 || >=26.0.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/vitest"
+ },
+ "peerDependencies": {
+ "@edge-runtime/vm": "*",
+ "@opentelemetry/api": "^1.9.0",
+ "@types/node": "^22.0.0 || >=24.0.0",
+ "@vitest/browser-playwright": "5.0.1",
+ "@vitest/browser-preview": "5.0.1",
+ "@vitest/browser-webdriverio": "^5.0.0-beta.5 || >=5.0.0",
+ "@vitest/coverage-istanbul": "5.0.1",
+ "@vitest/coverage-v8": "5.0.1",
+ "@vitest/ui": "5.0.1",
+ "happy-dom": "*",
+ "jsdom": "*",
+ "vite": "^6.4.0 || ^7.0.0 || ^8.0.0"
+ },
+ "peerDependenciesMeta": {
+ "@edge-runtime/vm": {
+ "optional": true
+ },
+ "@opentelemetry/api": {
+ "optional": true
+ },
+ "@types/node": {
+ "optional": true
+ },
+ "@vitest/browser-playwright": {
+ "optional": true
+ },
+ "@vitest/browser-preview": {
+ "optional": true
+ },
+ "@vitest/browser-webdriverio": {
+ "optional": true
+ },
+ "@vitest/coverage-istanbul": {
+ "optional": true
+ },
+ "@vitest/coverage-v8": {
+ "optional": true
+ },
+ "@vitest/ui": {
+ "optional": true
+ },
+ "happy-dom": {
+ "optional": true
+ },
+ "jsdom": {
+ "optional": true
+ },
+ "vite": {
+ "optional": false
+ }
+ }
+ },
+ "node_modules/w3c-xmlserializer": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",
+ "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "xml-name-validator": "^5.0.0"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/webidl-conversions": {
+ "version": "8.0.1",
+ "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-8.0.1.tgz",
+ "integrity": "sha512-BMhLD/Sw+GbJC21C/UgyaZX41nPt8bUTg+jWyDeg7e7YN4xOM05YPSIXceACnXVtqyEw/LMClUQMtMZ+PGGpqQ==",
+ "dev": true,
+ "license": "BSD-2-Clause",
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/whatwg-mimetype": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-5.0.0.tgz",
+ "integrity": "sha512-sXcNcHOC51uPGF0P/D4NVtrkjSU2fNsm9iog4ZvZJsL3rjoDAzXZhkm2MWt1y+PUdggKAYVoMAIYcs78wJ51Cw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/whatwg-url": {
+ "version": "17.1.1",
+ "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-17.1.1.tgz",
+ "integrity": "sha512-ohjk1mdUebJVadRt3bAhQhx8lSnISq+GDttK79LFl8EHQkAPvzwctoasC4hs8tBt6kLAncBWWyq1N52qEfKvDw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@exodus/bytes": "^1.15.1",
+ "tr46": "^6.0.0",
+ "webidl-conversions": "^8.0.1"
+ },
+ "engines": {
+ "node": "^22.14.0 || >=24.0.0"
+ }
+ },
+ "node_modules/why-is-node-running": {
+ "version": "2.3.0",
+ "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz",
+ "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "siginfo": "^2.0.0",
+ "stackback": "0.0.2"
+ },
+ "bin": {
+ "why-is-node-running": "cli.js"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/xml-name-validator": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz",
+ "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/xmlchars": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz",
+ "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==",
+ "dev": true,
+ "license": "MIT"
+ }
+ }
+}
diff --git a/demos/Aetherion.Helios/package.json b/demos/Aetherion.Helios/package.json
new file mode 100644
index 00000000..421bb591
--- /dev/null
+++ b/demos/Aetherion.Helios/package.json
@@ -0,0 +1,32 @@
+{
+ "name": "@aetheris/helios",
+ "version": "0.1.0",
+ "private": true,
+ "type": "module",
+ "scripts": {
+ "sdk:install": "node scripts/install-local-sdk.mjs",
+ "dev": "vite",
+ "build": "tsc -b && vite build",
+ "test": "vitest run",
+ "test:watch": "vitest",
+ "preview": "vite preview"
+ },
+ "dependencies": {
+ "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz",
+ "@vitejs/plugin-react": "latest",
+ "vite": "latest",
+ "typescript": "latest",
+ "react": "latest",
+ "react-dom": "latest",
+ "three": "latest"
+ },
+ "devDependencies": {
+ "@testing-library/jest-dom": "latest",
+ "@testing-library/react": "latest",
+ "@types/react": "latest",
+ "@types/react-dom": "latest",
+ "@types/three": "latest",
+ "jsdom": "latest",
+ "vitest": "latest"
+ }
+}
diff --git a/demos/Aetherion.Helios/scripts/install-local-sdk.mjs b/demos/Aetherion.Helios/scripts/install-local-sdk.mjs
new file mode 100644
index 00000000..ba1997c9
--- /dev/null
+++ b/demos/Aetherion.Helios/scripts/install-local-sdk.mjs
@@ -0,0 +1,20 @@
+import { mkdir, readdir } from 'node:fs/promises';
+import { spawnSync } from 'node:child_process';
+import { resolve } from 'node:path';
+
+const helios = resolve(import.meta.dirname, '..');
+const repo = resolve(helios, '..', '..');
+const sdk = resolve(repo, 'Aetheris.Web.Runtime', 'sdk');
+const output = resolve(repo, 'artifacts', 'local', 'helios-sdk');
+await mkdir(output, { recursive: true });
+
+run('npm', ['run', 'build'], sdk);
+run('npm', ['pack', '--pack-destination', output], sdk);
+const packages = (await readdir(output)).filter(name => name.endsWith('.tgz')).sort();
+if (!packages.length) throw new Error('The local @aetheris/cad pack did not produce a tarball.');
+run('npm', ['install'], helios);
+
+function run(command, args, cwd) {
+ const result = spawnSync(command, args, { cwd, stdio: 'inherit', shell: process.platform === 'win32' });
+ if (result.status !== 0) process.exit(result.status ?? 1);
+}
diff --git a/demos/Aetherion.Helios/src/app/HeliosApp.test.tsx b/demos/Aetherion.Helios/src/app/HeliosApp.test.tsx
new file mode 100644
index 00000000..00f1624c
--- /dev/null
+++ b/demos/Aetherion.Helios/src/app/HeliosApp.test.tsx
@@ -0,0 +1,24 @@
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { fakeModel, ok } from '../test/fakes';
+
+const { runtimeMock } = vi.hoisted(() => ({ runtimeMock: { info: { packageVersion: '2.0.0-preview.3' }, initialize: vi.fn(), open: vi.fn(), setSource: vi.fn(), setProperty: vi.fn(), rebuild: vi.fn(), exportSTEP: vi.fn(), dispose: vi.fn(), session: vi.fn() } }));
+vi.mock('../sdk/CadRuntime', () => ({ WebSdkCadRuntime: class { constructor() { return runtimeMock; } } }));
+vi.mock('../viewport/Viewport', () => ({ Viewport: ({ onSelect }: { onSelect(id: string, face: string): void }) => <button data-testid="viewport" onClick={() => onSelect('box:plate', 'face:top')}>Viewport geometry</button> }));
+
+import { HeliosApp } from './HeliosApp';
+const model = fakeModel();
+
+describe('Helios shell', () => {
+ beforeEach(() => { localStorage.clear(); vi.clearAllMocks(); vi.stubGlobal('URL', { ...URL, createObjectURL: vi.fn(() => 'blob:helios-test'), revokeObjectURL: vi.fn() }); vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(() => undefined); runtimeMock.open.mockResolvedValue({ model, diagnostics: [] }); runtimeMock.setSource.mockResolvedValue(ok()); runtimeMock.setProperty.mockResolvedValue(ok()); runtimeMock.rebuild.mockResolvedValue(ok()); runtimeMock.exportSTEP.mockResolvedValue(new Uint8Array([1])); runtimeMock.session.mockReturnValue(model); });
+ it('initializes with the bracket through the runtime boundary', async () => { render(<HeliosApp />); await waitFor(() => expect(runtimeMock.open).toHaveBeenCalled()); expect(screen.getByText('HELIOS')).toBeVisible(); expect(screen.getAllByText('WebBracket').length).toBeGreaterThan(0); });
+ it('ships Mars as the default theme', async () => { render(<HeliosApp />); await waitFor(() => expect(document.documentElement.dataset.theme).toBe('mars')); expect(screen.getByLabelText('Theme')).toHaveValue('mars'); });
+ it('switches and persists Sirius', async () => { render(<HeliosApp />); fireEvent.change(screen.getByLabelText('Theme'), { target: { value: 'sirius' } }); await waitFor(() => expect(localStorage.getItem('helios-theme')).toBe('sirius')); });
+ it('synchronizes viewport selection to tree and inspector', async () => { render(<HeliosApp />); await waitFor(() => expect(runtimeMock.open).toHaveBeenCalled()); fireEvent.click(screen.getByTestId('viewport')); expect(screen.getByText('Plate', { selector: '.entity-hero strong' })).toBeVisible(); expect(screen.getByText(/face:top/)).toBeVisible(); });
+ it('synchronizes tree selection to the inspector', async () => { render(<HeliosApp />); await waitFor(() => expect(runtimeMock.open).toHaveBeenCalled()); fireEvent.click(screen.getByText('CenterMount')); expect(screen.getByText('hole:center')).toBeVisible(); });
+ it('sends source replacement through the public session', async () => { render(<HeliosApp />); const source = await screen.findByLabelText('Firmament source'); fireEvent.change(source, { target: { value: 'Model Changed {}' } }); fireEvent.click(screen.getByText('↻ Rebuild')); await waitFor(() => expect(runtimeMock.setSource).toHaveBeenCalledWith('Model Changed {}', 'editable-bracket.firmament')); });
+ it('opens the assembly fixture', async () => { render(<HeliosApp />); await waitFor(() => expect(runtimeMock.open).toHaveBeenCalled()); fireEvent.click(screen.getByText('ASSEMBLY')); await waitFor(() => expect(runtimeMock.open).toHaveBeenLastCalledWith(expect.stringContaining('Assembly WebBlockPair'), 'shared-block-assembly.firmament')); });
+ it('authors a canonical Hole in source rather than geometry', async () => { render(<HeliosApp />); await waitFor(() => expect(runtimeMock.open).toHaveBeenCalled()); fireEvent.click(screen.getByRole('button', { name: /Hole/ })); expect((screen.getByLabelText('Firmament source') as HTMLTextAreaElement).value).toContain('Hole<Shaft> HeliosHole1'); expect(runtimeMock.setSource).not.toHaveBeenCalled(); });
+ it('keeps sheet metal explicitly unavailable', async () => { render(<HeliosApp />); await waitFor(() => expect(runtimeMock.open).toHaveBeenCalled()); expect(screen.getByText('SHEET METAL')).toBeDisabled(); });
+ it('exports STEP bytes through the public runtime boundary', async () => { render(<HeliosApp />); await waitFor(() => expect(runtimeMock.open).toHaveBeenCalled()); fireEvent.click(screen.getByRole('button', { name: /Export STEP/ })); await waitFor(() => expect(runtimeMock.exportSTEP).toHaveBeenCalledOnce()); expect(URL.createObjectURL).toHaveBeenCalled(); });
+});
diff --git a/demos/Aetherion.Helios/src/app/HeliosApp.tsx b/demos/Aetherion.Helios/src/app/HeliosApp.tsx
new file mode 100644
index 00000000..edee7e04
--- /dev/null
+++ b/demos/Aetherion.Helios/src/app/HeliosApp.tsx
@@ -0,0 +1,131 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import type { Diagnostic, EditableProperty, ModelSession, UnitValue } from '@aetheris/cad';
+import { WebSdkCadRuntime } from '../sdk/CadRuntime';
+import { assemblySource, bracketSource, emptyModelSource } from '../sdk/samples';
+import { appendCenteredHole } from '../commands/sourceAuthoring';
+import { ModelTree } from '../model-tree/ModelTree';
+import { Inspector } from '../inspector/Inspector';
+import { SourcePanel } from '../source/SourcePanel';
+import { Viewport } from '../viewport/Viewport';
+import type { BusyState, DisplayMode, ThemeName, ViewMode } from './types';
+
+const runtime = new WebSdkCadRuntime();
+
+export function HeliosApp() {
+ const [model, setModel] = useState<ModelSession | null>(null);
+ const [source, setSource] = useState(bracketSource);
+ const [sourceName, setSourceName] = useState('editable-bracket.firmament');
+ const [diagnostics, setDiagnostics] = useState<readonly Diagnostic[]>([]);
+ const [selectedEntityId, setSelectedEntityId] = useState<string | null>(null);
+ const [selectedFaceId, setSelectedFaceId] = useState<string | null>(null);
+ const [busy, setBusy] = useState<BusyState>('Initializing Aetheris');
+ const [theme, setTheme] = useState<ThemeName>(() => localStorage.getItem('helios-theme') === 'sirius' ? 'sirius' : 'mars');
+ const [displayMode, setDisplayMode] = useState<DisplayMode>('edges');
+ const [viewMode, setViewMode] = useState<ViewMode>('perspective');
+ const [viewCommand, setViewCommand] = useState('fit');
+ const [runtimeName, setRuntimeName] = useState('WASM');
+ const [lastTiming, setLastTiming] = useState<{ label: string; milliseconds: number } | null>(null);
+ const [history, setHistory] = useState([bracketSource]);
+ const [historyIndex, setHistoryIndex] = useState(0);
+ const fileInput = useRef<HTMLInputElement>(null);
+
+ const open = useCallback(async (nextSource: string, nextName: string) => {
+ const started = performance.now();
+ setBusy(model ? 'Compiling' : 'Initializing Aetheris');
+ try {
+ const result = await runtime.open(nextSource, nextName);
+ setRuntimeName(runtime.info ? `WASM · ${runtime.info.packageVersion}` : 'WASM');
+ setModel(result.model); setDiagnostics(result.diagnostics); setSource(nextSource); setSourceName(nextName);
+ setSelectedEntityId(result.model?.tree.rootId ?? null); setSelectedFaceId(null); setViewCommand(`fit-${Date.now()}`);
+ } catch (error) {
+ setDiagnostics([toDiagnostic(error, 'HELIOS-INIT')]);
+ } finally { setLastTiming({ label: model ? 'COMPILE' : 'INIT+COMPILE', milliseconds: performance.now() - started }); setBusy(null); }
+ }, [model]);
+
+ useEffect(() => { void open(bracketSource, 'editable-bracket.firmament'); return () => { void runtime.dispose(); }; }, []);
+ useEffect(() => { document.documentElement.dataset.theme = theme; localStorage.setItem('helios-theme', theme); }, [theme]);
+ useEffect(() => {
+ const onKey = (event: KeyboardEvent) => {
+ if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') { event.preventDefault(); downloadText(source, sourceName); }
+ if (event.key.toLowerCase() === 'f' && !isTyping(event.target)) setViewCommand(`fit-${Date.now()}`);
+ };
+ addEventListener('keydown', onKey); return () => removeEventListener('keydown', onKey);
+ }, [source, sourceName]);
+
+ const select = (entityId: string | null, faceId: string | null = null) => { setSelectedEntityId(entityId); setSelectedFaceId(faceId); };
+ const rebuildSource = async () => {
+ if (!model) return;
+ const started = performance.now();
+ setBusy('Rebuilding');
+ try {
+ const result = await runtime.setSource(source, sourceName);
+ setDiagnostics(result.diagnostics); setModel(snapshotSession(runtime.session()));
+ if (result.success) { commitHistory(source); setSelectedEntityId(runtime.session()?.tree.rootId ?? null); }
+ } catch (error) { setDiagnostics([toDiagnostic(error, 'HELIOS-REBUILD')]); }
+ finally { setLastTiming({ label: 'SOURCE REBUILD', milliseconds: performance.now() - started }); setBusy(null); }
+ };
+ const applyProperty = async (property: EditableProperty, value: UnitValue) => {
+ const started = performance.now();
+ setBusy('Rebuilding');
+ try {
+ const result = await runtime.setProperty(property.id, value);
+ setDiagnostics(result.diagnostics); setModel(snapshotSession(runtime.session()));
+ return result.success;
+ } catch (error) { setDiagnostics([toDiagnostic(error, 'HELIOS-PROPERTY')]); return false; }
+ finally { setLastTiming({ label: 'PROPERTY REBUILD', milliseconds: performance.now() - started }); setBusy(null); }
+ };
+ const exportStep = async () => {
+ setBusy('Exporting');
+ try { const bytes = await runtime.exportSTEP(); downloadBlob(new Blob([Uint8Array.from(bytes).buffer], { type: 'model/step' }), `${stripExtension(sourceName)}.step`); }
+ catch (error) { setDiagnostics([toDiagnostic(error, 'HELIOS-EXPORT')]); }
+ finally { setBusy(null); }
+ };
+ const commitHistory = (value: string) => { const next = [...history.slice(0, historyIndex + 1), value]; setHistory(next); setHistoryIndex(next.length - 1); };
+ const navigateHistory = (delta: number) => { const index = Math.max(0, Math.min(history.length - 1, historyIndex + delta)); setHistoryIndex(index); setSource(history[index]); };
+ const loadSample = (kind: 'part' | 'assembly' | 'new') => {
+ const value = kind === 'assembly' ? assemblySource : kind === 'new' ? emptyModelSource : bracketSource;
+ const name = kind === 'assembly' ? 'shared-block-assembly.firmament' : kind === 'new' ? 'untitled.firmament' : 'editable-bracket.firmament';
+ setHistory([value]); setHistoryIndex(0); void open(value, name);
+ };
+ const addHole = () => {
+ try { const target = model?.tree.nodes.find(node => ['Box', 'Part'].includes(node.kind))?.name ?? 'Body'; setSource(appendCenteredHole(source, target)); }
+ catch (error) { setDiagnostics([toDiagnostic(error, 'HELIOS-AUTHOR')]); }
+ };
+
+ return <div className="helios-app">
+ <header className="topbar">
+ <div className="brand"><span className="brand-mark">H</span><div><strong>HELIOS</strong><small>by Aetheris</small></div></div>
+ <nav className="workspace-tabs" aria-label="Workspace"><button className="active">SOLID</button><button>SURFACE</button><button disabled title="Unavailable in browser/WASM X1">SHEET METAL</button><button onClick={() => loadSample('assembly')}>ASSEMBLY</button></nav>
+ <div className="toolbar">
+ <button onClick={() => loadSample('new')} title="New model">+ <span>New</span></button>
+ <button onClick={() => fileInput.current?.click()}>⌑ <span>Open</span></button>
+ <button onClick={addHole}>⊙ <span>Hole</span></button>
+ <button onClick={() => void rebuildSource()}>↻ <span>Rebuild</span></button>
+ <button className="accent-button" onClick={() => void exportStep()}>⇩ <span>Export STEP</span></button>
+ </div>
+ <div className="top-actions"><button onClick={() => navigateHistory(-1)} disabled={historyIndex === 0} title="Undo">↶</button><button onClick={() => navigateHistory(1)} disabled={historyIndex === history.length - 1} title="Redo">↷</button><select aria-label="Theme" value={theme} onChange={event => setTheme(event.target.value as ThemeName)}><option value="mars">Mars</option><option value="sirius">Sirius</option></select></div>
+ <input ref={fileInput} hidden type="file" accept=".firmament,.txt" onChange={async event => { const file = event.target.files?.[0]; if (file) { const value = await file.text(); setHistory([value]); setHistoryIndex(0); void open(value, file.name); } }} />
+ </header>
+ <main className="workspace">
+ <ModelTree tree={model?.tree ?? null} selectedId={selectedEntityId} onSelect={id => select(id)} />
+ <div className="center-stack">
+ <div className="viewport-toolbar">
+ <div><button onClick={() => setViewCommand(`front-${Date.now()}`)}>FRONT</button><button onClick={() => setViewCommand(`top-${Date.now()}`)}>TOP</button><button onClick={() => setViewCommand(`right-${Date.now()}`)}>RIGHT</button><button onClick={() => setViewCommand(`iso-${Date.now()}`)}>ISO</button><button onClick={() => setViewCommand(`fit-${Date.now()}`)}>FIT</button><button onClick={() => setViewCommand(`fitselection-${Date.now()}`)}>FIT SEL</button></div>
+ <div><select aria-label="Display mode" value={displayMode} onChange={event => setDisplayMode(event.target.value as DisplayMode)}><option value="shaded">Shaded</option><option value="edges">Shaded with edges</option><option value="wireframe">Wireframe</option></select><button onClick={() => setViewMode(value => value === 'perspective' ? 'orthographic' : 'perspective')}>{viewMode === 'perspective' ? 'PERSP' : 'ORTHO'}</button></div>
+ </div>
+ <Viewport model={model} selectedEntityId={selectedEntityId} theme={theme} displayMode={displayMode} viewMode={viewMode} viewCommand={viewCommand} onSelect={select} />
+ <SourcePanel source={source} diagnostics={diagnostics} onSourceChange={setSource} onRebuild={() => void rebuildSource()} onDiagnosticClick={diagnostic => { if (diagnostic.source) setSelectedEntityId(null); }} />
+ </div>
+ <Inspector model={model} entityId={selectedEntityId} diagnostics={diagnostics} onApply={applyProperty} />
+ </main>
+ <footer className="statusbar"><span className="status-ready"><i />{busy ?? (model ? 'READY' : 'NO MODEL')}</span><span>{runtimeName}</span><span>REV {model?.revision ?? '—'}</span><span>{model?.mesh.definitions.length ?? 0} DEFS · {model?.mesh.occurrences.length ?? 0} OCC</span><span className={diagnostics.length ? 'has-diagnostics' : ''}>{diagnostics.length ? `⚠ ${diagnostics.length}` : '✓ 0'} DIAGNOSTICS</span>{lastTiming && <span>{lastTiming.label} {lastTiming.milliseconds.toFixed(0)}MS</span>}<span className="status-selection">{selectedEntityId ? `${model?.entity(selectedEntityId)?.name ?? selectedEntityId}${selectedFaceId ? ` · ${selectedFaceId}` : ''}` : 'NO SELECTION'}</span><span>{viewMode.toUpperCase()}</span><span>{theme.toUpperCase()}</span></footer>
+ {busy && <div className="busy-overlay" role="status"><span className="spinner" />{busy}</div>}
+ </div>;
+}
+
+function stripExtension(name: string) { return name.replace(/\.[^.]+$/, ''); }
+function snapshotSession(session: ModelSession | null) { return session ? Object.assign(Object.create(Object.getPrototypeOf(session)), session) as ModelSession : null; }
+function isTyping(target: EventTarget | null) { return target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement; }
+function toDiagnostic(error: unknown, code: string): Diagnostic { return { severity: 'error', code, message: error instanceof Error ? error.message : String(error) }; }
+function downloadText(value: string, name: string) { downloadBlob(new Blob([value], { type: 'text/plain' }), name); }
+function downloadBlob(blob: Blob, name: string) { const url = URL.createObjectURL(blob); const anchor = document.createElement('a'); anchor.href = url; anchor.download = name; anchor.click(); setTimeout(() => URL.revokeObjectURL(url), 0); }
diff --git a/demos/Aetherion.Helios/src/app/types.ts b/demos/Aetherion.Helios/src/app/types.ts
new file mode 100644
index 00000000..942bdbd6
--- /dev/null
+++ b/demos/Aetherion.Helios/src/app/types.ts
@@ -0,0 +1,15 @@
+import type { Diagnostic, ModelSession, RuntimeInfo } from '@aetheris/cad';
+
+export type ThemeName = 'mars' | 'sirius';
+export type BusyState = 'Initializing Aetheris' | 'Compiling' | 'Rebuilding' | 'Exporting' | null;
+export type ViewMode = 'perspective' | 'orthographic';
+export type DisplayMode = 'shaded' | 'edges' | 'wireframe';
+
+export interface EditorSnapshot {
+ model: ModelSession | null;
+ runtimeInfo: RuntimeInfo | null;
+ diagnostics: readonly Diagnostic[];
+ selectedEntityId: string | null;
+ selectedFaceId: string | null;
+ busy: BusyState;
+}
diff --git a/demos/Aetherion.Helios/src/commands/sourceAuthoring.test.ts b/demos/Aetherion.Helios/src/commands/sourceAuthoring.test.ts
new file mode 100644
index 00000000..0eb91de9
--- /dev/null
+++ b/demos/Aetherion.Helios/src/commands/sourceAuthoring.test.ts
@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest';
+import { appendCenteredHole } from './sourceAuthoring';
+
+describe('bounded source authoring', () => {
+ it('appends readable Firmament inside the model', () => {
+ const result = appendCenteredHole('Model A {\n Box Body { Size: [1mm,1mm,1mm] }\n}\n');
+ expect(result).toContain('Modify Body');
+ expect(result.indexOf('Modify Body')).toBeLessThan(result.lastIndexOf('}'));
+ });
+ it('uses the requested semantic target', () => expect(appendCenteredHole('Model A {}', 'Plate')).toContain('Modify Plate'));
+ it('allocates deterministic names', () => expect(appendCenteredHole('Model A { // HeliosHole1\n}')).toContain('HeliosHole2'));
+ it('rejects text without a model block', () => expect(() => appendCenteredHole('Units: mm')).toThrow(/model block/i));
+});
diff --git a/demos/Aetherion.Helios/src/commands/sourceAuthoring.ts b/demos/Aetherion.Helios/src/commands/sourceAuthoring.ts
new file mode 100644
index 00000000..1d3e1cd9
--- /dev/null
+++ b/demos/Aetherion.Helios/src/commands/sourceAuthoring.ts
@@ -0,0 +1,24 @@
+export function appendCenteredHole(source: string, target = 'Body'): string {
+ const closingBrace = findFinalModelBrace(source);
+ const suffix = source.slice(closingBrace);
+ const prefix = source.slice(0, closingBrace).trimEnd();
+ const name = nextHoleName(source);
+ return `${prefix}\n Modify ${target} {\n Hole<Shaft> ${name} { On: +Z Center: Point2(0mm, 0mm) Diameter: 6mm End: ThroughAll }\n }\n${suffix.startsWith('}') ? suffix : `}\n${suffix}`}`;
+}
+
+function findFinalModelBrace(source: string) {
+ let depth = 0;
+ let lastTopLevelClose = -1;
+ for (let i = 0; i < source.length; i++) {
+ if (source[i] === '{') depth++;
+ if (source[i] === '}' && --depth === 0) lastTopLevelClose = i;
+ }
+ if (lastTopLevelClose < 0) throw new Error('A top-level Firmament model block is required.');
+ return lastTopLevelClose;
+}
+
+function nextHoleName(source: string) {
+ let index = 1;
+ while (source.includes(`HeliosHole${index}`)) index++;
+ return `HeliosHole${index}`;
+}
diff --git a/demos/Aetherion.Helios/src/inspector/Inspector.test.tsx b/demos/Aetherion.Helios/src/inspector/Inspector.test.tsx
new file mode 100644
index 00000000..2efc0658
--- /dev/null
+++ b/demos/Aetherion.Helios/src/inspector/Inspector.test.tsx
@@ -0,0 +1,10 @@
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+import { Inspector } from './Inspector';
+import { fakeModel, plate, width } from '../test/fakes';
+
+describe('semantic inspector', () => {
+ it('shows identity and introspected property', () => { render(<Inspector model={fakeModel()} entityId={plate.id} diagnostics={[]} onApply={async () => true} />); expect(screen.getByText(plate.id)).toBeVisible(); expect(screen.getByLabelText('Width')).toHaveValue('50'); });
+ it('commits a unit-aware value only on Apply', async () => { const apply = vi.fn(async () => true); render(<Inspector model={fakeModel()} entityId={plate.id} diagnostics={[]} onApply={apply} />); fireEvent.change(screen.getByLabelText('Width'), { target: { value: '80' } }); expect(apply).not.toHaveBeenCalled(); fireEvent.click(screen.getByText('Apply')); await waitFor(() => expect(apply).toHaveBeenCalledWith(width, { value: 80, unit: 'mm' })); });
+ it('keeps invalid draft visibly correctable', async () => { render(<Inspector model={fakeModel()} entityId={plate.id} diagnostics={[]} onApply={async () => false} />); fireEvent.change(screen.getByLabelText('Width'), { target: { value: '-8' } }); fireEvent.click(screen.getByText('Apply')); expect(await screen.findByText(/last valid geometry remains/i)).toBeVisible(); expect(screen.getByLabelText('Width')).toHaveValue('-8'); });
+});
diff --git a/demos/Aetherion.Helios/src/inspector/Inspector.tsx b/demos/Aetherion.Helios/src/inspector/Inspector.tsx
new file mode 100644
index 00000000..20a54a6f
--- /dev/null
+++ b/demos/Aetherion.Helios/src/inspector/Inspector.tsx
@@ -0,0 +1,56 @@
+import { useEffect, useMemo, useState } from 'react';
+import type { Diagnostic, EditableProperty, ModelSession, UnitValue } from '@aetheris/cad';
+
+interface Props {
+ model: ModelSession | null;
+ entityId: string | null;
+ diagnostics: readonly Diagnostic[];
+ onApply(property: EditableProperty, value: UnitValue): Promise<boolean>;
+}
+
+export function Inspector({ model, entityId, diagnostics, onApply }: Props) {
+ const entity = entityId ? model?.entity(entityId) : undefined;
+ const occurrence = model?.mesh.occurrences.find(item => item.semanticEntityId === entityId || item.id === entityId);
+ const properties = useMemo(() => model?.properties.filter(property => property.ownerEntityId === entityId) ?? [], [entityId, model]);
+ return <section className="panel inspector" aria-label="Inspector">
+ <div className="panel-heading"><span>INSPECTOR</span><span className="panel-meta">{entity?.kind ?? '—'}</span></div>
+ <div className="inspector-scroll">
+ {entity ? <>
+ <div className="entity-hero"><span className="entity-glyph">{entity.kind === 'Hole' ? '⊙' : '◆'}</span><div><strong>{entity.name}</strong><small>{entity.kind}</small></div></div>
+ <dl className="identity-list"><dt>Semantic ID</dt><dd title={entity.id}>{entity.id}</dd>{entity.source && <><dt>Source</dt><dd>{entity.source.source}:{entity.source.line}</dd></>}</dl>
+ {occurrence && <><div className="section-label">OCCURRENCE</div><dl className="identity-list"><dt>Occurrence</dt><dd title={occurrence.id}>{occurrence.id}</dd><dt>Definition</dt><dd>{occurrence.definitionId ?? '—'}</dd><dt>Parent</dt><dd>{occurrence.parentId ?? 'Root'}</dd><dt>Translation</dt><dd>{formatTranslation(occurrence.transform)} mm</dd></dl></>}
+ <div className="section-label">PARAMETERS</div>
+ {properties.length ? properties.map(property => <PropertyEditor key={property.id} property={property} onApply={onApply} />) : <div className="empty-state compact">No editable properties on this entity.</div>}
+ <div className="section-label">RELATED DIAGNOSTICS</div>
+ <div className="empty-state compact">{diagnostics.length ? `${diagnostics.length} model diagnostic${diagnostics.length === 1 ? '' : 's'}` : 'No diagnostics'}</div>
+ </> : <div className="empty-state">Select model geometry or a tree item to inspect its semantic identity.</div>}
+ </div>
+ </section>;
+}
+
+function formatTranslation(transform: readonly number[]) { return `X ${formatNumber(transform[12])} · Y ${formatNumber(transform[13])} · Z ${formatNumber(transform[14])}`; }
+function formatNumber(value: number | undefined) { return Number(value ?? 0).toFixed(2); }
+
+function PropertyEditor({ property, onApply }: { property: EditableProperty; onApply(property: EditableProperty, value: UnitValue): Promise<boolean> }) {
+ const [draft, setDraft] = useState(String(property.value));
+ const [invalid, setInvalid] = useState(false);
+ const [applying, setApplying] = useState(false);
+ useEffect(() => { if (!invalid) setDraft(String(property.value)); }, [property.value, invalid]);
+ const commit = async () => {
+ const value = Number(draft);
+ if (!Number.isFinite(value)) { setInvalid(true); return; }
+ setApplying(true);
+ const success = await onApply(property, { value, unit: property.unit });
+ setInvalid(!success);
+ setApplying(false);
+ };
+ return <div className={`property-editor ${invalid ? 'invalid' : ''}`}>
+ <label htmlFor={property.id}>{property.name}</label>
+ <div className="property-control">
+ <input id={property.id} value={draft} disabled={!property.writable || applying} onChange={event => setDraft(event.target.value)} onKeyDown={event => { if (event.key === 'Enter') void commit(); }} />
+ <span>{property.unit}</span>
+ <button onClick={() => void commit()} disabled={!property.writable || applying}>Apply</button>
+ </div>
+ <small>{invalid ? 'Invalid value retained. Last valid geometry remains.' : `Source value at line ${property.source.line}; edits are effective overrides.`}</small>
+ </div>;
+}
diff --git a/demos/Aetherion.Helios/src/main.tsx b/demos/Aetherion.Helios/src/main.tsx
new file mode 100644
index 00000000..b95c8568
--- /dev/null
+++ b/demos/Aetherion.Helios/src/main.tsx
@@ -0,0 +1,7 @@
+import ReactDOM from 'react-dom/client';
+import { HeliosApp } from './app/HeliosApp';
+import './themes/helios.css';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+ <HeliosApp />
+);
diff --git a/demos/Aetherion.Helios/src/model-tree/ModelTree.test.tsx b/demos/Aetherion.Helios/src/model-tree/ModelTree.test.tsx
new file mode 100644
index 00000000..1ffd6cc2
--- /dev/null
+++ b/demos/Aetherion.Helios/src/model-tree/ModelTree.test.tsx
@@ -0,0 +1,30 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+import { ModelTree } from './ModelTree';
+import { hole, plate, root } from '../test/fakes';
+
+const tree = { rootId: root.id, nodes: [root, plate, hole] };
+describe('model tree', () => {
+ it('renders the SDK semantic hierarchy', () => { render(<ModelTree tree={tree} selectedId={null} onSelect={() => {}} />); expect(screen.getByText('WebBracket')).toBeVisible(); expect(screen.getByText('CenterMount')).toBeVisible(); });
+ it('routes selection by semantic id', () => { const select = vi.fn(); render(<ModelTree tree={tree} selectedId={null} onSelect={select} />); fireEvent.click(screen.getByText('Plate')); expect(select).toHaveBeenCalledWith(plate.id); });
+ it('derives broad semantic kind options from the public tree', () => {
+ render(<ModelTree tree={tree} selectedId={null} onSelect={() => {}} />);
+ expect(screen.getByLabelText('Filter model by kind')).toHaveTextContent('AllBoxHoleModel');
+ });
+ it('filters by semantic kind and keeps the matching ancestor path', () => {
+ render(<ModelTree tree={tree} selectedId={null} onSelect={() => {}} />);
+ fireEvent.change(screen.getByLabelText('Filter model by kind'), { target: { value: 'Hole' } });
+ expect(screen.getByText('WebBracket')).toBeVisible();
+ expect(screen.getByText('CenterMount')).toBeVisible();
+ expect(screen.queryByText('Plate')).not.toBeInTheDocument();
+ });
+ it('composes semantic kind and text filters and restores all kinds', () => {
+ render(<ModelTree tree={tree} selectedId={null} onSelect={() => {}} />);
+ fireEvent.change(screen.getByLabelText('Filter model by kind'), { target: { value: 'Hole' } });
+ fireEvent.change(screen.getByLabelText('Filter model'), { target: { value: 'plate' } });
+ expect(screen.queryByText('CenterMount')).not.toBeInTheDocument();
+ expect(screen.queryByText('Plate')).not.toBeInTheDocument();
+ fireEvent.change(screen.getByLabelText('Filter model by kind'), { target: { value: '' } });
+ expect(screen.getByText('Plate')).toBeVisible();
+ });
+});
diff --git a/demos/Aetherion.Helios/src/model-tree/ModelTree.tsx b/demos/Aetherion.Helios/src/model-tree/ModelTree.tsx
new file mode 100644
index 00000000..113639bc
--- /dev/null
+++ b/demos/Aetherion.Helios/src/model-tree/ModelTree.tsx
@@ -0,0 +1,71 @@
+import { useMemo, useState } from 'react';
+import type { ModelTree as SdkModelTree, ModelTreeNode } from '@aetheris/cad';
+
+interface Props {
+ tree: SdkModelTree | null;
+ selectedId: string | null;
+ onSelect(id: string): void;
+}
+
+export function ModelTree({ tree, selectedId, onSelect }: Props) {
+ const [query, setQuery] = useState('');
+ const [kind, setKind] = useState('');
+ const nodes = useMemo(() => new Map(tree?.nodes.map(node => [node.id, node]) ?? []), [tree]);
+ const kinds = useMemo(() => [...new Set(tree?.nodes.map(node => node.kind) ?? [])].sort((left, right) => left.localeCompare(right)), [tree]);
+ const selectedKind = kinds.includes(kind) ? kind : '';
+ const visible = useMemo(() => {
+ const normalized = query.trim().toLowerCase();
+ if (!normalized && !selectedKind) return null;
+
+ const matches = new Set(tree?.nodes
+ .filter(node => (!normalized || `${node.name} ${node.kind}`.toLowerCase().includes(normalized)) && (!selectedKind || node.kind === selectedKind))
+ .map(node => node.id));
+ for (const id of [...matches]) {
+ let parentId = nodes.get(id)?.parentId;
+ while (parentId) {
+ matches.add(parentId);
+ parentId = nodes.get(parentId)?.parentId;
+ }
+ }
+ return matches;
+ }, [nodes, query, selectedKind, tree]);
+
+ return <section className="panel model-browser" aria-label="Model browser">
+ <div className="panel-heading"><span>MODEL</span><span className="panel-meta">{tree?.nodes.length ?? 0}</span></div>
+ <div className="tree-filters">
+ <div className="tree-search"><span>⌕</span><input aria-label="Filter model" value={query} onChange={event => setQuery(event.target.value)} placeholder="Filter model" /></div>
+ <select aria-label="Filter model by kind" value={selectedKind} onChange={event => setKind(event.target.value)}>
+ <option value="">All</option>
+ {kinds.map(option => <option key={option} value={option}>{option}</option>)}
+ </select>
+ </div>
+ <div className="tree-scroll">
+ {tree ? <TreeNode node={nodes.get(tree.rootId)!} nodes={nodes} selectedId={selectedId} visible={visible} onSelect={onSelect} depth={0} /> : <div className="empty-state">No model loaded</div>}
+ </div>
+ </section>;
+}
+
+function TreeNode({ node, nodes, selectedId, visible, onSelect, depth }: { node: ModelTreeNode; nodes: Map<string, ModelTreeNode>; selectedId: string | null; visible: Set<string> | null; onSelect(id: string): void; depth: number }) {
+ const [open, setOpen] = useState(true);
+ if (!node) return null;
+ const children = node.children.map(id => nodes.get(id)).filter(Boolean) as ModelTreeNode[];
+ const matches = !visible || visible.has(node.id) || children.some(child => visible.has(child.id));
+ if (!matches) return null;
+ return <div className="tree-branch">
+ <div className={`tree-row ${selectedId === node.id ? 'selected' : ''}`} style={{ paddingLeft: 10 + depth * 14 }} onClick={() => onSelect(node.id)} data-entity-id={node.id}>
+ <button className="disclosure" aria-label={`${open ? 'Collapse' : 'Expand'} ${node.name}`} onClick={event => { event.stopPropagation(); setOpen(value => !value); }}>{children.length ? (open ? '⌄' : '›') : '·'}</button>
+ <span className={`kind-icon kind-${node.kind.toLowerCase()}`}>{kindGlyph(node.kind)}</span>
+ <span className="tree-name">{node.name}</span>
+ <span className="tree-kind">{node.kind}</span>
+ </div>
+ {open && children.map(child => <TreeNode key={child.id} node={child} nodes={nodes} selectedId={selectedId} visible={visible} onSelect={onSelect} depth={depth + 1} />)}
+ </div>;
+}
+
+function kindGlyph(kind: string) {
+ const normalized = kind.toLowerCase();
+ if (normalized.includes('assembly')) return '◇';
+ if (normalized.includes('hole')) return '⊙';
+ if (normalized.includes('model') || normalized.includes('part')) return '◆';
+ return '▧';
+}
diff --git a/demos/Aetherion.Helios/src/sdk/CadRuntime.ts b/demos/Aetherion.Helios/src/sdk/CadRuntime.ts
new file mode 100644
index 00000000..1cff4262
--- /dev/null
+++ b/demos/Aetherion.Helios/src/sdk/CadRuntime.ts
@@ -0,0 +1,53 @@
+import { Aetheris, type Diagnostic, type ModelSession, type RuntimeInfo, type UnitValue } from '@aetheris/cad';
+
+export interface OpenResult { model: ModelSession | null; diagnostics: readonly Diagnostic[] }
+
+export interface CadRuntime {
+ readonly info: RuntimeInfo | null;
+ initialize(): Promise<RuntimeInfo>;
+ open(source: string, sourceName: string): Promise<OpenResult>;
+ setSource(source: string, sourceName: string): ReturnType<ModelSession['setSource']>;
+ setProperty(id: string, value: UnitValue): ReturnType<ModelSession['setProperty']>;
+ rebuild(): ReturnType<ModelSession['rebuild']>;
+ exportSTEP(): Promise<Uint8Array>;
+ dispose(): Promise<void>;
+ session(): ModelSession | null;
+}
+
+export class WebSdkCadRuntime implements CadRuntime {
+ private cad: Aetheris | null = null;
+ private model: ModelSession | null = null;
+ info: RuntimeInfo | null = null;
+
+ async initialize() {
+ this.cad ??= await Aetheris.create();
+ this.info = await this.cad.info();
+ return this.info;
+ }
+
+ async open(source: string, sourceName: string) {
+ await this.initialize();
+ await this.model?.dispose();
+ const result = await this.cad!.compile(source, { sourceName });
+ this.model = result.model;
+ return result;
+ }
+
+ setSource(source: string, sourceName: string) { return this.requireModel().setSource(source, { sourceName }); }
+ setProperty(id: string, value: UnitValue) { return this.requireModel().setProperty(id, value); }
+ rebuild() { return this.requireModel().rebuild(); }
+ exportSTEP() { return this.requireModel().exportSTEP(); }
+ session() { return this.model; }
+
+ async dispose() {
+ await this.model?.dispose();
+ await this.cad?.dispose();
+ this.model = null;
+ this.cad = null;
+ }
+
+ private requireModel() {
+ if (!this.model) throw new Error('No Firmament model is open.');
+ return this.model;
+ }
+}
diff --git a/demos/Aetherion.Helios/src/sdk/samples.ts b/demos/Aetherion.Helios/src/sdk/samples.ts
new file mode 100644
index 00000000..f38ec508
--- /dev/null
+++ b/demos/Aetherion.Helios/src/sdk/samples.ts
@@ -0,0 +1,33 @@
+export const bracketSource = `Model WebBracket {
+ Units: mm
+ Box Plate { Size: [50mm, 40mm, 8mm] }
+ Modify Plate {
+ Hole<Shaft> CenterMount { On: +Z Center: Point2(0mm, 0mm) Diameter: 8mm End: ThroughAll }
+ }
+}
+`;
+
+export const assemblySource = `Units: mm
+
+Template < H: Length > Struct WebBlock {
+ Circle2 Circle { Center: [0mm,0mm] Radius: 4mm }
+ Profile Section { Loop Outer { Circle |> TraceLoop } }
+ Extrude Body { Profile: Section From: 0mm To: H }
+}
+
+Assembly WebBlockPair {
+ <Assembly WebBlockPair>
+ <Part Fixed = WebBlock<H: 10mm>></Part>
+ <Part Moving = WebBlock<H: 8mm>>
+ Placement ImportedOccurrence = [1,0,0,0, 0,1,0,0, 0,0,1,0, 20,0,0,1];
+ </Part>
+ </Assembly>
+ Anchor: WebBlockPair.Fixed;
+}
+`;
+
+export const emptyModelSource = `Model Untitled {
+ Units: mm
+ Box Body { Size: [40mm, 30mm, 8mm] }
+}
+`;
diff --git a/demos/Aetherion.Helios/src/source/SourcePanel.test.tsx b/demos/Aetherion.Helios/src/source/SourcePanel.test.tsx
new file mode 100644
index 00000000..64d7b2f7
--- /dev/null
+++ b/demos/Aetherion.Helios/src/source/SourcePanel.test.tsx
@@ -0,0 +1,10 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+import { SourcePanel } from './SourcePanel';
+
+describe('source and diagnostics', () => {
+ it('exposes authoritative source with line numbers', () => { render(<SourcePanel source={'Model A {\n}'} diagnostics={[]} onSourceChange={() => {}} onRebuild={() => {}} onDiagnosticClick={() => {}} />); expect(screen.getByLabelText('Firmament source')).toHaveValue('Model A {\n}'); });
+ it('uses Ctrl+Enter as explicit rebuild', () => { const rebuild = vi.fn(); render(<SourcePanel source="Model A {}" diagnostics={[]} onSourceChange={() => {}} onRebuild={rebuild} onDiagnosticClick={() => {}} />); fireEvent.keyDown(screen.getByLabelText('Firmament source'), { key: 'Enter', ctrlKey: true }); expect(rebuild).toHaveBeenCalledOnce(); });
+ it('routes a diagnostic click', () => { const click = vi.fn(); const diagnostic = { severity: 'error' as const, code: 'F001', message: 'Invalid size' }; render(<SourcePanel source="" diagnostics={[diagnostic]} onSourceChange={() => {}} onRebuild={() => {}} onDiagnosticClick={click} />); fireEvent.click(screen.getByText(/DIAGNOSTICS/)); fireEvent.click(screen.getByText('F001')); expect(click).toHaveBeenCalledWith(diagnostic); });
+ it('returns a located diagnostic to the source editor', () => { const diagnostic = { severity: 'error' as const, code: 'F002', message: 'Bad token', source: { source: 'model.firmament', line: 2, column: 2, start: 11, length: 1 } }; render(<SourcePanel source={'Model A {\n bad\n}'} diagnostics={[diagnostic]} onSourceChange={() => {}} onRebuild={() => {}} onDiagnosticClick={() => {}} />); fireEvent.click(screen.getByText(/DIAGNOSTICS/)); fireEvent.click(screen.getByText('F002')); expect(screen.getByLabelText('Firmament source')).toBeVisible(); });
+});
diff --git a/demos/Aetherion.Helios/src/source/SourcePanel.tsx b/demos/Aetherion.Helios/src/source/SourcePanel.tsx
new file mode 100644
index 00000000..bc4d5e67
--- /dev/null
+++ b/demos/Aetherion.Helios/src/source/SourcePanel.tsx
@@ -0,0 +1,40 @@
+import { useMemo, useRef, useState } from 'react';
+import type { Diagnostic } from '@aetheris/cad';
+
+interface Props {
+ source: string;
+ diagnostics: readonly Diagnostic[];
+ onSourceChange(value: string): void;
+ onRebuild(): void;
+ onDiagnosticClick(diagnostic: Diagnostic): void;
+}
+
+export function SourcePanel({ source, diagnostics, onSourceChange, onRebuild, onDiagnosticClick }: Props) {
+ const [tab, setTab] = useState<'source' | 'diagnostics'>('source');
+ const editor = useRef<HTMLTextAreaElement>(null);
+ const lines = useMemo(() => Array.from({ length: Math.max(1, source.split('\n').length) }, (_, i) => i + 1), [source]);
+ const jumpToDiagnostic = (diagnostic: Diagnostic) => {
+ onDiagnosticClick(diagnostic);
+ if (!diagnostic.source) return;
+ setTab('source');
+ const linesBefore = source.split('\n').slice(0, Math.max(0, diagnostic.source.line - 1));
+ const offset = linesBefore.reduce((total, line) => total + line.length + 1, 0) + Math.max(0, diagnostic.source.column - 1);
+ requestAnimationFrame(() => { editor.current?.focus(); editor.current?.setSelectionRange(offset, offset + 1); });
+ };
+ return <section className="panel source-panel" aria-label="Firmament source and diagnostics">
+ <div className="bottom-tabs">
+ <button className={tab === 'source' ? 'active' : ''} onClick={() => setTab('source')}>FIRMAMENT SOURCE</button>
+ <button className={tab === 'diagnostics' ? 'active' : ''} onClick={() => setTab('diagnostics')}>DIAGNOSTICS <span className={diagnostics.some(item => item.severity === 'error') ? 'badge error' : 'badge'}>{diagnostics.length}</span></button>
+ <span className="source-authority">AUTHORITATIVE SOURCE · OVERRIDES SHOWN IN INSPECTOR</span>
+ <button className="rebuild-inline" onClick={onRebuild}>↻ Rebuild</button>
+ </div>
+ {tab === 'source' ? <div className="code-editor">
+ <pre aria-hidden="true">{lines.join('\n')}</pre>
+ <textarea ref={editor} aria-label="Firmament source" spellCheck={false} value={source} onChange={event => onSourceChange(event.target.value)} onKeyDown={event => { if ((event.ctrlKey || event.metaKey) && event.key === 'Enter') { event.preventDefault(); onRebuild(); } }} />
+ </div> : <div className="diagnostic-list">
+ {diagnostics.length ? diagnostics.map((diagnostic, index) => <button key={`${diagnostic.code}-${index}`} className={`diagnostic ${diagnostic.severity}`} onClick={() => jumpToDiagnostic(diagnostic)}>
+ <span className="severity-dot">●</span><strong>{diagnostic.code}</strong><span>{diagnostic.message}</span><small>{diagnostic.source ? `${diagnostic.source.source}:${diagnostic.source.line}:${diagnostic.source.column}` : ''}</small>
+ </button>) : <div className="diagnostic-ok"><span>✓</span> Model is clean. No diagnostics.</div>}
+ </div>}
+ </section>;
+}
diff --git a/demos/Aetherion.Helios/src/test/fakes.ts b/demos/Aetherion.Helios/src/test/fakes.ts
new file mode 100644
index 00000000..db658e96
--- /dev/null
+++ b/demos/Aetherion.Helios/src/test/fakes.ts
@@ -0,0 +1,25 @@
+import type { Diagnostic, EditableProperty, ModelSession, ModelTreeNode, RebuildResult } from '@aetheris/cad';
+
+export const root: ModelTreeNode = { id: 'model:bracket', kind: 'Model', name: 'WebBracket', children: ['box:plate', 'hole:center'], visible: true };
+export const plate: ModelTreeNode = { id: 'box:plate', kind: 'Box', name: 'Plate', parentId: root.id, children: [], visible: true };
+export const hole: ModelTreeNode = { id: 'hole:center', kind: 'Hole', name: 'CenterMount', parentId: root.id, children: [], visible: true };
+export const width: EditableProperty = { id: 'prop:width', ownerEntityId: plate.id, name: 'Width', type: 'Length', unit: 'mm', value: 50, writable: true, source: { source: 'bracket.firmament', line: 3, column: 24, start: 40, length: 4 } };
+
+export function fakeModel(overrides: Partial<ModelSession> = {}): ModelSession {
+ const nodes = [root, plate, hole];
+ const properties = [width];
+ const model = {
+ id: 'session:1', name: 'WebBracket', revision: 1, source: '', sourceName: 'bracket.firmament',
+ tree: { rootId: root.id, nodes }, properties,
+ mesh: { schema: 'aetheris/display-mesh/1', name: 'WebBracket', units: 'mm', definitions: [{ id: 'def:plate', identity: 'plate', positions: new Float64Array(), normals: new Float64Array(), indices: new Uint32Array(), ranges: [{ startTriangle: 0, triangleCount: 12, faceId: 'face:top', semanticEntityId: plate.id }] }], occurrences: [{ id: 'occ:plate', path: '/Plate', definitionId: 'def:plate', semanticEntityId: plate.id, transform: [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1] }] },
+ diagnostics: [] as readonly Diagnostic[], changes: { changedEntityIds: [], addedEntityIds: [], removedEntityIds: [], meshChanged: false, diagnosticsChanged: false },
+ entity(id: string) { return nodes.find(item => item.id === id); }, property(id: string) { return properties.find(item => item.id === id); },
+ setProperty: async () => ok(), setSource: async () => ok(), rebuild: async () => ok(),
+ resolveSelection: () => ({ semanticEntityId: plate.id, faceId: 'face:top', occurrenceId: 'occ:plate', definitionId: 'def:plate' }),
+ selectionForEntity: (id: string) => id === plate.id ? { occurrenceIds: ['occ:plate'], ranges: [{ definitionId: 'def:plate', startTriangle: 0, triangleCount: 12, faceId: 'face:top', semanticEntityId: plate.id }] } : { occurrenceIds: [], ranges: [] },
+ exportSTEP: async () => new Uint8Array([1, 2, 3]), exportSTEPBlob: async () => new Blob(), dispose: async () => {}
+ } as unknown as ModelSession;
+ return Object.assign(model, overrides);
+}
+
+export function ok(): RebuildResult { return { success: true, revision: 2, diagnostics: [], retainedPreviousGeometry: false }; }
diff --git a/demos/Aetherion.Helios/src/test/setup.ts b/demos/Aetherion.Helios/src/test/setup.ts
new file mode 100644
index 00000000..8933a9a8
--- /dev/null
+++ b/demos/Aetherion.Helios/src/test/setup.ts
@@ -0,0 +1,12 @@
+import '@testing-library/jest-dom/vitest';
+import { cleanup } from '@testing-library/react';
+import { afterEach } from 'vitest';
+
+afterEach(cleanup);
+
+class ResizeObserverStub {
+ observe() {}
+ unobserve() {}
+ disconnect() {}
+}
+globalThis.ResizeObserver = ResizeObserverStub as typeof ResizeObserver;
diff --git a/demos/Aetherion.Helios/src/themes/helios.css b/demos/Aetherion.Helios/src/themes/helios.css
new file mode 100644
index 00000000..11811bac
--- /dev/null
+++ b/demos/Aetherion.Helios/src/themes/helios.css
@@ -0,0 +1,88 @@
+:root {
+ font-family: Inter, "Segoe UI", sans-serif;
+ color-scheme: dark;
+ --app-bg: #0c100e;
+ --panel-bg: #151c18;
+ --panel-elevated: #1c2520;
+ --border: #303b34;
+ --border-strong: #48544c;
+ --text-primary: #f0eadb;
+ --text-secondary: #9da69e;
+ --accent: #c99843;
+ --accent-hover: #e2b661;
+ --selection: #d6a348;
+ --error: #d86850;
+ --warning: #d79245;
+ --success: #6aa984;
+ --viewport-bg: #111814;
+ --grid-major: #59655a;
+ --grid-minor: #2b342f;
+ --geometry: #b8beb3;
+ --geometry-selected: #e7ad45;
+ --geometry-hovered: #78b9a4;
+ --control-bg: #101713;
+ --topbar: #111713;
+ --shadow: rgba(0,0,0,.35);
+}
+
+:root[data-theme="sirius"] {
+ color-scheme: light;
+ --app-bg: #e5e8e4;
+ --panel-bg: #f5f4ef;
+ --panel-elevated: #ffffff;
+ --border: #c8ccc7;
+ --border-strong: #aeb4af;
+ --text-primary: #252b28;
+ --text-secondary: #65706a;
+ --accent: #a66e16;
+ --accent-hover: #81520c;
+ --selection: #bd7e18;
+ --error: #b83e2d;
+ --warning: #ae651d;
+ --success: #367c55;
+ --viewport-bg: #e9ece8;
+ --grid-major: #97a19c;
+ --grid-minor: #ced4d0;
+ --geometry: #aab2ad;
+ --geometry-selected: #cc841b;
+ --geometry-hovered: #378a78;
+ --control-bg: #eceeea;
+ --topbar: #faf9f4;
+ --shadow: rgba(30,40,34,.16);
+}
+
+* { box-sizing: border-box; }
+html, body, #root { margin: 0; min-width: 1000px; min-height: 650px; width: 100%; height: 100%; overflow: hidden; }
+button, input, select, textarea { font: inherit; color: inherit; }
+button { border: 0; }
+button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-visible { outline: 1px solid var(--accent); outline-offset: -1px; }
+.helios-app { height: 100%; display: grid; grid-template-rows: 54px minmax(0,1fr) 26px; background: var(--app-bg); color: var(--text-primary); font-size: 12px; }
+.topbar { display: flex; align-items: stretch; background: var(--topbar); border-bottom: 1px solid var(--border); box-shadow: 0 2px 12px var(--shadow); z-index: 5; }
+.brand { width: 205px; display: flex; align-items: center; gap: 10px; padding: 0 14px; border-right: 1px solid var(--border); letter-spacing: .13em; }
+.brand-mark { display: grid; place-items: center; width: 29px; height: 29px; border: 1px solid var(--accent); color: var(--accent); font: 600 17px Georgia, serif; transform: rotate(45deg); }
+.brand-mark::first-letter { transform: rotate(-45deg); }
+.brand strong, .brand small { display: block; }.brand strong { font-size: 14px; }.brand small { color: var(--text-secondary); letter-spacing: .04em; font-size: 9px; margin-top: 2px; }
+.workspace-tabs { display: flex; align-items: end; gap: 2px; padding: 0 12px; border-right: 1px solid var(--border); }
+.workspace-tabs button { height: 100%; padding: 0 11px; background: transparent; color: var(--text-secondary); font-size: 10px; letter-spacing: .09em; border-bottom: 2px solid transparent; }
+.workspace-tabs button.active { color: var(--text-primary); border-color: var(--accent); }.workspace-tabs button:disabled { opacity: .32; }
+.toolbar { flex: 1; display: flex; align-items: center; gap: 3px; padding: 6px 10px; }
+.toolbar button { height: 39px; min-width: 48px; display: grid; place-items: center; background: transparent; color: var(--text-secondary); border-radius: 2px; font-size: 18px; }
+.toolbar button span { font-size: 9px; line-height: 10px; }.toolbar button:hover, .top-actions button:hover { background: var(--panel-elevated); color: var(--text-primary); }
+.toolbar .accent-button { margin-left: 5px; padding: 0 10px; display: flex; gap: 7px; background: color-mix(in srgb, var(--accent) 16%, transparent); border: 1px solid color-mix(in srgb, var(--accent) 55%, transparent); color: var(--accent-hover); }.toolbar .accent-button span { font-size: 10px; }
+.top-actions { display: flex; align-items: center; gap: 3px; padding: 0 12px; border-left: 1px solid var(--border); }.top-actions button { background: transparent; color: var(--text-secondary); padding: 8px; }.top-actions select, .viewport-toolbar select { background: var(--control-bg); border: 1px solid var(--border); padding: 6px 22px 6px 8px; }
+.workspace { min-height: 0; display: grid; grid-template-columns: minmax(175px, 225px) minmax(500px, 1fr) minmax(220px, 290px); }
+.panel { background: var(--panel-bg); min-width: 0; min-height: 0; }.model-browser { border-right: 1px solid var(--border); }.inspector { border-left: 1px solid var(--border); }
+.panel-heading { height: 34px; display: flex; align-items: center; justify-content: space-between; padding: 0 12px; border-bottom: 1px solid var(--border); color: var(--text-secondary); font-size: 10px; letter-spacing: .1em; }.panel-meta { color: var(--accent); letter-spacing: .03em; }
+.tree-filters { margin: 10px; display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 6px; }.tree-search { height: 30px; display: flex; align-items: center; gap: 6px; background: var(--control-bg); border: 1px solid var(--border); padding: 0 8px; color: var(--text-secondary); }.tree-search input { min-width: 0; flex: 1; border: 0; outline: 0; background: transparent; }.tree-filters select { min-width: 62px; max-width: 92px; border: 1px solid var(--border); background: var(--control-bg); padding: 0 6px; color: var(--text-secondary); }
+.tree-scroll, .inspector-scroll { height: calc(100% - 74px); overflow: auto; }.inspector-scroll { height: calc(100% - 34px); }
+.tree-row { height: 28px; display: flex; align-items: center; gap: 5px; border-left: 2px solid transparent; cursor: default; white-space: nowrap; }.tree-row:hover { background: var(--panel-elevated); }.tree-row.selected { background: color-mix(in srgb, var(--selection) 15%, transparent); border-left-color: var(--selection); }.disclosure { width: 15px; padding: 0; background: transparent; color: var(--text-secondary); }.kind-icon { width: 17px; color: var(--text-secondary); text-align: center; }.kind-hole { color: var(--accent); }.tree-name { overflow: hidden; text-overflow: ellipsis; }.tree-kind { margin-left: auto; color: var(--text-secondary); font-size: 9px; padding-right: 8px; text-transform: uppercase; }
+.empty-state { padding: 24px 16px; color: var(--text-secondary); line-height: 1.6; text-align: center; }.empty-state.compact { padding: 11px 14px; text-align: left; }
+.center-stack { min-width: 0; min-height: 0; display: grid; grid-template-rows: 34px minmax(260px,1fr) minmax(170px, 31%); background: var(--viewport-bg); }
+.viewport-toolbar { display: flex; justify-content: space-between; align-items: center; padding: 0 9px; background: var(--panel-bg); border-bottom: 1px solid var(--border); }.viewport-toolbar div { display: flex; gap: 3px; }.viewport-toolbar button { height: 25px; padding: 0 8px; background: transparent; color: var(--text-secondary); font-size: 9px; letter-spacing: .06em; border: 1px solid transparent; }.viewport-toolbar button:hover { border-color: var(--border); color: var(--text-primary); }.viewport-toolbar select { padding-top: 4px; padding-bottom: 4px; font-size: 10px; }
+.viewport-shell { position: relative; overflow: hidden; background: var(--viewport-bg); }.viewport-canvas, .viewport-canvas canvas { width: 100%; height: 100%; display: block; }.viewport-empty { position: absolute; inset: 0; display: grid; place-items: center; color: var(--text-secondary); pointer-events: none; }.axis-labels { position: absolute; left: 16px; bottom: 14px; display: flex; gap: 7px; font: 700 10px ui-monospace, monospace; }.axis-x { color: #d85a4c; }.axis-y { color: #63a86b; }.axis-z { color: #568ec6; }
+.source-panel { border-top: 1px solid var(--border); display: grid; grid-template-rows: 34px minmax(0,1fr); }.bottom-tabs { display: flex; align-items: stretch; border-bottom: 1px solid var(--border); }.bottom-tabs button { padding: 0 12px; background: transparent; color: var(--text-secondary); font-size: 9px; letter-spacing: .08em; border-top: 2px solid transparent; }.bottom-tabs button.active { color: var(--text-primary); border-top-color: var(--accent); }.bottom-tabs .rebuild-inline { margin-left: auto; color: var(--accent); }.badge { display: inline-grid; place-items: center; min-width: 16px; height: 15px; margin-left: 4px; border-radius: 8px; background: var(--panel-elevated); }.badge.error { color: var(--error); }.source-authority { align-self: center; color: var(--text-secondary); font-size: 8px; letter-spacing: .06em; opacity: .7; }
+.code-editor { min-height: 0; display: grid; grid-template-columns: 38px minmax(0,1fr); background: var(--control-bg); overflow: hidden; }.code-editor pre { margin: 0; padding: 10px 9px; overflow: hidden; background: color-mix(in srgb, var(--panel-bg) 65%, transparent); border-right: 1px solid var(--border); color: var(--text-secondary); text-align: right; font: 11px/18px "Cascadia Code", Consolas, monospace; user-select: none; }.code-editor textarea { width: 100%; height: 100%; resize: none; border: 0; outline: 0; padding: 10px 12px; background: transparent; color: var(--text-primary); font: 11px/18px "Cascadia Code", Consolas, monospace; white-space: pre; overflow: auto; tab-size: 4; }.diagnostic-list { overflow: auto; background: var(--control-bg); }.diagnostic { width: 100%; display: grid; grid-template-columns: 16px 110px 1fr auto; gap: 7px; align-items: center; padding: 8px 12px; background: transparent; text-align: left; border-bottom: 1px solid var(--border); }.diagnostic:hover { background: var(--panel-elevated); }.diagnostic small { color: var(--text-secondary); }.diagnostic.error .severity-dot { color: var(--error); }.diagnostic.warning .severity-dot { color: var(--warning); }.diagnostic.info .severity-dot { color: var(--success); }.diagnostic-ok { display: flex; align-items: center; gap: 8px; color: var(--success); padding: 16px; }
+.entity-hero { display: flex; align-items: center; gap: 10px; padding: 15px; border-bottom: 1px solid var(--border); }.entity-glyph { display: grid; place-items: center; width: 34px; height: 34px; color: var(--accent); background: color-mix(in srgb, var(--accent) 12%, transparent); border: 1px solid color-mix(in srgb, var(--accent) 40%, transparent); font-size: 16px; }.entity-hero strong, .entity-hero small { display: block; }.entity-hero small { margin-top: 3px; color: var(--text-secondary); text-transform: uppercase; font-size: 9px; letter-spacing: .08em; }.identity-list { display: grid; grid-template-columns: 76px 1fr; gap: 8px; margin: 0; padding: 12px 14px; border-bottom: 1px solid var(--border); }.identity-list dt { color: var(--text-secondary); }.identity-list dd { margin: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-family: "Cascadia Code", monospace; font-size: 10px; }.section-label { padding: 12px 14px 6px; color: var(--text-secondary); font-size: 9px; letter-spacing: .1em; }.property-editor { padding: 8px 14px 12px; border-bottom: 1px solid var(--border); }.property-editor label { display: block; margin-bottom: 6px; }.property-control { display: grid; grid-template-columns: minmax(0,1fr) auto auto; align-items: center; border: 1px solid var(--border); background: var(--control-bg); }.property-control input { min-width: 0; width: 100%; height: 29px; border: 0; padding: 0 7px; background: transparent; font-family: "Cascadia Code", monospace; }.property-control span { color: var(--text-secondary); padding: 0 7px; }.property-control button { height: 29px; padding: 0 8px; background: var(--panel-elevated); color: var(--accent); border-left: 1px solid var(--border); font-size: 9px; text-transform: uppercase; }.property-editor small { display: block; margin-top: 5px; color: var(--text-secondary); line-height: 1.4; }.property-editor.invalid .property-control { border-color: var(--error); }.property-editor.invalid small { color: var(--error); }
+.statusbar { display: flex; align-items: center; gap: 0; background: var(--panel-elevated); border-top: 1px solid var(--border); color: var(--text-secondary); font-size: 9px; letter-spacing: .05em; }.statusbar > span { height: 100%; display: flex; align-items: center; padding: 0 10px; border-right: 1px solid var(--border); white-space: nowrap; }.statusbar .status-ready { color: var(--success); }.status-ready i { width: 6px; height: 6px; margin-right: 6px; border-radius: 50%; background: currentColor; }.statusbar .status-selection { flex: 1; overflow: hidden; text-overflow: ellipsis; }.has-diagnostics { color: var(--warning); }
+.busy-overlay { position: fixed; top: 64px; left: 50%; transform: translateX(-50%); z-index: 20; display: flex; align-items: center; gap: 9px; padding: 9px 14px; background: var(--panel-elevated); border: 1px solid var(--border-strong); box-shadow: 0 8px 25px var(--shadow); color: var(--text-primary); }.spinner { width: 13px; height: 13px; border: 2px solid var(--border-strong); border-top-color: var(--accent); border-radius: 50%; animation: spin .7s linear infinite; }@keyframes spin { to { transform: rotate(360deg); } }
+@media (max-width: 1150px) { .workspace { grid-template-columns: 190px 1fr 235px; }.workspace-tabs button { padding: 0 6px; }.source-authority { display: none; } }
diff --git a/demos/Aetherion.Helios/src/viewport/Viewport.tsx b/demos/Aetherion.Helios/src/viewport/Viewport.tsx
new file mode 100644
index 00000000..2f76eb8b
--- /dev/null
+++ b/demos/Aetherion.Helios/src/viewport/Viewport.tsx
@@ -0,0 +1,200 @@
+import { useEffect, useRef } from 'react';
+import * as THREE from 'three';
+import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
+import type { ModelSession } from '@aetheris/cad';
+import type { DisplayMode, ThemeName, ViewMode } from '../app/types';
+
+interface Props {
+ model: ModelSession | null;
+ selectedEntityId: string | null;
+ theme: ThemeName;
+ displayMode: DisplayMode;
+ viewMode: ViewMode;
+ viewCommand: string;
+ onSelect(entityId: string | null, faceId: string | null): void;
+}
+
+type MeshMeta = { definitionId: string; occurrenceId: string; edge?: boolean };
+
+export function Viewport(props: Props) {
+ const host = useRef<HTMLDivElement>(null);
+ const state = useRef<ReturnType<typeof createScene> | null>(null);
+
+ useEffect(() => {
+ if (!host.current) return;
+ const sceneState = createScene(host.current, props.onSelect);
+ state.current = sceneState;
+ return () => { sceneState.dispose(); state.current = null; };
+ }, []);
+
+ useEffect(() => { if (state.current) loadModel(state.current, props.model); }, [props.model, props.model?.revision]);
+ useEffect(() => { if (state.current) selectEntity(state.current, props.model, props.selectedEntityId); }, [props.model, props.selectedEntityId]);
+ useEffect(() => { if (state.current) applyAppearance(state.current, props.theme, props.displayMode); }, [props.theme, props.displayMode]);
+ useEffect(() => { if (state.current) applyViewCommand(state.current, props.viewMode, props.viewCommand); }, [props.viewMode, props.viewCommand]);
+
+ return <section className="viewport-shell" aria-label="3D viewport">
+ <div className="viewport-canvas" ref={host} data-testid="viewport" />
+ <div className="axis-labels" aria-hidden="true"><span className="axis-x">X</span><span className="axis-y">Y</span><span className="axis-z">Z</span></div>
+ {!props.model && <div className="viewport-empty">Firmament geometry will appear here.</div>}
+ </section>;
+}
+
+function createScene(host: HTMLDivElement, onSelect: Props['onSelect']) {
+ const scene = new THREE.Scene();
+ const renderer = new THREE.WebGLRenderer({ antialias: true });
+ renderer.setPixelRatio(Math.min(devicePixelRatio, 2));
+ renderer.outputColorSpace = THREE.SRGBColorSpace;
+ host.appendChild(renderer.domElement);
+ const perspective = new THREE.PerspectiveCamera(35, 1, 0.1, 10000);
+ const orthographic = new THREE.OrthographicCamera(-70, 70, 70, -70, 0.1, 10000);
+ perspective.position.set(90, 70, 90);
+ orthographic.position.copy(perspective.position);
+ let camera: THREE.Camera = perspective;
+ const controls = new OrbitControls(perspective, renderer.domElement);
+ controls.enableDamping = true;
+ controls.dampingFactor = 0.12;
+ const ambient = new THREE.HemisphereLight(0xffffff, 0x263128, 2.1);
+ const key = new THREE.DirectionalLight(0xffffff, 2.8); key.position.set(60, 100, 80);
+ scene.add(ambient, key);
+ const grid = new THREE.GridHelper(400, 40, 0x6a715f, 0x414942); grid.rotation.x = Math.PI / 2; scene.add(grid);
+ const axes = new THREE.AxesHelper(25); scene.add(axes);
+ const group = new THREE.Group(); scene.add(group);
+ const raycaster = new THREE.Raycaster();
+ const pointer = new THREE.Vector2();
+ let hovered: THREE.Mesh | null = null;
+ let selectedIds = new Set<string>();
+ let dirty = true;
+ let raf = 0;
+ const invalidate = () => { dirty = true; if (!raf) raf = requestAnimationFrame(render); };
+ const render = () => {
+ raf = 0;
+ const damping = controls.update();
+ if (dirty || damping) renderer.render(scene, camera);
+ dirty = false;
+ if (damping) raf = requestAnimationFrame(render);
+ };
+ controls.addEventListener('change', invalidate);
+ const resize = new ResizeObserver(() => {
+ const width = Math.max(host.clientWidth, 1), height = Math.max(host.clientHeight, 1);
+ renderer.setSize(width, height, false);
+ perspective.aspect = width / height; perspective.updateProjectionMatrix();
+ const extent = 70; orthographic.left = -extent * width / height; orthographic.right = extent * width / height; orthographic.top = extent; orthographic.bottom = -extent; orthographic.updateProjectionMatrix();
+ invalidate();
+ });
+ resize.observe(host);
+ const hitTest = (event: PointerEvent) => {
+ const rect = renderer.domElement.getBoundingClientRect();
+ pointer.set(((event.clientX - rect.left) / rect.width) * 2 - 1, -((event.clientY - rect.top) / rect.height) * 2 + 1);
+ raycaster.setFromCamera(pointer, camera);
+ return raycaster.intersectObjects(group.children, false)[0];
+ };
+ renderer.domElement.addEventListener('pointermove', event => {
+ const next = hitTest(event)?.object as THREE.Mesh | undefined;
+ if (hovered !== next) { hovered = next ?? null; updateMaterials(group, selectedIds, hovered); invalidate(); }
+ });
+ renderer.domElement.addEventListener('click', event => {
+ const hit = hitTest(event);
+ if (!hit) { onSelect(null, null); return; }
+ const meta = hit.object.userData as MeshMeta;
+ const resolved = (state.model as ModelSession | null)?.resolveSelection(meta.definitionId, hit.faceIndex ?? 0, meta.occurrenceId);
+ onSelect(resolved?.semanticEntityId ?? null, resolved?.faceId ?? null);
+ });
+ const state = { scene, renderer, perspective, orthographic, get camera() { return camera; }, set camera(value) { camera = value; }, controls, grid, group, model: null as ModelSession | null, selectedIds, hovered, invalidate,
+ dispose() { cancelAnimationFrame(raf); resize.disconnect(); controls.dispose(); renderer.dispose(); host.replaceChildren(); } };
+ invalidate();
+ return state;
+}
+
+function loadModel(state: ReturnType<typeof createScene>, model: ModelSession | null) {
+ for (const child of [...state.group.children]) { state.group.remove(child); disposeObject(child); }
+ state.model = model;
+ if (!model) { state.invalidate(); return; }
+ const geometries = new Map(model.mesh.definitions.map(definition => {
+ const geometry = new THREE.BufferGeometry();
+ geometry.setAttribute('position', new THREE.BufferAttribute(Float32Array.from(definition.positions), 3));
+ geometry.setAttribute('normal', new THREE.BufferAttribute(Float32Array.from(definition.normals), 3));
+ geometry.setIndex(new THREE.BufferAttribute(definition.indices, 1));
+ geometry.computeBoundingSphere();
+ return [definition.id, geometry];
+ }));
+ for (const occurrence of model.mesh.occurrences) {
+ const geometry = occurrence.definitionId ? geometries.get(occurrence.definitionId) : undefined;
+ if (!geometry || !occurrence.definitionId) continue;
+ const mesh = new THREE.Mesh(geometry, material(false, false));
+ mesh.matrix.fromArray(occurrence.transform); mesh.matrixAutoUpdate = false;
+ mesh.userData = { definitionId: occurrence.definitionId, occurrenceId: occurrence.id } satisfies MeshMeta;
+ state.group.add(mesh);
+ const edges = new THREE.LineSegments(new THREE.EdgesGeometry(geometry, 25), new THREE.LineBasicMaterial({ color: 0x323a35, transparent: true, opacity: 0.72 }));
+ edges.matrix.copy(mesh.matrix); edges.matrixAutoUpdate = false;
+ edges.userData = { definitionId: occurrence.definitionId, occurrenceId: occurrence.id, edge: true } satisfies MeshMeta;
+ edges.raycast = () => undefined;
+ state.group.add(edges);
+ }
+ fit(state);
+}
+
+function selectEntity(state: ReturnType<typeof createScene>, model: ModelSession | null, entityId: string | null) {
+ const selection = entityId && model ? model.selectionForEntity(entityId) : { occurrenceIds: [] };
+ state.selectedIds = new Set(selection.occurrenceIds);
+ updateMaterials(state.group, state.selectedIds, state.hovered);
+ state.invalidate();
+}
+
+function updateMaterials(group: THREE.Group, selectedIds: Set<string>, hovered: THREE.Mesh | null) {
+ for (const object of group.children) if (object instanceof THREE.Mesh) {
+ const selected = selectedIds.has((object.userData as MeshMeta).occurrenceId);
+ (object.material as THREE.MeshStandardMaterial).color.set(selected ? 0xe7ad45 : object === hovered ? 0x78b9a4 : 0xb8beb3);
+ (object.material as THREE.MeshStandardMaterial).emissive.set(selected ? 0x382406 : 0x000000);
+ } else if (object instanceof THREE.LineSegments) {
+ const selected = selectedIds.has((object.userData as MeshMeta).occurrenceId);
+ (object.material as THREE.LineBasicMaterial).color.set(selected ? 0xffca63 : 0x323a35);
+ }
+}
+
+function applyAppearance(state: ReturnType<typeof createScene>, theme: ThemeName, mode: DisplayMode) {
+ state.scene.background = new THREE.Color(theme === 'mars' ? 0x111814 : 0xe9ece8);
+ (state.grid.material as THREE.Material).opacity = theme === 'mars' ? 0.28 : 0.4;
+ (state.grid.material as THREE.Material).transparent = true;
+ for (const object of state.group.children) if (object instanceof THREE.Mesh) {
+ const mat = object.material as THREE.MeshStandardMaterial;
+ mat.wireframe = mode === 'wireframe';
+ mat.flatShading = mode !== 'shaded'; mat.needsUpdate = true;
+ } else if (object instanceof THREE.LineSegments) {
+ object.visible = mode === 'edges';
+ (object.material as THREE.LineBasicMaterial).color.set(theme === 'mars' ? 0x323a35 : 0x69716d);
+ }
+ state.invalidate();
+}
+
+function applyViewCommand(state: ReturnType<typeof createScene>, mode: ViewMode, command: string) {
+ command = command.split('-')[0];
+ const prior = state.camera;
+ state.camera = mode === 'orthographic' ? state.orthographic : state.perspective;
+ state.controls.object = state.camera as THREE.PerspectiveCamera;
+ if (prior !== state.camera) state.camera.position.copy(prior.position);
+ const distance = Math.max(state.camera.position.length(), 100);
+ const positions: Record<string, THREE.Vector3> = { front: new THREE.Vector3(0, -distance, 0), top: new THREE.Vector3(0, 0, distance), right: new THREE.Vector3(distance, 0, 0), iso: new THREE.Vector3(distance, distance, distance) };
+ if (positions[command]) state.camera.position.copy(positions[command]);
+ if (command === 'fit') fit(state);
+ else if (command === 'fitselection') fitSelection(state);
+ else { state.camera.lookAt(0, 0, 0); state.controls.update(); state.invalidate(); }
+}
+
+function fit(state: ReturnType<typeof createScene>, objects: readonly THREE.Object3D[] = [state.group]) {
+ const box = new THREE.Box3();
+ for (const object of objects) box.expandByObject(object);
+ if (box.isEmpty()) { state.invalidate(); return; }
+ const center = box.getCenter(new THREE.Vector3());
+ const size = box.getSize(new THREE.Vector3()).length();
+ state.controls.target.copy(center);
+ state.camera.position.copy(center).add(new THREE.Vector3(1, 0.8, 1).normalize().multiplyScalar(Math.max(size * 1.5, 30)));
+ state.camera.lookAt(center); state.controls.update(); state.invalidate();
+}
+
+function fitSelection(state: ReturnType<typeof createScene>) {
+ const selected = state.group.children.filter(object => object instanceof THREE.Mesh && state.selectedIds.has((object.userData as MeshMeta).occurrenceId));
+ fit(state, selected.length ? selected : [state.group]);
+}
+
+function material(selected: boolean, wireframe: boolean) { return new THREE.MeshStandardMaterial({ color: selected ? 0xe7ad45 : 0xb8beb3, metalness: 0.15, roughness: 0.62, side: THREE.DoubleSide, wireframe }); }
+function disposeObject(object: THREE.Object3D) { if (object instanceof THREE.Mesh || object instanceof THREE.LineSegments) { object.geometry.dispose(); (object.material as THREE.Material).dispose(); } }
diff --git a/demos/Aetherion.Helios/src/vite-env.d.ts b/demos/Aetherion.Helios/src/vite-env.d.ts
new file mode 100644
index 00000000..11f02fe2
--- /dev/null
+++ b/demos/Aetherion.Helios/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
diff --git a/demos/Aetherion.Helios/tsconfig.app.json b/demos/Aetherion.Helios/tsconfig.app.json
new file mode 100644
index 00000000..5ec96c14
--- /dev/null
+++ b/demos/Aetherion.Helios/tsconfig.app.json
@@ -0,0 +1,19 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "useDefineForClassFields": true,
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
+ "allowJs": false,
+ "skipLibCheck": true,
+ "esModuleInterop": true,
+ "allowSyntheticDefaultImports": true,
+ "strict": true,
+ "module": "ESNext",
+ "moduleResolution": "Bundler",
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+ "jsx": "react-jsx"
+ },
+ "include": ["src"]
+}
diff --git a/demos/Aetherion.Helios/tsconfig.json b/demos/Aetherion.Helios/tsconfig.json
new file mode 100644
index 00000000..d32ff682
--- /dev/null
+++ b/demos/Aetherion.Helios/tsconfig.json
@@ -0,0 +1,4 @@
+{
+ "files": [],
+ "references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }]
+}
diff --git a/demos/Aetherion.Helios/tsconfig.node.json b/demos/Aetherion.Helios/tsconfig.node.json
new file mode 100644
index 00000000..c67e8a69
--- /dev/null
+++ b/demos/Aetherion.Helios/tsconfig.node.json
@@ -0,0 +1,9 @@
+{
+ "compilerOptions": {
+ "composite": true,
+ "skipLibCheck": true,
+ "module": "ESNext",
+ "moduleResolution": "Bundler"
+ },
+ "include": ["vite.config.ts"]
+}
diff --git a/demos/Aetherion.Helios/vite.config.ts b/demos/Aetherion.Helios/vite.config.ts
new file mode 100644
index 00000000..78f263a9
--- /dev/null
+++ b/demos/Aetherion.Helios/vite.config.ts
@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+import react from '@vitejs/plugin-react';
+import { aetherisCad } from '@aetheris/cad/vite';
+
+export default defineConfig({
+ plugins: [aetherisCad(), react()],
+ server: { port: 4173 },
+ test: { environment: 'jsdom', setupFiles: './src/test/setup.ts', css: true }
+});
diff --git a/docs/public/web-sdk/build-your-own-cad-frontend.md b/docs/public/web-sdk/build-your-own-cad-frontend.md
new file mode 100644
index 00000000..ea3c96d3
--- /dev/null
+++ b/docs/public/web-sdk/build-your-own-cad-frontend.md
@@ -0,0 +1,31 @@
+# Build Your Own CAD Frontend
+
+A minimal Aetheris CAD frontend needs four projections and one authority:
+
+```text
+@aetheris/cad
+ -> ModelSession
+ -> semantic tree
+ -> property schema
+ -> DisplayMesh
+ -> diagnostics and artifacts
+```
+
+Firmament and `ModelSession` are the authority. Your framework, renderer, and layout are choices.
+
+## Minimum path
+
+1. Create `Aetheris` and compile Firmament source.
+2. Render `model.tree`; keep semantic IDs as selection keys.
+3. Build render geometry from `model.mesh.definitions` and instances from `model.mesh.occurrences`.
+4. Send ray hits through `resolveSelection`. Send tree selections through `selectionForEntity`.
+5. Generate property controls from `model.properties` and preserve their units.
+6. Commit a property with `setProperty` or authoritative text with `setSource`.
+7. Treat diagnostics as values. On failure, continue displaying the last valid snapshot.
+8. Download manufacturing output from `exportSTEP`.
+
+Optional pieces include an editor runtime adapter, source history, named views, display modes, a command palette, file pickers, and theme persistence. None of them should own engineering semantics.
+
+Do not duplicate the Firmament feature graph, infer semantic identity from triangles, rewrite arbitrary source with regular expressions, mutate a browser B-rep, or hide property overrides. If a public capability is missing, add the smallest general SDK contract and qualify it independently.
+
+Helios uses React and Three.js, but neither is required. Its useful reusable pattern is the authority boundary, not its component framework.
diff --git a/docs/public/web-sdk/reference-editor.md b/docs/public/web-sdk/reference-editor.md
new file mode 100644
index 00000000..275f5bb6
--- /dev/null
+++ b/docs/public/web-sdk/reference-editor.md
@@ -0,0 +1,57 @@
+# Helios reference editor
+
+Helios is a reference CAD editor built entirely on the public Aetheris Web SDK. It demonstrates that a useful frontend can stay thin: Firmament owns engineering meaning, and the browser owns discoverability, selection, inspection, authoring assistance, and presentation.
+
+Run it from `demos/Aetherion.Helios` with `npm run sdk:install` followed by `npm run dev`. The setup command consumes a locally packed `@aetheris/cad` tarball, which qualifies the public package rather than repository-relative SDK source.
+
+## Data flow
+
+```text
+UI intent
+ -> Firmament source or typed property override
+ -> ModelSession.setSource / setProperty
+ -> transactional SDK rebuild
+ -> tree + properties + DisplayMesh + diagnostics
+ -> Helios projection
+```
+
+There is no browser feature graph, solid model, B-rep mutation layer, or private runtime access.
+
+## Public API mapping
+
+| Editor surface | Public SDK authority |
+|---|---|
+| Runtime status | `Aetheris.create`, `info`, `capabilities` |
+| Open/compile | `Aetheris.compile` |
+| Model tree | `ModelSession.tree`, `entity` |
+| Property inspector | `properties`, `property`, `setProperty` |
+| Source editor | `source`, `setSource`, `rebuild` |
+| Viewport | `mesh.definitions`, `mesh.occurrences` |
+| Viewport to model | `resolveSelection` |
+| Tree to viewport | `selectionForEntity` |
+| Diagnostics | compile and rebuild result diagnostics |
+| STEP download | `exportSTEP` |
+
+The viewport creates one Three.js `BufferGeometry` per SDK definition and one mesh object per occurrence. Occurrence transforms are applied exactly as supplied. GPU conversion from `Float64Array` to `Float32Array` happens only at the renderer boundary.
+
+## Editing policy
+
+The X1 SDK represents supported property edits as typed effective overrides. Helios therefore keeps the authoritative source visible and labels the inspector values as overrides. Replacing source clears overrides according to the SDK contract.
+
+Property edits commit only through **Apply** or Enter. A rejected edit remains in the field, the SDK keeps the last valid revision and geometry, and the diagnostic stays visible for correction. Source edits commit with Rebuild or Ctrl/Cmd+Enter.
+
+The Hole toolbar command is deliberately narrow. It appends one readable, canonical Firmament `Modify` block for an existing body and then relies on the ordinary source rebuild. It does not infer or alter B-rep geometry.
+
+## Selection authority
+
+On a viewport click, Three.js supplies only the definition, occurrence, and triangle index. Helios asks `resolveSelection` for the semantic entity and face, then stores that identity as editor selection. The tree and inspector consume the same identity. In the reverse direction, `selectionForEntity` returns occurrence/range bindings for viewport highlighting.
+
+## Runtime boundary
+
+`CadRuntime` is intentionally small: initialize, open, source/property rebuild, STEP export, and dispose. `WebSdkCadRuntime` delegates directly to the public package. A future local, hosted, or native engine can implement the same editor-facing boundary without changing Firmament authority. Those transports are not part of X1.
+
+## Browser and capability limits
+
+Chromium is the X1 browser baseline. Firefox is not claimed. The public runtime is main-thread WASM because `worker: true` returns `worker-unavailable`. Sheet metal, FEA, external STEP import, and Forge subprocess capabilities remain unavailable in browser X1 and Helios does not fake them.
+
+Helios is intentionally bounded. It is an example frontend, not the only Aetheris frontend and not a feature-for-feature commercial CAD replacement.
diff --git a/docs/release/HELIOS-X1.md b/docs/release/HELIOS-X1.md
new file mode 100644
index 00000000..5df956b0
--- /dev/null
+++ b/docs/release/HELIOS-X1.md
@@ -0,0 +1,85 @@
+# HELIOS-X1 release report
+
+## Executive verdict
+
+**Accepted.** Helios demonstrates a useful semantic CAD editor on the public `@aetheris/cad` package without private kernel knowledge or a parallel CAD implementation. The browser path compiled and rendered the canonical bracket and assembly, resolved selection in both directions, rebuilt a valid property override, and visibly retained the last valid revision and geometry for an invalid edit. A separately implemented public-SDK sample generated a 7,294-byte STEP payload in Chromium.
+
+Helios is deliberately bounded. It demonstrates the integration surface and does not prevent deeper or more specialized third-party Aetheris frontends.
+
+## Feature inventory
+
+- Shell: command bar, searchable and semantic-kind-filtered browser, Three.js viewport, inspector, source/diagnostics region, status bar.
+- SDK calls: `Aetheris.create`, `info`, `compile`; `entity`, `setProperty`, `setSource`, `rebuild`, `resolveSelection`, `selectionForEntity`, `exportSTEP`, and disposal.
+- Authoring convenience: deterministic centered through-hole source block; New/Open/source download and source history.
+- Display: shaded, real edge overlay, wireframe; perspective/orthographic; front/top/right/iso/fit-model/fit-selection; orbit/pan/zoom; grid and axes.
+- Assembly inspection: occurrence, referenced definition, parent, and transformed translation are shown using public display-mesh data.
+- Themes: Mars and Sirius through shared design tokens.
+- Fixtures: `editable-bracket.firmament` and `shared-block-assembly.firmament`.
+- Public dependencies: React, Three.js, Vite, and the packed `@aetheris/cad` package.
+
+## Firmament authority proof
+
+The Hole command changes readable Firmament source only. Rebuild passes that text to `ModelSession.setSource`; the resulting SDK snapshot replaces the tree, mesh, properties, revision, and diagnostics. No Helios code constructs CAD geometry.
+
+For scalar edits, the inspector calls `setProperty` with `{ value, unit }`. A live Chromium qualification changed Width from 50 mm to 80 mm and advanced revision 1 to revision 2. Entering -8 mm was rejected, left revision 2 and the 80 mm geometry visible, retained the invalid draft for correction, and displayed a diagnostic.
+
+## Selection authority proof
+
+The live assembly qualification clicked a rendered triangle. `resolveSelection` returned `assembly-instance:WebBlockPair.Fixed` and `face:3`; Helios selected **Fixed** in the tree and inspector and highlighted its occurrence. Tree selection uses `selectionForEntity` and highlighted the matching viewport occurrence.
+
+## SDK friction
+
+| Finding | Classification | Result |
+|---|---|---|
+| WASM runs on the page thread | Deferred by SDK | Async loading states are explicit; large rebuild blocking is documented. |
+| Sheet metal is unavailable in browser X1 | Deferred by SDK | Category is visibly disabled; no fake UI semantics. |
+| Property overrides leave source unchanged | Public policy | Inspector labels effective overrides and source remains visible. |
+| `ModelSession` updates its snapshot in place | Worked around generically | The Helios adapter snapshots the public session object after rebuild so reactive views receive a new identity. |
+| Runtime package is large | Deferred by SDK | Vite emits a chunk-size warning; package/runtime trimming is outside Helios X1. |
+| Programmatic download was not observable through the in-app browser download hook | Qualification friction | The Helios download path is component-tested. The independent public-SDK sample generated and attempted to download 7,294 STEP bytes in Chromium. |
+
+No Helios-only SDK backdoor was added.
+
+## Themes and accessibility
+
+Both themes use the same named tokens: application, panel, elevation, borders, primary/secondary text, accent/hover, selection, error, warning, success, viewport, grid major/minor, and default/selected/hovered geometry. Mars uses charcoal and green-gray chrome with brass accents. Sirius uses warm off-white surfaces, graphite text, cool grids, and the same semantic accent roles. Controls have visible focus, text labels, and sufficient state redundancy beyond color.
+
+## Browser and performance qualification
+
+Chromium exercised fit, semantic selection, tree/inspector synchronization, source and property editing, transactional invalid-edit recovery, assembly transforms, and both themes. Warm local observations were 362 ms for initialization plus compile, 288 ms for source rebuild, and 307 ms for property rebuild. These are development-machine observations, not performance promises. Rendering is event-driven: the Three.js renderer invalidates for camera, scene, resize, selection, hover, and appearance changes; damping schedules frames only while motion continues. There is no application-level perpetual render loop.
+
+Firefox is not qualified. STEP download event capture remains a browser-harness limitation noted above, not an SDK diagnostic.
+
+## Fresh-agent qualification
+
+Two independent fresh-agent tasks completed before release closure:
+
+1. The reference-editor agent added a broad semantic-kind filter derived only from public `ModelTreeNode.kind`, composed it with text search and ancestor preservation, and added focused tests. It found no public-contract blocker.
+2. The independent-frontend agent did not read Helios implementation code. It built `samples/web-sdk-pocket-view/` from public SDK material alone using framework-free TypeScript, a 2D canvas renderer, semantic tree, mesh counts, and STEP export. Chromium compiled revision 1 with 1 definition, 1 occurrence, 1,016 vertices, 1,808 triangles, and generated 7,294 STEP bytes.
+
+The independent implementation exposed two concrete SDK frictions: the canonical fixture's public semantic tree was coarse (model plus `AirHoleSimpleShaftMaterializer`), and the local runtime package installed about 61.9 MB of untrimmed assets. Neither required a private API or a Helios-specific backdoor.
+
+The editor's non-test TypeScript/TSX/CSS implementation is 666 lines, excluding package/configuration files. The independent sample is intentionally separate and is not counted toward that budget.
+
+## Evidence and reproduction
+
+Actual Chromium screenshots were captured during qualification for Mars, Sirius, selected feature, source/properties, invalid-edit recovery, assembly, and assembly selection. Per-run binary screenshots remain local/conversation evidence under the generated-artifact policy rather than source-controlled product assets.
+
+Reproduce with:
+
+```powershell
+cd demos/Aetherion.Helios
+npm run sdk:install
+npm test
+npm run build
+npm run dev
+```
+
+CLI ground truth:
+
+```powershell
+dotnet run --project Aetheris.CLI -- inspect fixtures/Canonical/WebSdk/editable-bracket.firmament --json
+dotnet run --project Aetheris.CLI -- asm inspect fixtures/Canonical/WebSdk/shared-block-assembly.firmament --json
+```
+
+Release validation passed with 26 Helios component tests, both Helios and pocket-view production builds, and the complete .NET solution test run using `--maxcpucount:1`. A first fully concurrent solution run exposed the existing five-second fallback-test sensitivity under machine load; that exact test, its complete 977-test project, and the serialized full solution all passed on rerun. `Aetheris.FrictionLab.Tests` continues to report no discoverable tests, as it did before this frontend work.
diff --git a/samples/README.md b/samples/README.md
index c55630aa..325ff1c0 100644
--- a/samples/README.md
+++ b/samples/README.md
@@ -3,3 +3,5 @@
Samples show how an external consumer integrates Aetheris. This includes package-consuming applications and Forge Host clients in other languages.
Use `samples/` for “how a consumer calls Aetheris.” Use [`demos/`](../demos/README.md) for a runnable narrative that demonstrates an Aetheris capability. A new Python Forge Host integration example belongs here.
+
+- [`web-sdk-pocket-view/`](web-sdk-pocket-view/) is a framework-free browser frontend that consumes the public `@aetheris/cad` package, compiles the canonical bracket, projects its mesh to canvas, lists semantic nodes, and exports STEP.
diff --git a/samples/web-sdk-pocket-view/.gitignore b/samples/web-sdk-pocket-view/.gitignore
new file mode 100644
index 00000000..178135c2
--- /dev/null
+++ b/samples/web-sdk-pocket-view/.gitignore
@@ -0,0 +1 @@
+/dist/
diff --git a/samples/web-sdk-pocket-view/README.md b/samples/web-sdk-pocket-view/README.md
new file mode 100644
index 00000000..a276b13f
--- /dev/null
+++ b/samples/web-sdk-pocket-view/README.md
@@ -0,0 +1,35 @@
+# Aetheris Web SDK Pocket View
+
+A tiny, framework-free CAD frontend built as an external consumer of `@aetheris/cad`.
+It compiles the canonical editable bracket, lists its semantic model nodes, draws a
+simple canvas wireframe from public display-mesh records, reports mesh counts, and
+downloads an AP242 STEP file.
+
+The sample intentionally uses only the public Web SDK contract. Firmament and the
+returned `ModelSession` remain authoritative; the canvas is just a projection.
+
+## Run
+
+The package dependency points at the locally packed preview tarball under
+`artifacts/local/helios-sdk/` so this checkout can test the exact release candidate.
+
+```powershell
+cd samples/web-sdk-pocket-view
+npm install
+npm run dev
+```
+
+Open the URL printed by Vite. Runtime assets are copied and served by the public
+`aetherisCad()` Vite plugin.
+
+## Check
+
+```powershell
+npm run check
+```
+
+This type-checks the frontend against the shipped declarations and performs a
+production Vite build, including the canonical fixture import and runtime assets.
+
+The X1 package is AGPL-3.0-only. See `docs/public/web-sdk/` for capabilities,
+limitations, and integration guidance.
diff --git a/samples/web-sdk-pocket-view/index.html b/samples/web-sdk-pocket-view/index.html
new file mode 100644
index 00000000..7e8b775c
--- /dev/null
+++ b/samples/web-sdk-pocket-view/index.html
@@ -0,0 +1,34 @@
+<!doctype html>
+<html lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <title>Aetheris Pocket View</title>
+ </head>
+ <body>
+ <main>
+ <header>
+ <div>
+ <p class="eyebrow">@aetheris/cad external consumer</p>
+ <h1>Pocket View</h1>
+ </div>
+ <button id="export" type="button" disabled>Export STEP</button>
+ </header>
+
+ <p id="status" role="status">Starting the Aetheris runtime…</p>
+
+ <section class="layout" aria-live="polite">
+ <article>
+ <h2>Mesh projection</h2>
+ <canvas id="viewport" width="720" height="440" aria-label="Wireframe projection of the compiled bracket"></canvas>
+ <dl id="mesh-summary"></dl>
+ </article>
+ <article>
+ <h2>Semantic nodes</h2>
+ <ol id="semantic-tree"></ol>
+ </article>
+ </section>
+ </main>
+ <script type="module" src="/src/main.ts"></script>
+ </body>
+</html>
diff --git a/samples/web-sdk-pocket-view/package-lock.json b/samples/web-sdk-pocket-view/package-lock.json
new file mode 100644
index 00000000..10946e8c
--- /dev/null
+++ b/samples/web-sdk-pocket-view/package-lock.json
@@ -0,0 +1,1209 @@
+{
+ "name": "aetheris-web-sdk-pocket-view",
+ "version": "0.1.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "aetheris-web-sdk-pocket-view",
+ "version": "0.1.0",
+ "dependencies": {
+ "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz"
+ },
+ "devDependencies": {
+ "@types/node": "^24.3.1",
+ "typescript": "^5.9.2",
+ "vite": "^7.1.5"
+ }
+ },
+ "node_modules/@aetheris/cad": {
+ "version": "2.0.0-preview.3",
+ "resolved": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz",
+ "integrity": "sha512-wuLetfhvqZLflQaWyL410pVMiOuNMKfXMBsdIkBV0bn5/u7GSFUBh70XtYEr5+RtnCdj5qCJIUK7fZJ7YJIQnw==",
+ "license": "AGPL-3.0-only",
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@esbuild/aix-ppc64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
+ "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
+ "cpu": [
+ "ppc64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "aix"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/android-arm": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
+ "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/android-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
+ "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/android-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
+ "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/darwin-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
+ "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/darwin-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
+ "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/freebsd-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
+ "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/freebsd-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
+ "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-arm": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
+ "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
+ "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-ia32": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
+ "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
+ "cpu": [
+ "ia32"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-loong64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
+ "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
+ "cpu": [
+ "loong64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-mips64el": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
+ "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
+ "cpu": [
+ "mips64el"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-ppc64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
+ "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
+ "cpu": [
+ "ppc64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-riscv64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
+ "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
+ "cpu": [
+ "riscv64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-s390x": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
+ "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
+ "cpu": [
+ "s390x"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
+ "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/netbsd-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
+ "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "netbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/netbsd-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
+ "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "netbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/openbsd-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
+ "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/openbsd-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
+ "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/openharmony-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
+ "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openharmony"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/sunos-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
+ "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "sunos"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/win32-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
+ "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/win32-ia32": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
+ "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
+ "cpu": [
+ "ia32"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/win32-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
+ "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@napi-rs/lzma-linux-x64-gnu": {
+ "version": "1.5.1",
+ "resolved": "https://registry.npmjs.org/@napi-rs/lzma-linux-x64-gnu/-/lzma-linux-x64-gnu-1.5.1.tgz",
+ "integrity": "sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^22.20 || ^24.12 || >=25"
+ }
+ },
+ "node_modules/@rollup/rollup-android-arm-eabi": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.63.3.tgz",
+ "integrity": "sha512-w3Jnvi1ocaVm/c7yVPpfB98XeSRBMyzp6njL5MVVbGyXjpmUkN+s6Hp4t0PqhGCCaI1ZHMKXt/w0lA1RCaLVcw==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ]
+ },
+ "node_modules/@rollup/rollup-android-arm64": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.63.3.tgz",
+ "integrity": "sha512-uI/ESiaIbbRYAEhzy8PCUWDp1hB0bjAqM06mW9flOoNO4Q8DQpeoREhBR5Hegfl+wpXiguyJv6XSPzEN7OxyHQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ]
+ },
+ "node_modules/@rollup/rollup-darwin-arm64": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.63.3.tgz",
+ "integrity": "sha512-oxhrd1jmXLwWZ83eQYDXxuqRdkqkzrjR3JobKeuUyfdNZo11FuQIvqEOZhyIT7OBHxXoGslDDjN0cQcM6T0TqQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@rollup/rollup-darwin-x64": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.63.3.tgz",
+ "integrity": "sha512-7/YiIMghVE8DrxKvNdorAaJVdriOFgOIpdStnPx8ppx5zfTwC3jBCSEAIzB7JD5404m65THl6H93UTTVUvypmg==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@rollup/rollup-freebsd-arm64": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.63.3.tgz",
+ "integrity": "sha512-GXFZRRoMAytaI5z6N3Zhfw0WL18Q0M8r95D5hlC4GqE/lGk8pbSJNUBoOWDfbm6dTciqHj2nU87tI5f6XhQiOg==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ]
+ },
+ "node_modules/@rollup/rollup-freebsd-x64": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.63.3.tgz",
+ "integrity": "sha512-77W+8X3ddYgPxUpB8nZFQs2Mq+wc4HVlcSRtApXLjYBcnPMkttrSnU8VwKQjeWYhMsITHFs5cWBQ8vz1Q+5RHQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.63.3.tgz",
+ "integrity": "sha512-FVkwK+iUC+mq+GipVK46rRVticfAPtvPUNlqlGXUDxdVk/UGjQiiiUVPUrEXdSpU2ufU0XxLGyTqDtBidDOVmg==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.63.3.tgz",
+ "integrity": "sha512-+aGU1t3398yQOVj1Bz8o3e+KtswxAPvO+mtxtNdfXYMkXIHu7XhhkCD7/DEH9q8tF8uhDnMWvfpUKI8y1sZJsg==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-arm64-gnu": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.63.3.tgz",
+ "integrity": "sha512-cR0kjpRXR2KJ2oQK8E2KTPtphs+b9hZ8IhTZubNryt/RsqgdOZBQ2Zq0q5UedtiIi0rs3jVhJh55RE1ZHUVGUA==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-arm64-musl": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.63.3.tgz",
+ "integrity": "sha512-y1RYi4Q3/9ByVWSSt9kX2ustE0B7kFYbJ6zZdVZVyqopZs3yhCTwRfrjIX4vezUJInma/Gs6BOFDJg7yZmJ0IQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-loong64-gnu": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.63.3.tgz",
+ "integrity": "sha512-DNhEA5viIj3Z5bZLE4z4oV8N5ozWqDwyt7T6KG7VdLDJ0nW+rNOYlphBl4/3HQkK75qipPLsVOfStHHOwN9WSg==",
+ "cpu": [
+ "loong64"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-loong64-musl": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.63.3.tgz",
+ "integrity": "sha512-17gQCqrIpXBX2Cmi9/TygnVOqGbzsba/iaqcYSL8FY7lNugg+7AiYNs5c5nKWD+NRQha36Sa0CqkJqH4XVHwnQ==",
+ "cpu": [
+ "loong64"
+ ],
+ "dev": true,
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.63.3.tgz",
+ "integrity": "sha512-6LwVnZRIyINpdku/yOcI8Tm9YqLmhHK5emmlOOnW9tO0SYEm1FmKPcsSAGp0NBlqR2P04xaND4jvN6sTHqhq8A==",
+ "cpu": [
+ "ppc64"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-ppc64-musl": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.63.3.tgz",
+ "integrity": "sha512-xMUqkTXlEUtI/p5AAukMwBRr1enU3efsTeF+bskeFfk8t1C9rcC8sLREcZXmTfAXEbvRdJVSonVJez3TMlbR3w==",
+ "cpu": [
+ "ppc64"
+ ],
+ "dev": true,
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.63.3.tgz",
+ "integrity": "sha512-S3E94co9F9WRRqEaUoQZ38K1gCz6KiM+nL7/3ijq7fDGF3OznjS5TasgYITlvl27GQKtu4lOAOsr5MFwkijvOA==",
+ "cpu": [
+ "riscv64"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-riscv64-musl": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.63.3.tgz",
+ "integrity": "sha512-1QtRDwG42x5BJI3s9mxu5rEjDnfbSnk20HQ9/ylTAYnSwYwxMVb+Vgu34wzzTQ7ogqBybebgQNUDAvZVQ38DbA==",
+ "cpu": [
+ "riscv64"
+ ],
+ "dev": true,
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-s390x-gnu": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.63.3.tgz",
+ "integrity": "sha512-BQhejF6ZXOpxbngiNTP12GCGQeaDVL2QXGeBVViKIYzFHM5RKxTxwUMB1fr1BeNFphFMpnRqC5QSXFSa4z6UQw==",
+ "cpu": [
+ "s390x"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-x64-gnu": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.63.3.tgz",
+ "integrity": "sha512-SXagRwnI2Wlwlitllu59UK/nGVbD1CKPcNqDplHwIC4BqJcpXFjD32d1R/RbuISa95HdQrZM3/7v4bKiowFaLA==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-linux-x64-musl": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.63.3.tgz",
+ "integrity": "sha512-2IPozoEALRCziGqE8O9KMK60PMu5TS1huv4fwoeCexj+WjmcwFtX9CTOVbfXCUqcELAubEwRFPYlzb/WvwY2HQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@rollup/rollup-openbsd-x64": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.63.3.tgz",
+ "integrity": "sha512-AoxqosUHT9IX54hFn2TiN6A7d6ZKTtE6pd2bqWtqkkNJ6HJGaU6FRouGX8L1O7R/ZwsnCnpQrHzb4pDEx+UHRQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openbsd"
+ ]
+ },
+ "node_modules/@rollup/rollup-openharmony-arm64": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.63.3.tgz",
+ "integrity": "sha512-d+CaftKgmkFBzCwezMqqy1d0QNNYugqLCMcYVQWBy5SS2YfeMP8Q8ripkgx9O8IyBXXLHrJ+aaCV4U96usv6Yg==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openharmony"
+ ]
+ },
+ "node_modules/@rollup/rollup-win32-arm64-msvc": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.63.3.tgz",
+ "integrity": "sha512-xXlDF6nR1eOuXbdDy5Hl5fmtY7teUDevF/k0O7IPoZe4Tpmdv+lgdE5JRsnhQtt37ql9P0VF2kAN9a0OCZdo+Q==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@rollup/rollup-win32-ia32-msvc": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.63.3.tgz",
+ "integrity": "sha512-YtXAgLN+JP7Ay6qG3eWhc7IHMQPzLc8r3uvhAvlJIoCz/4Q32+Bl9Fmnywidh8v1GOIMmymjovfqY9ETAtysvA==",
+ "cpu": [
+ "ia32"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@rollup/rollup-win32-x64-gnu": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.63.3.tgz",
+ "integrity": "sha512-WuWtSJRNo549vzcfZyEgfqb6zeSgn1F+UE5kQ+BCjzz0W4MGCjntUHkZVc1VRuAM7+ULaSyhiPxD1spyewFvkQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@rollup/rollup-win32-x64-msvc": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.63.3.tgz",
+ "integrity": "sha512-+lIKX7O0+IGe7WuhATaAMMeT7B76vfhXH/l9wLQL+nvyhbw2ohYCKIdWL56JfDu75CWt5oKRP4QFH/jkMtBquA==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@types/estree": {
+ "version": "1.0.9",
+ "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+ "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@types/node": {
+ "version": "24.13.5",
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.5.tgz",
+ "integrity": "sha512-TXyindR+lBr22aJIdMQzCFHPHR6cR4js838mRDCSz5hOKWZvZwsXSSiXDmjRj4iJmgl+sR9O+1mkoVBSMadNug==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "undici-types": "~7.18.0"
+ }
+ },
+ "node_modules/esbuild": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz",
+ "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
+ "dev": true,
+ "hasInstallScript": true,
+ "license": "MIT",
+ "bin": {
+ "esbuild": "bin/esbuild"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "optionalDependencies": {
+ "@esbuild/aix-ppc64": "0.28.2",
+ "@esbuild/android-arm": "0.28.2",
+ "@esbuild/android-arm64": "0.28.2",
+ "@esbuild/android-x64": "0.28.2",
+ "@esbuild/darwin-arm64": "0.28.2",
+ "@esbuild/darwin-x64": "0.28.2",
+ "@esbuild/freebsd-arm64": "0.28.2",
+ "@esbuild/freebsd-x64": "0.28.2",
+ "@esbuild/linux-arm": "0.28.2",
+ "@esbuild/linux-arm64": "0.28.2",
+ "@esbuild/linux-ia32": "0.28.2",
+ "@esbuild/linux-loong64": "0.28.2",
+ "@esbuild/linux-mips64el": "0.28.2",
+ "@esbuild/linux-ppc64": "0.28.2",
+ "@esbuild/linux-riscv64": "0.28.2",
+ "@esbuild/linux-s390x": "0.28.2",
+ "@esbuild/linux-x64": "0.28.2",
+ "@esbuild/netbsd-arm64": "0.28.2",
+ "@esbuild/netbsd-x64": "0.28.2",
+ "@esbuild/openbsd-arm64": "0.28.2",
+ "@esbuild/openbsd-x64": "0.28.2",
+ "@esbuild/openharmony-arm64": "0.28.2",
+ "@esbuild/sunos-x64": "0.28.2",
+ "@esbuild/win32-arm64": "0.28.2",
+ "@esbuild/win32-ia32": "0.28.2",
+ "@esbuild/win32-x64": "0.28.2"
+ }
+ },
+ "node_modules/fdir": {
+ "version": "6.5.0",
+ "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+ "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12.0.0"
+ },
+ "peerDependencies": {
+ "picomatch": "^3 || ^4"
+ },
+ "peerDependenciesMeta": {
+ "picomatch": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/fsevents": {
+ "version": "2.3.3",
+ "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+ "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+ "dev": true,
+ "hasInstallScript": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+ }
+ },
+ "node_modules/nanoid": {
+ "version": "3.3.19",
+ "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.19.tgz",
+ "integrity": "sha512-Y2tUNy4ouw6tq5oDSKeQYGOyhkUBhNOcGV/02KC+6kd9eDGqdZd++mjMiIDilrBYvjEnCYvVtsuHCuP+okSfug==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "bin": {
+ "nanoid": "bin/nanoid.cjs"
+ },
+ "engines": {
+ "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+ }
+ },
+ "node_modules/picocolors": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/picomatch": {
+ "version": "4.0.7",
+ "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
+ "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/jonschlinkert"
+ }
+ },
+ "node_modules/postcss": {
+ "version": "8.5.28",
+ "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.28.tgz",
+ "integrity": "sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/postcss/"
+ },
+ {
+ "type": "tidelift",
+ "url": "https://tidelift.com/funding/github/npm/postcss"
+ },
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "nanoid": "^3.3.18",
+ "picocolors": "^1.1.1",
+ "source-map-js": "^1.2.1"
+ },
+ "engines": {
+ "node": "^10 || ^12 || >=14"
+ }
+ },
+ "node_modules/rollup": {
+ "version": "4.63.3",
+ "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.63.3.tgz",
+ "integrity": "sha512-1i2XreiAoMMXuPGD6Msj2xWrMMkHojNRKivInxGQcg7/1KuPuYlfUutLyh4drnOxUTHX9cHI4wFoat8D/NKaBw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "1.0.9"
+ },
+ "bin": {
+ "rollup": "dist/bin/rollup"
+ },
+ "engines": {
+ "node": ">=18.0.0",
+ "npm": ">=8.0.0"
+ },
+ "optionalDependencies": {
+ "@napi-rs/lzma-linux-x64-gnu": "1.5.1",
+ "@rollup/rollup-android-arm-eabi": "4.63.3",
+ "@rollup/rollup-android-arm64": "4.63.3",
+ "@rollup/rollup-darwin-arm64": "4.63.3",
+ "@rollup/rollup-darwin-x64": "4.63.3",
+ "@rollup/rollup-freebsd-arm64": "4.63.3",
+ "@rollup/rollup-freebsd-x64": "4.63.3",
+ "@rollup/rollup-linux-arm-gnueabihf": "4.63.3",
+ "@rollup/rollup-linux-arm-musleabihf": "4.63.3",
+ "@rollup/rollup-linux-arm64-gnu": "4.63.3",
+ "@rollup/rollup-linux-arm64-musl": "4.63.3",
+ "@rollup/rollup-linux-loong64-gnu": "4.63.3",
+ "@rollup/rollup-linux-loong64-musl": "4.63.3",
+ "@rollup/rollup-linux-ppc64-gnu": "4.63.3",
+ "@rollup/rollup-linux-ppc64-musl": "4.63.3",
+ "@rollup/rollup-linux-riscv64-gnu": "4.63.3",
+ "@rollup/rollup-linux-riscv64-musl": "4.63.3",
+ "@rollup/rollup-linux-s390x-gnu": "4.63.3",
+ "@rollup/rollup-linux-x64-gnu": "4.63.3",
+ "@rollup/rollup-linux-x64-musl": "4.63.3",
+ "@rollup/rollup-openbsd-x64": "4.63.3",
+ "@rollup/rollup-openharmony-arm64": "4.63.3",
+ "@rollup/rollup-win32-arm64-msvc": "4.63.3",
+ "@rollup/rollup-win32-ia32-msvc": "4.63.3",
+ "@rollup/rollup-win32-x64-gnu": "4.63.3",
+ "@rollup/rollup-win32-x64-msvc": "4.63.3",
+ "fsevents": "~2.3.2"
+ }
+ },
+ "node_modules/source-map-js": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+ "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+ "dev": true,
+ "license": "BSD-3-Clause",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/tinyglobby": {
+ "version": "0.2.17",
+ "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+ "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "fdir": "^6.5.0",
+ "picomatch": "^4.0.4"
+ },
+ "engines": {
+ "node": ">=12.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/SuperchupuDev"
+ }
+ },
+ "node_modules/typescript": {
+ "version": "5.9.3",
+ "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+ "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "bin": {
+ "tsc": "bin/tsc",
+ "tsserver": "bin/tsserver"
+ },
+ "engines": {
+ "node": ">=14.17"
+ }
+ },
+ "node_modules/undici-types": {
+ "version": "7.18.2",
+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz",
+ "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/vite": {
+ "version": "7.3.6",
+ "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.6.tgz",
+ "integrity": "sha512-4XP60spRGjSZFf1qYH+dJIkK2znL3zQfl9KkOV9MkkRR/3Dls0dxaBsQPTloEc5BLXWPL9vsOxopxyKoMmDueg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "esbuild": "^0.27.0 || ^0.28.0",
+ "fdir": "^6.5.0",
+ "picomatch": "^4.0.3",
+ "postcss": "^8.5.6",
+ "rollup": "^4.43.0",
+ "tinyglobby": "^0.2.15"
+ },
+ "bin": {
+ "vite": "bin/vite.js"
+ },
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ },
+ "funding": {
+ "url": "https://github.com/vitejs/vite?sponsor=1"
+ },
+ "optionalDependencies": {
+ "fsevents": "~2.3.3"
+ },
+ "peerDependencies": {
+ "@types/node": "^20.19.0 || >=22.12.0",
+ "jiti": ">=1.21.0",
+ "less": "^4.0.0",
+ "lightningcss": "^1.21.0",
+ "sass": "^1.70.0",
+ "sass-embedded": "^1.70.0",
+ "stylus": ">=0.54.8",
+ "sugarss": "^5.0.0",
+ "terser": "^5.16.0",
+ "tsx": "^4.8.1",
+ "yaml": "^2.4.2"
+ },
+ "peerDependenciesMeta": {
+ "@types/node": {
+ "optional": true
+ },
+ "jiti": {
+ "optional": true
+ },
+ "less": {
+ "optional": true
+ },
+ "lightningcss": {
+ "optional": true
+ },
+ "sass": {
+ "optional": true
+ },
+ "sass-embedded": {
+ "optional": true
+ },
+ "stylus": {
+ "optional": true
+ },
+ "sugarss": {
+ "optional": true
+ },
+ "terser": {
+ "optional": true
+ },
+ "tsx": {
+ "optional": true
+ },
+ "yaml": {
+ "optional": true
+ }
+ }
+ }
+ }
+}
diff --git a/samples/web-sdk-pocket-view/package.json b/samples/web-sdk-pocket-view/package.json
new file mode 100644
index 00000000..24c6f88d
--- /dev/null
+++ b/samples/web-sdk-pocket-view/package.json
@@ -0,0 +1,19 @@
+{
+ "name": "aetheris-web-sdk-pocket-view",
+ "private": true,
+ "version": "0.1.0",
+ "type": "module",
+ "scripts": {
+ "dev": "vite",
+ "build": "tsc --noEmit && vite build",
+ "check": "npm run build"
+ },
+ "dependencies": {
+ "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz"
+ },
+ "devDependencies": {
+ "@types/node": "^24.3.1",
+ "typescript": "^5.9.2",
+ "vite": "^7.1.5"
+ }
+}
diff --git a/samples/web-sdk-pocket-view/src/main.ts b/samples/web-sdk-pocket-view/src/main.ts
new file mode 100644
index 00000000..3231a659
--- /dev/null
+++ b/samples/web-sdk-pocket-view/src/main.ts
@@ -0,0 +1,178 @@
+import { Aetheris, type DisplayMesh, type ModelSession, type ModelTree } from "@aetheris/cad";
+import bracketSource from "../../../fixtures/Canonical/WebSdk/editable-bracket.firmament?raw";
+import "./styles.css";
+
+const status = requiredElement<HTMLParagraphElement>("status");
+const exportButton = requiredElement<HTMLButtonElement>("export");
+const treeElement = requiredElement<HTMLOListElement>("semantic-tree");
+const summaryElement = requiredElement<HTMLDListElement>("mesh-summary");
+const canvas = requiredElement<HTMLCanvasElement>("viewport");
+
+let cad: Aetheris | undefined;
+let model: ModelSession | undefined;
+
+void start();
+
+async function start(): Promise<void> {
+ try {
+ cad = await Aetheris.create();
+ const result = await cad.compile(bracketSource, { sourceName: "editable-bracket.firmament" });
+ if (!result.model) {
+ throw new Error(result.diagnostics.map((item) => `${item.code}: ${item.message}`).join("\n"));
+ }
+
+ model = result.model;
+ renderSemanticTree(model.tree);
+ renderMesh(model.mesh);
+ renderSummary(model.mesh);
+ status.textContent = `Compiled ${model.name} at revision ${model.revision}.`;
+ exportButton.disabled = false;
+ } catch (error) {
+ status.classList.add("error");
+ status.textContent = error instanceof Error ? error.message : String(error);
+ }
+}
+
+exportButton.addEventListener("click", async () => {
+ if (!model) return;
+ exportButton.disabled = true;
+ status.textContent = "Generating AP242 STEP…";
+ try {
+ const blob = await model.exportSTEPBlob();
+ const url = URL.createObjectURL(blob);
+ const link = document.createElement("a");
+ link.href = url;
+ link.download = "web-bracket.step";
+ link.click();
+ URL.revokeObjectURL(url);
+ status.textContent = `Exported ${blob.size.toLocaleString()} STEP bytes.`;
+ } catch (error) {
+ status.classList.add("error");
+ status.textContent = error instanceof Error ? error.message : String(error);
+ } finally {
+ exportButton.disabled = false;
+ }
+});
+
+window.addEventListener("beforeunload", () => {
+ void model?.dispose();
+ void cad?.dispose();
+});
+
+function renderSemanticTree(tree: ModelTree): void {
+ const nodes = new Map(tree.nodes.map((node) => [node.id, node]));
+ const seen = new Set<string>();
+
+ const append = (id: string, depth: number): void => {
+ const node = nodes.get(id);
+ if (!node || seen.has(id)) return;
+ seen.add(id);
+ const item = document.createElement("li");
+ item.style.paddingLeft = `${depth * 18}px`;
+ item.append(node.name, " ");
+ const kind = document.createElement("small");
+ kind.textContent = node.kind;
+ item.append(kind);
+ treeElement.append(item);
+ node.children.forEach((childId) => append(childId, depth + 1));
+ };
+
+ append(tree.rootId, 0);
+ tree.nodes.forEach((node) => append(node.id, 0));
+}
+
+function renderSummary(mesh: DisplayMesh): void {
+ const vertices = mesh.definitions.reduce((sum, definition) => sum + definition.positions.length / 3, 0);
+ const triangles = mesh.definitions.reduce((sum, definition) => sum + definition.indices.length / 3, 0);
+ const values = [
+ ["Definitions", mesh.definitions.length],
+ ["Occurrences", mesh.occurrences.length],
+ ["Vertices", vertices],
+ ["Triangles", triangles],
+ ] as const;
+
+ for (const [label, value] of values) {
+ const group = document.createElement("div");
+ const term = document.createElement("dt");
+ term.textContent = label;
+ const description = document.createElement("dd");
+ description.textContent = value.toLocaleString();
+ group.append(term, description);
+ summaryElement.append(group);
+ }
+}
+
+function renderMesh(mesh: DisplayMesh): void {
+ const context = canvas.getContext("2d");
+ if (!context) throw new Error("2D canvas is unavailable.");
+
+ const definitions = new Map(mesh.definitions.map((definition) => [definition.id, definition]));
+ const lines: Array<readonly [Point2, Point2]> = [];
+ for (const occurrence of mesh.occurrences) {
+ if (!occurrence.definitionId) continue;
+ const definition = definitions.get(occurrence.definitionId);
+ if (!definition) continue;
+ for (let index = 0; index < definition.indices.length; index += 3) {
+ const a = project(transform(readPoint(definition.positions, definition.indices[index]), occurrence.transform));
+ const b = project(transform(readPoint(definition.positions, definition.indices[index + 1]), occurrence.transform));
+ const c = project(transform(readPoint(definition.positions, definition.indices[index + 2]), occurrence.transform));
+ lines.push([a, b], [b, c], [c, a]);
+ }
+ }
+
+ context.clearRect(0, 0, canvas.width, canvas.height);
+ if (lines.length === 0) return;
+ const points = lines.flat();
+ const minX = Math.min(...points.map((point) => point.x));
+ const maxX = Math.max(...points.map((point) => point.x));
+ const minY = Math.min(...points.map((point) => point.y));
+ const maxY = Math.max(...points.map((point) => point.y));
+ const margin = 36;
+ const scale = Math.min(
+ (canvas.width - margin * 2) / Math.max(maxX - minX, 1),
+ (canvas.height - margin * 2) / Math.max(maxY - minY, 1),
+ );
+ const draw = (point: Point2): Point2 => ({
+ x: margin + (point.x - minX) * scale,
+ y: canvas.height - margin - (point.y - minY) * scale,
+ });
+
+ context.beginPath();
+ for (const [start, end] of lines) {
+ const from = draw(start);
+ const to = draw(end);
+ context.moveTo(from.x, from.y);
+ context.lineTo(to.x, to.y);
+ }
+ context.strokeStyle = "#75d9c7";
+ context.lineWidth = 0.65;
+ context.globalAlpha = 0.55;
+ context.stroke();
+ context.globalAlpha = 1;
+}
+
+interface Point { readonly x: number; readonly y: number; readonly z: number }
+interface Point2 { readonly x: number; readonly y: number }
+
+function readPoint(positions: Float64Array, index: number): Point {
+ const offset = index * 3;
+ return { x: positions[offset], y: positions[offset + 1], z: positions[offset + 2] };
+}
+
+function transform(point: Point, matrix: readonly number[]): Point {
+ return {
+ x: matrix[0] * point.x + matrix[4] * point.y + matrix[8] * point.z + matrix[12],
+ y: matrix[1] * point.x + matrix[5] * point.y + matrix[9] * point.z + matrix[13],
+ z: matrix[2] * point.x + matrix[6] * point.y + matrix[10] * point.z + matrix[14],
+ };
+}
+
+function project(point: Point): Point2 {
+ return { x: point.x - point.z * 0.65, y: point.y + point.z * 0.42 };
+}
+
+function requiredElement<T extends HTMLElement>(id: string): T {
+ const element = document.getElementById(id);
+ if (!element) throw new Error(`Missing #${id}.`);
+ return element as T;
+}
diff --git a/samples/web-sdk-pocket-view/src/styles.css b/samples/web-sdk-pocket-view/src/styles.css
new file mode 100644
index 00000000..a413b4d2
--- /dev/null
+++ b/samples/web-sdk-pocket-view/src/styles.css
@@ -0,0 +1,71 @@
+:root {
+ color: #e8edf4;
+ background: #111820;
+ font-family: ui-monospace, "Cascadia Code", monospace;
+ font-synthesis: none;
+}
+
+* { box-sizing: border-box; }
+
+body { margin: 0; }
+
+main {
+ width: min(1080px, calc(100% - 32px));
+ margin: 0 auto;
+ padding: 32px 0;
+}
+
+header {
+ display: flex;
+ align-items: end;
+ justify-content: space-between;
+ gap: 24px;
+ margin-bottom: 20px;
+}
+
+h1, h2, p { margin-top: 0; }
+h1 { margin-bottom: 0; font-size: clamp(2rem, 7vw, 4.5rem); letter-spacing: -0.07em; }
+h2 { font-size: 0.9rem; letter-spacing: 0.12em; text-transform: uppercase; color: #92a4b8; }
+.eyebrow { margin-bottom: 6px; color: #75d9c7; font-size: 0.78rem; }
+
+button {
+ border: 1px solid #75d9c7;
+ border-radius: 4px;
+ padding: 10px 14px;
+ color: #111820;
+ background: #75d9c7;
+ font: inherit;
+ cursor: pointer;
+}
+
+button:disabled { opacity: 0.4; cursor: wait; }
+#status { color: #a9b7c7; min-height: 1.5em; }
+#status.error { color: #ff8c8c; white-space: pre-wrap; }
+
+.layout {
+ display: grid;
+ grid-template-columns: minmax(0, 2fr) minmax(260px, 1fr);
+ gap: 18px;
+}
+
+article {
+ min-width: 0;
+ padding: 18px;
+ border: 1px solid #2c3947;
+ background: #17212b;
+}
+
+canvas { display: block; width: 100%; height: auto; background: #0b1117; }
+
+dl { display: grid; grid-template-columns: repeat(4, 1fr); gap: 8px; margin: 14px 0 0; }
+dt { color: #7e91a4; font-size: 0.7rem; text-transform: uppercase; }
+dd { margin: 3px 0 0; font-size: 1.15rem; }
+
+ol { list-style: none; margin: 0; padding: 0; }
+li { padding: 7px 0; border-bottom: 1px solid #263544; }
+li small { color: #8193a7; }
+
+@media (max-width: 760px) {
+ .layout { grid-template-columns: 1fr; }
+ dl { grid-template-columns: repeat(2, 1fr); }
+}
diff --git a/samples/web-sdk-pocket-view/tsconfig.json b/samples/web-sdk-pocket-view/tsconfig.json
new file mode 100644
index 00000000..9951c60f
--- /dev/null
+++ b/samples/web-sdk-pocket-view/tsconfig.json
@@ -0,0 +1,13 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "useDefineForClassFields": true,
+ "module": "ESNext",
+ "moduleResolution": "Bundler",
+ "strict": true,
+ "noEmit": true,
+ "lib": ["ESNext", "DOM", "DOM.Iterable"],
+ "types": ["vite/client", "node"]
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/samples/web-sdk-pocket-view/vite.config.ts b/samples/web-sdk-pocket-view/vite.config.ts
new file mode 100644
index 00000000..a986fa45
--- /dev/null
+++ b/samples/web-sdk-pocket-view/vite.config.ts
@@ -0,0 +1,6 @@
+import { defineConfig } from "vite";
+import { aetherisCad } from "@aetheris/cad/vite";
+
+export default defineConfig({
+ plugins: [aetherisCad()],
+});