@decaf-ts/ui-decorators 0.20.3 → 0.20.6

package/lib/types/graph/constants.d.mts

@@ -282,3 +282,168 @@ export declare function resolveEffectiveColor(explicitColor?: string, category?:
  * category icon, which overrides the default.
  */
 export declare function resolveEffectiveIcon(explicitIcon?: string, category?: string): string;
+import type { GraphRunStatus } from "./types.d.mts";
+/**
+ * Disabled-node execution semantics (DECAF-50 §4.9).
+ *
+ * - `skip` — the node does not execute and produces no outputs.
+ * - `passThroughFirstInput` — the first incoming edge value is forwarded on
+ *   the node's first declared output port.
+ * - `emitDefaults` — every declared output port is emitted with its default
+ *   (absent a declared default, `undefined`).
+ */
+export declare const GRAPH_DISABLED_NODE_BEHAVIORS: readonly ["skip", "passThroughFirstInput", "emitDefaults"];
+/** How a disabled node behaves during execution (DECAF-50 §4.8): skip it, pass through its first input, or emit default outputs. */
+export type GraphDisabledNodeBehavior = (typeof GRAPH_DISABLED_NODE_BEHAVIORS)[number];
+/** The disabled-node behavior applied when a node declares none. */
+export declare const GRAPH_DEFAULT_DISABLED_NODE_BEHAVIOR: GraphDisabledNodeBehavior;
+/** Type guard for {@link GraphDisabledNodeBehavior}. */
+export declare function isGraphDisabledNodeBehavior(value: unknown): value is GraphDisabledNodeBehavior;
+/**
+ * Execution status for a workflow or individual node.
+ */
+export declare enum GraphExecutionStatus {
+    PENDING = "pending",
+    PLANNING = "planning",
+    RUNNING = "running",
+    SUCCEEDED = "succeeded",
+    FAILED = "failed",
+    SKIPPED = "skipped",
+    CANCELLED = "cancelled",
+    CACHED = "cached"
+}
+/**
+ * Visual execution state for a node or edge on the workflow canvas.
+ *
+ * Frontend-safe (DECAF-48 §4.4): a superset of {@link GraphExecutionStatus}
+ * normalised for rendering. `BLOCKED` is derived from the plan and execution
+ * events (waiting on upstream dependencies), not emitted as an engine status.
+ * `SKIPPED` is the post-failure "unexecuted/disabled" visual state.
+ */
+export declare enum GraphVisualState {
+    IDLE = "idle",
+    RUNNING = "running",
+    BLOCKED = "blocked",
+    SUCCEEDED = "succeeded",
+    FAILED = "failed",
+    SKIPPED = "skipped"
+}
+/**
+ * Namespace root for graph run SSE topics (DECAF-48 §4.2). A subscription
+ * filters on these granular topics before `observer.next(...)`.
+ */
+export declare const GRAPH_RUN_TOPIC = "graph.run";
+/**
+ * SSE sub-topic streaming per-node log lines during a run.
+ */
+export declare const GRAPH_RUN_LOG_TOPIC = "graph.run.log";
+/**
+ * SSE sub-topic streaming node/edge execution-state updates during a run.
+ */
+export declare const GRAPH_RUN_STATE_TOPIC = "graph.run.state";
+/**
+ * Logger custom-attribute keys attached to every run log line via
+ * DECAF-9 `logger.for({...})` (DECAF-48 §4.3). Rendered as discrete columns
+ * (not buried in the message string).
+ */
+export declare enum GraphLogAttribute {
+    NODE_ID = "nodeId",
+    WORKFLOW_ID = "workflowId",
+    RUN_ID = "runId",
+    USER = "user"
+}
+/**
+ * Namespace topic helper for a graph execution event.
+ *
+ * Log-carrier events resolve to `graph.run.log`; node/edge execution-state
+ * events resolve to `graph.run.state`; everything else stays under the shared
+ * `graph.run` topic and is only delivered to subscribers that match it.
+ *
+ * @param eventType - The graph execution event type to scope to a topic.
+ * @returns The SSE topic constant for the given event type.
+ */
+export declare function graphRunTopicOf(eventType: GraphExecutionEventType): string;
+/**
+ * Event types emitted through the graph execution observer pipeline.
+ *
+ * DECAF-48 extends this set with the visual-state and run-log event types the
+ * engine emits on the existing Observable: {@link GraphExecutionEventType.NODE_STATE_CHANGED},
+ * {@link GraphExecutionEventType.EDGE_STATE_CHANGED} and
+ * {@link GraphExecutionEventType.GRAPH_RUN_LOG}.
+ */
+export declare enum GraphExecutionEventType {
+    WORKFLOW_STARTED = "workflow.started",
+    WORKFLOW_PLANNED = "workflow.planned",
+    WORKFLOW_COMPLETED = "workflow.completed",
+    WORKFLOW_FAILED = "workflow.failed",
+    WORKFLOW_CANCELLED = "workflow.cancelled",
+    NODE_QUEUED = "node.queued",
+    NODE_STARTED = "node.started",
+    NODE_OUTPUT = "node.output",
+    NODE_COMPLETED = "node.completed",
+    NODE_FAILED = "node.failed",
+    NODE_SKIPPED = "node.skipped",
+    NODE_CACHE_HIT = "node.cacheHit",
+    NODE_PINNED = "node.pinned",
+    NODE_UNPINNED = "node.unpinned",
+    /** Node execution-state transition carrying a `GraphNodeStateChangedPayload` (DECAF-48 §4.4). */
+    NODE_STATE_CHANGED = "node.stateChanged",
+    EDGE_VALUE_ROUTED = "edge.valueRouted",
+    /** Edge execution-state transition carrying a `GraphEdgeStateChangedPayload` (DECAF-48 §4.4). */
+    EDGE_STATE_CHANGED = "edge.stateChanged",
+    /** Structured run log line carrying a `GraphRunLogEntry` (DECAF-48 §4.3). */
+    GRAPH_RUN_LOG = "graph.run.log",
+    LOOP_STARTED = "loop.started",
+    LOOP_ITERATION_STARTED = "loop.iteration.started",
+    LOOP_ITERATION_COMPLETED = "loop.iteration.completed",
+    LOOP_CONDITION_EVALUATED = "loop.condition.evaluated",
+    LOOP_COMPLETED = "loop.completed",
+    LOOP_LIMIT_REACHED = "loop.limitReached",
+    VALIDATION_STARTED = "validation.started",
+    VALIDATION_FAILED = "validation.failed",
+    VALIDATION_COMPLETED = "validation.completed",
+    STORE_READ = "store.read",
+    STORE_WRITE = "store.write",
+    STORE_DELETE = "store.delete"
+}
+/**
+ * Hard limits for the graph run subsystem (DECAF-50 §4.14/§4.16).
+ *
+ * Enforced by the run executor and the HTTP run controller; every omitted
+ * field falls back to {@link DEFAULT_GRAPH_RUN_LIMITS}.
+ */
+export interface GraphRunLimits {
+    /** Maximum serialised JSON size accepted for a run create request. */
+    maxRequestBytes?: number;
+    /**
+     * Maximum number of runs in flight per caller: the run's owner user, or
+     * the caller-key bucket supplied by the HTTP layer for anonymous callers
+     * (per-IP where the host exposes it, a shared `"anonymous"` bucket
+     * otherwise).
+     */
+    maxConcurrentRuns?: number;
+    /** Maximum events retained per run by the in-memory event store. */
+    maxEventsPerRun?: number;
+    /** Maximum serialised size of a single event envelope `payload`. */
+    maxEventPayloadBytes?: number;
+    /** Hard wall-clock budget for a run's engine execution. */
+    executionTimeoutMs?: number;
+    /**
+     * How long a terminal run's replayable event state is kept after the run
+     * finishes before being released (SAA-595 resource governance).
+     */
+    eventReplayWindowMs?: number;
+}
+/** Default run limits: request size, per-caller concurrency, event retention/payload size, execution timeout, and post-terminal event replay window. */
+export declare const DEFAULT_GRAPH_RUN_LIMITS: Required<GraphRunLimits>;
+/**
+ * Terminal graph event types closing a run's SSE stream
+ * (DECAF-50 §4.15). The run SSE endpoint never emits anything after these.
+ */
+export declare const GRAPH_RUN_TERMINAL_EVENT_TYPES: readonly GraphExecutionEventType[];
+/** Whether the event type is a run-stream terminal type (see {@link GRAPH_RUN_TERMINAL_EVENT_TYPES}). */
+export declare function isGraphRunTerminalEventType(type: GraphExecutionEventType): boolean;
+/** Whether the run status is terminal (`succeeded`, `failed`, or `cancelled`). */
+export declare function isGraphRunTerminalStatus(status: GraphRunStatus): boolean;
+/** Type guard for {@link GraphRunStatus}. */
+export declare function isGraphRunStatus(value: unknown): value is GraphRunStatus;

package/lib/types/graph/index.d.cts

@@ -9,4 +9,7 @@ export * from "./reader.d.cts";
 export * from "./document/index.d.cts";
 export * from "./catalog/index.d.cts";
 export * from "./types.d.cts";
+export * from "./GraphExecutionStateMapper.d.cts";
+export * from "./GraphResolution.d.cts";
+export * from "./nodes/index.d.cts";
 export * from "./overrides/index.d.cts";

package/lib/types/graph/index.d.mts

@@ -9,4 +9,7 @@ export * from "./reader.d.mts";
 export * from "./document/index.d.mts";
 export * from "./catalog/index.d.mts";
 export * from "./types.d.mts";
+export * from "./GraphExecutionStateMapper.d.mts";
+export * from "./GraphResolution.d.mts";
+export * from "./nodes/index.d.mts";
 export * from "./overrides/index.d.mts";

package/lib/types/graph/nodes/agents/agent.d.cts

@@ -0,0 +1,44 @@
+/**
+ * @module ui-decorators/graph/nodes/agents/agent
+ * @summary Production Agent node declaration.
+ * @description The Agent node is the primary AI agent entrypoint. It is a
+ * rectangular node with `@connection()` ports for its structural
+ * dependencies: `model` (the LLM), `memory` (the memory store), and
+ * `workspace` (the workspace/context). Connections are rendered on the
+ * bottom side of the node (DECAF-32 §21.3). Each connection category has a
+ * distinct color defined in the category style registry.
+ *
+ * The single `prompt` input accepts placeholder expressions (§22.4) such as
+ * `{{ $input.brief }}` or `{{ $node["Research"].output.summary }}` that are
+ * resolved at execution time by the placeholder compiler.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+/**
+ * Agent node — an AI agent that orchestrates a model, memory, and workspace.
+ *
+ * The agent has:
+ * - `@input` port on the **left**: `prompt` (the task prompt; supports
+ *   placeholder expressions like `{{ $input.something }}` per §22.4).
+ * - `@output` ports on the **right**: `response` (the agent's output), `actions`
+ *   (any actions the agent decided to take).
+ * - `@connection` ports on the **bottom**: `model` (LLM), `memory` (memory
+ *   store), `workspace` (workspace/context). Each connection has a distinct
+ *   category color.
+ *
+ * The node is rectangular (not rounded) to visually distinguish it from
+ * regular processing nodes. The `color` and `icon` are omitted from `@node()`
+ * so they are resolved from the `"Agent"` category style.
+ */
+export declare class AgentNode extends Model {
+    prompt: string;
+    response: string;
+    actions: unknown[];
+    model: unknown;
+    memory: unknown;
+    workspace: unknown;
+}
+/**
+ * All built-in agent node constructors.
+ */
+export declare const GRAPH_AGENT_NODES: readonly [typeof AgentNode];

package/lib/types/graph/nodes/agents/agent.d.mts

@@ -0,0 +1,44 @@
+/**
+ * @module ui-decorators/graph/nodes/agents/agent
+ * @summary Production Agent node declaration.
+ * @description The Agent node is the primary AI agent entrypoint. It is a
+ * rectangular node with `@connection()` ports for its structural
+ * dependencies: `model` (the LLM), `memory` (the memory store), and
+ * `workspace` (the workspace/context). Connections are rendered on the
+ * bottom side of the node (DECAF-32 §21.3). Each connection category has a
+ * distinct color defined in the category style registry.
+ *
+ * The single `prompt` input accepts placeholder expressions (§22.4) such as
+ * `{{ $input.brief }}` or `{{ $node["Research"].output.summary }}` that are
+ * resolved at execution time by the placeholder compiler.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+/**
+ * Agent node — an AI agent that orchestrates a model, memory, and workspace.
+ *
+ * The agent has:
+ * - `@input` port on the **left**: `prompt` (the task prompt; supports
+ *   placeholder expressions like `{{ $input.something }}` per §22.4).
+ * - `@output` ports on the **right**: `response` (the agent's output), `actions`
+ *   (any actions the agent decided to take).
+ * - `@connection` ports on the **bottom**: `model` (LLM), `memory` (memory
+ *   store), `workspace` (workspace/context). Each connection has a distinct
+ *   category color.
+ *
+ * The node is rectangular (not rounded) to visually distinguish it from
+ * regular processing nodes. The `color` and `icon` are omitted from `@node()`
+ * so they are resolved from the `"Agent"` category style.
+ */
+export declare class AgentNode extends Model {
+    prompt: string;
+    response: string;
+    actions: unknown[];
+    model: unknown;
+    memory: unknown;
+    workspace: unknown;
+}
+/**
+ * All built-in agent node constructors.
+ */
+export declare const GRAPH_AGENT_NODES: readonly [typeof AgentNode];

package/lib/types/graph/nodes/base.d.cts

@@ -0,0 +1,28 @@
+/**
+ * @module ui-decorators/graph/nodes/base
+ * @summary Base class for shared graph node declarations.
+ * @description `GraphNode` extends `Model` with an overridable
+ * `applyMetadata` static method. Concrete node kinds that support dynamic
+ * metadata changes (e.g. `SwitchFlowNode` adding case output ports) override
+ * this method to compute their own ports, size, and data patches — the node
+ * is exclusively responsible for itself in every way.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import type { NodeMetadataChange } from "../types.d.cts";
+export declare class GraphNode extends Model {
+    /**
+     * Applies a metadata patch to this node class, returning the resulting
+     * ports, size, and data patches.
+     *
+     * The default implementation returns `null` (no changes). Concrete node
+     * kinds that support dynamic metadata override this to compute their own
+     * ports and size from the metadata — the caller (renderer) simply relays
+     * the result to the diagram model.
+     *
+     * @param _meta - The metadata patch (node-kind-specific, e.g.
+     *   `SwitchNodeMetadata`).
+     * @returns The computed change, or `null` when the node kind does not
+     *   support dynamic metadata.
+     */
+    static applyMetadata(_meta: unknown): NodeMetadataChange | null;
+}

package/lib/types/graph/nodes/base.d.mts

@@ -0,0 +1,28 @@
+/**
+ * @module ui-decorators/graph/nodes/base
+ * @summary Base class for shared graph node declarations.
+ * @description `GraphNode` extends `Model` with an overridable
+ * `applyMetadata` static method. Concrete node kinds that support dynamic
+ * metadata changes (e.g. `SwitchFlowNode` adding case output ports) override
+ * this method to compute their own ports, size, and data patches — the node
+ * is exclusively responsible for itself in every way.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import type { NodeMetadataChange } from "../types.d.mts";
+export declare class GraphNode extends Model {
+    /**
+     * Applies a metadata patch to this node class, returning the resulting
+     * ports, size, and data patches.
+     *
+     * The default implementation returns `null` (no changes). Concrete node
+     * kinds that support dynamic metadata override this to compute their own
+     * ports and size from the metadata — the caller (renderer) simply relays
+     * the result to the diagram model.
+     *
+     * @param _meta - The metadata patch (node-kind-specific, e.g.
+     *   `SwitchNodeMetadata`).
+     * @returns The computed change, or `null` when the node kind does not
+     *   support dynamic metadata.
+     */
+    static applyMetadata(_meta: unknown): NodeMetadataChange | null;
+}

package/lib/types/graph/nodes/boundary/input-value.d.cts

@@ -0,0 +1,13 @@
+/**
+ * @module ui-decorators/graph/nodes/boundary/input-value
+ * @summary Workflow input value boundary node declaration.
+ * @description Shared canvas node representing a workflow input value
+ * (decorator id `graph-input-value-node`), moved from the for-angular
+ * boundary nodes so both sides share the declaration. Reusable value node
+ * whose single `value` output may feed multiple targets.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphInputValueNode extends Model {
+    value: unknown;
+}

package/lib/types/graph/nodes/boundary/input-value.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @module ui-decorators/graph/nodes/boundary/input-value
+ * @summary Workflow input value boundary node declaration.
+ * @description Shared canvas node representing a workflow input value
+ * (decorator id `graph-input-value-node`), moved from the for-angular
+ * boundary nodes so both sides share the declaration. Reusable value node
+ * whose single `value` output may feed multiple targets.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphInputValueNode extends Model {
+    value: unknown;
+}

package/lib/types/graph/nodes/category-styles.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Registers all built-in category styles. Called once at module init.
+ *
+ * Categories define the default visual style for nodes and connection ports.
+ * A node's explicit `color` / `icon` (on `@node()`) overrides the category
+ * style; when omitted, the category style is used.
+ */
+export declare function registerBuiltinCategoryStyles(): void;

package/lib/types/graph/nodes/category-styles.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Registers all built-in category styles. Called once at module init.
+ *
+ * Categories define the default visual style for nodes and connection ports.
+ * A node's explicit `color` / `icon` (on `@node()`) overrides the category
+ * style; when omitted, the category style is used.
+ */
+export declare function registerBuiltinCategoryStyles(): void;

package/lib/types/graph/nodes/flow-control/break.d.cts

@@ -0,0 +1,15 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/break
+ * @summary Break flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Break — breaks out of the enclosing loop (foreach/while/until).
+ * When executed inside a loop body, the loop terminates early and the loop's
+ * `completed`/`state` output carries the results collected so far. The Break
+ * node executor throws a `GraphBreakSignal` that the enclosing loop executor
+ * catches.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class BreakFlowNode extends Model {
+    value: unknown;
+    broken: unknown;
+}

package/lib/types/graph/nodes/flow-control/break.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/break
+ * @summary Break flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Break — breaks out of the enclosing loop (foreach/while/until).
+ * When executed inside a loop body, the loop terminates early and the loop's
+ * `completed`/`state` output carries the results collected so far. The Break
+ * node executor throws a `GraphBreakSignal` that the enclosing loop executor
+ * catches.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class BreakFlowNode extends Model {
+    value: unknown;
+    broken: unknown;
+}

package/lib/types/graph/nodes/flow-control/error-boundary.d.cts

@@ -0,0 +1,12 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/error-boundary
+ * @summary Error-boundary flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Error boundary — try/catch/finally workflow behaviour.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ErrorBoundaryFlowNode extends Model {
+    value: unknown;
+    result: unknown;
+    error: unknown;
+}

package/lib/types/graph/nodes/flow-control/error-boundary.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/error-boundary
+ * @summary Error-boundary flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Error boundary — try/catch/finally workflow behaviour.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ErrorBoundaryFlowNode extends Model {
+    value: unknown;
+    result: unknown;
+    error: unknown;
+}

package/lib/types/graph/nodes/flow-control/human-approval.d.cts

@@ -0,0 +1,13 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/human-approval
+ * @summary Human-approval flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Human approval — suspends execution until a human approves
+ * or rejects.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class HumanApprovalFlowNode extends Model {
+    value: unknown;
+    approved: unknown;
+    rejected: unknown;
+}

package/lib/types/graph/nodes/flow-control/human-approval.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/human-approval
+ * @summary Human-approval flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Human approval — suspends execution until a human approves
+ * or rejects.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class HumanApprovalFlowNode extends Model {
+    value: unknown;
+    approved: unknown;
+    rejected: unknown;
+}

package/lib/types/graph/nodes/flow-control/if.d.cts

@@ -0,0 +1,16 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/if
+ * @summary If flow-control node declaration (DECAF-32 §22.2.2).
+ * @description If — conditional branch. Evaluates a `ConditionExpression`
+ * (§22.3) and routes the input to the `then` or `else` output. A graph-level
+ * macro: the engine's planner recognises it as an ordinary executable node
+ * (§5.7) but it has no built-in executor — downstream projects register
+ * custom executors or compile it into composition APIs (§22.2.2).
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class IfFlowNode extends Model {
+    value: unknown;
+    then: unknown;
+    else: unknown;
+}

package/lib/types/graph/nodes/flow-control/if.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/if
+ * @summary If flow-control node declaration (DECAF-32 §22.2.2).
+ * @description If — conditional branch. Evaluates a `ConditionExpression`
+ * (§22.3) and routes the input to the `then` or `else` output. A graph-level
+ * macro: the engine's planner recognises it as an ordinary executable node
+ * (§5.7) but it has no built-in executor — downstream projects register
+ * custom executors or compile it into composition APIs (§22.2.2).
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class IfFlowNode extends Model {
+    value: unknown;
+    then: unknown;
+    else: unknown;
+}

package/lib/types/graph/nodes/flow-control/parallel.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/parallel
+ * @summary Parallel flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Parallel — splits execution into concurrent branches.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ParallelFlowNode extends Model {
+    value: unknown;
+    branches: unknown[];
+}

package/lib/types/graph/nodes/flow-control/parallel.d.mts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/flow-control/parallel
+ * @summary Parallel flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Parallel — splits execution into concurrent branches.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ParallelFlowNode extends Model {
+    value: unknown;
+    branches: unknown[];
+}

package/lib/types/graph/nodes/flow-control/switch.d.cts

@@ -0,0 +1,21 @@
+import type { NodeMetadataChange, SwitchNodeMetadata } from "../../types.d.cts";
+import { GraphNode } from "../base.d.cts";
+import "../category-styles";
+export declare class SwitchFlowNode extends GraphNode {
+    value: unknown;
+    default: unknown;
+    /**
+     * Computes the node's ports, size, and data patch from the given switch
+     * metadata. Each case gets its own output port on the right side; the
+     * `default` port always renders **last** (DECAF-32 §21 port-ordering rule,
+     * DECAF-34 §6.2). When `hasDefault` is `false`, the `default` output port
+     * is omitted entirely. The node grows in height as cases are added.
+     *
+     * @param meta - The switch metadata patch (`metadata.switch`), carrying
+     *   the cases and the optional default-port configuration.
+     * @returns The computed {@link NodeMetadataChange}: reordered ports
+     *   (case outputs inserted before the optional default), the grown size,
+     *   and the `switchMetadata` data patch.
+     */
+    static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
+}

package/lib/types/graph/nodes/flow-control/switch.d.mts

@@ -0,0 +1,21 @@
+import type { NodeMetadataChange, SwitchNodeMetadata } from "../../types.d.mts";
+import { GraphNode } from "../base.d.mts";
+import "../category-styles";
+export declare class SwitchFlowNode extends GraphNode {
+    value: unknown;
+    default: unknown;
+    /**
+     * Computes the node's ports, size, and data patch from the given switch
+     * metadata. Each case gets its own output port on the right side; the
+     * `default` port always renders **last** (DECAF-32 §21 port-ordering rule,
+     * DECAF-34 §6.2). When `hasDefault` is `false`, the `default` output port
+     * is omitted entirely. The node grows in height as cases are added.
+     *
+     * @param meta - The switch metadata patch (`metadata.switch`), carrying
+     *   the cases and the optional default-port configuration.
+     * @returns The computed {@link NodeMetadataChange}: reordered ports
+     *   (case outputs inserted before the optional default), the grown size,
+     *   and the `switchMetadata` data patch.
+     */
+    static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
+}