@frankieai/react 0.2.18 → 0.2.20

package/dist/index.d.cts

@@ -92,9 +92,18 @@ declare class FrankieClient {
     getConfig(signal?: AbortSignal): Promise<PublicWidgetConfig>;
     ensureSession(context?: PageContext): Promise<CreateSessionResponse>;
     listConversations(): Promise<ChatConversation[]>;
+    /** Whether a conversation can be reloaded from the server (a signed-in user and a conversation id). */
+    get canResume(): boolean;
+    /**
+     * Ask the server to stop the running turn. Closing the stream no longer
+     * stops it (a closed tab shouldn't lose the reply), so Stop says so
+     * explicitly. Best effort: the stream is closed right after either way.
+     */
+    stopTurn(): Promise<void>;
     resumeConversation(id?: string | undefined): Promise<{
         messages: unknown[];
         title: string;
+        busy: boolean;
     } | undefined>;
     syncConversation(messages: unknown[], title?: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
@@ -256,6 +265,23 @@ interface FrankieWidgetProps extends ChatPanelProps {
         toggle: () => void;
         label: string;
     }) => React.ReactNode;
+    /**
+     * `false` hides the floating button, for apps with their own entry point:
+     * give any element `data-frankie-open` (a nav tab, a "Help" link) and a
+     * click on it opens the chat. Defaults to `true`.
+     */
+    launcher?: boolean;
+    /**
+     * Sit above fixed bars along the bottom of the page (a mobile tab bar, a
+     * cookie banner) instead of underneath them. Defaults to `true`.
+     */
+    avoidBottomBars?: boolean;
+    /**
+     * Close the open panel when the user clicks or taps anywhere outside the
+     * widget, like a popover. Defaults to `true`. Clicks on elements marked
+     * `data-frankie-open` (or `data-frankie-keep-open`) never close it.
+     */
+    closeOnOutsideClick?: boolean;
 }
 /**
  * The drop-in embed: a floating launcher plus the chat panel.
@@ -263,7 +289,7 @@ interface FrankieWidgetProps extends ChatPanelProps {
  * Renders `position: fixed` at the document level, so it does not care what
  * layout the host page uses.
  */
-declare function FrankieWidget({ position, offset, defaultOpen, zIndex, open: controlledOpen, onOpenChange, renderLauncher, ...panelProps }: FrankieWidgetProps): react.JSX.Element;
+declare function FrankieWidget({ position, offset, defaultOpen, zIndex, open: controlledOpen, onOpenChange, renderLauncher, launcher, avoidBottomBars, closeOnOutsideClick, ...panelProps }: FrankieWidgetProps): react.JSX.Element;
 
 interface FrankieInlineProps extends ChatPanelProps {
     /** Extra styles on the filling wrapper — e.g. a `maxWidth` to centre the column. */
@@ -287,9 +313,15 @@ interface FrankieChatPageProps extends Omit<FrankieProviderProps, "children">, P
     showHistory?: boolean;
     /** Optional host navigation, e.g. a Back to dashboard link. */
     navigation?: React.ReactNode;
+    /**
+     * Grow to fill the screen from where the chat starts down to the bottom
+     * edge, or to the top of a fixed bottom bar. Defaults to true; set false
+     * when a sized parent should decide the height.
+     */
+    fillViewport?: boolean;
 }
 /** Reusable product chat with one shared conversation state and scoped styling. */
-declare function FrankieChatPage({ className, style, header, footer, emptyState, renderMessage, renderTool, placeholder, autoFocus, showHistory, navigation, ...provider }: FrankieChatPageProps): react.JSX.Element;
+declare function FrankieChatPage({ className, style, header, footer, emptyState, renderMessage, renderTool, placeholder, autoFocus, showHistory, navigation, fillViewport, ...provider }: FrankieChatPageProps): react.JSX.Element;
 
 interface ComposerAttachmentsConfig {
     enabled: boolean;
@@ -347,7 +379,9 @@ declare function TypingDots(): react.JSX.Element;
  * the first words, or during the pause after a tool result while the model
  * composes its answer — so those gaps read as "loading" rather than frozen.
  */
-declare function Thinking(): react.JSX.Element;
+declare function Thinking({ delayed }: {
+    delayed?: boolean;
+}): react.JSX.Element;
 
 /**
  * A deliberately small Markdown subset — headings, paragraphs, lists, fenced

package/dist/index.d.ts

@@ -92,9 +92,18 @@ declare class FrankieClient {
     getConfig(signal?: AbortSignal): Promise<PublicWidgetConfig>;
     ensureSession(context?: PageContext): Promise<CreateSessionResponse>;
     listConversations(): Promise<ChatConversation[]>;
+    /** Whether a conversation can be reloaded from the server (a signed-in user and a conversation id). */
+    get canResume(): boolean;
+    /**
+     * Ask the server to stop the running turn. Closing the stream no longer
+     * stops it (a closed tab shouldn't lose the reply), so Stop says so
+     * explicitly. Best effort: the stream is closed right after either way.
+     */
+    stopTurn(): Promise<void>;
     resumeConversation(id?: string | undefined): Promise<{
         messages: unknown[];
         title: string;
+        busy: boolean;
     } | undefined>;
     syncConversation(messages: unknown[], title?: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
@@ -256,6 +265,23 @@ interface FrankieWidgetProps extends ChatPanelProps {
         toggle: () => void;
         label: string;
     }) => React.ReactNode;
+    /**
+     * `false` hides the floating button, for apps with their own entry point:
+     * give any element `data-frankie-open` (a nav tab, a "Help" link) and a
+     * click on it opens the chat. Defaults to `true`.
+     */
+    launcher?: boolean;
+    /**
+     * Sit above fixed bars along the bottom of the page (a mobile tab bar, a
+     * cookie banner) instead of underneath them. Defaults to `true`.
+     */
+    avoidBottomBars?: boolean;
+    /**
+     * Close the open panel when the user clicks or taps anywhere outside the
+     * widget, like a popover. Defaults to `true`. Clicks on elements marked
+     * `data-frankie-open` (or `data-frankie-keep-open`) never close it.
+     */
+    closeOnOutsideClick?: boolean;
 }
 /**
  * The drop-in embed: a floating launcher plus the chat panel.
@@ -263,7 +289,7 @@ interface FrankieWidgetProps extends ChatPanelProps {
  * Renders `position: fixed` at the document level, so it does not care what
  * layout the host page uses.
  */
-declare function FrankieWidget({ position, offset, defaultOpen, zIndex, open: controlledOpen, onOpenChange, renderLauncher, ...panelProps }: FrankieWidgetProps): react.JSX.Element;
+declare function FrankieWidget({ position, offset, defaultOpen, zIndex, open: controlledOpen, onOpenChange, renderLauncher, launcher, avoidBottomBars, closeOnOutsideClick, ...panelProps }: FrankieWidgetProps): react.JSX.Element;
 
 interface FrankieInlineProps extends ChatPanelProps {
     /** Extra styles on the filling wrapper — e.g. a `maxWidth` to centre the column. */
@@ -287,9 +313,15 @@ interface FrankieChatPageProps extends Omit<FrankieProviderProps, "children">, P
     showHistory?: boolean;
     /** Optional host navigation, e.g. a Back to dashboard link. */
     navigation?: React.ReactNode;
+    /**
+     * Grow to fill the screen from where the chat starts down to the bottom
+     * edge, or to the top of a fixed bottom bar. Defaults to true; set false
+     * when a sized parent should decide the height.
+     */
+    fillViewport?: boolean;
 }
 /** Reusable product chat with one shared conversation state and scoped styling. */
-declare function FrankieChatPage({ className, style, header, footer, emptyState, renderMessage, renderTool, placeholder, autoFocus, showHistory, navigation, ...provider }: FrankieChatPageProps): react.JSX.Element;
+declare function FrankieChatPage({ className, style, header, footer, emptyState, renderMessage, renderTool, placeholder, autoFocus, showHistory, navigation, fillViewport, ...provider }: FrankieChatPageProps): react.JSX.Element;
 
 interface ComposerAttachmentsConfig {
     enabled: boolean;
@@ -347,7 +379,9 @@ declare function TypingDots(): react.JSX.Element;
  * the first words, or during the pause after a tool result while the model
  * composes its answer — so those gaps read as "loading" rather than frozen.
  */
-declare function Thinking(): react.JSX.Element;
+declare function Thinking({ delayed }: {
+    delayed?: boolean;
+}): react.JSX.Element;
 
 /**
  * A deliberately small Markdown subset — headings, paragraphs, lists, fenced