@syntrologie/runtime-sdk 2.12.0 → 2.14.0

package/CAPABILITIES.md

@@ -331,29 +331,46 @@ Collapsible Q&A accordion with actions, rich content, feedback, and personalizat
 
 | Goal | Action |
 |------|--------|
-| Mount an FAQ accordion widget | `core:mountWidget` with `widget: "adaptive-faq:accordion"` |
+| Add an FAQ accordion widget | Add a **tile** in `tiles[]` with `widget: "adaptive-faq:accordion"` |
 | Scroll to and expand a specific FAQ item | `faq:scroll_to` |
 | Open, close, or toggle a FAQ item | `faq:toggle_item` |
 | Add, remove, reorder, or replace FAQ items | `faq:update` |
 
-## Actions
+## Mounting an FAQ Widget
+
+FAQ widgets are mounted via **tiles** (not actions). Add an entry to the `tiles[]` array in the config:
 
-### core:mountWidget (FAQ)
+```json
+{
+  "tiles": [
+    {
+      "id": "my-faq",
+      "title": "Frequently Asked Questions",
+      "content": {
+        "type": "custom",
+        "component": "adaptive-faq:accordion",
+        "props": {
+          "expandBehavior": "single",
+          "searchable": true,
+          "items": [ ... ]
+        }
+      }
+    }
+  ]
+}
+```
 
-Mounts an FAQ accordion widget to a surface slot.
+### Tile Props
 
 | Property                | Type                              | Required | Description                                                         |
 | ----------------------- | --------------------------------- | -------- | ------------------------------------------------------------------- |
-| `kind`                  | `"core:mountWidget"`                     | Yes      | Action type                                                         |
-| `slot`                  | string                            | Yes      | Target slot (e.g., `"drawer_right"`, `"overlay_center"`)            |
-| `config.title`          | string                            | No       | Widget title                                                        |
-| `config.expandBehavior` | `"single"` \| `"multiple"`        | No       | Whether one or many items can be open at once (default: `"single"`) |
-| `config.searchable`     | boolean                           | No       | Show a search/filter input (default: `false`)                       |
-| `config.theme`          | `"light"` \| `"dark"` \| `"auto"` | No       | Color theme (default: `"auto"`)                                     |
-| `config.items`          | array                             | Yes      | FAQ items (see below)                                               |
-| `config.feedback`       | boolean \| FeedbackConfig         | No       | Enable per-item feedback widget                                     |
-| `config.ordering`       | OrderingStrategy                  | No       | Item ordering strategy (default: `"static"`)                        |
-| `config.injections`     | InjectionRule[]                   | No       | Dynamic item injection rules                                        |
+| `expandBehavior`        | `"single"` \| `"multiple"`        | No       | Whether one or many items can be open at once (default: `"single"`) |
+| `searchable`            | boolean                           | No       | Show a search/filter input (default: `false`)                       |
+| `theme`                 | `"light"` \| `"dark"` \| `"auto"` | No       | Color theme (default: `"auto"`)                                     |
+| `items`                 | array                             | Yes      | FAQ items (see below)                                               |
+| `feedback`              | boolean \| FeedbackConfig         | No       | Enable per-item feedback widget                                     |
+| `ordering`              | OrderingStrategy                  | No       | Item ordering strategy (default: `"static"`)                        |
+| `injections`            | InjectionRule[]                   | No       | Dynamic item injection rules                                        |
 
 ### FAQ Item Schema
 
@@ -370,53 +387,51 @@ Each item in the `items` array:
 | `config.answerStrategy` | AnswerStrategy           | No       | AI-generated answer configuration               |
 | `triggerWhen`              | DecisionStrategy \| null | No       | Conditional visibility strategy                 |
 
+**Full tile example with FAQ items:**
+
 ```json
 {
-  "kind": "core:mountWidget",
-  "slot": "drawer_right",
-  "config": {
-    "title": "Frequently Asked Questions",
-    "expandBehavior": "single",
-    "searchable": true,
-    "theme": "auto",
-    "feedback": {
-      "style": "thumbs",
-      "prompt": "Was this helpful?"
-    },
-    "ordering": "priority",
-    "items": [
-      {
-        "kind": "faq:question",
-        "config": {
-          "id": "getting-started",
-          "question": "How do I get started?",
-          "answer": "Sign up for a free account and follow our quickstart guide.",
-          "category": "General",
-          "priority": 10
-        }
-      },
-      {
-        "kind": "faq:question",
-        "config": {
-          "id": "payment-methods",
-          "question": "What payment methods do you accept?",
-          "answer": "We accept all major credit cards and PayPal.",
-          "category": "Billing",
-          "priority": 5
-        },
-        "triggerWhen": {
-          "type": "rules",
-          "rules": [
+  "tiles": [
+    {
+      "id": "help-faq",
+      "title": "Frequently Asked Questions",
+      "content": {
+        "type": "custom",
+        "component": "adaptive-faq:accordion",
+        "props": {
+          "expandBehavior": "single",
+          "searchable": true,
+          "feedback": {
+            "style": "thumbs",
+            "prompt": "Was this helpful?"
+          },
+          "ordering": "priority",
+          "items": [
             {
-              "conditions": [{ "type": "page_url", "pattern": "/pricing*" }],
-              "value": true
+              "kind": "faq:question",
+              "config": {
+                "id": "getting-started",
+                "question": "How do I get started?",
+                "answer": "Sign up for a free account and follow our quickstart guide.",
+                "category": "General",
+                "priority": 10
+              }
+            },
+            {
+              "kind": "faq:question",
+              "config": {
+                "id": "payment-methods",
+                "question": "What payment methods do you accept?",
+                "answer": "We accept all major credit cards and PayPal.",
+                "category": "Billing",
+                "priority": 5
+              }
             }
-          ],
-          "default": false
+          ]
         }
       }
-    ]
-  }
+    }
+  ]
 }
 ```
 
@@ -698,7 +713,7 @@ Gamification capabilities including badges, points, and leaderboards.
 |------|--------|
 | Award a badge to a user | `gamification:awardBadge` |
 | Add points to a user's score | `gamification:addPoints` |
-| Mount a gamification widget (leaderboard, progress) | `core:mountWidget` |
+| Mount a gamification widget (leaderboard, progress) | Add a **tile** with `component: "adaptive-gamification:leaderboard"` |
 
 ## Actions
 
@@ -734,15 +749,25 @@ Adds points to the current user's score.
 }
 ```
 
-### core:mountWidget (Gamification)
+### Gamification Widget (via Tile)
 
-Mounts gamification UI elements (leaderboard, badge display, progress tracker).
+Mount gamification UI elements (leaderboard, badge display, progress tracker) via a **tile**:
 
-| Property | Type                   | Required | Description                |
-| -------- | ---------------------- | -------- | -------------------------- |
-| `kind`   | `"core:mountWidget"`   | Yes      | Action type                |
-| `slot`   | string                 | Yes      | Target slot                |
-| `config` | object                 | Yes      | Gamification configuration |
+```json
+{
+  "tiles": [
+    {
+      "id": "gamification",
+      "title": "Your Progress",
+      "content": {
+        "type": "custom",
+        "component": "adaptive-gamification:leaderboard",
+        "props": { ... }
+      }
+    }
+  ]
+}
+```
 
 ### Configuration Schema
 
@@ -767,9 +792,13 @@ Mounts gamification UI elements (leaderboard, badge display, progress tracker).
 
 ```json
 {
-  "kind": "core:mountWidget",
-  "slot": "overlay_corner_br",
-  "config": {
+  "tiles": [{
+    "id": "gamification-widget",
+    "title": "Achievements",
+    "content": {
+      "type": "custom",
+      "component": "adaptive-gamification:leaderboard",
+      "props": {
     "badges": [
       {
         "id": "first-purchase",
@@ -813,7 +842,7 @@ Navigation tips accordion widget with conditional item visibility and toast noti
 |------|--------|
 | Scroll to an element on the page | `navigation:scrollTo` |
 | Navigate to a different URL | `navigation:navigate` |
-| Show contextual navigation tips widget | `core:mountWidget` with `widget: "adaptive-nav:tips"` |
+| Show contextual navigation tips widget | Add a **tile** with `component: "adaptive-nav:tips"` |
 
 ## Widget: `adaptive-nav:tips`