@pipelex/mthds-ui 0.8.0 → 0.10.0

package/dist/{types-D7NALhbw.d.ts → types-CEDZIAmh.d.ts}

@@ -313,16 +313,86 @@ declare const FOLD_MODE: {
     readonly AUTO: "auto";
 };
 type FoldMode = (typeof FOLD_MODE)[keyof typeof FOLD_MODE];
+/**
+ * The *resolved* binary theme — the value that actually drives the palette and
+ * the container class. `getPaletteForTheme` takes this. `system` is never a
+ * resolved theme; it resolves to one of these via the environment.
+ */
 declare const GRAPH_THEME: {
     readonly DARK: "dark";
     readonly LIGHT: "light";
 };
 type GraphTheme = (typeof GRAPH_THEME)[keyof typeof GRAPH_THEME];
+/**
+ * The user's theme *selection* — what the toolbar cycles, what gets persisted
+ * and reported. `system` follows the host environment (browser `prefers-color-scheme`
+ * or an injected `systemTheme`) and resolves to a binary `GraphTheme` at render
+ * time. The `dark`/`light` overlap with `GraphTheme` is intentional: a resolved
+ * theme is also a valid mode.
+ */
+declare const GRAPH_THEME_MODE: {
+    readonly DARK: "dark";
+    readonly LIGHT: "light";
+    readonly SYSTEM: "system";
+};
+type GraphThemeMode = (typeof GRAPH_THEME_MODE)[keyof typeof GRAPH_THEME_MODE];
+/**
+ * Anchor for the built-in floating toolbar. The values match ReactFlow's
+ * `PanelPosition` union exactly, so they pass straight to `<Panel position=…>`
+ * (the React layer asserts that subset relationship at compile time). Orientation
+ * is *derived* from the position, never configured independently — see
+ * `toolbarOrientation`: only the two edge-center anchors are vertical, everything
+ * else (corners + top/bottom-center) is a horizontal bar.
+ *
+ * `types.ts` stays React-free, so `PanelPosition` is intentionally NOT imported
+ * here — the compatibility assertion lives in `GraphToolbar.tsx`.
+ */
+declare const TOOLBAR_POSITION: {
+    readonly TOP_LEFT: "top-left";
+    readonly TOP_CENTER: "top-center";
+    readonly TOP_RIGHT: "top-right";
+    readonly BOTTOM_LEFT: "bottom-left";
+    readonly BOTTOM_CENTER: "bottom-center";
+    readonly BOTTOM_RIGHT: "bottom-right";
+    readonly CENTER_LEFT: "center-left";
+    readonly CENTER_RIGHT: "center-right";
+};
+type ToolbarPosition = (typeof TOOLBAR_POSITION)[keyof typeof TOOLBAR_POSITION];
+type ToolbarOrientation = "horizontal" | "vertical";
+/**
+ * Derive the bar orientation from its anchor. "Corners are horizontal, edges
+ * decide the rest": only `center-left` / `center-right` produce a vertical bar;
+ * every other position (the four corners plus `top-center` / `bottom-center`) is
+ * horizontal. Pure + React-free so it is unit-testable without rendering.
+ */
+declare function toolbarOrientation(position: ToolbarPosition): ToolbarOrientation;
+type ToolbarSide = "left" | "center" | "right";
+/**
+ * Derive which edge the anchor hugs. The built-in `DetailPanel` overlays the
+ * right edge, so only right-side anchors (`*-right`) need to dodge it — the
+ * toolbar reads this to decide whether to shift left while the panel is open.
+ * Pure + React-free so it is unit-testable without rendering, and exhaustively
+ * switched so adding a `TOOLBAR_POSITION` value without a side fails to compile
+ * — exactly like {@link toolbarOrientation}.
+ */
+declare function toolbarSide(position: ToolbarPosition): ToolbarSide;
 interface GraphConfig {
     direction?: GraphDirection;
     showControllers?: boolean;
     foldMode?: FoldMode;
-    theme?: GraphTheme;
+    /**
+     * Theme *mode*: `dark | light | system`. `system` follows the host environment.
+     * Defaults to `system` (see `DEFAULT_GRAPH_CONFIG`). Pass `dark`/`light` to pin
+     * a fixed appearance.
+     */
+    theme?: GraphThemeMode;
+    /**
+     * Anchor for the built-in floating toolbar (default `top-right`). Orientation
+     * is derived from the position — see {@link toolbarOrientation}. The
+     * `toolbarPosition` *prop* on `GraphViewer` takes precedence over this; both
+     * are reactive and persistence is the host's responsibility.
+     */
+    toolbarPosition?: ToolbarPosition;
     nodesep?: number;
     ranksep?: number;
     edgeType?: EdgeType;
@@ -431,4 +501,4 @@ declare const ARROW_CLOSED_MARKER = "arrowclosed";
 declare function nodeWidth(n: GraphNode): number;
 declare function nodeHeight(n: GraphNode): number;
 
-export { type PipeParallelBlueprint as $, ARROW_CLOSED_MARKER as A, type GraphSpecEdgeKind as B, type ConceptInfo as C, type DataflowAnalysis as D, EDGE_TYPE as E, type FoldMode as F, type GraphNodeData as G, type GraphSpecNodeError as H, type GraphSpecNodeIo as I, type GraphSpecNodeTiming as J, KNOWN_PIPE_TYPES as K, type LabelDescriptor as L, NODE_TYPE_PIPE_CARD as M, NODE_TYPE_CONTROLLER as N, NODE_TYPE_STUFF as O, type PipeStatus as P, type NodeKind as Q, type PipeBatchBlueprint as R, type PipeBlueprintBase as S, type PipeComposeBlueprint as T, type PipeComposeConstructBlueprint as U, type PipeComposeConstructField as V, type PipeConditionBlueprint as W, type PipeExtractBlueprint as X, type PipeFuncBlueprint as Y, type PipeImgGenBlueprint as Z, type PipeLLMBlueprint as _, type GraphEdge as a, type PipeSearchBlueprint as a0, type PipeSequenceBlueprint as a1, type PipeSignatureBlueprint as a2, STUFF_ID_PREFIX as a3, type StuffRole as a4, type StuffSpecInfo as a5, type SubPipeSpec as a6, type TemplateBlueprint as a7, isStuffNodeId as a8, nodeHeight as a9, nodeWidth as aa, stuffDigestFromId as ab, stuffNodeId as ac, type GraphNode as b, type GraphSpec as c, type GraphConfig as d, type GraphDirection as e, type GraphTheme as f, type PipeControllerType as g, type FoldToggleOptions as h, type PipeType as i, type GraphSpecNode as j, type GraphSpecNodeIoItem as k, type PipeOperatorType as l, type PipeCallNode as m, type PipeBlueprintUnion as n, type GraphData as o, type PipeCardPayload as p, type LayoutConfig as q, CONTROLLER_PADDING_BOTTOM as r, CONTROLLER_PADDING_TOP as s, CONTROLLER_PADDING_X as t, type EdgeType as u, FOLD_MODE as v, type FieldResolution as w, GRAPH_DIRECTION as x, GRAPH_THEME as y, type GraphSpecEdge as z };
+export { type PipeFuncBlueprint as $, ARROW_CLOSED_MARKER as A, GRAPH_THEME_MODE as B, type ConceptInfo as C, type DataflowAnalysis as D, EDGE_TYPE as E, type FoldMode as F, type GraphNodeData as G, type GraphSpecEdge as H, type GraphSpecEdgeKind as I, type GraphSpecNodeError as J, type GraphSpecNodeIo as K, type LabelDescriptor as L, type GraphSpecNodeTiming as M, KNOWN_PIPE_TYPES as N, NODE_TYPE_CONTROLLER as O, type PipeStatus as P, NODE_TYPE_PIPE_CARD as Q, NODE_TYPE_STUFF as R, type NodeKind as S, type ToolbarPosition as T, type PipeBatchBlueprint as U, type PipeBlueprintBase as V, type PipeComposeBlueprint as W, type PipeComposeConstructBlueprint as X, type PipeComposeConstructField as Y, type PipeConditionBlueprint as Z, type PipeExtractBlueprint as _, type GraphEdge as a, type PipeImgGenBlueprint as a0, type PipeLLMBlueprint as a1, type PipeParallelBlueprint as a2, type PipeSearchBlueprint as a3, type PipeSequenceBlueprint as a4, type PipeSignatureBlueprint as a5, STUFF_ID_PREFIX as a6, type StuffRole as a7, type StuffSpecInfo as a8, type SubPipeSpec as a9, TOOLBAR_POSITION as aa, type TemplateBlueprint as ab, type ToolbarOrientation as ac, type ToolbarSide as ad, isStuffNodeId as ae, nodeHeight as af, nodeWidth as ag, stuffDigestFromId as ah, stuffNodeId as ai, toolbarOrientation as aj, toolbarSide as ak, type GraphNode as b, type GraphSpec as c, type GraphConfig as d, type GraphDirection as e, type GraphThemeMode as f, type GraphTheme as g, type PipeControllerType as h, type FoldToggleOptions as i, type PipeType as j, type GraphSpecNode as k, type GraphSpecNodeIoItem as l, type PipeOperatorType as m, type PipeCallNode as n, type PipeBlueprintUnion as o, type GraphData as p, type PipeCardPayload as q, type LayoutConfig as r, CONTROLLER_PADDING_BOTTOM as s, CONTROLLER_PADDING_TOP as t, CONTROLLER_PADDING_X as u, type EdgeType as v, FOLD_MODE as w, type FieldResolution as x, GRAPH_DIRECTION as y, GRAPH_THEME as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipelex/mthds-ui",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Shared graph rendering logic for MTHDS method visualization",
   "license": "MIT",
   "repository": {
@@ -15,7 +15,7 @@
     "**/*.css"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",