@factorialco/f0-react 6.94.0 → 6.95.0

package/dist/experimental.d.ts

@@ -5280,6 +5280,13 @@ declare const defaultTranslations: {
             readonly upgradePlan: "Upgrade";
             readonly needMoreCredits: "Need more credits?";
         };
+        readonly usageLimits: {
+            readonly title: "Personal allowance";
+            readonly used: "{{percentage}}% used";
+            readonly yourCompany: "Your company";
+            readonly unlimited: "Unlimited";
+            readonly error: "Could not load usage";
+        };
         readonly reportCard: {
             readonly tableLabel: "Table";
             readonly openButton: "Open";
@@ -16563,10 +16570,9 @@ declare namespace Calendar {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        indent: {
-            setIndent: (level: number) => ReturnType;
-            unsetIndent: () => ReturnType;
-            outdent: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }
@@ -16586,9 +16592,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
         };
     }
 }
@@ -16596,8 +16602,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        moodTracker: {
-            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
+        indent: {
+            setIndent: (level: number) => ReturnType;
+            unsetIndent: () => ReturnType;
+            outdent: () => ReturnType;
         };
     }
 }
@@ -16605,9 +16613,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        fontSize: {
-            setFontSize: (fontSize: string) => ReturnType;
-            unsetFontSize: () => ReturnType;
+        moodTracker: {
+            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
         };
     }
 }
@@ -16615,8 +16622,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        transcript: {
-            insertTranscript: (data: TranscriptData) => ReturnType;
+        videoEmbed: {
+            setVideoEmbed: (options: {
+                src: string;
+            }) => ReturnType;
         };
     }
 }
@@ -16624,10 +16633,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        videoEmbed: {
-            setVideoEmbed: (options: {
-                src: string;
-            }) => ReturnType;
+        transcript: {
+            insertTranscript: (data: TranscriptData) => ReturnType;
         };
     }
 }

package/dist/f0.d.ts

@@ -982,6 +982,8 @@ declare interface AiChatState {
     tracking?: AiChatTrackingOptions;
 }
 
+export declare type AiChatTextAreaUsageLimits = Pick<F0AiChatUsageLimitsButtonProps, "usage" | "error" | "onOpenChange">;
+
 export declare type AiChatTrackingOptions = {
     onVisibility?: () => void;
     onClose?: () => void;
@@ -1009,6 +1011,32 @@ export declare interface AiChatTranslationsProviderProps {
     translations: AiChatTranslations;
 }
 
+/**
+ * Host-resolved numbers for `F0AiChatUsageLimitsButton`. Percentages only: the
+ * product avoids credit counts in the chat.
+ */
+export declare type AiChatUsageLimits = {
+    /** The viewer's own allowance, 0–100. */
+    usedPercentage: number;
+    /** Already localized, e.g. "Resets in 3h 6m". */
+    description?: string;
+    unlimited?: boolean;
+    /** Extra rows below a divider, typically for admins. */
+    sections?: AiChatUsageLimitsSection[];
+    /** Renders the "Your company" row. */
+    onSeeCompany?: () => void;
+};
+
+export declare type AiChatUsageLimitsSection = {
+    id: string;
+    /** Already localized. */
+    label: string;
+    /** Already localized, e.g. "Renews Sep 4". */
+    description?: string;
+    usedPercentage: number;
+    unlimited?: boolean;
+};
+
 export declare type AiInsightCardContent = {
     content: "text";
 } | {
@@ -1112,6 +1140,13 @@ export declare const aiTranslations: {
             readonly upgradePlan: "Upgrade";
             readonly needMoreCredits: "Need more credits?";
         };
+        readonly usageLimits: {
+            readonly title: "Personal allowance";
+            readonly used: "{{percentage}}% used";
+            readonly yourCompany: "Your company";
+            readonly unlimited: "Unlimited";
+            readonly error: "Could not load usage";
+        };
         readonly reportCard: {
             readonly tableLabel: "Table";
             readonly openButton: "Open";
@@ -5463,6 +5498,13 @@ export declare const defaultTranslations: {
             readonly upgradePlan: "Upgrade";
             readonly needMoreCredits: "Need more credits?";
         };
+        readonly usageLimits: {
+            readonly title: "Personal allowance";
+            readonly used: "{{percentage}}% used";
+            readonly yourCompany: "Your company";
+            readonly unlimited: "Unlimited";
+            readonly error: "Could not load usage";
+        };
         readonly reportCard: {
             readonly tableLabel: "Table";
             readonly openButton: "Open";
@@ -7174,7 +7216,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, onProcessFilesRef, disclaimer, 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, onTranscribe, searchPersons, onProcessFilesRef, disclaimer, usageLimits, footer, isWelcomeScreen, fullscreen, welcomeScreenSuggestions, onSuggestionClick, welcomeScreenSuggestionsPlacement, welcomeScreenSuggestionsCollapsedByDefault, welcomeScreenCards, padding, ref, }: F0AiChatTextAreaProps) => JSX_2.Element;
 
 export declare type F0AiChatTextAreaProps = {
     ref: RefObject<HTMLDivElement>;
@@ -7238,6 +7280,8 @@ export declare type F0AiChatTextAreaProps = {
      * the welcome screen of the fullscreen layout to give the footer room.
      */
     disclaimer?: AiChatDisclaimer;
+    /** Usage ring at the right end of the disclaimer row; the text then aligns left. */
+    usageLimits?: AiChatTextAreaUsageLimits;
     /**
      * Optional footer (e.g. powered-by, legal copy) rendered below the
      * textarea on the welcome screen.
@@ -7379,6 +7423,25 @@ export declare type F0AiChatTextAreaSubmitPayload = {
     quote: PendingQuote | null;
 };
 
+/**
+ * Headless usage-limits popover with its ring trigger. `F0AiChatTextArea`
+ * renders it from its `usageLimits` prop.
+ */
+export declare const F0AiChatUsageLimitsButton: ({ usage, error, onOpenChange, trigger, side, }: F0AiChatUsageLimitsButtonProps) => JSX_2.Element;
+
+export declare interface F0AiChatUsageLimitsButtonProps {
+    /** `null` while loading: empty ring, skeleton in the popover. */
+    usage: AiChatUsageLimits | null;
+    /** Shows an error line instead of the rows. */
+    error?: boolean;
+    /** Hosts refetch on open. */
+    onOpenChange?: (open: boolean) => void;
+    /** Custom popover trigger (asChild). Defaults to the usage ring button. */
+    trigger?: ReactNode;
+    /** `"top"` suits the composer row; use `"bottom"` from a header. */
+    side?: UsageLimitsPopoverSide;
+}
+
 /**
  * A card shown below the composer on the fullscreen welcome screen, rendered
  * as an `F0CardHorizontal`. Each card owns its behavior via `onClick`, so
@@ -19455,6 +19518,10 @@ declare interface UpsellRequestResponseDialogProps {
     portalContainer?: HTMLElement | null;
 }
 
+export declare type UsageLimitsPopoverSide = (typeof usageLimitsPopoverSides)[number];
+
+export declare const usageLimitsPopoverSides: readonly ["top", "bottom"];
+
 /**
  * Read the AiChat context. Returns an inert fallback when no provider
  * is mounted — that case is intentional in `ApplicationFrame`, which
@@ -20682,10 +20749,9 @@ declare namespace Calendar {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        indent: {
-            setIndent: (level: number) => ReturnType;
-            unsetIndent: () => ReturnType;
-            outdent: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }
@@ -20705,9 +20771,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
         };
     }
 }
@@ -20715,8 +20781,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        moodTracker: {
-            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
+        indent: {
+            setIndent: (level: number) => ReturnType;
+            unsetIndent: () => ReturnType;
+            outdent: () => ReturnType;
         };
     }
 }
@@ -20724,9 +20792,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        fontSize: {
-            setFontSize: (fontSize: string) => ReturnType;
-            unsetFontSize: () => ReturnType;
+        moodTracker: {
+            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
         };
     }
 }
@@ -20734,8 +20801,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        transcript: {
-            insertTranscript: (data: TranscriptData) => ReturnType;
+        videoEmbed: {
+            setVideoEmbed: (options: {
+                src: string;
+            }) => ReturnType;
         };
     }
 }
@@ -20743,10 +20812,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        videoEmbed: {
-            setVideoEmbed: (options: {
-                src: string;
-            }) => ReturnType;
+        transcript: {
+            insertTranscript: (data: TranscriptData) => ReturnType;
         };
     }
 }

package/dist/f0.js

@@ -11,10 +11,10 @@ import { l as t0, c as aI, d as Gh, r as r0 } from "./F0VideoPlayer-YejLcqsl.js"
 import { F as uge } from "./F0VideoPlayer-YejLcqsl.js";
 import { F as fge, p as dge } from "./index-CBg77yy7.js";
 import { c as vge } from "./pdfWorker-DP34_8_v.js";
-import { D as fG, E as Hh, G as K_, H as oI, I as dG, J as hG, K as vG, L as pG, M as gG, F as mG } from "./F0AiProcessingOverlay-CnPJe6l9.js";
-import { A as gge, C as mge, t as yge, s as bge, v as _ge, y as xge, l as wge, i as Sge, q as Cge, z as Tge, B as Dge, p as Age, r as Mge, j as Lge, e as Ege, g as Nge, k as Ige, T as kge, w as Pge, h as Rge, a as Oge, n as Bge, m as zge, o as Vge, b as Fge, f as Gge, x as Hge, c as Wge, d as $ge, u as Uge } from "./F0AiProcessingOverlay-CnPJe6l9.js";
+import { G as fG, H as Hh, I as K_, J as oI, K as dG, L as hG, M as vG, N as pG, O as gG, F as mG } from "./F0AiProcessingOverlay-D6Y6MLaK.js";
+import { A as gge, C as mge, t as yge, s as bge, v as _ge, y as xge, z as wge, l as Sge, i as Cge, q as Tge, D as Dge, E as Age, p as Mge, r as Lge, j as Ege, e as Nge, g as Ige, k as kge, T as Pge, w as Rge, h as Oge, a as Bge, n as zge, m as Vge, o as Fge, B as Gge, b as Hge, f as Wge, x as $ge, c as Uge, d as Yge, u as Xge } from "./F0AiProcessingOverlay-D6Y6MLaK.js";
 import { utils as Cl, write as sI } from "./xlsx-CzlURDDb.js";
-import { defaultTranslations as Xge } from "./i18n-provider-defaults.js";
+import { defaultTranslations as Zge } from "./i18n-provider-defaults.js";
 import './f0.css';const yG = {
   xs: 1,
   sm: 2,
@@ -67888,20 +67888,21 @@ export {
   _ge as F0AiChatHistory,
   Mhe as F0AiChatProvider,
   xge as F0AiChatTextArea,
+  wge as F0AiChatUsageLimitsButton,
   Lhe as F0AiFormRegistryProvider,
-  wge as F0AiInsightCard,
-  Sge as F0AiMask,
-  Cge as F0AiMessageSources,
-  Tge as F0AiMessagesContainer,
+  Sge as F0AiInsightCard,
+  Cge as F0AiMask,
+  Tge as F0AiMessageSources,
+  Dge as F0AiMessagesContainer,
   Ehe as F0AiPong,
-  Dge as F0AiProcessingOverlay,
-  Age as F0AiProposalCard,
-  Mge as F0AiTableCard,
+  Age as F0AiProcessingOverlay,
+  Mge as F0AiProposalCard,
+  Lge as F0AiTableCard,
   ope as F0Alert,
   ghe as F0AnalyticsDashboard,
   Ode as F0AudioPlayer,
   Bde as F0AudioPlayerCard,
-  Lge as F0AuraVoiceAnimation,
+  Ege as F0AuraVoiceAnimation,
   ZF as F0Avatar,
   LN as F0AvatarAlert,
   Nhe as F0AvatarCompany,
@@ -67919,13 +67920,13 @@ export {
   ot as F0Button,
   Vhe as F0ButtonDropdown,
   Fhe as F0ButtonToggle,
-  Ege as F0CanvasCard,
+  Nge as F0CanvasCard,
   Ghe as F0CanvasPanel,
   Hhe as F0Card,
   Whe as F0CardRow,
   Rc as F0Checkbox,
   Gde as F0ChipList,
-  Nge as F0ClarifyingPanel,
+  Ige as F0ClarifyingPanel,
   Mse as F0DataChart,
   spe as F0DatePicker,
   fhe as F0DemoCard,
@@ -67943,7 +67944,7 @@ export {
   fpe as F0Form,
   yr as F0FormField,
   rhe as F0GridStack,
-  Ige as F0HILActionConfirmation,
+  kge as F0HILActionConfirmation,
   jde as F0Heading,
   at as F0Icon,
   f5 as F0Link,
@@ -68022,8 +68023,8 @@ export {
   the as Tag,
   lve as TagCounter,
   Lpe as Textarea,
-  kge as ThreadItem,
-  Pge as ThreadListSkeleton,
+  Pge as ThreadItem,
+  Rge as ThreadListSkeleton,
   ude as ToastProvider,
   Mde as TwoColumnLayout,
   Epe as UPLOAD_INPUT_ID,
@@ -68035,9 +68036,9 @@ export {
   Npe as VerticalBarChart,
   uve as WeekStartDay,
   Ipe as actionBarStatuses,
-  Rge as actionItemStatuses,
+  Oge as actionItemStatuses,
   cve as adaptDataAdapterToInfiniteScroll,
-  Oge as aiTranslations,
+  Bge as aiTranslations,
   $de as alertVariantOptions,
   Rde as audioPlayerSizes,
   Cde as avatarVariants,
@@ -68059,7 +68060,7 @@ export {
   gve as chipVariants,
   Que as computeSectionEndIds,
   vge as configurePdfWorker,
-  Bge as contentTypes,
+  zge as contentTypes,
   Bpe as createAtlaskitDriver,
   mve as createDataSourceDefinition,
   qde as createF0FormDefinitionTester,
@@ -68068,7 +68069,7 @@ export {
   VG as createPageLayoutBlockGroup,
   Hde as dataCollectionLocalStorageHandler,
   Wde as datepickerSizes,
-  Xge as defaultTranslations,
+  Zge as defaultTranslations,
   yve as defineAvailableForm,
   Ole as describeFormSchema,
   zpe as dialog,
@@ -68102,10 +68103,10 @@ export {
   Ive as isPageBasedPagination,
   kve as isZodType,
   zde as linkVariants,
-  zge as markdownRenderers,
+  Vge as markdownRenderers,
   Pve as mergeDataCollectionFilters,
   Rve as modules,
-  Vge as oneIconSizes,
+  Fge as oneIconSizes,
   Wpe as parseDataCollectionUrlParams,
   dge as pdfScales,
   $pe as predefinedPresets,
@@ -68127,11 +68128,12 @@ export {
   Jde as timelineRowStatuses,
   Kpe as toasts,
   Hve as unwrapZodSchema,
+  Gge as usageLimitsPopoverSides,
   XN as useAiChat,
-  Fge as useAiChatTranslations,
+  Hge as useAiChatTranslations,
   N5 as useAudioPlayer,
-  Gge as useCanvasEntity,
-  Hge as useChatHistory,
+  Wge as useCanvasEntity,
+  $ge as useChatHistory,
   Wve as useData,
   $ve as useDataSource,
   Qpe as useDataSourceItemNavigation,
@@ -68145,7 +68147,7 @@ export {
   rge as useF0DialogAlikeContext,
   $_ as useF0Form,
   nge as useF0FormDefinition,
-  Wge as useFormCardValueFormatter,
+  Uge as useFormCardValueFormatter,
   yhe as useFormComponent,
   qve as useGroups,
   mhe as useIsDesktop,
@@ -68155,8 +68157,8 @@ export {
   cp as useReducedMotion,
   oge as useSchemaDefinition,
   Zve as useSelectable,
-  $ge as useSetFormCardValueFormatter,
-  Uge as useToolCallId,
+  Yge as useSetFormCardValueFormatter,
+  Xge as useToolCallId,
   jve as useXRay,
   ct as withDataTestId,
   sge as writeDataCollectionStorage

package/dist/i18n-provider-defaults.d.ts

@@ -690,6 +690,13 @@ export declare const defaultTranslations: {
             readonly upgradePlan: "Upgrade";
             readonly needMoreCredits: "Need more credits?";
         };
+        readonly usageLimits: {
+            readonly title: "Personal allowance";
+            readonly used: "{{percentage}}% used";
+            readonly yourCompany: "Your company";
+            readonly unlimited: "Unlimited";
+            readonly error: "Could not load usage";
+        };
         readonly reportCard: {
             readonly tableLabel: "Table";
             readonly openButton: "Open";
@@ -1350,10 +1357,9 @@ declare namespace Calendar {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        indent: {
-            setIndent: (level: number) => ReturnType;
-            unsetIndent: () => ReturnType;
-            outdent: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }
@@ -1373,9 +1379,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
         };
     }
 }
@@ -1383,8 +1389,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        moodTracker: {
-            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
+        indent: {
+            setIndent: (level: number) => ReturnType;
+            unsetIndent: () => ReturnType;
+            outdent: () => ReturnType;
         };
     }
 }
@@ -1392,9 +1400,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        fontSize: {
-            setFontSize: (fontSize: string) => ReturnType;
-            unsetFontSize: () => ReturnType;
+        moodTracker: {
+            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
         };
     }
 }
@@ -1402,8 +1409,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        transcript: {
-            insertTranscript: (data: TranscriptData) => ReturnType;
+        videoEmbed: {
+            setVideoEmbed: (options: {
+                src: string;
+            }) => ReturnType;
         };
     }
 }
@@ -1411,10 +1420,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        videoEmbed: {
-            setVideoEmbed: (options: {
-                src: string;
-            }) => ReturnType;
+        transcript: {
+            insertTranscript: (data: TranscriptData) => ReturnType;
         };
     }
 }

package/dist/i18n-provider-defaults.js

@@ -693,6 +693,13 @@ const e = {
       upgradePlan: "Upgrade",
       needMoreCredits: "Need more credits?"
     },
+    usageLimits: {
+      title: "Personal allowance",
+      used: "{{percentage}}% used",
+      yourCompany: "Your company",
+      unlimited: "Unlimited",
+      error: "Could not load usage"
+    },
     reportCard: {
       tableLabel: "Table",
       openButton: "Open"