@syntrologie/runtime-sdk 2.0.0 → 2.0.1-canary.0

package/dist/actions/types.d.ts

@@ -4,9 +4,9 @@
  * Defines the types for the unified execution layer for interventions
  * (highlight, tooltip, badge, DOM modifications, navigation).
  */
-import type { Placement } from "@floating-ui/dom";
+import type { Placement } from '@floating-ui/dom';
 /** 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";
+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) */
 export type InlineSurfaceSlot = `inline:${string}`;
 /** Dynamic adjacent slot (positioned near anchor) */
@@ -25,7 +25,7 @@ export interface HighlightStyle {
     radiusPx?: number;
 }
 /** Badge position relative to anchor */
-export type BadgePosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type BadgePosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 /** CTA button configuration for tooltips/modals */
 export interface CtaButton {
     label: string;
@@ -48,9 +48,9 @@ export interface TooltipContent {
     ctaButtons?: CtaButton[];
 }
 /** Tooltip trigger mode */
-export type TooltipTrigger = "immediate" | "hover" | "click";
+export type TooltipTrigger = 'immediate' | 'hover' | 'click';
 /** Position where HTML/content should be inserted */
-export type InsertPosition = "before" | "after" | "prepend" | "append" | "replace";
+export type InsertPosition = 'before' | 'after' | 'prepend' | 'append' | 'replace';
 /** Widget configuration for surface mounting */
 export interface WidgetConfig {
     widgetId: string;
@@ -64,7 +64,7 @@ interface BaseAction {
 }
 /** Highlight an anchor element with spotlight effect */
 export interface HighlightAction extends BaseAction {
-    kind: "overlays:highlight";
+    kind: 'overlays:highlight';
     anchorId: string;
     style?: HighlightStyle;
     /** Duration in ms before auto-cleanup (for use in sequences) */
@@ -72,22 +72,22 @@ export interface HighlightAction extends BaseAction {
 }
 /** Pulse animation on an anchor element */
 export interface PulseAction extends BaseAction {
-    kind: "overlays:pulse";
+    kind: 'overlays:pulse';
     anchorId: string;
     duration?: number;
 }
 /** Add a badge near an anchor element */
 export interface BadgeAction extends BaseAction {
-    kind: "overlays:badge";
+    kind: 'overlays:badge';
     anchorId: string;
     content: string;
     position?: BadgePosition;
 }
 /** Tooltip lifecycle - when the action completes (for sequences) */
-export type TooltipWaitFor = "dismissed" | "cta-click" | `timeout:${number}`;
+export type TooltipWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
 /** Show a tooltip near an anchor element */
 export interface TooltipAction extends BaseAction {
-    kind: "overlays:tooltip";
+    kind: 'overlays:tooltip';
     anchorId: string;
     content: TooltipContent;
     trigger?: TooltipTrigger;
@@ -96,12 +96,12 @@ export interface TooltipAction extends BaseAction {
     waitFor?: TooltipWaitFor;
 }
 /** Modal lifecycle - when the action completes (for sequences) */
-export type ModalWaitFor = "dismissed" | "cta-click" | `timeout:${number}`;
+export type ModalWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
 /** Show a centered modal dialog */
 export interface ModalAction extends BaseAction {
-    kind: "overlays:modal";
+    kind: 'overlays:modal';
     content: ModalContent;
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
     blocking?: boolean;
     scrim?: {
         opacity?: number;
@@ -117,51 +117,51 @@ export interface ModalAction extends BaseAction {
 }
 /** Insert HTML content relative to anchor */
 export interface InsertHtmlAction extends BaseAction {
-    kind: "content:insertHtml";
+    kind: 'content:insertHtml';
     anchorId: string;
     html: string;
     position: InsertPosition;
 }
 /** Set text content of an anchor */
 export interface SetTextAction extends BaseAction {
-    kind: "content:setText";
+    kind: 'content:setText';
     anchorId: string;
     text: string;
 }
 /** Set an attribute on an anchor */
 export interface SetAttrAction extends BaseAction {
-    kind: "content:setAttr";
+    kind: 'content:setAttr';
     anchorId: string;
     attr: string;
     value: string;
 }
 /** Add a CSS class to an anchor */
 export interface AddClassAction extends BaseAction {
-    kind: "content:addClass";
+    kind: 'content:addClass';
     anchorId: string;
     className: string;
 }
 /** Remove a CSS class from an anchor */
 export interface RemoveClassAction extends BaseAction {
-    kind: "content:removeClass";
+    kind: 'content:removeClass';
     anchorId: string;
     className: string;
 }
 /** Set inline styles on an anchor */
 export interface SetStyleAction extends BaseAction {
-    kind: "content:setStyle";
+    kind: 'content:setStyle';
     anchorId: string;
     styles: Record<string, string>;
 }
 /** Mount a widget to a surface slot */
 export interface MountWidgetAction extends BaseAction {
-    kind: "core:mountWidget";
+    kind: 'core:mountWidget';
     slot: SurfaceSlot;
     widget: WidgetConfig;
 }
 /** Scroll to an anchor element */
 export interface ScrollToAction extends BaseAction {
-    kind: "navigation:scrollTo";
+    kind: 'navigation:scrollTo';
     anchorId: string;
     behavior?: ScrollBehavior;
     block?: ScrollLogicalPosition;
@@ -169,13 +169,13 @@ export interface ScrollToAction extends BaseAction {
 }
 /** Navigate to a URL */
 export interface NavigateAction extends BaseAction {
-    kind: "navigation:navigate";
+    kind: 'navigation:navigate';
     url: string;
-    target?: "_self" | "_blank";
+    target?: '_self' | '_blank';
 }
 /** Wait for a duration or an event on the EventBus */
 export interface WaitAction extends BaseAction {
-    kind: "core:wait";
+    kind: 'core:wait';
     /** Wait for a specific duration in milliseconds */
     durationMs?: number;
     /** Wait for an event on the EventBus */
@@ -183,26 +183,26 @@ export interface WaitAction extends BaseAction {
 }
 /** Execute actions in sequence, awaiting each one's completion */
 export interface SequenceAction extends BaseAction {
-    kind: "core:sequence";
+    kind: 'core:sequence';
     actions: ActionStep[];
 }
 /** Execute actions in parallel */
 export interface ParallelAction extends BaseAction {
-    kind: "core:parallel";
+    kind: 'core:parallel';
     actions: ActionStep[];
     /** How to determine completion: "all" waits for all, "any" completes when first finishes */
-    waitFor?: "all" | "any";
+    waitFor?: 'all' | 'any';
 }
 /** Tour step with route + action mapping */
 export interface TourStep {
     id: string;
     action: ActionStep;
     route?: string;
-    onAction?: Record<string, string | "end">;
+    onAction?: Record<string, string | 'end'>;
 }
 /** Orchestrate sequential steps with cross-page state */
 export interface TourAction extends BaseAction {
-    kind: "core:tour";
+    kind: 'core:tour';
     tourId: string;
     steps: TourStep[];
     startStep?: string;
@@ -211,9 +211,9 @@ export interface TourAction extends BaseAction {
 /** Union of all action step types */
 export type ActionStep = HighlightAction | PulseAction | BadgeAction | TooltipAction | ModalAction | InsertHtmlAction | SetTextAction | SetAttrAction | AddClassAction | RemoveClassAction | SetStyleAction | MountWidgetAction | ScrollToAction | NavigateAction | WaitAction | SequenceAction | ParallelAction | TourAction;
 /** Extract action kind literal types */
-export type ActionKind = ActionStep["kind"];
+export type ActionKind = ActionStep['kind'];
 /** State of an action */
-export type ActionState = "pending" | "applied" | "reverted" | "failed";
+export type ActionState = 'pending' | 'applied' | 'reverted' | 'failed';
 /** Handle returned when an action is applied */
 export interface ActionHandle {
     /** Unique ID for this action instance */
@@ -353,27 +353,27 @@ export interface ActionEngine {
 }
 /** Renderable content types for surfaces */
 export type RenderableContent = {
-    type: "react";
+    type: 'react';
     component: unknown;
     props?: Record<string, unknown>;
 } | {
-    type: "html";
+    type: 'html';
     content: string;
 } | {
-    type: "widget";
+    type: 'widget';
     widgetId: string;
     config?: Record<string, unknown>;
 } | {
-    type: "custom";
+    type: 'custom';
     mount: (container: HTMLElement) => () => void;
 };
 /** Mount options for surfaces */
 export interface MountOptions {
     priority?: number;
     exclusive?: boolean;
-    animation?: "fade" | "slide" | "scale" | "none";
+    animation?: 'fade' | 'slide' | 'scale' | 'none';
     position?: {
-        placement: Placement | "auto";
+        placement: Placement | 'auto';
         offset?: {
             x: number;
             y: number;

package/dist/actions/validation.d.ts

@@ -3,7 +3,7 @@
  *
  * Validates action steps before execution.
  */
-import type { ActionStep, ValidationResult } from "./types";
+import type { ActionStep, ValidationResult } from './types';
 /**
  * Validate an action step.
  */