symbiote-ui 0.3.0-alpha.4

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to `symbiote-ui` will be documented in this file.
+
+## [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,76 @@
+# 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.
+
+Use `symbiote-node` only as the terminal migration facade for older consumers.
+
+## Browser Registration
+
+```js
+import {
+  registerSymbioteComponents,
+  getSymbioteComponentCatalog,
+} from 'symbiote-ui/ui';
+
+registerSymbioteComponents();
+
+console.log(getSymbioteComponentCatalog());
+```
+
+The root package and Node-safe entry points must not require DOM globals. Browser-only custom elements belong behind `symbiote-ui/ui`.
+
+## 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`.