@syntrologie/runtime-sdk 2.3.0 → 2.4.0-canary.10

package/CAPABILITIES.md

@@ -10,6 +10,7 @@ This document describes all available operations and capabilities of the SmartCa
 - [Adaptive Packages](#adaptive-packages)
 - [Surfaces](#surfaces)
 - [Anchor Resolution](#anchor-resolution)
+- [Route Scoping](#route-scoping)
 - [Decision Strategies](#decision-strategies)
 - [Best Practices](#best-practices)
 
@@ -1092,6 +1093,55 @@ Then reference by the anchor name:
 
 ---
 
+## Route Scoping
+
+Every tile and action **must** declare which pages it applies to via `activation.routes`. The config itself is always active — individual tiles and actions decide independently whether to render.
+
+### Per-Tile Activation
+
+```json
+{
+  "id": "faq-w2-boxes",
+  "widget": "adaptive-faq:accordion",
+  "activation": {
+    "routes": { "include": ["/dashboard/income"] }
+  },
+  "props": { ... }
+}
+```
+
+### Per-Action Activation
+
+```json
+{
+  "kind": "content:insertHtml",
+  "anchorId": "[data-section='refund-estimate']",
+  "activation": {
+    "routes": { "include": ["/dashboard"] }
+  },
+  "html": "...",
+  "position": "after"
+}
+```
+
+### Route Patterns
+
+| Pattern | Matches | Use Case |
+|---------|---------|----------|
+| `"/dashboard/income"` | Exact path only | Page-specific |
+| `"/dashboard/**"` | `/dashboard` and all sub-paths | Section-wide |
+| `"/**"` | All pages | Global (always active) |
+| `"/dashboard/:id"` | Any single segment after `/dashboard/` | Dynamic routes |
+
+### Pattern Matching Rules
+
+- Patterns match against **pathname only** (no domain, no query string)
+- `**` matches anything (including `/`)
+- `*` matches within a single path segment (not `/`)
+- `exclude` takes priority over `include`
+
+---
+
 ## Decision Strategies
 
 Control when adaptives activate using `DecisionStrategy`:

package/dist/SmartCanvasApp.d.ts

@@ -1,10 +1,10 @@
 import { type ReactNode } from 'react';
 import type { BatchActionHandle } from './actions/types';
-import { type CanvasTheme } from './components/ShadowCanvasOverlay';
 import type { SmartCanvasController } from './controller';
 import type { ExperimentClient } from './experiments/types';
 import type { SmartCanvasRuntime } from './runtime';
 import type { TelemetryClient } from './telemetry/types';
+import type { CanvasThemeConfig } from './theme';
 import type { CanvasConfigFetcher } from './types';
 export interface SmartCanvasAppProps {
     controller: SmartCanvasController;
@@ -29,8 +29,9 @@ export interface SmartCanvasAppProps {
     footerSlot?: ReactNode;
     launcherLabel?: string;
     canvasHost?: HTMLElement | null;
-    theme?: Partial<CanvasTheme>;
     /** Batch handle from eager action application in createSmartCanvas(). Prevents double-apply. */
     initialBatchHandle?: BatchActionHandle | null;
+    /** Workspace-level theme for 3-layer inheritance (defaults → workspace → config) */
+    workspaceTheme?: CanvasThemeConfig;
 }
-export declare function SmartCanvasApp({ controller, fetcher, configUri, configUriFeatureKey, configFeatureKey, fetchCredentials, pollIntervalMs, experiments, telemetry, runtime, overlayFetcher, overlayConfigUri, overlayConfigFeatureKey, overlayFetchCredentials, footerSlot, launcherLabel, canvasHost, theme, initialBatchHandle, }: SmartCanvasAppProps): import("react/jsx-runtime").JSX.Element;
+export declare function SmartCanvasApp({ controller, fetcher, configUri, configUriFeatureKey, configFeatureKey, fetchCredentials, pollIntervalMs, experiments, telemetry, runtime, overlayFetcher, overlayConfigUri, overlayConfigFeatureKey, overlayFetchCredentials, footerSlot, launcherLabel, canvasHost, initialBatchHandle, workspaceTheme, }: SmartCanvasAppProps): import("react/jsx-runtime").JSX.Element;