@usecrow/ui 0.1.64 → 0.1.66

package/dist/index.d.cts

@@ -84,6 +84,8 @@ interface WidgetBubbleConfig {
     size?: number;
     /** Icon size inside bubble in pixels */
     iconSize?: number;
+    /** Text label shown next to bubble icon (pill shape when set) */
+    label?: string;
 }
 interface WidgetShadowsConfig {
     /** Widget container shadow (CSS box-shadow) */
@@ -318,6 +320,7 @@ declare global {
         __crow_identity_token_fetcher?: () => Promise<string>;
         __crow_on_tool_result?: (toolName: string, result: Record<string, unknown>) => void;
         __crow_tool_renderers?: ToolRenderers;
+        __crow_context_label?: string;
     }
 }
 
@@ -394,8 +397,13 @@ interface CrowWidgetProps {
      * Appended after default styles, allowing overrides.
      */
     customCss?: string;
+    /**
+     * Label shown at the top of the widget indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, contextLabel: contextLabelProp, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -477,8 +485,13 @@ interface CrowCopilotProps {
      * responds in that language and the welcome message is translated.
      */
     language?: string;
+    /**
+     * Label shown at the top of the copilot indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, contextLabel: contextLabelProp, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -1181,8 +1194,10 @@ interface WidgetHeaderProps {
     hasCustomTransform?: boolean;
     /** Reset position & size to defaults */
     onResetTransform?: () => void;
+    /** Context label displayed below the header row */
+    contextLabel?: string;
 }
-declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
+declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, contextLabel, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * CopilotToggleButton - Edge toggle button for floating copilot

package/dist/index.d.ts

@@ -84,6 +84,8 @@ interface WidgetBubbleConfig {
     size?: number;
     /** Icon size inside bubble in pixels */
     iconSize?: number;
+    /** Text label shown next to bubble icon (pill shape when set) */
+    label?: string;
 }
 interface WidgetShadowsConfig {
     /** Widget container shadow (CSS box-shadow) */
@@ -318,6 +320,7 @@ declare global {
         __crow_identity_token_fetcher?: () => Promise<string>;
         __crow_on_tool_result?: (toolName: string, result: Record<string, unknown>) => void;
         __crow_tool_renderers?: ToolRenderers;
+        __crow_context_label?: string;
     }
 }
 
@@ -394,8 +397,13 @@ interface CrowWidgetProps {
      * Appended after default styles, allowing overrides.
      */
     customCss?: string;
+    /**
+     * Label shown at the top of the widget indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, customCss, contextLabel: contextLabelProp, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
@@ -477,8 +485,13 @@ interface CrowCopilotProps {
      * responds in that language and the welcome message is translated.
      */
     language?: string;
+    /**
+     * Label shown at the top of the copilot indicating what page/context the AI
+     * is aware of. Prop takes priority over window.crow('setContextLabel', ...).
+     */
+    contextLabel?: string;
 }
-declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, contextLabel: contextLabelProp, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -1181,8 +1194,10 @@ interface WidgetHeaderProps {
     hasCustomTransform?: boolean;
     /** Reset position & size to defaults */
     onResetTransform?: () => void;
+    /** Context label displayed below the header row */
+    contextLabel?: string;
 }
-declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
+declare function WidgetHeader({ isVerifiedUser, showConversationList, onNewChat, onToggleHistory, showMinimize, onToggleMinimize, onDragPointerDown, isDragging, hasCustomTransform, onResetTransform, contextLabel, }: WidgetHeaderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * CopilotToggleButton - Edge toggle button for floating copilot

package/dist/index.js

@@ -1237,6 +1237,16 @@ function useCrowAPI({ onIdentified, onReset } = {}) {
           }
           return crowAsk(opts);
         }
+        case "setContextLabel":
+          if (typeof options !== "string") {
+            console.error("[Crow] setContextLabel() requires a string");
+            return;
+          }
+          window.__crow_context_label = options || void 0;
+          window.dispatchEvent(
+            new CustomEvent("crow:setContextLabel", { detail: options })
+          );
+          break;
         case "setSuggestedActions":
           if (!Array.isArray(options)) {
             console.error("[Crow] setSuggestedActions() requires an array of { label, message }");
@@ -1369,7 +1379,8 @@ var DEFAULT_WIDGET_STYLES = {
   // ═══════════════════════════════════════════════════════════
   bubble: {
     size: 48,
-    iconSize: 24
+    iconSize: 24,
+    label: ""
   },
   // ═══════════════════════════════════════════════════════════
   // SHADOWS
@@ -2307,14 +2318,20 @@ function ShadowContainer({
 ShadowContainer.displayName = "ShadowContainer";
 function ChatBubble({ isExpanded, onClick }) {
   const { styles } = useWidgetStyleContext();
-  return /* @__PURE__ */ jsx(
+  const label = styles.bubble.label;
+  const showLabel = !isExpanded && !!label;
+  return /* @__PURE__ */ jsxs(
     "button",
     {
       onClick,
-      className: "crow-fixed crow-z-[999999] crow-rounded-full crow-flex crow-items-center crow-justify-center crow-shadow-2xl hover:crow-scale-110 crow-transition-all crow-duration-500 crow-border crow-backdrop-blur-md",
+      className: "crow-fixed crow-z-[999999] crow-flex crow-items-center crow-justify-center crow-shadow-2xl hover:crow-scale-110 crow-transition-all crow-duration-500 crow-border crow-backdrop-blur-md",
       style: {
-        width: styles.bubble.size,
         height: styles.bubble.size,
+        width: showLabel ? "auto" : styles.bubble.size,
+        paddingLeft: showLabel ? styles.bubble.size * 0.3 : 0,
+        paddingRight: showLabel ? styles.bubble.size * 0.4 : 0,
+        gap: showLabel ? 6 : 0,
+        borderRadius: 9999,
         right: styles.position.bubbleRight,
         bottom: styles.position.bubbleBottom,
         background: styles.colors.bubbleBackground,
@@ -2323,7 +2340,15 @@ function ChatBubble({ isExpanded, onClick }) {
         color: styles.colors.bubbleIcon
       },
       "aria-label": isExpanded ? "Close Chat" : "Open Chat",
-      children: isExpanded ? /* @__PURE__ */ jsx(ChevronDown, { size: styles.bubble.iconSize, strokeWidth: 2 }) : /* @__PURE__ */ jsx(MessageCircle, { size: styles.bubble.iconSize, strokeWidth: 2 })
+      children: [
+        isExpanded ? /* @__PURE__ */ jsx(ChevronDown, { size: styles.bubble.iconSize, strokeWidth: 2 }) : /* @__PURE__ */ jsx(MessageCircle, { size: styles.bubble.iconSize, strokeWidth: 2 }),
+        showLabel && /* @__PURE__ */ jsx("span", { style: {
+          fontSize: styles.bubble.iconSize * 0.6,
+          fontWeight: 500,
+          whiteSpace: "nowrap",
+          fontFamily: "system-ui, sans-serif"
+        }, children: label })
+      ]
     }
   );
 }
@@ -2423,7 +2448,8 @@ function WidgetHeader({
   onDragPointerDown,
   isDragging,
   hasCustomTransform,
-  onResetTransform
+  onResetTransform,
+  contextLabel
 }) {
   const { agentName, styles } = useWidgetStyleContext();
   return /* @__PURE__ */ jsxs(
@@ -2511,7 +2537,36 @@ function WidgetHeader({
               children: /* @__PURE__ */ jsx(X, { size: 18, className: "crow-text-gray-700" })
             }
           )
-        ] })
+        ] }),
+        contextLabel && /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "crow-flex crow-items-center crow-gap-1.5 crow-mt-1 crow-text-xs",
+            style: { color: "#6b7280" },
+            children: [
+              /* @__PURE__ */ jsxs(
+                "svg",
+                {
+                  xmlns: "http://www.w3.org/2000/svg",
+                  width: "12",
+                  height: "12",
+                  viewBox: "0 0 24 24",
+                  fill: "none",
+                  stroke: "currentColor",
+                  strokeWidth: "2",
+                  strokeLinecap: "round",
+                  strokeLinejoin: "round",
+                  className: "crow-shrink-0",
+                  children: [
+                    /* @__PURE__ */ jsx("path", { d: "M20 10c0 6-8 12-8 12s-8-6-8-12a8 8 0 0 1 16 0Z" }),
+                    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "10", r: "3" })
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsx("span", { className: "crow-truncate", children: contextLabel })
+            ]
+          }
+        )
       ]
     }
   );
@@ -4117,7 +4172,8 @@ function CrowWidget({
   context,
   toolRenderers,
   language,
-  customCss
+  customCss,
+  contextLabel: contextLabelProp
 }) {
   const effectiveGetIdentityToken = getIdentityToken || window.__crow_identity_token_fetcher;
   const effectiveOnToolResult = onToolResult || window.__crow_on_tool_result;
@@ -4158,6 +4214,15 @@ function CrowWidget({
     window.addEventListener("crow:setGreeting", handler);
     return () => window.removeEventListener("crow:setGreeting", handler);
   }, []);
+  const [contextLabelFromAPI, setContextLabelFromAPI] = useState(
+    () => window.__crow_context_label
+  );
+  useEffect(() => {
+    const handler = (e) => setContextLabelFromAPI(e.detail || void 0);
+    window.addEventListener("crow:setContextLabel", handler);
+    return () => window.removeEventListener("crow:setContextLabel", handler);
+  }, []);
+  const contextLabel = contextLabelProp ?? contextLabelFromAPI;
   const agentName = agentNameProp ?? agentNameFromAPI;
   const welcomeMessage = greetingOverride ?? welcomeMessageProp ?? welcomeMessageFromAPI;
   const selectedModel = selectedModelFromAPI;
@@ -4648,7 +4713,8 @@ function CrowWidget({
         onDragPointerDown: variant === "floating" ? transform.onDragPointerDown : void 0,
         isDragging: transform.isDragging,
         hasCustomTransform: transform.hasCustomTransform,
-        onResetTransform: transform.resetTransform
+        onResetTransform: transform.resetTransform,
+        contextLabel
       }
     ),
     /* @__PURE__ */ jsx(AnimatePresence, { children: showConversationList && isVerifiedUser && /* @__PURE__ */ jsx(
@@ -5040,7 +5106,8 @@ function CrowCopilot({
   toolRenderers,
   getIdentityToken,
   context,
-  language
+  language,
+  contextLabel: contextLabelProp
 }) {
   const effectiveGetIdentityToken = getIdentityToken || window.__crow_identity_token_fetcher;
   const effectiveOnToolResult = onToolResult || window.__crow_on_tool_result;
@@ -5081,6 +5148,15 @@ function CrowCopilot({
     return () => window.removeEventListener("crow:setGreeting", handler);
   }, []);
   const welcomeMessage = greetingOverride ?? welcomeMessageProp ?? welcomeMessageFromAPI;
+  const [contextLabelFromAPI, setContextLabelFromAPI] = useState(
+    () => window.__crow_context_label
+  );
+  useEffect(() => {
+    const handler = (e) => setContextLabelFromAPI(e.detail || void 0);
+    window.addEventListener("crow:setContextLabel", handler);
+    return () => window.removeEventListener("crow:setContextLabel", handler);
+  }, []);
+  const contextLabel = contextLabelProp ?? contextLabelFromAPI;
   const [autoTools, setAutoTools] = useState({});
   const browserUseLoaded = autoTools.browser_use;
   useEffect(() => {
@@ -5895,6 +5971,38 @@ function CrowCopilot({
                 ]
               }
             ),
+            contextLabel && /* @__PURE__ */ jsxs(
+              "div",
+              {
+                className: "crow-flex crow-items-center crow-gap-1.5 crow-px-3 crow-py-1.5 crow-border-b crow-text-xs",
+                style: {
+                  color: "#6b7280",
+                  borderColor: styles.colors.border
+                },
+                children: [
+                  /* @__PURE__ */ jsxs(
+                    "svg",
+                    {
+                      xmlns: "http://www.w3.org/2000/svg",
+                      width: "12",
+                      height: "12",
+                      viewBox: "0 0 24 24",
+                      fill: "none",
+                      stroke: "currentColor",
+                      strokeWidth: "2",
+                      strokeLinecap: "round",
+                      strokeLinejoin: "round",
+                      className: "crow-shrink-0",
+                      children: [
+                        /* @__PURE__ */ jsx("path", { d: "M20 10c0 6-8 12-8 12s-8-6-8-12a8 8 0 0 1 16 0Z" }),
+                        /* @__PURE__ */ jsx("circle", { cx: "12", cy: "10", r: "3" })
+                      ]
+                    }
+                  ),
+                  /* @__PURE__ */ jsx("span", { className: "crow-truncate", children: contextLabel })
+                ]
+              }
+            ),
             /* @__PURE__ */ jsxs(AnimatePresence, { children: [
               showConversationList && isVerifiedUser && /* @__PURE__ */ jsx(
                 ConversationList,