@syntrologie/runtime-sdk 2.4.0-canary.2 → 2.4.0-canary.21

package/dist/decisions/schema.js

@@ -3,12 +3,14 @@ import {
   AnchorVisibleConditionZ,
   ConditionZ,
   CooldownActiveConditionZ,
+  CounterDefZ,
   DecisionStrategyZ,
   DismissedConditionZ,
   EventCountConditionZ,
   EventOccurredConditionZ,
   ExternalStrategyZ,
   FrequencyLimitConditionZ,
+  MatchOpZ,
   ModelStrategyZ,
   PageUrlConditionZ,
   RouteConditionZ,
@@ -23,19 +25,20 @@ import {
   validateActivationConfig,
   validateCondition,
   validateStrategy
-} from "../chunk-BIYMC56J.js";
-import "../chunk-JMHRHAEL.js";
+} from "../chunk-P5G4KT2U.js";
 export {
   ActivationConfigZ,
   AnchorVisibleConditionZ,
   ConditionZ,
   CooldownActiveConditionZ,
+  CounterDefZ,
   DecisionStrategyZ,
   DismissedConditionZ,
   EventCountConditionZ,
   EventOccurredConditionZ,
   ExternalStrategyZ,
   FrequencyLimitConditionZ,
+  MatchOpZ,
   ModelStrategyZ,
   PageUrlConditionZ,
   RouteConditionZ,

package/dist/decisions/types.d.ts

@@ -110,6 +110,25 @@ export interface FrequencyLimitCondition {
     /** Invert the condition (true if limit NOT reached) */
     inverted?: boolean;
 }
+/**
+ * Match operator for counter filters.
+ * Exactly one of `equals` or `contains` must be specified.
+ */
+export interface MatchOp {
+    equals?: string | number | boolean;
+    contains?: string;
+}
+/**
+ * Defines what events to count for an event_count condition.
+ * Registered as an accumulator predicate at config-load time.
+ */
+export interface CounterDef {
+    /** Event names to listen for (e.g., ["ui.click"]). ALL other filters AND with this. */
+    events: string[];
+    /** Prop-based filters. Keys are event prop names OR element-chain fields
+     *  (tag_name, $el_text, attr__*). All entries AND together. */
+    match?: Record<string, MatchOp>;
+}
 /**
  * Condition that checks accumulated event counts.
  * Used for behavior triggers like "visited /pricing 3+ times".
@@ -125,6 +144,9 @@ export interface EventCountCondition {
     count: number;
     /** Only count events within this time window (ms). Omit = session lifetime. */
     withinMs?: number;
+    /** Inline counter definition. Defines what events to count.
+     *  If omitted, predicate is pass-through (counts all events). */
+    counter?: CounterDef;
 }
 /**
  * Union of all condition types.

package/dist/events/registerConfigPredicates.d.ts

@@ -1,19 +1,16 @@
 /**
  * Register accumulator predicates from tile configs at config-load time.
  *
- * Previously, predicate registration lived inside FAQWidget's useEffect —
- * meaning predicates were only active when the widget was mounted (canvas open).
- * On multi-page apps with `defaultOpen: false`, the canvas stays closed after
- * navigation, the widget never mounts, and clicks go uncounted.
+ * Scans all triggerWhen conditions (in tile actions and top-level actions)
+ * for event_count conditions with a `counter` definition. For each, builds
+ * a predicate and registers it with the accumulator.
  *
- * This module extracts that logic so predicates are registered as soon as the
- * config is loaded, regardless of canvas state.
+ * Safe to call multiple times — accumulator.register() is idempotent.
  */
 import type { TileConfig } from '../types';
 import type { EventAccumulator } from './EventAccumulator';
 /**
- * Scan tile configs for scope + showWhen event_count conditions and register
- * accumulator predicates. Safe to call multiple times — accumulator.register()
- * is idempotent (skips if key already registered).
+ * Scan tile configs and top-level actions for event_count conditions
+ * and register accumulator predicates from their counter definitions.
  */
-export declare function registerConfigPredicates(tiles: TileConfig[], accumulator: EventAccumulator): void;
+export declare function registerConfigPredicates(tiles: TileConfig[], accumulator: EventAccumulator, actions?: unknown[]): void;

package/dist/events/schema.d.ts

@@ -10,15 +10,15 @@ export declare const NormalizedEventZ: z.ZodObject<{
     props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     schemaVersion: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }, {
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }>;
@@ -29,25 +29,25 @@ export declare const EventFilterZ: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }, {
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }>;
 /**
  * Validate a NormalizedEvent object.
  */
 export declare function validateNormalizedEvent(data: unknown): z.SafeParseReturnType<{
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }, {
-    source: "posthog" | "canvas" | "derived";
-    name: string;
     schemaVersion: string;
+    source: "canvas" | "posthog" | "derived";
+    name: string;
     ts: number;
     props?: Record<string, unknown> | undefined;
 }>;
@@ -57,11 +57,11 @@ export declare function validateNormalizedEvent(data: unknown): z.SafeParseRetur
 export declare function validateEventFilter(data: unknown): z.SafeParseReturnType<{
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }, {
     names?: string[] | undefined;
     patterns?: string[] | undefined;
-    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
 }>;
 /**
  * Type inference from Zod schema.

package/dist/experiments/adapters/growthbook.d.ts

@@ -43,6 +43,7 @@ export interface GrowthBookAdapterOptions extends GrowthBookInitOptions {
  */
 export declare class GrowthBookAdapter implements ExperimentClient {
     private readonly gb;
+    private readonly featureListeners;
     constructor(options?: GrowthBookAdapterOptions);
     /**
      * Access to the underlying GrowthBook instance.
@@ -55,6 +56,7 @@ export declare class GrowthBookAdapter implements ExperimentClient {
     getFeatureValue<T>(key: string, fallback: T): T;
     getAllFeatures(): Record<string, unknown>;
     shouldRenderRectangle(_tile: TileConfig): boolean;
+    onFeaturesChanged(callback: () => void): () => void;
 }
 /**
  * Create an ExperimentClient backed by GrowthBook.

package/dist/experiments/types.d.ts

@@ -32,6 +32,13 @@ export interface ExperimentClient {
      * Returns a map of feature key -> feature value.
      */
     getAllFeatures?(): Record<string, unknown>;
+    /**
+     * Subscribe to feature flag value changes.
+     * Called when the underlying provider receives updated feature values
+     * (e.g., via streaming, webhook, or manual refresh).
+     * Returns an unsubscribe function.
+     */
+    onFeaturesChanged?(callback: () => void): () => void;
 }
 /**
  * @deprecated Use ExperimentClient instead

package/dist/hooks/useShadowCanvasConfig.d.ts

@@ -3,11 +3,13 @@ import type { SmartCanvasRuntime } from '../runtime';
 import type { ActionStep, CanvasConfigFetcher, CanvasThemeConfig, LauncherConfig, TileConfig } from '../types';
 export interface UseShadowCanvasConfigOptions {
     fetcher: CanvasConfigFetcher;
-    pollIntervalMs?: number;
     /** @deprecated Use runtime instead */
     experiments?: ExperimentClient;
     /** v2 Runtime for activation-based filtering */
     runtime?: SmartCanvasRuntime;
+    /** Current page URL — triggers re-filter when URL changes (route-based activation).
+     *  Full URL (not just pathname) so hash-based routing also triggers re-filter. */
+    pageUrl?: string;
 }
 export interface ShadowCanvasConfigState {
     tiles: TileConfig[];
@@ -24,4 +26,4 @@ export interface ShadowCanvasConfigState {
     /** Launcher button configuration */
     launcher?: LauncherConfig;
 }
-export declare function useShadowCanvasConfig({ fetcher, pollIntervalMs, experiments, runtime, }: UseShadowCanvasConfigOptions): ShadowCanvasConfigState;
+export declare function useShadowCanvasConfig({ fetcher, experiments, runtime, pageUrl, }: UseShadowCanvasConfigOptions): ShadowCanvasConfigState;

package/dist/index.d.ts

@@ -20,6 +20,7 @@ export * from './telemetry';
 export * from './types';
 export * from './version';
 export * from './actions';
+export * from './anchor';
 export * from './apps';
 export * from './context';
 export * from './decisions';

package/dist/index.js

@@ -30,10 +30,9 @@ import {
   appRegistry,
   applyStaticSlotStyles,
   base,
-  border,
-  brand,
   cleanupAppContext,
   createActionEngine,
+  createAnchorResolver,
   createAppContext,
   createAppLoader,
   createCanvasConfigFetcher,
@@ -101,9 +100,10 @@ import {
   validateAction,
   validateActions,
   widgetRegistry
-} from "./chunk-ZDZ3IYFN.js";
+} from "./chunk-IPU3WVPY.js";
 import {
   AddClassZ,
+  AnchorIdZ,
   BadgePositionZ,
   BadgeZ,
   CtaButtonZ,
@@ -134,18 +134,21 @@ import {
   WaitZ,
   WidgetConfigZ,
   coreActionStepSchemas
-} from "./chunk-DOJR7R46.js";
+} from "./chunk-HF3D7YFQ.js";
+import "./chunk-2UYZ5DWI.js";
 import {
   ActivationConfigZ,
   AnchorVisibleConditionZ,
   ConditionZ,
   CooldownActiveConditionZ,
+  CounterDefZ,
   DecisionStrategyZ,
   DismissedConditionZ,
   EventCountConditionZ,
   EventOccurredConditionZ,
   ExternalStrategyZ,
   FrequencyLimitConditionZ,
+  MatchOpZ,
   ModelStrategyZ,
   PageUrlConditionZ,
   RouteConditionZ,
@@ -160,8 +163,7 @@ import {
   validateActivationConfig,
   validateCondition,
   validateStrategy
-} from "./chunk-BIYMC56J.js";
-import "./chunk-JMHRHAEL.js";
+} from "./chunk-P5G4KT2U.js";
 
 // src/index.ts
 import React4 from "react";
@@ -841,14 +843,18 @@ var themeStyles = {
     }
   }
 };
-function FAQItem({ item, isExpanded, onToggle, theme, feedbackConfig, feedbackValue, onFeedback }) {
+function FAQItem({ item, isExpanded, isHighlighted, onToggle, theme, feedbackConfig, feedbackValue, onFeedback }) {
   const [isHovered, setIsHovered] = useState2(false);
   const colors = themeStyles[theme];
   const { question, answer } = item.config;
   const itemStyle = {
     ...baseStyles.item,
     ...colors.item,
-    ...isExpanded ? colors.itemExpanded : {}
+    ...isExpanded ? colors.itemExpanded : {},
+    ...isHighlighted ? {
+      boxShadow: "0 0 0 2px #6366f1, 0 0 12px rgba(99, 102, 241, 0.4)",
+      transition: "box-shadow 0.3s ease"
+    } : {}
   };
   const questionStyle = {
     ...baseStyles.question,
@@ -880,6 +886,7 @@ function FAQItem({ item, isExpanded, onToggle, theme, feedbackConfig, feedbackVa
 function FAQWidget({ config, runtime: runtime7, instanceId }) {
   const [renderTick, forceUpdate] = useReducer((x) => x + 1, 0);
   const [expandedIds, setExpandedIds] = useState2(/* @__PURE__ */ new Set());
+  const [highlightId, setHighlightId] = useState2(null);
   const [searchQuery, setSearchQuery] = useState2("");
   const [feedbackState, setFeedbackState] = useState2(/* @__PURE__ */ new Map());
   const feedbackConfig = useMemo(() => resolveFeedbackConfig(config.feedback), [config.feedback]);
@@ -897,43 +904,6 @@ function FAQWidget({ config, runtime: runtime7, instanceId }) {
       forceUpdate();
     });
   }, [runtime7.accumulator]);
-  useEffect2(() => {
-    var _a, _b;
-    if (!config.scope || !((_a = runtime7.accumulator) == null ? void 0 : _a.register))
-      return;
-    const { events: eventNames, urlContains, props: propFilters } = config.scope;
-    const keys = /* @__PURE__ */ new Set();
-    for (const action of config.actions) {
-      if (((_b = action.showWhen) == null ? void 0 : _b.type) === "rules") {
-        for (const rule of action.showWhen.rules) {
-          for (const cond of rule.conditions) {
-            if (cond.type === "event_count" && cond.key) {
-              keys.add(cond.key);
-            }
-          }
-        }
-      }
-    }
-    for (const key of keys) {
-      runtime7.accumulator.register(key, (event) => {
-        var _a2, _b2, _c;
-        if (!eventNames.includes(event.name))
-          return false;
-        if (urlContains) {
-          const pathname = String((_b2 = (_a2 = event.props) == null ? void 0 : _a2.pathname) != null ? _b2 : "");
-          if (!pathname.includes(urlContains))
-            return false;
-        }
-        if (propFilters) {
-          for (const [k, v] of Object.entries(propFilters)) {
-            if (((_c = event.props) == null ? void 0 : _c[k]) !== v)
-              return false;
-          }
-        }
-        return true;
-      });
-    }
-  }, [config.scope, config.actions, runtime7.accumulator]);
   useEffect2(() => {
     if (!runtime7.events.subscribe)
       return;
@@ -970,10 +940,43 @@ function FAQWidget({ config, runtime: runtime7, instanceId }) {
     });
     return unsubscribe;
   }, [runtime7]);
+  useEffect2(() => {
+    if (!runtime7.events.subscribe)
+      return;
+    const handleDeepLink = (event) => {
+      var _a, _b;
+      const tileId = (_a = event.props) == null ? void 0 : _a.tileId;
+      const itemId = (_b = event.props) == null ? void 0 : _b.itemId;
+      if (tileId !== instanceId)
+        return;
+      if (!itemId)
+        return;
+      setExpandedIds(/* @__PURE__ */ new Set([itemId]));
+      setHighlightId(itemId);
+      setTimeout(() => setHighlightId(null), 1500);
+      requestAnimationFrame(() => {
+        const el = document.querySelector(`[data-faq-item-id="${itemId}"]`);
+        if (el)
+          el.scrollIntoView({ behavior: "smooth", block: "center" });
+      });
+    };
+    if (runtime7.events.getRecent) {
+      const recent = runtime7.events.getRecent({ names: ["notification.deep_link"] }, 5);
+      const pending = recent.filter((e) => {
+        var _a, _b;
+        return ((_a = e.props) == null ? void 0 : _a.tileId) === instanceId && ((_b = e.props) == null ? void 0 : _b.itemId);
+      }).pop();
+      if (pending && Date.now() - pending.ts < 1e4) {
+        handleDeepLink(pending);
+      }
+    }
+    const unsubscribe = runtime7.events.subscribe({ names: ["notification.deep_link"] }, handleDeepLink);
+    return unsubscribe;
+  }, [runtime7, instanceId]);
   const visibleQuestions = useMemo(() => config.actions.filter((q) => {
-    if (!q.showWhen)
+    if (!q.triggerWhen)
       return true;
-    const result = runtime7.evaluateSync(q.showWhen);
+    const result = runtime7.evaluateSync(q.triggerWhen);
     return result.value;
   }), [config.actions, runtime7, renderTick]);
   const orderedQuestions = useMemo(() => {
@@ -1067,7 +1070,7 @@ function FAQWidget({ config, runtime: runtime7, instanceId }) {
     ...baseStyles.categoryHeader,
     ...themeStyles[resolvedTheme].categoryHeader
   };
-  const renderItems = (items) => items.map((q) => _jsx2(FAQItem, { item: q, isExpanded: expandedIds.has(q.config.id), onToggle: () => handleToggle(q.config.id), theme: resolvedTheme, feedbackConfig, feedbackValue: feedbackState.get(q.config.id), onFeedback: handleFeedback }, q.config.id));
+  const renderItems = (items) => items.map((q) => _jsx2(FAQItem, { item: q, isExpanded: expandedIds.has(q.config.id), isHighlighted: highlightId === q.config.id, onToggle: () => handleToggle(q.config.id), theme: resolvedTheme, feedbackConfig, feedbackValue: feedbackState.get(q.config.id), onFeedback: handleFeedback }, q.config.id));
   if (visibleQuestions.length === 0) {
     return _jsx2("div", { style: containerStyle, "data-adaptive-id": instanceId, "data-adaptive-type": "adaptive-faq", children: _jsx2("div", { style: emptyStateStyle, children: "No FAQ questions available." }) });
   }
@@ -1136,14 +1139,14 @@ var runtime4 = {
   /**
    * Extract notify watcher entries from tile config props.
    * The runtime evaluates these continuously (even with drawer closed)
-   * and publishes faq:question_revealed when showWhen transitions false → true.
+   * and publishes faq:question_revealed when triggerWhen transitions false → true.
    */
   notifyWatchers(props) {
     var _a;
     const actions = (_a = props.actions) != null ? _a : [];
-    return actions.filter((a) => a.notify && a.showWhen).map((a) => ({
+    return actions.filter((a) => a.notify && a.triggerWhen).map((a) => ({
       id: `faq:${a.config.id}`,
-      strategy: a.showWhen,
+      strategy: a.triggerWhen,
       eventName: "faq:question_revealed",
       eventProps: {
         questionId: a.config.id,
@@ -1403,48 +1406,11 @@ function NavWidget({ config, runtime: runtime7, instanceId }) {
       forceUpdate();
     });
   }, [runtime7.accumulator]);
-  useEffect3(() => {
-    var _a, _b;
-    if (!config.scope || !((_a = runtime7.accumulator) == null ? void 0 : _a.register))
-      return;
-    const { events: eventNames, urlContains, props: propFilters } = config.scope;
-    const keys = /* @__PURE__ */ new Set();
-    for (const action of config.actions) {
-      if (((_b = action.showWhen) == null ? void 0 : _b.type) === "rules") {
-        for (const rule of action.showWhen.rules) {
-          for (const cond of rule.conditions) {
-            if (cond.type === "event_count" && cond.key) {
-              keys.add(cond.key);
-            }
-          }
-        }
-      }
-    }
-    for (const key of keys) {
-      runtime7.accumulator.register(key, (event) => {
-        var _a2, _b2, _c;
-        if (!eventNames.includes(event.name))
-          return false;
-        if (urlContains) {
-          const pathname = String((_b2 = (_a2 = event.props) == null ? void 0 : _a2.pathname) != null ? _b2 : "");
-          if (!pathname.includes(urlContains))
-            return false;
-        }
-        if (propFilters) {
-          for (const [k, v] of Object.entries(propFilters)) {
-            if (((_c = event.props) == null ? void 0 : _c[k]) !== v)
-              return false;
-          }
-        }
-        return true;
-      });
-    }
-  }, [config.scope, config.actions, runtime7.accumulator]);
   const visibleTips = useMemo2(() => config.actions.filter((tip) => {
-    if (!tip.showWhen)
+    if (!tip.triggerWhen)
       return true;
     try {
-      const result = runtime7.evaluateSync(tip.showWhen);
+      const result = runtime7.evaluateSync(tip.triggerWhen);
       return result.value;
     } catch {
       return false;
@@ -1518,7 +1484,9 @@ function NavWidget({ config, runtime: runtime7, instanceId }) {
     if (external) {
       window.open(href, "_blank", "noopener,noreferrer");
     } else {
-      window.location.href = href;
+      const url = new URL(href, window.location.origin);
+      url.search = window.location.search;
+      window.location.href = url.toString();
     }
   }, [runtime7.events, instanceId]);
   const containerStyle = {
@@ -1580,7 +1548,9 @@ var executeScrollTo = async (action, context) => {
   var _a, _b, _c, _d;
   const anchorEl = context.resolveAnchor(action.anchorId);
   if (!anchorEl) {
-    throw new Error(`Anchor not found: ${action.anchorId}`);
+    console.error(`[adaptive-nav] Anchor not found for scrollTo, skipping: ${action.anchorId.selector}`);
+    return { cleanup: () => {
+    } };
   }
   anchorEl.scrollIntoView({
     behavior: (_a = action.behavior) != null ? _a : "smooth",
@@ -1662,14 +1632,14 @@ var runtime6 = {
   /**
    * Extract notify watcher entries from tile config props.
    * The runtime evaluates these continuously (even with drawer closed)
-   * and publishes nav:tip_revealed when showWhen transitions false → true.
+   * and publishes nav:tip_revealed when triggerWhen transitions false → true.
    */
   notifyWatchers(props) {
     var _a;
     const actions = (_a = props.actions) != null ? _a : [];
-    return actions.filter((a) => a.notify && a.showWhen).map((a) => ({
+    return actions.filter((a) => a.notify && a.triggerWhen).map((a) => ({
       id: `nav:${a.config.id}`,
-      strategy: a.showWhen,
+      strategy: a.triggerWhen,
       eventName: "nav:tip_revealed",
       eventProps: {
         tipId: a.config.id,
@@ -1744,8 +1714,8 @@ function TileWheel({ tiles, intervalMs = 7e3, telemetry }) {
         position: "relative",
         overflow: "hidden",
         borderRadius: "1.5rem",
-        border: `1px solid ${border.primary}`,
-        background: slateGrey[1],
+        border: "var(--sc-tile-border)",
+        background: "var(--sc-tile-background)",
         padding: "1.5rem",
         boxShadow: "0 25px 50px -12px rgba(0, 0, 0, 0.25)"
       },
@@ -1771,7 +1741,7 @@ function TileWheel({ tiles, intervalMs = 7e3, telemetry }) {
               height: "0.5rem",
               width: "1.5rem",
               borderRadius: "9999px",
-              background: idx === index ? brand[3] : slateGrey[6],
+              background: idx === index ? "var(--sc-color-primary)" : "var(--sc-tile-text-color)",
               border: "none",
               cursor: "pointer",
               padding: 0
@@ -2086,6 +2056,7 @@ export {
   ANIMATION_KEYFRAMES,
   ActivationConfigZ,
   AddClassZ,
+  AnchorIdZ,
   AnchorStateZ,
   AnchorVisibleConditionZ,
   AppRegistry,
@@ -2098,6 +2069,7 @@ export {
   ConditionZ,
   ContextManager,
   CooldownActiveConditionZ,
+  CounterDefZ,
   CtaButtonZ,
   DEFAULT_COOLDOWN,
   DEFAULT_TTL,
@@ -2119,6 +2091,7 @@ export {
   InsertHtmlZ,
   InsertPositionZ,
   MAX_VISIBLE_TOASTS,
+  MatchOpZ,
   ModalContentZ,
   ModalZ,
   ModelStrategyZ,
@@ -2187,6 +2160,7 @@ export {
   runtime as contentRuntime,
   coreActionStepSchemas,
   createActionEngine,
+  createAnchorResolver,
   createAppContext,
   createAppLoader,
   createCanvasConfigFetcher,