@factorialco/f0-react 2.20.0 → 2.21.0

package/dist/f0.d.ts

@@ -33,6 +33,7 @@ import { Context } from 'react';
 import { CopilotKitProps } from '@copilotkit/react-core';
 import { CountCellValue } from './types/count';
 import { CountryCellValue } from './types/country';
+import { CSSProperties } from 'react';
 import { DashboardProps as DashboardProps_2 } from './Dashboard';
 import { DateCellValue } from './f0';
 import { DateCellValue as DateCellValue_2 } from './types/date';
@@ -306,7 +307,7 @@ declare type ActionDefinition = DropdownItemSeparator | (Pick<DropdownItemObject
 
 export declare type ActionItemStatus = (typeof actionItemStatuses)[number];
 
-export declare const actionItemStatuses: readonly ["inProgress", "executing", "completed"];
+export declare const actionItemStatuses: readonly ["inProgress", "executing", "writing", "completed"];
 
 declare type ActionLinkProps = ActionBaseProps & {
     href: string;
@@ -510,7 +511,6 @@ export declare type AiChatMode = "chat" | "voice";
  */
 export declare type AiChatProviderProps = {
     enabled?: boolean;
-    greeting?: string;
     initialMessage?: string | string[];
     welcomeScreenSuggestions?: WelcomeScreenSuggestion[];
     disclaimer?: AiChatDisclaimer;
@@ -766,7 +766,7 @@ declare type AiChatProviderReturnValue = {
     pendingQuote: PendingQuote | null;
     /** Set the pending quote (pass null to clear). */
     setPendingQuote: React.Dispatch<React.SetStateAction<PendingQuote | null>>;
-} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityRefs" | "canvasActions" | "canvasEntities" | "credits" | "employeeCredits" | "creditWarning" | "fileAttachments"> & {
+} & Pick<AiChatState, "agent" | "disclaimer" | "resizable" | "entityRefs" | "canvasActions" | "canvasEntities" | "credits" | "employeeCredits" | "creditWarning" | "fileAttachments"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
     /** Open the canvas panel with the given content */
@@ -785,7 +785,6 @@ declare type AiChatProviderReturnValue = {
  * Internal state for the AiChat provider
  */
 declare interface AiChatState {
-    greeting?: string;
     enabled: boolean;
     agent?: string;
     initialMessage?: string | string[];
@@ -828,7 +827,7 @@ declare interface AiChatState {
 declare type AiChatTrackingOptions = {
     onVisibility?: () => void;
     onClose?: () => void;
-    onWelcomeSuggestionClick?: (item: WelcomeScreenSuggestionItem) => void;
+    onWelcomeSuggestionClick?: (event: WelcomeSuggestionClickEvent) => void;
     onNewChat?: () => void;
     onMessage?: (message: Message_2) => void;
 };
@@ -896,7 +895,7 @@ export declare const aiTranslations: {
         readonly stopAnswerGeneration: "Stop generating";
         readonly responseStopped: "You stopped this response";
         readonly sendMessage: "Send message";
-        readonly thoughtsGroupTitle: "Reflection";
+        readonly thoughtsGroupTitle: "Reasoning";
         readonly resourcesGroupTitle: "Resources";
         readonly thinking: "Thinking...";
         readonly feedbackModal: {
@@ -2638,7 +2637,19 @@ export declare interface ChatDashboardRadarChartConfig extends ChatDashboardChar
     showArea?: boolean;
 }
 
-export declare const ChatSpinner: ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & RefAttributes<SVGSVGElement>>;
+export declare const ChatSpinner: ForwardRefExoticComponent<ChatSpinnerProps & RefAttributes<HTMLDivElement>>;
+
+declare interface ChatSpinnerProps {
+    size?: number;
+    className?: string;
+    style?: CSSProperties;
+    /**
+     * "default" → spins 2 rotations, pauses, repeats.
+     * "continuous" → 2 rotations forward, then 2 backward, no pause. Used for
+     * "writing"-style activity where the indicator should never rest.
+     */
+    variant?: "default" | "continuous";
+}
 
 export declare type ChatThread = {
     id: string;
@@ -4345,7 +4356,7 @@ export declare const defaultTranslations: {
         readonly stopAnswerGeneration: "Stop generating";
         readonly responseStopped: "You stopped this response";
         readonly sendMessage: "Send message";
-        readonly thoughtsGroupTitle: "Reflection";
+        readonly thoughtsGroupTitle: "Reasoning";
         readonly resourcesGroupTitle: "Resources";
         readonly thinking: "Thinking...";
         readonly feedbackModal: {
@@ -5296,7 +5307,7 @@ export declare interface F0ActionItemProps {
     /**
      * Current status of the action item
      */
-    status?: "inProgress" | "executing" | "completed";
+    status?: "inProgress" | "executing" | "writing" | "completed";
     /**
      * Whether the action item is part of a group
      */
@@ -5436,7 +5447,7 @@ export declare type F0AiChatHistoryProps = {
 /**
  * @experimental This is an experimental component use it at your own risk
  */
-export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityRefs, canvasActions, canvasEntities, credits, employeeCredits, creditWarning, fileAttachments, onThumbsUp, onThumbsDown, onBeforeSendMessage, runtimeFetch, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
+export declare const F0AiChatProvider: ({ enabled, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityRefs, canvasActions, canvasEntities, credits, employeeCredits, creditWarning, fileAttachments, onThumbsUp, onThumbsDown, onBeforeSendMessage, runtimeFetch, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
 
 /**
  * Headless chat composer.
@@ -5512,8 +5523,9 @@ export declare type F0AiChatTextAreaProps = {
      * Hovering an item previews its prompt in the textarea placeholder.
      */
     welcomeScreenSuggestions?: WelcomeScreenSuggestion[];
-    /** Called when the user clicks a sub-suggestion. */
-    onSuggestionClick?: (item: WelcomeScreenSuggestionItem) => void;
+    /** Called when the user clicks a sub-suggestion. Receives the picked
+     *  `item` and its parent `group` (the outline-button entry). */
+    onSuggestionClick?: (item: WelcomeScreenSuggestionItem, group: WelcomeScreenSuggestion) => void;
     /**
      * When true, the composer adopts the fullscreen layout: the welcome
      * footer is pushed to the bottom and the disclaimer is hidden so the
@@ -5730,12 +5742,12 @@ export declare type F0AiMessagesContainerProps = {
     isLoadingThread?: boolean;
     /** Optional React node rendered inline at the end of the list (e.g. CopilotKit interrupt). */
     interrupt?: ReactNode;
-    /** Greeting shown above the initial message in the welcome screen. */
-    greeting?: string;
-    /** Initial message(s) shown in the welcome screen, or a default if omitted. */
+    /** Welcome phrase shown centered when the chat is empty. Falls back to
+     *  `translations.ai.defaultInitialMessage` if omitted. */
     initialMessage?: string | string[];
-    /** Optional click on the One icon (factorial uses it for the pong easter egg). */
-    onWelcomeIconClick?: () => void;
+    /** Called when the user clicks the welcome phrase (used by F0AiChat to open
+     *  the pong easter egg). When omitted the phrase is non-interactive. */
+    onWelcomeClick?: () => void;
     /** Returns a React node for an assistant message's tool call, or null. */
     renderToolCall?: F0AssistantMessageExtraProps["renderToolCall"];
     /** Called when the user selects text and clicks Reply (user or assistant bubble). */
@@ -7790,10 +7802,14 @@ export declare interface F0FormDefinitionPerSection<T extends F0PerSectionSchema
     defaultValues?: {
         [K in keyof T]?: Partial<z.infer<T[K]>>;
     };
+    /** Raw async function for resolving defaultValues — resolved by F0Form at render time */
+    asyncDefaultValues?: (signal: AbortSignal) => Promise<{
+        [K in keyof T]?: Partial<z.infer<T[K]>>;
+    }>;
     onSubmit: (arg: F0WizardFormPerSectionSubmitArg<T>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
     submitConfig?: F0PerSectionSubmitConfig;
     errorTriggerMode?: F0FormErrorTriggerMode;
-    /** Whether async defaultValues are still being resolved */
+    /** Whether async initialFiles are still being resolved */
     isLoading?: boolean;
     /** Zod schema describing params the AI can supply when calling presentForm */
     defaultValuesParamsSchema?: ZodType;
@@ -7819,10 +7835,12 @@ export declare interface F0FormDefinitionSingleSchema<TSchema extends F0FormSche
     schema: TSchema;
     sections?: Record<string, F0SectionConfig>;
     defaultValues?: Partial<z.infer<TSchema>>;
+    /** Raw async function for resolving defaultValues — resolved by F0Form at render time */
+    asyncDefaultValues?: (signal: AbortSignal) => Promise<Partial<z.infer<TSchema>>>;
     onSubmit: (arg: F0WizardFormSingleSubmitArg<TSchema>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
     submitConfig?: F0FormSubmitConfig;
     errorTriggerMode?: F0FormErrorTriggerMode;
-    /** Whether async defaultValues are still being resolved */
+    /** Whether async initialFiles are still being resolved */
     isLoading?: boolean;
     /** Zod schema describing params the AI can supply when calling presentForm */
     defaultValuesParamsSchema?: ZodType;
@@ -14809,6 +14827,18 @@ export declare type WelcomeScreenSuggestionItem = {
     prompt?: string;
 };
 
+/**
+ * Payload for `tracking.onWelcomeSuggestionClick`. Carries everything an
+ * analytics layer (e.g. Amplitude) needs to attribute the click: the picked
+ * sub-item, its parent group, and the resolved prompt that was actually sent.
+ */
+declare type WelcomeSuggestionClickEvent = {
+    item: WelcomeScreenSuggestionItem;
+    group: WelcomeScreenSuggestion;
+    /** Prompt actually sent to the AI — `item.prompt` falling back to `item.title`. */
+    prompt: string;
+};
+
 declare interface WiggleOptions {
     errorHighlight?: boolean;
 }