@hlang-tech/editor-ui 0.4.0 → 0.5.0

package/README.md

@@ -52,9 +52,9 @@ See the [playground](https://github.com/hlang-tech/hlang/tree/main/examples/edit
 | Area | Exports |
 | --- | --- |
 | Nodes and edges | `HlangNode`, `AssetNodeChrome`, `PillNodeChrome`, `NodeChrome`, `PortRow`, `SignalBar`, `NodeBodySlot`, `FlowEdge`, `createHlangFlowTypes` |
-| Shell and toolbar | `EditorShell`, `Toolbar`, `UndoRedo`, `RunButton`, `ToolbarStat`, `ToolbarGhostButton`, `ToolCluster` |
+| Shell and toolbar | `EditorShell`, `Toolbar`, `UndoRedo`, `RunButton`, `ToolbarStat`, `ToolbarGhostButton`, `ToolCluster`, `ReadOnlyBadge` |
 | Canvas | `CanvasChrome`, `CanvasDock`, `EmptyState` |
-| Panels | `OutlineTree`, `RailTabs`, `AssetGrid`, `InspectorPanel`, `ParamForm`, `PositionPanel`, `PreviewPanel`, `DiagnosticBadge` |
+| Panels | `OutlineTree`, `RailTabs`, `AssetGrid`, `InspectorPanel`, `ParamForm`, `PositionPanel`, `PreviewPanel`, `DiagnosticBadge`, `RunLog`, `PanelHead`, `PanelAction` |
 | Creating nodes | `NodeSearch`, `useNodeSearch`, `useNodeSearchTriggers` (double-click the canvas, or drop a connection on empty space) |
 | Interaction | `useEditorHotkeys`, `NodeContextMenu`, `useNodeContextMenu`, `NodeInteractionProvider`, `Cheatsheet`, `ToastProvider` |
 | Live execution | `LiveSignalProvider`, `LiveSignalStore`, `useLiveSignals`, `useNodeLiveState`, `useEdgeFlowing` |
@@ -64,6 +64,14 @@ See the [playground](https://github.com/hlang-tech/hlang/tree/main/examples/edit
 
 `useEditorHotkeys(core)` binds undo (`⌘Z`), redo (`⇧⌘Z` or `⌘Y`), copy, cut, paste, duplicate (`⌘D`), select all (`⌘A`), and delete (`Delete` or `Backspace`). `Ctrl` replaces `⌘` on Windows and Linux. Shortcuts are ignored while a text field has focus.
 
+### Read-only editors
+
+When the core is read-only (`core.mode`), the inspector, the connection inspector and the position panel disable their fields, and the node-search triggers open nothing. Pass `readOnly` to `CanvasDock` to keep only its view controls, and leave `rename` out of `NodeInteraction` so a node's name cannot be edited in place. `ReadOnlyBadge` says so in the toolbar.
+
+### Panel headers
+
+`PanelHead` and `PanelAction` respond to the header's own width, not the window's: a narrow header shows its actions as icons (the labels stay their accessible names and tooltips) and then drops its status.
+
 ### Live execution
 
 `useLiveSignals(core, handle)` feeds a run's activity and errors into a `LiveSignalStore`. Nodes and edges subscribe by id, so only the elements whose state changes re-render.

package/lib/index.d.mts

@@ -396,6 +396,21 @@ declare function ToolbarGhostButton({ children, onClick, title, }: {
     readonly title?: string;
 }): ReactElement;
 
+/**
+ * `ReadOnlyBadge` — says, in the toolbar, that the graph can be looked at
+ * and run but not changed (the editor core is read-only; see editor-core's
+ * `IEditorModeService`). The host says why in `title`. In a narrow toolbar it
+ * keeps only its lock; the label stays its accessible name.
+ */
+
+interface ReadOnlyBadgeProps {
+    /** The badge's text. */
+    readonly label?: string;
+    /** Why the editor is read-only, shown as its tooltip. */
+    readonly title?: string;
+}
+declare function ReadOnlyBadge({ label, title }: ReadOnlyBadgeProps): ReactElement;
+
 /**
  * `ToolCluster` — the centred group of canvas tools in the top bar (nover-style):
  * a row of icon buttons with optional separators, in the black/silver glass
@@ -438,6 +453,10 @@ declare function CanvasChrome({ background }: CanvasChromeProps): ReactElement;
  * glass language. It replaces React Flow's default corner Controls + MiniMap
  * with one calm, centred dock.
  *
+ * A read-only dock (`readOnly`) keeps only the view controls (zoom, fit):
+ * undo, redo, the pointer modes and add-node all change the graph or exist
+ * to edit it.
+ *
  * Presentation only: it renders buttons and the current zoom %, and calls back
  * to the host for every action. It holds no React Flow or graph state — the host
  * wires the callbacks to `useReactFlow()` (zoom/fit) and the node search (add).
@@ -461,8 +480,10 @@ interface CanvasDockProps {
     readonly onRedo: () => void;
     readonly canUndo: boolean;
     readonly canRedo: boolean;
+    /** Show the view controls only: the graph cannot be edited. */
+    readonly readOnly?: boolean;
 }
-declare function CanvasDock({ zoom, onZoomIn, onZoomOut, onFitView, onAdd, mode, onModeChange, onUndo, onRedo, canUndo, canRedo, }: CanvasDockProps): ReactElement;
+declare function CanvasDock({ zoom, onZoomIn, onZoomOut, onFitView, onAdd, mode, onModeChange, onUndo, onRedo, canUndo, canRedo, readOnly, }: CanvasDockProps): ReactElement;
 
 /**
  * `EmptyState` — a quiet, centered hint shown over an empty canvas. Purely
@@ -529,6 +550,59 @@ interface PreviewPanelProps {
 }
 declare function PreviewPanel({ imageUrl, title, status }: PreviewPanelProps): ReactElement;
 
+/**
+ * `PanelHead` and `PanelAction` — the header row of a docked panel (the
+ * console, the run log): what the panel is, a short status, and its actions.
+ *
+ * The header responds to its own width, not the window's (a container query,
+ * as VS Code's and DevTools' panel toolbars do): when it is narrow the actions
+ * drop their labels and keep their icons, and then the status gives way. A
+ * label that is not shown is still the button's accessible name, and its
+ * tooltip.
+ */
+
+interface PanelHeadProps {
+    /** What the panel is: its title, or the host's tabs. */
+    readonly leading: ReactNode;
+    /** A short status after it, e.g. a count; the first thing to go when the panel is narrow. */
+    readonly meta?: ReactNode;
+    /** The panel's actions, usually `PanelAction`s. */
+    readonly children?: ReactNode;
+}
+declare function PanelHead({ leading, meta, children }: PanelHeadProps): ReactElement;
+interface PanelActionProps {
+    readonly icon: ReactNode;
+    /** The action's name: shown when there is room, and always its accessible name. */
+    readonly label: string;
+    readonly onClick: () => void;
+    /** For a toggle: whether it is on. Leave out for a plain action. */
+    readonly pressed?: boolean;
+    readonly disabled?: boolean;
+    /** The tooltip; the label by default. */
+    readonly title?: string;
+}
+declare function PanelAction({ icon, label, onClick, pressed, disabled, title }: PanelActionProps): ReactElement;
+
+/**
+ * Per-type node icons. A small registry mapping a node `code` to a crisp
+ * line-glyph (1.5px stroke, currentColor), with a kind fallback (R/T/W). Used
+ * by the outline tree and the node chrome so every node reads by its ROLE, not
+ * a generic letter — the difference between a tool and a spreadsheet.
+ *
+ * Icons are inline SVG (not emoji) for a premium, monochrome, scalable look;
+ * they inherit `color` so callers tint them by kind or silver.
+ */
+
+interface IconProps {
+    readonly size?: number;
+}
+/** Funnel — show only what involves the selection. */
+declare function FilterIcon({ size }: IconProps): ReactElement;
+/** Arrow onto a line — keep the newest entry in view. */
+declare function FollowIcon({ size }: IconProps): ReactElement;
+/** Circle with a stroke through it — clear the log (DevTools' glyph). */
+declare function ClearIcon({ size }: IconProps): ReactElement;
+
 /**
  * `RailTabs` — the segmented tab strip at the top of a side rail (Outline /
  * Insert / Assets, nover-style), in the black/silver glass language. Purely
@@ -659,8 +733,10 @@ interface ParamFormProps {
     readonly fields: readonly ParamField[];
     /** Commit a single field's new value (undoable, handled by the caller). */
     readonly onCommit: (key: string, value: ParamValue) => void;
+    /** Disables every field, e.g. in a read-only editor. */
+    readonly disabled?: boolean;
 }
-declare function ParamForm({ fields, onCommit }: ParamFormProps): ReactElement;
+declare function ParamForm({ fields, onCommit, disabled }: ParamFormProps): ReactElement;
 
 /**
  * `useNodeParams` — reactively read a node's params and commit edits through the
@@ -845,6 +921,9 @@ declare function NodeSearch({ controller }: NodeSearchProps): ReactElement | nul
  *     only for the pane, never for nodes/edges/handles) rather than a raw DOM
  *     double-click, so this never reaches into React Flow's internal markup.
  *
+ * A read-only editor (`core.mode.readOnly`) opens nothing: the palette only
+ * adds nodes, which a read-only graph refuses.
+ *
  * Screen→flow coordinate conversion uses the React Flow instance, so created
  * nodes land under the pointer regardless of pan/zoom. This hook must be used
  * within a `ReactFlowProvider` (React Flow's own requirement for `useReactFlow`).
@@ -966,15 +1045,19 @@ declare function NodeContextMenu({ controller, items }: NodeContextMenuProps): R
  * `NodeInteractionContext` — optional per-node interaction wiring supplied by the
  * host (diagnostics to badge, rename to commit). Node chrome reads it to render a
  * diagnostic badge and to support inline rename, but degrades gracefully to a
- * plain, read-only node when no provider is present — so editor-ui stays usable
+ * plain node that cannot be renamed when no provider is present, or when the
+ * host leaves `rename` out (a read-only editor) — so editor-ui stays usable
  * without the full editor wiring.
  */
 
 interface NodeInteraction {
     /** The most severe diagnostic on a node, or undefined. */
     diagnosticFor(id: NodeId): Diagnostic | undefined;
-    /** Commit a rename (host routes it through the command service). */
-    rename(id: NodeId, name: string): void;
+    /**
+     * Commit a rename (host routes it through the command service). Without it,
+     * a node's name cannot be edited in place.
+     */
+    readonly rename?: (id: NodeId, name: string) => void;
 }
 interface NodeInteractionProviderProps {
     readonly value: NodeInteraction;
@@ -1462,5 +1545,5 @@ declare function LivePulse({ nodeId }: {
     readonly nodeId: string;
 }): ReactElement | null;
 
-export { AssetGrid, AssetNodeChrome, CanvasChrome, CanvasDock, Cheatsheet, ConnectionInspector, DEFAULT_EDGE_CAPACITY, DEFAULT_MIN_CANVAS_HEIGHT, DiagnosticBadge, EditorShell, EditorUIThemeProvider, EmptyState, FOLLOW_SLACK_PX, FOOTER_KEY_STEP, FlowEdge, FooterResizer, HlangNode, InspectorPanel, KIND_ROLE, KIND_TOKEN, LivePulse, LiveSignalProvider, LiveSignalStore, NodeBodySlot, NodeChrome, NodeContextMenu, NodeInteractionProvider, NodeRunStats, NodeSearch, OutlineTree, PREVIEW_LENGTH, ParamForm, PillNodeChrome, PortRow, PositionPanel, PreviewPanel, RUN_LOG_CAPACITY, RailTabs, RunButton, RunLog, RunTrace, RunTraceProvider, SELF_LOOP_CLEARANCE, SELF_LOOP_RADIUS, SignalBar, TOKEN_NAMES, ToastProvider, ToolCluster, Toolbar, ToolbarGhostButton, ToolbarStat, UndoRedo, boundsFields, capacityLabel, clampFooter, connectableCandidates, createHlangFlowTypes, createTheme, defaultLiveDeps, deriveParamSchema, descriptorCandidates, footerBounds, formatDuration, formatElapsed, fuzzyRank, fuzzyScore, involves, isEditableTarget, nextBounds, previewValue, resizeByKey, searchNodes, selfLoopPath, toggleCollapsed, tokenVar, useEdgeBounds, useEdgeFlowing, useEdgePulse, useEditorHotkeys, useFollowScroll, useFooterResize, useLiveSignalStore, useLiveSignals, useNodeContextMenu, useNodeInteraction, useNodeLiveState, useNodeParams, useNodePulse, useNodeSearch, useNodeSearchTriggers, useRunTrace, useRunTraceStore, useRunTraceVersion, useToast };
-export type { AssetGridProps, AssetItem, AssetNodeChromeProps, CanvasChromeProps, CanvasDockProps, CanvasMode, CheatsheetProps, ConnectableResult, ConnectionEnd, ContextMenuItem, DeliverySignal, DiagnosticBadgeProps, EdgeBoundsHandle, EdgeIndexEntry, EditorHotkeysOptions, EditorShellProps, EditorUIThemeProviderProps, EmptyStateProps, FollowScroll, FooterBounds, FooterResize, FooterResizeOptions, FooterResizerProps, FooterSize, FuzzyCandidate, FuzzyMatch, FuzzyResult, HlangFlowTypes, InspectorPanelProps, LiveSignalProviderProps, LiveSignalStoreDeps, NodeBodySlotProps, NodeCandidate, NodeChromeProps, NodeContextMenuController, NodeContextMenuProps, NodeContextMenuState, NodeInteraction, NodeInteractionProviderProps, NodeLiveState, NodeParamsHandle, NodeRunSummary, NodeSearchController, NodeSearchProps, NodeSearchResult, NodeSearchResultView, NodeSearchState, NodeSearchTriggerOptions, NodeSearchTriggers, OutlineTreeProps, ParamField, ParamFieldBase, ParamFormProps, PendingConnection, PillNodeChromeProps, PointerPosition, PortRowProps, PositionPanelProps, PreviewPanelProps, RailTab, RailTabsProps, RunButtonProps, RunDeliveryEntry, RunErrorEntry, RunLogEntry, RunLogProps, RunTraceOptions, RunTraceProviderProps, SelfLoop, SelfLoopInput, ShortcutGroup, ShortcutRow, ThemeOverride, ToastApi, ToastProviderProps, TokenName, ToolClusterProps, ToolItem, ToolbarProps, TouchPositions, UndoRedoProps };
+export { AssetGrid, AssetNodeChrome, CanvasChrome, CanvasDock, Cheatsheet, ClearIcon, ConnectionInspector, DEFAULT_EDGE_CAPACITY, DEFAULT_MIN_CANVAS_HEIGHT, DiagnosticBadge, EditorShell, EditorUIThemeProvider, EmptyState, FOLLOW_SLACK_PX, FOOTER_KEY_STEP, FilterIcon, FlowEdge, FollowIcon, FooterResizer, HlangNode, InspectorPanel, KIND_ROLE, KIND_TOKEN, LivePulse, LiveSignalProvider, LiveSignalStore, NodeBodySlot, NodeChrome, NodeContextMenu, NodeInteractionProvider, NodeRunStats, NodeSearch, OutlineTree, PREVIEW_LENGTH, PanelAction, PanelHead, ParamForm, PillNodeChrome, PortRow, PositionPanel, PreviewPanel, RUN_LOG_CAPACITY, RailTabs, ReadOnlyBadge, RunButton, RunLog, RunTrace, RunTraceProvider, SELF_LOOP_CLEARANCE, SELF_LOOP_RADIUS, SignalBar, TOKEN_NAMES, ToastProvider, ToolCluster, Toolbar, ToolbarGhostButton, ToolbarStat, UndoRedo, boundsFields, capacityLabel, clampFooter, connectableCandidates, createHlangFlowTypes, createTheme, defaultLiveDeps, deriveParamSchema, descriptorCandidates, footerBounds, formatDuration, formatElapsed, fuzzyRank, fuzzyScore, involves, isEditableTarget, nextBounds, previewValue, resizeByKey, searchNodes, selfLoopPath, toggleCollapsed, tokenVar, useEdgeBounds, useEdgeFlowing, useEdgePulse, useEditorHotkeys, useFollowScroll, useFooterResize, useLiveSignalStore, useLiveSignals, useNodeContextMenu, useNodeInteraction, useNodeLiveState, useNodeParams, useNodePulse, useNodeSearch, useNodeSearchTriggers, useRunTrace, useRunTraceStore, useRunTraceVersion, useToast };
+export type { AssetGridProps, AssetItem, AssetNodeChromeProps, CanvasChromeProps, CanvasDockProps, CanvasMode, CheatsheetProps, ConnectableResult, ConnectionEnd, ContextMenuItem, DeliverySignal, DiagnosticBadgeProps, EdgeBoundsHandle, EdgeIndexEntry, EditorHotkeysOptions, EditorShellProps, EditorUIThemeProviderProps, EmptyStateProps, FollowScroll, FooterBounds, FooterResize, FooterResizeOptions, FooterResizerProps, FooterSize, FuzzyCandidate, FuzzyMatch, FuzzyResult, HlangFlowTypes, InspectorPanelProps, LiveSignalProviderProps, LiveSignalStoreDeps, NodeBodySlotProps, NodeCandidate, NodeChromeProps, NodeContextMenuController, NodeContextMenuProps, NodeContextMenuState, NodeInteraction, NodeInteractionProviderProps, NodeLiveState, NodeParamsHandle, NodeRunSummary, NodeSearchController, NodeSearchProps, NodeSearchResult, NodeSearchResultView, NodeSearchState, NodeSearchTriggerOptions, NodeSearchTriggers, OutlineTreeProps, PanelActionProps, PanelHeadProps, ParamField, ParamFieldBase, ParamFormProps, PendingConnection, PillNodeChromeProps, PointerPosition, PortRowProps, PositionPanelProps, PreviewPanelProps, RailTab, RailTabsProps, ReadOnlyBadgeProps, RunButtonProps, RunDeliveryEntry, RunErrorEntry, RunLogEntry, RunLogProps, RunTraceOptions, RunTraceProviderProps, SelfLoop, SelfLoopInput, ShortcutGroup, ShortcutRow, ThemeOverride, ToastApi, ToastProviderProps, TokenName, ToolClusterProps, ToolItem, ToolbarProps, TouchPositions, UndoRedoProps };

package/lib/index.d.ts

@@ -396,6 +396,21 @@ declare function ToolbarGhostButton({ children, onClick, title, }: {
     readonly title?: string;
 }): ReactElement;
 
+/**
+ * `ReadOnlyBadge` — says, in the toolbar, that the graph can be looked at
+ * and run but not changed (the editor core is read-only; see editor-core's
+ * `IEditorModeService`). The host says why in `title`. In a narrow toolbar it
+ * keeps only its lock; the label stays its accessible name.
+ */
+
+interface ReadOnlyBadgeProps {
+    /** The badge's text. */
+    readonly label?: string;
+    /** Why the editor is read-only, shown as its tooltip. */
+    readonly title?: string;
+}
+declare function ReadOnlyBadge({ label, title }: ReadOnlyBadgeProps): ReactElement;
+
 /**
  * `ToolCluster` — the centred group of canvas tools in the top bar (nover-style):
  * a row of icon buttons with optional separators, in the black/silver glass
@@ -438,6 +453,10 @@ declare function CanvasChrome({ background }: CanvasChromeProps): ReactElement;
  * glass language. It replaces React Flow's default corner Controls + MiniMap
  * with one calm, centred dock.
  *
+ * A read-only dock (`readOnly`) keeps only the view controls (zoom, fit):
+ * undo, redo, the pointer modes and add-node all change the graph or exist
+ * to edit it.
+ *
  * Presentation only: it renders buttons and the current zoom %, and calls back
  * to the host for every action. It holds no React Flow or graph state — the host
  * wires the callbacks to `useReactFlow()` (zoom/fit) and the node search (add).
@@ -461,8 +480,10 @@ interface CanvasDockProps {
     readonly onRedo: () => void;
     readonly canUndo: boolean;
     readonly canRedo: boolean;
+    /** Show the view controls only: the graph cannot be edited. */
+    readonly readOnly?: boolean;
 }
-declare function CanvasDock({ zoom, onZoomIn, onZoomOut, onFitView, onAdd, mode, onModeChange, onUndo, onRedo, canUndo, canRedo, }: CanvasDockProps): ReactElement;
+declare function CanvasDock({ zoom, onZoomIn, onZoomOut, onFitView, onAdd, mode, onModeChange, onUndo, onRedo, canUndo, canRedo, readOnly, }: CanvasDockProps): ReactElement;
 
 /**
  * `EmptyState` — a quiet, centered hint shown over an empty canvas. Purely
@@ -529,6 +550,59 @@ interface PreviewPanelProps {
 }
 declare function PreviewPanel({ imageUrl, title, status }: PreviewPanelProps): ReactElement;
 
+/**
+ * `PanelHead` and `PanelAction` — the header row of a docked panel (the
+ * console, the run log): what the panel is, a short status, and its actions.
+ *
+ * The header responds to its own width, not the window's (a container query,
+ * as VS Code's and DevTools' panel toolbars do): when it is narrow the actions
+ * drop their labels and keep their icons, and then the status gives way. A
+ * label that is not shown is still the button's accessible name, and its
+ * tooltip.
+ */
+
+interface PanelHeadProps {
+    /** What the panel is: its title, or the host's tabs. */
+    readonly leading: ReactNode;
+    /** A short status after it, e.g. a count; the first thing to go when the panel is narrow. */
+    readonly meta?: ReactNode;
+    /** The panel's actions, usually `PanelAction`s. */
+    readonly children?: ReactNode;
+}
+declare function PanelHead({ leading, meta, children }: PanelHeadProps): ReactElement;
+interface PanelActionProps {
+    readonly icon: ReactNode;
+    /** The action's name: shown when there is room, and always its accessible name. */
+    readonly label: string;
+    readonly onClick: () => void;
+    /** For a toggle: whether it is on. Leave out for a plain action. */
+    readonly pressed?: boolean;
+    readonly disabled?: boolean;
+    /** The tooltip; the label by default. */
+    readonly title?: string;
+}
+declare function PanelAction({ icon, label, onClick, pressed, disabled, title }: PanelActionProps): ReactElement;
+
+/**
+ * Per-type node icons. A small registry mapping a node `code` to a crisp
+ * line-glyph (1.5px stroke, currentColor), with a kind fallback (R/T/W). Used
+ * by the outline tree and the node chrome so every node reads by its ROLE, not
+ * a generic letter — the difference between a tool and a spreadsheet.
+ *
+ * Icons are inline SVG (not emoji) for a premium, monochrome, scalable look;
+ * they inherit `color` so callers tint them by kind or silver.
+ */
+
+interface IconProps {
+    readonly size?: number;
+}
+/** Funnel — show only what involves the selection. */
+declare function FilterIcon({ size }: IconProps): ReactElement;
+/** Arrow onto a line — keep the newest entry in view. */
+declare function FollowIcon({ size }: IconProps): ReactElement;
+/** Circle with a stroke through it — clear the log (DevTools' glyph). */
+declare function ClearIcon({ size }: IconProps): ReactElement;
+
 /**
  * `RailTabs` — the segmented tab strip at the top of a side rail (Outline /
  * Insert / Assets, nover-style), in the black/silver glass language. Purely
@@ -659,8 +733,10 @@ interface ParamFormProps {
     readonly fields: readonly ParamField[];
     /** Commit a single field's new value (undoable, handled by the caller). */
     readonly onCommit: (key: string, value: ParamValue) => void;
+    /** Disables every field, e.g. in a read-only editor. */
+    readonly disabled?: boolean;
 }
-declare function ParamForm({ fields, onCommit }: ParamFormProps): ReactElement;
+declare function ParamForm({ fields, onCommit, disabled }: ParamFormProps): ReactElement;
 
 /**
  * `useNodeParams` — reactively read a node's params and commit edits through the
@@ -845,6 +921,9 @@ declare function NodeSearch({ controller }: NodeSearchProps): ReactElement | nul
  *     only for the pane, never for nodes/edges/handles) rather than a raw DOM
  *     double-click, so this never reaches into React Flow's internal markup.
  *
+ * A read-only editor (`core.mode.readOnly`) opens nothing: the palette only
+ * adds nodes, which a read-only graph refuses.
+ *
  * Screen→flow coordinate conversion uses the React Flow instance, so created
  * nodes land under the pointer regardless of pan/zoom. This hook must be used
  * within a `ReactFlowProvider` (React Flow's own requirement for `useReactFlow`).
@@ -966,15 +1045,19 @@ declare function NodeContextMenu({ controller, items }: NodeContextMenuProps): R
  * `NodeInteractionContext` — optional per-node interaction wiring supplied by the
  * host (diagnostics to badge, rename to commit). Node chrome reads it to render a
  * diagnostic badge and to support inline rename, but degrades gracefully to a
- * plain, read-only node when no provider is present — so editor-ui stays usable
+ * plain node that cannot be renamed when no provider is present, or when the
+ * host leaves `rename` out (a read-only editor) — so editor-ui stays usable
  * without the full editor wiring.
  */
 
 interface NodeInteraction {
     /** The most severe diagnostic on a node, or undefined. */
     diagnosticFor(id: NodeId): Diagnostic | undefined;
-    /** Commit a rename (host routes it through the command service). */
-    rename(id: NodeId, name: string): void;
+    /**
+     * Commit a rename (host routes it through the command service). Without it,
+     * a node's name cannot be edited in place.
+     */
+    readonly rename?: (id: NodeId, name: string) => void;
 }
 interface NodeInteractionProviderProps {
     readonly value: NodeInteraction;
@@ -1462,5 +1545,5 @@ declare function LivePulse({ nodeId }: {
     readonly nodeId: string;
 }): ReactElement | null;
 
-export { AssetGrid, AssetNodeChrome, CanvasChrome, CanvasDock, Cheatsheet, ConnectionInspector, DEFAULT_EDGE_CAPACITY, DEFAULT_MIN_CANVAS_HEIGHT, DiagnosticBadge, EditorShell, EditorUIThemeProvider, EmptyState, FOLLOW_SLACK_PX, FOOTER_KEY_STEP, FlowEdge, FooterResizer, HlangNode, InspectorPanel, KIND_ROLE, KIND_TOKEN, LivePulse, LiveSignalProvider, LiveSignalStore, NodeBodySlot, NodeChrome, NodeContextMenu, NodeInteractionProvider, NodeRunStats, NodeSearch, OutlineTree, PREVIEW_LENGTH, ParamForm, PillNodeChrome, PortRow, PositionPanel, PreviewPanel, RUN_LOG_CAPACITY, RailTabs, RunButton, RunLog, RunTrace, RunTraceProvider, SELF_LOOP_CLEARANCE, SELF_LOOP_RADIUS, SignalBar, TOKEN_NAMES, ToastProvider, ToolCluster, Toolbar, ToolbarGhostButton, ToolbarStat, UndoRedo, boundsFields, capacityLabel, clampFooter, connectableCandidates, createHlangFlowTypes, createTheme, defaultLiveDeps, deriveParamSchema, descriptorCandidates, footerBounds, formatDuration, formatElapsed, fuzzyRank, fuzzyScore, involves, isEditableTarget, nextBounds, previewValue, resizeByKey, searchNodes, selfLoopPath, toggleCollapsed, tokenVar, useEdgeBounds, useEdgeFlowing, useEdgePulse, useEditorHotkeys, useFollowScroll, useFooterResize, useLiveSignalStore, useLiveSignals, useNodeContextMenu, useNodeInteraction, useNodeLiveState, useNodeParams, useNodePulse, useNodeSearch, useNodeSearchTriggers, useRunTrace, useRunTraceStore, useRunTraceVersion, useToast };
-export type { AssetGridProps, AssetItem, AssetNodeChromeProps, CanvasChromeProps, CanvasDockProps, CanvasMode, CheatsheetProps, ConnectableResult, ConnectionEnd, ContextMenuItem, DeliverySignal, DiagnosticBadgeProps, EdgeBoundsHandle, EdgeIndexEntry, EditorHotkeysOptions, EditorShellProps, EditorUIThemeProviderProps, EmptyStateProps, FollowScroll, FooterBounds, FooterResize, FooterResizeOptions, FooterResizerProps, FooterSize, FuzzyCandidate, FuzzyMatch, FuzzyResult, HlangFlowTypes, InspectorPanelProps, LiveSignalProviderProps, LiveSignalStoreDeps, NodeBodySlotProps, NodeCandidate, NodeChromeProps, NodeContextMenuController, NodeContextMenuProps, NodeContextMenuState, NodeInteraction, NodeInteractionProviderProps, NodeLiveState, NodeParamsHandle, NodeRunSummary, NodeSearchController, NodeSearchProps, NodeSearchResult, NodeSearchResultView, NodeSearchState, NodeSearchTriggerOptions, NodeSearchTriggers, OutlineTreeProps, ParamField, ParamFieldBase, ParamFormProps, PendingConnection, PillNodeChromeProps, PointerPosition, PortRowProps, PositionPanelProps, PreviewPanelProps, RailTab, RailTabsProps, RunButtonProps, RunDeliveryEntry, RunErrorEntry, RunLogEntry, RunLogProps, RunTraceOptions, RunTraceProviderProps, SelfLoop, SelfLoopInput, ShortcutGroup, ShortcutRow, ThemeOverride, ToastApi, ToastProviderProps, TokenName, ToolClusterProps, ToolItem, ToolbarProps, TouchPositions, UndoRedoProps };
+export { AssetGrid, AssetNodeChrome, CanvasChrome, CanvasDock, Cheatsheet, ClearIcon, ConnectionInspector, DEFAULT_EDGE_CAPACITY, DEFAULT_MIN_CANVAS_HEIGHT, DiagnosticBadge, EditorShell, EditorUIThemeProvider, EmptyState, FOLLOW_SLACK_PX, FOOTER_KEY_STEP, FilterIcon, FlowEdge, FollowIcon, FooterResizer, HlangNode, InspectorPanel, KIND_ROLE, KIND_TOKEN, LivePulse, LiveSignalProvider, LiveSignalStore, NodeBodySlot, NodeChrome, NodeContextMenu, NodeInteractionProvider, NodeRunStats, NodeSearch, OutlineTree, PREVIEW_LENGTH, PanelAction, PanelHead, ParamForm, PillNodeChrome, PortRow, PositionPanel, PreviewPanel, RUN_LOG_CAPACITY, RailTabs, ReadOnlyBadge, RunButton, RunLog, RunTrace, RunTraceProvider, SELF_LOOP_CLEARANCE, SELF_LOOP_RADIUS, SignalBar, TOKEN_NAMES, ToastProvider, ToolCluster, Toolbar, ToolbarGhostButton, ToolbarStat, UndoRedo, boundsFields, capacityLabel, clampFooter, connectableCandidates, createHlangFlowTypes, createTheme, defaultLiveDeps, deriveParamSchema, descriptorCandidates, footerBounds, formatDuration, formatElapsed, fuzzyRank, fuzzyScore, involves, isEditableTarget, nextBounds, previewValue, resizeByKey, searchNodes, selfLoopPath, toggleCollapsed, tokenVar, useEdgeBounds, useEdgeFlowing, useEdgePulse, useEditorHotkeys, useFollowScroll, useFooterResize, useLiveSignalStore, useLiveSignals, useNodeContextMenu, useNodeInteraction, useNodeLiveState, useNodeParams, useNodePulse, useNodeSearch, useNodeSearchTriggers, useRunTrace, useRunTraceStore, useRunTraceVersion, useToast };
+export type { AssetGridProps, AssetItem, AssetNodeChromeProps, CanvasChromeProps, CanvasDockProps, CanvasMode, CheatsheetProps, ConnectableResult, ConnectionEnd, ContextMenuItem, DeliverySignal, DiagnosticBadgeProps, EdgeBoundsHandle, EdgeIndexEntry, EditorHotkeysOptions, EditorShellProps, EditorUIThemeProviderProps, EmptyStateProps, FollowScroll, FooterBounds, FooterResize, FooterResizeOptions, FooterResizerProps, FooterSize, FuzzyCandidate, FuzzyMatch, FuzzyResult, HlangFlowTypes, InspectorPanelProps, LiveSignalProviderProps, LiveSignalStoreDeps, NodeBodySlotProps, NodeCandidate, NodeChromeProps, NodeContextMenuController, NodeContextMenuProps, NodeContextMenuState, NodeInteraction, NodeInteractionProviderProps, NodeLiveState, NodeParamsHandle, NodeRunSummary, NodeSearchController, NodeSearchProps, NodeSearchResult, NodeSearchResultView, NodeSearchState, NodeSearchTriggerOptions, NodeSearchTriggers, OutlineTreeProps, PanelActionProps, PanelHeadProps, ParamField, ParamFieldBase, ParamFormProps, PendingConnection, PillNodeChromeProps, PointerPosition, PortRowProps, PositionPanelProps, PreviewPanelProps, RailTab, RailTabsProps, ReadOnlyBadgeProps, RunButtonProps, RunDeliveryEntry, RunErrorEntry, RunLogEntry, RunLogProps, RunTraceOptions, RunTraceProviderProps, SelfLoop, SelfLoopInput, ShortcutGroup, ShortcutRow, ThemeOverride, ToastApi, ToastProviderProps, TokenName, ToolClusterProps, ToolItem, ToolbarProps, TouchPositions, UndoRedoProps };