symbiote-ui 0.3.0-alpha.10

package/CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+All notable changes to `symbiote-ui` will be documented in this file.
+
+## [0.3.0-alpha.10] - 2026-06-04
+
+### Added
+
+- Added a reusable cascade theme contract with `createCascadeTheme()` and `applyCascadeTheme()`.
+- Exposed cascade theme controls and WebMCP metadata through provider discovery.
+
+### Changed
+
+- Updated the cascade theme lab to consume the library API instead of owning local theme formulas.
+
+## [0.3.0-alpha.6] - 2026-06-03
+
+### Changed
+
+- Updated package metadata to point at the standalone `symbiote-ui` repository.
+- Updated the `symbiote-engine` dependency to `0.3.0-alpha.6`.
+
+## [0.3.0-alpha.5] - 2026-06-03
+
+### Fixed
+
+- Kept browser UI exports off the `symbiote-engine` barrel so browser bundlers do not pull Node-only engine modules into UI builds.
+
+## [0.3.0-alpha.4] - 2026-06-03
+
+### Added
+
+- Split UI/provider ownership from the former `symbiote-node` monolith.
+- Added `symbiote-ui/webmcp` for explicit WebMCP descriptors and registration helpers.
+- Added `component-descriptor-v2` with SSR and WebMCP contract metadata.
+- Added provider discovery through `symbiote-ui/discover` and the `symbiote-ui discover` CLI command.
+
+### Changed
+
+- UI/provider imports now belong under `symbiote-ui`.
+- Runtime execution imports now belong under `symbiote-engine`.
+- `symbiote-node` remains only as the terminal migration facade.
+
+## [0.3.0-alpha.0] — 2026-04-18
+
+### Fixed
+- **Memory leak**: zombie `setTimeout` loops in SubgraphNode preview rendering — replaced with on-demand redraws
+- **Memory leak**: event listener accumulation in `NodeCanvas.setEditor()` — added explicit unsubscribe on context switch
+- **Memory leak**: incorrect `cancelAnimationFrame` cleanup for `setTimeout` IDs in `NodeViewManager.removeView()`
+- **Layout overlap**: nodes measured as 4px height (DOM not ready) caused overlap — enforced minimum `nodeHeight` floor in `getSize()`
+- **Inspector z-index**: panel header overlapped toolbar buttons — removed header, added toolbar-aware padding
+
+### Added
+- `Editor.removeAllListeners()` — clean teardown method for editor event system
+- `computeTreeLayout()` — directory-hierarchy-aware tree layout with indent levels
+- Shape primitives: `CircleShape`, `DiamondShape`, `PillShape`, `RectShape`
+- PCB dark theme enhancements: improved node styling, copper trace connections
+
+### Breaking
+- `InspectorPanel` no longer renders a title header bar — consumers relying on `.insp-header` CSS should update
+
+## [0.2.1] — 2026-04-13
+
+- Initial open-source release
+- Node graph editor with Symbiote.js web components
+- Sugiyama-based auto layout (`computeAutoLayout`)
+- PCB/Carbon theming system
+- Inspector panel with resize handle
+- Subgraph navigation (drill-down/drill-up)
+- Execution engine with topological sorting

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RND-PRO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# symbiote-ui
+
+`symbiote-ui` owns the browser-facing and agent-facing UI contracts for Symbiote provider systems.
+
+It is built for agents that construct components, data views, and surrounding layouts dynamically. A chat agent can choose a component descriptor, bind data, compose a layout, and let the browser hydrate interactive Web Components without restarting the server.
+
+## Install
+
+```sh
+npm install symbiote-ui @symbiotejs/symbiote@3.8.0-webmcp.2
+```
+
+For SSR integration tests or JSDA-based hosts, install the integration dependencies in the host project:
+
+```sh
+npm install jsda-kit linkedom
+```
+
+`jsda-kit` is intentionally not a runtime dependency of `symbiote-ui`.
+
+## Entry Points
+
+- `symbiote-ui` - Node-safe core primitives.
+- `symbiote-ui/core` - graph editor data primitives.
+- `symbiote-ui/layout` - SSR-safe layout helpers.
+- `symbiote-ui/graph` - provider graph normalization and projection helpers.
+- `symbiote-ui/manifest` - component, schema, rule, theme, and provider catalogs.
+- `symbiote-ui/ui` - browser Web Component registration and UI runtime.
+- `symbiote-ui/webmcp` - WebMCP descriptor helpers and registration utilities.
+- `symbiote-ui/xr` - WebXR provider helpers.
+- `symbiote-ui/locale` - Node-safe locale catalogs and translation helpers.
+- `symbiote-ui/discover` - provider discovery JSON API used by the CLI.
+- `symbiote-ui/custom-elements.json` - Custom Elements manifest.
+- `symbiote-ui/schemas/*`, `symbiote-ui/tokens/*`, `symbiote-ui/rules/*` - machine-readable provider contracts.
+- `symbiote-ui/display/*` - reusable display utilities exposed by package export map.
+
+For the complete export map and provider catalog, run:
+
+```sh
+symbiote-ui discover
+```
+
+Use `symbiote-node` only as the terminal migration facade for older consumers.
+
+## Related Packages
+
+- [`symbiote-engine`](https://github.com/RND-PRO/symbiote-engine) - runtime execution, CLI commands, server helpers, persistence, and handlers.
+- [`symbiote-node`](https://github.com/RND-PRO/symbiote-node) - terminal migration facade for older imports.
+- [Package split guide](https://github.com/RND-PRO/symbiote-node/blob/main/docs/package-split.md)
+- [Agent contract index](https://github.com/RND-PRO/symbiote-node/blob/main/docs/agent-contracts.md)
+
+## Browser Registration
+
+```js
+import { defineModule, listModules } from 'symbiote-ui/ui';
+
+defineModule('chat-composer');
+
+console.log(listModules());
+```
+
+The root package and Node-safe entry points must import without creating DOM globals. Import safety does not mean every exported helper is useful without host data, a DOM adapter, browser hydration, or runtime-provided objects. Browser-only custom elements and module definition helpers belong behind `symbiote-ui/ui`.
+
+## Cascade Theme
+
+`symbiote-ui` exposes a reusable cascade theme contract for agent-built UI, graph canvases, layouts, scrollbars, and VR-ready panels:
+
+```js
+import { applyCascadeTheme, createCascadeTheme } from 'symbiote-ui';
+
+let theme = createCascadeTheme({
+  mode: 'dark',
+  brightness: 0,
+  contrast: 58,
+  chroma: 89,
+  hue: 218,
+  outline: 38,
+  type: 100,
+  density: 100,
+});
+
+applyCascadeTheme(document.documentElement, theme.state);
+```
+
+Apply the cascade once at `:root`, an app shell, or a subtree boundary. Components inherit `--sn-*` tokens; host projects should not duplicate the formulas in app-local CSS or JS.
+
+## Demos
+
+- [`demo/cascade-theme-lab.html`](./demo/cascade-theme-lab.html) - cascade theme controls for dark/light mode, brightness, contrast, accent chroma, and graph/UI token inheritance.
+- [`demo/pcb-router-stress.html`](./demo/pcb-router-stress.html) - animated PCB route diagnostics with orbit metrics, keyframes, and agent-readable JSON samples.
+
+## WebMCP
+
+Component metadata uses `component-descriptor-v2` with bounded agent-facing contracts:
+
+- `contract.ssr.mode` classifies SSR safety as `node-safe`, `ssr-entry-safe`, `jsda-ssr-renderable`, `hydrate-only`, or `client-only`.
+- `contract.webmcp.tools[]` documents explicit tool descriptors with `name`, `description`, `inputSchema`, `annotations`, visibility, and permission hints.
+- WebMCP exposure is explicit-first. The package does not enable global `Symbiote.mcpToolMode` by default.
+
+The upstream Symbiote WebMCP reference is:
+
+https://github.com/symbiotejs/symbiote.js/blob/webmcp/docs/webmcp.md
+
+## JSDA SSR
+
+Hosts that use JSDA SSR should provide their own SSR runtime and DOM adapter:
+
+```js
+import { parseHTML } from 'linkedom';
+import 'symbiote-ui/ui';
+```
+
+`jsda-ssr-renderable` components are expected to import safely in a JSDA SSR fixture with `ssr.enabled`, `ssr.imports`, `linkedom`, and Web Component SSR enabled by the host.
+
+## Package Boundary
+
+`symbiote-ui` owns Web Components, UI/layout primitives, manifests, schemas, rules, tokens, themes, locale helpers, provider-facing graph metadata, WebMCP metadata, and `custom-elements.json`.
+
+Runtime workflow execution, persistence, server commands, handler packs, and process lifecycle belong in `symbiote-engine`.