@signalsafe/tree-spec-editor 0.2.2 → 0.3.0

package/dist/ui/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/ui/primitives.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,SAAS,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAcrJ,wBAAgB,YAAY,CAAC,EACzB,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,GAAG,IAAI,EACV,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,+BAM7D;AAED,wBAAgB,gBAAgB,CAAC,EAC7B,SAAS,EACT,QAAQ,EACR,GAAG,IAAI,EACV,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,+BAMzC;AAED,wBAAgB,iBAAiB,CAAC,EAC9B,SAAS,EACT,KAAe,EACf,GAAG,IAAI,EACV,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,+BAW9D;AAED,wBAAgB,WAAW,CAAC,EACxB,SAAS,EACT,GAAG,IAAI,EACV,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,+BAEvC;AAED,wBAAgB,YAAY,CAAC,EACzB,SAAS,EACT,QAAQ,EACR,GAAG,IAAI,EACV,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,+BAMzC;AAED,wBAAgB,cAAc,CAAC,EAC3B,SAAS,EACT,GAAG,IAAI,EACV,EAAE,sBAAsB,CAAC,mBAAmB,CAAC,+BAE7C;AAED,wBAAgB,WAAW,CAAC,EACxB,SAAS,EACT,QAAQ,GACX,EAAE;IACC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACvB,+BAEA;AAED,wBAAgB,WAAW,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,IAAI,EACV,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,+BAMvC;AAED,wBAAgB,cAAc,CAAC,EAC3B,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACV,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,+BAO/D;AAED,wBAAgB,YAAY,CAAC,EACzB,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACV,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,+BAO/D"}

package/dist/ui/primitives.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { EDITOR_BTN, EDITOR_CHECKBOX, EDITOR_FIELD, EDITOR_FIELD_LABEL, EDITOR_INPUT, EDITOR_SELECT, EDITOR_TEXTAREA, editorBtnToneClass, joinClasses, } from './editorClasses.js';
+export function EditorButton({ tone, className, children, ...rest }) {
+    return (_jsx("button", { type: "button", className: joinClasses(editorBtnToneClass(tone), className), ...rest, children: children }));
+}
+export function EditorIconButton({ className, children, ...rest }) {
+    return (_jsx("button", { type: "button", className: joinClasses(`${EDITOR_BTN} graph-editor-btn--icon`, className), ...rest, children: children }));
+}
+export function EditorCloseButton({ className, label = 'Close', ...rest }) {
+    return (_jsx("button", { type: "button", className: joinClasses(`${EDITOR_BTN} graph-editor-btn--close`, className), "aria-label": label, ...rest, children: "\u00D7" }));
+}
+export function EditorInput({ className, ...rest }) {
+    return _jsx("input", { className: joinClasses(EDITOR_INPUT, className), ...rest });
+}
+export function EditorSelect({ className, children, ...rest }) {
+    return (_jsx("select", { className: joinClasses(EDITOR_SELECT, className), ...rest, children: children }));
+}
+export function EditorTextarea({ className, ...rest }) {
+    return _jsx("textarea", { className: joinClasses(EDITOR_TEXTAREA, className), ...rest });
+}
+export function EditorField({ className, children, }) {
+    return _jsx("div", { className: joinClasses(EDITOR_FIELD, className), children: children });
+}
+export function EditorLabel({ className, children, ...rest }) {
+    return (_jsx("label", { className: joinClasses(EDITOR_FIELD_LABEL, className), ...rest, children: children }));
+}
+export function EditorCheckbox({ className, label, ...rest }) {
+    return (_jsxs("label", { className: joinClasses(EDITOR_CHECKBOX, className), children: [_jsx("input", { type: "checkbox", ...rest }), label ? _jsx("span", { children: label }) : null] }));
+}
+export function EditorSwitch({ className, label, ...rest }) {
+    return (_jsxs("label", { className: joinClasses(`${EDITOR_CHECKBOX} graph-editor-checkbox--switch`, className), children: [_jsx("input", { type: "checkbox", role: "switch", ...rest }), label ? _jsx("span", { children: label }) : null] }));
+}

package/docs/UI_KIT_AGNOSTIC_REFACTOR.md

@@ -0,0 +1,186 @@
+# UI-kit agnostic editor refactor — design scan (Prompt 8)
+
+**Status:** Implemented on `cleanup` (Prompts 9–10, 9A). `@signalsafe/tree-spec-editor@0.3.0` and `@signalsafe/tree-spec-editor-react@0.2.0` are UI-kit agnostic. See [UI_KIT_AGNOSTIC_USAGE.md](./UI_KIT_AGNOSTIC_USAGE.md) and [`tree-spec-editor-react` canvas doc](../../tree-spec-editor-react/docs/UI_KIT_AGNOSTIC_CANVAS.md).
+
+---
+
+## Executive summary (historical — Prompt 8 scan)
+
+| Package | react-bootstrap | Bootstrap CSS classes | Ready for UI-kit agnostic goal |
+|---------|-----------------|----------------------|--------------------------------|
+| `tree-spec-editor-core` | None | None | **Yes** — already meets boundary |
+| `tree-spec-editor-react` | None | **None (0.2.0+)** | **Yes** — canvas uses `graph-editor-*` hooks |
+| `tree-spec-editor` | ~~**Yes** — 13 source files~~ → **None (0.3.0+)** | ~~**Yes**~~ → **`graph-editor-*` hooks** | **Yes** — shell refactor complete |
+
+**Likely semver:** `@signalsafe/tree-spec-editor` **0.3.0** (remove `react-bootstrap` peer; public panel/modal API and styling contract change). `@signalsafe/tree-spec-editor-react` **0.2.0** (canvas class renames / neutral tokens). `@signalsafe/tree-spec-editor-core` **patch or unchanged**.
+
+---
+
+## Search inventory (Prompt 8 task list)
+
+### `tree-spec-editor`
+
+| Category | Matches |
+|----------|---------|
+| **Runtime `react-bootstrap` imports** | 13 files under `src/` (see table below) |
+| **Bootstrap CSS only (no import)** | Modals (`<dialog>` + `modal-*`, `alert-*`), all sidebar panels (`card-*`, `list-group-*`, `btn-*`), `panelNodeLink.tsx`, `PanelHeaderCollapseCarets.tsx` |
+| **Public exports (Bootstrap-coupled)** | All panel/modal components; `ToolbarPanel`; `getIssueSeverityBadgeClass`; `LIST_*` / `CANVAS_*` selection class constants; `buildDefaultToolbarSpec` (variant strings) |
+| **Package metadata** | `peerDependencies.react-bootstrap`, keyword `react-bootstrap`, README install line includes `react-bootstrap bootstrap` |
+| **Tests** | `ToolbarPanel.test.ts` mocks `react-bootstrap`; `panelHelpers.test.ts` asserts `text-bg-*`; `NodesPanel` / `IssuesPanel` assert `list-group-item-primary` |
+| **Docs** | README positions package as “React **Bootstrap UI shell**” (throughout) |
+| **Not used** | `Tabs`, `Accordion`, `Overlay`, `Popover`, `Toast`, `react-bootstrap` `Modal` (native `<dialog>` + Bootstrap classes instead) |
+
+**Runtime `react-bootstrap` import sites:**
+
+| File | Components imported |
+|------|---------------------|
+| `src/modals/DraftHistoryModal.tsx` | `Button`, `CloseButton` |
+| `src/modals/AuditLogModal.tsx` | `Button`, `CloseButton` |
+| `src/modals/PublishReviewModal.tsx` | `Button`, `CloseButton` |
+| `src/panels/GraphEditorInfoPanel.tsx` | `Badge`, `Form`, `Table` |
+| `src/panels/AdvancedJsonPanel.tsx` | `Button` |
+| `src/panels/IssuesPanel.tsx` | `Form` |
+| `src/panels/NodesPanel.tsx` | `Form` |
+| `src/panels/ChoiceEdgeAppearanceFields.tsx` | `Form` |
+| `src/panels/inspector/ChoiceEditorCard.tsx` | `Form` |
+| `src/panels/inspector/NodeTypeField.tsx` | `Form` |
+| `src/panels/inspector/RequiredNodeCard.tsx` | `Form` |
+| `src/panels/ToolbarPanel.tsx` | `Button`, `Dropdown` |
+| `src/panels/ChoiceTemplatesPanel.tsx` | `Button`, `Card` |
+
+**Public API — types mentioning Bootstrap:**
+
+- `ToolbarButtonItem.variant`, `ToolbarDropdownItem.variant`, `ToolbarBadgeItem.variant` — documented as Bootstrap variant strings.
+- `PublishReviewModalProps.errorAlertText` — uses Bootstrap `alert-danger` markup (prop name only; rendering is Bootstrap CSS).
+
+### `tree-spec-editor-react`
+
+| Category | Matches |
+|----------|---------|
+| **react-bootstrap** | **None** (docs/comments only) |
+| **Bootstrap CSS in runtime** | 9 files: `PromptNode.tsx`, `PromptNodeHeader.tsx`, `PromptNodeChoicesList.tsx`, `PromptNodeIssueBadges.tsx`, `PromptNodeToolbar.tsx`, `ChoiceCanvasRow.tsx`, `EndNode.tsx`, `GraphCanvasContextMenu.tsx`, `canvas/constants.ts` (`dropdown-menu`, `card-*`, `badge`, `btn-*`, `list-group-*`, `bg-body-secondary`) |
+| **False positives** | `useTreeSpecEditor` “bootstrap graph” comments (data bootstrap, not UI) |
+| **Public API** | `TreeSpecGraphEditorProps.colorScheme` doc mentions Bootstrap `colorScheme` — host contract leak |
+
+### `tree-spec-editor-core`
+
+| Category | Matches |
+|----------|---------|
+| **All matches** | README / `index.ts` comments stating “no Bootstrap” — **docs only** |
+| **Runtime** | **Clean** |
+
+---
+
+## Current vs target boundaries
+
+### Target (ecosystem policy)
+
+1. **`tree-spec-editor-core`** — pure logic, no React/DOM/Bootstrap. **Already there.**
+2. **`tree-spec-editor-react`** — React Flow + hooks; **no Bootstrap/MUI**; neutral canvas markup.
+3. **`tree-spec-editor`** — UI-kit agnostic composition (hooks, primitives, render props); **must not** require `react-bootstrap` or Bootstrap CSS.
+
+### Optional future package
+
+`@signalsafe/tree-spec-editor-bootstrap` — migrate **today’s** panel/modal/toolbar implementations here for hosts that want the reference Bootstrap shell (including DeliveryPlus during transition).
+
+---
+
+## Refactor strategy (recommended phases)
+
+### Phase 0 — No behavior change (prep)
+
+- Add this design doc; align DeliveryPlus on timeline.
+- Snapshot README/API contract before refactors.
+
+### Phase 1 — `tree-spec-editor-react` neutral canvas
+
+- Replace Bootstrap class names in node/context-menu components with **`graph-editor-*`** semantic classes.
+- Ship minimal package CSS (or document host-provided tokens) mapping semantic classes → host theme.
+- Change `CONTEXT_MENU_CLASS` off `dropdown-menu` to neutral menu classes.
+- Update tests in `-react` that assert Bootstrap class strings.
+- **semver:** minor (`0.2.0`).
+
+### Phase 2 — Headless shell API in `tree-spec-editor`
+
+Introduce UI-kit agnostic layer **alongside** existing components (deprecate, then remove):
+
+| Pattern | Use for |
+|---------|---------|
+| **Hooks** | Re-export / wrap `useTreeSpecEditor` with panel-state helpers (`useInspectorState`, `useToolbarActions`) |
+| **Primitives** | Unstyled structural components: `EditorSidebarSection`, `EditorModalFrame`, `EditorListRow` — semantics + ARIA only |
+| **Render props / slots** | `InspectorPanel` already has `renderExtraNodeFields` / `renderExtraChoiceFields` — extend to **all** chrome (buttons, badges, inputs) |
+| **Data-only helpers** | Replace `getIssueSeverityBadgeClass` with `getIssueSeverityToken()` → `'error' \| 'warning' \| 'info'`; hosts map to UI |
+| **Selection tokens** | Replace exported `LIST_SELECTION_CLASS` Bootstrap strings with stable token constants |
+
+Remove from **`tree-spec-editor` public API** (breaking):
+
+- Direct export of Bootstrap-backed panels/modals **or** move them to `@signalsafe/tree-spec-editor-bootstrap`.
+
+### Phase 3 — Optional `@signalsafe/tree-spec-editor-bootstrap`
+
+- Move current `src/panels/`, `src/modals/`, Bootstrap `ToolbarPanel` implementation verbatim.
+- Keep peer deps: `react-bootstrap`, `bootstrap` (CSS loaded by host).
+- `tree-spec-editor` re-exports bootstrap package temporarily with deprecation notice.
+
+### Phase 4 — Docs & metadata
+
+- Remove `react-bootstrap` from `peerDependencies` and keywords on `@signalsafe/tree-spec-editor`.
+- README: primary path = hooks + render props; Bootstrap = optional add-on package.
+- **semver:** `@signalsafe/tree-spec-editor` **0.3.0**.
+
+---
+
+## DeliveryPlus migration impact
+
+**Today (inferred from package docs):**
+
+- Installs `@signalsafe/tree-spec-editor` + peers including **`react-bootstrap`** and **Bootstrap CSS**.
+- Uses exported panels, modals, toolbar, and canvas default export from one barrel.
+
+**After refactor:**
+
+- **Short term:** Pin `@signalsafe/tree-spec-editor-bootstrap` (or pre-0.3.0 line) until DeliveryPlus rebuilds shell with its UI library.
+- **Target:** Depend on `@signalsafe/tree-spec-editor-react` + `@signalsafe/tree-spec-editor-core` + **DeliveryPlus-owned** panel/modal components using render props / hooks.
+- **CSS:** Must load neutral `graph-editor-*` styles from `-react` (or map tokens in DeliveryPlus theme) — no implicit Bootstrap on canvas.
+
+**Do not modify DeliveryPlus in this prompt.**
+
+---
+
+## Risks
+
+| Risk | Mitigation |
+|------|------------|
+| Breaking visual parity | Optional bootstrap package; screenshot tests in bootstrap package only |
+| Class-based tests fail | Update tests to assert semantic tokens / `graph-editor-*` classes |
+| Hidden Bootstrap in `-react` | Phase 1 before removing bootstrap from shell |
+| Toolbar `variant` strings | Replace with theme-agnostic `tone: 'primary' \| 'neutral' \| 'danger'` |
+| Modal `<dialog>` + Bootstrap layout | `EditorModalFrame` primitive with slot for actions |
+
+---
+
+## Tests needed (implementation prompts)
+
+- [ ] `-react`: canvas renders without Bootstrap CSS loaded (layout smoke).
+- [ ] `-react`: context menu keyboard/a11y with neutral classes.
+- [ ] `tree-spec-editor`: hook + render-prop contract tests (no `react-bootstrap` import in package).
+- [ ] `tree-spec-editor-bootstrap`: port existing panel/modal vitest suite.
+- [ ] Cross-package: `buildDefaultToolbarSpec` works with agnostic toolbar renderer.
+- [ ] DeliveryPlus integration checklist (manual).
+
+---
+
+## Recommended action summary
+
+| Repo | Action |
+|------|--------|
+| `tree-spec-editor-core` | **None** — maintain boundary |
+| `tree-spec-editor-react` | **Phase 1 ✓** — Bootstrap CSS removed from canvas (`0.2.0`) |
+| `tree-spec-editor` | **Phase 2–4** — headless API + optional bootstrap split; **0.3.0** |
+
+---
+
+## References
+
+- Ecosystem boundaries: `prompts/summary.md` (Option A — UI-kit agnostic editor)
+- npm packages (release-ready on `cleanup`, not yet published): `@signalsafe/tree-spec-editor@0.3.0`, `@signalsafe/tree-spec-editor-react@0.2.0`, `@signalsafe/tree-spec-editor-core@0.1.3`

package/docs/UI_KIT_AGNOSTIC_USAGE.md

@@ -0,0 +1,129 @@
+# UI-kit agnostic editor — usage and migration
+
+**Package:** `@signalsafe/tree-spec-editor`  
+**Status:** Implemented (0.3.0+)  
+**Related:** [UI_KIT_AGNOSTIC_REFACTOR.md](./UI_KIT_AGNOSTIC_REFACTOR.md) (design scan)
+
+---
+
+## Summary
+
+`@signalsafe/tree-spec-editor` ships **composable React panels, modals, and toolbar** with semantic HTML and stable **`graph-editor-*` class hooks**. It does **not** require Bootstrap, Material UI, or any other UI library.
+
+**The host application owns styling.** Map `graph-editor-*` classes to your design system, or load optional host CSS (Bootstrap, MUI, Tailwind, etc.).
+
+Peer dependencies: `react`, `react-dom`, `reactflow` only.
+
+---
+
+## Architecture
+
+| Layer | Package | UI library |
+|-------|---------|------------|
+| Wire | `@signalsafe/tree-spec` | None |
+| Model | `@signalsafe/tree-spec-editor-core` | None |
+| Canvas | `@signalsafe/tree-spec-editor-react` | None (React Flow only; canvas emits `graph-editor-*` hooks — see [`UI_KIT_AGNOSTIC_CANVAS.md`](../../tree-spec-editor-react/docs/UI_KIT_AGNOSTIC_CANVAS.md)) |
+| Shell | `@signalsafe/tree-spec-editor` | **Host-owned** — semantic hooks only |
+
+---
+
+## Class hooks (`graph-editor-*`)
+
+Panels, modals, and toolbar emit predictable class names from `src/ui/editorClasses.ts`:
+
+| Token | Example classes | Used for |
+|-------|-----------------|----------|
+| Card chrome | `graph-editor-card`, `graph-editor-card__header`, `graph-editor-card__body` | Sidebar panels |
+| Lists | `graph-editor-list`, `graph-editor-list__item`, `graph-editor-list__item--selected` | Nodes / Issues rows |
+| Buttons | `graph-editor-btn`, `graph-editor-btn--neutral`, `graph-editor-btn--success` | Toolbar, modals, inspector |
+| Badges | `graph-editor-badge`, `graph-editor-badge--error` | Severity, toolbar status |
+| Modals | `graph-editor-modal`, `graph-editor-modal__dialog`, `graph-editor-alert--danger` | Publish / draft / audit dialogs |
+| Forms | `graph-editor-input`, `graph-editor-select`, `graph-editor-field` | Inspector fields |
+| Toolbar | `graph-editor-toolbar`, `graph-editor-dropdown__menu` | `ToolbarPanel` |
+
+**Tone mapping:** `ToolbarPanel` and `EditorButton` accept legacy Bootstrap `variant` strings (`outline-secondary`, `success`, …). They are mapped to tone hooks (`neutral`, `success`, …) via `normalizeToolbarTone()` — you may pass either style during migration.
+
+---
+
+## Primitives (internal building blocks)
+
+The package uses small presentational components in `src/ui/primitives.tsx`. They are **not** re-exported from the public barrel today; hosts typically style via `graph-editor-*` CSS. Maintainers and fork authors may import them from source when composing custom panels:
+
+| Primitive | Role |
+|-----------|------|
+| `EditorButton` | `<button>` with `tone` → `graph-editor-btn--*` |
+| `EditorIconButton` / `EditorCloseButton` | Icon and modal close controls |
+| `EditorInput`, `EditorSelect`, `EditorTextarea` | Form controls |
+| `EditorField`, `EditorLabel`, `EditorCheckbox`, `EditorSwitch` | Field layout |
+
+---
+
+## Render props and extension slots
+
+Several panels accept host injection without replacing the whole component:
+
+### `InspectorPanel`
+
+| Prop | Purpose |
+|------|---------|
+| `renderExtraNodeFields(ctx)` | Extra UI below the prompt textarea |
+| `renderExtraChoiceFields(ctx)` | Extra UI per choice card |
+| `outcomeOptions` | Override END-transition `<select>` options |
+| `hideOutcomeField` | Hide outcome field when host manages outcomes elsewhere |
+| `choiceTypes` / `onSetChoiceType` | Host-defined choice type catalog |
+
+### `AppearancePanel`
+
+| Prop | Purpose |
+|------|---------|
+| `renderAppearanceFields(ctx)` | Replace default node/edge appearance fields |
+
+### `SelectedEdgePanel`
+
+| Prop | Purpose |
+|------|---------|
+| `renderDetails(edge, ctx)` | Custom edge summary line |
+
+### `ToolbarPanel`
+
+| Item kind | Purpose |
+|-----------|---------|
+| `kind: 'custom'` | `render: () => ReactNode` for router links, host widgets |
+
+### `buildDefaultToolbarSpec`
+
+Returns a `ToolbarItem[]` for the standard authoring actions. Host closures own capability gates and labels; `ToolbarPanel` renders them with semantic classes.
+
+---
+
+## Helpers (public API)
+
+| Export | Before (≤0.2.x) | After (0.3.0+) |
+|--------|-----------------|----------------|
+| `getIssueSeverityBadgeClass(severity)` | `text-bg-danger`, … | `graph-editor-badge graph-editor-badge--error`, … |
+| `getIssueSeverityToken(severity)` | *(not exported)* | `'error' \| 'warning' \| 'info' \| 'neutral'` |
+| `LIST_SELECTION_CLASS` | `list-group-item-primary` | `graph-editor-list__item--selected` |
+| `CANVAS_SELECTION_CLASS` | Bootstrap canvas class | `graph-editor-canvas__selected` |
+
+Prefer **`getIssueSeverityToken`** when mapping to MUI/Bootstrap/theme tokens in host code.
+
+---
+
+## DeliveryPlus migration (guidance only)
+
+**Do not change DeliveryPlus in editor package work.** When DeliveryPlus upgrades to `@signalsafe/tree-spec-editor@0.3.0`:
+
+1. **Remove** `react-bootstrap` as a required peer for this package (keep it only if DeliveryPlus still uses Bootstrap elsewhere).
+2. **Add CSS** mapping `graph-editor-*` → DeliveryPlus/Bootstrap theme, **or** ship a small `graph-editor.css` in the host app.
+3. **Update tests** that assert `text-bg-*`, `list-group-item-primary`, or `btn-*` on panel output — assert `graph-editor-*` instead.
+4. **Toolbar variants** — existing `outline-secondary` / `success` strings still work via tone mapping.
+5. **Optional short-term pin** — stay on `0.2.x` until host CSS is ready; then bump to `0.3.0`.
+6. **Future (optional)** — `@signalsafe/tree-spec-editor-bootstrap` may provide a reference Bootstrap skin without coupling the core package.
+
+**Canvas (`@signalsafe/tree-spec-editor-react@0.2.0`):** uses the same `graph-editor-*` prefix for node cards, lists, badges, and context menus. Map canvas hooks in host CSS alongside panel hooks.
+
+---
+
+## Semver
+
+**0.3.0** — removes `react-bootstrap` peer dependency; changes styling class contract and adds `getIssueSeverityToken`. Component prop names and export surface are largely unchanged; visual parity requires host CSS updates.

package/package.json

@@ -1,8 +1,8 @@
 {
     "name": "@signalsafe/tree-spec-editor",
-    "version": "0.2.2",
+    "version": "0.3.0",
     "type": "module",
-    "description": "Reusable TreeSpec graph editor (React Flow) and authoring helpers (no API or routing).",
+    "description": "UI-kit agnostic TreeSpec graph editor shell (React Flow canvas, panels, modals, toolbar).",
     "license": "MIT",
     "repository": {
         "type": "git",
@@ -18,7 +18,6 @@
         "editor",
         "graph-editor",
         "decision-tree",
-        "react-bootstrap",
         "typescript",
         "signalsafe"
     ],
@@ -39,13 +38,15 @@
         "LICENSE"
     ],
     "engines": {
-        "node": ">=18"
+        "node": ">=22.12.0"
     },
+    "packageManager": "yarn@1.22.22",
     "publishConfig": {
         "access": "public"
     },
     "scripts": {
         "build": "tsc -p tsconfig.build.json",
+        "lint": "yarn typecheck",
         "typecheck": "tsc --noEmit",
         "pack:local": "npm pack --pack-destination ../../dist/reusable-npm",
         "release:check": "node ../../scripts/run-private-package-release-checks.mjs --mode prepublish",
@@ -56,19 +57,20 @@
         "pack:check": "node ../../scripts/check-package-tarball.mjs --tgz \"../../dist/reusable-npm/signalsafe-tree-spec-editor-$npm_package_version.tgz\" --expect package/dist/index.js --expect package/dist/index.d.ts --expect package/package.json --expect package/README.md",
         "smoke:external": "node ../../scripts/smoke-tree-spec-editor-external-consumer.mjs",
         "smoke:published": "node ../../scripts/smoke-tree-spec-editor-external-consumer.mjs --source registry",
+        "smoke:package": "node scripts/smoke-package.mjs",
         "prepublishOnly": "npm run build",
         "prepare": "npm run build",
         "test": "vitest run",
+        "test:coverage": "yarn test --coverage",
         "test:monorepo": "cd ../../frontend && yarn vitest run --config vitest.tree-spec-editor.config.ts"
     },
     "dependencies": {
-        "@signalsafe/tree-spec": "^0.3.1",
-        "@signalsafe/tree-spec-editor-core": "^0.1.2",
-        "@signalsafe/tree-spec-editor-react": "^0.1.2"
+        "@signalsafe/tree-spec": "^0.3.3",
+        "@signalsafe/tree-spec-editor-core": "^0.1.4",
+        "@signalsafe/tree-spec-editor-react": "^0.2.0"
     },
     "peerDependencies": {
         "react": "^18.0.0",
-        "react-bootstrap": "^2.10.0",
         "react-dom": "^18.0.0",
         "reactflow": "^11.0.0"
     },
@@ -77,11 +79,11 @@
         "@types/react-dom": "^18.2.22",
         "@types/react-test-renderer": "^18.3.0",
         "react": "^18.3.1",
-        "react-bootstrap": "^2.10.2",
         "react-dom": "^18.3.1",
         "react-test-renderer": "^18.3.1",
         "reactflow": "^11.11.4",
         "typescript": "^5.4.2",
+        "@vitest/coverage-v8": "^3.2.4",
         "vitest": "^3.2.4"
     }
 }