@decaf-ts/ui-decorators 0.21.0 → 0.21.1

package/lib/types/graph/document/GraphDecoratedWorkflowCompiler.d.cts

@@ -1,47 +0,0 @@
-import type { Constructor } from "@decaf-ts/decoration";
-import type { Model } from "@decaf-ts/decorator-validation";
-import type { GraphWorkflowDefinition } from "../constants.d.cts";
-import type { GraphWorkflowDocument } from "./GraphWorkflowDocument.d.cts";
-import type { GraphNodeEndpoint, GraphWorkflowEndpoint } from "./GraphEndpoint.d.cts";
-import type { GraphWorkflowViewport } from "./GraphWorkflowUiState.d.cts";
-/**
- * Options for compiling a decorated workflow into a canonical
- * {@link GraphWorkflowDocument}.
- */
-export interface GraphDecoratedWorkflowCompileOptions {
-    /** Document id; defaults to the workflow's tag or name. */
-    id?: string;
-    /** Human-readable document name; defaults to the workflow's name. */
-    name?: string;
-    /** Canvas positions per node id, carried into the document's UI state. */
-    positions?: Record<string, {
-        x: number;
-        y: number;
-    }>;
-    /** Initial canvas viewport carried into the document's UI state. */
-    viewport?: GraphWorkflowViewport;
-}
-/** Anything the compiler can resolve into a {@link GraphWorkflowDefinition}: a decorated workflow class (constructor), a model instance, or a definition. */
-export type GraphDecoratedWorkflowInput = Constructor | Model | GraphWorkflowDefinition;
-/**
- * Compiles a decorated workflow (or an already-resolved
- * {@link GraphWorkflowDefinition}) into a canonical
- * {@link GraphWorkflowDocument}: workflow boundary ports, one instance per
- * node (input-port defaults and loop/switch metadata folded into
- * `parameters`/`metadata`), one edge per relation, plus UI state. Browser-safe:
- * node constructors are never invoked, so `@node` classes can seed demo
- * graphs without engine imports (DECAF-50 §4.4.4).
- *
- * @throws ValidationError when the input cannot be resolved to a decorated
- * graph workflow definition.
- */
-export declare function graphDecoratedWorkflowCompiler(workflow: GraphDecoratedWorkflowInput, options?: GraphDecoratedWorkflowCompileOptions): GraphWorkflowDocument;
-/**
- * Spec-mandated (§4.4.9) compiler facade. Delegates to
- * {@link graphDecoratedWorkflowCompiler}, which performs the actual
- * decorated-definition to {@link GraphWorkflowDocument} mapping.
- */
-export declare class GraphDecoratedWorkflowCompiler {
-    compile(workflow: GraphDecoratedWorkflowInput, options?: GraphDecoratedWorkflowCompileOptions): GraphWorkflowDocument;
-}
-export type { GraphWorkflowEndpoint, GraphNodeEndpoint };

package/lib/types/graph/document/GraphDecoratedWorkflowCompiler.d.mts

@@ -1,47 +0,0 @@
-import type { Constructor } from "@decaf-ts/decoration";
-import type { Model } from "@decaf-ts/decorator-validation";
-import type { GraphWorkflowDefinition } from "../constants.d.mts";
-import type { GraphWorkflowDocument } from "./GraphWorkflowDocument.d.mts";
-import type { GraphNodeEndpoint, GraphWorkflowEndpoint } from "./GraphEndpoint.d.mts";
-import type { GraphWorkflowViewport } from "./GraphWorkflowUiState.d.mts";
-/**
- * Options for compiling a decorated workflow into a canonical
- * {@link GraphWorkflowDocument}.
- */
-export interface GraphDecoratedWorkflowCompileOptions {
-    /** Document id; defaults to the workflow's tag or name. */
-    id?: string;
-    /** Human-readable document name; defaults to the workflow's name. */
-    name?: string;
-    /** Canvas positions per node id, carried into the document's UI state. */
-    positions?: Record<string, {
-        x: number;
-        y: number;
-    }>;
-    /** Initial canvas viewport carried into the document's UI state. */
-    viewport?: GraphWorkflowViewport;
-}
-/** Anything the compiler can resolve into a {@link GraphWorkflowDefinition}: a decorated workflow class (constructor), a model instance, or a definition. */
-export type GraphDecoratedWorkflowInput = Constructor | Model | GraphWorkflowDefinition;
-/**
- * Compiles a decorated workflow (or an already-resolved
- * {@link GraphWorkflowDefinition}) into a canonical
- * {@link GraphWorkflowDocument}: workflow boundary ports, one instance per
- * node (input-port defaults and loop/switch metadata folded into
- * `parameters`/`metadata`), one edge per relation, plus UI state. Browser-safe:
- * node constructors are never invoked, so `@node` classes can seed demo
- * graphs without engine imports (DECAF-50 §4.4.4).
- *
- * @throws ValidationError when the input cannot be resolved to a decorated
- * graph workflow definition.
- */
-export declare function graphDecoratedWorkflowCompiler(workflow: GraphDecoratedWorkflowInput, options?: GraphDecoratedWorkflowCompileOptions): GraphWorkflowDocument;
-/**
- * Spec-mandated (§4.4.9) compiler facade. Delegates to
- * {@link graphDecoratedWorkflowCompiler}, which performs the actual
- * decorated-definition to {@link GraphWorkflowDocument} mapping.
- */
-export declare class GraphDecoratedWorkflowCompiler {
-    compile(workflow: GraphDecoratedWorkflowInput, options?: GraphDecoratedWorkflowCompileOptions): GraphWorkflowDocument;
-}
-export type { GraphWorkflowEndpoint, GraphNodeEndpoint };

package/lib/types/graph/document/GraphEdgeInstance.d.cts

@@ -1,12 +0,0 @@
-import type { GraphEndpoint } from "./GraphEndpoint.d.cts";
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-import type { GraphEdgeUiState } from "./GraphWorkflowUiState.d.cts";
-export interface GraphEdgeInstance {
-    id: string;
-    type: "data" | "connection";
-    source: GraphEndpoint;
-    target: GraphEndpoint;
-    label?: string;
-    metadata?: Record<string, GraphJsonValue>;
-    ui?: GraphEdgeUiState;
-}

package/lib/types/graph/document/GraphEdgeInstance.d.mts

@@ -1,12 +0,0 @@
-import type { GraphEndpoint } from "./GraphEndpoint.d.mts";
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-import type { GraphEdgeUiState } from "./GraphWorkflowUiState.d.mts";
-export interface GraphEdgeInstance {
-    id: string;
-    type: "data" | "connection";
-    source: GraphEndpoint;
-    target: GraphEndpoint;
-    label?: string;
-    metadata?: Record<string, GraphJsonValue>;
-    ui?: GraphEdgeUiState;
-}

package/lib/types/graph/document/GraphEndpoint.d.cts

@@ -1,13 +0,0 @@
-export type GraphWorkflowEndpoint = {
-    scope: "workflow";
-    port: string;
-};
-export type GraphNodeEndpoint = {
-    scope: "node";
-    nodeId: string;
-    port: string;
-};
-export type GraphEndpoint = GraphWorkflowEndpoint | GraphNodeEndpoint;
-export declare function isGraphWorkflowEndpoint(endpoint: GraphEndpoint): endpoint is GraphWorkflowEndpoint;
-export declare function isGraphNodeEndpoint(endpoint: GraphEndpoint): endpoint is GraphNodeEndpoint;
-export declare function isGraphEndpoint(value: unknown): value is GraphEndpoint;

package/lib/types/graph/document/GraphEndpoint.d.mts

@@ -1,13 +0,0 @@
-export type GraphWorkflowEndpoint = {
-    scope: "workflow";
-    port: string;
-};
-export type GraphNodeEndpoint = {
-    scope: "node";
-    nodeId: string;
-    port: string;
-};
-export type GraphEndpoint = GraphWorkflowEndpoint | GraphNodeEndpoint;
-export declare function isGraphWorkflowEndpoint(endpoint: GraphEndpoint): endpoint is GraphWorkflowEndpoint;
-export declare function isGraphNodeEndpoint(endpoint: GraphEndpoint): endpoint is GraphNodeEndpoint;
-export declare function isGraphEndpoint(value: unknown): value is GraphEndpoint;

package/lib/types/graph/document/GraphJsonValue.d.cts

@@ -1,11 +0,0 @@
-export type GraphJsonPrimitive = string | number | boolean | null;
-export type GraphJsonValue = GraphJsonPrimitive | GraphJsonValue[] | {
-    [key: string]: GraphJsonValue;
-};
-export declare const GRAPH_UNSAFE_OBJECT_KEYS: readonly ["__proto__", "prototype", "constructor"];
-export type GraphUnsafeObjectKey = (typeof GRAPH_UNSAFE_OBJECT_KEYS)[number];
-export declare function isGraphUnsafeObjectKey(key: string): key is GraphUnsafeObjectKey;
-export declare function isGraphJsonPrimitive(value: unknown): value is GraphJsonPrimitive;
-export declare function isGraphJsonValue(value: unknown): value is GraphJsonValue;
-export declare function isGraphJsonSafeValue(value: unknown): boolean;
-export declare function cloneGraphJsonValue<T extends GraphJsonValue>(value: T): T;

package/lib/types/graph/document/GraphJsonValue.d.mts

@@ -1,11 +0,0 @@
-export type GraphJsonPrimitive = string | number | boolean | null;
-export type GraphJsonValue = GraphJsonPrimitive | GraphJsonValue[] | {
-    [key: string]: GraphJsonValue;
-};
-export declare const GRAPH_UNSAFE_OBJECT_KEYS: readonly ["__proto__", "prototype", "constructor"];
-export type GraphUnsafeObjectKey = (typeof GRAPH_UNSAFE_OBJECT_KEYS)[number];
-export declare function isGraphUnsafeObjectKey(key: string): key is GraphUnsafeObjectKey;
-export declare function isGraphJsonPrimitive(value: unknown): value is GraphJsonPrimitive;
-export declare function isGraphJsonValue(value: unknown): value is GraphJsonValue;
-export declare function isGraphJsonSafeValue(value: unknown): boolean;
-export declare function cloneGraphJsonValue<T extends GraphJsonValue>(value: T): T;

package/lib/types/graph/document/GraphLoopConfiguration.d.cts

@@ -1,24 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-import type { GraphWorkflowDocument } from "./GraphWorkflowDocument.d.cts";
-export type GraphValueReference = {
-    source: "workflow";
-    port: string;
-} | {
-    source: "node";
-    nodeId: string;
-    port: string;
-} | {
-    source: "literal";
-    value: GraphJsonValue;
-} | {
-    source: "expression";
-    expression: string;
-};
-export interface GraphLoopConfiguration {
-    body: GraphWorkflowDocument;
-    maxIterations?: number;
-    timeoutMs?: number;
-    concurrency?: number;
-    inputMappings?: Record<string, GraphValueReference>;
-    outputMappings?: Record<string, GraphValueReference>;
-}

package/lib/types/graph/document/GraphLoopConfiguration.d.mts

@@ -1,24 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-import type { GraphWorkflowDocument } from "./GraphWorkflowDocument.d.mts";
-export type GraphValueReference = {
-    source: "workflow";
-    port: string;
-} | {
-    source: "node";
-    nodeId: string;
-    port: string;
-} | {
-    source: "literal";
-    value: GraphJsonValue;
-} | {
-    source: "expression";
-    expression: string;
-};
-export interface GraphLoopConfiguration {
-    body: GraphWorkflowDocument;
-    maxIterations?: number;
-    timeoutMs?: number;
-    concurrency?: number;
-    inputMappings?: Record<string, GraphValueReference>;
-    outputMappings?: Record<string, GraphValueReference>;
-}

package/lib/types/graph/document/GraphNodeBinding.d.cts

@@ -1,21 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-export type GraphInputBindingMode = "edge" | "literal" | "expression";
-export type GraphEdgeInputBinding = {
-    mode: "edge";
-};
-export type GraphLiteralInputBinding = {
-    mode: "literal";
-    value: GraphJsonValue;
-};
-export type GraphExpressionInputBinding = {
-    mode: "expression";
-    expression: string;
-};
-export type GraphInputBinding = GraphEdgeInputBinding | GraphLiteralInputBinding | GraphExpressionInputBinding;
-export type GraphOutputBinding = {
-    enabled?: boolean;
-    alias?: string;
-    metadata?: Record<string, GraphJsonValue>;
-};
-export declare function isGraphInputBindingMode(value: unknown): value is GraphInputBindingMode;
-export declare function isGraphInputBinding(value: unknown): value is GraphInputBinding;

package/lib/types/graph/document/GraphNodeBinding.d.mts

@@ -1,21 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-export type GraphInputBindingMode = "edge" | "literal" | "expression";
-export type GraphEdgeInputBinding = {
-    mode: "edge";
-};
-export type GraphLiteralInputBinding = {
-    mode: "literal";
-    value: GraphJsonValue;
-};
-export type GraphExpressionInputBinding = {
-    mode: "expression";
-    expression: string;
-};
-export type GraphInputBinding = GraphEdgeInputBinding | GraphLiteralInputBinding | GraphExpressionInputBinding;
-export type GraphOutputBinding = {
-    enabled?: boolean;
-    alias?: string;
-    metadata?: Record<string, GraphJsonValue>;
-};
-export declare function isGraphInputBindingMode(value: unknown): value is GraphInputBindingMode;
-export declare function isGraphInputBinding(value: unknown): value is GraphInputBinding;

package/lib/types/graph/document/GraphNodeInstance.d.cts

@@ -1,36 +0,0 @@
-import type { GraphInputBinding, GraphOutputBinding } from "./GraphNodeBinding.d.cts";
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-import type { GraphLoopConfiguration } from "./GraphLoopConfiguration.d.cts";
-import type { GraphNodeUiState } from "./GraphWorkflowUiState.d.cts";
-/**
- * Document-carried UI data-pinning state (D4, DECAF-50 §4.22). Data pinning
- * freezes the node's parameter values so downstream runs reuse them, and is a
- * distinct concept from the engine's cache pinning (`GraphPinning`): this state is
- * written into the canonical document and survives save/load round-trips.
- */
-export interface GraphNodePinState {
-    /**
-     * Parameter values frozen when the node was pinned. Downstream runs apply this
-     * snapshot on top of the node's live parameters.
-     */
-    parameters: Record<string, GraphJsonValue>;
-    /** ISO-8601 timestamp of when the pin was captured, when known. */
-    pinnedAt?: string;
-}
-export interface GraphNodeInstance {
-    id: string;
-    kind: string;
-    label?: string;
-    parameters: Record<string, GraphJsonValue>;
-    inputBindings?: Record<string, GraphInputBinding>;
-    outputBindings?: Record<string, GraphOutputBinding>;
-    disabled?: boolean;
-    metadata?: Record<string, GraphJsonValue>;
-    loop?: GraphLoopConfiguration;
-    ui?: GraphNodeUiState;
-    /**
-     * UI data-pinning state (D4, DECAF-50 §4.22). Present iff the node is
-     * pinned; the frozen parameter snapshot is what downstream runs reuse.
-     */
-    pinned?: GraphNodePinState;
-}

package/lib/types/graph/document/GraphNodeInstance.d.mts

@@ -1,36 +0,0 @@
-import type { GraphInputBinding, GraphOutputBinding } from "./GraphNodeBinding.d.mts";
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-import type { GraphLoopConfiguration } from "./GraphLoopConfiguration.d.mts";
-import type { GraphNodeUiState } from "./GraphWorkflowUiState.d.mts";
-/**
- * Document-carried UI data-pinning state (D4, DECAF-50 §4.22). Data pinning
- * freezes the node's parameter values so downstream runs reuse them, and is a
- * distinct concept from the engine's cache pinning (`GraphPinning`): this state is
- * written into the canonical document and survives save/load round-trips.
- */
-export interface GraphNodePinState {
-    /**
-     * Parameter values frozen when the node was pinned. Downstream runs apply this
-     * snapshot on top of the node's live parameters.
-     */
-    parameters: Record<string, GraphJsonValue>;
-    /** ISO-8601 timestamp of when the pin was captured, when known. */
-    pinnedAt?: string;
-}
-export interface GraphNodeInstance {
-    id: string;
-    kind: string;
-    label?: string;
-    parameters: Record<string, GraphJsonValue>;
-    inputBindings?: Record<string, GraphInputBinding>;
-    outputBindings?: Record<string, GraphOutputBinding>;
-    disabled?: boolean;
-    metadata?: Record<string, GraphJsonValue>;
-    loop?: GraphLoopConfiguration;
-    ui?: GraphNodeUiState;
-    /**
-     * UI data-pinning state (D4, DECAF-50 §4.22). Present iff the node is
-     * pinned; the frozen parameter snapshot is what downstream runs reuse.
-     */
-    pinned?: GraphNodePinState;
-}

package/lib/types/graph/document/GraphWorkflowDocument.d.cts

@@ -1,33 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-import type { GraphNodeInstance } from "./GraphNodeInstance.d.cts";
-import type { GraphEdgeInstance } from "./GraphEdgeInstance.d.cts";
-import type { GraphWorkflowUiState } from "./GraphWorkflowUiState.d.cts";
-import type { GraphValueSchema } from "../catalog/GraphValueSchema.d.cts";
-export interface GraphWorkflowPortInstance {
-    id: string;
-    label?: string;
-    schema?: GraphValueSchema;
-    required?: boolean;
-    defaultValue?: GraphJsonValue;
-    metadata?: Record<string, GraphJsonValue>;
-}
-export type GraphWorkflowSettings = Record<string, GraphJsonValue>;
-export interface GraphWorkflowDocument {
-    id: string;
-    name: string;
-    inputs: GraphWorkflowPortInstance[];
-    outputs: GraphWorkflowPortInstance[];
-    nodes: GraphNodeInstance[];
-    edges: GraphEdgeInstance[];
-    settings?: GraphWorkflowSettings;
-    metadata?: Record<string, GraphJsonValue>;
-    ui?: GraphWorkflowUiState;
-}
-export declare function isGraphWorkflowDocumentShape(value: unknown): value is {
-    id: string;
-    name: string;
-    inputs: unknown[];
-    outputs: unknown[];
-    nodes: unknown[];
-    edges: unknown[];
-};

package/lib/types/graph/document/GraphWorkflowDocument.d.mts

@@ -1,33 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-import type { GraphNodeInstance } from "./GraphNodeInstance.d.mts";
-import type { GraphEdgeInstance } from "./GraphEdgeInstance.d.mts";
-import type { GraphWorkflowUiState } from "./GraphWorkflowUiState.d.mts";
-import type { GraphValueSchema } from "../catalog/GraphValueSchema.d.mts";
-export interface GraphWorkflowPortInstance {
-    id: string;
-    label?: string;
-    schema?: GraphValueSchema;
-    required?: boolean;
-    defaultValue?: GraphJsonValue;
-    metadata?: Record<string, GraphJsonValue>;
-}
-export type GraphWorkflowSettings = Record<string, GraphJsonValue>;
-export interface GraphWorkflowDocument {
-    id: string;
-    name: string;
-    inputs: GraphWorkflowPortInstance[];
-    outputs: GraphWorkflowPortInstance[];
-    nodes: GraphNodeInstance[];
-    edges: GraphEdgeInstance[];
-    settings?: GraphWorkflowSettings;
-    metadata?: Record<string, GraphJsonValue>;
-    ui?: GraphWorkflowUiState;
-}
-export declare function isGraphWorkflowDocumentShape(value: unknown): value is {
-    id: string;
-    name: string;
-    inputs: unknown[];
-    outputs: unknown[];
-    nodes: unknown[];
-    edges: unknown[];
-};

package/lib/types/graph/document/GraphWorkflowDocumentBuilder.d.cts

@@ -1,72 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-import type { GraphNodeEndpoint, GraphWorkflowEndpoint } from "./GraphEndpoint.d.cts";
-import type { GraphWorkflowUiState } from "./GraphWorkflowUiState.d.cts";
-import type { GraphEdgeInstance } from "./GraphEdgeInstance.d.cts";
-import type { GraphNodeInstance } from "./GraphNodeInstance.d.cts";
-import type { GraphWorkflowDocument, GraphWorkflowPortInstance, GraphWorkflowSettings } from "./GraphWorkflowDocument.d.cts";
-/** A workflow boundary port accepted by {@link GraphWorkflowDocumentBuilder}. */
-export type GraphWorkflowPortInput = GraphWorkflowPortInstance;
-/** Options for constructing a {@link GraphWorkflowDocumentBuilder}. */
-export interface GraphWorkflowDocumentBuilderOptions {
-    /** Document id; defaults to an empty string when omitted. */
-    id?: string;
-    /** Human-readable document name; defaults to an empty string when omitted. */
-    name?: string;
-}
-/**
- * Fluent builder for the canonical {@link GraphWorkflowDocument}
- * (DECAF-50 §4.4.4). Collects boundary ports, node instances, edges, and
- * optional settings/metadata/UI state, then validates and freezes a
- * defensively-copied document on {@link GraphWorkflowDocumentBuilder.build}.
- */
-export declare class GraphWorkflowDocumentBuilder {
-    private readonly document;
-    /**
-     * @param id Document id.
-     * @param name Optional document name; defaults to an empty string.
-     */
-    constructor(id: string, name?: string);
-    /** Appends a workflow input port. */
-    addInput(port: GraphWorkflowPortInput): this;
-    /** Appends a workflow output port. */
-    addOutput(port: GraphWorkflowPortInput): this;
-    /** Appends a node instance, defaulting `parameters` to an empty object. */
-    addNode(node: GraphNodeInstance): this;
-    /** Appends an edge instance. */
-    addEdge(edge: GraphEdgeInstance): this;
-    /** Sets (or clears) the document's free-form settings bag. */
-    setSettings(settings?: GraphWorkflowSettings): this;
-    /** Sets (or clears) the document's metadata bag. */
-    setMetadata(metadata?: Record<string, GraphJsonValue>): this;
-    /** Sets (or clears) the document's editor UI state. */
-    setUi(ui?: GraphWorkflowUiState): this;
-    /**
-     * Validates the accumulated document with
-     * {@link assertGraphWorkflowDocumentValid} and returns a deep-ish copy:
-     * ports, nodes, and edges are cloned per entry, and the optional
-     * `settings`/`metadata`/`ui` bags are only present when explicitly set, so
-     * callers never observe builder-internal `undefined` fields.
-     *
-     * @throws ValidationError when the document fails validation.
-     */
-    build(): GraphWorkflowDocument;
-}
-/**
- * Shared validation context for
- * {@link assertGraphWorkflowDocumentValid}: tracks documents already visited
- * on the current nesting path so cyclic loop bodies are detected.
- */
-export interface GraphWorkflowDocumentValidationContext {
-    seen: unknown[];
-}
-/**
- * Structural validation gate for a canonical {@link GraphWorkflowDocument}
- * (shared by the frontend builder and the backend nine-stage validator,
- * DECAF-50 §4.8 stage 1 shape rules). Checks unique port/node/edge ids,
- * valid schemas, binding shapes, edge endpoints, and recursively validates
- * nested loop-body documents.
- *
- * @throws ValidationError describing the first invalid aspect found.
- */
-export declare function assertGraphWorkflowDocumentValid(document: GraphWorkflowDocument, context?: GraphWorkflowDocumentValidationContext): void;
-export type { GraphWorkflowEndpoint, GraphNodeEndpoint };

package/lib/types/graph/document/GraphWorkflowDocumentBuilder.d.mts

@@ -1,72 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-import type { GraphNodeEndpoint, GraphWorkflowEndpoint } from "./GraphEndpoint.d.mts";
-import type { GraphWorkflowUiState } from "./GraphWorkflowUiState.d.mts";
-import type { GraphEdgeInstance } from "./GraphEdgeInstance.d.mts";
-import type { GraphNodeInstance } from "./GraphNodeInstance.d.mts";
-import type { GraphWorkflowDocument, GraphWorkflowPortInstance, GraphWorkflowSettings } from "./GraphWorkflowDocument.d.mts";
-/** A workflow boundary port accepted by {@link GraphWorkflowDocumentBuilder}. */
-export type GraphWorkflowPortInput = GraphWorkflowPortInstance;
-/** Options for constructing a {@link GraphWorkflowDocumentBuilder}. */
-export interface GraphWorkflowDocumentBuilderOptions {
-    /** Document id; defaults to an empty string when omitted. */
-    id?: string;
-    /** Human-readable document name; defaults to an empty string when omitted. */
-    name?: string;
-}
-/**
- * Fluent builder for the canonical {@link GraphWorkflowDocument}
- * (DECAF-50 §4.4.4). Collects boundary ports, node instances, edges, and
- * optional settings/metadata/UI state, then validates and freezes a
- * defensively-copied document on {@link GraphWorkflowDocumentBuilder.build}.
- */
-export declare class GraphWorkflowDocumentBuilder {
-    private readonly document;
-    /**
-     * @param id Document id.
-     * @param name Optional document name; defaults to an empty string.
-     */
-    constructor(id: string, name?: string);
-    /** Appends a workflow input port. */
-    addInput(port: GraphWorkflowPortInput): this;
-    /** Appends a workflow output port. */
-    addOutput(port: GraphWorkflowPortInput): this;
-    /** Appends a node instance, defaulting `parameters` to an empty object. */
-    addNode(node: GraphNodeInstance): this;
-    /** Appends an edge instance. */
-    addEdge(edge: GraphEdgeInstance): this;
-    /** Sets (or clears) the document's free-form settings bag. */
-    setSettings(settings?: GraphWorkflowSettings): this;
-    /** Sets (or clears) the document's metadata bag. */
-    setMetadata(metadata?: Record<string, GraphJsonValue>): this;
-    /** Sets (or clears) the document's editor UI state. */
-    setUi(ui?: GraphWorkflowUiState): this;
-    /**
-     * Validates the accumulated document with
-     * {@link assertGraphWorkflowDocumentValid} and returns a deep-ish copy:
-     * ports, nodes, and edges are cloned per entry, and the optional
-     * `settings`/`metadata`/`ui` bags are only present when explicitly set, so
-     * callers never observe builder-internal `undefined` fields.
-     *
-     * @throws ValidationError when the document fails validation.
-     */
-    build(): GraphWorkflowDocument;
-}
-/**
- * Shared validation context for
- * {@link assertGraphWorkflowDocumentValid}: tracks documents already visited
- * on the current nesting path so cyclic loop bodies are detected.
- */
-export interface GraphWorkflowDocumentValidationContext {
-    seen: unknown[];
-}
-/**
- * Structural validation gate for a canonical {@link GraphWorkflowDocument}
- * (shared by the frontend builder and the backend nine-stage validator,
- * DECAF-50 §4.8 stage 1 shape rules). Checks unique port/node/edge ids,
- * valid schemas, binding shapes, edge endpoints, and recursively validates
- * nested loop-body documents.
- *
- * @throws ValidationError describing the first invalid aspect found.
- */
-export declare function assertGraphWorkflowDocumentValid(document: GraphWorkflowDocument, context?: GraphWorkflowDocumentValidationContext): void;
-export type { GraphWorkflowEndpoint, GraphNodeEndpoint };

package/lib/types/graph/document/GraphWorkflowDocumentReader.d.cts

@@ -1,21 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
-import type { GraphWorkflowDocument, GraphWorkflowPortInstance } from "./GraphWorkflowDocument.d.cts";
-import type { GraphNodeInstance } from "./GraphNodeInstance.d.cts";
-import type { GraphEdgeInstance } from "./GraphEdgeInstance.d.cts";
-import type { GraphNodeUiState, GraphWorkflowUiState } from "./GraphWorkflowUiState.d.cts";
-export declare function graphWorkflowDocumentOf(value: unknown): GraphWorkflowDocument | undefined;
-export declare function graphWorkflowNodeOf(document: GraphWorkflowDocument | undefined, nodeId: string): GraphNodeInstance | undefined;
-export declare function graphWorkflowEdgeOf(document: GraphWorkflowDocument | undefined, edgeId: string): GraphEdgeInstance | undefined;
-export declare function graphWorkflowPortsOf(document: GraphWorkflowDocument | undefined): {
-    inputs: GraphWorkflowPortInstance[];
-    outputs: GraphWorkflowPortInstance[];
-};
-export declare function graphWorkflowSettingsOf(document: GraphWorkflowDocument | undefined): Record<string, GraphJsonValue>;
-export declare function graphWorkflowEdgesOf(document: GraphWorkflowDocument | undefined): GraphEdgeInstance[];
-export declare function graphWorkflowNodeEdgesOf(document: GraphWorkflowDocument | undefined, nodeId: string): GraphEdgeInstance[];
-export declare function graphNodeEndpointId(endpoint: GraphEdgeInstance["source"]): string | undefined;
-export declare function graphWorkflowNodeUiOf(document: GraphWorkflowDocument, nodeId: string): GraphNodeUiState | undefined;
-export declare function graphWorkflowUiOf(document: GraphWorkflowDocument): GraphWorkflowUiState | undefined;
-export declare function graphWorkflowUiValueOf(document: GraphWorkflowDocument, key: string): GraphJsonValue | undefined;
-export declare function graphWorkflowDocumentSettingOf(document: GraphWorkflowDocument | undefined, key: string): GraphJsonValue | undefined;
-export declare function graphWorkflowDocumentMetadataValueOf(document: GraphWorkflowDocument | undefined, key: string): GraphJsonValue | undefined;

package/lib/types/graph/document/GraphWorkflowDocumentReader.d.mts

@@ -1,21 +0,0 @@
-import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
-import type { GraphWorkflowDocument, GraphWorkflowPortInstance } from "./GraphWorkflowDocument.d.mts";
-import type { GraphNodeInstance } from "./GraphNodeInstance.d.mts";
-import type { GraphEdgeInstance } from "./GraphEdgeInstance.d.mts";
-import type { GraphNodeUiState, GraphWorkflowUiState } from "./GraphWorkflowUiState.d.mts";
-export declare function graphWorkflowDocumentOf(value: unknown): GraphWorkflowDocument | undefined;
-export declare function graphWorkflowNodeOf(document: GraphWorkflowDocument | undefined, nodeId: string): GraphNodeInstance | undefined;
-export declare function graphWorkflowEdgeOf(document: GraphWorkflowDocument | undefined, edgeId: string): GraphEdgeInstance | undefined;
-export declare function graphWorkflowPortsOf(document: GraphWorkflowDocument | undefined): {
-    inputs: GraphWorkflowPortInstance[];
-    outputs: GraphWorkflowPortInstance[];
-};
-export declare function graphWorkflowSettingsOf(document: GraphWorkflowDocument | undefined): Record<string, GraphJsonValue>;
-export declare function graphWorkflowEdgesOf(document: GraphWorkflowDocument | undefined): GraphEdgeInstance[];
-export declare function graphWorkflowNodeEdgesOf(document: GraphWorkflowDocument | undefined, nodeId: string): GraphEdgeInstance[];
-export declare function graphNodeEndpointId(endpoint: GraphEdgeInstance["source"]): string | undefined;
-export declare function graphWorkflowNodeUiOf(document: GraphWorkflowDocument, nodeId: string): GraphNodeUiState | undefined;
-export declare function graphWorkflowUiOf(document: GraphWorkflowDocument): GraphWorkflowUiState | undefined;
-export declare function graphWorkflowUiValueOf(document: GraphWorkflowDocument, key: string): GraphJsonValue | undefined;
-export declare function graphWorkflowDocumentSettingOf(document: GraphWorkflowDocument | undefined, key: string): GraphJsonValue | undefined;
-export declare function graphWorkflowDocumentMetadataValueOf(document: GraphWorkflowDocument | undefined, key: string): GraphJsonValue | undefined;

package/lib/types/graph/document/GraphWorkflowDocumentSerializer.d.cts

@@ -1,5 +0,0 @@
-import type { GraphWorkflowDocument } from "./GraphWorkflowDocument.d.cts";
-export declare function graphWorkflowDocumentSerializer(document: GraphWorkflowDocument): string;
-export declare function graphWorkflowDocumentDeserializer(serialised: string): GraphWorkflowDocument;
-export declare function graphJsonSerializer(value: unknown, indentation?: number): string;
-export declare function graphJsonParser(serialised: string | unknown): unknown;

package/lib/types/graph/document/GraphWorkflowDocumentSerializer.d.mts

@@ -1,5 +0,0 @@
-import type { GraphWorkflowDocument } from "./GraphWorkflowDocument.d.mts";
-export declare function graphWorkflowDocumentSerializer(document: GraphWorkflowDocument): string;
-export declare function graphWorkflowDocumentDeserializer(serialised: string): GraphWorkflowDocument;
-export declare function graphJsonSerializer(value: unknown, indentation?: number): string;
-export declare function graphJsonParser(serialised: string | unknown): unknown;