@factorialco/f0-react 7.35.1 → 7.37.0

package/dist/{SheetViewer-Bj_g_o7k.js → SheetViewer-Br7dSUQX.js}

@@ -1,8 +1,8 @@
 import { jsxs as a, jsx as r, Fragment as N } from "react/jsx-runtime";
 import { useState as i, useEffect as k } from "react";
-import { u as v, T as S, h as V, S as R } from "./F0CanvasPanel-B8GTWbHT.js";
+import { u as v, T as S, h as V, S as R } from "./F0CanvasPanel-BlJYT_pW.js";
 import { f as z, c as E } from "./sheetPreview-Djc-YyVs.js";
-import { u as _, D as j } from "./DocumentToolbar-DRVoTpae.js";
+import { u as _, D as j } from "./DocumentToolbar-BvjptWbC.js";
 const g = 1e3, F = 100, G = ({
   url: n,
   filename: y,

package/dist/{TextViewer-u0RHT2X8.js → TextViewer-J8flQHdz.js}

@@ -1,7 +1,7 @@
 import { jsxs as b, jsx as e } from "react/jsx-runtime";
 import { useState as _, useEffect as h } from "react";
-import { u as x, S as p, p as w } from "./F0CanvasPanel-B8GTWbHT.js";
-import { u as y, D as g } from "./DocumentToolbar-DRVoTpae.js";
+import { u as x, S as p, p as w } from "./F0CanvasPanel-BlJYT_pW.js";
+import { u as y, D as g } from "./DocumentToolbar-BvjptWbC.js";
 const k = 2 * 1024 * 1024, v = [
   "[&_h1]:mb-3 [&_h1]:mt-6 [&_h1]:text-2xl [&_h1]:font-semibold",
   "[&_h2]:mb-2 [&_h2]:mt-5 [&_h2]:text-xl [&_h2]:font-semibold",

package/dist/ai.d.ts

@@ -212,6 +212,73 @@ declare const actionVariants: readonly ["default", "outline", "critical", "neutr
 
 export declare type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
 
+/**
+ * An entry in the composer's attachment menu — see `composerActions` on
+ * `F0AiChatTextArea`. Attaching a file is NOT one of these: the composer
+ * contributes that entry itself from `fileAttachments`, so a host adding
+ * "Connectors" doesn't have to rewire the file picker to keep it.
+ */
+export declare type AiChatComposerAction = AiChatComposerActionItem | AiChatComposerActionSubmenu | AiChatComposerActionToggle | AiChatComposerActionSeparator;
+
+/** What every composer-menu entry shows, whatever choosing it does. */
+declare type AiChatComposerActionBase = {
+    /**
+     * Host-side bookkeeping — a key for the host's own list, and what it reads
+     * back in analytics. The composer neither renders it nor keys the menu by it.
+     */
+    id: string;
+    label: string;
+    icon?: IconType;
+    /** A partner's logo, where an f0 icon would be wrong — a connector's mark. */
+    avatar?: AvatarVariant;
+    /** Short trailing tag beside the label, e.g. "New". Not a sentence. */
+    tag?: string;
+    /** Secondary line under the label. */
+    description?: string;
+    disabled?: boolean;
+    /**
+     * Shown on hover while `disabled` — say why the action is unavailable.
+     * HOVER-ONLY: a disabled menu entry is not focusable, so this text never
+     * reaches the keyboard or a screen reader. Never put anything here that the
+     * label alone doesn't already imply.
+     */
+    disabledTooltip?: string;
+};
+
+/** An entry that DOES something and closes the menu. */
+export declare type AiChatComposerActionItem = AiChatComposerActionBase & {
+    type?: "action";
+    onClick: () => void;
+};
+
+/** A rule between groups of entries. Carries no label and nothing to press. */
+export declare type AiChatComposerActionSeparator = {
+    type: "separator";
+};
+
+/**
+ * An entry that opens a menu of its own beside this one. Use it to keep a long
+ * or stateful list one step in — the connectors this chat can reach — instead
+ * of unrolling it where the file picker lives.
+ */
+export declare type AiChatComposerActionSubmenu = AiChatComposerActionBase & {
+    type: "submenu";
+    actions: AiChatComposerAction[];
+    /** Shown inside the submenu while `actions` is empty, so it never opens bare. */
+    emptyLabel?: string;
+};
+
+/**
+ * An entry you flip rather than press: it carries a switch and the menu STAYS
+ * OPEN, so several can be set in one visit. The host owns `checked` — the
+ * composer renders what it is told and reports back through `onCheckedChange`.
+ */
+export declare type AiChatComposerActionToggle = AiChatComposerActionBase & {
+    type: "toggle";
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+};
+
 /**
  * Credits configuration for the AI chat.
  * Groups all credits-related props into a single object.
@@ -952,6 +1019,8 @@ export declare const aiTranslations: {
             readonly dismiss: "Dismiss";
         };
         readonly attachFile: "Attach file";
+        readonly addToConversation: "Add to this conversation";
+        readonly addFilesOrPhotos: "Add files or photos";
         readonly recordAudio: "Record audio";
         readonly listening: "Listening…";
         readonly stopRecording: "Stop and transcribe";
@@ -3071,6 +3140,8 @@ export declare const defaultTranslations: {
             readonly dismiss: "Dismiss";
         };
         readonly attachFile: "Attach file";
+        readonly addToConversation: "Add to this conversation";
+        readonly addFilesOrPhotos: "Add files or photos";
         readonly recordAudio: "Record audio";
         readonly listening: "Listening…";
         readonly stopRecording: "Stop and transcribe";
@@ -3853,20 +3924,16 @@ declare type DetailsItemContent = (ComponentProps<typeof DataList.Item> & {
  */
 declare type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
 
-declare type DropdownItem = DropdownItemObject | DropdownItemSeparator | DropdownItemLabel;
+declare type DropdownItem = DropdownItemObject | DropdownItemSeparator | DropdownItemLabel | DropdownItemSubmenu | DropdownItemSwitch;
 
 declare type DropdownItemLabel = {
     type: "label";
     text: string;
 };
 
-declare type DropdownItemObject = Pick<NavigationItem, "label" | "href"> & {
+declare type DropdownItemObject = Pick<NavigationItem, "label" | "href"> & Omit<DropdownItemVisuals, "label"> & {
     type?: "item";
     onClick?: () => void;
-    icon?: IconType;
-    description?: string;
-    critical?: boolean;
-    avatar?: AvatarVariant;
     disabled?: boolean;
     /**
      * Tooltip shown on hover while the item is `disabled` — use it to explain why
@@ -3881,6 +3948,48 @@ declare type DropdownItemSeparator = {
     type: "separator";
 };
 
+/**
+ * A row that opens a menu of its own beside this one, rather than doing
+ * something. Use it to keep a long list one step in — the connectors a chat can
+ * reach, say — instead of unrolling it into the parent menu.
+ */
+declare type DropdownItemSubmenu = DropdownItemVisuals & {
+    type: "submenu";
+    items: DropdownItem[];
+    disabled?: boolean;
+    /**
+     * Shown INSIDE the submenu when `items` is empty, so choosing it never opens
+     * an empty panel. Without it an empty submenu renders nothing.
+     */
+    emptyLabel?: string;
+};
+
+/**
+ * A row you flip rather than press: it carries a switch, and choosing it keeps
+ * the menu open so several can be set in a row. The item itself is what the
+ * keyboard and the accessibility tree see (`aria-checked`); the switch is drawn
+ * for the eye only.
+ */
+declare type DropdownItemSwitch = DropdownItemVisuals & {
+    type: "switch";
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+    disabled?: boolean;
+    /** Tooltip shown on hover while `disabled`, as on `DropdownItemObject`. */
+    disabledTooltip?: string;
+};
+
+/** What any row shows, whatever it does when you choose it. */
+declare type DropdownItemVisuals = {
+    label: string;
+    icon?: IconType;
+    description?: string;
+    avatar?: AvatarVariant;
+    /** Short trailing tag beside the label, e.g. "New". Not a sentence. */
+    tag?: string;
+    critical?: boolean;
+};
+
 export declare const DropOverlay: ({ visible, onFilesDropped, mode, }: DropOverlayProps) => JSX_2.Element;
 
 declare interface DropOverlayProps {
@@ -4157,7 +4266,7 @@ export declare const F0AiChatProvider: ({ enabled, side, panelContentSide, initi
  * coupling to `useAiChat()` or CopilotKit — wrappers like F0AiChat
  * provide the wiring.
  */
-export declare const F0AiChatTextArea: ({ onSubmit, onStop, inProgress, onBeforeSubmit, placeholders, creditWarning, clarifyingUI, pendingContext, onPendingContextChange, pendingQuote, onPendingQuoteChange, fileAttachments, toolbarStart, onTranscribe, searchPersons, mentionSources, onProcessFilesRef, disclaimer, usageLimits, footer, isWelcomeScreen, fullscreen, welcomeScreenSuggestions, onSuggestionClick, welcomeScreenSuggestionsPlacement, welcomeScreenSuggestionsCollapsedByDefault, welcomeScreenCards, padding, ref, }: F0AiChatTextAreaProps) => JSX_2.Element;
+export declare const F0AiChatTextArea: ({ onSubmit, onStop, inProgress, onBeforeSubmit, placeholders, creditWarning, clarifyingUI, pendingContext, onPendingContextChange, pendingQuote, onPendingQuoteChange, fileAttachments, toolbarStart, composerActions, onComposerActionsOpenChange, onTranscribe, searchPersons, mentionSources, onProcessFilesRef, disclaimer, usageLimits, footer, isWelcomeScreen, fullscreen, welcomeScreenSuggestions, onSuggestionClick, welcomeScreenSuggestionsPlacement, welcomeScreenSuggestionsCollapsedByDefault, welcomeScreenCards, padding, ref, }: F0AiChatTextAreaProps) => JSX_2.Element;
 
 export declare type F0AiChatTextAreaProps = {
     ref: RefObject<HTMLDivElement>;
@@ -4195,6 +4304,39 @@ export declare type F0AiChatTextAreaProps = {
     onPendingQuoteChange?: (quote: PendingQuote | null) => void;
     /** File attachment configuration. When omitted, attachments are disabled. */
     fileAttachments?: AiChatFileAttachmentConfig;
+    /**
+     * Extra actions offered where the attachment control sits.
+     *
+     * Omitted or empty — the default — leaves the paperclip exactly as it is: one
+     * button that opens the file picker. With at least one action the paperclip
+     * becomes a `+` that opens a menu, and attaching a file becomes the FIRST
+     * entry in it rather than disappearing. The composer contributes that entry
+     * from `fileAttachments`, so a host adding "Connectors" doesn't have to
+     * rewire the file picker to keep it.
+     *
+     * Without `fileAttachments` the menu holds only these actions and no file
+     * entry, which is how a host offers "add context" on a composer that takes
+     * no uploads.
+     *
+     * Reaching `maxFiles` disables the file entry alone — the host's actions have
+     * nothing to do with the file count and stay live. Transcribing disables the
+     * whole trigger, as it does the paperclip today.
+     */
+    composerActions?: AiChatComposerAction[];
+    /**
+     * Told when the `+` menu opens and when it closes.
+     *
+     * There for hosts whose entries cost something to produce: a list that has to
+     * be fetched can stay unfetched until the menu is actually opened, instead of
+     * loading on every composer that might never be opened at all. Fires only
+     * where there IS a menu — with no `composerActions` the control is the plain
+     * paperclip and there is nothing to open.
+     *
+     * It reports the ROOT menu, not a submenu: on a phone a submenu flattens into
+     * the same sheet, so there is no second moment to report and a host that
+     * loaded on this one has its entries ready either way.
+     */
+    onComposerActionsOpenChange?: (open: boolean) => void;
     /**
      * Host-owned compact controls rendered after the attachment action in the
      * normal action row. Controls render inside the chat form, so buttons must

package/dist/ai.js

@@ -1,6 +1,6 @@
-import { C as e, D as r, c as t, F as i, a as o, f as n, g as F, d as C, e as l, I as A, P as d, b as u, u as m } from "./F0CanvasPanel-B8GTWbHT.js";
+import { C as e, D as r, c as t, F as i, a as o, f as n, g as F, d as C, e as l, I as A, P as d, b as u, u as m } from "./F0CanvasPanel-BlJYT_pW.js";
 import { defaultTranslations as c } from "./i18n-provider-defaults.js";
-import { A as g, C as p, t as v, s as I, v as T, y as S, B as f, l as y, i as x, q as b, E as k, G as B, p as H, r as L, j as M, e as O, g as V, k as w, F as D, T as z, w as E, h as G, a as j, n as q, z as R, m as U, o as J, D as K, b as N, f as Q, x as W, c as X, d as Y, u as Z } from "./F0AiProcessingOverlay-BsKOOcJf.js";
+import { A as g, C as p, t as v, s as I, v as T, y as S, B as f, l as y, i as x, q as b, E as k, G as B, p as H, r as L, j as M, e as O, g as V, k as w, F as D, T as z, w as E, h as G, a as j, n as q, z as R, m as U, o as J, D as K, b as N, f as Q, x as W, c as X, d as Y, u as Z } from "./F0AiProcessingOverlay-rN9DzM28.js";
 export {
   g as AiChatTranslationsProvider,
   e as ChatSpinner,