@perspective-ai/sdk-react 1.0.0-alpha.2

package/dist/index.cjs

@@ -0,0 +1,529 @@
+'use strict';
+
+var react = require('react');
+var sdk = require('@perspective-ai/sdk');
+var jsxRuntime = require('react/jsx-runtime');
+
+var useIsomorphicLayoutEffect = typeof window !== "undefined" ? react.useLayoutEffect : react.useEffect;
+function useStableCallback(callback) {
+  const callbackRef = react.useRef(callback);
+  useIsomorphicLayoutEffect(() => {
+    callbackRef.current = callback;
+  });
+  return react.useCallback(
+    ((...args) => callbackRef.current?.(...args)),
+    []
+  );
+}
+function Widget({
+  researchId,
+  params,
+  brand,
+  theme,
+  host,
+  onReady,
+  onSubmit,
+  onNavigate,
+  onClose,
+  onError,
+  embedRef,
+  className,
+  style,
+  ...divProps
+}) {
+  const containerRef = react.useRef(null);
+  const handleRef = react.useRef(null);
+  const stableOnReady = useStableCallback(onReady);
+  const stableOnSubmit = useStableCallback(onSubmit);
+  const stableOnNavigate = useStableCallback(onNavigate);
+  const stableOnClose = useStableCallback(onClose);
+  const stableOnError = useStableCallback(onError);
+  react.useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    const handle = sdk.createWidget(container, {
+      researchId,
+      params,
+      brand,
+      theme,
+      host,
+      onReady: stableOnReady,
+      onSubmit: stableOnSubmit,
+      onNavigate: stableOnNavigate,
+      onClose: stableOnClose,
+      onError: stableOnError
+    });
+    handleRef.current = handle;
+    if (embedRef) {
+      embedRef.current = handle;
+    }
+    return () => {
+      handle.unmount();
+      handleRef.current = null;
+      if (embedRef) {
+        embedRef.current = null;
+      }
+    };
+  }, [
+    researchId,
+    params,
+    brand,
+    theme,
+    host,
+    stableOnReady,
+    stableOnSubmit,
+    stableOnNavigate,
+    stableOnClose,
+    stableOnError,
+    embedRef
+  ]);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      ref: containerRef,
+      className,
+      style: { minHeight: 500, ...style },
+      "data-testid": "perspective-widget",
+      ...divProps
+    }
+  );
+}
+function PopupButton({
+  researchId,
+  params,
+  brand,
+  theme,
+  host,
+  onReady,
+  onSubmit,
+  onNavigate,
+  onClose,
+  onError,
+  children,
+  open,
+  onOpenChange,
+  embedRef,
+  onClick,
+  ...buttonProps
+}) {
+  const handleRef = react.useRef(null);
+  const [internalOpen, setInternalOpen] = react.useState(false);
+  const isControlled = open !== void 0;
+  const isOpen = isControlled ? open : internalOpen;
+  const stableOnReady = useStableCallback(onReady);
+  const stableOnSubmit = useStableCallback(onSubmit);
+  const stableOnNavigate = useStableCallback(onNavigate);
+  const stableOnError = useStableCallback(onError);
+  const setOpen = react.useCallback(
+    (value) => {
+      if (isControlled) {
+        onOpenChange?.(value);
+      } else {
+        setInternalOpen(value);
+      }
+    },
+    [isControlled, onOpenChange]
+  );
+  const handleClose = react.useCallback(() => {
+    handleRef.current = null;
+    setOpen(false);
+    onClose?.();
+  }, [setOpen, onClose]);
+  const stableOnClose = useStableCallback(handleClose);
+  const createPopup = react.useCallback(() => {
+    if (handleRef.current) return handleRef.current;
+    const handle = sdk.openPopup({
+      researchId,
+      params,
+      brand,
+      theme,
+      host,
+      onReady: stableOnReady,
+      onSubmit: stableOnSubmit,
+      onNavigate: stableOnNavigate,
+      onClose: stableOnClose,
+      onError: stableOnError
+    });
+    handleRef.current = handle;
+    return handle;
+  }, [
+    researchId,
+    params,
+    brand,
+    theme,
+    host,
+    stableOnReady,
+    stableOnSubmit,
+    stableOnNavigate,
+    stableOnClose,
+    stableOnError
+  ]);
+  const proxyHandle = react.useMemo(
+    () => ({
+      open: () => {
+        createPopup();
+        setOpen(true);
+      },
+      close: () => {
+        handleRef.current?.destroy();
+        handleRef.current = null;
+        setOpen(false);
+      },
+      toggle: () => {
+        if (handleRef.current) {
+          handleRef.current.destroy();
+          handleRef.current = null;
+          setOpen(false);
+        } else {
+          createPopup();
+          setOpen(true);
+        }
+      },
+      unmount: () => {
+        handleRef.current?.unmount();
+        handleRef.current = null;
+        setOpen(false);
+      },
+      get isOpen() {
+        return isOpen;
+      },
+      researchId
+    }),
+    [createPopup, setOpen, researchId, isOpen]
+  );
+  react.useEffect(() => {
+    if (embedRef) {
+      embedRef.current = proxyHandle;
+    }
+    return () => {
+      if (embedRef) {
+        embedRef.current = null;
+      }
+    };
+  }, [embedRef, proxyHandle]);
+  react.useEffect(() => {
+    if (!isControlled) return;
+    if (open && !handleRef.current) {
+      createPopup();
+    } else if (!open && handleRef.current) {
+      handleRef.current.destroy();
+      handleRef.current = null;
+    }
+  }, [open, isControlled, createPopup]);
+  const handleClick = react.useCallback(
+    (e) => {
+      onClick?.(e);
+      if (e.defaultPrevented) return;
+      if (isOpen && handleRef.current) {
+        handleRef.current.destroy();
+        handleRef.current = null;
+        setOpen(false);
+      } else {
+        createPopup();
+        setOpen(true);
+      }
+    },
+    [onClick, isOpen, createPopup, setOpen]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      "data-testid": "perspective-popup-button",
+      ...buttonProps,
+      children
+    }
+  );
+}
+function SliderButton({
+  researchId,
+  params,
+  brand,
+  theme,
+  host,
+  onReady,
+  onSubmit,
+  onNavigate,
+  onClose,
+  onError,
+  children,
+  open,
+  onOpenChange,
+  embedRef,
+  onClick,
+  ...buttonProps
+}) {
+  const handleRef = react.useRef(null);
+  const [internalOpen, setInternalOpen] = react.useState(false);
+  const isControlled = open !== void 0;
+  const isOpen = isControlled ? open : internalOpen;
+  const stableOnReady = useStableCallback(onReady);
+  const stableOnSubmit = useStableCallback(onSubmit);
+  const stableOnNavigate = useStableCallback(onNavigate);
+  const stableOnError = useStableCallback(onError);
+  const setOpen = react.useCallback(
+    (value) => {
+      if (isControlled) {
+        onOpenChange?.(value);
+      } else {
+        setInternalOpen(value);
+      }
+    },
+    [isControlled, onOpenChange]
+  );
+  const handleClose = react.useCallback(() => {
+    handleRef.current = null;
+    setOpen(false);
+    onClose?.();
+  }, [setOpen, onClose]);
+  const stableOnClose = useStableCallback(handleClose);
+  const createSlider = react.useCallback(() => {
+    if (handleRef.current) return handleRef.current;
+    const handle = sdk.openSlider({
+      researchId,
+      params,
+      brand,
+      theme,
+      host,
+      onReady: stableOnReady,
+      onSubmit: stableOnSubmit,
+      onNavigate: stableOnNavigate,
+      onClose: stableOnClose,
+      onError: stableOnError
+    });
+    handleRef.current = handle;
+    return handle;
+  }, [
+    researchId,
+    params,
+    brand,
+    theme,
+    host,
+    stableOnReady,
+    stableOnSubmit,
+    stableOnNavigate,
+    stableOnClose,
+    stableOnError
+  ]);
+  const proxyHandle = react.useMemo(
+    () => ({
+      open: () => {
+        createSlider();
+        setOpen(true);
+      },
+      close: () => {
+        handleRef.current?.destroy();
+        handleRef.current = null;
+        setOpen(false);
+      },
+      toggle: () => {
+        if (handleRef.current) {
+          handleRef.current.destroy();
+          handleRef.current = null;
+          setOpen(false);
+        } else {
+          createSlider();
+          setOpen(true);
+        }
+      },
+      unmount: () => {
+        handleRef.current?.unmount();
+        handleRef.current = null;
+        setOpen(false);
+      },
+      get isOpen() {
+        return isOpen;
+      },
+      researchId
+    }),
+    [createSlider, setOpen, researchId, isOpen]
+  );
+  react.useEffect(() => {
+    if (embedRef) {
+      embedRef.current = proxyHandle;
+    }
+    return () => {
+      if (embedRef) {
+        embedRef.current = null;
+      }
+    };
+  }, [embedRef, proxyHandle]);
+  react.useEffect(() => {
+    if (!isControlled) return;
+    if (open && !handleRef.current) {
+      createSlider();
+    } else if (!open && handleRef.current) {
+      handleRef.current.destroy();
+      handleRef.current = null;
+    }
+  }, [open, isControlled, createSlider]);
+  const handleClick = react.useCallback(
+    (e) => {
+      onClick?.(e);
+      if (e.defaultPrevented) return;
+      if (isOpen && handleRef.current) {
+        handleRef.current.destroy();
+        handleRef.current = null;
+        setOpen(false);
+      } else {
+        createSlider();
+        setOpen(true);
+      }
+    },
+    [onClick, isOpen, createSlider, setOpen]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      "data-testid": "perspective-slider-button",
+      ...buttonProps,
+      children
+    }
+  );
+}
+function FloatBubble({
+  researchId,
+  params,
+  brand,
+  theme,
+  host,
+  onReady,
+  onSubmit,
+  onNavigate,
+  onClose,
+  onError,
+  embedRef
+}) {
+  const handleRef = react.useRef(null);
+  const stableOnReady = useStableCallback(onReady);
+  const stableOnSubmit = useStableCallback(onSubmit);
+  const stableOnNavigate = useStableCallback(onNavigate);
+  const stableOnClose = useStableCallback(onClose);
+  const stableOnError = useStableCallback(onError);
+  react.useEffect(() => {
+    const handle = sdk.createFloatBubble({
+      researchId,
+      params,
+      brand,
+      theme,
+      host,
+      onReady: stableOnReady,
+      onSubmit: stableOnSubmit,
+      onNavigate: stableOnNavigate,
+      onClose: stableOnClose,
+      onError: stableOnError
+    });
+    handleRef.current = handle;
+    if (embedRef) {
+      embedRef.current = handle;
+    }
+    return () => {
+      handle.unmount();
+      handleRef.current = null;
+      if (embedRef) {
+        embedRef.current = null;
+      }
+    };
+  }, [
+    researchId,
+    params,
+    brand,
+    theme,
+    host,
+    stableOnReady,
+    stableOnSubmit,
+    stableOnNavigate,
+    stableOnClose,
+    stableOnError,
+    embedRef
+  ]);
+  return null;
+}
+function Fullpage({
+  researchId,
+  params,
+  brand,
+  theme,
+  host,
+  onReady,
+  onSubmit,
+  onNavigate,
+  onClose,
+  onError,
+  embedRef
+}) {
+  const handleRef = react.useRef(null);
+  const stableOnReady = useStableCallback(onReady);
+  const stableOnSubmit = useStableCallback(onSubmit);
+  const stableOnNavigate = useStableCallback(onNavigate);
+  const stableOnClose = useStableCallback(onClose);
+  const stableOnError = useStableCallback(onError);
+  react.useEffect(() => {
+    const handle = sdk.createFullpage({
+      researchId,
+      params,
+      brand,
+      theme,
+      host,
+      onReady: stableOnReady,
+      onSubmit: stableOnSubmit,
+      onNavigate: stableOnNavigate,
+      onClose: stableOnClose,
+      onError: stableOnError
+    });
+    handleRef.current = handle;
+    if (embedRef) {
+      embedRef.current = handle;
+    }
+    return () => {
+      handle.unmount();
+      handleRef.current = null;
+      if (embedRef) {
+        embedRef.current = null;
+      }
+    };
+  }, [
+    researchId,
+    params,
+    brand,
+    theme,
+    host,
+    stableOnReady,
+    stableOnSubmit,
+    stableOnNavigate,
+    stableOnClose,
+    stableOnError,
+    embedRef
+  ]);
+  return null;
+}
+function useThemeSync(theme = "system") {
+  const [resolved, setResolved] = react.useState(
+    theme !== "system" ? theme : "light"
+  );
+  react.useEffect(() => {
+    if (theme !== "system") {
+      setResolved(theme);
+      return;
+    }
+    const mq = window.matchMedia("(prefers-color-scheme: dark)");
+    setResolved(mq.matches ? "dark" : "light");
+    const handler = (e) => setResolved(e.matches ? "dark" : "light");
+    mq.addEventListener("change", handler);
+    return () => mq.removeEventListener("change", handler);
+  }, [theme]);
+  return resolved;
+}
+
+exports.FloatBubble = FloatBubble;
+exports.Fullpage = Fullpage;
+exports.PopupButton = PopupButton;
+exports.SliderButton = SliderButton;
+exports.Widget = Widget;
+exports.useStableCallback = useStableCallback;
+exports.useThemeSync = useThemeSync;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useStableCallback.ts","../src/Widget.tsx","../src/PopupButton.tsx","../src/SliderButton.tsx","../src/FloatBubble.tsx","../src/Fullpage.tsx","../src/hooks/useThemeSync.ts"],"names":["useLayoutEffect","useEffect","useRef","useCallback","createWidget","jsx","useState","openPopup","useMemo","openSlider","createFloatBubble","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 { 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 {\n  useRef,\n  useCallback,\n  useState,\n  useEffect,\n  useMemo,\n  type ReactNode,\n  type ButtonHTMLAttributes,\n  type RefObject,\n} from \"react\";\nimport {\n  openPopup,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\n/** Handle for programmatic control of popup button */\nexport interface PopupButtonHandle {\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n  unmount: () => void;\n  readonly isOpen: boolean;\n  readonly researchId: string;\n}\n\nexport interface PopupButtonProps\n  extends\n    Omit<EmbedConfig, \"type\">,\n    Omit<ButtonHTMLAttributes<HTMLButtonElement>, \"onError\" | \"onSubmit\"> {\n  /** Button content */\n  children: ReactNode;\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n  /** Ref to access the handle for programmatic control */\n  embedRef?: RefObject<PopupButtonHandle | null>;\n}\n\n/**\n * Button that opens a popup modal when clicked.\n * Supports both controlled and uncontrolled modes.\n */\nexport function PopupButton({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  children,\n  open,\n  onOpenChange,\n  embedRef,\n  onClick,\n  ...buttonProps\n}: PopupButtonProps) {\n  const handleRef = useRef<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n\n  const isControlled = open !== undefined;\n  const isOpen = isControlled ? open : 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    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 handle = 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 = handle;\n    return handle;\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 proxyHandle = useMemo<PopupButtonHandle>(\n    () => ({\n      open: () => {\n        createPopup();\n        setOpen(true);\n      },\n      close: () => {\n        handleRef.current?.destroy();\n        handleRef.current = null;\n        setOpen(false);\n      },\n      toggle: () => {\n        if (handleRef.current) {\n          handleRef.current.destroy();\n          handleRef.current = null;\n          setOpen(false);\n        } else {\n          createPopup();\n          setOpen(true);\n        }\n      },\n      unmount: () => {\n        handleRef.current?.unmount();\n        handleRef.current = null;\n        setOpen(false);\n      },\n      get isOpen() {\n        return isOpen;\n      },\n      researchId,\n    }),\n    [createPopup, setOpen, researchId, isOpen]\n  );\n\n  useEffect(() => {\n    if (embedRef) {\n      embedRef.current = proxyHandle;\n    }\n    return () => {\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [embedRef, proxyHandle]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (open && !handleRef.current) {\n      createPopup();\n    } else if (!open && handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n    }\n  }, [open, isControlled, createPopup]);\n\n  const handleClick = useCallback(\n    (e: React.MouseEvent<HTMLButtonElement>) => {\n      onClick?.(e);\n      if (e.defaultPrevented) return;\n\n      if (isOpen && handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n        setOpen(false);\n      } else {\n        createPopup();\n        setOpen(true);\n      }\n    },\n    [onClick, isOpen, createPopup, setOpen]\n  );\n\n  return (\n    <button\n      type=\"button\"\n      onClick={handleClick}\n      data-testid=\"perspective-popup-button\"\n      {...buttonProps}\n    >\n      {children}\n    </button>\n  );\n}\n","import {\n  useRef,\n  useCallback,\n  useState,\n  useEffect,\n  useMemo,\n  type ReactNode,\n  type ButtonHTMLAttributes,\n  type RefObject,\n} from \"react\";\nimport {\n  openSlider,\n  type EmbedConfig,\n  type EmbedHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\n\n/** Handle for programmatic control of slider button */\nexport interface SliderButtonHandle {\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n  unmount: () => void;\n  readonly isOpen: boolean;\n  readonly researchId: string;\n}\n\nexport interface SliderButtonProps\n  extends\n    Omit<EmbedConfig, \"type\">,\n    Omit<ButtonHTMLAttributes<HTMLButtonElement>, \"onError\" | \"onSubmit\"> {\n  /** Button content */\n  children: ReactNode;\n  /** Controlled open state */\n  open?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n  /** Ref to access the handle for programmatic control */\n  embedRef?: RefObject<SliderButtonHandle | null>;\n}\n\n/**\n * Button that opens a slider panel when clicked.\n * Supports both controlled and uncontrolled modes.\n */\nexport function SliderButton({\n  researchId,\n  params,\n  brand,\n  theme,\n  host,\n  onReady,\n  onSubmit,\n  onNavigate,\n  onClose,\n  onError,\n  children,\n  open,\n  onOpenChange,\n  embedRef,\n  onClick,\n  ...buttonProps\n}: SliderButtonProps) {\n  const handleRef = useRef<EmbedHandle | null>(null);\n  const [internalOpen, setInternalOpen] = useState(false);\n\n  const isControlled = open !== undefined;\n  const isOpen = isControlled ? open : 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    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 handle = 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 = handle;\n    return handle;\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 proxyHandle = useMemo<SliderButtonHandle>(\n    () => ({\n      open: () => {\n        createSlider();\n        setOpen(true);\n      },\n      close: () => {\n        handleRef.current?.destroy();\n        handleRef.current = null;\n        setOpen(false);\n      },\n      toggle: () => {\n        if (handleRef.current) {\n          handleRef.current.destroy();\n          handleRef.current = null;\n          setOpen(false);\n        } else {\n          createSlider();\n          setOpen(true);\n        }\n      },\n      unmount: () => {\n        handleRef.current?.unmount();\n        handleRef.current = null;\n        setOpen(false);\n      },\n      get isOpen() {\n        return isOpen;\n      },\n      researchId,\n    }),\n    [createSlider, setOpen, researchId, isOpen]\n  );\n\n  useEffect(() => {\n    if (embedRef) {\n      embedRef.current = proxyHandle;\n    }\n    return () => {\n      if (embedRef) {\n        embedRef.current = null;\n      }\n    };\n  }, [embedRef, proxyHandle]);\n\n  useEffect(() => {\n    if (!isControlled) return;\n\n    if (open && !handleRef.current) {\n      createSlider();\n    } else if (!open && handleRef.current) {\n      handleRef.current.destroy();\n      handleRef.current = null;\n    }\n  }, [open, isControlled, createSlider]);\n\n  const handleClick = useCallback(\n    (e: React.MouseEvent<HTMLButtonElement>) => {\n      onClick?.(e);\n      if (e.defaultPrevented) return;\n\n      if (isOpen && handleRef.current) {\n        handleRef.current.destroy();\n        handleRef.current = null;\n        setOpen(false);\n      } else {\n        createSlider();\n        setOpen(true);\n      }\n    },\n    [onClick, isOpen, createSlider, setOpen]\n  );\n\n  return (\n    <button\n      type=\"button\"\n      onClick={handleClick}\n      data-testid=\"perspective-slider-button\"\n      {...buttonProps}\n    >\n      {children}\n    </button>\n  );\n}\n","import { useRef, useEffect, type RefObject } from \"react\";\nimport {\n  createFloatBubble,\n  type EmbedConfig,\n  type FloatHandle,\n} from \"@perspective-ai/sdk\";\nimport { useStableCallback } from \"./hooks/useStableCallback\";\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 * Renders a floating button in the corner of the screen.\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 handleRef = useRef<FloatHandle | 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 = 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 = 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 bubble is added to document.body\n  return null;\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 { 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"]}

package/dist/index.d.cts

@@ -0,0 +1,96 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { HTMLAttributes, RefObject, ButtonHTMLAttributes, ReactNode } from 'react';
+import { EmbedConfig, EmbedHandle, FloatHandle } from '@perspective-ai/sdk';
+export { BrandColors, EmbedConfig, EmbedError, EmbedHandle, FloatHandle, ThemeValue } from '@perspective-ai/sdk';
+
+interface WidgetProps extends Omit<EmbedConfig, "type">, Omit<HTMLAttributes<HTMLDivElement>, "onError" | "onSubmit"> {
+    /** Ref to access the embed handle for programmatic control */
+    embedRef?: RefObject<EmbedHandle | null>;
+}
+/**
+ * Inline widget embed component.
+ * Renders the interview directly in a container.
+ */
+declare function Widget({ researchId, params, brand, theme, host, onReady, onSubmit, onNavigate, onClose, onError, embedRef, className, style, ...divProps }: WidgetProps): react_jsx_runtime.JSX.Element;
+
+/** Handle for programmatic control of popup button */
+interface PopupButtonHandle {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    unmount: () => void;
+    readonly isOpen: boolean;
+    readonly researchId: string;
+}
+interface PopupButtonProps extends Omit<EmbedConfig, "type">, Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onError" | "onSubmit"> {
+    /** Button content */
+    children: ReactNode;
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Ref to access the handle for programmatic control */
+    embedRef?: RefObject<PopupButtonHandle | null>;
+}
+/**
+ * Button that opens a popup modal when clicked.
+ * Supports both controlled and uncontrolled modes.
+ */
+declare function PopupButton({ researchId, params, brand, theme, host, onReady, onSubmit, onNavigate, onClose, onError, children, open, onOpenChange, embedRef, onClick, ...buttonProps }: PopupButtonProps): react_jsx_runtime.JSX.Element;
+
+/** Handle for programmatic control of slider button */
+interface SliderButtonHandle {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    unmount: () => void;
+    readonly isOpen: boolean;
+    readonly researchId: string;
+}
+interface SliderButtonProps extends Omit<EmbedConfig, "type">, Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onError" | "onSubmit"> {
+    /** Button content */
+    children: ReactNode;
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Ref to access the handle for programmatic control */
+    embedRef?: RefObject<SliderButtonHandle | null>;
+}
+/**
+ * Button that opens a slider panel when clicked.
+ * Supports both controlled and uncontrolled modes.
+ */
+declare function SliderButton({ researchId, params, brand, theme, host, onReady, onSubmit, onNavigate, onClose, onError, children, open, onOpenChange, embedRef, onClick, ...buttonProps }: SliderButtonProps): react_jsx_runtime.JSX.Element;
+
+interface FloatBubbleProps extends Omit<EmbedConfig, "type"> {
+    /** Ref to access the handle for programmatic control */
+    embedRef?: RefObject<FloatHandle | null>;
+}
+/**
+ * Floating bubble widget that expands into a chat window.
+ * Renders a floating button in the corner of the screen.
+ */
+declare function FloatBubble({ researchId, params, brand, theme, host, onReady, onSubmit, onNavigate, onClose, onError, embedRef, }: FloatBubbleProps): null;
+
+interface FullpageProps extends Omit<EmbedConfig, "type"> {
+    /** Ref to access the embed handle for programmatic control */
+    embedRef?: RefObject<EmbedHandle | null>;
+}
+/**
+ * Full viewport embed component.
+ * Takes over the entire screen with the interview.
+ */
+declare function Fullpage({ researchId, params, brand, theme, host, onReady, onSubmit, onNavigate, onClose, onError, embedRef, }: FullpageProps): null;
+
+type Theme = "light" | "dark";
+type ThemeInput = "light" | "dark" | "system";
+/**
+ * Hook to resolve theme based on override and system preference.
+ * Listens for system preference changes when theme is "system".
+ */
+declare function useThemeSync(theme?: ThemeInput): Theme;
+
+declare function useStableCallback<T extends (...args: any[]) => any>(callback: T | undefined): T;
+
+export { FloatBubble, type FloatBubbleProps, Fullpage, type FullpageProps, PopupButton, type PopupButtonHandle, type PopupButtonProps, SliderButton, type SliderButtonHandle, type SliderButtonProps, Widget, type WidgetProps, useStableCallback, useThemeSync };