@syntrologie/runtime-sdk 1.0.1-canary.3 → 2.0.0-canary.1

package/dist/surfaces/positioning.js

@@ -0,0 +1,231 @@
+/**
+ * Surfaces Positioning
+ *
+ * Handles positioning for different slot types using CSS for static slots
+ * and Floating UI for adjacent slots.
+ */
+import { computePosition, autoUpdate, offset, flip, shift, } from "@floating-ui/dom";
+import { getSlotType } from "./types";
+/**
+ * CSS styles for static surface slots.
+ */
+export const STATIC_SLOT_STYLES = {
+    drawer_right: {
+        position: "fixed",
+        top: "0",
+        right: "0",
+        bottom: "0",
+        width: "360px",
+        maxWidth: "90vw",
+    },
+    drawer_left: {
+        position: "fixed",
+        top: "0",
+        left: "0",
+        bottom: "0",
+        width: "360px",
+        maxWidth: "90vw",
+    },
+    drawer_bottom: {
+        position: "fixed",
+        left: "0",
+        right: "0",
+        bottom: "0",
+        maxHeight: "50vh",
+    },
+    overlay_center: {
+        position: "fixed",
+        top: "50%",
+        left: "50%",
+        transform: "translate(-50%, -50%)",
+        maxWidth: "90vw",
+        maxHeight: "90vh",
+    },
+    overlay_corner_br: {
+        position: "fixed",
+        bottom: "16px",
+        right: "16px",
+        maxWidth: "400px",
+        maxHeight: "80vh",
+    },
+    overlay_corner_bl: {
+        position: "fixed",
+        bottom: "16px",
+        left: "16px",
+        maxWidth: "400px",
+        maxHeight: "80vh",
+    },
+    toast_top: {
+        position: "fixed",
+        top: "16px",
+        left: "50%",
+        transform: "translateX(-50%)",
+        maxWidth: "90vw",
+    },
+    toast_bottom: {
+        position: "fixed",
+        bottom: "16px",
+        left: "50%",
+        transform: "translateX(-50%)",
+        maxWidth: "90vw",
+    },
+};
+/**
+ * Animation keyframes for different animation types.
+ */
+export const ANIMATION_KEYFRAMES = {
+    fade: [
+        { opacity: 0 },
+        { opacity: 1 },
+    ],
+    slide: [
+        { opacity: 0, transform: "translateY(10px)" },
+        { opacity: 1, transform: "translateY(0)" },
+    ],
+    scale: [
+        { opacity: 0, transform: "scale(0.95)" },
+        { opacity: 1, transform: "scale(1)" },
+    ],
+    none: [],
+};
+/**
+ * Animation options.
+ */
+export const ANIMATION_OPTIONS = {
+    duration: 200,
+    easing: "cubic-bezier(0.16, 1, 0.3, 1)",
+    fill: "forwards",
+};
+/**
+ * Apply static slot positioning to an element.
+ */
+export function applyStaticSlotStyles(element, slot, constraints) {
+    const styles = STATIC_SLOT_STYLES[slot];
+    Object.assign(element.style, styles);
+    // Apply constraints
+    if (constraints) {
+        if (constraints.maxWidth)
+            element.style.maxWidth = constraints.maxWidth;
+        if (constraints.maxHeight)
+            element.style.maxHeight = constraints.maxHeight;
+        if (constraints.minWidth)
+            element.style.minWidth = constraints.minWidth;
+        if (constraints.minHeight)
+            element.style.minHeight = constraints.minHeight;
+    }
+}
+/**
+ * Set up adjacent slot positioning using Floating UI.
+ * Returns a cleanup function.
+ */
+export function setupAdjacentPositioning(container, anchorEl, config) {
+    const placement = config.placement === "auto" ? "bottom" : config.placement;
+    const middleware = [
+        offset(config.offset ? { mainAxis: config.offset.y, crossAxis: config.offset.x } : 8),
+    ];
+    if (config.flip !== false) {
+        middleware.push(flip());
+    }
+    if (config.shift !== false) {
+        middleware.push(shift({ padding: 8 }));
+    }
+    // Set initial position style
+    container.style.position = "absolute";
+    container.style.zIndex = "2147483646";
+    const cleanup = autoUpdate(anchorEl, container, async () => {
+        const { x, y, strategy } = await computePosition(anchorEl, container, {
+            placement,
+            middleware,
+        });
+        Object.assign(container.style, {
+            position: strategy,
+            left: `${x}px`,
+            top: `${y}px`,
+        });
+    });
+    return cleanup;
+}
+/**
+ * Set up inline slot positioning.
+ * Inline slots render content inside the anchor element.
+ */
+export function setupInlinePositioning(container, anchorEl, position = "append") {
+    // Reset container positioning (inline is flow-based)
+    container.style.position = "relative";
+    container.style.display = "inline-block";
+    if (position === "prepend") {
+        anchorEl.insertBefore(container, anchorEl.firstChild);
+    }
+    else {
+        anchorEl.appendChild(container);
+    }
+    return () => {
+        container.remove();
+    };
+}
+/**
+ * Play enter animation on an element.
+ */
+export function playEnterAnimation(element, animationType) {
+    if (animationType === "none" || ANIMATION_KEYFRAMES[animationType].length === 0) {
+        return null;
+    }
+    return element.animate(ANIMATION_KEYFRAMES[animationType], ANIMATION_OPTIONS);
+}
+/**
+ * Play exit animation on an element.
+ * Returns a promise that resolves when the animation completes.
+ */
+export function playExitAnimation(element, animationType) {
+    if (animationType === "none" || ANIMATION_KEYFRAMES[animationType].length === 0) {
+        return Promise.resolve();
+    }
+    const keyframes = [...ANIMATION_KEYFRAMES[animationType]].reverse();
+    const animation = element.animate(keyframes, ANIMATION_OPTIONS);
+    return new Promise((resolve) => {
+        animation.onfinish = () => resolve();
+        animation.oncancel = () => resolve();
+    });
+}
+/**
+ * Create and style a surface container element.
+ */
+export function createSurfaceContainer(slot, id) {
+    const container = document.createElement("div");
+    container.setAttribute("data-syntro-surface", slot);
+    container.setAttribute("data-syntro-mount-id", id);
+    container.className = "syntro-surface";
+    // Base styles for all surfaces
+    Object.assign(container.style, {
+        pointerEvents: "auto",
+        boxSizing: "border-box",
+        overflow: "auto",
+    });
+    return container;
+}
+/**
+ * Get the z-index for a slot type.
+ */
+export function getSlotZIndex(slot) {
+    const type = getSlotType(slot);
+    switch (type) {
+        case "static":
+            // Drawers and overlays
+            if (slot.startsWith("drawer"))
+                return 2147483640;
+            if (slot.startsWith("overlay"))
+                return 2147483642;
+            if (slot.startsWith("toast"))
+                return 2147483644;
+            return 2147483640;
+        case "inline":
+            // Inline content doesn't need high z-index
+            return 1;
+        case "adjacent":
+            // Adjacent content needs to be above page content
+            return 2147483638;
+        default:
+            return 2147483640;
+    }
+}
+//# sourceMappingURL=positioning.js.map

package/dist/surfaces/positioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.js","sourceRoot":"","sources":["../../src/surfaces/positioning.ts"],"names":[],"mappings":"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"}

package/dist/surfaces/types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Surfaces Types
+ *
+ * Defines types for the managed surface system that renders UI into named slots.
+ * Surfaces handles layout, stacking, animations, and priority-based arbitration.
+ */
+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";
+/** Dynamic inline slot (rendered inside anchor) */
+export type InlineSurfaceSlot = `inline:${string}`;
+/** Dynamic adjacent slot (positioned near anchor) */
+export type AdjacentSurfaceSlot = `adjacent:${string}`;
+/** All surface slot types */
+export type SurfaceSlot = StaticSurfaceSlot | InlineSurfaceSlot | AdjacentSurfaceSlot;
+/** React component content */
+export interface ReactContent {
+    type: "react";
+    component: unknown;
+    props?: Record<string, unknown>;
+}
+/** HTML string content */
+export interface HtmlContent {
+    type: "html";
+    content: string;
+}
+/** Widget reference content */
+export interface WidgetContent {
+    type: "widget";
+    widgetId: string;
+    config?: Record<string, unknown>;
+}
+/** Custom mount function content */
+export interface CustomContent {
+    type: "custom";
+    mount: (container: HTMLElement) => () => void;
+}
+/** Union of all renderable content types */
+export type RenderableContent = ReactContent | HtmlContent | WidgetContent | CustomContent;
+/** Position configuration for adjacent slots */
+export interface PositionConfig {
+    placement: Placement | "auto";
+    offset?: {
+        x: number;
+        y: number;
+    };
+    flip?: boolean;
+    shift?: boolean;
+}
+/** Size constraints for mounted content */
+export interface MountConstraints {
+    maxWidth?: string;
+    maxHeight?: string;
+    minWidth?: string;
+    minHeight?: string;
+}
+/** Animation types for enter/exit */
+export type AnimationType = "fade" | "slide" | "scale" | "none";
+/** Options when mounting content to a surface */
+export interface MountOptions {
+    /** Priority for conflict resolution (higher wins) */
+    priority?: number;
+    /** Whether to unmount other content in the same slot */
+    exclusive?: boolean;
+    /** Animation for enter/exit */
+    animation?: AnimationType;
+    /** Position configuration for adjacent slots */
+    position?: PositionConfig;
+    /** Size constraints */
+    constraints?: MountConstraints;
+    /** ID of the adaptive mounting this content */
+    adaptiveId?: string;
+    /** Whether to auto-unmount on route change */
+    autoUnmountOnRouteChange?: boolean;
+}
+/** Handle returned when content is mounted */
+export interface MountHandle {
+    /** Unique ID for this mount */
+    id: string;
+    /** Update the content */
+    update: (content: RenderableContent) => void;
+    /** Update mount options */
+    setOptions: (opts: Partial<MountOptions>) => void;
+    /** Unmount the content */
+    unmount: () => void;
+    /** Check if still mounted */
+    isMounted: () => boolean;
+    /** Get the DOM container element */
+    getContainer: () => HTMLElement | null;
+}
+/** State of a surface slot */
+export interface SurfaceState {
+    /** The slot identifier */
+    slot: SurfaceSlot;
+    /** Whether the slot is currently occupied */
+    occupied: boolean;
+    /** Priority of the current content (if occupied) */
+    currentPriority?: number;
+    /** Adaptive ID that owns current content */
+    currentAdaptiveId?: string;
+    /** Total number of mounts to this slot this session */
+    mountCount: number;
+    /** ID of the current mount (if occupied) */
+    currentMountId?: string;
+}
+/** Callback for surface state changes */
+export type SurfaceChangeCallback = (state: SurfaceState) => void;
+/** Widget registry interface (subset needed by Surfaces) */
+export interface SurfacesWidgetRegistry {
+    has: (id: string) => boolean;
+    mount: (id: string, container: HTMLElement, config?: Record<string, unknown>) => {
+        unmount: () => void;
+        update: (config?: Record<string, unknown>) => void;
+    };
+}
+/** Options for creating a Surfaces instance */
+export interface SurfacesOptions {
+    /** Overlay root element for rendering */
+    overlayRoot: HTMLElement;
+    /** Event bus for publishing surface events */
+    eventBus?: {
+        publish: (name: string, props?: Record<string, unknown>) => void;
+    };
+    /** Function to resolve anchor IDs to elements (for inline/adjacent slots) */
+    anchorResolver?: (anchorId: string) => HTMLElement | null;
+    /** Default animation type */
+    defaultAnimation?: AnimationType;
+    /** Widget registry for resolving widget content */
+    widgetRegistry?: SurfacesWidgetRegistry;
+}
+/** The Surfaces interface */
+export interface Surfaces {
+    /** Mount content to a surface slot */
+    mount: (slot: SurfaceSlot, content: RenderableContent, opts?: MountOptions) => MountHandle;
+    /** Get the current state of a slot */
+    getState: (slot: SurfaceSlot) => SurfaceState;
+    /** Subscribe to state changes for a slot */
+    onStateChange: (slot: SurfaceSlot, fn: SurfaceChangeCallback) => () => void;
+    /** Check if content can be mounted to a slot */
+    canMount: (slot: SurfaceSlot, priority?: number) => boolean;
+    /** Clean up all mounted surfaces */
+    destroy: () => void;
+}
+/** Resolved internal options (with defaults applied) */
+export interface InternalMountOptions {
+    priority: number;
+    exclusive: boolean;
+    animation: AnimationType;
+    position: PositionConfig;
+    constraints: MountConstraints;
+    adaptiveId?: string;
+    autoUnmountOnRouteChange: boolean;
+}
+/** Internal mount entry */
+export interface InternalMountEntry {
+    id: string;
+    slot: SurfaceSlot;
+    content: RenderableContent;
+    options: InternalMountOptions;
+    container: HTMLElement;
+    cleanup?: () => void;
+    mountedAt: number;
+}
+/** Slot type classifier */
+export declare function getSlotType(slot: SurfaceSlot): "static" | "inline" | "adjacent";
+/** Extract anchor ID from inline/adjacent slots */
+export declare function getSlotAnchorId(slot: SurfaceSlot): string | null;

package/dist/surfaces/types.js

@@ -0,0 +1,23 @@
+/**
+ * Surfaces Types
+ *
+ * Defines types for the managed surface system that renders UI into named slots.
+ * Surfaces handles layout, stacking, animations, and priority-based arbitration.
+ */
+/** Slot type classifier */
+export function getSlotType(slot) {
+    if (slot.startsWith("inline:"))
+        return "inline";
+    if (slot.startsWith("adjacent:"))
+        return "adjacent";
+    return "static";
+}
+/** Extract anchor ID from inline/adjacent slots */
+export function getSlotAnchorId(slot) {
+    if (slot.startsWith("inline:"))
+        return slot.slice(7);
+    if (slot.startsWith("adjacent:"))
+        return slot.slice(9);
+    return null;
+}
+//# sourceMappingURL=types.js.map

package/dist/surfaces/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/surfaces/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuPH,2BAA2B;AAC3B,MAAM,UAAU,WAAW,CACzB,IAAiB;IAEjB,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChD,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,UAAU,CAAC;IACpD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,IAAiB;IAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/telemetry/adapters/posthog.d.ts

@@ -53,6 +53,11 @@ export interface PostHogAdapterOptions {
      * Used to update GrowthBook attributes with segment membership.
      */
     onFeatureFlagsLoaded?: (flags: Record<string, boolean | string>) => void;
+    /**
+     * Callback when any event is captured by PostHog.
+     * Used to feed events into the EventBus for runtime decisions.
+     */
+    onCapture?: (eventName: string, properties?: Record<string, unknown>) => void;
 }
 interface CanvasAnalyticsPayload extends Properties {
     rectangleId?: string;
@@ -65,6 +70,7 @@ export declare class PostHogAdapter implements TelemetryClient {
     private readonly options;
     private client?;
     private featureFlagsCallback?;
+    private captureCallback?;
     constructor(options?: PostHogAdapterOptions);
     /**
      * Get all feature flags from PostHog.

package/dist/telemetry/adapters/posthog.js

@@ -8,6 +8,7 @@ export class PostHogAdapter {
         this.options = options;
         this.client = options.client;
         this.featureFlagsCallback = options.onFeatureFlagsLoaded;
+        this.captureCallback = options.onCapture;
         if (!this.client && typeof window !== "undefined" && options.apiKey) {
             this.client = posthog;
             // Determine if we should enable feature flags (for segment membership)
@@ -49,6 +50,14 @@ export class PostHogAdapter {
                             }
                         });
                     }
+                    // Wire up capture callback to feed events into EventBus
+                    if (this.captureCallback) {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        ph.on('eventCaptured', (eventName, properties) => {
+                            var _a;
+                            (_a = this.captureCallback) === null || _a === void 0 ? void 0 : _a.call(this, eventName, properties);
+                        });
+                    }
                 },
             });
         }

package/dist/telemetry/adapters/posthog.js.map

@@ -1 +1 @@
-{"version":3,"file":"posthog.js","sourceRoot":"","sources":["../../../src/telemetry/adapters/posthog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"posthog.js","sourceRoot":"","sources":["../../../src/telemetry/adapters/posthog.ts"],"names":[],"mappings":"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"}

package/dist/types-only.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Types-only export for app packages.
+ *
+ * This file re-exports action types without importing any runtime code,
+ * allowing app packages to import types without circular dependency issues.
+ *
+ * Apps should import from "@syntrologie/runtime-sdk/types" instead of
+ * the main entry point when they only need type definitions.
+ */
+/**
+ * Props passed to editor panel components.
+ */
+export interface EditorPanelProps {
+    /** The current config for this app's portion */
+    config: Record<string, unknown>;
+    /** Callback when config changes */
+    onChange: (config: Record<string, unknown>) => void;
+    /** Editor utilities */
+    editor: {
+        /** Mark the editor as dirty (has unsaved changes) */
+        setDirty: (dirty: boolean) => void;
+        /** Navigate back to home */
+        navigateHome: () => Promise<boolean>;
+        /** Save the current config */
+        save: () => Promise<void>;
+        /** Publish the current config */
+        publish: (captureScreenshot?: boolean) => Promise<void>;
+    };
+    /** Platform client for API calls (optional) */
+    platformClient?: unknown;
+}
+export type { StaticSurfaceSlot, InlineSurfaceSlot, AdjacentSurfaceSlot, SurfaceSlot, HighlightStyle, BadgePosition, TooltipContent, TooltipTrigger, InsertPosition, WidgetConfig, HighlightAction, PulseAction, BadgeAction, TooltipAction, InsertHtmlAction, SetTextAction, SetAttrAction, AddClassAction, RemoveClassAction, SetStyleAction, MountWidgetAction, ScrollToAction, NavigateAction, ActionStep, ActionKind, ActionState, ActionHandle, BatchActionHandle, ActiveAction, ValidationError, ValidationWarning, ValidationResult, ExecutorCleanup, ExecutorUpdate, ExecutorResult, ActionExecutor, ExecutorContext, } from "./actions/types";

package/dist/types-only.js

@@ -0,0 +1,11 @@
+/**
+ * Types-only export for app packages.
+ *
+ * This file re-exports action types without importing any runtime code,
+ * allowing app packages to import types without circular dependency issues.
+ *
+ * Apps should import from "@syntrologie/runtime-sdk/types" instead of
+ * the main entry point when they only need type definitions.
+ */
+export {};
+//# sourceMappingURL=types-only.js.map

package/dist/types-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-only.js","sourceRoot":"","sources":["../src/types-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+export type { ActionStep } from './actions/types';
 /**
  * Props passed to every tile component when mounted
  */
@@ -294,10 +295,9 @@ export interface TileConfig {
      */
     activation?: import("./decisions/types").ActivationConfig;
 }
-import type { Patch } from "./hostPatcher/core/types";
+import type { ActionStep } from "./actions/types";
 /**
  * Theme configuration for the SmartCanvas overlay.
- * These values are typically set from workspace settings after style selection.
  */
 export interface CanvasThemeConfig {
     name?: string;
@@ -310,35 +310,47 @@ export interface CanvasThemeConfig {
     borderRadius?: string;
     position?: 'left' | 'right';
 }
+/**
+ * Launcher button configuration.
+ */
 export interface LauncherConfig {
-    /** Label shown on the launcher button (default: "Adaptives") */
     label?: string;
-    /** Whether to animate the launcher to draw attention */
     animate?: boolean;
-    /** Animation style: "pulse" (default), "bounce", "glow" */
     animationStyle?: "pulse" | "bounce" | "glow";
 }
+/**
+ * Route filtering - control where canvas appears.
+ */
 export interface RoutesConfig {
-    /** Routes where the canvas should NOT appear (e.g., ["/login", "/signup"]) */
     exclude?: string[];
-    /** If specified, canvas ONLY appears on these routes */
     include?: string[];
 }
+/**
+ * Canvas configuration response.
+ *
+ * This is the complete config format. Actions are the single mechanism
+ * for all interventions: DOM modifications, tooltips, highlights, modals.
+ */
 export interface CanvasConfigResponse {
+    /** Tiles to display in the canvas drawer */
     tiles: TileConfig[];
+    /**
+     * Actions to execute.
+     * This is the unified intervention format. Every DOM change, tooltip,
+     * highlight, or modal is an ActionStep.
+     */
+    actions: ActionStep[];
+    /** When the config was fetched */
     fetchedAt: string;
+    /** Optional version string for cache invalidation */
     configVersion?: string;
+    /** Display title for the canvas */
     canvasTitle?: string;
-    patches?: Patch[];
-    /** @deprecated Use overlayRecipes instead */
-    overlayRecipe?: import('./overlays/types').CanvasRecipe;
-    /** Multiple overlay recipes (tours) */
-    overlayRecipes?: import('./overlays/types').CanvasRecipe[];
-    /** SmartCanvas theme configuration from workspace settings */
+    /** Theme configuration */
     theme?: CanvasThemeConfig;
     /** Launcher button configuration */
     launcher?: LauncherConfig;
-    /** Route filtering - control where canvas appears */
+    /** Route filtering */
     routes?: RoutesConfig;
 }
 export type CanvasConfigFetcher = () => Promise<CanvasConfigResponse>;

package/dist/types.js

@@ -1,5 +1,5 @@
 // =============================================================================
-// TILE COMPONENT API
+// RE-EXPORT ACTION TYPES
 // =============================================================================
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF"}