{"owner":"xiangechen","repo":"chili3d","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Chili3D coding guidelines\n\n## Build & Test\n\n```bash\nnpm run dev            # Rspack dev server → localhost:8080\nnpm run build          # Production build (Rspack + SWC)\nnpm run test           # All tests (Rstest + Happy-DOM); npm run testc = with coverage\nnpm run check          # Biome lint + auto-fix (run before commits)\nnpm run format         # Biome + clang-format across all files\nnpm run build:wasm     # C++ → WebAssembly (CMake + Emscripten); setup:wasm = one-time deps\n\nnpx rstest packages/core/test/result.test.ts   # single file\nnpx rstest -t \"should handle error case\"       # filter by name\n```\n\n## Monorepo Structure\n\nBrowser-based parametric 3D CAD: OCCT C++ kernel compiled to WebAssembly, rendered with Three.js. npm workspace under `packages/`:\n\n```\nweb ──> builder ──> app ──> core\n                  ──> i18n / three / wasm ──> core\n                  ──> ui ──> core + element\n```\n\n- **`core`** — Everything abstract: shape interfaces, math, document model, reactive data (`Observable`, `Binding`, `PubSub`), `Result<T,E>`, undo, commands, serialization, plugins, services, UI abstractions\n- **`wasm`** — Concrete `ShapeFactory` → OCCT via Emscripten; exports `initWasm()`\n- **`three`** — Three.js viewport, camera controller, visuals, highlighter, gizmo, mesh export\n- **`element`** — Custom reactive DOM elements (radio groups, expanders, data converters)\n- **`ui`** — App chrome: main window, ribbon, property panels, project tree, dialogs, toast, status bar\n- **`app`** — `Application`, body nodes (`bodys/`), command implementations, `CommandService`, `HotkeyService`\n- **`builder`** — `AppBuilder` fluent chain (`.useIndexedDB().useWasmOcc().useThree().useUI().build()`), default ribbon layout\n- **`i18n`** / **`storage`** / **`web`** — Locale data (en, zh-cn, pt-br) / IndexedDB persistence / entry point (loading screen, `?plugin=`/`?url=`/`?model=` params)\n\nImport via workspace names (`import { ... } from \"@chili3d/core\"`); one root `tsconfig.json` covers all packages.\n\n## C++ WASM (`cpp/`)\n\nOCCT v8.0.0 → `chili-wasm.wasm` via Emscripten. `cpp/src/`: `factory.cpp` (shape creation), `shape.cpp` (topology traversal), `converter.cpp` (STEP/IGES/BREP/STL), `mesher.cpp` (B-rep → mesh), `geometry.cpp` (curve/surface queries). Output: `packages/wasm/lib/chili-wasm.{wasm,js,d.ts}`. C++ style: WebKit (clang-format); license LGPL-3.0 (TS is AGPL-3.0).\n\n## Key Patterns\n\n- **Interface-driven** — `core` defines interfaces; feature packages implement; `AppBuilder` wires at startup.\n- **Result pattern** — Fallible ops return `Result.ok(value)` / `Result.err(error)` (`core/src/foundation/result.ts`); never throw for expected failures.\n- **Reactive data** — `Observable` uses `getPrivateValue(key)` / `setPrivateValue(key, value)`; setting emits `emitPropertyChanged`. `ObservableCollection` powers property editor and project tree.\n- **Serialization** — `@serializable()` on classes, `@serialize()` on fields → `{ __cla$$__: \"ClassName\", ...props }`.\n- **Body nodes** — `app/src/bodys/`; extend `ParameterShapeNode`, implement `generateShape(): Result<IShape>`, `setPropertyEmitShapeChanged()` triggers re-evaluation.\n- **Commands** — `ICommand.execute(application): Promise<void>`; `CancelableCommand` adds `cancel()`, `AsyncController`, dispose stack.\n- **Undo/redo** — `Transaction` records snapshots, `History` keeps the stack; commands create transactions automatically.\n- **Plugins** — Loaded from URLs or `?plugin=`; manager in `core/src/plugin/` + `app/src/pluginManager.ts`; examples in `plugins/`.\n- **Global singleton** — `getCurrentApplication()` (from `core`) instead of DI threading.\n- **MCP server** (`packages/mcp/`) — `live_*` tools drive the user's open browser tab; headless tools (`run_cad_program`, `render_preview`, etc.) are a server-side scratchpad. Units: millimetres; angles: degrees.\n\n## Testing\n\n- Rstest (not Jest/Vitest) + Happy-DOM; root `rstest.config.ts`, globals enabled (`describe`, `test`, `expect`); tests in `packages/*/test/`; legacy decorators enabled.\n- Reuse shared mocks from `@chili3d/core/test-utils` (`TestDocument`, `createMockDocument`, `createMockApplication`, `createMockVisual`, ...) instead of per-package copies; package-specific facades (e.g. `packages/ui/test/_helpers/`) extend them. `initializeI18n()` runs automatically via rstest `setupFiles` — never call it in test files.\n- Assertions must execute: none hidden in event callbacks (unless the callback is also asserted to fire), no tautologies (`x === true || x === false`), no `if (x) expect(...)` — assert the precondition, then the behavior; `await` every promise whose `.then` asserts.\n- Assert behavior, not absence of crashes: bare `not.toThrow()` / `toBeDefined()` is a smell; `querySelector` results need `not.toBeNull()`.\n- Restore global monkeypatches (`PubSub.default.pub`, `globalThis.fetch`, ...) in `finally`/`afterEach`, or use `rs.stubGlobal` + `rs.unstubAllGlobals()`.\n- Type `rs.fn` mocks with the real signature (`rs.fn((_edges: IEdge[]) => ...)`) so `mock.calls` typechecks; use `test.each` for near-identical repeated cases.\n\n## Code Style\n\n- Biome: 4-space indent, 110-col width, double quotes, semicolons always\n- `I`-prefixed interfaces; `camelCase` functions/variables/files; `PascalCase` classes; `UPPER_SNAKE_CASE` constants\n- CSS Modules (`*.module.css`); type-only imports (`import type { IFoo }`)\n- Every TS file starts with the AGPL-3.0 header:\n\n```ts\n// Part of the Chili3d Project, under the AGPL-3.0 License.\n// See LICENSE file in the project root for full license information.\n```\n\n## Git\n\nCommits: `<emoji> <type>(<scope>): <description>` — ✨ `feat` · 🐛 `fix` · ♻️ `refactor` · ✅ `test` · 📝 `docs` · 💄 `style` · 🔧 `chore`. Scope = package name. Active branch: `dev` → PR to `main`.\n"},"files":{"AGENTS.md":"# Chili3D coding guidelines\n\n## Build & Test\n\n```bash\nnpm run dev            # Rspack dev server → localhost:8080\nnpm run build          # Production build (Rspack + SWC)\nnpm run test           # All tests (Rstest + Happy-DOM); npm run testc = with coverage\nnpm run check          # Biome lint + auto-fix (run before commits)\nnpm run format         # Biome + clang-format across all files\nnpm run build:wasm     # C++ → WebAssembly (CMake + Emscripten); setup:wasm = one-time deps\n\nnpx rstest packages/core/test/result.test.ts   # single file\nnpx rstest -t \"should handle error case\"       # filter by name\n```\n\n## Monorepo Structure\n\nBrowser-based parametric 3D CAD: OCCT C++ kernel compiled to WebAssembly, rendered with Three.js. npm workspace under `packages/`:\n\n```\nweb ──> builder ──> app ──> core\n                  ──> i18n / three / wasm ──> core\n                  ──> ui ──> core + element\n```\n\n- **`core`** — Everything abstract: shape interfaces, math, document model, reactive data (`Observable`, `Binding`, `PubSub`), `Result<T,E>`, undo, commands, serialization, plugins, services, UI abstractions\n- **`wasm`** — Concrete `ShapeFactory` → OCCT via Emscripten; exports `initWasm()`\n- **`three`** — Three.js viewport, camera controller, visuals, highlighter, gizmo, mesh export\n- **`element`** — Custom reactive DOM elements (radio groups, expanders, data converters)\n- **`ui`** — App chrome: main window, ribbon, property panels, project tree, dialogs, toast, status bar\n- **`app`** — `Application`, body nodes (`bodys/`), command implementations, `CommandService`, `HotkeyService`\n- **`builder`** — `AppBuilder` fluent chain (`.useIndexedDB().useWasmOcc().useThree().useUI().build()`), default ribbon layout\n- **`i18n`** / **`storage`** / **`web`** — Locale data (en, zh-cn, pt-br) / IndexedDB persistence / entry point (loading screen, `?plugin=`/`?url=`/`?model=` params)\n\nImport via workspace names (`import { ... } from \"@chili3d/core\"`); one root `tsconfig.json` covers all packages.\n\n## C++ WASM (`cpp/`)\n\nOCCT v8.0.0 → `chili-wasm.wasm` via Emscripten. `cpp/src/`: `factory.cpp` (shape creation), `shape.cpp` (topology traversal), `converter.cpp` (STEP/IGES/BREP/STL), `mesher.cpp` (B-rep → mesh), `geometry.cpp` (curve/surface queries). Output: `packages/wasm/lib/chili-wasm.{wasm,js,d.ts}`. C++ style: WebKit (clang-format); license LGPL-3.0 (TS is AGPL-3.0).\n\n## Key Patterns\n\n- **Interface-driven** — `core` defines interfaces; feature packages implement; `AppBuilder` wires at startup.\n- **Result pattern** — Fallible ops return `Result.ok(value)` / `Result.err(error)` (`core/src/foundation/result.ts`); never throw for expected failures.\n- **Reactive data** — `Observable` uses `getPrivateValue(key)` / `setPrivateValue(key, value)`; setting emits `emitPropertyChanged`. `ObservableCollection` powers property editor and project tree.\n- **Serialization** — `@serializable()` on classes, `@serialize()` on fields → `{ __cla$$__: \"ClassName\", ...props }`.\n- **Body nodes** — `app/src/bodys/`; extend `ParameterShapeNode`, implement `generateShape(): Result<IShape>`, `setPropertyEmitShapeChanged()` triggers re-evaluation.\n- **Commands** — `ICommand.execute(application): Promise<void>`; `CancelableCommand` adds `cancel()`, `AsyncController`, dispose stack.\n- **Undo/redo** — `Transaction` records snapshots, `History` keeps the stack; commands create transactions automatically.\n- **Plugins** — Loaded from URLs or `?plugin=`; manager in `core/src/plugin/` + `app/src/pluginManager.ts`; examples in `plugins/`.\n- **Global singleton** — `getCurrentApplication()` (from `core`) instead of DI threading.\n- **MCP server** (`packages/mcp/`) — `live_*` tools drive the user's open browser tab; headless tools (`run_cad_program`, `render_preview`, etc.) are a server-side scratchpad. Units: millimetres; angles: degrees.\n\n## Testing\n\n- Rstest (not Jest/Vitest) + Happy-DOM; root `rstest.config.ts`, globals enabled (`describe`, `test`, `expect`); tests in `packages/*/test/`; legacy decorators enabled.\n- Reuse shared mocks from `@chili3d/core/test-utils` (`TestDocument`, `createMockDocument`, `createMockApplication`, `createMockVisual`, ...) instead of per-package copies; package-specific facades (e.g. `packages/ui/test/_helpers/`) extend them. `initializeI18n()` runs automatically via rstest `setupFiles` — never call it in test files.\n- Assertions must execute: none hidden in event callbacks (unless the callback is also asserted to fire), no tautologies (`x === true || x === false`), no `if (x) expect(...)` — assert the precondition, then the behavior; `await` every promise whose `.then` asserts.\n- Assert behavior, not absence of crashes: bare `not.toThrow()` / `toBeDefined()` is a smell; `querySelector` results need `not.toBeNull()`.\n- Restore global monkeypatches (`PubSub.default.pub`, `globalThis.fetch`, ...) in `finally`/`afterEach`, or use `rs.stubGlobal` + `rs.unstubAllGlobals()`.\n- Type `rs.fn` mocks with the real signature (`rs.fn((_edges: IEdge[]) => ...)`) so `mock.calls` typechecks; use `test.each` for near-identical repeated cases.\n\n## Code Style\n\n- Biome: 4-space indent, 110-col width, double quotes, semicolons always\n- `I`-prefixed interfaces; `camelCase` functions/variables/files; `PascalCase` classes; `UPPER_SNAKE_CASE` constants\n- CSS Modules (`*.module.css`); type-only imports (`import type { IFoo }`)\n- Every TS file starts with the AGPL-3.0 header:\n\n```ts\n// Part of the Chili3d Project, under the AGPL-3.0 License.\n// See LICENSE file in the project root for full license information.\n```\n\n## Git\n\nCommits: `<emoji> <type>(<scope>): <description>` — ✨ `feat` · 🐛 `fix` · ♻️ `refactor` · ✅ `test` · 📝 `docs` · 💄 `style` · 🔧 `chore`. Scope = package name. Active branch: `dev` → PR to `main`.\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Chili3D coding guidelines\n\n## Build & Test\n\n```bash\nnpm run dev            # Rspack dev server → localhost:8080\nnpm run build          # Production build (Rspack + SWC)\nnpm run test           # All tests (Rstest + Happy-DOM); npm run testc = with coverage\nnpm run check          # Biome lint + auto-fix (run before commits)\nnpm run format         # Biome + clang-format across all files\nnpm run build:wasm     # C++ → WebAssembly (CMake + Emscripten); setup:wasm = one-time deps\n\nnpx rstest packages/core/test/result.test.ts   # single file\nnpx rstest -t \"should handle error case\"       # filter by name\n```\n\n## Monorepo Structure\n\nBrowser-based parametric 3D CAD: OCCT C++ kernel compiled to WebAssembly, rendered with Three.js. npm workspace under `packages/`:\n\n```\nweb ──> builder ──> app ──> core\n                  ──> i18n / three / wasm ──> core\n                  ──> ui ──> core + element\n```\n\n- **`core`** — Everything abstract: shape interfaces, math, document model, reactive data (`Observable`, `Binding`, `PubSub`), `Result<T,E>`, undo, commands, serialization, plugins, services, UI abstractions\n- **`wasm`** — Concrete `ShapeFactory` → OCCT via Emscripten; exports `initWasm()`\n- **`three`** — Three.js viewport, camera controller, visuals, highlighter, gizmo, mesh export\n- **`element`** — Custom reactive DOM elements (radio groups, expanders, data converters)\n- **`ui`** — App chrome: main window, ribbon, property panels, project tree, dialogs, toast, status bar\n- **`app`** — `Application`, body nodes (`bodys/`), command implementations, `CommandService`, `HotkeyService`\n- **`builder`** — `AppBuilder` fluent chain (`.useIndexedDB().useWasmOcc().useThree().useUI().build()`), default ribbon layout\n- **`i18n`** / **`storage`** / **`web`** — Locale data (en, zh-cn, pt-br) / IndexedDB persistence / entry point (loading screen, `?plugin=`/`?url=`/`?model=` params)\n\nImport via workspace names (`import { ... } from \"@chili3d/core\"`); one root `tsconfig.json` covers all packages.\n\n## C++ WASM (`cpp/`)\n\nOCCT v8.0.0 → `chili-wasm.wasm` via Emscripten. `cpp/src/`: `factory.cpp` (shape creation), `shape.cpp` (topology traversal), `converter.cpp` (STEP/IGES/BREP/STL), `mesher.cpp` (B-rep → mesh), `geometry.cpp` (curve/surface queries). Output: `packages/wasm/lib/chili-wasm.{wasm,js,d.ts}`. C++ style: WebKit (clang-format); license LGPL-3.0 (TS is AGPL-3.0).\n\n## Key Patterns\n\n- **Interface-driven** — `core` defines interfaces; feature packages implement; `AppBuilder` wires at startup.\n- **Result pattern** — Fallible ops return `Result.ok(value)` / `Result.err(error)` (`core/src/foundation/result.ts`); never throw for expected failures.\n- **Reactive data** — `Observable` uses `getPrivateValue(key)` / `setPrivateValue(key, value)`; setting emits `emitPropertyChanged`. `ObservableCollection` powers property editor and project tree.\n- **Serialization** — `@serializable()` on classes, `@serialize()` on fields → `{ __cla$$__: \"ClassName\", ...props }`.\n- **Body nodes** — `app/src/bodys/`; extend `ParameterShapeNode`, implement `generateShape(): Result<IShape>`, `setPropertyEmitShapeChanged()` triggers re-evaluation.\n- **Commands** — `ICommand.execute(application): Promise<void>`; `CancelableCommand` adds `cancel()`, `AsyncController`, dispose stack.\n- **Undo/redo** — `Transaction` records snapshots, `History` keeps the stack; commands create transactions automatically.\n- **Plugins** — Loaded from URLs or `?plugin=`; manager in `core/src/plugin/` + `app/src/pluginManager.ts`; examples in `plugins/`.\n- **Global singleton** — `getCurrentApplication()` (from `core`) instead of DI threading.\n- **MCP server** (`packages/mcp/`) — `live_*` tools drive the user's open browser tab; headless tools (`run_cad_program`, `render_preview`, etc.) are a server-side scratchpad. Units: millimetres; angles: degrees.\n\n## Testing\n\n- Rstest (not Jest/Vitest) + Happy-DOM; root `rstest.config.ts`, globals enabled (`describe`, `test`, `expect`); tests in `packages/*/test/`; legacy decorators enabled.\n- Reuse shared mocks from `@chili3d/core/test-utils` (`TestDocument`, `createMockDocument`, `createMockApplication`, `createMockVisual`, ...) instead of per-package copies; package-specific facades (e.g. `packages/ui/test/_helpers/`) extend them. `initializeI18n()` runs automatically via rstest `setupFiles` — never call it in test files.\n- Assertions must execute: none hidden in event callbacks (unless the callback is also asserted to fire), no tautologies (`x === true || x === false`), no `if (x) expect(...)` — assert the precondition, then the behavior; `await` every promise whose `.then` asserts.\n- Assert behavior, not absence of crashes: bare `not.toThrow()` / `toBeDefined()` is a smell; `querySelector` results need `not.toBeNull()`.\n- Restore global monkeypatches (`PubSub.default.pub`, `globalThis.fetch`, ...) in `finally`/`afterEach`, or use `rs.stubGlobal` + `rs.unstubAllGlobals()`.\n- Type `rs.fn` mocks with the real signature (`rs.fn((_edges: IEdge[]) => ...)`) so `mock.calls` typechecks; use `test.each` for near-identical repeated cases.\n\n## Code Style\n\n- Biome: 4-space indent, 110-col width, double quotes, semicolons always\n- `I`-prefixed interfaces; `camelCase` functions/variables/files; `PascalCase` classes; `UPPER_SNAKE_CASE` constants\n- CSS Modules (`*.module.css`); type-only imports (`import type { IFoo }`)\n- Every TS file starts with the AGPL-3.0 header:\n\n```ts\n// Part of the Chili3d Project, under the AGPL-3.0 License.\n// See LICENSE file in the project root for full license information.\n```\n\n## Git\n\nCommits: `<emoji> <type>(<scope>): <description>` — ✨ `feat` · 🐛 `fix` · ♻️ `refactor` · ✅ `test` · 📝 `docs` · 💄 `style` · 🔧 `chore`. Scope = package name. Active branch: `dev` → PR to `main`.\n","category":"root","tokens":1441}]}