@consciousclouds/canvas-sdk 0.2.0

package/dist/validate/canvas.d.ts

@@ -0,0 +1,1091 @@
+/**
+ * Runtime validation of a CanvasDefinition (zod mirror of the JSON Schema).
+ *
+ * The JSON Schema under platform/contracts/canvas/v1/ is authoritative; this
+ * zod schema mirrors it for ergonomic in-process validation. The conformance
+ * test asserts the discriminants here match the contract and the registry.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+import type { CanvasDefinition, CanvasNodeType } from '../types/canvas.js';
+/** The node `type` discriminants, in registry order. */
+export declare const NODE_TYPES: readonly ["stat-card", "data-table", "service-health", "text-block"];
+export declare const canvasNodeSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    props: z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        unit: z.ZodOptional<z.ZodString>;
+        trend: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        label: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        unit: z.ZodOptional<z.ZodString>;
+        trend: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        label: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        unit: z.ZodOptional<z.ZodString>;
+        trend: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    id: z.ZodString;
+    requiredPermission: z.ZodOptional<z.ZodString>;
+    nodeVersion: z.ZodOptional<z.ZodNumber>;
+    bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prop: z.ZodString;
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        prop: string;
+        source: string;
+    }, {
+        prop: string;
+        source: string;
+    }>, "many">>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        target: z.ZodString;
+        method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }>, "many">>;
+    type: z.ZodLiteral<"stat-card">;
+}, "strict", z.ZodTypeAny, {
+    type: "stat-card";
+    id: string;
+    props: {
+        label: string;
+        value: string | number;
+        unit?: string | undefined;
+        trend?: "up" | "down" | "flat" | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}, {
+    type: "stat-card";
+    id: string;
+    props: {
+        label: string;
+        value: string | number;
+        unit?: string | undefined;
+        trend?: "up" | "down" | "flat" | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    props: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        columns: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+        rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        title: z.ZodOptional<z.ZodString>;
+        columns: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+        rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        title: z.ZodOptional<z.ZodString>;
+        columns: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+        rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, z.ZodTypeAny, "passthrough">>;
+    id: z.ZodString;
+    requiredPermission: z.ZodOptional<z.ZodString>;
+    nodeVersion: z.ZodOptional<z.ZodNumber>;
+    bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prop: z.ZodString;
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        prop: string;
+        source: string;
+    }, {
+        prop: string;
+        source: string;
+    }>, "many">>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        target: z.ZodString;
+        method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }>, "many">>;
+    type: z.ZodLiteral<"data-table">;
+}, "strict", z.ZodTypeAny, {
+    type: "data-table";
+    id: string;
+    props: {
+        columns: {
+            label: string;
+            key: string;
+        }[];
+        rows: Record<string, unknown>[];
+        title?: string | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}, {
+    type: "data-table";
+    id: string;
+    props: {
+        columns: {
+            label: string;
+            key: string;
+        }[];
+        rows: Record<string, unknown>[];
+        title?: string | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    props: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        services: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        title: z.ZodOptional<z.ZodString>;
+        services: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        title: z.ZodOptional<z.ZodString>;
+        services: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">>;
+    id: z.ZodString;
+    requiredPermission: z.ZodOptional<z.ZodString>;
+    nodeVersion: z.ZodOptional<z.ZodNumber>;
+    bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prop: z.ZodString;
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        prop: string;
+        source: string;
+    }, {
+        prop: string;
+        source: string;
+    }>, "many">>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        target: z.ZodString;
+        method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }>, "many">>;
+    type: z.ZodLiteral<"service-health">;
+}, "strict", z.ZodTypeAny, {
+    type: "service-health";
+    id: string;
+    props: {
+        services: z.objectOutputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">[];
+        title?: string | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}, {
+    type: "service-health";
+    id: string;
+    props: {
+        services: z.objectInputType<{
+            name: z.ZodString;
+            state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+            health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+        }, z.ZodTypeAny, "passthrough">[];
+        title?: string | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    props: z.ZodObject<{
+        variant: z.ZodEnum<["heading", "subheading", "body"]>;
+        text: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        variant: z.ZodEnum<["heading", "subheading", "body"]>;
+        text: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        variant: z.ZodEnum<["heading", "subheading", "body"]>;
+        text: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    id: z.ZodString;
+    requiredPermission: z.ZodOptional<z.ZodString>;
+    nodeVersion: z.ZodOptional<z.ZodNumber>;
+    bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prop: z.ZodString;
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        prop: string;
+        source: string;
+    }, {
+        prop: string;
+        source: string;
+    }>, "many">>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        target: z.ZodString;
+        method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }, {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }>, "many">>;
+    type: z.ZodLiteral<"text-block">;
+}, "strict", z.ZodTypeAny, {
+    type: "text-block";
+    id: string;
+    props: {
+        variant: "heading" | "subheading" | "body";
+        text: string;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}, {
+    type: "text-block";
+    id: string;
+    props: {
+        variant: "heading" | "subheading" | "body";
+        text: string;
+    } & {
+        [k: string]: unknown;
+    };
+    requiredPermission?: string | undefined;
+    nodeVersion?: number | undefined;
+    bindings?: {
+        prop: string;
+        source: string;
+    }[] | undefined;
+    actions?: {
+        label: string;
+        id: string;
+        target: string;
+        method?: "GET" | "POST" | undefined;
+    }[] | undefined;
+}>]>;
+export declare const canvasDefinitionSchema: z.ZodObject<{
+    version: z.ZodLiteral<"v1">;
+    correlationId: z.ZodString;
+    layout: z.ZodObject<{
+        type: z.ZodEnum<["stack", "grid"]>;
+        columns: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        type: "stack" | "grid";
+        columns?: number | undefined;
+    }, {
+        type: "stack" | "grid";
+        columns?: number | undefined;
+    }>;
+    nodes: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        props: z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            unit: z.ZodOptional<z.ZodString>;
+            trend: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            label: z.ZodString;
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            unit: z.ZodOptional<z.ZodString>;
+            trend: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            label: z.ZodString;
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            unit: z.ZodOptional<z.ZodString>;
+            trend: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
+        }, z.ZodTypeAny, "passthrough">>;
+        id: z.ZodString;
+        requiredPermission: z.ZodOptional<z.ZodString>;
+        nodeVersion: z.ZodOptional<z.ZodNumber>;
+        bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            prop: z.ZodString;
+            source: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            prop: string;
+            source: string;
+        }, {
+            prop: string;
+            source: string;
+        }>, "many">>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            target: z.ZodString;
+            method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }>, "many">>;
+        type: z.ZodLiteral<"stat-card">;
+    }, "strict", z.ZodTypeAny, {
+        type: "stat-card";
+        id: string;
+        props: {
+            label: string;
+            value: string | number;
+            unit?: string | undefined;
+            trend?: "up" | "down" | "flat" | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }, {
+        type: "stat-card";
+        id: string;
+        props: {
+            label: string;
+            value: string | number;
+            unit?: string | undefined;
+            trend?: "up" | "down" | "flat" | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }>, z.ZodObject<{
+        props: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            columns: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                label: string;
+                key: string;
+            }, {
+                label: string;
+                key: string;
+            }>, "many">;
+            rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            title: z.ZodOptional<z.ZodString>;
+            columns: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                label: string;
+                key: string;
+            }, {
+                label: string;
+                key: string;
+            }>, "many">;
+            rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            title: z.ZodOptional<z.ZodString>;
+            columns: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                label: string;
+                key: string;
+            }, {
+                label: string;
+                key: string;
+            }>, "many">;
+            rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        }, z.ZodTypeAny, "passthrough">>;
+        id: z.ZodString;
+        requiredPermission: z.ZodOptional<z.ZodString>;
+        nodeVersion: z.ZodOptional<z.ZodNumber>;
+        bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            prop: z.ZodString;
+            source: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            prop: string;
+            source: string;
+        }, {
+            prop: string;
+            source: string;
+        }>, "many">>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            target: z.ZodString;
+            method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }>, "many">>;
+        type: z.ZodLiteral<"data-table">;
+    }, "strict", z.ZodTypeAny, {
+        type: "data-table";
+        id: string;
+        props: {
+            columns: {
+                label: string;
+                key: string;
+            }[];
+            rows: Record<string, unknown>[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }, {
+        type: "data-table";
+        id: string;
+        props: {
+            columns: {
+                label: string;
+                key: string;
+            }[];
+            rows: Record<string, unknown>[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }>, z.ZodObject<{
+        props: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            services: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">>, "many">;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            title: z.ZodOptional<z.ZodString>;
+            services: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">>, "many">;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            title: z.ZodOptional<z.ZodString>;
+            services: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">>, "many">;
+        }, z.ZodTypeAny, "passthrough">>;
+        id: z.ZodString;
+        requiredPermission: z.ZodOptional<z.ZodString>;
+        nodeVersion: z.ZodOptional<z.ZodNumber>;
+        bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            prop: z.ZodString;
+            source: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            prop: string;
+            source: string;
+        }, {
+            prop: string;
+            source: string;
+        }>, "many">>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            target: z.ZodString;
+            method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }>, "many">>;
+        type: z.ZodLiteral<"service-health">;
+    }, "strict", z.ZodTypeAny, {
+        type: "service-health";
+        id: string;
+        props: {
+            services: z.objectOutputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }, {
+        type: "service-health";
+        id: string;
+        props: {
+            services: z.objectInputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }>, z.ZodObject<{
+        props: z.ZodObject<{
+            variant: z.ZodEnum<["heading", "subheading", "body"]>;
+            text: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            variant: z.ZodEnum<["heading", "subheading", "body"]>;
+            text: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            variant: z.ZodEnum<["heading", "subheading", "body"]>;
+            text: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>;
+        id: z.ZodString;
+        requiredPermission: z.ZodOptional<z.ZodString>;
+        nodeVersion: z.ZodOptional<z.ZodNumber>;
+        bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            prop: z.ZodString;
+            source: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            prop: string;
+            source: string;
+        }, {
+            prop: string;
+            source: string;
+        }>, "many">>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            target: z.ZodString;
+            method: z.ZodOptional<z.ZodEnum<["GET", "POST"]>>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }, {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }>, "many">>;
+        type: z.ZodLiteral<"text-block">;
+    }, "strict", z.ZodTypeAny, {
+        type: "text-block";
+        id: string;
+        props: {
+            variant: "heading" | "subheading" | "body";
+            text: string;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }, {
+        type: "text-block";
+        id: string;
+        props: {
+            variant: "heading" | "subheading" | "body";
+            text: string;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    }>]>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: "v1";
+    correlationId: string;
+    layout: {
+        type: "stack" | "grid";
+        columns?: number | undefined;
+    };
+    nodes: ({
+        type: "stat-card";
+        id: string;
+        props: {
+            label: string;
+            value: string | number;
+            unit?: string | undefined;
+            trend?: "up" | "down" | "flat" | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    } | {
+        type: "data-table";
+        id: string;
+        props: {
+            columns: {
+                label: string;
+                key: string;
+            }[];
+            rows: Record<string, unknown>[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    } | {
+        type: "service-health";
+        id: string;
+        props: {
+            services: z.objectOutputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    } | {
+        type: "text-block";
+        id: string;
+        props: {
+            variant: "heading" | "subheading" | "body";
+            text: string;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    })[];
+}, {
+    version: "v1";
+    correlationId: string;
+    layout: {
+        type: "stack" | "grid";
+        columns?: number | undefined;
+    };
+    nodes: ({
+        type: "stat-card";
+        id: string;
+        props: {
+            label: string;
+            value: string | number;
+            unit?: string | undefined;
+            trend?: "up" | "down" | "flat" | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    } | {
+        type: "data-table";
+        id: string;
+        props: {
+            columns: {
+                label: string;
+                key: string;
+            }[];
+            rows: Record<string, unknown>[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    } | {
+        type: "service-health";
+        id: string;
+        props: {
+            services: z.objectInputType<{
+                name: z.ZodString;
+                state: z.ZodEnum<["running", "stopped", "unknown", "error"]>;
+                health: z.ZodOptional<z.ZodEnum<["healthy", "unhealthy", "unknown"]>>;
+            }, z.ZodTypeAny, "passthrough">[];
+            title?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    } | {
+        type: "text-block";
+        id: string;
+        props: {
+            variant: "heading" | "subheading" | "body";
+            text: string;
+        } & {
+            [k: string]: unknown;
+        };
+        requiredPermission?: string | undefined;
+        nodeVersion?: number | undefined;
+        bindings?: {
+            prop: string;
+            source: string;
+        }[] | undefined;
+        actions?: {
+            label: string;
+            id: string;
+            target: string;
+            method?: "GET" | "POST" | undefined;
+        }[] | undefined;
+    })[];
+}>;
+export interface ValidationResult {
+    ok: boolean;
+    data?: CanvasDefinition;
+    errors?: string[];
+}
+/** Validate an unknown value as a CanvasDefinition. */
+export declare function validateCanvasDefinition(input: unknown): ValidationResult;
+/** The discriminant literals the zod union accepts (for conformance checks). */
+export declare const ZOD_NODE_TYPES: readonly CanvasNodeType[];
+//# sourceMappingURL=canvas.d.ts.map