@syntrologie/runtime-sdk 2.4.0-canary.2 → 2.4.0-canary.20

package/dist/actions/schema.js

@@ -1,5 +1,6 @@
 import {
   AddClassZ,
+  AnchorIdZ,
   BadgePositionZ,
   BadgeZ,
   CtaButtonZ,
@@ -30,10 +31,11 @@ import {
   WaitZ,
   WidgetConfigZ,
   coreActionStepSchemas
-} from "../chunk-DOJR7R46.js";
-import "../chunk-JMHRHAEL.js";
+} from "../chunk-LR5AA5SE.js";
+import "../chunk-P5G4KT2U.js";
 export {
   AddClassZ,
+  AnchorIdZ,
   BadgePositionZ,
   BadgeZ,
   CtaButtonZ,

package/dist/actions/types.d.ts

@@ -5,6 +5,8 @@
  * (highlight, tooltip, badge, DOM modifications, navigation).
  */
 import type { Placement } from '@floating-ui/dom';
+import type { BadgePosition, CtaButton, HighlightStyle, InsertPosition, ModalContent, ModalWaitFor, TooltipTrigger, TooltipWaitFor } from '@syntrologie/sdk-contracts';
+export type { BadgePosition, CtaButton, HighlightStyle, InsertPosition, ModalContent, ModalWaitFor, TooltipTrigger, TooltipWaitFor, };
 /** Static surface slots with fixed positioning */
 export type StaticSurfaceSlot = 'drawer_right' | 'drawer_left' | 'drawer_bottom' | 'overlay_center' | 'overlay_corner_br' | 'overlay_corner_bl' | 'toast_top' | 'toast_bottom';
 /** Dynamic inline slot (rendered inside anchor) */
@@ -13,31 +15,7 @@ export type InlineSurfaceSlot = `inline:${string}`;
 export type AdjacentSurfaceSlot = `adjacent:${string}`;
 /** All surface slot types */
 export type SurfaceSlot = StaticSurfaceSlot | InlineSurfaceSlot | AdjacentSurfaceSlot;
-/** Highlight style configuration */
-export interface HighlightStyle {
-    /** Ring color (default: "#5b8cff") */
-    color?: string;
-    /** Backdrop scrim opacity 0-1 (default: 0.55, set to 0 to hide) */
-    scrimOpacity?: number;
-    /** Space between element and ring in pixels (default: 12) */
-    paddingPx?: number;
-    /** Ring corner radius in pixels (default: 12) */
-    radiusPx?: number;
-}
-/** Badge position relative to anchor */
-export type BadgePosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-/** CTA button configuration for tooltips/modals */
-export interface CtaButton {
-    label: string;
-    actionId: string;
-    primary?: boolean;
-}
-/** Modal content configuration */
-export interface ModalContent {
-    title?: string;
-    body: string;
-}
-/** Tooltip content configuration */
+/** Tooltip content configuration (uses ActionStep for cta.action, narrower than sdk-contracts' unknown) */
 export interface TooltipContent {
     title?: string;
     body: string;
@@ -47,25 +25,30 @@ export interface TooltipContent {
     };
     ctaButtons?: CtaButton[];
 }
-/** Tooltip trigger mode */
-export type TooltipTrigger = 'immediate' | 'hover' | 'click';
-/** Position where HTML/content should be inserted */
-export type InsertPosition = 'before' | 'after' | 'prepend' | 'append' | 'replace';
 /** Widget configuration for surface mounting */
 export interface WidgetConfig {
     widgetId: string;
     props?: Record<string, unknown>;
     priority?: number;
 }
+/** Route-scoped anchor identifier */
+export interface AnchorId {
+    /** CSS selector for the anchor element */
+    selector: string;
+    /** Route pattern(s) where this anchor applies. Uses matchRoutePattern (**, *, :param). Use "**" for all routes. */
+    route: string | string[];
+}
 /** Base action with common properties */
 interface BaseAction {
     /** Optional label for debugging/telemetry */
     label?: string;
+    /** Optional conditional trigger — when present, action only fires if strategy evaluates to true */
+    triggerWhen?: import('../decisions/types').DecisionStrategy<boolean>;
 }
 /** Highlight an anchor element with spotlight effect */
 export interface HighlightAction extends BaseAction {
     kind: 'overlays:highlight';
-    anchorId: string;
+    anchorId: AnchorId;
     style?: HighlightStyle;
     /** Duration in ms before auto-cleanup (for use in sequences) */
     duration?: number;
@@ -73,30 +56,26 @@ export interface HighlightAction extends BaseAction {
 /** Pulse animation on an anchor element */
 export interface PulseAction extends BaseAction {
     kind: 'overlays:pulse';
-    anchorId: string;
+    anchorId: AnchorId;
     duration?: number;
 }
 /** Add a badge near an anchor element */
 export interface BadgeAction extends BaseAction {
     kind: 'overlays:badge';
-    anchorId: string;
+    anchorId: AnchorId;
     content: string;
     position?: BadgePosition;
 }
-/** Tooltip lifecycle - when the action completes (for sequences) */
-export type TooltipWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
 /** Show a tooltip near an anchor element */
 export interface TooltipAction extends BaseAction {
     kind: 'overlays:tooltip';
-    anchorId: string;
+    anchorId: AnchorId;
     content: TooltipContent;
     trigger?: TooltipTrigger;
     placement?: Placement;
     /** When the action completes (for use in sequences). Publishes event to EventBus. */
     waitFor?: TooltipWaitFor;
 }
-/** Modal lifecycle - when the action completes (for sequences) */
-export type ModalWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
 /** Show a centered modal dialog */
 export interface ModalAction extends BaseAction {
     kind: 'overlays:modal';
@@ -118,39 +97,39 @@ export interface ModalAction extends BaseAction {
 /** Insert HTML content relative to anchor */
 export interface InsertHtmlAction extends BaseAction {
     kind: 'content:insertHtml';
-    anchorId: string;
+    anchorId: AnchorId;
     html: string;
     position: InsertPosition;
 }
 /** Set text content of an anchor */
 export interface SetTextAction extends BaseAction {
     kind: 'content:setText';
-    anchorId: string;
+    anchorId: AnchorId;
     text: string;
 }
 /** Set an attribute on an anchor */
 export interface SetAttrAction extends BaseAction {
     kind: 'content:setAttr';
-    anchorId: string;
+    anchorId: AnchorId;
     attr: string;
     value: string;
 }
 /** Add a CSS class to an anchor */
 export interface AddClassAction extends BaseAction {
     kind: 'content:addClass';
-    anchorId: string;
+    anchorId: AnchorId;
     className: string;
 }
 /** Remove a CSS class from an anchor */
 export interface RemoveClassAction extends BaseAction {
     kind: 'content:removeClass';
-    anchorId: string;
+    anchorId: AnchorId;
     className: string;
 }
 /** Set inline styles on an anchor */
 export interface SetStyleAction extends BaseAction {
     kind: 'content:setStyle';
-    anchorId: string;
+    anchorId: AnchorId;
     styles: Record<string, string>;
 }
 /** Mount a widget to a surface slot */
@@ -162,7 +141,7 @@ export interface MountWidgetAction extends BaseAction {
 /** Scroll to an anchor element */
 export interface ScrollToAction extends BaseAction {
     kind: 'navigation:scrollTo';
-    anchorId: string;
+    anchorId: AnchorId;
     behavior?: ScrollBehavior;
     block?: ScrollLogicalPosition;
     inline?: ScrollLogicalPosition;
@@ -213,7 +192,7 @@ export type ActionStep = HighlightAction | PulseAction | BadgeAction | TooltipAc
 /** Extract action kind literal types */
 export type ActionKind = ActionStep['kind'];
 /** State of an action */
-export type ActionState = 'pending' | 'applied' | 'reverted' | 'failed';
+export type ActionState = 'pending' | 'applied' | 'reverted' | 'failed' | 'deferred';
 /** Handle returned when an action is applied */
 export interface ActionHandle {
     /** Unique ID for this action instance */
@@ -289,13 +268,18 @@ export interface ExecutorContext {
     /** Overlay root element for rendering */
     overlayRoot: HTMLElement;
     /** Resolve an anchor ID to an element */
-    resolveAnchor: (anchorId: string) => HTMLElement | null;
+    resolveAnchor: (anchorId: AnchorId) => HTMLElement | null;
     /** Generate unique IDs */
     generateId: () => string;
     /** Publish events to EventBus */
     publishEvent: (name: string, props?: Record<string, unknown>) => void;
     /** Get the current adaptive ID (if any) */
     adaptiveId?: string;
+    /**
+     * Async anchor resolver — waits for a DOM element to appear.
+     * Returns null on timeout or route mismatch (never throws).
+     */
+    waitForAnchor?: (anchorId: AnchorId, timeoutMs?: number) => Promise<HTMLElement | null>;
     /**
      * Execute a nested action (for composite executors like tours).
      * Returns a handle that can be used to revert the action.
@@ -337,13 +321,27 @@ export interface ActionEngineOptions {
         mount: (slot: SurfaceSlot, content: RenderableContent, opts?: MountOptions) => MountHandle;
     };
     /** Function to resolve anchor IDs to elements */
-    anchorResolver: (anchorId: string) => HTMLElement | null;
+    anchorResolver: (anchorId: AnchorId) => HTMLElement | null;
+    /** Async anchor resolver — waits for a DOM element to appear */
+    waitForAnchor?: (anchorId: AnchorId, timeoutMs?: number) => Promise<HTMLElement | null>;
     /** Current adaptive ID for attribution */
     adaptiveId?: string;
     /** Optional executor registry (uses default singleton if not provided) */
     executorRegistry?: ActionEngineExecutorRegistry;
     /** Subscribe to navigation changes (from NavigationMonitor) */
     subscribeNavigation?: (callback: (url: string, method: string) => void) => () => void;
+    /** Runtime for evaluating DecisionStrategy conditions (e.g., triggerWhen) */
+    runtime?: {
+        evaluateSync: <T>(strategy: import('../decisions/types').DecisionStrategy<T>) => {
+            value: T;
+        };
+        context?: {
+            subscribe: (cb: () => void) => () => void;
+        };
+        accumulator?: {
+            subscribe: (cb: () => void) => () => void;
+        };
+    };
 }
 /** The ActionEngine interface */
 export interface ActionEngine {
@@ -403,4 +401,3 @@ export interface MountHandle {
     isMounted: () => boolean;
     getContainer: () => HTMLElement | null;
 }
-export {};

package/dist/anchor/AnchorResolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AnchorResolver — Centralized DOM observation for anchor element resolution.
+ *
+ * Provides a single MutationObserver that multiple callers share to wait for
+ * DOM elements to appear. Replaces scattered observation mechanisms.
+ */
+export interface AnchorResolverOptions {
+    root?: HTMLElement;
+    defaultTimeoutMs?: number;
+}
+export interface AnchorResolver {
+    resolve(selector: string): HTMLElement | null;
+    waitFor(selector: string, timeoutMs?: number): Promise<HTMLElement>;
+    onAppear(selector: string, cb: (el: HTMLElement) => void): () => void;
+    pendingCount(): number;
+    destroy(): void;
+}
+export declare function createAnchorResolver(opts?: AnchorResolverOptions): AnchorResolver;

package/dist/anchor/index.d.ts

@@ -0,0 +1,2 @@
+export type { AnchorResolver, AnchorResolverOptions } from './AnchorResolver';
+export { createAnchorResolver } from './AnchorResolver';

package/dist/api.d.ts

@@ -4,13 +4,13 @@
  * Entry point for the SmartCanvas SDK. Creates and manages the canvas element,
  * handles configuration, and coordinates between the ActionEngine and UI.
  */
-import type { CanvasTheme } from './components/ShadowCanvasOverlay';
 import type { ExperimentClient } from './experiments/types';
 import type { OverlayRecipeFetcher } from './overlays/fetcher';
 import type { ActionHandler, AppearanceConfig, RenderProps } from './render/types';
 import type { SmartCanvasRuntime } from './runtime';
 import { type SmartCanvasElement } from './SmartCanvasElement';
 import type { TelemetryClient } from './telemetry/types';
+import type { CanvasThemeConfig } from './theme';
 import type { CanvasConfigFetcher, CanvasConfigResponse } from './types';
 export interface SmartCanvasIntegrations {
     experiments?: ExperimentClient;
@@ -35,16 +35,16 @@ export interface SmartCanvasConfig {
         className?: string;
     };
     editorUrl?: string;
-    theme?: Partial<CanvasTheme>;
     /**
      * v2 Runtime instance.
      * Required for action execution. If not provided, actions will not be applied.
      */
     runtime?: SmartCanvasRuntime;
-    autoDetectTheme?: boolean;
     appearance?: AppearanceConfig;
     renderProps?: RenderProps;
     actionHandlers?: ActionHandler;
+    /** Workspace-level theme for 3-layer inheritance (defaults → workspace → config) */
+    workspaceTheme?: CanvasThemeConfig;
 }
 /**
  * Handle for interacting with a SmartCanvas instance.
@@ -59,11 +59,6 @@ export interface SmartCanvasHandle {
      * Get the current config.
      */
     getConfig(): Promise<CanvasConfigResponse>;
-    /**
-     * Update the config and re-apply actions.
-     * This is the primary way to modify what the canvas displays.
-     */
-    updateConfig(newConfig: CanvasConfigResponse): Promise<void>;
     /**
      * Enable or disable the canvas.
      * When disabled, all actions are reverted.

package/dist/{chunk-DOJR7R46.js → chunk-LR5AA5SE.js}

@@ -1,5 +1,18 @@
+import {
+  ActivationConfigZ,
+  DecisionStrategyZ
+} from "./chunk-P5G4KT2U.js";
+
 // src/actions/schema.ts
 import { z } from "zod";
+var ActionActivationZ = {
+  activation: ActivationConfigZ.optional(),
+  triggerWhen: DecisionStrategyZ.nullable().optional()
+};
+var AnchorIdZ = z.object({
+  selector: z.string(),
+  route: z.union([z.string(), z.array(z.string())])
+}).strict();
 var HighlightStyleZ = z.object({
   color: z.string().optional(),
   scrimOpacity: z.number().min(0).max(1).optional(),
@@ -47,76 +60,76 @@ var TourStepForSchemaZ = z.object({
   action: z.any(),
   route: z.string().optional(),
   onAction: z.record(z.string()).optional()
-}).strict();
+}).passthrough();
 var ScrollBehaviorZ = z.enum(["auto", "smooth", "instant"]);
 var ScrollLogicalPositionZ = z.enum(["start", "center", "end", "nearest"]);
 var SetTextZ = z.object({
   kind: z.literal("content:setText"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   text: z.string(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var SetAttrZ = z.object({
   kind: z.literal("content:setAttr"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   attr: z.string(),
   value: z.string(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var AddClassZ = z.object({
   kind: z.literal("content:addClass"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   className: z.string(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var RemoveClassZ = z.object({
   kind: z.literal("content:removeClass"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   className: z.string(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var SetStyleZ = z.object({
   kind: z.literal("content:setStyle"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   styles: z.record(z.string()),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var InsertHtmlZ = z.object({
   kind: z.literal("content:insertHtml"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   html: z.string(),
   position: InsertPositionZ,
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var HighlightZ = z.object({
   kind: z.literal("overlays:highlight"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   style: HighlightStyleZ.optional(),
   duration: z.number().optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var PulseZ = z.object({
   kind: z.literal("overlays:pulse"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   duration: z.number().optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var BadgeZ = z.object({
   kind: z.literal("overlays:badge"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   content: z.string(),
   position: BadgePositionZ.optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var TooltipZ = z.object({
   kind: z.literal("overlays:tooltip"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   content: TooltipContentZ,
   trigger: TooltipTriggerZ.optional(),
   placement: PlacementZ.optional(),
   waitFor: z.string().optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var ModalZ = z.object({
   kind: z.literal("overlays:modal"),
   content: ModalContentZ,
@@ -133,44 +146,44 @@ var ModalZ = z.object({
   ctaButtons: z.array(CtaButtonZ).optional(),
   waitFor: z.string().optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var ScrollToZ = z.object({
   kind: z.literal("navigation:scrollTo"),
-  anchorId: z.string(),
+  anchorId: AnchorIdZ,
   behavior: ScrollBehaviorZ.optional(),
   block: ScrollLogicalPositionZ.optional(),
   inline: ScrollLogicalPositionZ.optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var NavigateZ = z.object({
   kind: z.literal("navigation:navigate"),
   url: z.string(),
   target: z.enum(["_self", "_blank"]).optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var MountWidgetZ = z.object({
   kind: z.literal("core:mountWidget"),
   slot: z.string(),
   widget: WidgetConfigZ,
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var WaitZ = z.object({
   kind: z.literal("core:wait"),
   durationMs: z.number().min(0).optional(),
   event: z.string().optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var SequenceZ = z.object({
   kind: z.literal("core:sequence"),
   actions: z.array(z.any()),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var ParallelZ = z.object({
   kind: z.literal("core:parallel"),
   actions: z.array(z.any()),
   waitFor: z.enum(["all", "any"]).optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).strict();
 var TourZ = z.object({
   kind: z.literal("core:tour"),
   tourId: z.string(),
@@ -178,7 +191,7 @@ var TourZ = z.object({
   startStep: z.string().optional(),
   autoStart: z.boolean().optional(),
   label: z.string().optional()
-}).strict();
+}).extend(ActionActivationZ).passthrough();
 var coreActionStepSchemas = [
   { defName: "setText", schema: SetTextZ },
   { defName: "setAttr", schema: SetAttrZ },
@@ -201,6 +214,7 @@ var coreActionStepSchemas = [
 ];
 
 export {
+  AnchorIdZ,
   HighlightStyleZ,
   BadgePositionZ,
   PlacementZ,
@@ -233,4 +247,4 @@ export {
   TourZ,
   coreActionStepSchemas
 };
-//# sourceMappingURL=chunk-DOJR7R46.js.map
+//# sourceMappingURL=chunk-LR5AA5SE.js.map

package/dist/chunk-LR5AA5SE.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/actions/schema.ts"],
+  "sourcesContent": ["/**\n * Core Action Zod Schemas\n *\n * Single source of truth for the shape of all 18 core action types.\n * These schemas are converted to JSON Schema during build and merged\n * into the unified canvas-config.schema.json.\n *\n * Design decisions:\n * - `.strict()` on most objects \u2192 `additionalProperties: false` in JSON Schema\n * - Tour/TourStep use `.passthrough()` to allow adaptive-specific extensions (e.g. `workflow`)\n * - Matches `types.ts` exactly (fixes all drift from the old manual JSON defs)\n * - Recursive ActionStep references use `z.any()` as placeholder; the generator\n *   replaces `{}` with `{ \"$ref\": \"#/$defs/actionStep\" }` post-conversion\n */\n\nimport { z } from 'zod';\nimport { ActivationConfigZ, DecisionStrategyZ } from '../decisions/schema';\n\n// ============================================================================\n// Shared Sub-Types\n// ============================================================================\n\n/** Optional activation config \u2014 every action can declare its own route scoping */\nconst ActionActivationZ = {\n  activation: ActivationConfigZ.optional(),\n  triggerWhen: DecisionStrategyZ.nullable().optional(),\n};\n\n/** Route-scoped anchor identifier */\nconst AnchorIdZ = z\n  .object({\n    selector: z.string(),\n    route: z.union([z.string(), z.array(z.string())]),\n  })\n  .strict();\n\n/** Highlight style configuration */\nconst HighlightStyleZ = z\n  .object({\n    color: z.string().optional(),\n    scrimOpacity: z.number().min(0).max(1).optional(),\n    paddingPx: z.number().optional(),\n    radiusPx: z.number().optional(),\n  })\n  .strict();\n\n/** Badge position relative to anchor */\nconst BadgePositionZ = z.enum(['top-left', 'top-right', 'bottom-left', 'bottom-right']);\n\n/**\n * Floating-ui Placement \u2014 all 12 values.\n * Matches `@floating-ui/dom` `Placement` type.\n */\nconst PlacementZ = z.enum([\n  'top',\n  'top-start',\n  'top-end',\n  'bottom',\n  'bottom-start',\n  'bottom-end',\n  'left',\n  'left-start',\n  'left-end',\n  'right',\n  'right-start',\n  'right-end',\n]);\n\n/** CTA button configuration for tooltips/modals */\nconst CtaButtonZ = z\n  .object({\n    label: z.string(),\n    actionId: z.string(),\n    primary: z.boolean().optional(),\n  })\n  .strict();\n\n/**\n * Tooltip content (schema-safe version).\n * Omits `cta` (legacy field with recursive ActionStep; never in JSON schema).\n */\nconst TooltipContentZ = z\n  .object({\n    title: z.string().optional(),\n    body: z.string(),\n    ctaButtons: z.array(CtaButtonZ).optional(),\n  })\n  .strict();\n\n/** Modal content configuration */\nconst ModalContentZ = z\n  .object({\n    title: z.string().optional(),\n    body: z.string(),\n  })\n  .strict();\n\n/** Position where HTML/content should be inserted */\nconst InsertPositionZ = z.enum(['before', 'after', 'prepend', 'append', 'replace']);\n\n/** Tooltip trigger mode */\nconst TooltipTriggerZ = z.enum(['immediate', 'hover', 'click']);\n\n/** Widget configuration for surface mounting */\nconst WidgetConfigZ = z\n  .object({\n    widgetId: z.string(),\n    props: z.record(z.unknown()).optional(),\n    priority: z.number().optional(),\n  })\n  .strict();\n\n/**\n * Tour step (schema-safe version).\n * Uses `z.any()` for the `action` field \u2014 the generator replaces it with a $ref.\n */\nconst TourStepForSchemaZ = z\n  .object({\n    id: z.string(),\n    action: z.any(),\n    route: z.string().optional(),\n    onAction: z.record(z.string()).optional(),\n  })\n  .passthrough();\n\n// ============================================================================\n// ScrollBehavior / ScrollLogicalPosition (DOM built-in types as Zod enums)\n// ============================================================================\n\nconst ScrollBehaviorZ = z.enum(['auto', 'smooth', 'instant']);\nconst ScrollLogicalPositionZ = z.enum(['start', 'center', 'end', 'nearest']);\n\n// ============================================================================\n// Core Action Schemas (18 total)\n// ============================================================================\n\n// --- Content Actions ---\n\nconst SetTextZ = z\n  .object({\n    kind: z.literal('content:setText'),\n    anchorId: AnchorIdZ,\n    text: z.string(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst SetAttrZ = z\n  .object({\n    kind: z.literal('content:setAttr'),\n    anchorId: AnchorIdZ,\n    attr: z.string(),\n    value: z.string(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst AddClassZ = z\n  .object({\n    kind: z.literal('content:addClass'),\n    anchorId: AnchorIdZ,\n    className: z.string(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst RemoveClassZ = z\n  .object({\n    kind: z.literal('content:removeClass'),\n    anchorId: AnchorIdZ,\n    className: z.string(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst SetStyleZ = z\n  .object({\n    kind: z.literal('content:setStyle'),\n    anchorId: AnchorIdZ,\n    styles: z.record(z.string()),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst InsertHtmlZ = z\n  .object({\n    kind: z.literal('content:insertHtml'),\n    anchorId: AnchorIdZ,\n    html: z.string(),\n    position: InsertPositionZ,\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\n// --- Overlay Actions ---\n\nconst HighlightZ = z\n  .object({\n    kind: z.literal('overlays:highlight'),\n    anchorId: AnchorIdZ,\n    style: HighlightStyleZ.optional(),\n    duration: z.number().optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst PulseZ = z\n  .object({\n    kind: z.literal('overlays:pulse'),\n    anchorId: AnchorIdZ,\n    duration: z.number().optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst BadgeZ = z\n  .object({\n    kind: z.literal('overlays:badge'),\n    anchorId: AnchorIdZ,\n    content: z.string(),\n    position: BadgePositionZ.optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst TooltipZ = z\n  .object({\n    kind: z.literal('overlays:tooltip'),\n    anchorId: AnchorIdZ,\n    content: TooltipContentZ,\n    trigger: TooltipTriggerZ.optional(),\n    placement: PlacementZ.optional(),\n    waitFor: z.string().optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst ModalZ = z\n  .object({\n    kind: z.literal('overlays:modal'),\n    content: ModalContentZ,\n    size: z.enum(['sm', 'md', 'lg']).optional(),\n    blocking: z.boolean().optional(),\n    scrim: z\n      .object({\n        opacity: z.number().min(0).max(1).optional(),\n      })\n      .strict()\n      .optional(),\n    dismiss: z\n      .object({\n        onEsc: z.boolean().optional(),\n        closeButton: z.boolean().optional(),\n        timeoutMs: z.number().min(0).optional(),\n      })\n      .strict()\n      .optional(),\n    ctaButtons: z.array(CtaButtonZ).optional(),\n    waitFor: z.string().optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\n// --- Navigation Actions ---\n\nconst ScrollToZ = z\n  .object({\n    kind: z.literal('navigation:scrollTo'),\n    anchorId: AnchorIdZ,\n    behavior: ScrollBehaviorZ.optional(),\n    block: ScrollLogicalPositionZ.optional(),\n    inline: ScrollLogicalPositionZ.optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst NavigateZ = z\n  .object({\n    kind: z.literal('navigation:navigate'),\n    url: z.string(),\n    target: z.enum(['_self', '_blank']).optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\n// --- Core Primitives ---\n\nconst MountWidgetZ = z\n  .object({\n    kind: z.literal('core:mountWidget'),\n    slot: z.string(),\n    widget: WidgetConfigZ,\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\nconst WaitZ = z\n  .object({\n    kind: z.literal('core:wait'),\n    durationMs: z.number().min(0).optional(),\n    event: z.string().optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\n/**\n * Sequence \u2014 executes actions serially.\n * `actions` uses `z.any()` as placeholder for recursive ActionStep refs.\n */\nconst SequenceZ = z\n  .object({\n    kind: z.literal('core:sequence'),\n    actions: z.array(z.any()),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\n/**\n * Parallel \u2014 executes actions concurrently.\n * `actions` uses `z.any()` as placeholder for recursive ActionStep refs.\n */\nconst ParallelZ = z\n  .object({\n    kind: z.literal('core:parallel'),\n    actions: z.array(z.any()),\n    waitFor: z.enum(['all', 'any']).optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .strict();\n\n/**\n * Tour \u2014 orchestrate sequential steps with cross-page state.\n * `steps` contains TourStepForSchemaZ which uses z.any() for step.action.\n */\nconst TourZ = z\n  .object({\n    kind: z.literal('core:tour'),\n    tourId: z.string(),\n    steps: z.array(TourStepForSchemaZ).min(1),\n    startStep: z.string().optional(),\n    autoStart: z.boolean().optional(),\n    label: z.string().optional(),\n  })\n  .extend(ActionActivationZ)\n  .passthrough();\n\n// ============================================================================\n// Export: Array for unified schema generation\n// ============================================================================\n\n/**\n * All 18 core action step schemas for unified JSON Schema generation.\n * The generator imports this array and converts each to JSON Schema,\n * then merges them into `$defs` and `actionStep.oneOf`.\n *\n * `defName` values match the existing `$defs` keys for backward compat.\n */\nexport const coreActionStepSchemas = [\n  { defName: 'setText', schema: SetTextZ },\n  { defName: 'setAttr', schema: SetAttrZ },\n  { defName: 'addClass', schema: AddClassZ },\n  { defName: 'removeClass', schema: RemoveClassZ },\n  { defName: 'setStyle', schema: SetStyleZ },\n  { defName: 'insertHtml', schema: InsertHtmlZ },\n  { defName: 'highlight', schema: HighlightZ },\n  { defName: 'pulse', schema: PulseZ },\n  { defName: 'badge', schema: BadgeZ },\n  { defName: 'tooltip', schema: TooltipZ },\n  { defName: 'modal', schema: ModalZ },\n  { defName: 'scrollTo', schema: ScrollToZ },\n  { defName: 'navigate', schema: NavigateZ },\n  { defName: 'mountWidget', schema: MountWidgetZ },\n  { defName: 'wait', schema: WaitZ },\n  { defName: 'sequence', schema: SequenceZ },\n  { defName: 'parallel', schema: ParallelZ },\n  { defName: 'tour', schema: TourZ },\n];\n\n// ============================================================================\n// Named Exports (for unit tests and direct usage)\n// ============================================================================\n\nexport {\n  // Sub-types\n  AnchorIdZ,\n  HighlightStyleZ,\n  BadgePositionZ,\n  PlacementZ,\n  CtaButtonZ,\n  TooltipContentZ,\n  ModalContentZ,\n  InsertPositionZ,\n  TooltipTriggerZ,\n  WidgetConfigZ,\n  TourStepForSchemaZ,\n  ScrollBehaviorZ,\n  ScrollLogicalPositionZ,\n  // Actions\n  SetTextZ,\n  SetAttrZ,\n  AddClassZ,\n  RemoveClassZ,\n  SetStyleZ,\n  InsertHtmlZ,\n  HighlightZ,\n  PulseZ,\n  BadgeZ,\n  TooltipZ,\n  ModalZ,\n  ScrollToZ,\n  NavigateZ,\n  MountWidgetZ,\n  WaitZ,\n  SequenceZ,\n  ParallelZ,\n  TourZ,\n};\n"],
+  "mappings": "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",
+  "names": []
+}