@signalsafe/tree-spec-editor 0.2.0 → 0.2.2

package/dist/lib/buildDefaultToolbarSpec.d.ts

@@ -1,157 +1,7 @@
-import type { ReactNode } from 'react';
-import { AUTOSAVE_STATUS, type AutosaveStatus, type EditorNode, type TreeTemplateSpec } from '@signalsafe/tree-spec-editor-core';
-import { type ToolbarItem } from '../panels/ToolbarPanel';
-/**
- * Description of a node type the host wants in the "+ Add" dropdown, or a
- * visual divider between groups.
- *
- * Each entry encodes the host's vocabulary: the package never assumes a fixed
- * set of node types. When a label is omitted, the type id is title-cased. Pass
- * `{ divider: true }` to insert a `<Dropdown.Divider />`.
- */
-export interface DefaultToolbarNodeType {
-    /** Node type id (matches `EditorNode.type`). Required unless `divider: true`. */
-    type?: string;
-    /** Optional display label; defaults to the title-cased type id. */
-    label?: ReactNode;
-    /** Optional patch applied to the spawned node (e.g. starter prompt). */
-    patch?: Partial<EditorNode>;
-    /** Optional stable id; defaults to `add-<type>`. */
-    id?: string;
-    /** Render this entry as a visual divider. Ignores `type` / `label` / `patch`. */
-    divider?: boolean;
-}
-/** Description of a starter template the host wants in the "Templates" dropdown. */
-export interface DefaultToolbarTemplate {
-    /** Template id used as the React key. */
-    id: string;
-    /** Display label in the dropdown. */
-    label: ReactNode;
-    /** Template spec consumed by `actions.insertTemplate`. */
-    spec: TreeTemplateSpec;
-}
-/**
- * Minimal subset of {@link UseTreeSpecEditorState} consumed by
- * {@link buildDefaultToolbarSpec}. Hosts pass the state object returned by
- * `useTreeSpecEditor` (which satisfies this contract structurally) — see the
- * `-react` package for the full state type.
- */
-export interface DefaultToolbarState {
-    isPublished: boolean;
-    saving: boolean;
-    publishing: boolean;
-    creatingSnapshot: boolean;
-    cloning: boolean;
-    canPublish: boolean;
-    hasTree: boolean;
-    autosaveStatus: AutosaveStatus;
-}
-/**
- * Minimal subset of {@link UseTreeSpecEditorActions} consumed by
- * {@link buildDefaultToolbarSpec}.
- */
-export interface DefaultToolbarActions {
-    addNodeOfType: (type: string, patch?: Partial<EditorNode>) => unknown;
-    insertTemplate: (spec: TreeTemplateSpec) => void;
-    triggerResetView: () => void;
-    autoLayout: () => void;
-    validate: (...args: unknown[]) => unknown;
-    saveDraft: (...args: unknown[]) => unknown;
-    setShowDraftHistory: (next: boolean) => void;
-    setShowAudit: (next: boolean) => void;
-    createSnapshot: (...args: unknown[]) => unknown;
-    cloneToDraft: (...args: unknown[]) => unknown;
-    setShowPublishModal: (next: boolean) => void;
-}
-/**
- * Adapter-capability flags consumed by {@link buildDefaultToolbarSpec}.
- * Hosts pass `Boolean(adapter.validate)` (etc.) so the builder can gate the
- * Validate / Draft history / Audit / Snapshot / Clone / Publish buttons.
- */
-export interface DefaultToolbarCapabilities {
-    /** Show the Validate button. */
-    canValidate?: boolean;
-    /** Show the Draft history button. */
-    canListSnapshots?: boolean;
-    /** Show the Audit button. */
-    canListAudit?: boolean;
-    /** Show the Snapshot button. */
-    canCreateSnapshot?: boolean;
-    /** Show the Clone to Draft button. */
-    canCloneToDraft?: boolean;
-    /** Show the Publish button. */
-    canPublish?: boolean;
-}
-/** Optional labels for the default toolbar; defaults are in en-US. */
-export interface DefaultToolbarLabels {
-    add?: ReactNode;
-    templates?: ReactNode;
-    resetView?: ReactNode;
-    autoLayout?: ReactNode;
-    validate?: ReactNode;
-    draftHistory?: ReactNode;
-    audit?: ReactNode;
-    snapshot?: ReactNode;
-    snapshotInFlight?: ReactNode;
-    cloneToDraft?: ReactNode;
-    cloneInFlight?: ReactNode;
-    saveDraft?: ReactNode;
-    saveDraftInFlight?: ReactNode;
-    publish?: ReactNode;
-    publishInFlight?: ReactNode;
-    statusPublished?: ReactNode;
-    statusDraft?: ReactNode;
-}
-/** Options for {@link buildDefaultToolbarSpec}. */
-export interface BuildDefaultToolbarSpecOptions {
-    /** Editor state from `useTreeSpecEditor` (or a structurally compatible source). */
-    state: DefaultToolbarState;
-    /** Editor actions from `useTreeSpecEditor`. */
-    actions: DefaultToolbarActions;
-    /** Adapter-capability flags. Buttons are hidden when their flag is false. */
-    capabilities?: DefaultToolbarCapabilities;
-    /** Node types the host wants in the "+ Add" dropdown. */
-    nodeTypes?: DefaultToolbarNodeType[];
-    /** Starter templates the host wants in the "Templates" dropdown. */
-    templates?: DefaultToolbarTemplate[];
-    /**
-     * Optional slot rendered before everything else. Hosts use this for a
-     * router-aware back link (e.g. `() => <Link to=...>Back</Link>`).
-     */
-    backSlot?: {
-        id?: string;
-        render: () => ReactNode;
-    };
-    /**
-     * Optional Preview action. When supplied, a `Preview` button is appended
-     * after the status badge.
-     */
-    preview?: {
-        onClick: () => void;
-        disabled?: boolean;
-        label?: ReactNode;
-    };
-    /**
-     * When `false`, the published/draft badge and autosave status text are not
-     * appended to the toolbar (hosts can show them elsewhere, e.g. an info panel).
-     * Default: `true`.
-     */
-    includePublishedAutosaveStatus?: boolean;
-    /** Items appended after the autosave-status text (e.g. project-specific badges). */
-    extraItems?: ToolbarItem[];
-    /** Override the default English labels. */
-    labels?: DefaultToolbarLabels;
-}
-/**
- * Build the standard TreeSpec editor toolbar — Reset view / Auto layout /
- * Validate / Draft history / Audit / Snapshot / Clone to Draft / Save Draft /
- * Publish / (optional) status badge + autosave label — and inject host-supplied
- * vocabulary (node types, templates, back-link slot, preview action).
- *
- * This is the opinionated SignalSafe + Bootstrap toolbar layout. Hosts using a
- * different UI library should write their own builder; the
- * {@link useTreeSpecEditor} hook does not depend on this helper.
- */
+import type { ToolbarItem } from '../panels/ToolbarPanel.js';
+import type { BuildDefaultToolbarSpecOptions } from './toolbar/defaultToolbarTypes.js';
+export { AUTOSAVE_STATUS } from '@signalsafe/tree-spec-editor-core';
+export type { BuildDefaultToolbarSpecOptions, DefaultToolbarActions, DefaultToolbarBackSlot, DefaultToolbarCapabilities, DefaultToolbarLabels, DefaultToolbarNodeType, DefaultToolbarState, DefaultToolbarTemplate, } from './toolbar/defaultToolbarTypes.js';
+/** Build the default TreeSpec editor toolbar item list from state, actions, and capability flags. */
 export declare function buildDefaultToolbarSpec(options: BuildDefaultToolbarSpecOptions): ToolbarItem[];
-export { AUTOSAVE_STATUS };
 //# sourceMappingURL=buildDefaultToolbarSpec.d.ts.map

package/dist/lib/buildDefaultToolbarSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildDefaultToolbarSpec.d.ts","sourceRoot":"","sources":["../../src/lib/buildDefaultToolbarSpec.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EACH,eAAe,EAEf,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACxB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAGH,KAAK,WAAW,EACnB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACnC,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,oDAAoD;IACpD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACnC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,KAAK,EAAE,SAAS,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC;IACtE,cAAc,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjD,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC1C,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC3C,mBAAmB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAChD,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC9C,mBAAmB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACvC,gCAAgC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6BAA6B;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACjC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,SAAS,CAAC;CAC3B;AAsBD,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC3C,mFAAmF;IACnF,KAAK,EAAE,mBAAmB,CAAC;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C,yDAAyD;IACzD,SAAS,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC,oEAAoE;IACpE,SAAS,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,SAAS,CAAA;KAAE,CAAC;IACpD;;;OAGG;IACH,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IACzE;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,oFAAoF;IACpF,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAUD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,WAAW,EAAE,CA4L9F;AAGD,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"buildDefaultToolbarSpec.d.ts","sourceRoot":"","sources":["../../src/lib/buildDefaultToolbarSpec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAW7D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAEvF,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,YAAY,EACR,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,GACzB,MAAM,kCAAkC,CAAC;AAE1C,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,WAAW,EAAE,CA+B9F"}

package/dist/lib/buildDefaultToolbarSpec.js

@@ -1,202 +1,21 @@
-import { AUTOSAVE_STATUS, getAutosaveStatusLabel, } from '@signalsafe/tree-spec-editor-core';
-import { TOOLBAR_ITEM_KIND, } from '../panels/ToolbarPanel';
-const DEFAULT_LABELS = {
-    add: '+ Add',
-    templates: 'Templates',
-    resetView: 'Reset view',
-    autoLayout: 'Auto layout',
-    validate: 'Validate',
-    draftHistory: 'Draft history',
-    audit: 'Audit',
-    snapshot: 'Snapshot',
-    snapshotInFlight: 'Creating…',
-    cloneToDraft: 'Clone to Draft',
-    cloneInFlight: 'Cloning…',
-    saveDraft: 'Save Draft',
-    saveDraftInFlight: 'Saving…',
-    publish: 'Publish',
-    publishInFlight: 'Publishing…',
-    statusPublished: 'Published (read-only)',
-    statusDraft: 'Draft',
-};
-function titleCase(type) {
-    return type
-        .split(/[_-]/)
-        .filter(Boolean)
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(' ');
-}
-/**
- * Build the standard TreeSpec editor toolbar — Reset view / Auto layout /
- * Validate / Draft history / Audit / Snapshot / Clone to Draft / Save Draft /
- * Publish / (optional) status badge + autosave label — and inject host-supplied
- * vocabulary (node types, templates, back-link slot, preview action).
- *
- * This is the opinionated SignalSafe + Bootstrap toolbar layout. Hosts using a
- * different UI library should write their own builder; the
- * {@link useTreeSpecEditor} hook does not depend on this helper.
- */
+import { appendAddDropdown, appendBackSlot, appendCapabilityButtons, appendLayoutButtons, appendSaveAndPublish, appendTemplatesDropdown, appendUndoRedo, } from './toolbar/toolbarSectionBuilders.js';
+export { AUTOSAVE_STATUS } from '@signalsafe/tree-spec-editor-core';
+/** Build the default TreeSpec editor toolbar item list from state, actions, and capability flags. */
 export function buildDefaultToolbarSpec(options) {
-    const { state, actions, capabilities = {}, nodeTypes = [], templates = [], backSlot, preview, extraItems = [], labels: labelOverrides, includePublishedAutosaveStatus = true, } = options;
-    const labels = { ...DEFAULT_LABELS, ...(labelOverrides ?? {}) };
+    const { state, actions, capabilities = {}, nodeTypes = [], templates = [], preview, labels = {}, extraItems = [], showUndoRedo = true, } = options;
     const items = [];
-    if (backSlot) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.CUSTOM,
-            id: backSlot.id ?? 'back',
-            render: backSlot.render,
-        });
-    }
-    if (nodeTypes.length > 0) {
-        const entries = nodeTypes
-            .map((nt, idx) => {
-            if (nt.divider) {
-                return { id: nt.id ?? `divider-${idx}`, label: '', divider: true };
-            }
-            if (!nt.type)
-                return null;
-            return {
-                id: nt.id ?? `add-${nt.type}`,
-                label: nt.label ?? titleCase(nt.type),
-                onClick: () => actions.addNodeOfType(nt.type, nt.patch),
-                disabled: state.isPublished,
-            };
-        })
-            .filter((e) => e !== null);
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.DROPDOWN,
-            id: 'add',
-            label: labels.add,
-            disabled: state.isPublished,
-            entries,
-        });
-    }
-    if (templates.length > 0) {
-        const entries = templates.map((t) => ({
-            id: t.id,
-            label: t.label,
-            onClick: () => actions.insertTemplate(t.spec),
-            disabled: state.isPublished,
-        }));
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.DROPDOWN,
-            id: 'templates',
-            label: labels.templates,
-            disabled: state.isPublished,
-            entries,
-        });
-    }
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.BUTTON,
-        id: 'reset-view',
-        label: labels.resetView,
-        onClick: () => actions.triggerResetView(),
-        title: 'Reset view to fit graph',
-    });
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.BUTTON,
-        id: 'auto-layout',
-        label: labels.autoLayout,
-        onClick: () => actions.autoLayout(),
-        disabled: state.isPublished,
-    });
-    if (capabilities.canValidate) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'validate',
-            label: labels.validate,
-            variant: 'outline-primary',
-            onClick: () => {
-                void actions.validate();
-            },
-            disabled: state.saving || state.publishing,
-        });
-    }
-    if (capabilities.canListSnapshots) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'draft-history',
-            label: labels.draftHistory,
-            onClick: () => actions.setShowDraftHistory(true),
-            disabled: state.isPublished,
-        });
-    }
-    if (capabilities.canListAudit) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'audit',
-            label: labels.audit,
-            onClick: () => actions.setShowAudit(true),
-        });
-    }
-    if (capabilities.canCreateSnapshot) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'snapshot',
-            label: state.creatingSnapshot ? labels.snapshotInFlight : labels.snapshot,
-            onClick: () => {
-                void actions.createSnapshot();
-            },
-            disabled: state.isPublished || !state.hasTree || state.creatingSnapshot,
-        });
-    }
-    if (capabilities.canCloneToDraft) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'clone-to-draft',
-            label: state.cloning ? labels.cloneInFlight : labels.cloneToDraft,
-            onClick: () => {
-                void actions.cloneToDraft();
-            },
-            disabled: state.cloning,
-        });
-    }
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.BUTTON,
-        id: 'save-draft',
-        label: state.saving ? labels.saveDraftInFlight : labels.saveDraft,
-        variant: 'primary',
-        onClick: () => {
-            void actions.saveDraft();
-        },
-        disabled: state.isPublished || state.saving || state.publishing,
-    });
-    if (capabilities.canPublish) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'publish',
-            label: state.publishing ? labels.publishInFlight : labels.publish,
-            variant: 'success',
-            onClick: () => actions.setShowPublishModal(true),
-            disabled: state.isPublished || !state.canPublish || state.saving || state.publishing,
-        });
-    }
-    if (preview) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'preview',
-            label: preview.label ?? 'Preview',
-            variant: 'outline-dark',
-            onClick: preview.onClick,
-            disabled: preview.disabled ?? false,
-        });
-    }
-    if (includePublishedAutosaveStatus) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BADGE,
-            id: 'status',
-            label: state.isPublished ? labels.statusPublished : labels.statusDraft,
-            variant: state.isPublished ? 'success' : 'secondary',
-        });
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.TEXT,
-            id: 'autosave',
-            content: getAutosaveStatusLabel(state.autosaveStatus),
-        });
-    }
-    if (extraItems.length > 0)
-        items.push(...extraItems);
+    const toolbarBackSlot = options.toolbarBackSlot;
+    if (toolbarBackSlot) {
+        appendBackSlot(items, toolbarBackSlot);
+    }
+    appendAddDropdown(items, nodeTypes, actions, labels, state.isPublished);
+    appendTemplatesDropdown(items, templates, actions, labels, state.isPublished);
+    appendLayoutButtons(items, state, actions, labels);
+    if (showUndoRedo) {
+        appendUndoRedo(items, state, actions, labels);
+    }
+    appendCapabilityButtons(items, capabilities, state, actions, labels);
+    appendSaveAndPublish(items, capabilities, state, actions, labels, preview);
+    items.push(...extraItems);
     return items;
 }
-// Re-exported for tests / hosts wiring the autosave label themselves.
-export { AUTOSAVE_STATUS };

package/dist/lib/panelHelpers.d.ts

@@ -1,9 +1,3 @@
-/**
- * Map a TreeSpec issue severity to the matching Bootstrap badge classes.
- *
- * This lives in the Bootstrap-flavored package because the returned class
- * names are Bootstrap-specific. Material / Angular shells expose their own
- * equivalent helper.
- */
+/** Bootstrap severity badge class for issue rows. */
 export declare function getIssueSeverityBadgeClass(severity: string): string;
 //# sourceMappingURL=panelHelpers.d.ts.map

package/dist/lib/panelHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panelHelpers.d.ts","sourceRoot":"","sources":["../../src/lib/panelHelpers.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAInE"}
+{"version":3,"file":"panelHelpers.d.ts","sourceRoot":"","sources":["../../src/lib/panelHelpers.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWnE"}

package/dist/lib/panelHelpers.js

@@ -1,22 +1,14 @@
-/**
- * Bootstrap-flavored helpers for the editor sidebar panels.
- *
- * Pure / framework-agnostic helpers (e.g. {@link buildStableEntries}) live in
- * `@signalsafe/tree-spec-editor-core` and are re-exported from this package's
- * barrel for consumer convenience.
- */
 import { TREE_SPEC_ISSUE_SEVERITY } from '@signalsafe/tree-spec';
-/**
- * Map a TreeSpec issue severity to the matching Bootstrap badge classes.
- *
- * This lives in the Bootstrap-flavored package because the returned class
- * names are Bootstrap-specific. Material / Angular shells expose their own
- * equivalent helper.
- */
+/** Bootstrap severity badge class for issue rows. */
 export function getIssueSeverityBadgeClass(severity) {
-    if (severity === TREE_SPEC_ISSUE_SEVERITY.ERROR)
-        return 'bg-danger';
-    if (severity === TREE_SPEC_ISSUE_SEVERITY.WARNING)
-        return 'bg-warning text-dark';
-    return 'bg-info';
+    switch (severity) {
+        case TREE_SPEC_ISSUE_SEVERITY.ERROR:
+            return 'text-bg-danger';
+        case TREE_SPEC_ISSUE_SEVERITY.WARNING:
+            return 'text-bg-warning text-dark';
+        case TREE_SPEC_ISSUE_SEVERITY.INFO:
+            return 'text-bg-info text-dark';
+        default:
+            return 'text-bg-secondary';
+    }
 }

package/dist/lib/panelNodeLink.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react';
+import type { EditorTransition } from '@signalsafe/tree-spec-editor-core';
+export interface PanelNodeLinkContext {
+    onNodeSelect?: (nodeId: string) => void;
+}
+/** Clickable node id for panel breadcrumb lines; plain text when `onNodeSelect` is unset. */
+export declare function PanelNodeLink({ nodeId, onNodeSelect, }: Readonly<{
+    nodeId: string;
+    onNodeSelect?: (nodeId: string) => void;
+}>): ReactNode;
+/** Default `from · choice → to` line for selected transitions. */
+export declare function renderDefaultEdgeBreadcrumb(edge: EditorTransition, { onNodeSelect }: PanelNodeLinkContext): ReactNode;
+//# sourceMappingURL=panelNodeLink.d.ts.map

package/dist/lib/panelNodeLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelNodeLink.d.ts","sourceRoot":"","sources":["../../src/lib/panelNodeLink.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACjC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,EAC1B,MAAM,EACN,YAAY,GACf,EAAE,QAAQ,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,CAAC,GAAG,SAAS,CAcb;AAED,kEAAkE;AAClE,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,gBAAgB,EACtB,EAAE,YAAY,EAAE,EAAE,oBAAoB,GACvC,SAAS,CAUX"}

package/dist/lib/panelNodeLink.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/** Clickable node id for panel breadcrumb lines; plain text when `onNodeSelect` is unset. */
+export function PanelNodeLink({ nodeId, onNodeSelect, }) {
+    if (!onNodeSelect) {
+        return nodeId;
+    }
+    return (_jsx("button", { type: "button", className: "btn btn-link p-0 align-baseline font-size-12", onClick: () => onNodeSelect(nodeId), children: nodeId }));
+}
+/** Default `from · choice → to` line for selected transitions. */
+export function renderDefaultEdgeBreadcrumb(edge, { onNodeSelect }) {
+    return (_jsxs(_Fragment, { children: [_jsx(PanelNodeLink, { nodeId: edge.fromNodeId, onNodeSelect: onNodeSelect }), ' · ', edge.fromChoiceId, ' → ', _jsx(PanelNodeLink, { nodeId: edge.toNodeId, onNodeSelect: onNodeSelect })] }));
+}

package/dist/lib/selectionStyles.d.ts

@@ -0,0 +1,9 @@
+/** Bootstrap list-group selection highlight (subtle primary background). */
+export declare const LIST_SELECTION_CLASS = "list-group-item-primary";
+/** Dark readable text on {@link LIST_SELECTION_CLASS} rows (sidebar Nodes / Issues). */
+export declare const LIST_SELECTION_TEXT_CLASS = "graph-editor-sidebar-selected";
+/** Canvas / card selection highlight matching list selection. */
+export declare const CANVAS_SELECTION_CLASS = "bg-primary-subtle";
+/** Dark readable text on {@link CANVAS_SELECTION_CLASS} graph nodes. */
+export declare const CANVAS_SELECTION_TEXT_CLASS = "graph-editor-canvas-selected";
+//# sourceMappingURL=selectionStyles.d.ts.map

package/dist/lib/selectionStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionStyles.d.ts","sourceRoot":"","sources":["../../src/lib/selectionStyles.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAE9D,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,wEAAwE;AACxE,eAAO,MAAM,2BAA2B,iCAAiC,CAAC"}

package/dist/lib/selectionStyles.js

@@ -0,0 +1,8 @@
+/** Bootstrap list-group selection highlight (subtle primary background). */
+export const LIST_SELECTION_CLASS = 'list-group-item-primary';
+/** Dark readable text on {@link LIST_SELECTION_CLASS} rows (sidebar Nodes / Issues). */
+export const LIST_SELECTION_TEXT_CLASS = 'graph-editor-sidebar-selected';
+/** Canvas / card selection highlight matching list selection. */
+export const CANVAS_SELECTION_CLASS = 'bg-primary-subtle';
+/** Dark readable text on {@link CANVAS_SELECTION_CLASS} graph nodes. */
+export const CANVAS_SELECTION_TEXT_CLASS = 'graph-editor-canvas-selected';

package/dist/lib/toolbar/defaultToolbarTypes.d.ts

@@ -0,0 +1,89 @@
+import type { ReactNode } from 'react';
+import { type AutosaveStatus, type TreeTemplateSpec } from '@signalsafe/tree-spec-editor-core';
+import type { ToolbarItem } from '../../panels/ToolbarPanel.js';
+export { AUTOSAVE_STATUS } from '@signalsafe/tree-spec-editor-core';
+export interface DefaultToolbarCapabilities {
+    canValidate?: boolean;
+    canListSnapshots?: boolean;
+    canListAudit?: boolean;
+    canCreateSnapshot?: boolean;
+    canCloneToDraft?: boolean;
+    canPublish?: boolean;
+}
+export interface DefaultToolbarNodeType {
+    type?: string;
+    label?: string;
+    divider?: boolean;
+    id?: string;
+    patch?: Record<string, unknown>;
+}
+export interface DefaultToolbarTemplate {
+    id: string;
+    label: string;
+    spec: TreeTemplateSpec;
+}
+export interface DefaultToolbarLabels {
+    add?: string;
+    templates?: string;
+    validate?: string;
+    autoLayout?: string;
+    resetView?: string;
+    preview?: string;
+    save?: string;
+    publish?: string;
+    history?: string;
+    audit?: string;
+    snapshot?: string;
+    clone?: string;
+    undo?: string;
+    redo?: string;
+}
+export interface DefaultToolbarState {
+    isPublished: boolean;
+    saving: boolean;
+    publishing: boolean;
+    creatingSnapshot: boolean;
+    cloning: boolean;
+    canPublish: boolean;
+    hasTree: boolean;
+    autosaveStatus: AutosaveStatus;
+    canUndo?: boolean;
+    canRedo?: boolean;
+}
+export interface DefaultToolbarActions {
+    addNodeOfType: (type: string, patch?: Record<string, unknown>) => void;
+    insertTemplate: (spec: TreeTemplateSpec) => void;
+    triggerResetView: () => void;
+    autoLayout: () => void;
+    validate: () => void | Promise<void>;
+    saveDraft: () => void | Promise<void>;
+    setShowDraftHistory: (show: boolean) => void;
+    setShowAudit: (show: boolean) => void;
+    createSnapshot: () => void | Promise<void>;
+    cloneToDraft: () => void | Promise<void>;
+    setShowPublishModal: (show: boolean) => void;
+    undo?: () => void;
+    redo?: () => void;
+}
+export type DefaultToolbarBackSlot = {
+    id?: string;
+    render: () => ReactNode;
+};
+export interface BuildDefaultToolbarSpecOptions {
+    state: DefaultToolbarState;
+    actions: DefaultToolbarActions;
+    capabilities?: DefaultToolbarCapabilities;
+    nodeTypes?: DefaultToolbarNodeType[];
+    templates?: DefaultToolbarTemplate[];
+    /** Optional legacy toolbar back control when page breadcrumbs are not used. */
+    toolbarBackSlot?: DefaultToolbarBackSlot;
+    preview?: {
+        onClick: () => void;
+        disabled?: boolean;
+    };
+    labels?: DefaultToolbarLabels;
+    extraItems?: ToolbarItem[];
+    /** When false, omit Undo/Redo buttons even if `actions.undo` / `actions.redo` are set. Default true. */
+    showUndoRedo?: boolean;
+}
+//# sourceMappingURL=defaultToolbarTypes.d.ts.map

package/dist/lib/toolbar/defaultToolbarTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultToolbarTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/toolbar/defaultToolbarTypes.ts"],"names":[],"mappings":"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"}

package/dist/lib/toolbar/defaultToolbarTypes.js

@@ -0,0 +1 @@
+export { AUTOSAVE_STATUS } from '@signalsafe/tree-spec-editor-core';

package/dist/lib/toolbar/toolbarSectionBuilders.d.ts

@@ -0,0 +1,10 @@
+import { type ToolbarItem } from '../../panels/ToolbarPanel.js';
+import type { BuildDefaultToolbarSpecOptions, DefaultToolbarActions, DefaultToolbarBackSlot, DefaultToolbarCapabilities, DefaultToolbarLabels, DefaultToolbarNodeType, DefaultToolbarState, DefaultToolbarTemplate } from './defaultToolbarTypes.js';
+export declare function appendBackSlot(items: ToolbarItem[], slot: DefaultToolbarBackSlot): void;
+export declare function appendAddDropdown(items: ToolbarItem[], nodeTypes: DefaultToolbarNodeType[], actions: DefaultToolbarActions, labels: DefaultToolbarLabels, isPublished: boolean): void;
+export declare function appendTemplatesDropdown(items: ToolbarItem[], templates: DefaultToolbarTemplate[], actions: DefaultToolbarActions, labels: DefaultToolbarLabels, isPublished: boolean): void;
+export declare function appendLayoutButtons(items: ToolbarItem[], state: DefaultToolbarState, actions: DefaultToolbarActions, labels: DefaultToolbarLabels): void;
+export declare function appendUndoRedo(items: ToolbarItem[], state: DefaultToolbarState, actions: DefaultToolbarActions, labels: DefaultToolbarLabels): void;
+export declare function appendCapabilityButtons(items: ToolbarItem[], capabilities: DefaultToolbarCapabilities, state: DefaultToolbarState, actions: DefaultToolbarActions, labels: DefaultToolbarLabels): void;
+export declare function appendSaveAndPublish(items: ToolbarItem[], capabilities: DefaultToolbarCapabilities, state: DefaultToolbarState, actions: DefaultToolbarActions, labels: DefaultToolbarLabels, preview: BuildDefaultToolbarSpecOptions['preview']): void;
+//# sourceMappingURL=toolbarSectionBuilders.d.ts.map

package/dist/lib/toolbar/toolbarSectionBuilders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbarSectionBuilders.d.ts","sourceRoot":"","sources":["../../../src/lib/toolbar/toolbarSectionBuilders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,KAAK,EACR,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACzB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,cAAc,CAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,IAAI,EAAE,sBAAsB,GAC7B,IAAI,CAMN;AAED,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,WAAW,EAAE,EACpB,SAAS,EAAE,sBAAsB,EAAE,EACnC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,OAAO,GACrB,IAAI,CAsBN;AAED,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,WAAW,EAAE,EACpB,SAAS,EAAE,sBAAsB,EAAE,EACnC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,OAAO,GACrB,IAAI,CAcN;AAED,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB,GAC7B,IAAI,CAkBN;AAED,wBAAgB,cAAc,CAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB,GAC7B,IAAI,CAoBN;AAED,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,WAAW,EAAE,EACpB,YAAY,EAAE,0BAA0B,EACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB,GAC7B,IAAI,CAkDN;AAED,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,YAAY,EAAE,0BAA0B,EACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,8BAA8B,CAAC,SAAS,CAAC,GACnD,IAAI,CA8BN"}