@syntrologie/runtime-sdk 2.4.0-canary.16 → 2.4.0-canary.17

package/CAPABILITIES.md

@@ -855,7 +855,7 @@ Navigates to a URL.
 
 # @syntrologie/adapt-overlays
 
-Visual overlay capabilities including highlights, tooltips, badges, and pulse animations.
+Visual overlay capabilities including highlights, tooltips, badges, pulse animations, and celebrations.
 
 ## Actions
 
@@ -1029,6 +1029,71 @@ Shows a centered modal dialog with optional CTA buttons.
 }
 ```
 
+### celebrate
+
+Renders a fullscreen Canvas 2D celebration effect. One action kind with a pluggable `effect` parameter supporting multiple visual presets.
+
+| Property    | Type                               | Required | Default                    | Description                                   |
+| ----------- | ---------------------------------- | -------- | -------------------------- | --------------------------------------------- |
+| `kind`      | `"overlays:celebrate"`             | Yes      |                            | Action type                                   |
+| `effect`    | string                             | Yes      |                            | Effect name (see presets below)                |
+| `duration`  | number                             | No       | `3000`                     | Animation duration in ms                      |
+| `intensity` | `"light"` \| `"medium"` \| `"heavy"` | No       | `"medium"`                 | Particle density                              |
+| `colors`    | string[]                           | No       | Rainbow palette            | Color palette for particles                   |
+| `props`     | object                             | No       |                            | Effect-specific properties (see presets below) |
+
+**Available effect presets:**
+
+- **`confetti`** — Falling rectangular/circular confetti pieces with gravity, air resistance, and rotation
+- **`fireworks`** — Multiple burst centers with radiating particles, deceleration, and glow effect
+- **`sparkles`** — Diamond shapes that twinkle via sine-wave opacity oscillation and float gently upward
+- **`emoji-rain`** — Emoji characters falling from the top with horizontal sine-wave wobble. Use `props.emoji` to set the character (default: `"🎉"`)
+
+**Confetti:**
+
+```json
+{
+  "kind": "overlays:celebrate",
+  "effect": "confetti",
+  "duration": 4000,
+  "intensity": "heavy",
+  "colors": ["#ff0000", "#00ff00", "#0000ff", "#ffff00"]
+}
+```
+
+**Fireworks:**
+
+```json
+{
+  "kind": "overlays:celebrate",
+  "effect": "fireworks",
+  "duration": 3000,
+  "intensity": "medium"
+}
+```
+
+**Sparkles:**
+
+```json
+{
+  "kind": "overlays:celebrate",
+  "effect": "sparkles",
+  "duration": 5000,
+  "colors": ["#ffd700", "#ffffff", "#fffacd"]
+}
+```
+
+**Emoji rain:**
+
+```json
+{
+  "kind": "overlays:celebrate",
+  "effect": "emoji-rain",
+  "duration": 3000,
+  "props": { "emoji": "🔥" }
+}
+```
+
 
 ---
 

package/dist/SmartCanvasApp.d.ts

@@ -13,6 +13,7 @@ export interface SmartCanvasAppProps {
     configUriFeatureKey?: string;
     configFeatureKey?: string;
     fetchCredentials?: RequestCredentials;
+    /** @deprecated No longer used — config updates are event-driven via ExperimentClient.onFeaturesChanged */
     pollIntervalMs?: number;
     experiments?: ExperimentClient;
     telemetry?: TelemetryClient;