@syntrologie/runtime-sdk 2.2.0-canary.9 → 2.2.0

package/dist/{chunk-UEAP7WOK.js → chunk-V4MDQX67.js}

@@ -5,6 +5,56 @@ import {
   __publicField
 } from "./chunk-AYTRRBR5.js";
 
+// ../adaptives/adaptive-content/dist/reconciliation-guard.js
+function guardAgainstReconciliation(container, anchor, reinsertFn, opts) {
+  var _a2, _b, _c;
+  const maxRetries = (_a2 = opts == null ? void 0 : opts.maxRetries) != null ? _a2 : 3;
+  const debounceMs = (_b = opts == null ? void 0 : opts.debounceMs) != null ? _b : 50;
+  const observeTarget = (_c = container.parentElement) != null ? _c : anchor.parentElement;
+  if (!observeTarget)
+    return () => {
+    };
+  let retries = 0;
+  let debounceTimer = null;
+  let disconnected = false;
+  const observer = new MutationObserver((mutations) => {
+    if (disconnected)
+      return;
+    for (const mutation of mutations) {
+      for (const removed of mutation.removedNodes) {
+        if (removed !== container)
+          continue;
+        if (retries >= maxRetries) {
+          observer.disconnect();
+          disconnected = true;
+          return;
+        }
+        if (debounceTimer)
+          clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+          if (disconnected)
+            return;
+          retries++;
+          try {
+            reinsertFn();
+          } catch {
+            observer.disconnect();
+            disconnected = true;
+          }
+        }, debounceMs);
+        return;
+      }
+    }
+  });
+  observer.observe(observeTarget, { childList: true, subtree: true });
+  return () => {
+    disconnected = true;
+    observer.disconnect();
+    if (debounceTimer)
+      clearTimeout(debounceTimer);
+  };
+}
+
 // ../adaptives/adaptive-content/dist/sanitizer.js
 var ALLOWED_TAGS = /* @__PURE__ */ new Set([
   "b",
@@ -107,8 +157,28 @@ var executeInsertHtml = async (action, context) => {
     anchorId: action.anchorId,
     position: action.position
   });
+  const reinsertFn = () => {
+    switch (action.position) {
+      case "before":
+        anchorEl.insertAdjacentElement("beforebegin", container);
+        break;
+      case "after":
+        anchorEl.insertAdjacentElement("afterend", container);
+        break;
+      case "prepend":
+        anchorEl.insertBefore(container, anchorEl.firstChild);
+        break;
+      case "append":
+        anchorEl.appendChild(container);
+        break;
+      case "replace":
+        break;
+    }
+  };
+  const guardCleanup = guardAgainstReconciliation(container, anchorEl, reinsertFn);
   return {
     cleanup: () => {
+      guardCleanup();
       if (action.position === "replace" && originalContent !== null) {
         const restoredEl = document.createElement(anchorEl.tagName);
         restoredEl.innerHTML = originalContent;
@@ -729,6 +799,10 @@ function showHighlight(anchorEl, overlayRoot, opts) {
     scrim.style.webkitClipPath = path;
   };
   const update = () => {
+    if (!anchorEl.isConnected) {
+      handle.destroy();
+      return;
+    }
     const rect = anchorEl.getBoundingClientRect();
     const x = Math.max(0, rect.left - padding);
     const y = Math.max(0, rect.top - padding);
@@ -1146,9 +1220,14 @@ function showTooltip(anchorEl, overlayRoot, opts) {
   ];
   const placement = opts.placement && opts.placement !== "auto" ? opts.placement : "top";
   const cleanup = autoUpdate(anchorEl, div, async () => {
+    if (!anchorEl.isConnected) {
+      handle.destroy();
+      return;
+    }
     const currentAnchorRef = getAnchorReference(anchorEl);
     const result = await computePosition(currentAnchorRef, div, {
       placement,
+      strategy: "fixed",
       middleware
     });
     const { x, y, strategy, middlewareData, placement: finalPlacement } = result;
@@ -1858,8 +1937,8 @@ var AppRegistry = class {
     if (!registration) {
       throw new Error(`App not registered: ${appId}`);
     }
-    if (registration.state === "active") {
-      console.warn(`[AppRegistry] App already active: ${appId}`);
+    if (registration.state === "active" || registration.state === "activating") {
+      console.warn(`[AppRegistry] App already ${registration.state}: ${appId}`);
       return;
     }
     if (!this.runtime) {
@@ -2062,21 +2141,44 @@ var appRegistry = new AppRegistry();
 var DEFAULT_CONFIG = {
   timeout: 300,
   className: "sc-anti-flicker",
-  style: "opacity: 0 !important"
+  style: "opacity: 0 !important",
+  hostLoadingSelector: "",
+  waitForHostReady: ""
 };
 function initAntiFlicker(config = {}) {
-  const { timeout, className, style } = { ...DEFAULT_CONFIG, ...config };
+  const { timeout, className, style, hostLoadingSelector, waitForHostReady } = {
+    ...DEFAULT_CONFIG,
+    ...config
+  };
+  if (hostLoadingSelector && document.querySelector(hostLoadingSelector)) {
+    return () => {
+    };
+  }
   const styleEl = document.createElement("style");
   styleEl.textContent = `.${className} { ${style} }`;
   document.head.appendChild(styleEl);
   document.documentElement.classList.add(className);
-  const timeoutId = setTimeout(() => {
-    document.documentElement.classList.remove(className);
-  }, timeout);
-  return () => {
+  let removed = false;
+  const remove = () => {
+    if (removed) return;
+    removed = true;
     clearTimeout(timeoutId);
     document.documentElement.classList.remove(className);
     styleEl.remove();
+    if (waitForHostReady && hostReadyHandler) {
+      document.removeEventListener(waitForHostReady, hostReadyHandler);
+    }
+  };
+  let hostReadyHandler;
+  if (waitForHostReady) {
+    hostReadyHandler = () => remove();
+    document.addEventListener(waitForHostReady, hostReadyHandler);
+  }
+  const timeoutId = setTimeout(() => {
+    remove();
+  }, timeout);
+  return () => {
+    remove();
   };
 }
 function getAntiFlickerSnippet(config = {}) {
@@ -2091,7 +2193,7 @@ function getAntiFlickerSnippet(config = {}) {
 }
 
 // src/version.ts
-var SDK_VERSION = "2.2.0-canary.9";
+var SDK_VERSION = "2.2.0";
 
 // src/types.ts
 var SDK_SCHEMA_VERSION = "2.0";
@@ -2202,6 +2304,44 @@ function isSameOrigin(uri) {
     return false;
   }
 }
+var CONFIG_CACHE_KEY = "syntro_config_cache";
+var CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
+function hasLocalStorage() {
+  try {
+    return typeof localStorage !== "undefined" && localStorage !== null;
+  } catch {
+    return false;
+  }
+}
+function cacheConfig(config, sdkVersion) {
+  if (!hasLocalStorage()) return;
+  try {
+    const entry = {
+      config,
+      timestamp: Date.now(),
+      sdkVersion
+    };
+    localStorage.setItem(CONFIG_CACHE_KEY, JSON.stringify(entry));
+  } catch {
+  }
+}
+function getCachedConfig(sdkVersion) {
+  if (!hasLocalStorage()) return null;
+  try {
+    const raw = localStorage.getItem(CONFIG_CACHE_KEY);
+    if (!raw) return null;
+    const entry = JSON.parse(raw);
+    if (!entry.config || typeof entry.timestamp !== "number" || !entry.sdkVersion) {
+      return null;
+    }
+    if (entry.sdkVersion !== sdkVersion) return null;
+    const age = Date.now() - entry.timestamp;
+    if (age > CACHE_MAX_AGE_MS) return null;
+    return entry.config;
+  } catch {
+    return null;
+  }
+}
 var resolveConfigUri = ({
   configUri,
   experiments,
@@ -2235,7 +2375,8 @@ var createCanvasConfigFetcher = ({
   credentials,
   configFeatureKey = "smart-canvas-config",
   manifestKey,
-  variantFlagPrefix
+  variantFlagPrefix,
+  sdkVersion
 }) => async () => {
   var _a2;
   if (experiments && configFeatureKey) {
@@ -2264,19 +2405,33 @@ var createCanvasConfigFetcher = ({
     throw new Error(`SmartCanvas: config URI not allowed: ${uri}`);
   }
   const effectiveCredentials = credentials != null ? credentials : isSameOrigin(uri) ? "include" : "omit";
-  const response = await fetch(uri, {
-    credentials: effectiveCredentials,
-    headers: {
-      "X-SDK-Version": SDK_VERSION,
-      "X-SDK-Schema-Version": SDK_SCHEMA_VERSION
+  try {
+    const response = await fetch(uri, {
+      credentials: effectiveCredentials,
+      headers: {
+        "X-SDK-Version": SDK_VERSION,
+        "X-SDK-Schema-Version": SDK_SCHEMA_VERSION
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`SmartCanvas: failed to fetch config (${response.status})`);
     }
-  });
-  if (!response.ok) {
-    throw new Error(`SmartCanvas: failed to fetch config (${response.status})`);
+    const config = await response.json();
+    debug("SmartCanvas Config", "Fetched config from URI", config);
+    if (sdkVersion) {
+      cacheConfig(config, sdkVersion);
+    }
+    return config;
+  } catch (error2) {
+    if (sdkVersion) {
+      const cached = getCachedConfig(sdkVersion);
+      if (cached) {
+        debug("SmartCanvas Config", "Serving config from offline cache");
+        return cached;
+      }
+    }
+    throw error2;
   }
-  const config = await response.json();
-  debug("SmartCanvas Config", "Fetched config from URI", config);
-  return config;
 };
 
 // src/events/registerConfigPredicates.ts
@@ -3125,26 +3280,33 @@ function useDecision(strategy, defaultValue) {
 }
 
 // src/components/TileCard.tsx
-import { useCallback as useCallback2, useEffect as useEffect5, useRef as useRef3, useState as useState4 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect5, useReducer, useRef as useRef3, useState as useState4 } from "react";
 import { jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
 function WidgetMount({ widgetId, props }) {
+  var _a2;
   const runtime3 = useRuntime();
   const containerRef = useRef3(null);
   const handleRef = useRef3(null);
   const registry = runtime3 == null ? void 0 : runtime3.widgets;
+  const widgetAvailable = (_a2 = registry == null ? void 0 : registry.has(widgetId)) != null ? _a2 : false;
+  const [, forceUpdate] = useReducer((x) => x + 1, 0);
   useEffect5(() => {
-    if (!containerRef.current || !registry) return;
-    if (!registry.has(widgetId)) {
-      console.warn(`[TileCard] Widget not found in registry: ${widgetId}`);
-      return;
-    }
+    if (!registry || widgetAvailable) return;
+    return registry.subscribe((event) => {
+      if (event.type === "registered" && event.widgetId === widgetId) {
+        forceUpdate();
+      }
+    });
+  }, [registry, widgetId, widgetAvailable]);
+  useEffect5(() => {
+    if (!containerRef.current || !registry || !widgetAvailable) return;
     const handle = registry.mount(widgetId, containerRef.current, props);
     handleRef.current = handle;
     return () => {
       handle.unmount();
       handleRef.current = null;
     };
-  }, [registry, widgetId, props]);
+  }, [registry, widgetId, props, widgetAvailable]);
   if (!registry || !registry.has(widgetId)) {
     return /* @__PURE__ */ jsxs2(
       "div",
@@ -4203,18 +4365,31 @@ function decodeParam(paramName) {
 var _cachedSource;
 var _cachedConf;
 function getEditorSource() {
-  if (_cachedSource === void 0) {
+  var _a2;
+  if (_cachedSource === void 0 || _cachedSource === null) {
     const globalParams = typeof window !== "undefined" ? window.__SYNTRO_EDITOR_PARAMS__ : null;
     if (globalParams == null ? void 0 : globalParams.token) {
       _cachedSource = { token: globalParams.token, api_base: globalParams.apiBase || "" };
+      console.log(
+        `[DIAG] getEditorSource: from __SYNTRO_EDITOR_PARAMS__ (token=${_cachedSource.token.slice(0, 15)}...)`
+      );
     } else {
-      _cachedSource = decodeParam("editor_source");
+      const decoded = decodeParam("editor_source");
+      if (decoded) {
+        _cachedSource = decoded;
+      }
+      console.log(
+        `[DIAG] getEditorSource: from URL param \u2192 ${decoded ? `token=${(_a2 = decoded.token) == null ? void 0 : _a2.slice(0, 15)}...` : "NULL"}`
+      );
+      if (!decoded && typeof window !== "undefined") {
+        console.log(`[DIAG] getEditorSource: URL search = ${window.location.search.slice(0, 200)}`);
+      }
     }
   }
-  return _cachedSource;
+  return _cachedSource != null ? _cachedSource : null;
 }
 function getEditorConf() {
-  if (_cachedConf === void 0) {
+  if (_cachedConf === void 0 || _cachedConf === null) {
     const globalParams = typeof window !== "undefined" ? window.__SYNTRO_EDITOR_PARAMS__ : null;
     if (globalParams == null ? void 0 : globalParams.mode) {
       _cachedConf = {
@@ -4223,11 +4398,18 @@ function getEditorConf() {
         syntro_token: globalParams.syntroToken,
         workspace_id: globalParams.workspaceId
       };
+      console.log(`[DIAG] getEditorConf: from __SYNTRO_EDITOR_PARAMS__ (mode=${_cachedConf.mode})`);
     } else {
-      _cachedConf = decodeParam("editor_conf");
+      const decoded = decodeParam("editor_conf");
+      if (decoded) {
+        _cachedConf = decoded;
+      }
+      console.log(
+        `[DIAG] getEditorConf: from URL param \u2192 ${decoded ? `mode=${decoded.mode}` : "NULL"}`
+      );
     }
   }
-  return _cachedConf;
+  return _cachedConf != null ? _cachedConf : null;
 }
 function validateEditorUrl(url) {
   debug("Syntro Runtime", "Validating editor URL:", url);
@@ -5145,67 +5327,96 @@ var PostHogAdapter = class {
     __publicField(this, "client");
     __publicField(this, "featureFlagsCallback");
     __publicField(this, "captureCallback");
-    var _a2, _b, _c, _d, _e, _f;
+    __publicField(this, "consentUnsub");
     this.client = options.client;
     this.featureFlagsCallback = options.onFeatureFlagsLoaded;
     this.captureCallback = options.onCapture;
+    if (!this.client && options.consent && options.requireExplicitConsent && typeof window !== "undefined" && options.apiKey) {
+      const consent = options.consent;
+      const currentStatus = consent.getStatus();
+      if (currentStatus === "granted") {
+        this.initPostHog();
+      }
+      this.consentUnsub = consent.subscribe((status) => {
+        if (status === "granted") {
+          if (!this.client) {
+            this.initPostHog();
+          } else {
+            this.client.opt_in_capturing();
+          }
+        } else if (status === "denied" && this.client) {
+          this.client.opt_out_capturing();
+        }
+      });
+      return;
+    }
     if (!this.client && typeof window !== "undefined" && options.apiKey) {
-      const enableFeatureFlags = (_a2 = options.enableFeatureFlags) != null ? _a2 : true;
-      const instanceName = `syntro_${options.apiKey.slice(-6) || "sdk"}`;
-      this.client = posthog.init(
-        options.apiKey,
-        {
-          api_host: (_b = options.apiHost) != null ? _b : "https://telemetry.syntrologie.com",
-          // Feature flags for segment membership (in_segment_* flags)
-          // When enabled, /decide is called to get segment flags
-          advanced_disable_feature_flags: !enableFeatureFlags,
-          advanced_disable_feature_flags_on_first_load: !enableFeatureFlags,
-          // Full-page tracking - all ON by default
-          autocapture: (_c = options.autocapture) != null ? _c : true,
-          capture_pageview: (_d = options.capturePageview) != null ? _d : true,
-          capture_pageleave: (_e = options.capturePageleave) != null ? _e : true,
-          disable_session_recording: !((_f = options.sessionRecording) != null ? _f : true),
-          // CRITICAL: Disable user agent filtering to allow headless Chrome
-          // PostHog blocks "HeadlessChrome" user agents by default as bot detection
-          // This enables session recording in Playwright/crawler sessions
-          opt_out_useragent_filter: true,
-          // Cross-domain iframe recording for embeds
-          session_recording: {
-            recordCrossDomainIFrames: true
-          },
-          // Capture performance metrics
-          capture_performance: true,
-          // Enable web vitals
-          enable_recording_console_log: true,
-          // Bootstrap callback for when flags are loaded
-          loaded: (ph) => {
-            if (enableFeatureFlags && this.featureFlagsCallback) {
-              ph.onFeatureFlags(() => {
-                const allFlags = this.getAllFeatureFlags();
-                if (allFlags && this.featureFlagsCallback) {
-                  this.featureFlagsCallback(allFlags);
-                }
-              });
-              const existingFlags = this.getAllFeatureFlags();
-              if (existingFlags && Object.keys(existingFlags).length > 0) {
-                this.featureFlagsCallback(existingFlags);
+      this.initPostHog();
+    }
+  }
+  /**
+   * Initialize the PostHog client. Called immediately (no consent gate)
+   * or deferred (when consent gate grants).
+   */
+  initPostHog() {
+    var _a2, _b, _c, _d, _e, _f;
+    const options = this.options;
+    if (!options.apiKey) return;
+    const enableFeatureFlags = (_a2 = options.enableFeatureFlags) != null ? _a2 : true;
+    const instanceName = `syntro_${options.apiKey.slice(-6) || "sdk"}`;
+    this.client = posthog.init(
+      options.apiKey,
+      {
+        api_host: (_b = options.apiHost) != null ? _b : "https://telemetry.syntrologie.com",
+        // Feature flags for segment membership (in_segment_* flags)
+        // When enabled, /decide is called to get segment flags
+        advanced_disable_feature_flags: !enableFeatureFlags,
+        advanced_disable_feature_flags_on_first_load: !enableFeatureFlags,
+        // Full-page tracking - all ON by default
+        autocapture: (_c = options.autocapture) != null ? _c : true,
+        capture_pageview: (_d = options.capturePageview) != null ? _d : true,
+        capture_pageleave: (_e = options.capturePageleave) != null ? _e : true,
+        disable_session_recording: !((_f = options.sessionRecording) != null ? _f : true),
+        // CRITICAL: Disable user agent filtering to allow headless Chrome
+        // PostHog blocks "HeadlessChrome" user agents by default as bot detection
+        // This enables session recording in Playwright/crawler sessions
+        opt_out_useragent_filter: true,
+        // Cross-domain iframe recording for embeds
+        session_recording: {
+          recordCrossDomainIFrames: true
+        },
+        // Capture performance metrics
+        capture_performance: true,
+        // Enable web vitals
+        enable_recording_console_log: true,
+        // Bootstrap callback for when flags are loaded
+        loaded: (ph) => {
+          if (enableFeatureFlags && this.featureFlagsCallback) {
+            ph.onFeatureFlags(() => {
+              const allFlags = this.getAllFeatureFlags();
+              if (allFlags && this.featureFlagsCallback) {
+                this.featureFlagsCallback(allFlags);
               }
-            }
-            if (this.captureCallback) {
-              ph.on("eventCaptured", (data) => {
-                var _a3;
-                const eventName = typeof data === "string" ? data : data == null ? void 0 : data.event;
-                const properties = typeof data === "string" ? void 0 : data == null ? void 0 : data.properties;
-                if (typeof eventName === "string") {
-                  (_a3 = this.captureCallback) == null ? void 0 : _a3.call(this, eventName, properties);
-                }
-              });
+            });
+            const existingFlags = this.getAllFeatureFlags();
+            if (existingFlags && Object.keys(existingFlags).length > 0) {
+              this.featureFlagsCallback(existingFlags);
             }
           }
-        },
-        instanceName
-      );
-    }
+          if (this.captureCallback) {
+            ph.on("eventCaptured", (data) => {
+              var _a3;
+              const eventName = typeof data === "string" ? data : data == null ? void 0 : data.event;
+              const properties = typeof data === "string" ? void 0 : data == null ? void 0 : data.properties;
+              if (typeof eventName === "string") {
+                (_a3 = this.captureCallback) == null ? void 0 : _a3.call(this, eventName, properties);
+              }
+            });
+          }
+        }
+      },
+      instanceName
+    );
   }
   /**
    * Get all feature flags from PostHog.
@@ -5574,6 +5785,9 @@ var executeTour = async (action, context) => {
         });
       }
     };
+    if (context.subscribeNavigation) {
+      return context.subscribeNavigation(() => checkRoute());
+    }
     window.addEventListener("popstate", checkRoute);
     const origPushState = history.pushState.bind(history);
     const origReplaceState = history.replaceState.bind(history);
@@ -6382,7 +6596,8 @@ function createActionEngine(options) {
     surfaces,
     anchorResolver,
     adaptiveId,
-    executorRegistry: executorRegistry2 = executorRegistry
+    executorRegistry: executorRegistry2 = executorRegistry,
+    subscribeNavigation
   } = options;
   const activeActions = /* @__PURE__ */ new Map();
   function generateId() {
@@ -6403,7 +6618,9 @@ function createActionEngine(options) {
       // Allow composite executors (like tours) to execute nested actions
       applyAction: apply,
       // Allow composite executors to subscribe to events
-      subscribeEvent: eventBus ? (name, callback) => eventBus.subscribe({ names: [name] }, (event) => callback(event.props)) : void 0
+      subscribeEvent: eventBus ? (name, callback) => eventBus.subscribe({ names: [name] }, (event) => callback(event.props)) : void 0,
+      // Allow composite executors to subscribe to navigation changes
+      subscribeNavigation
     };
   }
   async function executeMountWidget(action, context) {
@@ -6684,11 +6901,13 @@ var ContextManager = class {
     __publicField(this, "listeners", /* @__PURE__ */ new Set());
     __publicField(this, "telemetry");
     __publicField(this, "routes");
+    __publicField(this, "navigation");
     // Event listener cleanup functions
     __publicField(this, "cleanupFns", []);
     var _a2;
     this.telemetry = options.telemetry;
     this.routes = options.routes;
+    this.navigation = options.navigation;
     this.context = createDefaultContext();
     this.previousContext = { ...this.context };
     if ((_a2 = options.telemetry) == null ? void 0 : _a2.getSessionId) {
@@ -6769,25 +6988,30 @@ var ContextManager = class {
     };
     window.addEventListener("resize", handleResize);
     this.cleanupFns.push(() => window.removeEventListener("resize", handleResize));
-    const handlePopState = () => {
-      this.updatePage();
-    };
-    window.addEventListener("popstate", handlePopState);
-    this.cleanupFns.push(() => window.removeEventListener("popstate", handlePopState));
-    const originalPushState = history.pushState.bind(history);
-    const originalReplaceState = history.replaceState.bind(history);
-    history.pushState = (...args) => {
-      originalPushState(...args);
-      queueMicrotask(() => this.updatePage());
-    };
-    history.replaceState = (...args) => {
-      originalReplaceState(...args);
-      queueMicrotask(() => this.updatePage());
-    };
-    this.cleanupFns.push(() => {
-      history.pushState = originalPushState;
-      history.replaceState = originalReplaceState;
-    });
+    if (this.navigation) {
+      const unsub = this.navigation.subscribe(() => this.updatePage());
+      this.cleanupFns.push(unsub);
+    } else {
+      const handlePopState = () => {
+        this.updatePage();
+      };
+      window.addEventListener("popstate", handlePopState);
+      this.cleanupFns.push(() => window.removeEventListener("popstate", handlePopState));
+      const originalPushState = history.pushState.bind(history);
+      const originalReplaceState = history.replaceState.bind(history);
+      history.pushState = (...args) => {
+        originalPushState(...args);
+        queueMicrotask(() => this.updatePage());
+      };
+      history.replaceState = (...args) => {
+        originalReplaceState(...args);
+        queueMicrotask(() => this.updatePage());
+      };
+      this.cleanupFns.push(() => {
+        history.pushState = originalPushState;
+        history.replaceState = originalReplaceState;
+      });
+    }
   }
   updateViewport() {
     const newViewport = {
@@ -7432,6 +7656,79 @@ function createPostHogNormalizer(publishFn) {
   };
 }
 
+// src/navigation/NavigationMonitor.ts
+var NavigationMonitor = class {
+  constructor() {
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+    __publicField(this, "capturedPushState");
+    __publicField(this, "capturedReplaceState");
+    __publicField(this, "wasNative");
+    __publicField(this, "destroyed", false);
+    // ─── Private ─────────────────────────────────────────────────────
+    __publicField(this, "onPopState", () => {
+      this.notify(window.location.href, "popstate");
+    });
+    this.wasNative = this.isNativeFunction(history.pushState);
+    this.capturedPushState = history.pushState;
+    this.capturedReplaceState = history.replaceState;
+    history.pushState = (...args) => {
+      this.capturedPushState.call(history, ...args);
+      queueMicrotask(() => this.notify(window.location.href, "pushState"));
+    };
+    history.replaceState = (...args) => {
+      this.capturedReplaceState.call(history, ...args);
+      queueMicrotask(() => this.notify(window.location.href, "replaceState"));
+    };
+    window.addEventListener("popstate", this.onPopState);
+  }
+  /**
+   * Subscribe to navigation events.
+   * Returns an unsubscribe function.
+   */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /**
+   * Get diagnostics about the History API chain.
+   */
+  diagnose() {
+    return {
+      isNative: this.wasNative,
+      subscriberCount: this.listeners.size
+    };
+  }
+  /**
+   * Restore the History API to the state we captured and remove all listeners.
+   */
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    history.pushState = this.capturedPushState;
+    history.replaceState = this.capturedReplaceState;
+    window.removeEventListener("popstate", this.onPopState);
+    this.listeners.clear();
+  }
+  notify(url, method) {
+    if (this.destroyed) return;
+    for (const listener of this.listeners) {
+      try {
+        listener(url, method);
+      } catch {
+      }
+    }
+  }
+  isNativeFunction(fn) {
+    try {
+      return Function.prototype.toString.call(fn).includes("[native code]");
+    } catch {
+      return false;
+    }
+  }
+};
+
 // src/state/helpers/cooldowns.ts
 var COOLDOWN_PREFIX = "cooldown:";
 function createCooldownStore(storage) {
@@ -8236,6 +8533,7 @@ var WidgetRegistry = class {
     __publicField(this, "mountedWidgets", /* @__PURE__ */ new Map());
     __publicField(this, "mountIdCounter", 0);
     __publicField(this, "runtimeRef");
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
   }
   /**
    * Bind a runtime reference so it can be injected into widget mount() calls.
@@ -8266,6 +8564,7 @@ var WidgetRegistry = class {
       source,
       metadata
     });
+    this.notify({ type: "registered", widgetId: id });
   }
   /**
    * Unregister a widget.
@@ -8283,6 +8582,7 @@ var WidgetRegistry = class {
       return false;
     }
     this.widgets.delete(id);
+    this.notify({ type: "unregistered", widgetId: id });
     return true;
   }
   /**
@@ -8390,6 +8690,24 @@ var WidgetRegistry = class {
       (registration) => registration.source === source
     );
   }
+  /**
+   * Subscribe to widget registration changes.
+   */
+  subscribe(callback) {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  }
+  notify(event) {
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch (error2) {
+        console.error("[WidgetRegistry] Listener error:", error2);
+      }
+    }
+  }
   /**
    * Clean up all mounted widgets.
    */
@@ -8452,9 +8770,11 @@ function createSmartCanvasRuntime(options = {}) {
   const widgets = (_a2 = options.widgets) != null ? _a2 : widgetRegistry;
   const executors3 = (_b = options.executors) != null ? _b : executorRegistry;
   const apps = (_c = options.apps) != null ? _c : appRegistry;
+  const navigation = new NavigationMonitor();
   const context = createContextManager({
     telemetry,
-    routes
+    routes,
+    navigation
   });
   const events = (_d = options.events) != null ? _d : createEventBus();
   const state = createStateStore({
@@ -8483,7 +8803,8 @@ function createSmartCanvasRuntime(options = {}) {
     eventBus: events,
     surfaces,
     anchorResolver,
-    executorRegistry: executors3
+    executorRegistry: executors3,
+    subscribeNavigation: (callback) => navigation.subscribe(callback)
   });
   const runtime3 = {
     telemetry,
@@ -8497,6 +8818,7 @@ function createSmartCanvasRuntime(options = {}) {
     executors: executors3,
     apps,
     accumulator,
+    navigation,
     version: RUNTIME_VERSION,
     mode,
     async evaluate(strategy) {
@@ -8536,6 +8858,7 @@ function createSmartCanvasRuntime(options = {}) {
         console.error("[Runtime] Error unbinding apps registry:", err);
       });
       accumulator.destroy();
+      navigation.destroy();
       context.destroy();
       actions.destroy();
       surfaces.destroy();
@@ -8906,7 +9229,30 @@ async function init(options) {
   const auditMode = isAuditMode();
   const reviewMode = isReviewMode();
   const sdkMode = editorMode ? "editor" : auditMode ? "audit" : reviewMode ? "review" : null;
+  console.log(
+    `[DIAG] Mode detection: editor=${editorMode}, audit=${auditMode}, review=${reviewMode}, sdkMode=${sdkMode}`
+  );
+  console.log(`[DIAG] editorSource:`, getEditorSource());
+  console.log(`[DIAG] editorConf:`, getEditorConf());
   debug("Syntro Bootstrap", "SDK mode:", sdkMode != null ? sdkMode : "normal");
+  if (!sdkMode && typeof window !== "undefined") {
+    const hasEditorGlobal = !!window.__SYNTRO_EDITOR_PARAMS__;
+    const hasAuditLegend = !!window.__SYNTRO_AUDIT_LEGEND__;
+    const hasReviewData = !!window.__SYNTRO_REVIEW_DATA__;
+    if (hasEditorGlobal || hasAuditLegend || hasReviewData) {
+      const globals = [
+        hasEditorGlobal && "__SYNTRO_EDITOR_PARAMS__",
+        hasAuditLegend && "__SYNTRO_AUDIT_LEGEND__",
+        hasReviewData && "__SYNTRO_REVIEW_DATA__"
+      ].filter(Boolean);
+      console.warn(
+        `[Syntro Bootstrap] \u26A0 Mode detection returned null but mode-specific globals found: ${globals.join(", ")}. This suggests URL params were lost (redirect?) but the service worker injected mode data. Check if replaceState failed or if page JS changed the URL before init().`
+      );
+    }
+  }
+  console.log(
+    `[DIAG] Token resolution: options.token=${options.token ? options.token.slice(0, 15) + "..." : "null"}`
+  );
   let resolvedToken = options.token;
   if (!resolvedToken && sdkMode) {
     const conf = getEditorConf();
@@ -9045,15 +9391,24 @@ async function init(options) {
     debug("Syntro Bootstrap", "Global SynOS object exposed");
   }
   const registeredApps = (_e = (_d = (_c = runtime3.apps).list) == null ? void 0 : _d.call(_c)) != null ? _e : [];
+  console.log(
+    `[DIAG] Activation loop: ${registeredApps.length} apps in registry:`,
+    registeredApps.map((a) => `${a.manifest.id}(${a.state})`).join(", ")
+  );
   for (const app of registeredApps) {
     if (app.state === "registered") {
       try {
         await runtime3.apps.activate(app.manifest.id);
+        console.log(
+          `[DIAG] Activated: ${app.manifest.id} \u2192 widgets: [${runtime3.widgets.list().join(", ")}]`
+        );
       } catch (err) {
+        console.error(`[DIAG] FAILED to activate: ${app.manifest.id}`, err);
         warn("Syntro Bootstrap", `Failed to auto-activate built-in app: ${app.manifest.id}`, err);
       }
     }
   }
+  console.log(`[DIAG] Activation complete. Total widgets: [${runtime3.widgets.list().join(", ")}]`);
   if (experiments == null ? void 0 : experiments.refreshFeatures) {
     try {
       await experiments.refreshFeatures();
@@ -9241,6 +9596,7 @@ export {
   normalizePostHogEvent,
   shouldNormalizeEvent,
   createPostHogNormalizer,
+  NavigationMonitor,
   StateStore,
   createStateStore,
   getSlotType,
@@ -9263,4 +9619,4 @@ export {
   encodeToken,
   Syntro
 };
-//# sourceMappingURL=chunk-UEAP7WOK.js.map
+//# sourceMappingURL=chunk-V4MDQX67.js.map