@wallavi/widget 1.3.9 → 1.4.0

package/dist/index.d.mts

@@ -119,8 +119,32 @@ interface BubbleWidgetProps extends ChatWidgetConfig {
      * @default true
      */
     autoConfig?: boolean;
+    /**
+     * Hide the floating bubble button. The panel can still be opened via:
+     *   - Keyboard shortcut (keyboardShortcut + shortcutKey)
+     *   - Controlled mode (isOpen + onOpenChange) — connect your own button or trigger
+     * Useful when you want a custom-placed button or a purely keyboard-driven widget.
+     * @default false
+     */
+    hideBubble?: boolean;
+    /**
+     * Controlled open state. When provided the widget becomes fully controlled —
+     * the parent is responsible for managing open/close. Pair with onOpenChange.
+     *
+     * @example
+     * const [chatOpen, setChatOpen] = useState(false);
+     * <button onClick={() => setChatOpen(v => !v)}>Support</button>
+     * <BubbleWidget isOpen={chatOpen} onOpenChange={setChatOpen} hideBubble ... />
+     */
+    isOpen?: boolean;
+    /**
+     * Called whenever the widget wants to change its open state
+     * (bubble click, header close button, Cmd+K, autoOpen).
+     * Use together with isOpen to fully control open/close from outside.
+     */
+    onOpenChange?: (open: boolean) => void;
 }
-declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
+declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, hideBubble, isOpen: isOpenProp, onOpenChange, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
 
 declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 

package/dist/index.d.ts

@@ -119,8 +119,32 @@ interface BubbleWidgetProps extends ChatWidgetConfig {
      * @default true
      */
     autoConfig?: boolean;
+    /**
+     * Hide the floating bubble button. The panel can still be opened via:
+     *   - Keyboard shortcut (keyboardShortcut + shortcutKey)
+     *   - Controlled mode (isOpen + onOpenChange) — connect your own button or trigger
+     * Useful when you want a custom-placed button or a purely keyboard-driven widget.
+     * @default false
+     */
+    hideBubble?: boolean;
+    /**
+     * Controlled open state. When provided the widget becomes fully controlled —
+     * the parent is responsible for managing open/close. Pair with onOpenChange.
+     *
+     * @example
+     * const [chatOpen, setChatOpen] = useState(false);
+     * <button onClick={() => setChatOpen(v => !v)}>Support</button>
+     * <BubbleWidget isOpen={chatOpen} onOpenChange={setChatOpen} hideBubble ... />
+     */
+    isOpen?: boolean;
+    /**
+     * Called whenever the widget wants to change its open state
+     * (bubble click, header close button, Cmd+K, autoOpen).
+     * Use together with isOpen to fully control open/close from outside.
+     */
+    onOpenChange?: (open: boolean) => void;
 }
-declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
+declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, hideBubble, isOpen: isOpenProp, onOpenChange, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
 
 declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 

package/dist/index.js

@@ -835,9 +835,19 @@ function BubbleWidget({
   bubbleSize = 52,
   panelClassName,
   autoConfig = true,
+  hideBubble = false,
+  isOpen: isOpenProp,
+  onOpenChange,
   ...chatProps
 }) {
-  const [open, setOpen] = react.useState(false);
+  const isControlled = isOpenProp !== void 0;
+  const [internalOpen, setInternalOpen] = react.useState(false);
+  const open = isControlled ? isOpenProp : internalOpen;
+  const setOpen = react.useCallback((valueOrUpdater) => {
+    const next = typeof valueOrUpdater === "function" ? valueOrUpdater(open) : valueOrUpdater;
+    if (!isControlled) setInternalOpen(next);
+    onOpenChange?.(next);
+  }, [isControlled, open, onOpenChange]);
   const [expanded, setExpanded] = react.useState(false);
   const panelRef = react.useRef(null);
   const autoOpenedRef = react.useRef(false);
@@ -906,7 +916,9 @@ function BubbleWidget({
   }, [open]);
   const handleClose = () => {
     setOpen(false);
-    localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    if (!isControlled) {
+      localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    }
   };
   const toggleExpanded = () => setExpanded((v) => {
     const next = !v;
@@ -953,7 +965,7 @@ function BubbleWidget({
             )
           }
         ),
-        /* @__PURE__ */ jsxRuntime.jsx(
+        !hideBubble && /* @__PURE__ */ jsxRuntime.jsx(
           "button",
           {
             onClick: () => setOpen((v) => !v),

package/dist/index.mjs

@@ -809,9 +809,19 @@ function BubbleWidget({
   bubbleSize = 52,
   panelClassName,
   autoConfig = true,
+  hideBubble = false,
+  isOpen: isOpenProp,
+  onOpenChange,
   ...chatProps
 }) {
-  const [open, setOpen] = useState(false);
+  const isControlled = isOpenProp !== void 0;
+  const [internalOpen, setInternalOpen] = useState(false);
+  const open = isControlled ? isOpenProp : internalOpen;
+  const setOpen = useCallback((valueOrUpdater) => {
+    const next = typeof valueOrUpdater === "function" ? valueOrUpdater(open) : valueOrUpdater;
+    if (!isControlled) setInternalOpen(next);
+    onOpenChange?.(next);
+  }, [isControlled, open, onOpenChange]);
   const [expanded, setExpanded] = useState(false);
   const panelRef = useRef(null);
   const autoOpenedRef = useRef(false);
@@ -880,7 +890,9 @@ function BubbleWidget({
   }, [open]);
   const handleClose = () => {
     setOpen(false);
-    localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    if (!isControlled) {
+      localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    }
   };
   const toggleExpanded = () => setExpanded((v) => {
     const next = !v;
@@ -927,7 +939,7 @@ function BubbleWidget({
             )
           }
         ),
-        /* @__PURE__ */ jsx(
+        !hideBubble && /* @__PURE__ */ jsx(
           "button",
           {
             onClick: () => setOpen((v) => !v),

package/package.json

@@ -33,7 +33,7 @@
   },
   "private": false,
   "types": "./dist/index.d.ts",
-  "version": "1.3.9",
+  "version": "1.4.0",
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit"