@signalsafe/tree-spec-editor 0.2.1 → 0.2.3

package/dist/index.js

@@ -22,21 +22,25 @@
  * - `lib/` — UI-flavored helpers (Bootstrap severity badge classes)
  */
 export { default } from '@signalsafe/tree-spec-editor-react';
-export { default as IssuesPanel } from './panels/IssuesPanel';
-export { default as GraphEditorInfoPanel } from './panels/GraphEditorInfoPanel';
-export { default as NodesPanel } from './panels/NodesPanel';
-export { default as AdvancedJsonPanel } from './panels/AdvancedJsonPanel';
-export { default as InspectorPanel, DEFAULT_OUTCOME_OPTIONS } from './panels/InspectorPanel';
-export { default as SelectedEdgePanel } from './panels/SelectedEdgePanel';
-export { default as PublishReviewModal } from './modals/PublishReviewModal';
-export { default as DraftHistoryModal } from './modals/DraftHistoryModal';
-export { default as AuditLogModal } from './modals/AuditLogModal';
-export { default as ToolbarPanel, TOOLBAR_ITEM_KIND } from './panels/ToolbarPanel';
-export { getIssueSeverityBadgeClass } from './lib/panelHelpers';
-export { default as PanelHeaderCollapseCarets } from './lib/PanelHeaderCollapseCarets';
-export { buildDefaultToolbarSpec } from './lib/buildDefaultToolbarSpec';
+export { default as IssuesPanel } from './panels/IssuesPanel.js';
+export { default as GraphEditorInfoPanel } from './panels/GraphEditorInfoPanel.js';
+export { default as NodesPanel } from './panels/NodesPanel.js';
+export { default as AdvancedJsonPanel } from './panels/AdvancedJsonPanel.js';
+export { default as InspectorPanel, DEFAULT_OUTCOME_OPTIONS } from './panels/InspectorPanel.js';
+export { default as AppearancePanel } from './panels/AppearancePanel.js';
+export { default as SelectedEdgePanel } from './panels/SelectedEdgePanel.js';
+export { default as ChoiceTemplatesPanel } from './panels/ChoiceTemplatesPanel.js';
+export { default as ChoiceEdgeAppearanceFields } from './panels/ChoiceEdgeAppearanceFields.js';
+export { default as PublishReviewModal } from './modals/PublishReviewModal.js';
+export { default as DraftHistoryModal } from './modals/DraftHistoryModal.js';
+export { default as AuditLogModal } from './modals/AuditLogModal.js';
+export { default as ToolbarPanel, TOOLBAR_ITEM_KIND } from './panels/ToolbarPanel.js';
+export { getIssueSeverityBadgeClass } from './lib/panelHelpers.js';
+export { LIST_SELECTION_CLASS, CANVAS_SELECTION_CLASS, LIST_SELECTION_TEXT_CLASS, CANVAS_SELECTION_TEXT_CLASS } from './lib/selectionStyles.js';
+export { default as PanelHeaderCollapseCarets } from './lib/PanelHeaderCollapseCarets.js';
+export { buildDefaultToolbarSpec } from './lib/buildDefaultToolbarSpec.js';
 /* ------------------------------------------------------------------------- */
 /* Framework-agnostic re-exports from @signalsafe/tree-spec-editor-core.     */
 /* Hosts may consume these directly from `-core` to skip the React surface.  */
 /* ------------------------------------------------------------------------- */
-export { END_NODE_ID, GRAPH_SELECTION_KIND, safeUUID, getTransition, upsertTransition, deleteTransitionsForChoice, lintEditorTree, parsePydanticOutcomeErrors, shouldQueueInitialValidation, TREE_SPEC_NODE_TYPE_PRESETS, autoLayoutTree, getNextSpawnPosition, getAutosaveStatusLabel, AUTOSAVE_STATUS, getKeyboardShortcutAction, KEYBOARD_SHORTCUT_ACTION, applyTreeTemplate, computeTreeDiffSummary, deleteNode, duplicateNode, buildStableEntries, } from '@signalsafe/tree-spec-editor-core';
+export { END_NODE_ID, GRAPH_SELECTION_KIND, safeUUID, getTransition, upsertTransition, deleteTransitionsForChoice, lintEditorTree, parsePydanticOutcomeErrors, shouldQueueInitialValidation, TREE_SPEC_NODE_TYPE_PRESETS, autoLayoutTree, getNextSpawnPosition, needsInitialLayout, getThemeHints, getEditorHints, isNodeLocked, patchEditorHints, editorHintsToStyle, RENDER_HINTS_THEME_NS, RENDER_HINTS_EDITOR_NS, GRAPH_POSITION_KEY, getAutosaveStatusLabel, AUTOSAVE_STATUS, getKeyboardShortcutAction, KEYBOARD_SHORTCUT_ACTION, applyTreeTemplate, applyEditorConnectOnDrop, computeTreeDiffSummary, deleteNode, duplicateNode, buildStableEntries, } from '@signalsafe/tree-spec-editor-core';

package/dist/lib/PanelHeaderCollapseCarets.d.ts

@@ -3,5 +3,5 @@ export interface PanelHeaderCollapseCaretsProps {
     onToggle: () => void;
 }
 /** Collapse/expand carets for card panel headers. */
-export default function PanelHeaderCollapseCarets({ expanded, onToggle, }: Readonly<PanelHeaderCollapseCaretsProps>): import("react/jsx-runtime").JSX.Element;
+export default function PanelHeaderCollapseCarets({ expanded, onToggle, }: Readonly<PanelHeaderCollapseCaretsProps>): import("react").JSX.Element;
 //# sourceMappingURL=PanelHeaderCollapseCarets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PanelHeaderCollapseCarets.d.ts","sourceRoot":"","sources":["../../src/lib/PanelHeaderCollapseCarets.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,EAC9C,QAAQ,EACR,QAAQ,GACX,EAAE,QAAQ,CAAC,8BAA8B,CAAC,2CAY1C"}
+{"version":3,"file":"PanelHeaderCollapseCarets.d.ts","sourceRoot":"","sources":["../../src/lib/PanelHeaderCollapseCarets.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,EAC9C,QAAQ,EACR,QAAQ,GACX,EAAE,QAAQ,CAAC,8BAA8B,CAAC,+BAY1C"}

package/dist/lib/buildDefaultToolbarSpec.d.ts

@@ -1,83 +1,7 @@
-import type { ReactNode } from 'react';
-import { type AutosaveStatus, type TreeTemplateSpec } from '@signalsafe/tree-spec-editor-core';
-import { type ToolbarItem } from '../panels/ToolbarPanel.js';
+import type { ToolbarItem } from '../panels/ToolbarPanel.js';
+import type { BuildDefaultToolbarSpecOptions } from './toolbar/defaultToolbarTypes.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;
-    draftBadge?: string;
-    publishedBadge?: string;
-}
-export interface DefaultToolbarState {
-    isPublished: boolean;
-    saving: boolean;
-    publishing: boolean;
-    creatingSnapshot: boolean;
-    cloning: boolean;
-    canPublish: boolean;
-    hasTree: boolean;
-    autosaveStatus: AutosaveStatus;
-}
-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;
-}
-export interface BuildDefaultToolbarSpecOptions {
-    state: DefaultToolbarState;
-    actions: DefaultToolbarActions;
-    capabilities?: DefaultToolbarCapabilities;
-    nodeTypes?: DefaultToolbarNodeType[];
-    templates?: DefaultToolbarTemplate[];
-    backSlot?: {
-        id?: string;
-        render: () => ReactNode;
-    };
-    preview?: {
-        onClick: () => void;
-        disabled?: boolean;
-    };
-    labels?: DefaultToolbarLabels;
-    extraItems?: ToolbarItem[];
-}
+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[];
 //# 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.ts"],"names":[],"mappings":"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"}
+{"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,167 +1,21 @@
-import { getAutosaveStatusLabel, } from '@signalsafe/tree-spec-editor-core';
-import { TOOLBAR_ITEM_KIND } from '../panels/ToolbarPanel.js';
+import { appendAddDropdown, appendBackSlot, appendCapabilityButtons, appendLayoutButtons, appendSaveAndPublish, appendTemplatesDropdown, appendUndoRedo, } from './toolbar/toolbarSectionBuilders.js';
 export { AUTOSAVE_STATUS } from '@signalsafe/tree-spec-editor-core';
-function appendBackSlot(items, backSlot) {
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.CUSTOM,
-        id: backSlot.id ?? 'back',
-        render: backSlot.render,
-    });
-}
-function appendAddDropdown(items, nodeTypes, actions, labels, isPublished) {
-    const addEntries = nodeTypes.map((entry, index) => {
-        if (entry.divider) {
-            return { id: entry.id ?? `divider-${index}`, label: '', divider: true };
-        }
-        const type = entry.type ?? 'prompt';
-        return {
-            id: entry.id ?? `add-${type}`,
-            label: entry.label ?? type,
-            onClick: () => actions.addNodeOfType(type, entry.patch),
-        };
-    });
-    if (addEntries.length === 0)
-        return;
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.DROPDOWN,
-        id: 'add',
-        label: labels.add ?? '+ Add',
-        disabled: isPublished,
-        entries: addEntries,
-    });
-}
-function appendTemplatesDropdown(items, templates, actions, labels, isPublished) {
-    if (templates.length === 0)
-        return;
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.DROPDOWN,
-        id: 'templates',
-        label: labels.templates ?? 'Templates',
-        disabled: isPublished,
-        entries: templates.map((t) => ({
-            id: t.id,
-            label: t.label,
-            onClick: () => actions.insertTemplate(t.spec),
-        })),
-    });
-}
-function appendLayoutButtons(items, state, actions, labels) {
-    const { isPublished, hasTree } = state;
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.BUTTON,
-        id: 'reset-view',
-        label: labels.resetView ?? 'Reset view',
-        disabled: !hasTree,
-        onClick: () => actions.triggerResetView(),
-    }, {
-        kind: TOOLBAR_ITEM_KIND.BUTTON,
-        id: 'auto-layout',
-        label: labels.autoLayout ?? 'Auto layout',
-        disabled: !hasTree || isPublished,
-        onClick: () => actions.autoLayout(),
-    });
-}
-function appendCapabilityButtons(items, capabilities, state, actions, labels) {
-    const { isPublished, creatingSnapshot, cloning, hasTree } = state;
-    if (capabilities.canValidate) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'validate',
-            label: labels.validate ?? 'Validate',
-            disabled: !hasTree,
-            onClick: () => void actions.validate(),
-        });
-    }
-    if (capabilities.canListSnapshots) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'draft-history',
-            label: labels.history ?? 'Draft history',
-            onClick: () => actions.setShowDraftHistory(true),
-        });
-    }
-    if (capabilities.canListAudit) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'audit',
-            label: labels.audit ?? 'Audit log',
-            onClick: () => actions.setShowAudit(true),
-        });
-    }
-    if (capabilities.canCreateSnapshot) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'snapshot',
-            label: creatingSnapshot ? 'Creating…' : (labels.snapshot ?? 'Snapshot'),
-            disabled: isPublished || creatingSnapshot || !hasTree,
-            onClick: () => void actions.createSnapshot(),
-        });
-    }
-    if (capabilities.canCloneToDraft) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'clone-to-draft',
-            label: cloning ? 'Cloning…' : (labels.clone ?? 'Clone to draft'),
-            disabled: cloning,
-            onClick: () => void actions.cloneToDraft(),
-        });
-    }
-}
-function appendSaveAndPublish(items, capabilities, state, actions, labels, preview) {
-    const { isPublished, saving, publishing, canPublish, hasTree } = state;
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.BUTTON,
-        id: 'save-draft',
-        label: saving ? 'Saving…' : (labels.save ?? 'Save draft'),
-        disabled: isPublished || saving || !hasTree,
-        onClick: () => void actions.saveDraft(),
-    });
-    if (capabilities.canPublish) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'publish',
-            label: publishing ? 'Publishing…' : (labels.publish ?? 'Publish'),
-            disabled: isPublished || publishing || !canPublish,
-            onClick: () => actions.setShowPublishModal(true),
-        });
-    }
-    if (preview) {
-        items.push({
-            kind: TOOLBAR_ITEM_KIND.BUTTON,
-            id: 'preview',
-            label: labels.preview ?? 'Preview',
-            disabled: preview.disabled ?? false,
-            onClick: preview.onClick,
-        });
-    }
-}
-function appendStatusFooter(items, state, labels, extraItems) {
-    const { isPublished, autosaveStatus } = state;
-    items.push({
-        kind: TOOLBAR_ITEM_KIND.BADGE,
-        id: 'status',
-        label: isPublished
-            ? (labels.publishedBadge ?? 'Published')
-            : (labels.draftBadge ?? 'Draft'),
-        variant: isPublished ? 'success' : 'secondary',
-    }, {
-        kind: TOOLBAR_ITEM_KIND.TEXT,
-        id: 'autosave',
-        content: getAutosaveStatusLabel(autosaveStatus),
-    }, ...extraItems);
-}
 /** 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, labels = {}, extraItems = [], } = options;
+    const { state, actions, capabilities = {}, nodeTypes = [], templates = [], preview, labels = {}, extraItems = [], showUndoRedo = true, } = options;
     const items = [];
-    if (backSlot) {
-        appendBackSlot(items, backSlot);
+    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);
-    appendStatusFooter(items, state, labels, extraItems);
+    items.push(...extraItems);
     return items;
 }

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"}