@pipelex/mthds-ui 0.7.0 → 0.9.0

package/dist/{types-DJTrDxjV.d.ts → types-uGRs3n4k.d.ts}

@@ -1,4 +1,4 @@
-type PipeOperatorType = "PipeLLM" | "PipeExtract" | "PipeCompose" | "PipeImgGen" | "PipeSearch" | "PipeFunc";
+type PipeOperatorType = "PipeLLM" | "PipeExtract" | "PipeCompose" | "PipeImgGen" | "PipeSearch" | "PipeFunc" | "PipeSignature";
 type PipeControllerType = "PipeSequence" | "PipeParallel" | "PipeCondition" | "PipeBatch";
 type PipeType = PipeOperatorType | PipeControllerType;
 /** Every pipe class name pipelex emits as `pipe_type`. Used by validateGraphSpec. */
@@ -221,6 +221,22 @@ interface PipeSearchBlueprint extends PipeBlueprintBase {
 interface PipeFuncBlueprint extends PipeBlueprintBase {
     type: "PipeFunc";
 }
+/**
+ * A contract-only pipe: declares inputs + output but has no implementation.
+ * Emitted under `--allow-signatures` so an in-progress bundle still validates
+ * (dry-run mocks the declared output) before every referenced pipe is built.
+ */
+interface PipeSignatureBlueprint extends Omit<PipeBlueprintBase, "pipe_category"> {
+    type: "PipeSignature";
+    /**
+     * Signatures sit outside the executable taxonomy, so pipelex serializes
+     * `pipe_category: null` (present, not omitted) — unlike operator/controller
+     * blueprints which carry "PipeOperator" / "PipeController".
+     */
+    pipe_category: null;
+    /** Intended downstream pipe type once implemented — an optional hint. */
+    signature_for?: PipeType | null;
+}
 interface PipeSequenceBlueprint extends PipeBlueprintBase {
     type: "PipeSequence";
     sequential_sub_pipes: SubPipeSpec[];
@@ -246,7 +262,7 @@ interface PipeBatchBlueprint extends PipeBlueprintBase {
         input_item_stuff_name: string;
     };
 }
-type PipeBlueprintUnion = PipeLLMBlueprint | PipeImgGenBlueprint | PipeComposeBlueprint | PipeExtractBlueprint | PipeSearchBlueprint | PipeFuncBlueprint | PipeSequenceBlueprint | PipeParallelBlueprint | PipeConditionBlueprint | PipeBatchBlueprint;
+type PipeBlueprintUnion = PipeLLMBlueprint | PipeImgGenBlueprint | PipeComposeBlueprint | PipeExtractBlueprint | PipeSearchBlueprint | PipeFuncBlueprint | PipeSignatureBlueprint | PipeSequenceBlueprint | PipeParallelBlueprint | PipeConditionBlueprint | PipeBatchBlueprint;
 interface GraphSpec {
     graph_id?: string;
     created_at?: string;
@@ -297,16 +313,39 @@ 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];
 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;
     nodesep?: number;
     ranksep?: number;
     edgeType?: EdgeType;
@@ -415,4 +454,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, STUFF_ID_PREFIX as a2, type StuffRole as a3, type StuffSpecInfo as a4, type SubPipeSpec as a5, type TemplateBlueprint as a6, isStuffNodeId as a7, nodeHeight as a8, nodeWidth as a9, stuffDigestFromId as aa, stuffNodeId as ab, 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 PipeImgGenBlueprint 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 PipeBatchBlueprint as T, type PipeBlueprintBase as U, type PipeComposeBlueprint as V, type PipeComposeConstructBlueprint as W, type PipeComposeConstructField as X, type PipeConditionBlueprint as Y, type PipeExtractBlueprint as Z, type PipeFuncBlueprint as _, type GraphEdge as a, type PipeLLMBlueprint as a0, type PipeParallelBlueprint as a1, type PipeSearchBlueprint as a2, type PipeSequenceBlueprint as a3, type PipeSignatureBlueprint as a4, STUFF_ID_PREFIX as a5, type StuffRole as a6, type StuffSpecInfo as a7, type SubPipeSpec as a8, type TemplateBlueprint as a9, isStuffNodeId as aa, nodeHeight as ab, nodeWidth as ac, stuffDigestFromId as ad, stuffNodeId as ae, 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.7.0",
+  "version": "0.9.0",
   "description": "Shared graph rendering logic for MTHDS method visualization",
   "license": "MIT",
   "repository": {