@artemis-studio/plugin-sdk 2026.9.51 → 2026.9.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artemis-studio/plugin-sdk",
-  "version": "2026.9.51",
+  "version": "2026.9.53",
   "description": "Build the UI of an Artemis Studio plugin: typings for the Studio APIs a plugin may use, and a Vite preset.",
   "license": "Apache-2.0",
   "repository": {

package/types/sdk/index.d.ts

@@ -20,7 +20,7 @@ export { gateFor, type GateVerdict } from '../ui/capabilityGate.ts';
 export { useMe } from '../kernel/auth/api.ts';
 export { CodeEditor, type CodeDiagnostic, type CodeEditorProps } from '../ui/CodeEditor.tsx';
 export { ConfirmByTyping } from '../ui/ConfirmByTyping.tsx';
-export { DiagramView, type DiagramEdge, type DiagramNode, type DiagramViewProps } from '../ui/DiagramView.tsx';
+export { DiagramView, type DiagramAction, type DiagramChoice, type DiagramEdge, type DiagramNode, type DiagramViewProps } from '../ui/DiagramView.tsx';
 export { NodeOutcomeSummary, OutcomeSummary, type OutcomeRow } from '../ui/NodeOutcomeSummary.tsx';
 export { Pager } from '../ui/Pager.tsx';
 export { VirtualTable, type GridColumn } from '../ui/VirtualTable.tsx';

package/types/ui/DiagramView.d.ts

@@ -1,5 +1,5 @@
-import { type DiagramEdge, type DiagramNode } from './diagram.ts';
-export type { DiagramEdge, DiagramNode };
+import { type DiagramAction, type DiagramChoice, type DiagramEdge, type DiagramNode } from './diagram.ts';
+export type { DiagramAction, DiagramChoice, DiagramEdge, DiagramNode };
 export interface DiagramViewProps {
     nodes: DiagramNode[];
     edges: DiagramEdge[];
@@ -7,19 +7,29 @@ export interface DiagramViewProps {
     onSelect?: (id: string) => void;
     /** Which way the arrows run. Default: down. */
     direction?: 'DOWN' | 'RIGHT';
-    /** The frame's height in pixels. Default 480. */
-    height?: number;
+    /** The frame's height: pixels, or any CSS length such as '100%' to fill a sized parent. Default 480. */
+    height?: number | string;
     /** Names the diagram for screen readers. */
     'aria-label': string;
+    /** What can be inserted on an arrow marked `insertable`. With `onInsert`, each such arrow offers them. */
+    insertChoices?: DiagramChoice[];
+    /** A choice was made on an arrow. The diagram changes nothing itself. */
+    onInsert?: (edgeId: string, value: string) => void;
+    /** The actions a box offers in its menu. With `onNodeAction`, every box that has some offers them. */
+    nodeActions?: (node: DiagramNode) => DiagramAction[];
+    /** An action was chosen on a box. The diagram changes nothing itself. */
+    onNodeAction?: (nodeId: string, actionId: string) => void;
 }
 /**
- * A read-only diagram of boxes and arrows, laid out automatically (ELK layered, in a worker) and
- * drawn in Studio's theme (ADR-0117). Nothing is dragged, connected or deleted: it shows a
- * structure and reports which box was chosen.
+ * A diagram of boxes and arrows, laid out automatically (ELK layered, in a worker) and drawn in
+ * Studio's theme (ADR-0117). Nothing is dragged, connected or deleted: it shows a structure and
+ * reports which box was chosen. A caller may offer things to insert on arrows and actions on boxes
+ * (ADR-0120); the diagram reports the choice and the caller changes the nodes.
  *
  * <p>The diagram is one tab stop. Arrow keys move between boxes in reading order, Enter or Space
  * selects one, and the selection is announced. A box with a problem says so in words, on the box
  * and in its accessible name, so colour is never the only signal. Positions change only when the
- * boxes or arrows do, never when a label does.
+ * boxes or arrows do, never when a label does. A box's actions open from its "⋯", a right-click,
+ * or Shift+F10; Insert on a box offers what can go on the arrows into it.
  */
-export declare function DiagramView({ nodes, edges, selectedId, onSelect, direction, height, 'aria-label': ariaLabel, }: DiagramViewProps): import("react").JSX.Element;
+export declare function DiagramView({ nodes, edges, selectedId, onSelect, direction, height, 'aria-label': ariaLabel, insertChoices, onInsert, nodeActions, onNodeAction, }: DiagramViewProps): import("react").JSX.Element;

package/types/ui/diagram.d.ts

@@ -21,6 +21,24 @@ export interface DiagramEdge {
     label?: string;
     /** Drawn dashed: a secondary path. Its meaning belongs in its label. */
     dashed?: boolean;
+    /** Something can be inserted on this arrow: it offers the diagram's `insertChoices`. */
+    insertable?: boolean;
+}
+/** One thing a `DiagramView` offers to insert on an arrow ("Call a service"). */
+export interface DiagramChoice {
+    value: string;
+    label: string;
+    /** A heading the choice is listed under. */
+    group?: string;
+}
+/** One action in a box's menu. The diagram only reports it: the caller changes the nodes. */
+export interface DiagramAction {
+    id: string;
+    label: string;
+    /** Why it cannot be taken here. It stays listed, with the reason, rather than disappearing. */
+    disabledReason?: string;
+    /** Destroys something: shown in the danger colour. The label still says so in words. */
+    danger?: boolean;
 }
 /** What positions depend on: which nodes exist and how they connect. A new label moves nothing. */
 export declare function layoutSignature(nodes: DiagramNode[], edges: DiagramEdge[], direction: string): string;