@syntrologie/runtime-sdk 1.0.1 → 2.0.0

package/README.md

@@ -2,19 +2,50 @@
 
 ## Smart Canvas SDK (React + Shadow DOM)
 
-The SDK now ships a framework-agnostic `<smart-canvas>` custom element with an **open shadow root**. We still render everything with React, but the canvas is encapsulated so host Tailwind configs, resets, or stacking contexts can’t break the UI.
+The SDK ships a framework-agnostic `<smart-canvas>` custom element with an **open shadow root**. We render everything with React, but the canvas is encapsulated so host Tailwind configs, resets, or stacking contexts can't break the UI.
 
-### What’s Included
+### What's Included
 
 - `SmartCanvasElement` – the custom element that owns the shadow DOM, overlay root, and controller.
 - `SmartCanvasApp` – the React tree (overlay, rectangles, toggle) you portal into the shadow.
 - `SmartCanvasPortal` – helper for React hosts to portal their tree (and context) into the element mount.
 - `createSmartCanvas` – imperative API (`window.SmartCanvas.create`) for non-React hosts.
+- **ActionEngine** – unified execution layer for interventions (highlight, tooltip, badge, DOM modifications)
+- **Surfaces** – managed surface system for rendering UI into named slots
 - GrowthBook/PostHog wrappers, hooks, rectangle components, and wheel remain available.
 
-### Installation
+---
 
-#### NPM/Yarn
+## Quick Start
+
+```typescript
+import { Syntro } from "@syntrologie/runtime-sdk";
+
+const { runtime } = await Syntro.init({ token: "syn_..." });
+
+// Change a headline
+const handle = await runtime.actions.apply({
+  kind: "set_text",
+  anchorId: "h1.hero-title",
+  text: "Welcome to Our New Experience"
+});
+
+// Show a toast notification
+const toast = runtime.surfaces.mount("toast_top", {
+  type: "html",
+  content: '<div class="toast">Changes applied!</div>'
+});
+
+// Later: revert and cleanup
+await handle.revert();
+toast.unmount();
+```
+
+---
+
+## Installation
+
+### NPM/Yarn
 
 ```bash
 npm install @syntrologie/smart-canvas-sdk
@@ -22,7 +53,7 @@ npm install @syntrologie/smart-canvas-sdk
 yarn add @syntrologie/smart-canvas-sdk
 ```
 
-#### CDN
+### CDN
 
 For quick setup without a build process:
 
@@ -39,18 +70,96 @@ For quick setup without a build process:
 </script>
 ```
 
-#### Local Development
+### Local Development
 
 ```bash
-cd tech-core/sdks/shadow-canvas
+cd tech-core/sdks/runtime-sdk
 npm run build
-cd ../../tax_landing_page
-npm install @syntrologie/smart-canvas-sdk@file:../tech-core/sdks/shadow-canvas
 ```
 
-Rebuild and reinstall whenever the SDK changes.
+---
+
+## Core Modules
+
+### ActionEngine
+
+The ActionEngine provides a unified API for applying reversible interventions:
+
+```typescript
+// Visual actions
+await runtime.actions.apply({ kind: "highlight", anchorId: "#cta", style: { color: "#4f46e5" } });
+await runtime.actions.apply({ kind: "tooltip", anchorId: "#help", content: { body: "Click for help" } });
+await runtime.actions.apply({ kind: "badge", anchorId: "#inbox", content: "3" });
+await runtime.actions.apply({ kind: "pulse", anchorId: "#notification" });
+
+// DOM actions
+await runtime.actions.apply({ kind: "set_text", anchorId: "h1", text: "New headline" });
+await runtime.actions.apply({ kind: "insert_html", anchorId: ".cta", html: "<span>NEW</span>", position: "append" });
+await runtime.actions.apply({ kind: "add_class", anchorId: ".card", className: "highlighted" });
+await runtime.actions.apply({ kind: "set_style", anchorId: ".hero", styles: { "background": "#1e40af" } });
+
+// Navigation actions
+await runtime.actions.apply({ kind: "scroll_to", anchorId: "#pricing" });
+await runtime.actions.apply({ kind: "navigate", url: "/signup" });
+
+// Batch with atomic rollback
+const batch = await runtime.actions.applyBatch([
+  { kind: "set_text", anchorId: "h1", text: "New" },
+  { kind: "highlight", anchorId: "h1" }
+]);
+await batch.revertAll();
+```
+
+### Surfaces
 
-### Using the Custom Element (React Host)
+The Surfaces system manages UI rendering into named slots:
+
+```typescript
+// Static slots
+runtime.surfaces.mount("toast_top", { type: "html", content: "<div>Saved!</div>" });
+runtime.surfaces.mount("drawer_right", { type: "html", content: "<div>Settings</div>" });
+runtime.surfaces.mount("overlay_center", { type: "html", content: "<div>Modal</div>" });
+
+// Dynamic slots (positioned relative to anchors)
+runtime.surfaces.mount("inline:product-card", { type: "html", content: "<span>SALE</span>" });
+runtime.surfaces.mount("adjacent:help-icon", { type: "html", content: "<div>Help text</div>" }, {
+  position: { placement: "bottom" }
+});
+
+// Priority-based arbitration
+runtime.surfaces.mount("toast_top", content, { priority: 10 }); // Higher priority wins
+```
+
+**Available Static Slots:**
+| Slot | Position |
+|------|----------|
+| `drawer_right` | Right edge, full height |
+| `drawer_left` | Left edge, full height |
+| `drawer_bottom` | Bottom edge, full width |
+| `overlay_center` | Centered modal |
+| `overlay_corner_br` | Bottom-right corner |
+| `overlay_corner_bl` | Bottom-left corner |
+| `toast_top` | Top center |
+| `toast_bottom` | Bottom center |
+
+### Runtime
+
+The runtime provides access to all core providers:
+
+```typescript
+const { runtime } = await Syntro.init({ token: "syn_..." });
+
+runtime.telemetry    // Event tracking (PostHog)
+runtime.context      // Page/session/viewport state
+runtime.events       // Normalized event stream
+runtime.state        // Persistent storage
+runtime.actions      // ActionEngine
+runtime.surfaces     // Surfaces
+```
+
+---
+
+## Using the Custom Element (React Host)
 
 ```tsx
 import {
@@ -90,7 +199,9 @@ function SmartCanvasBridge() {
 }
 ```
 
-### Using the Imperative API (Plain JS Host)
+---
+
+## Using the Imperative API (Plain JS Host)
 
 When using via CDN, the SDK is available as `window.SyntrologieSDK`:
 
@@ -109,77 +220,189 @@ await window.SmartCanvas?.create({
 });
 ```
 
-### Styling & Overlays
+---
 
-- Fonts, colors, and CSS variables (`--sc-surface`, `--sc-fg`, etc.) are inherited from the host. Tokens can be overridden via `setTokens` or standard CSS:
-  - `--syntro-tooltip-bg`, `--syntro-tooltip-fg`, `--syntro-tooltip-radius`, `--syntro-tooltip-shadow`
-  - `--syntro-ring`, `--syntro-spotlight-backdrop` for highlights
-- A scoped reset is injected via `adoptedStyleSheets` (fallbacks to `<style>`).
-- Tooltips/popovers should use the Popover API or Floating UI with the exposed overlay root (`element.getOverlayRoot()`).
+## Event System
 
-### Analytics Events
+The EventBus provides a unified stream of normalized events:
 
-The `createSyntroTelemetry` client emits:
+```typescript
+// Subscribe to events
+runtime.events.subscribe({ names: ["ui.click", "action.applied"] }, (event) => {
+  console.log(event.name, event.props);
+});
 
-| Event | Description |
-| --- | --- |
-| `shadow_canvas_opened` / `shadow_canvas_closed` | Toggle button interactions. |
-| `shadow_canvas_rectangle_viewed` | A rectangle becomes visible (overlay grid & wheel). |
-| `shadow_canvas_action` | CTA click, chatbot send, overlay events (tooltips, dismiss, anchor missing). |
+// Standard events
+// UI: ui.click, ui.scroll, ui.input, ui.submit
+// Navigation: nav.page_view, nav.page_leave
+// Canvas: canvas.opened, canvas.closed, tile.viewed, tile.action
+// Actions: action.applied, action.reverted, action.failed
+// Surfaces: surface.mounted, surface.unmounted
+```
 
-### Rectangle Config (unchanged)
+---
 
-The experimentation service still returns the same payload (`rectangles`, `style`, `content`, optional `experiment` metadata). Top-level fields now include optional `canvasTitle` so host teams can rename the overlay without code changes. See `src/types.ts` for the exact contract.
+## State Management
 
-### Schema & Validation Tool
+```typescript
+// Dismissals
+runtime.state.dismissals.mark("promo-banner");
+if (runtime.state.dismissals.isDismissed("promo-banner")) { ... }
 
-- JSON schema lives at `schema/canvas-config.schema.json` (published with the package).
-- Validate a config file locally:
+// Cooldowns
+runtime.state.cooldowns.set("upsell", 86400000); // 24h
+if (runtime.state.cooldowns.isActive("upsell")) { ... }
 
-```bash
-cd tech-core/sdks/shadow-canvas
-npm run validate-config -- ../../tax_landing_page/public/smart-canvas-demo.json
+// Frequency caps
+runtime.state.frequency.increment("tooltip-shown");
+if (runtime.state.frequency.count("tooltip-shown") >= 3) { ... }
 ```
 
-The script evaluates structure/required fields without third-party dependencies so CI and content authors can catch issues early.
+---
+
+## Decision Strategies
+
+Control when adaptives activate:
+
+```typescript
+const result = runtime.evaluateSync({
+  type: "rules",
+  rules: [
+    {
+      conditions: [
+        { type: "page_url", pattern: "/pricing*" },
+        { type: "viewport", minWidth: 768 },
+        { type: "dismissed", key: "promo", inverted: true }
+      ],
+      value: true
+    }
+  ],
+  default: false
+});
+
+if (result.value) {
+  // Apply adaptive
+}
+```
+
+---
+
+## Styling & Overlays
 
-### Overlays (Tooltips & Highlights)
+- Fonts, colors, and CSS variables are inherited from the host
+- Tokens can be overridden via `setTokens` or standard CSS:
+  - `--syntro-tooltip-bg`, `--syntro-tooltip-fg`, `--syntro-tooltip-radius`
+  - `--syntro-ring`, `--syntro-spotlight-backdrop` for highlights
+- A scoped reset is injected via `adoptedStyleSheets`
+
+---
+
+## Schema & Validation
+
+- JSON schema lives at `schema/canvas-config.schema.json`
+- Validate a config file locally:
+
+```bash
+cd tech-core/sdks/runtime-sdk
+npm run validate-config -- path/to/config.json
+```
 
-- Recipes use the schema in `src/overlays/schema.ts` (roughly `{ id, version, steps[] }`).
-- Provide a recipe URI via `overlayConfigUri` or let GrowthBook supply `smart-canvas-overlay-uri`.
-- Overlays render in `#syntro-overlays` (fixed, pointer-events: none) and use Floating UI for tethering.
-- The Canvas runtime dynamically imports the overlay chunk only when a recipe resolves.
-- Exposed helpers:
-  - `createOverlayRecipeFetcher`, `resolveConfigUri`
-  - `runOverlays`, `showTooltip`, `showHighlight`
-  - `createAnchorResolver` (works for main DOM + shadow DOM)
+---
 
-Telemetry for overlays uses `telemetry.trackAction("syntro_overlay_*", stepId, "overlay")`.
+## Documentation
 
-### Testing
+- **[APPS.md](./APPS.md)** - App architecture: how to build runtime extensions with actions, schemas, and editor modules
+- **[CAPABILITIES.md](./CAPABILITIES.md)** - Complete reference for all actions, surfaces, and config options
+- **[RUNTIME_V2_REFERENCE.md](./RUNTIME_V2_REFERENCE.md)** - Context, Events, State, Decisions modules
 
-- Shadow root is **open**, so Playwright/Cypress can traverse via `.shadow()`.
-- Data hooks: `[data-shadow-canvas-id="overlay-launcher"]`, `[data-shadow-canvas-id="rectangle-${id}"]`, etc.
-- `SmartCanvasController` exposes `open/close` for deterministic tests.
+---
 
-### Directory Overview
+## Directory Overview
 
 ```
-tech-core/sdks/shadow-canvas
+tech-core/sdks/runtime-sdk
 ├─ src
-│  ├─ SmartCanvasElement.tsx   // custom element + controller glue
-│  ├─ SmartCanvasApp.tsx       // React UI
-│  ├─ SmartCanvasPortal.tsx    // portal helper
-│  ├─ api.tsx                  // window.SmartCanvas + imperative API
-│  ├─ analytics/, experiments/, hooks/, components/
-│  └─ controller.ts
+│  ├─ actions/              # ActionEngine (interventions)
+│  │  ├─ types.ts
+│  │  ├─ ActionEngine.ts
+│  │  ├─ validation.ts
+│  │  └─ executors/         # visual, dom, navigation executors
+│  ├─ apps/                 # App system (see APPS.md)
+│  │  ├─ AppRegistry.ts     # App registration and lifecycle
+│  │  ├─ AppLoader.ts       # Dynamic app loading
+│  │  ├─ types.ts           # AppManifest, AppContext types
+│  │  └─ built-in/          # Core apps (bundled with runtime)
+│  ├─ surfaces/             # Surfaces (UI rendering)
+│  │  ├─ types.ts
+│  │  ├─ Surfaces.ts
+│  │  └─ positioning.ts
+│  ├─ context/              # Page/session/viewport state
+│  ├─ events/               # EventBus
+│  ├─ state/                # StateStore
+│  ├─ decisions/            # DecisionStrategy evaluation
+│  ├─ runtime.ts            # SmartCanvasRuntime factory
+│  ├─ bootstrap.ts          # Syntro.init()
+│  ├─ SmartCanvasElement.tsx
+│  ├─ SmartCanvasApp.tsx
+│  └─ SmartCanvasPortal.tsx
+├─ schema/
+│  └─ canvas-config.schema.json
+├─ APPS.md
+├─ CAPABILITIES.md
+├─ RUNTIME_V2_REFERENCE.md
 └─ README.md
 ```
 
-### Quick Checklist
+---
 
-1. Call `registerSmartCanvasElement()` once per app.
-2. Render `<smart-canvas>` (custom element).
-3. Portal your React tree into the element’s shadow via `SmartCanvasPortal`.
-4. Configure the SDK with your API credentials.
-5. For non-React pages, call `window.SmartCanvas.create()` with configuration.
+## Development Commands
+
+```bash
+# Build TypeScript library
+npm run build:lib
+
+# Build CDN bundle
+npm run build:cdn
+
+# Full build
+npm run build
+
+# Validate a config file
+npm run validate-config -- path/to/config.json
+
+# Type check
+npx tsc --noEmit
+```
+
+---
+
+## Testing
+
+- Shadow root is **open**, so Playwright/Cypress can traverse via `.shadow()`
+- Data hooks: `[data-shadow-canvas-id="overlay-launcher"]`, `[data-shadow-canvas-id="rectangle-${id}"]`
+- `SmartCanvasController` exposes `open/close` for deterministic tests
+
+---
+
+## Analytics Events
+
+The telemetry client emits:
+
+| Event | Description |
+| --- | --- |
+| `shadow_canvas_opened` / `shadow_canvas_closed` | Toggle button interactions |
+| `shadow_canvas_rectangle_viewed` | A rectangle becomes visible |
+| `shadow_canvas_action` | CTA click, chatbot send, overlay events |
+| `action.applied` / `action.reverted` | ActionEngine events |
+| `surface.mounted` / `surface.unmounted` | Surfaces events |
+
+---
+
+## Quick Checklist
+
+1. Call `registerSmartCanvasElement()` once per app
+2. Render `<smart-canvas>` (custom element)
+3. Portal your React tree into the element's shadow via `SmartCanvasPortal`
+4. Configure the SDK with your API credentials
+5. Use `runtime.actions` for interventions, `runtime.surfaces` for UI
+6. For non-React pages, call `window.SmartCanvas.create()` with configuration

package/dist/RuntimeProvider.d.ts

@@ -0,0 +1,51 @@
+/**
+ * RuntimeProvider - React context for accessing the v2 Runtime.
+ *
+ * Provides access to the SmartCanvasRuntime from any component in the tree.
+ */
+import { ReactNode } from "react";
+import type { SmartCanvasRuntime } from "./runtime";
+import type { RuntimeContext } from "./context/types";
+export interface RuntimeProviderProps {
+    /** The SmartCanvasRuntime instance */
+    runtime: SmartCanvasRuntime | null;
+    children: ReactNode;
+}
+/**
+ * Provider component for the SmartCanvasRuntime.
+ */
+export declare function RuntimeProvider({ runtime, children }: RuntimeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the SmartCanvasRuntime.
+ */
+export declare function useRuntime(): SmartCanvasRuntime | null;
+/**
+ * Hook to access the current runtime context (reactive).
+ */
+export declare function useRuntimeContext(): RuntimeContext | null;
+/**
+ * Hook to access a specific part of the runtime context.
+ */
+export declare function usePageContext(): import("./context").PageContext | null;
+export declare function useSessionContext(): import("./context").SessionContext | null;
+export declare function useViewportContext(): import("./context").ViewportContext | null;
+/**
+ * Hook to subscribe to runtime events.
+ */
+export declare function useRuntimeEvents(filter: {
+    names?: string[];
+    patterns?: string[];
+    sources?: Array<"posthog" | "canvas" | "derived">;
+} | undefined, callback: (event: import("./events/types").NormalizedEvent) => void, deps?: React.DependencyList): void;
+/**
+ * Hook to access state helpers.
+ */
+export declare function useRuntimeState(): import("./state").StateStore | null;
+/**
+ * Hook to evaluate a decision strategy.
+ */
+export declare function useDecision<T>(strategy: import("./decisions/types").DecisionStrategy<T> | undefined | null, defaultValue: T): {
+    value: T;
+    isFallback: boolean;
+    isLoading: boolean;
+};

package/dist/RuntimeProvider.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * RuntimeProvider - React context for accessing the v2 Runtime.
+ *
+ * Provides access to the SmartCanvasRuntime from any component in the tree.
+ */
+import { createContext, useContext, useMemo, useEffect, useState } from "react";
+const RuntimeReactContext = createContext({
+    runtime: null,
+    context: null,
+});
+/**
+ * Provider component for the SmartCanvasRuntime.
+ */
+export function RuntimeProvider({ runtime, children }) {
+    // Subscribe to context changes and re-render when they occur
+    const [context, setContext] = useState(runtime ? runtime.context.get() : null);
+    useEffect(() => {
+        if (!runtime)
+            return;
+        // Set initial context
+        setContext(runtime.context.get());
+        // Subscribe to changes
+        const unsubscribe = runtime.context.subscribe((ctx) => {
+            setContext(ctx);
+        });
+        return unsubscribe;
+    }, [runtime]);
+    const value = useMemo(() => ({ runtime, context }), [runtime, context]);
+    return (_jsx(RuntimeReactContext.Provider, { value: value, children: children }));
+}
+/**
+ * Hook to access the SmartCanvasRuntime.
+ */
+export function useRuntime() {
+    const { runtime } = useContext(RuntimeReactContext);
+    return runtime;
+}
+/**
+ * Hook to access the current runtime context (reactive).
+ */
+export function useRuntimeContext() {
+    const { context } = useContext(RuntimeReactContext);
+    return context;
+}
+/**
+ * Hook to access a specific part of the runtime context.
+ */
+export function usePageContext() {
+    var _a;
+    const context = useRuntimeContext();
+    return (_a = context === null || context === void 0 ? void 0 : context.page) !== null && _a !== void 0 ? _a : null;
+}
+export function useSessionContext() {
+    var _a;
+    const context = useRuntimeContext();
+    return (_a = context === null || context === void 0 ? void 0 : context.session) !== null && _a !== void 0 ? _a : null;
+}
+export function useViewportContext() {
+    var _a;
+    const context = useRuntimeContext();
+    return (_a = context === null || context === void 0 ? void 0 : context.viewport) !== null && _a !== void 0 ? _a : null;
+}
+/**
+ * Hook to subscribe to runtime events.
+ */
+export function useRuntimeEvents(filter, callback, deps = []) {
+    const runtime = useRuntime();
+    useEffect(() => {
+        if (!runtime)
+            return;
+        const unsubscribe = filter
+            ? runtime.events.subscribe(filter, callback)
+            : runtime.events.subscribe(callback);
+        return unsubscribe;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [runtime, ...deps]);
+}
+/**
+ * Hook to access state helpers.
+ */
+export function useRuntimeState() {
+    var _a;
+    const runtime = useRuntime();
+    return (_a = runtime === null || runtime === void 0 ? void 0 : runtime.state) !== null && _a !== void 0 ? _a : null;
+}
+/**
+ * Hook to evaluate a decision strategy.
+ */
+export function useDecision(strategy, defaultValue) {
+    const runtime = useRuntime();
+    const [result, setResult] = useState({
+        value: defaultValue,
+        isFallback: true,
+        isLoading: true,
+    });
+    useEffect(() => {
+        if (!runtime || !strategy) {
+            setResult({ value: defaultValue, isFallback: true, isLoading: false });
+            return;
+        }
+        let cancelled = false;
+        runtime.evaluate(strategy).then((res) => {
+            if (!cancelled) {
+                setResult({ value: res.value, isFallback: res.isFallback, isLoading: false });
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [runtime, strategy, defaultValue]);
+    return result;
+}
+//# sourceMappingURL=RuntimeProvider.js.map

package/dist/RuntimeProvider.js.map

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

package/dist/SmartCanvasApp.d.ts

@@ -3,9 +3,9 @@ import { SmartCanvasController } from "./controller";
 import type { CanvasConfigFetcher } from "./types";
 import type { ExperimentClient } from "./experiments/types";
 import type { TelemetryClient } from "./telemetry/types";
-import type { OverlayRecipeFetcher } from "./overlays/fetcher";
 import { MountableComponent } from "./api";
 import { CanvasTheme } from "./components/ShadowCanvasOverlay";
+import type { SmartCanvasRuntime } from "./runtime";
 export interface SmartCanvasAppProps {
     controller: SmartCanvasController;
     fetcher?: CanvasConfigFetcher;
@@ -16,9 +16,15 @@ export interface SmartCanvasAppProps {
     pollIntervalMs?: number;
     experiments?: ExperimentClient;
     telemetry?: TelemetryClient;
-    overlayFetcher?: OverlayRecipeFetcher;
+    /** v2 Runtime instance for context, events, state, and decisions */
+    runtime?: SmartCanvasRuntime;
+    /** @deprecated Actions replace overlay recipes. Use config.actions instead. */
+    overlayFetcher?: () => Promise<unknown>;
+    /** @deprecated Actions replace overlay recipes. Use config.actions instead. */
     overlayConfigUri?: string;
+    /** @deprecated Actions replace overlay recipes. Use config.actions instead. */
     overlayConfigFeatureKey?: string;
+    /** @deprecated Actions replace overlay recipes. Use config.actions instead. */
     overlayFetchCredentials?: RequestCredentials;
     footerSlot?: ReactNode;
     launcherLabel?: string;
@@ -26,4 +32,4 @@ export interface SmartCanvasAppProps {
     customRenderers?: Record<string, MountableComponent>;
     theme?: Partial<CanvasTheme>;
 }
-export declare function SmartCanvasApp({ controller, fetcher, configUri, configUriFeatureKey, configFeatureKey, fetchCredentials, pollIntervalMs, experiments, telemetry, overlayFetcher, overlayConfigUri, overlayConfigFeatureKey, overlayFetchCredentials, footerSlot, launcherLabel, canvasHost, customRenderers, theme, }: SmartCanvasAppProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SmartCanvasApp({ controller, fetcher, configUri, configUriFeatureKey, configFeatureKey, fetchCredentials, pollIntervalMs, experiments, telemetry, runtime, overlayFetcher, overlayConfigUri, overlayConfigFeatureKey, overlayFetchCredentials, footerSlot, launcherLabel, canvasHost, customRenderers, theme, }: SmartCanvasAppProps): import("react/jsx-runtime").JSX.Element;