@perspective-ai/sdk-react 1.0.1 → 1.1.1

package/dist/index.cjs

@@ -10,10 +10,11 @@ function useStableCallback(callback) {
   useIsomorphicLayoutEffect(() => {
     callbackRef.current = callback;
   });
-  return react.useCallback(
+  const stable = react.useCallback(
     ((...args) => callbackRef.current?.(...args)),
     []
   );
+  return callback ? stable : callback;
 }
 
 // src/hooks/usePopup.ts
@@ -378,6 +379,35 @@ function useFloatBubble(options) {
     handle
   };
 }
+function useAutoOpen(options) {
+  const { trigger, showOnce = "session", researchId, ...embedConfig } = options;
+  const cleanupRef = react.useRef(null);
+  const [triggered, setTriggered] = react.useState(false);
+  const triggerDelay = trigger.type === "timeout" ? trigger.delay : void 0;
+  const stableOnTrigger = useStableCallback(() => {
+    sdk.markShown(researchId, showOnce);
+    sdk.openPopup({ researchId, ...embedConfig });
+  });
+  react.useEffect(() => {
+    if (!sdk.shouldShow(researchId, showOnce)) return;
+    cleanupRef.current = sdk.setupTrigger(trigger, () => {
+      setTriggered((prev) => {
+        if (prev) return prev;
+        stableOnTrigger();
+        return true;
+      });
+    });
+    return () => {
+      cleanupRef.current?.();
+      cleanupRef.current = null;
+    };
+  }, [researchId, trigger.type, triggerDelay, showOnce]);
+  const cancel = react.useCallback(() => {
+    cleanupRef.current?.();
+    cleanupRef.current = null;
+  }, []);
+  return { cancel, triggered };
+}
 function useThemeSync(theme = "system") {
   const [resolved, setResolved] = react.useState(
     theme !== "system" ? theme : "light"
@@ -567,6 +597,7 @@ function FloatBubble({
 exports.FloatBubble = FloatBubble;
 exports.Fullpage = Fullpage;
 exports.Widget = Widget;
+exports.useAutoOpen = useAutoOpen;
 exports.useFloatBubble = useFloatBubble;
 exports.usePopup = usePopup;
 exports.useSlider = useSlider;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useStableCallback.ts","../src/hooks/usePopup.ts","../src/hooks/useSlider.ts","../src/hooks/useFloatBubble.ts","../src/hooks/useThemeSync.ts","../src/Widget.tsx","../src/Fullpage.tsx","../src/FloatBubble.tsx"],"names":["useLayoutEffect","useEffect","useRef","useCallback","useState","openPopup","openSlider","createFloatBubble","createWidget","jsx","createFullpage"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useRef, useCallback, useLayoutEffect, useEffect } from \"react\";\n\nconst useIsomorphicLayoutEffect =\n  typeof window !== \"undefined\" ? useLayoutEffect : useEffect;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useStableCallback<T extends (...args: any[]) => any>(\n  callback: T | undefined\n): T {\n  const callbackRef = useRef(callback);\n\n  useIsomorphicLayoutEffect(() => {\n    callbackRef.current = callback;\n  });\n\n  return useCallback(\n    ((...args: Parameters<T>) => callbackRef.current?.(...args)) as T,\n    []\n  );\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openPopup,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for usePopup hook */\nexport interface UsePopupOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for usePopup hook */\nexport interface UsePopupReturn {\n  /** Open the popup */\n  open: () => void;\n  /** Close the popup */\n  close: () => void;\n  /** Toggle the popup */\n  toggle: () => void;\n  /** Whether the popup is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic popup control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * // Basic usage with custom trigger\n * const { open, isOpen } = usePopup({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Open Survey</MyCustomButton>\n *\n * // Controlled mode\n * const [isOpen, setIsOpen] = useState(false);\n * const popup = usePopup({\n *   researchId: \"abc\",\n *   open: isOpen,\n *   onOpenChange: setIsOpen\n * });\n * ```\n */\nexport function usePopup(options: UsePopupOptions): UsePopupReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createPopup = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openPopup({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroyPopup = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createPopup();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createPopup]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroyPopup();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroyPopup]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createPopup();\n    } else if (!controlledOpen && handleRef.current) {\n      destroyPopup();\n    }\n  }, [controlledOpen, isControlled, createPopup, destroyPopup]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openSlider,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useSlider hook */\nexport interface UseSliderOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useSlider hook */\nexport interface UseSliderReturn {\n  /** Open the slider */\n  open: () => void;\n  /** Close the slider */\n  close: () => void;\n  /** Toggle the slider */\n  toggle: () => void;\n  /** Whether the slider is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic slider control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * const { open, isOpen } = useSlider({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Give Feedback</MyCustomButton>\n * ```\n */\nexport function useSlider(options: UseSliderOptions): UseSliderReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createSlider = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openSlider({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroySlider = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createSlider();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createSlider]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroySlider();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroySlider]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createSlider();\n    } else if (!controlledOpen && handleRef.current) {\n      destroySlider();\n    }\n  }, [controlledOpen, isControlled, createSlider, destroySlider]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  createFloatBubble,\n  type EmbedConfig,\n  type FloatHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useFloatBubble hook */\nexport interface UseFloatBubbleOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useFloatBubble hook */\nexport interface UseFloatBubbleReturn {\n  /** Open the float bubble window */\n  open: () => void;\n  /** Close the float bubble window */\n  close: () => void;\n  /** Toggle the float bubble window */\n  toggle: () => void;\n  /** Unmount the float bubble entirely */\n  unmount: () => void;\n  /** Whether the float bubble window is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null until mounted) */\n  handle: FloatHandle | null;\n}\n\n/**\n * Headless hook for float bubble lifecycle management.\n * Creates a floating bubble button that expands into a chat window.\n * The bubble mounts on component mount and unmounts on component unmount.\n *\n * @example\n * ```tsx\n * // Basic usage - bubble mounts on component mount\n * useFloatBubble({ researchId: \"abc\" });\n *\n * // With programmatic control\n * const { open, close, isOpen } = useFloatBubble({ researchId: \"abc\" });\n * <button onClick={open}>Open Chat</button>\n * ```\n */\nexport function useFloatBubble(\n  options: UseFloatBubbleOptions\n): UseFloatBubbleReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<FloatHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<FloatHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const handleClose = useCallback(() => {\n    setInternalOpen(false);\n    if (isControlled) {\n      onOpenChange?.(false);\n    }\n    onClose?.();\n  }, [isControlled, onOpenChange, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  useEffect(() => {\n    const newHandle = createFloatBubble({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n\n    return () => {\n      if (handleRef.current === newHandle) {\n        newHandle.unmount();\n        handleRef.current = null;\n        setHandle(null);\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  useEffect(() => {\n    if (!isControlled || !handle) return;\n\n    if (controlledOpen && !handle.isOpen) {\n      handle.open();\n    } else if (!controlledOpen && handle.isOpen) {\n      handle.close();\n    }\n  }, [controlledOpen, isControlled, handle]);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      handleRef.current?.open();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      handleRef.current?.close();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const toggleFn = useCallback(() => {\n    const currentlyOpen = handleRef.current?.isOpen ?? internalOpen;\n    if (currentlyOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [internalOpen, openFn, closeFn]);\n\n  const unmountFn = useCallback(() => {\n    handleRef.current?.unmount();\n    handleRef.current = null;\n    setHandle(null);\n    setInternalOpen(false);\n  }, []);\n\n  const isOpen = isControlled\n    ? controlledOpen\n    : (handle?.isOpen ?? internalOpen);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    unmount: unmountFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useState, useEffect } from \"react\";\n\ntype Theme = \"light\" | \"dark\";\ntype ThemeInput = \"light\" | \"dark\" | \"system\";\n\n/**\n * Hook to resolve theme based on override and system preference.\n * Listens for system preference changes when theme is \"system\".\n */\nexport function useThemeSync(theme: ThemeInput = \"system\"): Theme {\n  // Always start with a deterministic value for SSR hydration safety.\n  // The actual system preference is synced in useEffect.\n  const [resolved, setResolved] = useState<Theme>(\n    theme !== \"system\" ? theme : \"light\"\n  );\n\n  useEffect(() => {\n    if (theme !== \"system\") {\n      setResolved(theme);\n      return;\n    }\n\n    const mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\n    // Set initial value\n    setResolved(mq.matches ? \"dark\" : \"light\");\n\n    const handler = (e: MediaQueryListEvent) =>\n      setResolved(e.matches ? \"dark\" : \"light\");\n\n    mq.addEventListener(\"change\", handler);\n    return () => mq.removeEventListener(\"change\", handler);\n  }, [theme]);\n\n  return resolved;\n}\n","import { useRef, useEffect, type HTMLAttributes, type RefObject } from \"react\";\nimport {\n  createWidget,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface WidgetProps\n  extends\n    Omit<EmbedConfig, \"type\">,\n    Omit<HTMLAttributes<HTMLDivElement>, \"onError\" | \"onSubmit\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Inline widget embed component.\n * Renders the interview directly in a container.\n */\nexport function Widget({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n  className,\n  style,\n  ...divProps\n}: WidgetProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks to avoid re-mounting on callback changes\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handle = createWidget(container, {\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={className}\n      style={{ minHeight: 500, ...style }}\n      data-testid=\"perspective-widget\"\n      {...divProps}\n    />\n  );\n}\n","import { useRef, useEffect, type RefObject } from \"react\";\nimport {\n  createFullpage,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface FullpageProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Full viewport embed component.\n * Takes over the entire screen with the interview.\n */\nexport function Fullpage({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FullpageProps) {\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const handle = createFullpage({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  // This component doesn't render anything - the fullpage overlay is added to document.body\n  return null;\n}\n","import { useEffect, type RefObject } from \"react\";\nimport { type EmbedConfig, type FloatHandle } from \"@perspective-ai/sdk\";\nimport { useFloatBubble } from \"./hooks/useFloatBubble\";\n\nexport interface FloatBubbleProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the handle for programmatic control */\n  embedRef?: RefObject<FloatHandle | null>;\n}\n\n/**\n * Floating bubble widget that expands into a chat window.\n * This is a convenience wrapper around useFloatBubble hook.\n *\n * @example\n * ```tsx\n * <FloatBubble researchId=\"abc\" onSubmit={handleSubmit} />\n * ```\n */\nexport function FloatBubble({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FloatBubbleProps) {\n  const { handle } = useFloatBubble({\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n  });\n\n  useEffect(() => {\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n    return () => {\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [embedRef, handle]);\n\n  return null;\n}\n"]}
+{"version":3,"sources":["../src/hooks/useStableCallback.ts","../src/hooks/usePopup.ts","../src/hooks/useSlider.ts","../src/hooks/useFloatBubble.ts","../src/hooks/useAutoOpen.ts","../src/hooks/useThemeSync.ts","../src/Widget.tsx","../src/Fullpage.tsx","../src/FloatBubble.tsx"],"names":["useLayoutEffect","useEffect","useRef","useCallback","useState","openPopup","openSlider","createFloatBubble","markShown","shouldShow","setupTrigger","createWidget","jsx","createFullpage"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useRef, useCallback, useLayoutEffect, useEffect } from \"react\";\n\nconst useIsomorphicLayoutEffect =\n  typeof window !== \"undefined\" ? useLayoutEffect : useEffect;\n\nexport function useStableCallback<\n  T extends ((...args: any[]) => any) | undefined,\n>(callback: T): T {\n  const callbackRef = useRef(callback);\n\n  useIsomorphicLayoutEffect(() => {\n    callbackRef.current = callback;\n  });\n\n  // Always create the stable wrapper (hooks can't be conditional),\n  // but return undefined when no callback is provided to preserve\n  // truthiness semantics for consumers that branch on it.\n  const stable = useCallback(\n    ((...args: any[]) => callbackRef.current?.(...args)) as NonNullable<T>,\n    []\n  );\n\n  return callback ? stable : callback;\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openPopup,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for usePopup hook */\nexport interface UsePopupOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for usePopup hook */\nexport interface UsePopupReturn {\n  /** Open the popup */\n  open: () => void;\n  /** Close the popup */\n  close: () => void;\n  /** Toggle the popup */\n  toggle: () => void;\n  /** Whether the popup is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic popup control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * // Basic usage with custom trigger\n * const { open, isOpen } = usePopup({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Open Survey</MyCustomButton>\n *\n * // Controlled mode\n * const [isOpen, setIsOpen] = useState(false);\n * const popup = usePopup({\n *   researchId: \"abc\",\n *   open: isOpen,\n *   onOpenChange: setIsOpen\n * });\n * ```\n */\nexport function usePopup(options: UsePopupOptions): UsePopupReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createPopup = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openPopup({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroyPopup = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createPopup();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createPopup]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroyPopup();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroyPopup]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createPopup();\n    } else if (!controlledOpen && handleRef.current) {\n      destroyPopup();\n    }\n  }, [controlledOpen, isControlled, createPopup, destroyPopup]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openSlider,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useSlider hook */\nexport interface UseSliderOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useSlider hook */\nexport interface UseSliderReturn {\n  /** Open the slider */\n  open: () => void;\n  /** Close the slider */\n  close: () => void;\n  /** Toggle the slider */\n  toggle: () => void;\n  /** Whether the slider is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic slider control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * const { open, isOpen } = useSlider({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Give Feedback</MyCustomButton>\n * ```\n */\nexport function useSlider(options: UseSliderOptions): UseSliderReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createSlider = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openSlider({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroySlider = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createSlider();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createSlider]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroySlider();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroySlider]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createSlider();\n    } else if (!controlledOpen && handleRef.current) {\n      destroySlider();\n    }\n  }, [controlledOpen, isControlled, createSlider, destroySlider]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  createFloatBubble,\n  type EmbedConfig,\n  type FloatHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useFloatBubble hook */\nexport interface UseFloatBubbleOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useFloatBubble hook */\nexport interface UseFloatBubbleReturn {\n  /** Open the float bubble window */\n  open: () => void;\n  /** Close the float bubble window */\n  close: () => void;\n  /** Toggle the float bubble window */\n  toggle: () => void;\n  /** Unmount the float bubble entirely */\n  unmount: () => void;\n  /** Whether the float bubble window is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null until mounted) */\n  handle: FloatHandle | null;\n}\n\n/**\n * Headless hook for float bubble lifecycle management.\n * Creates a floating bubble button that expands into a chat window.\n * The bubble mounts on component mount and unmounts on component unmount.\n *\n * @example\n * ```tsx\n * // Basic usage - bubble mounts on component mount\n * useFloatBubble({ researchId: \"abc\" });\n *\n * // With programmatic control\n * const { open, close, isOpen } = useFloatBubble({ researchId: \"abc\" });\n * <button onClick={open}>Open Chat</button>\n * ```\n */\nexport function useFloatBubble(\n  options: UseFloatBubbleOptions\n): UseFloatBubbleReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<FloatHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<FloatHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const handleClose = useCallback(() => {\n    setInternalOpen(false);\n    if (isControlled) {\n      onOpenChange?.(false);\n    }\n    onClose?.();\n  }, [isControlled, onOpenChange, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  useEffect(() => {\n    const newHandle = createFloatBubble({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n\n    return () => {\n      if (handleRef.current === newHandle) {\n        newHandle.unmount();\n        handleRef.current = null;\n        setHandle(null);\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  useEffect(() => {\n    if (!isControlled || !handle) return;\n\n    if (controlledOpen && !handle.isOpen) {\n      handle.open();\n    } else if (!controlledOpen && handle.isOpen) {\n      handle.close();\n    }\n  }, [controlledOpen, isControlled, handle]);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      handleRef.current?.open();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      handleRef.current?.close();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const toggleFn = useCallback(() => {\n    const currentlyOpen = handleRef.current?.isOpen ?? internalOpen;\n    if (currentlyOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [internalOpen, openFn, closeFn]);\n\n  const unmountFn = useCallback(() => {\n    handleRef.current?.unmount();\n    handleRef.current = null;\n    setHandle(null);\n    setInternalOpen(false);\n  }, []);\n\n  const isOpen = isControlled\n    ? controlledOpen\n    : (handle?.isOpen ?? internalOpen);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    unmount: unmountFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport {\n  openPopup,\n  setupTrigger,\n  shouldShow,\n  markShown,\n} from \"@perspective-ai/sdk\";\nimport type { EmbedConfig, TriggerConfig, ShowOnce } from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\nexport interface UseAutoOpenOptions extends Omit<\n  EmbedConfig,\n  \"type\" | \"autoOpen\"\n> {\n  trigger: TriggerConfig;\n  showOnce?: ShowOnce; // default: \"session\"\n}\n\nexport interface UseAutoOpenReturn {\n  /** Cancel the pending trigger */\n  cancel: () => void;\n  /** Whether the trigger has fired */\n  triggered: boolean;\n}\n\nexport function useAutoOpen(options: UseAutoOpenOptions): UseAutoOpenReturn {\n  const { trigger, showOnce = \"session\", researchId, ...embedConfig } = options;\n  const cleanupRef = useRef<(() => void) | null>(null);\n  const [triggered, setTriggered] = useState(false);\n  const triggerDelay = trigger.type === \"timeout\" ? trigger.delay : undefined;\n\n  // Fix #5: useStableCallback so the trigger always calls with latest config\n  const stableOnTrigger = useStableCallback(() => {\n    markShown(researchId, showOnce);\n    openPopup({ researchId, ...embedConfig });\n  });\n\n  useEffect(() => {\n    if (!shouldShow(researchId, showOnce)) return;\n\n    cleanupRef.current = setupTrigger(trigger, () => {\n      setTriggered((prev) => {\n        if (prev) return prev; // already fired\n        stableOnTrigger();\n        return true;\n      });\n    });\n\n    return () => {\n      cleanupRef.current?.();\n      cleanupRef.current = null;\n    };\n    // Primitive deps only — avoids re-triggering on object identity changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [researchId, trigger.type, triggerDelay, showOnce]);\n\n  const cancel = useCallback(() => {\n    cleanupRef.current?.();\n    cleanupRef.current = null;\n  }, []);\n\n  return { cancel, triggered };\n}\n","import { useState, useEffect } from \"react\";\n\ntype Theme = \"light\" | \"dark\";\ntype ThemeInput = \"light\" | \"dark\" | \"system\";\n\n/**\n * Hook to resolve theme based on override and system preference.\n * Listens for system preference changes when theme is \"system\".\n */\nexport function useThemeSync(theme: ThemeInput = \"system\"): Theme {\n  // Always start with a deterministic value for SSR hydration safety.\n  // The actual system preference is synced in useEffect.\n  const [resolved, setResolved] = useState<Theme>(\n    theme !== \"system\" ? theme : \"light\"\n  );\n\n  useEffect(() => {\n    if (theme !== \"system\") {\n      setResolved(theme);\n      return;\n    }\n\n    const mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\n    // Set initial value\n    setResolved(mq.matches ? \"dark\" : \"light\");\n\n    const handler = (e: MediaQueryListEvent) =>\n      setResolved(e.matches ? \"dark\" : \"light\");\n\n    mq.addEventListener(\"change\", handler);\n    return () => mq.removeEventListener(\"change\", handler);\n  }, [theme]);\n\n  return resolved;\n}\n","import { useRef, useEffect, type HTMLAttributes, type RefObject } from \"react\";\nimport {\n  createWidget,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface WidgetProps\n  extends\n    Omit<EmbedConfig, \"type\">,\n    Omit<HTMLAttributes<HTMLDivElement>, \"onError\" | \"onSubmit\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Inline widget embed component.\n * Renders the interview directly in a container.\n */\nexport function Widget({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n  className,\n  style,\n  ...divProps\n}: WidgetProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks to avoid re-mounting on callback changes\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handle = createWidget(container, {\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={className}\n      style={{ minHeight: 500, ...style }}\n      data-testid=\"perspective-widget\"\n      {...divProps}\n    />\n  );\n}\n","import { useRef, useEffect, type RefObject } from \"react\";\nimport {\n  createFullpage,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface FullpageProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Full viewport embed component.\n * Takes over the entire screen with the interview.\n */\nexport function Fullpage({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FullpageProps) {\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const handle = createFullpage({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  // This component doesn't render anything - the fullpage overlay is added to document.body\n  return null;\n}\n","import { useEffect, type RefObject } from \"react\";\nimport { type EmbedConfig, type FloatHandle } from \"@perspective-ai/sdk\";\nimport { useFloatBubble } from \"./hooks/useFloatBubble\";\n\nexport interface FloatBubbleProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the handle for programmatic control */\n  embedRef?: RefObject<FloatHandle | null>;\n}\n\n/**\n * Floating bubble widget that expands into a chat window.\n * This is a convenience wrapper around useFloatBubble hook.\n *\n * @example\n * ```tsx\n * <FloatBubble researchId=\"abc\" onSubmit={handleSubmit} />\n * ```\n */\nexport function FloatBubble({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FloatBubbleProps) {\n  const { handle } = useFloatBubble({\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n  });\n\n  useEffect(() => {\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n    return () => {\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [embedRef, handle]);\n\n  return null;\n}\n"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { EmbedConfig, EmbedHandle, FloatHandle } from '@perspective-ai/sdk';
-export { BrandColors, EmbedConfig, EmbedError, EmbedHandle, FloatHandle, ThemeValue } from '@perspective-ai/sdk';
+import { EmbedConfig, EmbedHandle, FloatHandle, TriggerConfig, ShowOnce } from '@perspective-ai/sdk';
+export { AutoOpenConfig, BrandColors, EmbedConfig, EmbedError, EmbedHandle, FloatHandle, ShowOnce, ThemeValue, TriggerConfig } from '@perspective-ai/sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { HTMLAttributes, RefObject } from 'react';
 
@@ -115,6 +115,18 @@ interface UseFloatBubbleReturn {
  */
 declare function useFloatBubble(options: UseFloatBubbleOptions): UseFloatBubbleReturn;
 
+interface UseAutoOpenOptions extends Omit<EmbedConfig, "type" | "autoOpen"> {
+    trigger: TriggerConfig;
+    showOnce?: ShowOnce;
+}
+interface UseAutoOpenReturn {
+    /** Cancel the pending trigger */
+    cancel: () => void;
+    /** Whether the trigger has fired */
+    triggered: boolean;
+}
+declare function useAutoOpen(options: UseAutoOpenOptions): UseAutoOpenReturn;
+
 type Theme = "light" | "dark";
 type ThemeInput = "light" | "dark" | "system";
 /**
@@ -123,7 +135,7 @@ type ThemeInput = "light" | "dark" | "system";
  */
 declare function useThemeSync(theme?: ThemeInput): Theme;
 
-declare function useStableCallback<T extends (...args: any[]) => any>(callback: T | undefined): T;
+declare function useStableCallback<T extends ((...args: any[]) => any) | undefined>(callback: T): T;
 
 interface WidgetProps extends Omit<EmbedConfig, "type">, Omit<HTMLAttributes<HTMLDivElement>, "onError" | "onSubmit"> {
     /** Ref to access the embed handle for programmatic control */
@@ -160,4 +172,4 @@ interface FloatBubbleProps extends Omit<EmbedConfig, "type"> {
  */
 declare function FloatBubble({ researchId, params, brand, theme, host, onReady, onSubmit, onNavigate, onClose, onError, embedRef, }: FloatBubbleProps): null;
 
-export { FloatBubble, type FloatBubbleProps, Fullpage, type FullpageProps, type UseFloatBubbleOptions, type UseFloatBubbleReturn, type UsePopupOptions, type UsePopupReturn, type UseSliderOptions, type UseSliderReturn, Widget, type WidgetProps, useFloatBubble, usePopup, useSlider, useStableCallback, useThemeSync };
+export { FloatBubble, type FloatBubbleProps, Fullpage, type FullpageProps, type UseAutoOpenOptions, type UseAutoOpenReturn, type UseFloatBubbleOptions, type UseFloatBubbleReturn, type UsePopupOptions, type UsePopupReturn, type UseSliderOptions, type UseSliderReturn, Widget, type WidgetProps, useAutoOpen, useFloatBubble, usePopup, useSlider, useStableCallback, useThemeSync };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { EmbedConfig, EmbedHandle, FloatHandle } from '@perspective-ai/sdk';
-export { BrandColors, EmbedConfig, EmbedError, EmbedHandle, FloatHandle, ThemeValue } from '@perspective-ai/sdk';
+import { EmbedConfig, EmbedHandle, FloatHandle, TriggerConfig, ShowOnce } from '@perspective-ai/sdk';
+export { AutoOpenConfig, BrandColors, EmbedConfig, EmbedError, EmbedHandle, FloatHandle, ShowOnce, ThemeValue, TriggerConfig } from '@perspective-ai/sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { HTMLAttributes, RefObject } from 'react';
 
@@ -115,6 +115,18 @@ interface UseFloatBubbleReturn {
  */
 declare function useFloatBubble(options: UseFloatBubbleOptions): UseFloatBubbleReturn;
 
+interface UseAutoOpenOptions extends Omit<EmbedConfig, "type" | "autoOpen"> {
+    trigger: TriggerConfig;
+    showOnce?: ShowOnce;
+}
+interface UseAutoOpenReturn {
+    /** Cancel the pending trigger */
+    cancel: () => void;
+    /** Whether the trigger has fired */
+    triggered: boolean;
+}
+declare function useAutoOpen(options: UseAutoOpenOptions): UseAutoOpenReturn;
+
 type Theme = "light" | "dark";
 type ThemeInput = "light" | "dark" | "system";
 /**
@@ -123,7 +135,7 @@ type ThemeInput = "light" | "dark" | "system";
  */
 declare function useThemeSync(theme?: ThemeInput): Theme;
 
-declare function useStableCallback<T extends (...args: any[]) => any>(callback: T | undefined): T;
+declare function useStableCallback<T extends ((...args: any[]) => any) | undefined>(callback: T): T;
 
 interface WidgetProps extends Omit<EmbedConfig, "type">, Omit<HTMLAttributes<HTMLDivElement>, "onError" | "onSubmit"> {
     /** Ref to access the embed handle for programmatic control */
@@ -160,4 +172,4 @@ interface FloatBubbleProps extends Omit<EmbedConfig, "type"> {
  */
 declare function FloatBubble({ researchId, params, brand, theme, host, onReady, onSubmit, onNavigate, onClose, onError, embedRef, }: FloatBubbleProps): null;
 
-export { FloatBubble, type FloatBubbleProps, Fullpage, type FullpageProps, type UseFloatBubbleOptions, type UseFloatBubbleReturn, type UsePopupOptions, type UsePopupReturn, type UseSliderOptions, type UseSliderReturn, Widget, type WidgetProps, useFloatBubble, usePopup, useSlider, useStableCallback, useThemeSync };
+export { FloatBubble, type FloatBubbleProps, Fullpage, type FullpageProps, type UseAutoOpenOptions, type UseAutoOpenReturn, type UseFloatBubbleOptions, type UseFloatBubbleReturn, type UsePopupOptions, type UsePopupReturn, type UseSliderOptions, type UseSliderReturn, Widget, type WidgetProps, useAutoOpen, useFloatBubble, usePopup, useSlider, useStableCallback, useThemeSync };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { useRef, useLayoutEffect, useEffect, useCallback, useState } from 'react';
-import { openPopup, openSlider, createFloatBubble, createWidget, createFullpage } from '@perspective-ai/sdk';
+import { openPopup, openSlider, createFloatBubble, markShown, shouldShow, setupTrigger, createWidget, createFullpage } from '@perspective-ai/sdk';
 import { jsx } from 'react/jsx-runtime';
 
 var useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
@@ -8,10 +8,11 @@ function useStableCallback(callback) {
   useIsomorphicLayoutEffect(() => {
     callbackRef.current = callback;
   });
-  return useCallback(
+  const stable = useCallback(
     ((...args) => callbackRef.current?.(...args)),
     []
   );
+  return callback ? stable : callback;
 }
 
 // src/hooks/usePopup.ts
@@ -376,6 +377,35 @@ function useFloatBubble(options) {
     handle
   };
 }
+function useAutoOpen(options) {
+  const { trigger, showOnce = "session", researchId, ...embedConfig } = options;
+  const cleanupRef = useRef(null);
+  const [triggered, setTriggered] = useState(false);
+  const triggerDelay = trigger.type === "timeout" ? trigger.delay : void 0;
+  const stableOnTrigger = useStableCallback(() => {
+    markShown(researchId, showOnce);
+    openPopup({ researchId, ...embedConfig });
+  });
+  useEffect(() => {
+    if (!shouldShow(researchId, showOnce)) return;
+    cleanupRef.current = setupTrigger(trigger, () => {
+      setTriggered((prev) => {
+        if (prev) return prev;
+        stableOnTrigger();
+        return true;
+      });
+    });
+    return () => {
+      cleanupRef.current?.();
+      cleanupRef.current = null;
+    };
+  }, [researchId, trigger.type, triggerDelay, showOnce]);
+  const cancel = useCallback(() => {
+    cleanupRef.current?.();
+    cleanupRef.current = null;
+  }, []);
+  return { cancel, triggered };
+}
 function useThemeSync(theme = "system") {
   const [resolved, setResolved] = useState(
     theme !== "system" ? theme : "light"
@@ -562,6 +592,6 @@ function FloatBubble({
   return null;
 }
 
-export { FloatBubble, Fullpage, Widget, useFloatBubble, usePopup, useSlider, useStableCallback, useThemeSync };
+export { FloatBubble, Fullpage, Widget, useAutoOpen, useFloatBubble, usePopup, useSlider, useStableCallback, useThemeSync };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useStableCallback.ts","../src/hooks/usePopup.ts","../src/hooks/useSlider.ts","../src/hooks/useFloatBubble.ts","../src/hooks/useThemeSync.ts","../src/Widget.tsx","../src/Fullpage.tsx","../src/FloatBubble.tsx"],"names":["useRef","useCallback","useEffect","useState"],"mappings":"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","file":"index.js","sourcesContent":["import { useRef, useCallback, useLayoutEffect, useEffect } from \"react\";\n\nconst useIsomorphicLayoutEffect =\n  typeof window !== \"undefined\" ? useLayoutEffect : useEffect;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useStableCallback<T extends (...args: any[]) => any>(\n  callback: T | undefined\n): T {\n  const callbackRef = useRef(callback);\n\n  useIsomorphicLayoutEffect(() => {\n    callbackRef.current = callback;\n  });\n\n  return useCallback(\n    ((...args: Parameters<T>) => callbackRef.current?.(...args)) as T,\n    []\n  );\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openPopup,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for usePopup hook */\nexport interface UsePopupOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for usePopup hook */\nexport interface UsePopupReturn {\n  /** Open the popup */\n  open: () => void;\n  /** Close the popup */\n  close: () => void;\n  /** Toggle the popup */\n  toggle: () => void;\n  /** Whether the popup is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic popup control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * // Basic usage with custom trigger\n * const { open, isOpen } = usePopup({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Open Survey</MyCustomButton>\n *\n * // Controlled mode\n * const [isOpen, setIsOpen] = useState(false);\n * const popup = usePopup({\n *   researchId: \"abc\",\n *   open: isOpen,\n *   onOpenChange: setIsOpen\n * });\n * ```\n */\nexport function usePopup(options: UsePopupOptions): UsePopupReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createPopup = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openPopup({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroyPopup = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createPopup();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createPopup]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroyPopup();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroyPopup]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createPopup();\n    } else if (!controlledOpen && handleRef.current) {\n      destroyPopup();\n    }\n  }, [controlledOpen, isControlled, createPopup, destroyPopup]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openSlider,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useSlider hook */\nexport interface UseSliderOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useSlider hook */\nexport interface UseSliderReturn {\n  /** Open the slider */\n  open: () => void;\n  /** Close the slider */\n  close: () => void;\n  /** Toggle the slider */\n  toggle: () => void;\n  /** Whether the slider is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic slider control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * const { open, isOpen } = useSlider({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Give Feedback</MyCustomButton>\n * ```\n */\nexport function useSlider(options: UseSliderOptions): UseSliderReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createSlider = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openSlider({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroySlider = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createSlider();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createSlider]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroySlider();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroySlider]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createSlider();\n    } else if (!controlledOpen && handleRef.current) {\n      destroySlider();\n    }\n  }, [controlledOpen, isControlled, createSlider, destroySlider]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  createFloatBubble,\n  type EmbedConfig,\n  type FloatHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useFloatBubble hook */\nexport interface UseFloatBubbleOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useFloatBubble hook */\nexport interface UseFloatBubbleReturn {\n  /** Open the float bubble window */\n  open: () => void;\n  /** Close the float bubble window */\n  close: () => void;\n  /** Toggle the float bubble window */\n  toggle: () => void;\n  /** Unmount the float bubble entirely */\n  unmount: () => void;\n  /** Whether the float bubble window is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null until mounted) */\n  handle: FloatHandle | null;\n}\n\n/**\n * Headless hook for float bubble lifecycle management.\n * Creates a floating bubble button that expands into a chat window.\n * The bubble mounts on component mount and unmounts on component unmount.\n *\n * @example\n * ```tsx\n * // Basic usage - bubble mounts on component mount\n * useFloatBubble({ researchId: \"abc\" });\n *\n * // With programmatic control\n * const { open, close, isOpen } = useFloatBubble({ researchId: \"abc\" });\n * <button onClick={open}>Open Chat</button>\n * ```\n */\nexport function useFloatBubble(\n  options: UseFloatBubbleOptions\n): UseFloatBubbleReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<FloatHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<FloatHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const handleClose = useCallback(() => {\n    setInternalOpen(false);\n    if (isControlled) {\n      onOpenChange?.(false);\n    }\n    onClose?.();\n  }, [isControlled, onOpenChange, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  useEffect(() => {\n    const newHandle = createFloatBubble({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n\n    return () => {\n      if (handleRef.current === newHandle) {\n        newHandle.unmount();\n        handleRef.current = null;\n        setHandle(null);\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  useEffect(() => {\n    if (!isControlled || !handle) return;\n\n    if (controlledOpen && !handle.isOpen) {\n      handle.open();\n    } else if (!controlledOpen && handle.isOpen) {\n      handle.close();\n    }\n  }, [controlledOpen, isControlled, handle]);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      handleRef.current?.open();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      handleRef.current?.close();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const toggleFn = useCallback(() => {\n    const currentlyOpen = handleRef.current?.isOpen ?? internalOpen;\n    if (currentlyOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [internalOpen, openFn, closeFn]);\n\n  const unmountFn = useCallback(() => {\n    handleRef.current?.unmount();\n    handleRef.current = null;\n    setHandle(null);\n    setInternalOpen(false);\n  }, []);\n\n  const isOpen = isControlled\n    ? controlledOpen\n    : (handle?.isOpen ?? internalOpen);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    unmount: unmountFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useState, useEffect } from \"react\";\n\ntype Theme = \"light\" | \"dark\";\ntype ThemeInput = \"light\" | \"dark\" | \"system\";\n\n/**\n * Hook to resolve theme based on override and system preference.\n * Listens for system preference changes when theme is \"system\".\n */\nexport function useThemeSync(theme: ThemeInput = \"system\"): Theme {\n  // Always start with a deterministic value for SSR hydration safety.\n  // The actual system preference is synced in useEffect.\n  const [resolved, setResolved] = useState<Theme>(\n    theme !== \"system\" ? theme : \"light\"\n  );\n\n  useEffect(() => {\n    if (theme !== \"system\") {\n      setResolved(theme);\n      return;\n    }\n\n    const mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\n    // Set initial value\n    setResolved(mq.matches ? \"dark\" : \"light\");\n\n    const handler = (e: MediaQueryListEvent) =>\n      setResolved(e.matches ? \"dark\" : \"light\");\n\n    mq.addEventListener(\"change\", handler);\n    return () => mq.removeEventListener(\"change\", handler);\n  }, [theme]);\n\n  return resolved;\n}\n","import { useRef, useEffect, type HTMLAttributes, type RefObject } from \"react\";\nimport {\n  createWidget,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface WidgetProps\n  extends\n    Omit<EmbedConfig, \"type\">,\n    Omit<HTMLAttributes<HTMLDivElement>, \"onError\" | \"onSubmit\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Inline widget embed component.\n * Renders the interview directly in a container.\n */\nexport function Widget({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n  className,\n  style,\n  ...divProps\n}: WidgetProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks to avoid re-mounting on callback changes\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handle = createWidget(container, {\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={className}\n      style={{ minHeight: 500, ...style }}\n      data-testid=\"perspective-widget\"\n      {...divProps}\n    />\n  );\n}\n","import { useRef, useEffect, type RefObject } from \"react\";\nimport {\n  createFullpage,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface FullpageProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Full viewport embed component.\n * Takes over the entire screen with the interview.\n */\nexport function Fullpage({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FullpageProps) {\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const handle = createFullpage({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  // This component doesn't render anything - the fullpage overlay is added to document.body\n  return null;\n}\n","import { useEffect, type RefObject } from \"react\";\nimport { type EmbedConfig, type FloatHandle } from \"@perspective-ai/sdk\";\nimport { useFloatBubble } from \"./hooks/useFloatBubble\";\n\nexport interface FloatBubbleProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the handle for programmatic control */\n  embedRef?: RefObject<FloatHandle | null>;\n}\n\n/**\n * Floating bubble widget that expands into a chat window.\n * This is a convenience wrapper around useFloatBubble hook.\n *\n * @example\n * ```tsx\n * <FloatBubble researchId=\"abc\" onSubmit={handleSubmit} />\n * ```\n */\nexport function FloatBubble({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FloatBubbleProps) {\n  const { handle } = useFloatBubble({\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n  });\n\n  useEffect(() => {\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n    return () => {\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [embedRef, handle]);\n\n  return null;\n}\n"]}
+{"version":3,"sources":["../src/hooks/useStableCallback.ts","../src/hooks/usePopup.ts","../src/hooks/useSlider.ts","../src/hooks/useFloatBubble.ts","../src/hooks/useAutoOpen.ts","../src/hooks/useThemeSync.ts","../src/Widget.tsx","../src/Fullpage.tsx","../src/FloatBubble.tsx"],"names":["useRef","useCallback","useEffect","useState","openPopup"],"mappings":"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","file":"index.js","sourcesContent":["import { useRef, useCallback, useLayoutEffect, useEffect } from \"react\";\n\nconst useIsomorphicLayoutEffect =\n  typeof window !== \"undefined\" ? useLayoutEffect : useEffect;\n\nexport function useStableCallback<\n  T extends ((...args: any[]) => any) | undefined,\n>(callback: T): T {\n  const callbackRef = useRef(callback);\n\n  useIsomorphicLayoutEffect(() => {\n    callbackRef.current = callback;\n  });\n\n  // Always create the stable wrapper (hooks can't be conditional),\n  // but return undefined when no callback is provided to preserve\n  // truthiness semantics for consumers that branch on it.\n  const stable = useCallback(\n    ((...args: any[]) => callbackRef.current?.(...args)) as NonNullable<T>,\n    []\n  );\n\n  return callback ? stable : callback;\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openPopup,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for usePopup hook */\nexport interface UsePopupOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for usePopup hook */\nexport interface UsePopupReturn {\n  /** Open the popup */\n  open: () => void;\n  /** Close the popup */\n  close: () => void;\n  /** Toggle the popup */\n  toggle: () => void;\n  /** Whether the popup is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic popup control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * // Basic usage with custom trigger\n * const { open, isOpen } = usePopup({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Open Survey</MyCustomButton>\n *\n * // Controlled mode\n * const [isOpen, setIsOpen] = useState(false);\n * const popup = usePopup({\n *   researchId: \"abc\",\n *   open: isOpen,\n *   onOpenChange: setIsOpen\n * });\n * ```\n */\nexport function usePopup(options: UsePopupOptions): UsePopupReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createPopup = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openPopup({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroyPopup = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createPopup();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createPopup]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroyPopup();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroyPopup]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createPopup();\n    } else if (!controlledOpen && handleRef.current) {\n      destroyPopup();\n    }\n  }, [controlledOpen, isControlled, createPopup, destroyPopup]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  openSlider,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useSlider hook */\nexport interface UseSliderOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useSlider hook */\nexport interface UseSliderReturn {\n  /** Open the slider */\n  open: () => void;\n  /** Close the slider */\n  close: () => void;\n  /** Toggle the slider */\n  toggle: () => void;\n  /** Whether the slider is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null when closed) */\n  handle: EmbedHandle | null;\n}\n\n/**\n * Headless hook for programmatic slider control.\n * Use this when you need custom trigger elements or programmatic control.\n *\n * @example\n * ```tsx\n * const { open, isOpen } = useSlider({ researchId: \"abc\" });\n * <MyCustomButton onClick={open}>Give Feedback</MyCustomButton>\n * ```\n */\nexport function useSlider(options: UseSliderOptions): UseSliderReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n  const isOpen = isControlled ? controlledOpen : internalOpen;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const setOpen = useCallback(\n    (value: boolean) => {\n      if (isControlled) {\n        onOpenChange?.(value);\n      } else {\n        setInternalOpen(value);\n      }\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const handleClose = useCallback(() => {\n    handleRef.current = null;\n    setHandle(null);\n    setOpen(false);\n    onClose?.();\n  }, [setOpen, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  const createSlider = useCallback(() => {\n    if (handleRef.current) return handleRef.current;\n\n    const newHandle = openSlider({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n    return newHandle;\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  const destroySlider = useCallback(() => {\n    if (handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n      setHandle(null);\n    }\n  }, []);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      createSlider();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange, createSlider]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      destroySlider();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange, destroySlider]);\n\n  const toggleFn = useCallback(() => {\n    if (isOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [isOpen, openFn, closeFn]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (controlledOpen && !handleRef.current) {\n      createSlider();\n    } else if (!controlledOpen && handleRef.current) {\n      destroySlider();\n    }\n  }, [controlledOpen, isControlled, createSlider, destroySlider]);\n\n  useEffect(() => {\n    return () => {\n      if (handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useCallback, useState, useEffect, useRef } from \"react\";\nimport {\n  createFloatBubble,\n  type EmbedConfig,\n  type FloatHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/** Options for useFloatBubble hook */\nexport interface UseFloatBubbleOptions extends Omit<EmbedConfig, \"type\"> {\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n}\n\n/** Return type for useFloatBubble hook */\nexport interface UseFloatBubbleReturn {\n  /** Open the float bubble window */\n  open: () => void;\n  /** Close the float bubble window */\n  close: () => void;\n  /** Toggle the float bubble window */\n  toggle: () => void;\n  /** Unmount the float bubble entirely */\n  unmount: () => void;\n  /** Whether the float bubble window is currently open */\n  isOpen: boolean;\n  /** The underlying SDK handle (null until mounted) */\n  handle: FloatHandle | null;\n}\n\n/**\n * Headless hook for float bubble lifecycle management.\n * Creates a floating bubble button that expands into a chat window.\n * The bubble mounts on component mount and unmounts on component unmount.\n *\n * @example\n * ```tsx\n * // Basic usage - bubble mounts on component mount\n * useFloatBubble({ researchId: \"abc\" });\n *\n * // With programmatic control\n * const { open, close, isOpen } = useFloatBubble({ researchId: \"abc\" });\n * <button onClick={open}>Open Chat</button>\n * ```\n */\nexport function useFloatBubble(\n  options: UseFloatBubbleOptions\n): UseFloatBubbleReturn {\n  const {\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n    open: controlledOpen,\n    onOpenChange,\n  } = options;\n\n  const [handle, setHandle] = useState<FloatHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n  const handleRef = useRef<FloatHandle | null>(null);\n\n  const isControlled = controlledOpen !== undefined;\n\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnError = useStableCallback(onError);\n\n  const handleClose = useCallback(() => {\n    setInternalOpen(false);\n    if (isControlled) {\n      onOpenChange?.(false);\n    }\n    onClose?.();\n  }, [isControlled, onOpenChange, onClose]);\n\n  const stableOnClose = useStableCallback(handleClose);\n\n  useEffect(() => {\n    const newHandle = createFloatBubble({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = newHandle;\n    setHandle(newHandle);\n\n    return () => {\n      if (handleRef.current === newHandle) {\n        newHandle.unmount();\n        handleRef.current = null;\n        setHandle(null);\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n  ]);\n\n  useEffect(() => {\n    if (!isControlled || !handle) return;\n\n    if (controlledOpen && !handle.isOpen) {\n      handle.open();\n    } else if (!controlledOpen && handle.isOpen) {\n      handle.close();\n    }\n  }, [controlledOpen, isControlled, handle]);\n\n  const openFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(true);\n    } else {\n      handleRef.current?.open();\n      setInternalOpen(true);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const closeFn = useCallback(() => {\n    if (isControlled) {\n      onOpenChange?.(false);\n    } else {\n      handleRef.current?.close();\n      setInternalOpen(false);\n    }\n  }, [isControlled, onOpenChange]);\n\n  const toggleFn = useCallback(() => {\n    const currentlyOpen = handleRef.current?.isOpen ?? internalOpen;\n    if (currentlyOpen) {\n      closeFn();\n    } else {\n      openFn();\n    }\n  }, [internalOpen, openFn, closeFn]);\n\n  const unmountFn = useCallback(() => {\n    handleRef.current?.unmount();\n    handleRef.current = null;\n    setHandle(null);\n    setInternalOpen(false);\n  }, []);\n\n  const isOpen = isControlled\n    ? controlledOpen\n    : (handle?.isOpen ?? internalOpen);\n\n  return {\n    open: openFn,\n    close: closeFn,\n    toggle: toggleFn,\n    unmount: unmountFn,\n    isOpen,\n    handle,\n  };\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport {\n  openPopup,\n  setupTrigger,\n  shouldShow,\n  markShown,\n} from \"@perspective-ai/sdk\";\nimport type { EmbedConfig, TriggerConfig, ShowOnce } from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./useStableCallback\";\n\nexport interface UseAutoOpenOptions extends Omit<\n  EmbedConfig,\n  \"type\" | \"autoOpen\"\n> {\n  trigger: TriggerConfig;\n  showOnce?: ShowOnce; // default: \"session\"\n}\n\nexport interface UseAutoOpenReturn {\n  /** Cancel the pending trigger */\n  cancel: () => void;\n  /** Whether the trigger has fired */\n  triggered: boolean;\n}\n\nexport function useAutoOpen(options: UseAutoOpenOptions): UseAutoOpenReturn {\n  const { trigger, showOnce = \"session\", researchId, ...embedConfig } = options;\n  const cleanupRef = useRef<(() => void) | null>(null);\n  const [triggered, setTriggered] = useState(false);\n  const triggerDelay = trigger.type === \"timeout\" ? trigger.delay : undefined;\n\n  // Fix #5: useStableCallback so the trigger always calls with latest config\n  const stableOnTrigger = useStableCallback(() => {\n    markShown(researchId, showOnce);\n    openPopup({ researchId, ...embedConfig });\n  });\n\n  useEffect(() => {\n    if (!shouldShow(researchId, showOnce)) return;\n\n    cleanupRef.current = setupTrigger(trigger, () => {\n      setTriggered((prev) => {\n        if (prev) return prev; // already fired\n        stableOnTrigger();\n        return true;\n      });\n    });\n\n    return () => {\n      cleanupRef.current?.();\n      cleanupRef.current = null;\n    };\n    // Primitive deps only — avoids re-triggering on object identity changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [researchId, trigger.type, triggerDelay, showOnce]);\n\n  const cancel = useCallback(() => {\n    cleanupRef.current?.();\n    cleanupRef.current = null;\n  }, []);\n\n  return { cancel, triggered };\n}\n","import { useState, useEffect } from \"react\";\n\ntype Theme = \"light\" | \"dark\";\ntype ThemeInput = \"light\" | \"dark\" | \"system\";\n\n/**\n * Hook to resolve theme based on override and system preference.\n * Listens for system preference changes when theme is \"system\".\n */\nexport function useThemeSync(theme: ThemeInput = \"system\"): Theme {\n  // Always start with a deterministic value for SSR hydration safety.\n  // The actual system preference is synced in useEffect.\n  const [resolved, setResolved] = useState<Theme>(\n    theme !== \"system\" ? theme : \"light\"\n  );\n\n  useEffect(() => {\n    if (theme !== \"system\") {\n      setResolved(theme);\n      return;\n    }\n\n    const mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\n    // Set initial value\n    setResolved(mq.matches ? \"dark\" : \"light\");\n\n    const handler = (e: MediaQueryListEvent) =>\n      setResolved(e.matches ? \"dark\" : \"light\");\n\n    mq.addEventListener(\"change\", handler);\n    return () => mq.removeEventListener(\"change\", handler);\n  }, [theme]);\n\n  return resolved;\n}\n","import { useRef, useEffect, type HTMLAttributes, type RefObject } from \"react\";\nimport {\n  createWidget,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface WidgetProps\n  extends\n    Omit<EmbedConfig, \"type\">,\n    Omit<HTMLAttributes<HTMLDivElement>, \"onError\" | \"onSubmit\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Inline widget embed component.\n * Renders the interview directly in a container.\n */\nexport function Widget({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n  className,\n  style,\n  ...divProps\n}: WidgetProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks to avoid re-mounting on callback changes\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handle = createWidget(container, {\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  return (\n    <div\n      ref={containerRef}\n      className={className}\n      style={{ minHeight: 500, ...style }}\n      data-testid=\"perspective-widget\"\n      {...divProps}\n    />\n  );\n}\n","import { useRef, useEffect, type RefObject } from \"react\";\nimport {\n  createFullpage,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\nexport interface FullpageProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the embed handle for programmatic control */\n  embedRef?: RefObject<EmbedHandle | null>;\n}\n\n/**\n * Full viewport embed component.\n * Takes over the entire screen with the interview.\n */\nexport function Fullpage({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FullpageProps) {\n  const handleRef = useRef<EmbedHandle | null>(null);\n\n  // Stable callbacks\n  const stableOnReady = useStableCallback(onReady);\n  const stableOnSubmit = useStableCallback(onSubmit);\n  const stableOnNavigate = useStableCallback(onNavigate);\n  const stableOnClose = useStableCallback(onClose);\n  const stableOnError = useStableCallback(onError);\n\n  useEffect(() => {\n    const handle = createFullpage({\n      researchId,\n      params,\n      brand,\n      theme,\n      host,\n      onReady: stableOnReady,\n      onSubmit: stableOnSubmit,\n      onNavigate: stableOnNavigate,\n      onClose: stableOnClose,\n      onError: stableOnError,\n    });\n\n    handleRef.current = handle;\n\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n\n    return () => {\n      handle.unmount();\n      handleRef.current = null;\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    stableOnReady,\n    stableOnSubmit,\n    stableOnNavigate,\n    stableOnClose,\n    stableOnError,\n    embedRef,\n  ]);\n\n  // This component doesn't render anything - the fullpage overlay is added to document.body\n  return null;\n}\n","import { useEffect, type RefObject } from \"react\";\nimport { type EmbedConfig, type FloatHandle } from \"@perspective-ai/sdk\";\nimport { useFloatBubble } from \"./hooks/useFloatBubble\";\n\nexport interface FloatBubbleProps extends Omit<EmbedConfig, \"type\"> {\n  /** Ref to access the handle for programmatic control */\n  embedRef?: RefObject<FloatHandle | null>;\n}\n\n/**\n * Floating bubble widget that expands into a chat window.\n * This is a convenience wrapper around useFloatBubble hook.\n *\n * @example\n * ```tsx\n * <FloatBubble researchId=\"abc\" onSubmit={handleSubmit} />\n * ```\n */\nexport function FloatBubble({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  embedRef,\n}: FloatBubbleProps) {\n  const { handle } = useFloatBubble({\n    researchId,\n    params,\n    brand,\n    theme,\n    host,\n    onReady,\n    onSubmit,\n    onNavigate,\n    onClose,\n    onError,\n  });\n\n  useEffect(() => {\n    if (embedRef) {\n      embedRef.current = handle;\n    }\n    return () => {\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [embedRef, handle]);\n\n  return null;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perspective-ai/sdk-react",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "React components for Perspective AI embed SDK",
   "type": "module",
   "sideEffects": false,
@@ -56,7 +56,7 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@perspective-ai/sdk": "^1.0.1"
+    "@perspective-ai/sdk": "^1.1.0"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",

package/src/hooks/useAutoOpen.test.ts

@@ -0,0 +1,168 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { renderHook, cleanup, act } from "@testing-library/react";
+import { useAutoOpen } from "./useAutoOpen";
+
+vi.mock("@perspective-ai/sdk", () => ({
+  openPopup: vi.fn(() => ({
+    unmount: vi.fn(),
+    update: vi.fn(),
+    destroy: vi.fn(),
+    researchId: "test-id",
+    type: "popup",
+    iframe: null,
+    container: null,
+  })),
+  setupTrigger: vi.fn(() => vi.fn()),
+  shouldShow: vi.fn(() => true),
+  markShown: vi.fn(),
+}));
+
+// useStableCallback just passes through in tests
+vi.mock("./useStableCallback", () => ({
+  useStableCallback: (cb: unknown) => cb,
+}));
+
+import {
+  openPopup,
+  setupTrigger,
+  shouldShow,
+  markShown,
+} from "@perspective-ai/sdk";
+
+const mockOpenPopup = vi.mocked(openPopup);
+const mockSetupTrigger = vi.mocked(setupTrigger);
+const mockShouldShow = vi.mocked(shouldShow);
+const mockMarkShown = vi.mocked(markShown);
+
+describe("useAutoOpen", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    // Restore defaults after clearAllMocks resets implementations
+    mockShouldShow.mockReturnValue(true);
+    mockSetupTrigger.mockReturnValue(vi.fn());
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+    cleanup();
+  });
+
+  it("calls setupTrigger on mount when shouldShow returns true", () => {
+    renderHook(() =>
+      useAutoOpen({
+        researchId: "test-id",
+        trigger: { type: "timeout", delay: 5000 },
+      })
+    );
+
+    expect(mockShouldShow).toHaveBeenCalledWith("test-id", "session");
+    expect(mockSetupTrigger).toHaveBeenCalledWith(
+      { type: "timeout", delay: 5000 },
+      expect.any(Function)
+    );
+  });
+
+  it("does not call setupTrigger when shouldShow returns false", () => {
+    mockShouldShow.mockReturnValue(false);
+
+    renderHook(() =>
+      useAutoOpen({
+        researchId: "test-id",
+        trigger: { type: "timeout", delay: 5000 },
+      })
+    );
+
+    expect(mockSetupTrigger).not.toHaveBeenCalled();
+  });
+
+  it("calls markShown and openPopup when trigger fires", () => {
+    let triggerCallback: () => void;
+    mockSetupTrigger.mockImplementation((_config, cb) => {
+      triggerCallback = cb;
+      return vi.fn();
+    });
+
+    const { result } = renderHook(() =>
+      useAutoOpen({
+        researchId: "test-id",
+        trigger: { type: "timeout", delay: 5000 },
+        showOnce: "visitor",
+      })
+    );
+
+    expect(result.current.triggered).toBe(false);
+
+    act(() => triggerCallback!());
+
+    expect(mockMarkShown).toHaveBeenCalledWith("test-id", "visitor");
+    expect(mockOpenPopup).toHaveBeenCalledWith(
+      expect.objectContaining({ researchId: "test-id" })
+    );
+    expect(result.current.triggered).toBe(true);
+  });
+
+  it("only fires once even if trigger callback called multiple times", () => {
+    let triggerCallback: () => void;
+    mockSetupTrigger.mockImplementation((_config, cb) => {
+      triggerCallback = cb;
+      return vi.fn();
+    });
+
+    const { result } = renderHook(() =>
+      useAutoOpen({
+        researchId: "test-id",
+        trigger: { type: "timeout", delay: 5000 },
+      })
+    );
+
+    act(() => triggerCallback!());
+    act(() => triggerCallback!());
+
+    expect(mockOpenPopup).toHaveBeenCalledTimes(1);
+    expect(result.current.triggered).toBe(true);
+  });
+
+  it("defaults showOnce to session", () => {
+    renderHook(() =>
+      useAutoOpen({
+        researchId: "test-id",
+        trigger: { type: "exit-intent" },
+      })
+    );
+
+    expect(mockShouldShow).toHaveBeenCalledWith("test-id", "session");
+  });
+
+  it("calls cleanup on unmount", () => {
+    const mockCleanup = vi.fn();
+    mockSetupTrigger.mockReturnValue(mockCleanup);
+
+    const { unmount } = renderHook(() =>
+      useAutoOpen({
+        researchId: "test-id",
+        trigger: { type: "timeout", delay: 5000 },
+      })
+    );
+
+    unmount();
+
+    expect(mockCleanup).toHaveBeenCalled();
+  });
+
+  it("cancel() stops the trigger", () => {
+    const mockCleanup = vi.fn();
+    mockSetupTrigger.mockReturnValue(mockCleanup);
+
+    const { result } = renderHook(() =>
+      useAutoOpen({
+        researchId: "test-id",
+        trigger: { type: "timeout", delay: 5000 },
+      })
+    );
+
+    result.current.cancel();
+
+    expect(mockCleanup).toHaveBeenCalled();
+  });
+});

package/src/hooks/useAutoOpen.ts

@@ -0,0 +1,63 @@
+import { useEffect, useRef, useState, useCallback } from "react";
+import {
+  openPopup,
+  setupTrigger,
+  shouldShow,
+  markShown,
+} from "@perspective-ai/sdk";
+import type { EmbedConfig, TriggerConfig, ShowOnce } from "@perspective-ai/sdk";
+import { useStableCallback } from "./useStableCallback";
+
+export interface UseAutoOpenOptions extends Omit<
+  EmbedConfig,
+  "type" | "autoOpen"
+> {
+  trigger: TriggerConfig;
+  showOnce?: ShowOnce; // default: "session"
+}
+
+export interface UseAutoOpenReturn {
+  /** Cancel the pending trigger */
+  cancel: () => void;
+  /** Whether the trigger has fired */
+  triggered: boolean;
+}
+
+export function useAutoOpen(options: UseAutoOpenOptions): UseAutoOpenReturn {
+  const { trigger, showOnce = "session", researchId, ...embedConfig } = options;
+  const cleanupRef = useRef<(() => void) | null>(null);
+  const [triggered, setTriggered] = useState(false);
+  const triggerDelay = trigger.type === "timeout" ? trigger.delay : undefined;
+
+  // Fix #5: useStableCallback so the trigger always calls with latest config
+  const stableOnTrigger = useStableCallback(() => {
+    markShown(researchId, showOnce);
+    openPopup({ researchId, ...embedConfig });
+  });
+
+  useEffect(() => {
+    if (!shouldShow(researchId, showOnce)) return;
+
+    cleanupRef.current = setupTrigger(trigger, () => {
+      setTriggered((prev) => {
+        if (prev) return prev; // already fired
+        stableOnTrigger();
+        return true;
+      });
+    });
+
+    return () => {
+      cleanupRef.current?.();
+      cleanupRef.current = null;
+    };
+    // Primitive deps only — avoids re-triggering on object identity changes
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [researchId, trigger.type, triggerDelay, showOnce]);
+
+  const cancel = useCallback(() => {
+    cleanupRef.current?.();
+    cleanupRef.current = null;
+  }, []);
+
+  return { cancel, triggered };
+}

package/src/hooks/useStableCallback.test.ts

@@ -47,15 +47,29 @@ describe("useStableCallback", () => {
     expect(callback1).toHaveBeenCalledTimes(1); // Still only called once
   });
 
-  it("handles undefined callback", () => {
+  it("returns undefined when callback is undefined", () => {
     const { result } = renderHook(() => useStableCallback(undefined));
+    expect(result.current).toBeUndefined();
+  });
+
+  it("transitions between undefined and defined", () => {
+    const callback = vi.fn();
+    const { result, rerender } = renderHook(({ cb }) => useStableCallback(cb), {
+      initialProps: { cb: undefined as (() => void) | undefined },
+    });
+
+    expect(result.current).toBeUndefined();
+
+    rerender({ cb: callback });
+    expect(result.current).toBeDefined();
+    const stableRef = result.current;
+
+    // Remains stable across re-renders with different callback instances
+    rerender({ cb: vi.fn() });
+    expect(result.current).toBe(stableRef);
 
-    // Should not throw when called
-    expect(() => {
-      act(() => {
-        result.current("test");
-      });
-    }).not.toThrow();
+    rerender({ cb: undefined });
+    expect(result.current).toBeUndefined();
   });
 
   it("passes through all arguments", () => {

package/src/hooks/useStableCallback.ts

@@ -3,18 +3,22 @@ import { useRef, useCallback, useLayoutEffect, useEffect } from "react";
 const useIsomorphicLayoutEffect =
   typeof window !== "undefined" ? useLayoutEffect : useEffect;
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function useStableCallback<T extends (...args: any[]) => any>(
-  callback: T | undefined
-): T {
+export function useStableCallback<
+  T extends ((...args: any[]) => any) | undefined,
+>(callback: T): T {
   const callbackRef = useRef(callback);
 
   useIsomorphicLayoutEffect(() => {
     callbackRef.current = callback;
   });
 
-  return useCallback(
-    ((...args: Parameters<T>) => callbackRef.current?.(...args)) as T,
+  // Always create the stable wrapper (hooks can't be conditional),
+  // but return undefined when no callback is provided to preserve
+  // truthiness semantics for consumers that branch on it.
+  const stable = useCallback(
+    ((...args: any[]) => callbackRef.current?.(...args)) as NonNullable<T>,
     []
   );
+
+  return callback ? stable : callback;
 }

package/src/index.ts

@@ -32,6 +32,11 @@ export {
   type UseFloatBubbleOptions,
   type UseFloatBubbleReturn,
 } from "./hooks/useFloatBubble";
+export {
+  useAutoOpen,
+  type UseAutoOpenOptions,
+  type UseAutoOpenReturn,
+} from "./hooks/useAutoOpen";
 export { useThemeSync } from "./hooks/useThemeSync";
 export { useStableCallback } from "./hooks/useStableCallback";
 
@@ -46,4 +51,7 @@ export type {
   BrandColors,
   ThemeValue,
   EmbedError,
+  TriggerConfig,
+  ShowOnce,
+  AutoOpenConfig,
 } from "@perspective-ai/sdk";