@getsoren/design-system 4.68.2 → 4.68.4

package/dist/src/components/DataDisplay/AiAssistant/AiAssistant.d.ts

@@ -9,6 +9,7 @@ declare const AiAssistant: {
     EmptyState: ({ message, children }: import('./types').AiAssistantEmptyStateProps) => import("@emotion/react/jsx-runtime").JSX.Element;
     Fab: ({ open, onClick, tooltip, dataTestId }: import('./types').AiAssistantFabProps) => import("@emotion/react/jsx-runtime").JSX.Element;
     Header: ({ title, subtitle, onClose, icon }: import('./types').AiAssistantHeaderProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+    Nudge: ({ open, title, onClose, children, dataTestId }: import('./types').AiAssistantNudgeProps) => import("@emotion/react/jsx-runtime").JSX.Element;
     Panel: ({ open, isBusy, children, dataTestId }: import('./types').AiAssistantPanelProps) => import("@emotion/react/jsx-runtime").JSX.Element;
     ThinkingOrb: ({ size }: import('./types').AiAssistantThinkingOrbProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 };

package/dist/src/components/DataDisplay/AiAssistant/components/AiAssistantNudge.d.ts

@@ -0,0 +1,9 @@
+import { AiAssistantNudgeProps } from '../types';
+/**
+ * Contextual nudge anchored where the assistant lives — a compact bubble growing out of
+ * the Fab, same spot and motion as the Panel but free-height and one-click dismissable.
+ * No backdrop, no focus trap: the ongoing interaction is never blocked. Host apps use it
+ * for proactive one-shot messages (onboarding hints…) without opening the full panel.
+ */
+declare const AiAssistantNudge: ({ open, title, onClose, children, dataTestId }: AiAssistantNudgeProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default AiAssistantNudge;

package/dist/src/components/DataDisplay/AiAssistant/types.d.ts

@@ -2,22 +2,41 @@ import { ReactNode } from 'react';
 export interface AiAssistantFabProps {
     /** Panel visibility — the FAB shows a close glyph and calms down when open */
     open: boolean;
+    /** Toggles the panel — the FAB never owns the open state, the host app does */
     onClick: () => void;
     /** Tooltip content (e.g. the assistant's name) */
     tooltip?: string;
+    /** Test hook on the FAB button (defaults to "assistantFab") */
+    dataTestId?: string;
+}
+export interface AiAssistantNudgeProps {
+    /** Bubble visibility — animated in/out of the Fab corner, unmounted when closed */
+    open: boolean;
+    /** Short headline of the nudge (host-app wording, already translated) */
+    title: string;
+    /** One-click dismiss — the host app decides what "seen" means */
+    onClose: () => void;
+    /** Body of the bubble — plain text or a few short paragraphs (\n\n separated) */
+    children: ReactNode;
+    /** Test hook on the bubble ("assistantNudge"); the close button appends "Close" */
     dataTestId?: string;
 }
 export interface AiAssistantPanelProps {
+    /** Panel visibility — grows out of the Fab when opening, unmounted when closed */
     open: boolean;
     /** The assistant is working (streaming/tools): the panel breathes an iridescent aura */
     isBusy?: boolean;
+    /** Panel content — typically Header + a Chat.* composition owned by the host app */
     children: ReactNode;
+    /** Test hook on the panel container (defaults to "assistantPanel") */
     dataTestId?: string;
 }
 export interface AiAssistantHeaderProps {
     /** Product name of the assistant — a brand chosen by the host app */
     title: string;
+    /** Secondary caption next to the title (e.g. "Assistant IA") */
     subtitle?: string;
+    /** Close action of the panel — rendered as the trailing icon button */
     onClose: () => void;
     /** Defaults to the gradient AI spark */
     icon?: ReactNode;
@@ -39,13 +58,18 @@ export interface AiAssistantConfirmationCardProps {
     summary: string;
     /** Raw params fallback, rendered monospace when provided */
     details?: string;
+    /** Lifecycle of the confirmation — "pending" shows both buttons, the others freeze the outcome */
     status: "approved" | "declined" | "pending";
+    /** Called when the user approves the action */
     onAccept: () => void;
+    /** Called when the user declines the action */
     onDecline: () => void;
+    /** Button wording (host-app i18n) */
     labels: {
         accept: string;
         decline: string;
     };
+    /** Test hook on the card (defaults to "assistantConfirmationCard") */
     dataTestId?: string;
 }
 export interface AiSparkIconProps {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@getsoren/design-system",
   "description": "Design System React library",
   "sideEffects": false,
-  "version": "4.68.2",
+  "version": "4.68.4",
   "license": "ISC",
   "type": "module",
   "types": "./dist/src/main.d.ts",