@syntrologie/runtime-sdk 2.7.0 → 2.8.0-canary.10

package/CAPABILITIES.md

@@ -292,7 +292,7 @@ Removes a CSS class from an element.
 
 # @syntrologie/adapt-faq
 
-Collapsible Q&A accordion with actions, rich content, feedback, and personalization. Supports mounting a full FAQ widget, scrolling to specific items, toggling item state, and dynamically updating the item list at runtime.
+Collapsible Q&A accordion with actions, rich content, feedback, and personalization.
 
 ## Actions
 
@@ -1284,3 +1284,25 @@ Control when adaptives activate using `DecisionStrategy`:
 - Listen for `action.failed` to handle errors
 - Track `action.applied` for analytics
 - Use EventBus for cross-adaptive coordination
+
+### 6. JavaScript API (window.SynOS)
+
+When generating `content:insertHtml` with interactive elements (buttons, links) that need to control the SDK canvas panel, use the `window.SynOS.handle` API:
+
+| Method | Description |
+|--------|-------------|
+| `window.SynOS.handle.open()` | Open the canvas panel |
+| `window.SynOS.handle.close()` | Close the canvas panel |
+
+Example — button that opens the canvas:
+
+```json
+{
+  "kind": "insert_html",
+  "anchorId": ".pricing-heading",
+  "html": "<button onclick='window.SynOS?.handle?.open()'>Help Me Choose</button>",
+  "position": "after"
+}
+```
+
+**WARNING:** There is NO `window.SynOS.canvas` property. Always use `window.SynOS.handle`.