@syntrologie/runtime-sdk 2.1.0 → 2.2.0-canary.10

package/dist/actions/schema.d.ts

@@ -0,0 +1,1229 @@
+/**
+ * Core Action Zod Schemas
+ *
+ * Single source of truth for the shape of all 18 core action types.
+ * These schemas are converted to JSON Schema during build and merged
+ * into the unified canvas-config.schema.json.
+ *
+ * Design decisions:
+ * - `.strict()` on every object → `additionalProperties: false` in JSON Schema
+ * - Matches `types.ts` exactly (fixes all drift from the old manual JSON defs)
+ * - Recursive ActionStep references use `z.any()` as placeholder; the generator
+ *   replaces `{}` with `{ "$ref": "#/$defs/actionStep" }` post-conversion
+ */
+import { z } from 'zod';
+/** Highlight style configuration */
+declare const HighlightStyleZ: z.ZodObject<{
+    color: z.ZodOptional<z.ZodString>;
+    scrimOpacity: z.ZodOptional<z.ZodNumber>;
+    paddingPx: z.ZodOptional<z.ZodNumber>;
+    radiusPx: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    color?: string | undefined;
+    scrimOpacity?: number | undefined;
+    paddingPx?: number | undefined;
+    radiusPx?: number | undefined;
+}, {
+    color?: string | undefined;
+    scrimOpacity?: number | undefined;
+    paddingPx?: number | undefined;
+    radiusPx?: number | undefined;
+}>;
+/** Badge position relative to anchor */
+declare const BadgePositionZ: z.ZodEnum<["top-left", "top-right", "bottom-left", "bottom-right"]>;
+/**
+ * Floating-ui Placement — all 12 values.
+ * Matches `@floating-ui/dom` `Placement` type.
+ */
+declare const PlacementZ: z.ZodEnum<["top", "top-start", "top-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end", "right", "right-start", "right-end"]>;
+/** CTA button configuration for tooltips/modals */
+declare const CtaButtonZ: z.ZodObject<{
+    label: z.ZodString;
+    actionId: z.ZodString;
+    primary: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    actionId: string;
+    label: string;
+    primary?: boolean | undefined;
+}, {
+    actionId: string;
+    label: string;
+    primary?: boolean | undefined;
+}>;
+/**
+ * Tooltip content (schema-safe version).
+ * Omits `cta` (legacy field with recursive ActionStep; never in JSON schema).
+ */
+declare const TooltipContentZ: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodString;
+    ctaButtons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        actionId: z.ZodString;
+        primary: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }, {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    body: string;
+    ctaButtons?: {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+}, {
+    body: string;
+    ctaButtons?: {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+}>;
+/** Modal content configuration */
+declare const ModalContentZ: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    body: string;
+    title?: string | undefined;
+}, {
+    body: string;
+    title?: string | undefined;
+}>;
+/** Position where HTML/content should be inserted */
+declare const InsertPositionZ: z.ZodEnum<["before", "after", "prepend", "append", "replace"]>;
+/** Tooltip trigger mode */
+declare const TooltipTriggerZ: z.ZodEnum<["immediate", "hover", "click"]>;
+/** Widget configuration for surface mounting */
+declare const WidgetConfigZ: z.ZodObject<{
+    widgetId: z.ZodString;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    widgetId: string;
+    props?: Record<string, unknown> | undefined;
+    priority?: number | undefined;
+}, {
+    widgetId: string;
+    props?: Record<string, unknown> | undefined;
+    priority?: number | undefined;
+}>;
+/**
+ * Tour step (schema-safe version).
+ * Uses `z.any()` for the `action` field — the generator replaces it with a $ref.
+ */
+declare const TourStepForSchemaZ: z.ZodObject<{
+    id: z.ZodString;
+    action: z.ZodAny;
+    route: z.ZodOptional<z.ZodString>;
+    onAction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    route?: string | undefined;
+    action?: any;
+    onAction?: Record<string, string> | undefined;
+}, {
+    id: string;
+    route?: string | undefined;
+    action?: any;
+    onAction?: Record<string, string> | undefined;
+}>;
+declare const ScrollBehaviorZ: z.ZodEnum<["auto", "smooth", "instant"]>;
+declare const ScrollLogicalPositionZ: z.ZodEnum<["start", "center", "end", "nearest"]>;
+declare const SetTextZ: z.ZodObject<{
+    kind: z.ZodLiteral<"content:setText">;
+    anchorId: z.ZodString;
+    text: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "content:setText";
+    anchorId: string;
+    text: string;
+    label?: string | undefined;
+}, {
+    kind: "content:setText";
+    anchorId: string;
+    text: string;
+    label?: string | undefined;
+}>;
+declare const SetAttrZ: z.ZodObject<{
+    kind: z.ZodLiteral<"content:setAttr">;
+    anchorId: z.ZodString;
+    attr: z.ZodString;
+    value: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "content:setAttr";
+    anchorId: string;
+    attr: string;
+    value: string;
+    label?: string | undefined;
+}, {
+    kind: "content:setAttr";
+    anchorId: string;
+    attr: string;
+    value: string;
+    label?: string | undefined;
+}>;
+declare const AddClassZ: z.ZodObject<{
+    kind: z.ZodLiteral<"content:addClass">;
+    anchorId: z.ZodString;
+    className: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "content:addClass";
+    anchorId: string;
+    className: string;
+    label?: string | undefined;
+}, {
+    kind: "content:addClass";
+    anchorId: string;
+    className: string;
+    label?: string | undefined;
+}>;
+declare const RemoveClassZ: z.ZodObject<{
+    kind: z.ZodLiteral<"content:removeClass">;
+    anchorId: z.ZodString;
+    className: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "content:removeClass";
+    anchorId: string;
+    className: string;
+    label?: string | undefined;
+}, {
+    kind: "content:removeClass";
+    anchorId: string;
+    className: string;
+    label?: string | undefined;
+}>;
+declare const SetStyleZ: z.ZodObject<{
+    kind: z.ZodLiteral<"content:setStyle">;
+    anchorId: z.ZodString;
+    styles: z.ZodRecord<z.ZodString, z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "content:setStyle";
+    anchorId: string;
+    styles: Record<string, string>;
+    label?: string | undefined;
+}, {
+    kind: "content:setStyle";
+    anchorId: string;
+    styles: Record<string, string>;
+    label?: string | undefined;
+}>;
+declare const InsertHtmlZ: z.ZodObject<{
+    kind: z.ZodLiteral<"content:insertHtml">;
+    anchorId: z.ZodString;
+    html: z.ZodString;
+    position: z.ZodEnum<["before", "after", "prepend", "append", "replace"]>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "content:insertHtml";
+    anchorId: string;
+    position: "before" | "after" | "prepend" | "append" | "replace";
+    html: string;
+    label?: string | undefined;
+}, {
+    kind: "content:insertHtml";
+    anchorId: string;
+    position: "before" | "after" | "prepend" | "append" | "replace";
+    html: string;
+    label?: string | undefined;
+}>;
+declare const HighlightZ: z.ZodObject<{
+    kind: z.ZodLiteral<"overlays:highlight">;
+    anchorId: z.ZodString;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        scrimOpacity: z.ZodOptional<z.ZodNumber>;
+        paddingPx: z.ZodOptional<z.ZodNumber>;
+        radiusPx: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        color?: string | undefined;
+        scrimOpacity?: number | undefined;
+        paddingPx?: number | undefined;
+        radiusPx?: number | undefined;
+    }, {
+        color?: string | undefined;
+        scrimOpacity?: number | undefined;
+        paddingPx?: number | undefined;
+        radiusPx?: number | undefined;
+    }>>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "overlays:highlight";
+    anchorId: string;
+    style?: {
+        color?: string | undefined;
+        scrimOpacity?: number | undefined;
+        paddingPx?: number | undefined;
+        radiusPx?: number | undefined;
+    } | undefined;
+    duration?: number | undefined;
+    label?: string | undefined;
+}, {
+    kind: "overlays:highlight";
+    anchorId: string;
+    style?: {
+        color?: string | undefined;
+        scrimOpacity?: number | undefined;
+        paddingPx?: number | undefined;
+        radiusPx?: number | undefined;
+    } | undefined;
+    duration?: number | undefined;
+    label?: string | undefined;
+}>;
+declare const PulseZ: z.ZodObject<{
+    kind: z.ZodLiteral<"overlays:pulse">;
+    anchorId: z.ZodString;
+    duration: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "overlays:pulse";
+    anchorId: string;
+    duration?: number | undefined;
+    label?: string | undefined;
+}, {
+    kind: "overlays:pulse";
+    anchorId: string;
+    duration?: number | undefined;
+    label?: string | undefined;
+}>;
+declare const BadgeZ: z.ZodObject<{
+    kind: z.ZodLiteral<"overlays:badge">;
+    anchorId: z.ZodString;
+    content: z.ZodString;
+    position: z.ZodOptional<z.ZodEnum<["top-left", "top-right", "bottom-left", "bottom-right"]>>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "overlays:badge";
+    anchorId: string;
+    content: string;
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | undefined;
+    label?: string | undefined;
+}, {
+    kind: "overlays:badge";
+    anchorId: string;
+    content: string;
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | undefined;
+    label?: string | undefined;
+}>;
+declare const TooltipZ: z.ZodObject<{
+    kind: z.ZodLiteral<"overlays:tooltip">;
+    anchorId: z.ZodString;
+    content: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        body: z.ZodString;
+        ctaButtons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            actionId: z.ZodString;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }, {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        body: string;
+        ctaButtons?: {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    }, {
+        body: string;
+        ctaButtons?: {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    }>;
+    trigger: z.ZodOptional<z.ZodEnum<["immediate", "hover", "click"]>>;
+    placement: z.ZodOptional<z.ZodEnum<["top", "top-start", "top-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end", "right", "right-start", "right-end"]>>;
+    waitFor: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "overlays:tooltip";
+    anchorId: string;
+    content: {
+        body: string;
+        ctaButtons?: {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    };
+    trigger?: "immediate" | "hover" | "click" | undefined;
+    placement?: "top" | "right" | "bottom" | "left" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | undefined;
+    waitFor?: string | undefined;
+    label?: string | undefined;
+}, {
+    kind: "overlays:tooltip";
+    anchorId: string;
+    content: {
+        body: string;
+        ctaButtons?: {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    };
+    trigger?: "immediate" | "hover" | "click" | undefined;
+    placement?: "top" | "right" | "bottom" | "left" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | undefined;
+    waitFor?: string | undefined;
+    label?: string | undefined;
+}>;
+declare const ModalZ: z.ZodObject<{
+    kind: z.ZodLiteral<"overlays:modal">;
+    content: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        body: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        body: string;
+        title?: string | undefined;
+    }, {
+        body: string;
+        title?: string | undefined;
+    }>;
+    size: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
+    blocking: z.ZodOptional<z.ZodBoolean>;
+    scrim: z.ZodOptional<z.ZodObject<{
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        opacity?: number | undefined;
+    }, {
+        opacity?: number | undefined;
+    }>>;
+    dismiss: z.ZodOptional<z.ZodObject<{
+        onEsc: z.ZodOptional<z.ZodBoolean>;
+        closeButton: z.ZodOptional<z.ZodBoolean>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        onEsc?: boolean | undefined;
+        closeButton?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }, {
+        onEsc?: boolean | undefined;
+        closeButton?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }>>;
+    ctaButtons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        actionId: z.ZodString;
+        primary: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }, {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }>, "many">>;
+    waitFor: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "overlays:modal";
+    content: {
+        body: string;
+        title?: string | undefined;
+    };
+    waitFor?: string | undefined;
+    size?: "sm" | "md" | "lg" | undefined;
+    blocking?: boolean | undefined;
+    scrim?: {
+        opacity?: number | undefined;
+    } | undefined;
+    dismiss?: {
+        onEsc?: boolean | undefined;
+        closeButton?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    } | undefined;
+    ctaButtons?: {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }[] | undefined;
+    label?: string | undefined;
+}, {
+    kind: "overlays:modal";
+    content: {
+        body: string;
+        title?: string | undefined;
+    };
+    waitFor?: string | undefined;
+    size?: "sm" | "md" | "lg" | undefined;
+    blocking?: boolean | undefined;
+    scrim?: {
+        opacity?: number | undefined;
+    } | undefined;
+    dismiss?: {
+        onEsc?: boolean | undefined;
+        closeButton?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    } | undefined;
+    ctaButtons?: {
+        actionId: string;
+        label: string;
+        primary?: boolean | undefined;
+    }[] | undefined;
+    label?: string | undefined;
+}>;
+declare const ScrollToZ: z.ZodObject<{
+    kind: z.ZodLiteral<"navigation:scrollTo">;
+    anchorId: z.ZodString;
+    behavior: z.ZodOptional<z.ZodEnum<["auto", "smooth", "instant"]>>;
+    block: z.ZodOptional<z.ZodEnum<["start", "center", "end", "nearest"]>>;
+    inline: z.ZodOptional<z.ZodEnum<["start", "center", "end", "nearest"]>>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "navigation:scrollTo";
+    anchorId: string;
+    behavior?: "auto" | "instant" | "smooth" | undefined;
+    block?: "start" | "end" | "center" | "nearest" | undefined;
+    inline?: "start" | "end" | "center" | "nearest" | undefined;
+    label?: string | undefined;
+}, {
+    kind: "navigation:scrollTo";
+    anchorId: string;
+    behavior?: "auto" | "instant" | "smooth" | undefined;
+    block?: "start" | "end" | "center" | "nearest" | undefined;
+    inline?: "start" | "end" | "center" | "nearest" | undefined;
+    label?: string | undefined;
+}>;
+declare const NavigateZ: z.ZodObject<{
+    kind: z.ZodLiteral<"navigation:navigate">;
+    url: z.ZodString;
+    target: z.ZodOptional<z.ZodEnum<["_self", "_blank"]>>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "navigation:navigate";
+    url: string;
+    target?: "_self" | "_blank" | undefined;
+    label?: string | undefined;
+}, {
+    kind: "navigation:navigate";
+    url: string;
+    target?: "_self" | "_blank" | undefined;
+    label?: string | undefined;
+}>;
+declare const MountWidgetZ: z.ZodObject<{
+    kind: z.ZodLiteral<"core:mountWidget">;
+    slot: z.ZodString;
+    widget: z.ZodObject<{
+        widgetId: z.ZodString;
+        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        widgetId: string;
+        props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
+    }, {
+        widgetId: string;
+        props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "core:mountWidget";
+    slot: string;
+    widget: {
+        widgetId: string;
+        props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
+    };
+    label?: string | undefined;
+}, {
+    kind: "core:mountWidget";
+    slot: string;
+    widget: {
+        widgetId: string;
+        props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
+    };
+    label?: string | undefined;
+}>;
+declare const WaitZ: z.ZodObject<{
+    kind: z.ZodLiteral<"core:wait">;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    event: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "core:wait";
+    durationMs?: number | undefined;
+    event?: string | undefined;
+    label?: string | undefined;
+}, {
+    kind: "core:wait";
+    durationMs?: number | undefined;
+    event?: string | undefined;
+    label?: string | undefined;
+}>;
+/**
+ * Sequence — executes actions serially.
+ * `actions` uses `z.any()` as placeholder for recursive ActionStep refs.
+ */
+declare const SequenceZ: z.ZodObject<{
+    kind: z.ZodLiteral<"core:sequence">;
+    actions: z.ZodArray<z.ZodAny, "many">;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "core:sequence";
+    actions: any[];
+    label?: string | undefined;
+}, {
+    kind: "core:sequence";
+    actions: any[];
+    label?: string | undefined;
+}>;
+/**
+ * Parallel — executes actions concurrently.
+ * `actions` uses `z.any()` as placeholder for recursive ActionStep refs.
+ */
+declare const ParallelZ: z.ZodObject<{
+    kind: z.ZodLiteral<"core:parallel">;
+    actions: z.ZodArray<z.ZodAny, "many">;
+    waitFor: z.ZodOptional<z.ZodEnum<["all", "any"]>>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "core:parallel";
+    actions: any[];
+    waitFor?: "all" | "any" | undefined;
+    label?: string | undefined;
+}, {
+    kind: "core:parallel";
+    actions: any[];
+    waitFor?: "all" | "any" | undefined;
+    label?: string | undefined;
+}>;
+/**
+ * Tour — orchestrate sequential steps with cross-page state.
+ * `steps` contains TourStepForSchemaZ which uses z.any() for step.action.
+ */
+declare const TourZ: z.ZodObject<{
+    kind: z.ZodLiteral<"core:tour">;
+    tourId: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        action: z.ZodAny;
+        route: z.ZodOptional<z.ZodString>;
+        onAction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        route?: string | undefined;
+        action?: any;
+        onAction?: Record<string, string> | undefined;
+    }, {
+        id: string;
+        route?: string | undefined;
+        action?: any;
+        onAction?: Record<string, string> | undefined;
+    }>, "many">;
+    startStep: z.ZodOptional<z.ZodString>;
+    autoStart: z.ZodOptional<z.ZodBoolean>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "core:tour";
+    tourId: string;
+    steps: {
+        id: string;
+        route?: string | undefined;
+        action?: any;
+        onAction?: Record<string, string> | undefined;
+    }[];
+    startStep?: string | undefined;
+    autoStart?: boolean | undefined;
+    label?: string | undefined;
+}, {
+    kind: "core:tour";
+    tourId: string;
+    steps: {
+        id: string;
+        route?: string | undefined;
+        action?: any;
+        onAction?: Record<string, string> | undefined;
+    }[];
+    startStep?: string | undefined;
+    autoStart?: boolean | undefined;
+    label?: string | undefined;
+}>;
+/**
+ * All 18 core action step schemas for unified JSON Schema generation.
+ * The generator imports this array and converts each to JSON Schema,
+ * then merges them into `$defs` and `actionStep.oneOf`.
+ *
+ * `defName` values match the existing `$defs` keys for backward compat.
+ */
+export declare const coreActionStepSchemas: ({
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"content:setText">;
+        anchorId: z.ZodString;
+        text: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "content:setText";
+        anchorId: string;
+        text: string;
+        label?: string | undefined;
+    }, {
+        kind: "content:setText";
+        anchorId: string;
+        text: string;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"content:setAttr">;
+        anchorId: z.ZodString;
+        attr: z.ZodString;
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "content:setAttr";
+        anchorId: string;
+        attr: string;
+        value: string;
+        label?: string | undefined;
+    }, {
+        kind: "content:setAttr";
+        anchorId: string;
+        attr: string;
+        value: string;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"content:addClass">;
+        anchorId: z.ZodString;
+        className: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "content:addClass";
+        anchorId: string;
+        className: string;
+        label?: string | undefined;
+    }, {
+        kind: "content:addClass";
+        anchorId: string;
+        className: string;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"content:removeClass">;
+        anchorId: z.ZodString;
+        className: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "content:removeClass";
+        anchorId: string;
+        className: string;
+        label?: string | undefined;
+    }, {
+        kind: "content:removeClass";
+        anchorId: string;
+        className: string;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"content:setStyle">;
+        anchorId: z.ZodString;
+        styles: z.ZodRecord<z.ZodString, z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "content:setStyle";
+        anchorId: string;
+        styles: Record<string, string>;
+        label?: string | undefined;
+    }, {
+        kind: "content:setStyle";
+        anchorId: string;
+        styles: Record<string, string>;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"content:insertHtml">;
+        anchorId: z.ZodString;
+        html: z.ZodString;
+        position: z.ZodEnum<["before", "after", "prepend", "append", "replace"]>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "content:insertHtml";
+        anchorId: string;
+        position: "before" | "after" | "prepend" | "append" | "replace";
+        html: string;
+        label?: string | undefined;
+    }, {
+        kind: "content:insertHtml";
+        anchorId: string;
+        position: "before" | "after" | "prepend" | "append" | "replace";
+        html: string;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"overlays:highlight">;
+        anchorId: z.ZodString;
+        style: z.ZodOptional<z.ZodObject<{
+            color: z.ZodOptional<z.ZodString>;
+            scrimOpacity: z.ZodOptional<z.ZodNumber>;
+            paddingPx: z.ZodOptional<z.ZodNumber>;
+            radiusPx: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            color?: string | undefined;
+            scrimOpacity?: number | undefined;
+            paddingPx?: number | undefined;
+            radiusPx?: number | undefined;
+        }, {
+            color?: string | undefined;
+            scrimOpacity?: number | undefined;
+            paddingPx?: number | undefined;
+            radiusPx?: number | undefined;
+        }>>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "overlays:highlight";
+        anchorId: string;
+        style?: {
+            color?: string | undefined;
+            scrimOpacity?: number | undefined;
+            paddingPx?: number | undefined;
+            radiusPx?: number | undefined;
+        } | undefined;
+        duration?: number | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "overlays:highlight";
+        anchorId: string;
+        style?: {
+            color?: string | undefined;
+            scrimOpacity?: number | undefined;
+            paddingPx?: number | undefined;
+            radiusPx?: number | undefined;
+        } | undefined;
+        duration?: number | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"overlays:pulse">;
+        anchorId: z.ZodString;
+        duration: z.ZodOptional<z.ZodNumber>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "overlays:pulse";
+        anchorId: string;
+        duration?: number | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "overlays:pulse";
+        anchorId: string;
+        duration?: number | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"overlays:badge">;
+        anchorId: z.ZodString;
+        content: z.ZodString;
+        position: z.ZodOptional<z.ZodEnum<["top-left", "top-right", "bottom-left", "bottom-right"]>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "overlays:badge";
+        anchorId: string;
+        content: string;
+        position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "overlays:badge";
+        anchorId: string;
+        content: string;
+        position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"overlays:tooltip">;
+        anchorId: z.ZodString;
+        content: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            body: z.ZodString;
+            ctaButtons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                actionId: z.ZodString;
+                primary: z.ZodOptional<z.ZodBoolean>;
+            }, "strict", z.ZodTypeAny, {
+                actionId: string;
+                label: string;
+                primary?: boolean | undefined;
+            }, {
+                actionId: string;
+                label: string;
+                primary?: boolean | undefined;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            body: string;
+            ctaButtons?: {
+                actionId: string;
+                label: string;
+                primary?: boolean | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }, {
+            body: string;
+            ctaButtons?: {
+                actionId: string;
+                label: string;
+                primary?: boolean | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }>;
+        trigger: z.ZodOptional<z.ZodEnum<["immediate", "hover", "click"]>>;
+        placement: z.ZodOptional<z.ZodEnum<["top", "top-start", "top-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end", "right", "right-start", "right-end"]>>;
+        waitFor: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "overlays:tooltip";
+        anchorId: string;
+        content: {
+            body: string;
+            ctaButtons?: {
+                actionId: string;
+                label: string;
+                primary?: boolean | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        };
+        trigger?: "immediate" | "hover" | "click" | undefined;
+        placement?: "top" | "right" | "bottom" | "left" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | undefined;
+        waitFor?: string | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "overlays:tooltip";
+        anchorId: string;
+        content: {
+            body: string;
+            ctaButtons?: {
+                actionId: string;
+                label: string;
+                primary?: boolean | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        };
+        trigger?: "immediate" | "hover" | "click" | undefined;
+        placement?: "top" | "right" | "bottom" | "left" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | undefined;
+        waitFor?: string | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"overlays:modal">;
+        content: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            body: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            body: string;
+            title?: string | undefined;
+        }, {
+            body: string;
+            title?: string | undefined;
+        }>;
+        size: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
+        blocking: z.ZodOptional<z.ZodBoolean>;
+        scrim: z.ZodOptional<z.ZodObject<{
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            opacity?: number | undefined;
+        }, {
+            opacity?: number | undefined;
+        }>>;
+        dismiss: z.ZodOptional<z.ZodObject<{
+            onEsc: z.ZodOptional<z.ZodBoolean>;
+            closeButton: z.ZodOptional<z.ZodBoolean>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            onEsc?: boolean | undefined;
+            closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
+        }, {
+            onEsc?: boolean | undefined;
+            closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
+        }>>;
+        ctaButtons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            actionId: z.ZodString;
+            primary: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }, {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }>, "many">>;
+        waitFor: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "overlays:modal";
+        content: {
+            body: string;
+            title?: string | undefined;
+        };
+        waitFor?: string | undefined;
+        size?: "sm" | "md" | "lg" | undefined;
+        blocking?: boolean | undefined;
+        scrim?: {
+            opacity?: number | undefined;
+        } | undefined;
+        dismiss?: {
+            onEsc?: boolean | undefined;
+            closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
+        } | undefined;
+        ctaButtons?: {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }[] | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "overlays:modal";
+        content: {
+            body: string;
+            title?: string | undefined;
+        };
+        waitFor?: string | undefined;
+        size?: "sm" | "md" | "lg" | undefined;
+        blocking?: boolean | undefined;
+        scrim?: {
+            opacity?: number | undefined;
+        } | undefined;
+        dismiss?: {
+            onEsc?: boolean | undefined;
+            closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
+        } | undefined;
+        ctaButtons?: {
+            actionId: string;
+            label: string;
+            primary?: boolean | undefined;
+        }[] | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"navigation:scrollTo">;
+        anchorId: z.ZodString;
+        behavior: z.ZodOptional<z.ZodEnum<["auto", "smooth", "instant"]>>;
+        block: z.ZodOptional<z.ZodEnum<["start", "center", "end", "nearest"]>>;
+        inline: z.ZodOptional<z.ZodEnum<["start", "center", "end", "nearest"]>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "navigation:scrollTo";
+        anchorId: string;
+        behavior?: "auto" | "instant" | "smooth" | undefined;
+        block?: "start" | "end" | "center" | "nearest" | undefined;
+        inline?: "start" | "end" | "center" | "nearest" | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "navigation:scrollTo";
+        anchorId: string;
+        behavior?: "auto" | "instant" | "smooth" | undefined;
+        block?: "start" | "end" | "center" | "nearest" | undefined;
+        inline?: "start" | "end" | "center" | "nearest" | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"navigation:navigate">;
+        url: z.ZodString;
+        target: z.ZodOptional<z.ZodEnum<["_self", "_blank"]>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "navigation:navigate";
+        url: string;
+        target?: "_self" | "_blank" | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "navigation:navigate";
+        url: string;
+        target?: "_self" | "_blank" | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"core:mountWidget">;
+        slot: z.ZodString;
+        widget: z.ZodObject<{
+            widgetId: z.ZodString;
+            props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            priority: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            widgetId: string;
+            props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
+        }, {
+            widgetId: string;
+            props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "core:mountWidget";
+        slot: string;
+        widget: {
+            widgetId: string;
+            props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
+        };
+        label?: string | undefined;
+    }, {
+        kind: "core:mountWidget";
+        slot: string;
+        widget: {
+            widgetId: string;
+            props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
+        };
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"core:wait">;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        event: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "core:wait";
+        durationMs?: number | undefined;
+        event?: string | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "core:wait";
+        durationMs?: number | undefined;
+        event?: string | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"core:sequence">;
+        actions: z.ZodArray<z.ZodAny, "many">;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "core:sequence";
+        actions: any[];
+        label?: string | undefined;
+    }, {
+        kind: "core:sequence";
+        actions: any[];
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"core:parallel">;
+        actions: z.ZodArray<z.ZodAny, "many">;
+        waitFor: z.ZodOptional<z.ZodEnum<["all", "any"]>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "core:parallel";
+        actions: any[];
+        waitFor?: "all" | "any" | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "core:parallel";
+        actions: any[];
+        waitFor?: "all" | "any" | undefined;
+        label?: string | undefined;
+    }>;
+} | {
+    defName: string;
+    schema: z.ZodObject<{
+        kind: z.ZodLiteral<"core:tour">;
+        tourId: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            action: z.ZodAny;
+            route: z.ZodOptional<z.ZodString>;
+            onAction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            route?: string | undefined;
+            action?: any;
+            onAction?: Record<string, string> | undefined;
+        }, {
+            id: string;
+            route?: string | undefined;
+            action?: any;
+            onAction?: Record<string, string> | undefined;
+        }>, "many">;
+        startStep: z.ZodOptional<z.ZodString>;
+        autoStart: z.ZodOptional<z.ZodBoolean>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "core:tour";
+        tourId: string;
+        steps: {
+            id: string;
+            route?: string | undefined;
+            action?: any;
+            onAction?: Record<string, string> | undefined;
+        }[];
+        startStep?: string | undefined;
+        autoStart?: boolean | undefined;
+        label?: string | undefined;
+    }, {
+        kind: "core:tour";
+        tourId: string;
+        steps: {
+            id: string;
+            route?: string | undefined;
+            action?: any;
+            onAction?: Record<string, string> | undefined;
+        }[];
+        startStep?: string | undefined;
+        autoStart?: boolean | undefined;
+        label?: string | undefined;
+    }>;
+})[];
+export { HighlightStyleZ, BadgePositionZ, PlacementZ, CtaButtonZ, TooltipContentZ, ModalContentZ, InsertPositionZ, TooltipTriggerZ, WidgetConfigZ, TourStepForSchemaZ, ScrollBehaviorZ, ScrollLogicalPositionZ, SetTextZ, SetAttrZ, AddClassZ, RemoveClassZ, SetStyleZ, InsertHtmlZ, HighlightZ, PulseZ, BadgeZ, TooltipZ, ModalZ, ScrollToZ, NavigateZ, MountWidgetZ, WaitZ, SequenceZ, ParallelZ, TourZ, };