@syntrologie/runtime-sdk 0.2.21 → 1.0.0-canary.1

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,113 @@ 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 {
@@ -60,9 +186,11 @@ import {
   SmartCanvasPortal,
   registerSmartCanvasElement,
   type SmartCanvasElement,
-} from "@syntrologie/smart-canvas-sdk";
+} from '@syntrologie/smart-canvas-sdk';
 
-const canvasFetcher = async () => {/* return ShadowCanvasConfigResponse */};
+const canvasFetcher = async () => {
+  /* return ShadowCanvasConfigResponse */
+};
 
 function SmartCanvasBridge() {
   const [element, setElement] = useState<SmartCanvasElement | null>(null);
@@ -90,7 +218,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`:
 
@@ -99,87 +229,199 @@ When using via CDN, the SDK is available as `window.SyntrologieSDK`:
 await window.SmartCanvas?.create({
   defaultOpen: true,
   tokens: {
-    "--sc-surface": "#050814",
-    "--sc-fg": "#f8fafc",
+    '--sc-surface': '#050814',
+    '--sc-fg': '#f8fafc',
   },
   integrations: {
-    posthog,       // existing PostHog client
-    growthbook,    // existing GrowthBook client
+    posthog, // existing PostHog client
+    growthbook, // existing GrowthBook client
   },
 });
 ```
 
-### 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
+
+The EventBus provides a unified stream of normalized events:
+
+```typescript
+// Subscribe to events
+runtime.events.subscribe({ names: ['ui.click', 'action.applied'] }, (event) => {
+  console.log(event.name, event.props);
+});
 
-### Analytics Events
+// 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
+```
 
-The `createSyntroTelemetry` client emits:
+---
 
-| 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). |
+## State Management
 
-### Rectangle Config (unchanged)
+```typescript
+// Dismissals
+runtime.state.dismissals.mark("promo-banner");
+if (runtime.state.dismissals.isDismissed("promo-banner")) { ... }
 
-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.
+// Cooldowns
+runtime.state.cooldowns.set("upsell", 86400000); // 24h
+if (runtime.state.cooldowns.isActive("upsell")) { ... }
 
-### Schema & Validation Tool
+// Frequency caps
+runtime.state.frequency.increment("tooltip-shown");
+if (runtime.state.frequency.count("tooltip-shown") >= 3) { ... }
+```
 
-- JSON schema lives at `schema/canvas-config.schema.json` (published with the package).
-- Validate a config file locally:
+---
+
+## 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,
+});
 
-```bash
-cd tech-core/sdks/shadow-canvas
-npm run validate-config -- ../../tax_landing_page/public/smart-canvas-demo.json
+if (result.value) {
+  // Apply adaptive
+}
 ```
 
-The script evaluates structure/required fields without third-party dependencies so CI and content authors can catch issues early.
+---
 
-### Overlays (Tooltips & Highlights)
+## Styling & Overlays
 
-- 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)
+- 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`
 
-Telemetry for overlays uses `telemetry.trackAction("syntro_overlay_*", stepId, "overlay")`.
+---
 
-### Testing
+## Schema & Validation
 
-- 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.
+- JSON schema lives at `schema/canvas-config.schema.json`
+- Validate a config file locally:
 
-### Directory Overview
+```bash
+cd tech-core/sdks/runtime-sdk
+npm run validate-config -- path/to/config.json
+```
+
+---
+
+## Documentation
+
+- **[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
+
+---
+
+## 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
+---
+
+## 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. For non-React pages, call `window.SmartCanvas.create()` with configuration.
+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,113 @@
+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;
+    }, [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

@@ -1,11 +1,11 @@
-import { ReactNode } from "react";
-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 { ReactNode } from 'react';
+import { SmartCanvasController } from './controller';
+import type { CanvasConfigFetcher } from './types';
+import type { ExperimentClient } from './experiments/types';
+import type { TelemetryClient } from './telemetry/types';
+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;