@syntrologie/runtime-sdk 2.8.0-canary.13 → 2.8.0-canary.130

package/scripts/syntroReactPlugin.mjs

@@ -71,6 +71,9 @@ export const syntroReactPlugin = {
             export function useReducer() { return _R().useReducer.apply(null, arguments); }
             export function useLayoutEffect() { return _R().useLayoutEffect.apply(null, arguments); }
             export function useId() { return _R().useId.apply(null, arguments); }
+            export function useSyncExternalStore() { return _R().useSyncExternalStore.apply(null, arguments); }
+            export function useDebugValue() { return _R().useDebugValue.apply(null, arguments); }
+            export function useInsertionEffect() { return _R().useInsertionEffect.apply(null, arguments); }
 
             // Creation APIs — lazy function wrappers
             export function createElement() { return _R().createElement.apply(null, arguments); }

package/scripts/validate-config.mjs

@@ -119,6 +119,29 @@ if (semanticErrors.length > 0) {
   process.exit(1);
 }
 
+// --- Semantic check: tiles with notifications must have actions ---
+// Notifications reference content (FAQ items, nav tips) that lives in
+// tile.props.actions. Without actions, notifications have nothing to show.
+for (const tile of config.tiles ?? []) {
+  const notifications = tile.notifications ?? [];
+  if (notifications.length === 0) continue;
+
+  const actions = tile.props?.actions ?? [];
+  if (actions.length === 0) {
+    semanticErrors.push(
+      `Tile "${tile.id}": has ${notifications.length} notification(s) but no actions.\n` +
+        `    Notifications reference tile content (FAQ items, nav tips) defined in tile.props.actions.\n` +
+        `    Add actions to the tile, or remove the notifications.`
+    );
+  }
+}
+
+if (semanticErrors.length > 0) {
+  console.error(`\n\u274C ${semanticErrors.length} semantic error(s):`);
+  for (const e of semanticErrors) console.error(`  - ${e}`);
+  process.exit(1);
+}
+
 // --- Semantic check: anchorId.route must include at least one concrete route ---
 // Wildcards allowed by canvas-config.schema.json anchorId.route;
 // update here if the schema adds new glob patterns.
@@ -241,6 +264,25 @@ for (const { path, url } of pageUrlHits) {
   }
 }
 
+// Hidden insertHtml without a triggerWhen is dead HTML — the SDK has no way to show it.
+// The LLM sometimes generates `display:none` elements expecting a trigger type (e.g.,
+// exit-intent) that doesn't exist in the SDK. Without triggerWhen, the element is
+// injected hidden and stays hidden forever.
+for (const [i, action] of (config.actions ?? []).entries()) {
+  if (action.kind !== 'content:insertHtml') continue;
+  if (action.triggerWhen) continue;
+  const html = action.html ?? '';
+  if (!/display\s*:\s*none/i.test(html)) continue;
+
+  const label = action.label ? ` (label: "${action.label}")` : '';
+  warnings.push(
+    `actions[${i}]${label}: content:insertHtml injects hidden HTML (display:none) with no triggerWhen.\n` +
+      `    This element will be inserted into the DOM but never shown — the SDK has no mechanism to reveal it.\n` +
+      `    Either add a triggerWhen with a valid condition (e.g., event_count, session_metric) to control visibility,\n` +
+      `    or remove display:none to show it immediately.`
+  );
+}
+
 if (warnings.length > 0) {
   console.warn(`\n\u26A0\uFE0F  ${warnings.length} design warning(s):`);
   for (const w of warnings) console.warn(`  - ${w}`);

package/dist/chunk-37TTQRH5.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/config/schema.ts"],
-  "sourcesContent": ["/**\n * Zod schemas for canvas configuration types.\n *\n * Single source of truth for tile, theme, launcher, and top-level\n * CanvasConfigResponse shapes. These schemas are converted to JSON Schema\n * during build and merged into the unified canvas-config.schema.json.\n *\n * Design decisions:\n * - `.strict()` on top-level objects \u2192 `additionalProperties: false` in JSON Schema\n * - Element sub-schemas (canvas, tile, etc.) are NOT strict to allow future expansion\n */\n\nimport { z } from 'zod';\nimport { ActivationConfigZ, ConditionZ } from '../decisions/schema';\n\n// ============================================================================\n// Tile Notification Sub-Types\n// ============================================================================\n\nconst NotificationDeepLinkZ = z\n  .object({\n    tileId: z.string(),\n    itemId: z.string().optional(),\n  })\n  .strict();\n\nconst TileNotificationRuleZ = z\n  .object({\n    on: z.string(),\n    title: z.string(),\n    body: z.string().optional(),\n    icon: z.string().optional(),\n    ttl: z.number().optional(),\n    cooldown: z.number().optional(),\n    deepLink: NotificationDeepLinkZ.optional(),\n  })\n  .strict();\n\n// ============================================================================\n// Tile\n// ============================================================================\n\nexport const TileZ = z\n  .object({\n    id: z.string(),\n    title: z.string().optional(),\n    subtitle: z.string().optional(),\n    icon: z.string().optional(),\n    priority: z.number().optional(),\n    widget: z.string(),\n    props: z.record(z.unknown()).optional(),\n    activation: ActivationConfigZ.optional(),\n    notifications: z.array(TileNotificationRuleZ).optional(),\n  })\n  .strict();\n\n// ============================================================================\n// Theme Config \u2014 Element Sub-Schemas\n// ============================================================================\n\nexport const CanvasElementConfigZ = z.object({\n  position: z.enum(['left', 'right']).optional(),\n  layout: z.enum(['overlay', 'push']).optional(),\n  background: z.string().optional(),\n  blur: z.string().optional(),\n  border: z.string().optional(),\n  width: z.string().optional(),\n  transitionDuration: z.string().optional(),\n  transitionEasing: z.string().optional(),\n  transitionFade: z.string().optional(),\n});\n\nexport const LauncherElementConfigZ = z.object({\n  background: z.string().optional(),\n  backgroundHover: z.string().optional(),\n  color: z.string().optional(),\n  size: z.string().optional(),\n  shadow: z.string().optional(),\n  borderRadius: z.string().optional(),\n});\n\nexport const TileElementConfigZ = z.object({\n  background: z.string().optional(),\n  backgroundHover: z.string().optional(),\n  border: z.string().optional(),\n  borderRadius: z.string().optional(),\n  shadow: z.string().optional(),\n  titleColor: z.string().optional(),\n  textColor: z.string().optional(),\n  iconBackground: z.string().optional(),\n  iconShadow: z.string().optional(),\n  headerPadding: z.string().optional(),\n  bodyPadding: z.string().optional(),\n  gap: z.string().optional(),\n});\n\nexport const OverlayElementConfigZ = z.object({\n  background: z.string().optional(),\n  textColor: z.string().optional(),\n  titleColor: z.string().optional(),\n  arrowColor: z.string().optional(),\n  arrowSize: z.string().optional(),\n  border: z.string().optional(),\n  borderRadius: z.string().optional(),\n  scrimOpacity: z.string().optional(),\n  highlightRing: z.string().optional(),\n});\n\nexport const NotificationElementConfigZ = z.object({\n  background: z.string().optional(),\n  textColor: z.string().optional(),\n  textSecondaryColor: z.string().optional(),\n  border: z.string().optional(),\n  borderRadius: z.string().optional(),\n  successColor: z.string().optional(),\n  warningColor: z.string().optional(),\n  errorColor: z.string().optional(),\n  iconBackground: z.string().optional(),\n  progressGradient: z.string().optional(),\n});\n\nexport const ContentElementConfigZ = z.object({\n  background: z.string().optional(),\n  backgroundHover: z.string().optional(),\n  border: z.string().optional(),\n  borderRadius: z.string().optional(),\n  textColor: z.string().optional(),\n  textSecondaryColor: z.string().optional(),\n  // Accordion layout\n  itemDivider: z.string().optional(),\n  itemGap: z.string().optional(),\n  itemPadding: z.string().optional(),\n  itemFontSize: z.string().optional(),\n  // Expanded content\n  bodyPadding: z.string().optional(),\n  bodyFontSize: z.string().optional(),\n  // Category headers\n  categoryPadding: z.string().optional(),\n  categoryGap: z.string().optional(),\n  categoryFontSize: z.string().optional(),\n  // Search\n  searchBackground: z.string().optional(),\n  searchColor: z.string().optional(),\n  // Chevron\n  chevronColor: z.string().optional(),\n});\n\n// ============================================================================\n// Theme Config \u2014 Top-Level\n// ============================================================================\n\nexport const CanvasThemeConfigZ = z\n  .object({\n    mode: z.enum(['dark', 'light']).optional(),\n    fontFamily: z.string().optional(),\n    colorPrimary: z.string().optional(),\n    colorPrimaryHover: z.string().optional(),\n    borderRadius: z.string().optional(),\n    canvas: CanvasElementConfigZ.optional(),\n    launcher: LauncherElementConfigZ.optional(),\n    tile: TileElementConfigZ.optional(),\n    overlay: OverlayElementConfigZ.optional(),\n    notification: NotificationElementConfigZ.optional(),\n    content: ContentElementConfigZ.optional(),\n  })\n  .strict();\n\n// ============================================================================\n// Launcher Config\n// ============================================================================\n\nexport const LauncherConfigZ = z\n  .object({\n    enabled: z.boolean().optional(),\n    label: z.string().optional(),\n    icon: z.string().optional(),\n    position: z.string().optional(),\n    animate: z.boolean().optional(),\n    animationStyle: z.enum(['pulse', 'bounce', 'glow']).optional(),\n    notificationCount: z.number().optional(),\n  })\n  .strict();\n\n// ============================================================================\n// Canvas Config Response (top-level)\n// ============================================================================\n\nexport const CanvasConfigResponseZ = z\n  .object({\n    schemaVersion: z.string().optional(),\n    fetchedAt: z.string().datetime(),\n    configVersion: z.string().optional(),\n    canvasTitle: z.string().optional(),\n    tiles: z.array(TileZ),\n    actions: z.array(z.any()),\n    theme: CanvasThemeConfigZ.optional(),\n    launcher: LauncherConfigZ.optional(),\n    meta: z\n      .object({\n        verificationSteps: z\n          .array(\n            z.union([\n              z.string(),\n              z.object({\n                text: z.string(),\n                check: ConditionZ.optional(),\n              }),\n            ])\n          )\n          .optional(),\n      })\n      .passthrough()\n      .optional(),\n  })\n  .strict();\n\n// ============================================================================\n// Export: Array for unified schema generation\n// ============================================================================\n\n/**\n * Config schemas for unified JSON Schema generation.\n * The generator imports this array and converts each to a JSON Schema $def.\n */\nexport const configSchemas = [\n  { defName: 'tile', schema: TileZ },\n  { defName: 'themeConfig', schema: CanvasThemeConfigZ },\n  { defName: 'launcherConfig', schema: LauncherConfigZ },\n  { defName: 'canvasConfigResponse', schema: CanvasConfigResponseZ },\n];\n\n// ============================================================================\n// Named Exports\n// ============================================================================\n\nexport { NotificationDeepLinkZ, TileNotificationRuleZ };\n"],
-  "mappings": "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",
-  "names": []
-}