@syntrologie/runtime-sdk 2.4.1 → 2.6.0-canary.1

package/dist/overlays/schema.d.ts

@@ -15,11 +15,11 @@ export declare const SelectorZ: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"css">;
     value: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    value: string;
     type: "css";
-}, {
     value: string;
+}, {
     type: "css";
+    value: string;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"aria">;
     role: z.ZodOptional<z.ZodString>;
@@ -36,11 +36,11 @@ export declare const SelectorZ: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"shadow-css">;
     value: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    value: string;
     type: "shadow-css";
-}, {
     value: string;
+}, {
     type: "shadow-css";
+    value: string;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"ref">;
     el: z.ZodAny;
@@ -70,11 +70,11 @@ export declare const TooltipStepZ: z.ZodObject<{
         type: z.ZodLiteral<"css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "css";
-    }, {
         value: string;
+    }, {
         type: "css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"aria">;
         role: z.ZodOptional<z.ZodString>;
@@ -91,11 +91,11 @@ export declare const TooltipStepZ: z.ZodObject<{
         type: z.ZodLiteral<"shadow-css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "shadow-css";
-    }, {
         value: string;
+    }, {
         type: "shadow-css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"ref">;
         el: z.ZodAny;
@@ -125,13 +125,13 @@ export declare const TooltipStepZ: z.ZodObject<{
         closeButton: z.ZodOptional<z.ZodBoolean>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        timeoutMs?: number | undefined;
         onEsc?: boolean | undefined;
         closeButton?: boolean | undefined;
-    }, {
         timeoutMs?: number | undefined;
+    }, {
         onEsc?: boolean | undefined;
         closeButton?: boolean | undefined;
+        timeoutMs?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     kind: "tooltip";
@@ -145,15 +145,15 @@ export declare const TooltipStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
@@ -162,9 +162,9 @@ export declare const TooltipStepZ: z.ZodObject<{
     placement?: "top" | "right" | "bottom" | "left" | "auto" | undefined;
     blocking?: boolean | undefined;
     dismiss?: {
-        timeoutMs?: number | undefined;
         onEsc?: boolean | undefined;
         closeButton?: boolean | undefined;
+        timeoutMs?: number | undefined;
     } | undefined;
     offsetPx?: number | undefined;
 }, {
@@ -179,15 +179,15 @@ export declare const TooltipStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
@@ -196,9 +196,9 @@ export declare const TooltipStepZ: z.ZodObject<{
     placement?: "top" | "right" | "bottom" | "left" | "auto" | undefined;
     blocking?: boolean | undefined;
     dismiss?: {
-        timeoutMs?: number | undefined;
         onEsc?: boolean | undefined;
         closeButton?: boolean | undefined;
+        timeoutMs?: number | undefined;
     } | undefined;
     offsetPx?: number | undefined;
 }>;
@@ -221,11 +221,11 @@ export declare const HighlightStepZ: z.ZodObject<{
         type: z.ZodLiteral<"css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "css";
-    }, {
         value: string;
+    }, {
         type: "css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"aria">;
         role: z.ZodOptional<z.ZodString>;
@@ -242,11 +242,11 @@ export declare const HighlightStepZ: z.ZodObject<{
         type: z.ZodLiteral<"shadow-css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "shadow-css";
-    }, {
         value: string;
+    }, {
         type: "shadow-css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"ref">;
         el: z.ZodAny;
@@ -282,12 +282,12 @@ export declare const HighlightStepZ: z.ZodObject<{
         onEsc: z.ZodOptional<z.ZodBoolean>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        timeoutMs?: number | undefined;
         onEsc?: boolean | undefined;
+        timeoutMs?: number | undefined;
         onClickOutside?: boolean | undefined;
     }, {
-        timeoutMs?: number | undefined;
         onEsc?: boolean | undefined;
+        timeoutMs?: number | undefined;
         onClickOutside?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -298,15 +298,15 @@ export declare const HighlightStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
@@ -316,8 +316,8 @@ export declare const HighlightStepZ: z.ZodObject<{
         opacity?: number | undefined;
     } | undefined;
     dismiss?: {
-        timeoutMs?: number | undefined;
         onEsc?: boolean | undefined;
+        timeoutMs?: number | undefined;
         onClickOutside?: boolean | undefined;
     } | undefined;
     copy?: string | undefined;
@@ -334,15 +334,15 @@ export declare const HighlightStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
@@ -352,8 +352,8 @@ export declare const HighlightStepZ: z.ZodObject<{
         opacity?: number | undefined;
     } | undefined;
     dismiss?: {
-        timeoutMs?: number | undefined;
         onEsc?: boolean | undefined;
+        timeoutMs?: number | undefined;
         onClickOutside?: boolean | undefined;
     } | undefined;
     copy?: string | undefined;
@@ -386,11 +386,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "css";
-        }, {
             value: string;
+        }, {
             type: "css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"aria">;
             role: z.ZodOptional<z.ZodString>;
@@ -407,11 +407,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"shadow-css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "shadow-css";
-        }, {
             value: string;
+        }, {
             type: "shadow-css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"ref">;
             el: z.ZodAny;
@@ -441,13 +441,13 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             closeButton: z.ZodOptional<z.ZodBoolean>;
             timeoutMs: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
             closeButton?: boolean | undefined;
-        }, {
             timeoutMs?: number | undefined;
+        }, {
             onEsc?: boolean | undefined;
             closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         kind: "tooltip";
@@ -461,15 +461,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -478,9 +478,9 @@ export declare const CanvasRecipeZ: z.ZodObject<{
         placement?: "top" | "right" | "bottom" | "left" | "auto" | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
             closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
         } | undefined;
         offsetPx?: number | undefined;
     }, {
@@ -495,15 +495,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -512,9 +512,9 @@ export declare const CanvasRecipeZ: z.ZodObject<{
         placement?: "top" | "right" | "bottom" | "left" | "auto" | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
             closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
         } | undefined;
         offsetPx?: number | undefined;
     }>, z.ZodObject<{
@@ -536,11 +536,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "css";
-        }, {
             value: string;
+        }, {
             type: "css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"aria">;
             role: z.ZodOptional<z.ZodString>;
@@ -557,11 +557,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"shadow-css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "shadow-css";
-        }, {
             value: string;
+        }, {
             type: "shadow-css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"ref">;
             el: z.ZodAny;
@@ -597,12 +597,12 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             onEsc: z.ZodOptional<z.ZodBoolean>;
             timeoutMs: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
+            timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         }, {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
+            timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
@@ -613,15 +613,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -631,8 +631,8 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             opacity?: number | undefined;
         } | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
+            timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
         copy?: string | undefined;
@@ -649,15 +649,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -667,8 +667,8 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             opacity?: number | undefined;
         } | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
+            timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
         copy?: string | undefined;
@@ -691,15 +691,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -708,9 +708,9 @@ export declare const CanvasRecipeZ: z.ZodObject<{
         placement?: "top" | "right" | "bottom" | "left" | "auto" | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
             closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
         } | undefined;
         offsetPx?: number | undefined;
     } | {
@@ -721,15 +721,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -739,8 +739,8 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             opacity?: number | undefined;
         } | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
+            timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
         copy?: string | undefined;
@@ -766,15 +766,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -783,9 +783,9 @@ export declare const CanvasRecipeZ: z.ZodObject<{
         placement?: "top" | "right" | "bottom" | "left" | "auto" | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
             closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
         } | undefined;
         offsetPx?: number | undefined;
     } | {
@@ -796,15 +796,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -814,8 +814,8 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             opacity?: number | undefined;
         } | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
+            timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
         copy?: string | undefined;
@@ -842,15 +842,15 @@ export declare function validateRecipe(json: unknown): {
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -859,9 +859,9 @@ export declare function validateRecipe(json: unknown): {
         placement?: "top" | "right" | "bottom" | "left" | "auto" | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
             closeButton?: boolean | undefined;
+            timeoutMs?: number | undefined;
         } | undefined;
         offsetPx?: number | undefined;
     } | {
@@ -872,15 +872,15 @@ export declare function validateRecipe(json: unknown): {
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -890,8 +890,8 @@ export declare function validateRecipe(json: unknown): {
             opacity?: number | undefined;
         } | undefined;
         dismiss?: {
-            timeoutMs?: number | undefined;
             onEsc?: boolean | undefined;
+            timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
         copy?: string | undefined;

package/dist/react.js

@@ -1,8 +1,9 @@
 import {
   Syntro
-} from "./chunk-QGWATS3Z.js";
-import "./chunk-OGTCFYR3.js";
-import "./chunk-4NYS7GAW.js";
+} from "./chunk-Q4WGXNKC.js";
+import "./chunk-R5DNAIRI.js";
+import "./chunk-XDYJ64IN.js";
+import "./chunk-BU4Z6PD7.js";
 
 // src/react.tsx
 import { createContext, useContext, useEffect, useRef, useState } from "react";

package/dist/react.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/react.tsx"],
   "sourcesContent": ["/**\n * React bindings for the Syntro SDK.\n *\n * Usage:\n * ```tsx\n * import { SyntroProvider, useSyntro } from '@syntrologie/runtime-sdk/react';\n *\n * function App() {\n *   return (\n *     <SyntroProvider token=\"syn_xxx\">\n *       <MyApp />\n *     </SyntroProvider>\n *   );\n * }\n *\n * function MyComponent() {\n *   const { canvas, experiments, telemetry, isReady } = useSyntro();\n *   // ...\n * }\n * ```\n */\nimport { createContext, type ReactNode, useContext, useEffect, useRef, useState } from 'react';\n\nimport type { SmartCanvasHandle } from './api';\nimport { Syntro, type SyntroInitOptions, type SyntroInitResult } from './bootstrap';\nimport type { ExperimentClient } from './experiments/types';\nimport type { TelemetryClient } from './telemetry/types';\n\nexport interface SyntroContextValue {\n  /** The SmartCanvas handle */\n  canvas: SmartCanvasHandle | null;\n  /** The experiment client */\n  experiments: ExperimentClient | null;\n  /** The telemetry client */\n  telemetry: TelemetryClient | null;\n  /** Whether the SDK has finished initializing */\n  isReady: boolean;\n  /** Any error that occurred during initialization */\n  error: Error | null;\n}\n\nconst SyntroContext = createContext<SyntroContextValue | null>(null);\n\n// Global tracking to handle React Strict Mode double-mounting\nlet globalInitPromise: Promise<SyntroInitResult> | null = null;\nlet globalInitToken: string | null = null;\n\nexport interface SyntroProviderProps {\n  /**\n   * The Syntro token containing all credentials.\n   */\n  token: string;\n\n  /**\n   * Optional canvas configuration overrides.\n   */\n  canvasOptions?: SyntroInitOptions['canvas'];\n\n  /**\n   * Custom config fetcher to override the default experiment-based fetcher.\n   * Use this for local development or when bypassing the experiment server.\n   */\n  fetcher?: SyntroInitOptions['fetcher'];\n\n  /**\n   * Children to render.\n   */\n  children: ReactNode;\n\n  /**\n   * Called when initialization completes.\n   */\n  onReady?: (result: SyntroInitResult) => void;\n\n  /**\n   * Called when initialization fails.\n   */\n  onError?: (error: Error) => void;\n}\n\n/**\n * Provider component that initializes the Syntro SDK.\n *\n * Place this at the root of your app or at the top of any subtree\n * that needs access to the SDK.\n */\nexport function SyntroProvider({\n  token,\n  canvasOptions,\n  fetcher,\n  children,\n  onReady,\n  onError,\n}: SyntroProviderProps) {\n  const [state, setState] = useState<SyntroContextValue>({\n    canvas: null,\n    experiments: null,\n    telemetry: null,\n    isReady: false,\n    error: null,\n  });\n\n  const initRef = useRef(false);\n  const handleRef = useRef<SmartCanvasHandle | null>(null);\n\n  useEffect(() => {\n    if (!token) return;\n\n    // Reuse existing init if same token (handles React Strict Mode remounts)\n    if (globalInitPromise && globalInitToken === token) {\n      globalInitPromise.then((result) => {\n        handleRef.current = result.canvas;\n        setState({\n          canvas: result.canvas,\n          experiments: result.experiments ?? null,\n          telemetry: result.telemetry ?? null,\n          isReady: true,\n          error: null,\n        });\n      });\n      return;\n    }\n\n    // Prevent double init\n    if (initRef.current) return;\n    initRef.current = true;\n\n    globalInitToken = token;\n    globalInitPromise = Syntro.init({ token, canvas: canvasOptions, fetcher });\n\n    globalInitPromise\n      .then((result) => {\n        handleRef.current = result.canvas;\n        setState({\n          canvas: result.canvas,\n          experiments: result.experiments ?? null,\n          telemetry: result.telemetry ?? null,\n          isReady: true,\n          error: null,\n        });\n        onReady?.(result);\n      })\n      .catch((err) => {\n        const error = err instanceof Error ? err : new Error(String(err));\n        setState((prev) => ({ ...prev, error, isReady: true }));\n        onError?.(error);\n        // Clear global state on error so retry is possible\n        globalInitPromise = null;\n        globalInitToken = null;\n      });\n\n    // Don't destroy on unmount in dev mode - React Strict Mode will remount\n    // The canvas persists and will be reused on remount\n  }, [token, canvasOptions, fetcher, onError, onReady]);\n\n  return <SyntroContext.Provider value={state}>{children}</SyntroContext.Provider>;\n}\n\n/**\n * Hook to access the Syntro SDK.\n *\n * Must be used within a SyntroProvider.\n *\n * @returns The SDK context containing canvas, experiments, telemetry, and status\n */\nexport function useSyntro(): SyntroContextValue {\n  const context = useContext(SyntroContext);\n  if (!context) {\n    throw new Error('useSyntro must be used within a SyntroProvider');\n  }\n  return context;\n}\n\n/**\n * Hook to check if the SDK is ready.\n *\n * Shorthand for `useSyntro().isReady`.\n */\nexport function useSyntroReady(): boolean {\n  return useSyntro().isReady;\n}\n\n/**\n * Hook to access the experiment client.\n *\n * @returns The experiment client, or null if not configured\n */\nexport function useSyntroExperiments(): ExperimentClient | null {\n  return useSyntro().experiments;\n}\n\n/**\n * Hook to access the telemetry client.\n *\n * @returns The telemetry client, or null if not configured\n */\nexport function useSyntroTelemetry(): TelemetryClient | null {\n  return useSyntro().telemetry;\n}\n\n/**\n * Hook to access the canvas handle.\n *\n * @returns The canvas handle, or null if not ready\n */\nexport function useSyntroCanvas(): SmartCanvasHandle | null {\n  return useSyntro().canvas;\n}\n"],
-  "mappings": ";;;;;;;AAqBA,SAAS,eAA+B,YAAY,WAAW,QAAQ,gBAAgB;AAsI9E;AAlHT,IAAM,gBAAgB,cAAyC,IAAI;AAGnE,IAAI,oBAAsD;AAC1D,IAAI,kBAAiC;AAyC9B,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAwB;AACtB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA6B;AAAA,IACrD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,WAAW;AAAA,IACX,SAAS;AAAA,IACT,OAAO;AAAA,EACT,CAAC;AAED,QAAM,UAAU,OAAO,KAAK;AAC5B,QAAM,YAAY,OAAiC,IAAI;AAEvD,YAAU,MAAM;AACd,QAAI,CAAC,MAAO;AAGZ,QAAI,qBAAqB,oBAAoB,OAAO;AAClD,wBAAkB,KAAK,CAAC,WAAW;AA9GzC;AA+GQ,kBAAU,UAAU,OAAO;AAC3B,iBAAS;AAAA,UACP,QAAQ,OAAO;AAAA,UACf,cAAa,YAAO,gBAAP,YAAsB;AAAA,UACnC,YAAW,YAAO,cAAP,YAAoB;AAAA,UAC/B,SAAS;AAAA,UACT,OAAO;AAAA,QACT,CAAC;AAAA,MACH,CAAC;AACD;AAAA,IACF;AAGA,QAAI,QAAQ,QAAS;AACrB,YAAQ,UAAU;AAElB,sBAAkB;AAClB,wBAAoB,OAAO,KAAK,EAAE,OAAO,QAAQ,eAAe,QAAQ,CAAC;AAEzE,sBACG,KAAK,CAAC,WAAW;AAnIxB;AAoIQ,gBAAU,UAAU,OAAO;AAC3B,eAAS;AAAA,QACP,QAAQ,OAAO;AAAA,QACf,cAAa,YAAO,gBAAP,YAAsB;AAAA,QACnC,YAAW,YAAO,cAAP,YAAoB;AAAA,QAC/B,SAAS;AAAA,QACT,OAAO;AAAA,MACT,CAAC;AACD,yCAAU;AAAA,IACZ,CAAC,EACA,MAAM,CAAC,QAAQ;AACd,YAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,eAAS,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,SAAS,KAAK,EAAE;AACtD,yCAAU;AAEV,0BAAoB;AACpB,wBAAkB;AAAA,IACpB,CAAC;AAAA,EAIL,GAAG,CAAC,OAAO,eAAe,SAAS,SAAS,OAAO,CAAC;AAEpD,SAAO,oBAAC,cAAc,UAAd,EAAuB,OAAO,OAAQ,UAAS;AACzD;AASO,SAAS,YAAgC;AAC9C,QAAM,UAAU,WAAW,aAAa;AACxC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;AAOO,SAAS,iBAA0B;AACxC,SAAO,UAAU,EAAE;AACrB;AAOO,SAAS,uBAAgD;AAC9D,SAAO,UAAU,EAAE;AACrB;AAOO,SAAS,qBAA6C;AAC3D,SAAO,UAAU,EAAE;AACrB;AAOO,SAAS,kBAA4C;AAC1D,SAAO,UAAU,EAAE;AACrB;",
+  "mappings": ";;;;;;;;AAqBA,SAAS,eAA+B,YAAY,WAAW,QAAQ,gBAAgB;AAsI9E;AAlHT,IAAM,gBAAgB,cAAyC,IAAI;AAGnE,IAAI,oBAAsD;AAC1D,IAAI,kBAAiC;AAyC9B,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAwB;AACtB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA6B;AAAA,IACrD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,WAAW;AAAA,IACX,SAAS;AAAA,IACT,OAAO;AAAA,EACT,CAAC;AAED,QAAM,UAAU,OAAO,KAAK;AAC5B,QAAM,YAAY,OAAiC,IAAI;AAEvD,YAAU,MAAM;AACd,QAAI,CAAC,MAAO;AAGZ,QAAI,qBAAqB,oBAAoB,OAAO;AAClD,wBAAkB,KAAK,CAAC,WAAW;AA9GzC;AA+GQ,kBAAU,UAAU,OAAO;AAC3B,iBAAS;AAAA,UACP,QAAQ,OAAO;AAAA,UACf,cAAa,YAAO,gBAAP,YAAsB;AAAA,UACnC,YAAW,YAAO,cAAP,YAAoB;AAAA,UAC/B,SAAS;AAAA,UACT,OAAO;AAAA,QACT,CAAC;AAAA,MACH,CAAC;AACD;AAAA,IACF;AAGA,QAAI,QAAQ,QAAS;AACrB,YAAQ,UAAU;AAElB,sBAAkB;AAClB,wBAAoB,OAAO,KAAK,EAAE,OAAO,QAAQ,eAAe,QAAQ,CAAC;AAEzE,sBACG,KAAK,CAAC,WAAW;AAnIxB;AAoIQ,gBAAU,UAAU,OAAO;AAC3B,eAAS;AAAA,QACP,QAAQ,OAAO;AAAA,QACf,cAAa,YAAO,gBAAP,YAAsB;AAAA,QACnC,YAAW,YAAO,cAAP,YAAoB;AAAA,QAC/B,SAAS;AAAA,QACT,OAAO;AAAA,MACT,CAAC;AACD,yCAAU;AAAA,IACZ,CAAC,EACA,MAAM,CAAC,QAAQ;AACd,YAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,eAAS,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,SAAS,KAAK,EAAE;AACtD,yCAAU;AAEV,0BAAoB;AACpB,wBAAkB;AAAA,IACpB,CAAC;AAAA,EAIL,GAAG,CAAC,OAAO,eAAe,SAAS,SAAS,OAAO,CAAC;AAEpD,SAAO,oBAAC,cAAc,UAAd,EAAuB,OAAO,OAAQ,UAAS;AACzD;AASO,SAAS,YAAgC;AAC9C,QAAM,UAAU,WAAW,aAAa;AACxC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;AAOO,SAAS,iBAA0B;AACxC,SAAO,UAAU,EAAE;AACrB;AAOO,SAAS,uBAAgD;AAC9D,SAAO,UAAU,EAAE;AACrB;AAOO,SAAS,qBAA6C;AAC3D,SAAO,UAAU,EAAE;AACrB;AAOO,SAAS,kBAA4C;AAC1D,SAAO,UAAU,EAAE;AACrB;",
   "names": []
 }

package/dist/runtime.d.ts

@@ -14,6 +14,7 @@
  * The runtime receives the config and makes decisions using DecisionStrategy.
  */
 import { type ActionEngine, type ExecutorRegistry } from './actions';
+import { type AnchorResolver } from './anchor';
 import { type AppRegistry } from './apps';
 import { type ContextManager } from './context/ContextManager';
 import type { DecisionResult, DecisionStrategy, RouteFilter } from './decisions/types';
@@ -60,6 +61,8 @@ export interface SmartCanvasRuntime {
     apps: AppRegistry;
     /** Event accumulator for event_count conditions */
     accumulator: EventAccumulator;
+    /** Centralized anchor resolver for DOM observation */
+    anchorResolver: AnchorResolver;
     /** Centralized navigation monitor for History API interception */
     navigation: NavigationMonitor;
     /** Runtime version */