@decaf-ts/ui-decorators 0.19.0 → 0.20.0

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

@@ -4,6 +4,14 @@ export declare enum GraphKeys {
     EDGE = "graph.edge",
     PORT = "graph.port"
 }
+/**
+ * Rollout gate for the canonical document pipeline (DECAF-50/P1). Defaults to
+ * off so existing legacy snapshot/definition flows keep working until the
+ * save/history cutover. Overridable at runtime via the browser-safe global
+ * `__DECAF_GRAPH_CANONICAL_DOCUMENT__` flag (no Node/`process` dependency).
+ */
+export declare const GRAPH_CANONICAL_DOCUMENT_ENABLED_DEFAULT = false;
+export declare function graphCanonicalDocumentEnabled(): boolean;
 export declare enum PortDirection {
     INPUT = "input",
     OUTPUT = "output",

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

@@ -4,6 +4,14 @@ export declare enum GraphKeys {
     EDGE = "graph.edge",
     PORT = "graph.port"
 }
+/**
+ * Rollout gate for the canonical document pipeline (DECAF-50/P1). Defaults to
+ * off so existing legacy snapshot/definition flows keep working until the
+ * save/history cutover. Overridable at runtime via the browser-safe global
+ * `__DECAF_GRAPH_CANONICAL_DOCUMENT__` flag (no Node/`process` dependency).
+ */
+export declare const GRAPH_CANONICAL_DOCUMENT_ENABLED_DEFAULT = false;
+export declare function graphCanonicalDocumentEnabled(): boolean;
 export declare enum PortDirection {
     INPUT = "input",
     OUTPUT = "output",

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

@@ -0,0 +1,26 @@
+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";
+export interface GraphDecoratedWorkflowCompileOptions {
+    id?: string;
+    name?: string;
+    positions?: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    viewport?: GraphWorkflowViewport;
+}
+export type GraphDecoratedWorkflowInput = Constructor | Model | GraphWorkflowDefinition;
+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

@@ -0,0 +1,26 @@
+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";
+export interface GraphDecoratedWorkflowCompileOptions {
+    id?: string;
+    name?: string;
+    positions?: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    viewport?: GraphWorkflowViewport;
+}
+export type GraphDecoratedWorkflowInput = Constructor | Model | GraphWorkflowDefinition;
+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

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,16 @@
+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";
+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;
+}

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

@@ -0,0 +1,16 @@
+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";
+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;
+}

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

@@ -0,0 +1,33 @@
+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

@@ -0,0 +1,33 @@
+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

@@ -0,0 +1,28 @@
+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";
+export type GraphWorkflowPortInput = GraphWorkflowPortInstance;
+export interface GraphWorkflowDocumentBuilderOptions {
+    id?: string;
+    name?: string;
+}
+export declare class GraphWorkflowDocumentBuilder {
+    private readonly document;
+    constructor(id: string, name?: string);
+    addInput(port: GraphWorkflowPortInput): this;
+    addOutput(port: GraphWorkflowPortInput): this;
+    addNode(node: GraphNodeInstance): this;
+    addEdge(edge: GraphEdgeInstance): this;
+    setSettings(settings?: GraphWorkflowSettings): this;
+    setMetadata(metadata?: Record<string, GraphJsonValue>): this;
+    setUi(ui?: GraphWorkflowUiState): this;
+    build(): GraphWorkflowDocument;
+}
+export interface GraphWorkflowDocumentValidationContext {
+    seen: unknown[];
+}
+export declare function assertGraphWorkflowDocumentValid(document: GraphWorkflowDocument, context?: GraphWorkflowDocumentValidationContext): void;
+export type { GraphWorkflowEndpoint, GraphNodeEndpoint };

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

@@ -0,0 +1,28 @@
+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";
+export type GraphWorkflowPortInput = GraphWorkflowPortInstance;
+export interface GraphWorkflowDocumentBuilderOptions {
+    id?: string;
+    name?: string;
+}
+export declare class GraphWorkflowDocumentBuilder {
+    private readonly document;
+    constructor(id: string, name?: string);
+    addInput(port: GraphWorkflowPortInput): this;
+    addOutput(port: GraphWorkflowPortInput): this;
+    addNode(node: GraphNodeInstance): this;
+    addEdge(edge: GraphEdgeInstance): this;
+    setSettings(settings?: GraphWorkflowSettings): this;
+    setMetadata(metadata?: Record<string, GraphJsonValue>): this;
+    setUi(ui?: GraphWorkflowUiState): this;
+    build(): GraphWorkflowDocument;
+}
+export interface GraphWorkflowDocumentValidationContext {
+    seen: unknown[];
+}
+export declare function assertGraphWorkflowDocumentValid(document: GraphWorkflowDocument, context?: GraphWorkflowDocumentValidationContext): void;
+export type { GraphWorkflowEndpoint, GraphNodeEndpoint };

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

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,5 @@
+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;

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

@@ -0,0 +1,29 @@
+import type { GraphJsonValue } from "./GraphJsonValue.d.cts";
+export type GraphWorkflowViewport = {
+    x: number;
+    y: number;
+    zoom: number;
+};
+export type GraphNodeUiState = {
+    position: {
+        x: number;
+        y: number;
+    };
+    size?: {
+        width?: number;
+        height?: number;
+    };
+    expanded?: boolean;
+    selectedTab?: string;
+};
+export type GraphEdgeUiState = {
+    points?: Array<{
+        x: number;
+        y: number;
+    }>;
+};
+export type GraphWorkflowUiState = {
+    viewport?: GraphWorkflowViewport;
+} & {
+    [key: string]: GraphJsonValue | undefined;
+};

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

@@ -0,0 +1,29 @@
+import type { GraphJsonValue } from "./GraphJsonValue.d.mts";
+export type GraphWorkflowViewport = {
+    x: number;
+    y: number;
+    zoom: number;
+};
+export type GraphNodeUiState = {
+    position: {
+        x: number;
+        y: number;
+    };
+    size?: {
+        width?: number;
+        height?: number;
+    };
+    expanded?: boolean;
+    selectedTab?: string;
+};
+export type GraphEdgeUiState = {
+    points?: Array<{
+        x: number;
+        y: number;
+    }>;
+};
+export type GraphWorkflowUiState = {
+    viewport?: GraphWorkflowViewport;
+} & {
+    [key: string]: GraphJsonValue | undefined;
+};

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

@@ -0,0 +1,12 @@
+export * from "./GraphDecoratedWorkflowCompiler.d.cts";
+export * from "./GraphEdgeInstance.d.cts";
+export * from "./GraphEndpoint.d.cts";
+export * from "./GraphJsonValue.d.cts";
+export * from "./GraphLoopConfiguration.d.cts";
+export * from "./GraphNodeBinding.d.cts";
+export * from "./GraphNodeInstance.d.cts";
+export * from "./GraphWorkflowDocument.d.cts";
+export * from "./GraphWorkflowDocumentBuilder.d.cts";
+export * from "./GraphWorkflowDocumentReader.d.cts";
+export * from "./GraphWorkflowDocumentSerializer.d.cts";
+export * from "./GraphWorkflowUiState.d.cts";

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

@@ -0,0 +1,12 @@
+export * from "./GraphDecoratedWorkflowCompiler.d.mts";
+export * from "./GraphEdgeInstance.d.mts";
+export * from "./GraphEndpoint.d.mts";
+export * from "./GraphJsonValue.d.mts";
+export * from "./GraphLoopConfiguration.d.mts";
+export * from "./GraphNodeBinding.d.mts";
+export * from "./GraphNodeInstance.d.mts";
+export * from "./GraphWorkflowDocument.d.mts";
+export * from "./GraphWorkflowDocumentBuilder.d.mts";
+export * from "./GraphWorkflowDocumentReader.d.mts";
+export * from "./GraphWorkflowDocumentSerializer.d.mts";
+export * from "./GraphWorkflowUiState.d.mts";

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

@@ -6,5 +6,7 @@ export * from "./registry.d.cts";
 export * from "./overrides/index.d.cts";
 export * from "./snapshot.d.cts";
 export * from "./reader.d.cts";
+export * from "./document/index.d.cts";
+export * from "./catalog/index.d.cts";
 export * from "./types.d.cts";
 export * from "./overrides/index.d.cts";

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

@@ -6,5 +6,7 @@ export * from "./registry.d.mts";
 export * from "./overrides/index.d.mts";
 export * from "./snapshot.d.mts";
 export * from "./reader.d.mts";
+export * from "./document/index.d.mts";
+export * from "./catalog/index.d.mts";
 export * from "./types.d.mts";
 export * from "./overrides/index.d.mts";