@syntrologie/runtime-sdk 2.4.0-canary.24 → 2.4.0-canary.25

package/dist/version.d.ts

@@ -10,4 +10,4 @@
  *
  * @since 2.0.0
  */
-export declare const SDK_VERSION = "2.4.0-canary.24";
+export declare const SDK_VERSION = "2.4.0-canary.25";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntrologie/runtime-sdk",
-  "version": "2.4.0-canary.24",
+  "version": "2.4.0-canary.25",
   "description": "Syntrologie Runtime SDK for web experimentation and analytics",
   "license": "Proprietary",
   "private": false,
@@ -67,12 +67,12 @@
     "@floating-ui/dom": "^1.7.5",
     "@growthbook/growthbook": "~1.6.2",
     "@growthbook/growthbook-react": "^1.6.4",
-    "@syntrologie/adapt-chatbot": "2.4.0-canary.24",
-    "@syntrologie/adapt-content": "2.4.0-canary.24",
-    "@syntrologie/adapt-faq": "2.4.0-canary.24",
-    "@syntrologie/adapt-gamification": "2.4.0-canary.24",
-    "@syntrologie/adapt-nav": "2.4.0-canary.24",
-    "@syntrologie/adapt-overlays": "2.4.0-canary.24",
+    "@syntrologie/adapt-chatbot": "2.4.0-canary.25",
+    "@syntrologie/adapt-content": "2.4.0-canary.25",
+    "@syntrologie/adapt-faq": "2.4.0-canary.25",
+    "@syntrologie/adapt-gamification": "2.4.0-canary.25",
+    "@syntrologie/adapt-nav": "2.4.0-canary.25",
+    "@syntrologie/adapt-overlays": "2.4.0-canary.25",
     "lucide-react": "^0.576.0",
     "posthog-js": "~1.302.2",
     "zod": "^3.25.76"

package/schema/canvas-config.schema.json

@@ -271,6 +271,15 @@
             },
             "width": {
               "type": "string"
+            },
+            "transitionDuration": {
+              "type": "string"
+            },
+            "transitionEasing": {
+              "type": "string"
+            },
+            "transitionFade": {
+              "type": "string"
             }
           },
           "additionalProperties": false

package/scripts/validate-config.mjs

@@ -159,3 +159,74 @@ if (routeErrors.length > 0) {
   for (const e of routeErrors) console.error(`  - ${e}`);
   process.exit(1);
 }
+
+// --- Semantic warnings (non-blocking, design-quality hints) ---
+const warnings = [];
+
+// Tile-level route restrictions should be rare. They hide the entire tile
+// (and all its actions) on non-matching pages. The preferred pattern is:
+//   - Tile: routes ["/**"] (or omitted) + onlyIfPopulated: true
+//   - Actions: triggerWhen with route conditions to self-target specific pages
+// This way the tile is always available and actions decide when to appear.
+for (const tile of config.tiles ?? []) {
+  const routes = tile.activation?.routes;
+  if (!routes) continue;
+
+  const includePatterns = routes.include ?? [];
+  const hasCatchAll = includePatterns.some((r) => WILDCARD_PATTERNS.includes(r) || r === '/**');
+  if (hasCatchAll) continue;
+
+  const routeList = includePatterns.join('", "');
+  const actions = tile.props?.actions ?? [];
+  const actionsWithoutTrigger = actions.filter((a) => !a.triggerWhen).length;
+
+  let detail = '';
+  if (actionsWithoutTrigger > 0) {
+    detail =
+      `\n    ${actionsWithoutTrigger} of ${actions.length} action(s) have no triggerWhen — ` +
+      `they'll never appear outside ["${routeList}"].`;
+  }
+
+  warnings.push(
+    `Tile "${tile.id}": activation.routes restricts to ["${routeList}"].${detail}\n` +
+      `    Prefer: set routes to ["/**"], add onlyIfPopulated: true, and use ` +
+      `triggerWhen with a "route" condition on each action to target specific pages.`
+  );
+}
+
+// page_url conditions should use ** prefix to match any host, not absolute paths.
+// "/dashboard/state" won't match "http://localhost:8088/dashboard/state" because
+// page_url evaluates against the full URL. Use "**/dashboard/state" instead.
+function collectPageUrlConditions(obj, path, results) {
+  if (!obj || typeof obj !== 'object') return;
+  if (Array.isArray(obj)) {
+    for (const [i, item] of obj.entries()) {
+      collectPageUrlConditions(item, `${path}[${i}]`, results);
+    }
+    return;
+  }
+  if (obj.type === 'page_url' && typeof obj.url === 'string') {
+    results.push({ path, url: obj.url });
+    return;
+  }
+  for (const [key, val] of Object.entries(obj)) {
+    collectPageUrlConditions(val, `${path}.${key}`, results);
+  }
+}
+
+const pageUrlHits = [];
+collectPageUrlConditions(config, 'config', pageUrlHits);
+for (const { path, url } of pageUrlHits) {
+  if (url.startsWith('/')) {
+    warnings.push(
+      `${path}: page_url "${url}" uses an absolute path.\n` +
+        `    page_url matches against the full URL (e.g., "http://localhost:8088${url}"),\n` +
+        `    so "${url}" will never match. Use "**${url}" instead.`
+    );
+  }
+}
+
+if (warnings.length > 0) {
+  console.warn(`\n\u26A0\uFE0F  ${warnings.length} design warning(s):`);
+  for (const w of warnings) console.warn(`  - ${w}`);
+}