@decaf-ts/ui-decorators 0.20.4 → 0.20.6

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

@@ -0,0 +1,79 @@
+/**
+ * @module ui-decorators/graph/nodes
+ * @summary Shared node kind declarations (DECAF-32 §22.2, DECAF-50 Phase A).
+ * @description Canonical `@node`-decorated classes for the ALFRED-5 node kind
+ * taxonomy, laid out one node per file under `nodes/<category>/<node>.ts`:
+ * triggers (§22.2.1), flow-control and utility nodes (§22.2.2–22.2.3), the
+ * Agent node (§21.3), the three loop kinds (`core.loop.foreach/while/until`,
+ * §5.9), and the workflow input-value boundary node. Shared non-node support
+ * (base class, category styles, manifests) lives in sibling files under the
+ * same tree. Consumers (for-angular, ALFRED, etc.) import these declarations
+ * to populate node palettes, registries, and reference snapshots.
+ */
+export * from "./base.d.cts";
+export * from "./category-styles.d.cts";
+export * from "./flow-control/break.d.cts";
+export * from "./flow-control/error-boundary.d.cts";
+export * from "./flow-control/human-approval.d.cts";
+export * from "./flow-control/if.d.cts";
+export * from "./flow-control/parallel.d.cts";
+export * from "./flow-control/switch.d.cts";
+export * from "./utility/code.d.cts";
+export * from "./utility/delay.d.cts";
+export * from "./utility/log.d.cts";
+export * from "./utility/map.d.cts";
+export * from "./utility/merge.d.cts";
+export * from "./utility/return.d.cts";
+export * from "./utility/utility-log.d.cts";
+export * from "./triggers/chat.d.cts";
+export * from "./triggers/event.d.cts";
+export * from "./triggers/form.d.cts";
+export * from "./triggers/manual.d.cts";
+export * from "./triggers/schedule.d.cts";
+export * from "./triggers/webhook.d.cts";
+export * from "./agents/agent.d.cts";
+export * from "./loops/foreach.d.cts";
+export * from "./loops/until.d.cts";
+export * from "./loops/while.d.cts";
+export * from "./boundary/input-value.d.cts";
+export * from "./manifests.d.cts";
+import { BreakFlowNode } from "./flow-control/break.d.cts";
+import { ErrorBoundaryFlowNode } from "./flow-control/error-boundary.d.cts";
+import { HumanApprovalFlowNode } from "./flow-control/human-approval.d.cts";
+import { IfFlowNode } from "./flow-control/if.d.cts";
+import { ParallelFlowNode } from "./flow-control/parallel.d.cts";
+import { SwitchFlowNode } from "./flow-control/switch.d.cts";
+import { CodeFlowNode } from "./utility/code.d.cts";
+import { DelayFlowNode } from "./utility/delay.d.cts";
+import { LogFlowNode } from "./utility/log.d.cts";
+import { MapFlowNode } from "./utility/map.d.cts";
+import { MergeFlowNode } from "./utility/merge.d.cts";
+import { ReturnFlowNode } from "./utility/return.d.cts";
+import { UtilityLogNode } from "./utility/utility-log.d.cts";
+import { ChatTriggerNode } from "./triggers/chat.d.cts";
+import { EventTriggerNode } from "./triggers/event.d.cts";
+import { FormTriggerNode } from "./triggers/form.d.cts";
+import { ManualTriggerNode } from "./triggers/manual.d.cts";
+import { ScheduleTriggerNode } from "./triggers/schedule.d.cts";
+import { WebhookTriggerNode } from "./triggers/webhook.d.cts";
+import { GraphForeachLoopNode } from "./loops/foreach.d.cts";
+import { GraphUntilLoopNode } from "./loops/until.d.cts";
+import { GraphWhileLoopNode } from "./loops/while.d.cts";
+import { GraphInputValueNode } from "./boundary/input-value.d.cts";
+/**
+ * All built-in trigger node constructors.
+ */
+export declare const GRAPH_TRIGGER_NODES: readonly [typeof ManualTriggerNode, typeof WebhookTriggerNode, typeof ScheduleTriggerNode, typeof EventTriggerNode, typeof FormTriggerNode, typeof ChatTriggerNode];
+/**
+ * All built-in flow-control node constructors.
+ */
+export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof MapFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof CodeFlowNode, typeof LogFlowNode, typeof UtilityLogNode, typeof BreakFlowNode];
+/**
+ * All built-in loop node constructors (shared declarations of the
+ * `core.loop.*` system kinds).
+ */
+export declare const GRAPH_LOOP_NODES: readonly [typeof GraphForeachLoopNode, typeof GraphWhileLoopNode, typeof GraphUntilLoopNode];
+/**
+ * All built-in boundary node constructors.
+ */
+export declare const GRAPH_BOUNDARY_NODES: readonly [typeof GraphInputValueNode];

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

@@ -0,0 +1,79 @@
+/**
+ * @module ui-decorators/graph/nodes
+ * @summary Shared node kind declarations (DECAF-32 §22.2, DECAF-50 Phase A).
+ * @description Canonical `@node`-decorated classes for the ALFRED-5 node kind
+ * taxonomy, laid out one node per file under `nodes/<category>/<node>.ts`:
+ * triggers (§22.2.1), flow-control and utility nodes (§22.2.2–22.2.3), the
+ * Agent node (§21.3), the three loop kinds (`core.loop.foreach/while/until`,
+ * §5.9), and the workflow input-value boundary node. Shared non-node support
+ * (base class, category styles, manifests) lives in sibling files under the
+ * same tree. Consumers (for-angular, ALFRED, etc.) import these declarations
+ * to populate node palettes, registries, and reference snapshots.
+ */
+export * from "./base.d.mts";
+export * from "./category-styles.d.mts";
+export * from "./flow-control/break.d.mts";
+export * from "./flow-control/error-boundary.d.mts";
+export * from "./flow-control/human-approval.d.mts";
+export * from "./flow-control/if.d.mts";
+export * from "./flow-control/parallel.d.mts";
+export * from "./flow-control/switch.d.mts";
+export * from "./utility/code.d.mts";
+export * from "./utility/delay.d.mts";
+export * from "./utility/log.d.mts";
+export * from "./utility/map.d.mts";
+export * from "./utility/merge.d.mts";
+export * from "./utility/return.d.mts";
+export * from "./utility/utility-log.d.mts";
+export * from "./triggers/chat.d.mts";
+export * from "./triggers/event.d.mts";
+export * from "./triggers/form.d.mts";
+export * from "./triggers/manual.d.mts";
+export * from "./triggers/schedule.d.mts";
+export * from "./triggers/webhook.d.mts";
+export * from "./agents/agent.d.mts";
+export * from "./loops/foreach.d.mts";
+export * from "./loops/until.d.mts";
+export * from "./loops/while.d.mts";
+export * from "./boundary/input-value.d.mts";
+export * from "./manifests.d.mts";
+import { BreakFlowNode } from "./flow-control/break.d.mts";
+import { ErrorBoundaryFlowNode } from "./flow-control/error-boundary.d.mts";
+import { HumanApprovalFlowNode } from "./flow-control/human-approval.d.mts";
+import { IfFlowNode } from "./flow-control/if.d.mts";
+import { ParallelFlowNode } from "./flow-control/parallel.d.mts";
+import { SwitchFlowNode } from "./flow-control/switch.d.mts";
+import { CodeFlowNode } from "./utility/code.d.mts";
+import { DelayFlowNode } from "./utility/delay.d.mts";
+import { LogFlowNode } from "./utility/log.d.mts";
+import { MapFlowNode } from "./utility/map.d.mts";
+import { MergeFlowNode } from "./utility/merge.d.mts";
+import { ReturnFlowNode } from "./utility/return.d.mts";
+import { UtilityLogNode } from "./utility/utility-log.d.mts";
+import { ChatTriggerNode } from "./triggers/chat.d.mts";
+import { EventTriggerNode } from "./triggers/event.d.mts";
+import { FormTriggerNode } from "./triggers/form.d.mts";
+import { ManualTriggerNode } from "./triggers/manual.d.mts";
+import { ScheduleTriggerNode } from "./triggers/schedule.d.mts";
+import { WebhookTriggerNode } from "./triggers/webhook.d.mts";
+import { GraphForeachLoopNode } from "./loops/foreach.d.mts";
+import { GraphUntilLoopNode } from "./loops/until.d.mts";
+import { GraphWhileLoopNode } from "./loops/while.d.mts";
+import { GraphInputValueNode } from "./boundary/input-value.d.mts";
+/**
+ * All built-in trigger node constructors.
+ */
+export declare const GRAPH_TRIGGER_NODES: readonly [typeof ManualTriggerNode, typeof WebhookTriggerNode, typeof ScheduleTriggerNode, typeof EventTriggerNode, typeof FormTriggerNode, typeof ChatTriggerNode];
+/**
+ * All built-in flow-control node constructors.
+ */
+export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof MapFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof CodeFlowNode, typeof LogFlowNode, typeof UtilityLogNode, typeof BreakFlowNode];
+/**
+ * All built-in loop node constructors (shared declarations of the
+ * `core.loop.*` system kinds).
+ */
+export declare const GRAPH_LOOP_NODES: readonly [typeof GraphForeachLoopNode, typeof GraphWhileLoopNode, typeof GraphUntilLoopNode];
+/**
+ * All built-in boundary node constructors.
+ */
+export declare const GRAPH_BOUNDARY_NODES: readonly [typeof GraphInputValueNode];

package/lib/types/graph/nodes/loops/foreach.d.cts

@@ -0,0 +1,19 @@
+/**
+ * @module ui-decorators/graph/nodes/loops/foreach
+ * @summary Foreach loop node declaration.
+ * @description Shared declaration for the `core.loop.foreach` system node
+ * kind (decorator id `graph-foreach-loop-node`), ported from the for-angular
+ * demo app so the loop kinds become shared canvas nodes. Its executor is
+ * built into the integrations engine (`ForeachGraphNodeExecutor`). The
+ * loop-body workflow is demo/app-side content and is not part of the shared
+ * declaration — the shared class carries the port/metadata shape only.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphForeachLoopNode extends Model {
+    items: unknown[];
+    slice: number;
+    item: unknown;
+    loop: unknown;
+    completed: unknown[];
+}

package/lib/types/graph/nodes/loops/foreach.d.mts

@@ -0,0 +1,19 @@
+/**
+ * @module ui-decorators/graph/nodes/loops/foreach
+ * @summary Foreach loop node declaration.
+ * @description Shared declaration for the `core.loop.foreach` system node
+ * kind (decorator id `graph-foreach-loop-node`), ported from the for-angular
+ * demo app so the loop kinds become shared canvas nodes. Its executor is
+ * built into the integrations engine (`ForeachGraphNodeExecutor`). The
+ * loop-body workflow is demo/app-side content and is not part of the shared
+ * declaration — the shared class carries the port/metadata shape only.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphForeachLoopNode extends Model {
+    items: unknown[];
+    slice: number;
+    item: unknown;
+    loop: unknown;
+    completed: unknown[];
+}

package/lib/types/graph/nodes/loops/until.d.cts

@@ -0,0 +1,16 @@
+/**
+ * @module ui-decorators/graph/nodes/loops/until
+ * @summary Until loop node declaration.
+ * @description Shared declaration for the `core.loop.until` system node kind
+ * (decorator id `graph-until-loop-node`), ported from the for-angular demo
+ * app so the loop kinds become shared canvas nodes. Its executor is built
+ * into the integrations engine (`UntilGraphNodeExecutor`). The loop-body
+ * workflow is demo/app-side content and is not part of the shared
+ * declaration — the shared class carries the port/metadata shape only.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphUntilLoopNode extends Model {
+    state: unknown;
+    stateOut: unknown;
+}

package/lib/types/graph/nodes/loops/until.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @module ui-decorators/graph/nodes/loops/until
+ * @summary Until loop node declaration.
+ * @description Shared declaration for the `core.loop.until` system node kind
+ * (decorator id `graph-until-loop-node`), ported from the for-angular demo
+ * app so the loop kinds become shared canvas nodes. Its executor is built
+ * into the integrations engine (`UntilGraphNodeExecutor`). The loop-body
+ * workflow is demo/app-side content and is not part of the shared
+ * declaration — the shared class carries the port/metadata shape only.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphUntilLoopNode extends Model {
+    state: unknown;
+    stateOut: unknown;
+}

package/lib/types/graph/nodes/loops/while.d.cts

@@ -0,0 +1,16 @@
+/**
+ * @module ui-decorators/graph/nodes/loops/while
+ * @summary While loop node declaration.
+ * @description Shared declaration for the `core.loop.while` system node kind
+ * (decorator id `graph-while-loop-node`), ported from the for-angular demo
+ * app so the loop kinds become shared canvas nodes. Its executor is built
+ * into the integrations engine (`WhileGraphNodeExecutor`). The loop-body
+ * workflow is demo/app-side content and is not part of the shared
+ * declaration — the shared class carries the port/metadata shape only.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphWhileLoopNode extends Model {
+    state: unknown;
+    stateOut: unknown;
+}

package/lib/types/graph/nodes/loops/while.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @module ui-decorators/graph/nodes/loops/while
+ * @summary While loop node declaration.
+ * @description Shared declaration for the `core.loop.while` system node kind
+ * (decorator id `graph-while-loop-node`), ported from the for-angular demo
+ * app so the loop kinds become shared canvas nodes. Its executor is built
+ * into the integrations engine (`WhileGraphNodeExecutor`). The loop-body
+ * workflow is demo/app-side content and is not part of the shared
+ * declaration — the shared class carries the port/metadata shape only.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class GraphWhileLoopNode extends Model {
+    state: unknown;
+    stateOut: unknown;
+}

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

@@ -0,0 +1,62 @@
+/**
+ * @module ui-decorators/graph/nodes/manifests
+ * @summary Built-in node manifests (DECAF-50 §4.12).
+ * @description The catalogue-published JSON manifests for every node kind
+ * the backend ships. Loop manifests are hand-authored (their loop-body
+ * shapes are structural); the rest are compiled from the shared
+ * `@node`-decorated classes via `graphNodeManifest`, so the served shape is
+ * identical to what the Angular palette consumes. Aggregated in
+ * `GRAPH_BUILT_IN_NODE_MANIFESTS` and indexed by kind in
+ * `GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND`.
+ */
+import type { GraphNodeManifest } from "../catalog/index.d.cts";
+/** Manifest for the `core.loop.foreach` node: runs the loop body once per item (or slice) of the input array. */
+export declare const FOREACH_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the `core.loop.while` node: repeats the loop body while the condition holds. */
+export declare const WHILE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the `core.loop.until` node: repeats the loop body until the condition holds. */
+export declare const UNTIL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the `core.flow.switch` node: routes execution by switch-case conditions (cases live under `parameters["switch"]`). */
+export declare const SWITCH_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the manual-trigger node (starts a run on demand). */
+export declare const MANUAL_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the webhook-trigger node (starts a run from an inbound webhook). */
+export declare const WEBHOOK_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the schedule-trigger node (starts a run on a schedule). */
+export declare const SCHEDULE_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the event-trigger node (starts a run on an observed event). */
+export declare const EVENT_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the form-trigger node (starts a run from a form submission). */
+export declare const FORM_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the chat-trigger node (starts a run from a chat message). */
+export declare const CHAT_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the if node (conditional branch on a boolean condition). */
+export declare const IF_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the parallel node (runs branches concurrently). */
+export declare const PARALLEL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the merge node (joins parallel branches). */
+export declare const MERGE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the map node (transforms each input item). */
+export declare const MAP_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the delay node (pauses execution for a duration). */
+export declare const DELAY_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the error-boundary node (isolates branch failures). */
+export declare const ERROR_BOUNDARY_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the human-approval node (waits for an approval decision). */
+export declare const HUMAN_APPROVAL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the return node (terminates the workflow with output values). */
+export declare const RETURN_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the code node (executes user code). */
+export declare const CODE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the log node (logs its input). */
+export declare const LOG_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the utility-log node (log-shaped utility sink). */
+export declare const UTILITY_LOG_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the break node (exits the enclosing loop). */
+export declare const BREAK_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the agent node (delegates work to an agent). */
+export declare const AGENT_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** All built-in node manifests, in catalogue display order. */
+export declare const GRAPH_BUILT_IN_NODE_MANIFESTS: GraphNodeManifest[];
+/** Built-in manifests indexed by node `kind` — the source for built-in catalogue registrations. */
+export declare const GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND: Record<string, GraphNodeManifest>;

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

@@ -0,0 +1,62 @@
+/**
+ * @module ui-decorators/graph/nodes/manifests
+ * @summary Built-in node manifests (DECAF-50 §4.12).
+ * @description The catalogue-published JSON manifests for every node kind
+ * the backend ships. Loop manifests are hand-authored (their loop-body
+ * shapes are structural); the rest are compiled from the shared
+ * `@node`-decorated classes via `graphNodeManifest`, so the served shape is
+ * identical to what the Angular palette consumes. Aggregated in
+ * `GRAPH_BUILT_IN_NODE_MANIFESTS` and indexed by kind in
+ * `GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND`.
+ */
+import type { GraphNodeManifest } from "../catalog/index.d.mts";
+/** Manifest for the `core.loop.foreach` node: runs the loop body once per item (or slice) of the input array. */
+export declare const FOREACH_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the `core.loop.while` node: repeats the loop body while the condition holds. */
+export declare const WHILE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the `core.loop.until` node: repeats the loop body until the condition holds. */
+export declare const UNTIL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the `core.flow.switch` node: routes execution by switch-case conditions (cases live under `parameters["switch"]`). */
+export declare const SWITCH_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the manual-trigger node (starts a run on demand). */
+export declare const MANUAL_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the webhook-trigger node (starts a run from an inbound webhook). */
+export declare const WEBHOOK_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the schedule-trigger node (starts a run on a schedule). */
+export declare const SCHEDULE_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the event-trigger node (starts a run on an observed event). */
+export declare const EVENT_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the form-trigger node (starts a run from a form submission). */
+export declare const FORM_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the chat-trigger node (starts a run from a chat message). */
+export declare const CHAT_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the if node (conditional branch on a boolean condition). */
+export declare const IF_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the parallel node (runs branches concurrently). */
+export declare const PARALLEL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the merge node (joins parallel branches). */
+export declare const MERGE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the map node (transforms each input item). */
+export declare const MAP_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the delay node (pauses execution for a duration). */
+export declare const DELAY_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the error-boundary node (isolates branch failures). */
+export declare const ERROR_BOUNDARY_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the human-approval node (waits for an approval decision). */
+export declare const HUMAN_APPROVAL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the return node (terminates the workflow with output values). */
+export declare const RETURN_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the code node (executes user code). */
+export declare const CODE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the log node (logs its input). */
+export declare const LOG_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the utility-log node (log-shaped utility sink). */
+export declare const UTILITY_LOG_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the break node (exits the enclosing loop). */
+export declare const BREAK_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** Manifest for the agent node (delegates work to an agent). */
+export declare const AGENT_GRAPH_NODE_MANIFEST: GraphNodeManifest;
+/** All built-in node manifests, in catalogue display order. */
+export declare const GRAPH_BUILT_IN_NODE_MANIFESTS: GraphNodeManifest[];
+/** Built-in manifests indexed by node `kind` — the source for built-in catalogue registrations. */
+export declare const GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND: Record<string, GraphNodeManifest>;

package/lib/types/graph/nodes/triggers/chat.d.cts

@@ -0,0 +1,13 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/chat
+ * @summary Chat trigger node declaration (DECAF-32 §22.2.1).
+ * @description Chat trigger — chat message entrypoint; message/sessionId/
+ * userId schema.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ChatTriggerNode extends Model {
+    message: string;
+    sessionId: string;
+    userId: string;
+}

package/lib/types/graph/nodes/triggers/chat.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/chat
+ * @summary Chat trigger node declaration (DECAF-32 §22.2.1).
+ * @description Chat trigger — chat message entrypoint; message/sessionId/
+ * userId schema.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ChatTriggerNode extends Model {
+    message: string;
+    sessionId: string;
+    userId: string;
+}

package/lib/types/graph/nodes/triggers/event.d.cts

@@ -0,0 +1,10 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/event
+ * @summary Event trigger node declaration (DECAF-32 §22.2.1).
+ * @description Event trigger — internal event bus topic subscriber.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class EventTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/event.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/event
+ * @summary Event trigger node declaration (DECAF-32 §22.2.1).
+ * @description Event trigger — internal event bus topic subscriber.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class EventTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/form.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/form
+ * @summary Form trigger node declaration (DECAF-32 §22.2.1).
+ * @description Form trigger — generated public/internal form; field
+ * definitions.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class FormTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/form.d.mts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/form
+ * @summary Form trigger node declaration (DECAF-32 §22.2.1).
+ * @description Form trigger — generated public/internal form; field
+ * definitions.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class FormTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/manual.d.cts

@@ -0,0 +1,12 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/manual
+ * @summary Manual trigger node declaration (DECAF-32 §22.2.1).
+ * @description Manual trigger — user clicks Run; input form generated from
+ * `inputSchema`. Triggers are metadata-only entrypoints: they define how a
+ * workflow starts and produce a trigger payload on their `@output` ports.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ManualTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/manual.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/manual
+ * @summary Manual trigger node declaration (DECAF-32 §22.2.1).
+ * @description Manual trigger — user clicks Run; input form generated from
+ * `inputSchema`. Triggers are metadata-only entrypoints: they define how a
+ * workflow starts and produce a trigger payload on their `@output` ports.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ManualTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/schedule.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/schedule
+ * @summary Schedule trigger node declaration (DECAF-32 §22.2.1).
+ * @description Schedule trigger — cron-like schedule; timezone + payload
+ * config.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ScheduleTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/schedule.d.mts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/schedule
+ * @summary Schedule trigger node declaration (DECAF-32 §22.2.1).
+ * @description Schedule trigger — cron-like schedule; timezone + payload
+ * config.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class ScheduleTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/webhook.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/webhook
+ * @summary Webhook trigger node declaration (DECAF-32 §22.2.1).
+ * @description Webhook trigger — HTTP request received; path/method/auth/
+ * responseMode config.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class WebhookTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/triggers/webhook.d.mts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/triggers/webhook
+ * @summary Webhook trigger node declaration (DECAF-32 §22.2.1).
+ * @description Webhook trigger — HTTP request received; path/method/auth/
+ * responseMode config.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class WebhookTriggerNode extends Model {
+    payload: unknown;
+}

package/lib/types/graph/nodes/utility/code.d.cts

@@ -0,0 +1,31 @@
+/**
+ * @module ui-decorators/graph/nodes/utility/code
+ * @summary Code utility node declaration (ALFRED-5 §7, DECAF-32 §22.4).
+ * @description Code — sandboxed JS/TS code execution. The engine's
+ * `CodeGraphNodeExecutor` delegates to the pluggable `CodeSandboxEvaluator`.
+ * The default `IsolatedVmCodeSandboxEvaluator` (backed by `isolated-vm`)
+ * enforces the Code Node restrictions: no imports, no requires, pure
+ * functions only. The sandbox context exposes `$input`, `$vars`, `$item`,
+ * `$index`, `$node`, and `$output` as data variables. TypeScript is
+ * supported via transpilation.
+ *
+ * The `@input` on `CodeFlowNode.input` is a schema group — the nested
+ * model's `@input` ports are spliced into the parent unprefixed. `code` has
+ * `@input` + `@uielement("code-editor")`, so it appears as a port AND in the
+ * CRUD modal (the only visible field). `data` has `@input` + `@hidden()` but
+ * no `@uielement`, so it is a canvas-only port (for edge connections from
+ * workflow input badges) but never appears in the CRUD modal. `language` has
+ * no `@input` and no `@uielement`, so it is neither a port nor rendered — it
+ * defaults to `"javascript"`.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class CodeInputSchema extends Model {
+    language: string;
+    code: string;
+    data?: unknown;
+}
+export declare class CodeFlowNode extends Model {
+    input: CodeInputSchema;
+    result: unknown;
+}

package/lib/types/graph/nodes/utility/code.d.mts

@@ -0,0 +1,31 @@
+/**
+ * @module ui-decorators/graph/nodes/utility/code
+ * @summary Code utility node declaration (ALFRED-5 §7, DECAF-32 §22.4).
+ * @description Code — sandboxed JS/TS code execution. The engine's
+ * `CodeGraphNodeExecutor` delegates to the pluggable `CodeSandboxEvaluator`.
+ * The default `IsolatedVmCodeSandboxEvaluator` (backed by `isolated-vm`)
+ * enforces the Code Node restrictions: no imports, no requires, pure
+ * functions only. The sandbox context exposes `$input`, `$vars`, `$item`,
+ * `$index`, `$node`, and `$output` as data variables. TypeScript is
+ * supported via transpilation.
+ *
+ * The `@input` on `CodeFlowNode.input` is a schema group — the nested
+ * model's `@input` ports are spliced into the parent unprefixed. `code` has
+ * `@input` + `@uielement("code-editor")`, so it appears as a port AND in the
+ * CRUD modal (the only visible field). `data` has `@input` + `@hidden()` but
+ * no `@uielement`, so it is a canvas-only port (for edge connections from
+ * workflow input badges) but never appears in the CRUD modal. `language` has
+ * no `@input` and no `@uielement`, so it is neither a port nor rendered — it
+ * defaults to `"javascript"`.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class CodeInputSchema extends Model {
+    language: string;
+    code: string;
+    data?: unknown;
+}
+export declare class CodeFlowNode extends Model {
+    input: CodeInputSchema;
+    result: unknown;
+}

package/lib/types/graph/nodes/utility/delay.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/utility/delay
+ * @summary Delay utility node declaration (DECAF-32 §22.2.2).
+ * @description Delay — pauses execution for a configured duration.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class DelayFlowNode extends Model {
+    value: unknown;
+    valueOut: unknown;
+}

package/lib/types/graph/nodes/utility/delay.d.mts

@@ -0,0 +1,11 @@
+/**
+ * @module ui-decorators/graph/nodes/utility/delay
+ * @summary Delay utility node declaration (DECAF-32 §22.2.2).
+ * @description Delay — pauses execution for a configured duration.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import "../category-styles";
+export declare class DelayFlowNode extends Model {
+    value: unknown;
+    valueOut: unknown;
+}