@factorialco/f0-react 1.432.0 → 1.434.0

package/dist/f0.d.ts

@@ -332,6 +332,16 @@ declare type AiChatDisclaimer = {
     linkText?: string;
 };
 
+export declare type AiChatFileAttachmentConfig = {
+    onUploadFiles: (files: File[]) => Promise<UploadedFile[]>;
+    allowedMimeTypes?: string | string[];
+    /**
+     * Maximum number of files that can be attached at once.
+     * Omit or pass undefined for no limit.
+     */
+    maxFiles?: number;
+};
+
 /**
  * Interaction mode for the AI chat
  */
@@ -378,12 +388,11 @@ export declare type AiChatProviderProps = {
      */
     VoiceMode?: React.ComponentType;
     /**
-     * Async resolver functions for entity references in markdown.
-     * Used to fetch profile data for inline entity mentions (hover cards).
-     * The consuming app provides these so the chat can resolve entity IDs
-     * (e.g. employee IDs) into rich profile data without knowing the API.
+     * Configuration for entity references in markdown.
+     * Groups resolver functions (data fetching for hover cards) and
+     * URL builders (navigation links) for each entity type.
      */
-    entityResolvers?: EntityResolvers;
+    entityRefs?: EntityRefs;
     /**
      * Available tool hints that the user can activate to provide intent context
      * to the AI. Renders a selector button next to the send button.
@@ -395,6 +404,10 @@ export declare type AiChatProviderProps = {
      * Groups fetchUsage, upgradePlanUrl, and company/plan display info.
      */
     credits?: AiChatCredits;
+    /**
+     * File attachment configuration. When provided, enables file uploads in the chat.
+     */
+    fileAttachments?: AiChatFileAttachmentConfig;
     onThumbsUp?: (message: AIMessage, { threadId, feedback }: {
         threadId: string;
         feedback: string;
@@ -504,7 +517,7 @@ declare type AiChatProviderReturnValue = {
     inProgress: boolean;
     /** Set the in-progress state (synced from CopilotKit's isLoading) */
     setInProgress: (value: boolean) => void;
-} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityResolvers" | "toolHints" | "credits"> & {
+} & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityRefs" | "toolHints" | "credits" | "fileAttachments"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
     /** Open the canvas panel with the given content */
@@ -533,9 +546,10 @@ declare interface AiChatState {
     historyEnabled?: boolean;
     footer?: React.ReactNode;
     VoiceMode?: React.ComponentType;
-    entityResolvers?: EntityResolvers;
+    entityRefs?: EntityRefs;
     toolHints?: AiChatToolHint[];
     credits?: AiChatCredits;
+    fileAttachments?: AiChatFileAttachmentConfig;
     placeholders?: string[];
     setPlaceholders?: React.Dispatch<React.SetStateAction<string[]>>;
     onThumbsUp?: (message: AIMessage, { threadId, feedback }: {
@@ -571,9 +585,6 @@ export declare type AiChatToolHint = {
     prompt: string;
 };
 
-/**
- * Tracking options for the AI chat
- */
 declare type AiChatTrackingOptions = {
     onVisibility?: () => void;
     onClose?: () => void;
@@ -652,7 +663,7 @@ export declare const aiTranslations: {
         readonly unpinChat: "Unpin chat";
         readonly deleteChat: "Delete chat";
         readonly ask: "Ask One";
-        readonly viewProfile: "View profile";
+        readonly view: "View";
         readonly tools: "Tools";
         readonly credits: {
             readonly title: "Credits";
@@ -689,6 +700,8 @@ export declare const aiTranslations: {
                 readonly actionLabel: "Get credits";
             };
         };
+        readonly attachFile: "Attach file";
+        readonly removeFile: "Remove";
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -1419,6 +1432,18 @@ declare type CalendarMode = "single" | "range";
 
 declare type CalendarView = "day" | "month" | "year" | "week" | "quarter" | "halfyear";
 
+/**
+ * Profile data for a candidate entity (ATS applicant), resolved asynchronously
+ * and displayed in the entity reference hover card.
+ */
+declare type CandidateProfile = {
+    id: string | number;
+    firstName: string;
+    lastName: string;
+    avatarUrl?: string;
+    source?: string;
+};
+
 /**
  * Discriminated union for canvas panel content.
  * Add new entity types to this union as they are implemented.
@@ -3217,7 +3242,7 @@ export declare const defaultTranslations: {
         readonly unpinChat: "Unpin chat";
         readonly deleteChat: "Delete chat";
         readonly ask: "Ask One";
-        readonly viewProfile: "View profile";
+        readonly view: "View";
         readonly tools: "Tools";
         readonly credits: {
             readonly title: "Credits";
@@ -3254,6 +3279,8 @@ export declare const defaultTranslations: {
                 readonly actionLabel: "Get credits";
             };
         };
+        readonly attachFile: "Attach file";
+        readonly removeFile: "Remove";
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -3753,6 +3780,15 @@ declare const emojiVariants: (props?: ({
     className?: ClassValue;
 })) | undefined) => string;
 
+/**
+ * Grouped configuration for entity references in the AI chat.
+ * Combines resolver functions (data fetching) with URL builders (navigation).
+ */
+export declare type EntityRefs = {
+    resolvers?: EntityResolvers;
+    urls?: EntityUrlBuilders;
+};
+
 /**
  * Map of async resolver functions keyed by entity type.
  * Each resolver takes an entity ID and returns the profile data
@@ -3762,6 +3798,8 @@ declare const emojiVariants: (props?: ({
  */
 export declare type EntityResolvers = {
     person?: (id: string) => Promise<PersonProfile>;
+    candidate?: (id: string) => Promise<CandidateProfile>;
+    jobPosting?: (id: string) => Promise<JobPostingProfile>;
     /**
      * Search for persons by name query. Used by the @mention autocomplete
      * in the chat input to let users reference specific employees.
@@ -3769,6 +3807,19 @@ export declare type EntityResolvers = {
     searchPersons?: (query: string) => Promise<PersonProfile[]>;
 };
 
+/**
+ * Map of URL builder functions keyed by entity type.
+ * Each builder takes an entity ID and returns the URL to navigate to.
+ *
+ * When a URL builder is not provided for an entity type, the hover card
+ * will not show a navigation action.
+ */
+export declare type EntityUrlBuilders = {
+    person?: (id: string) => string;
+    candidate?: (id: string) => string;
+    jobPosting?: (id: string) => string;
+};
+
 declare type Enumerate<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? [...Acc, N][number] : Enumerate<N, [...Acc, Acc["length"]]>;
 
 export declare interface ErrorMessageProps {
@@ -3867,7 +3918,7 @@ export declare const F0AiChat: () => JSX_2.Element | null;
 /**
  * @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, entityResolvers, toolHints, credits, onThumbsUp, onThumbsDown, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
+export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityRefs, toolHints, credits, fileAttachments, onThumbsUp, onThumbsDown, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
 
 export declare const F0AiChatTextArea: ({ submitLabel, inProgress, onSend, onStop, creditWarning, onDismissCreditWarning, onGetCredits, }: ChatTextareaProps) => JSX_2.Element;
 
@@ -4181,13 +4232,14 @@ declare type F0AvatarFlagProps = {
 } & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
 
 export declare const F0AvatarIcon: WithDataTestIdReturnType_4<    {
-({ icon, size, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, }: F0AvatarIconProps_2): JSX_2.Element;
+({ icon, size, state, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, }: F0AvatarIconProps_2): JSX_2.Element;
 displayName: string;
 }>;
 
 export declare type F0AvatarIconProps = {
     icon: IconType;
     size?: (typeof avatarIconSizes)[number];
+    state?: F0IconProps["state"];
 } & Partial<Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">>;
 
 export declare const F0AvatarList: WithDataTestIdReturnType_4<    {
@@ -7664,6 +7716,17 @@ declare type ItemDefinition = {
     avatar?: AvatarVariant;
 };
 
+/**
+ * Profile data for a job posting entity (ATS opening), resolved asynchronously
+ * and displayed in the entity reference hover card.
+ */
+declare type JobPostingProfile = {
+    id: string | number;
+    title: string;
+    status?: string;
+    location?: string;
+};
+
 declare type Join<T extends string[], D extends string> = T extends [] ? never : T extends [infer F] ? F : T extends [infer F, ...infer R] ? F extends string ? `${F}${D}${Join<Extract<R, string[]>, D>}` : never : string;
 
 /** Flex justify content */
@@ -10085,6 +10148,15 @@ export declare interface TwoColumnLayoutProps {
  */
 export declare function unwrapZodSchema(schema: ZodTypeAny): ZodTypeAny;
 
+/**
+ * Tracking options for the AI chat
+ */
+export declare type UploadedFile = {
+    url: string;
+    filename: string;
+    mimetype: string;
+};
+
 declare type UpsellAction = BaseAction & {
     type: "upsell";
     variant: "promote" | "outlinePromote";
@@ -10898,11 +10970,6 @@ declare module "gridstack" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -10950,3 +11017,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}

package/dist/f0.js

@@ -1,12 +1,12 @@
-import { O as jo, P as xe, Q as yt, K as U, L as sn, R as nr, T as Vo, U as wa, W as pi, X as Wu, Y as $o, Z as je, u as De, _ as Le, $ as ur, a0 as Uu, a1 as Ku, a2 as Tr, a3 as ut, a4 as Sa, a5 as Qu, a6 as Hu, a7 as Gu, a8 as qn, a9 as Ns, aa as Xu, ab as Yu, ac as Ju, ad as gi, ae as ed, af as td, ag as zo, ah as nd, ai as _a, aj as ka, ak as rs, al as Ca, am as Zo, an as Or, ao as qo, ap as rd, aq as sd, ar as ad, as as id, at as Na, au as vi, av as od, aw as ld, ax as cd, ay as Wo, az as ud, M as Me, aA as dd, aB as Er, aC as rr, aD as Uo, aE as Da, aF as fd, aG as md, aH as dr, aI as Aa, aJ as Ko, aK as xn, aL as Qo, aM as hd, aN as Fa, aO as pd, aP as Ho, aQ as Go, N as kt, aR as gd, aS as Gs, aT as Xo, aU as vd, aV as Yo, aW as Sn, aX as Jo, aY as bd, aZ as yd, a_ as el, a$ as xd, b0 as wd, b1 as Sd, b2 as ss, b3 as _d, b4 as kd, b5 as Cd, b6 as Nd, j as Dd, b7 as Ad, b8 as tl, b9 as mn, ba as nl, bb as rl, bc as Ir, bd as sl, be as Ta, bf as Oa, bg as Ea, bh as Ia, bi as dt, bj as Ra, bk as _n, bl as Wn, bm as Un, bn as Kn, bo as Qn, bp as Fd, bq as br, br as al, bs as Rr, bt as ot, bu as il, bv as as, bw as ol, bx as Pa, by as La, bz as Td, bA as Od, bB as Ed, bC as Id, bD as Rd, bE as ll, bF as Pd, bG as Ld, bH as Md, bI as Bd, bJ as cl, bK as jd, bL as Vd, bM as $d, bN as ul, bO as zd, bP as Zd, bQ as qd, bR as Wd, I as Ud, bS as Kd, bT as Qd, bU as Hd, bV as Gd, bW as Xd, bX as Yd } from "./F0AiChat-DRUcCTJI.js";
-import { cl as r0, i as s0, cx as a0, cF as i0, h as o0, F as l0, a as c0, C as u0, b as d0, bY as f0, bZ as m0, b_ as h0, b$ as p0, c0 as g0, c1 as v0, c3 as b0, c4 as y0, c5 as x0, c6 as w0, ca as S0, cb as _0, cB as k0, k as C0, ce as N0, cf as D0, cg as A0, ch as F0, cj as T0, ck as O0, cm as E0, cd as I0, ci as R0, cC as P0, c7 as L0, c8 as M0, c9 as B0, cw as j0, cr as V0, cu as $0, g as z0, cq as Z0, cG as q0, cp as W0, co as U0, c2 as K0, c as Q0, cn as H0, cs as G0, d as X0, cy as Y0, cz as J0, cA as e1, cH as t1, cc as n1, ct as r1, f as s1, e as a1, cE as i1, cv as o1, cD as l1 } from "./F0AiChat-DRUcCTJI.js";
+import { O as jo, P as xe, Q as yt, K as U, L as sn, R as nr, T as Vo, U as wa, W as pi, X as Wu, Y as $o, Z as je, u as De, _ as Le, $ as ur, a0 as Uu, a1 as Ku, a2 as Tr, a3 as ut, a4 as Sa, a5 as Qu, a6 as Hu, a7 as Gu, a8 as qn, a9 as Ns, aa as Xu, ab as Yu, ac as Ju, ad as gi, ae as ed, af as td, ag as zo, ah as nd, ai as _a, aj as ka, ak as rs, al as Ca, am as Zo, an as Or, ao as qo, ap as rd, aq as sd, ar as ad, as as id, at as Na, au as vi, av as od, aw as ld, ax as cd, ay as Wo, az as ud, M as Me, aA as dd, aB as Er, aC as rr, aD as Uo, aE as Da, aF as fd, aG as md, aH as dr, aI as Aa, aJ as Ko, aK as xn, aL as Qo, aM as hd, aN as Fa, aO as pd, aP as Ho, aQ as Go, N as kt, aR as gd, aS as Gs, aT as Xo, aU as vd, aV as Yo, aW as Sn, aX as Jo, aY as bd, aZ as yd, a_ as el, a$ as xd, b0 as wd, b1 as Sd, b2 as ss, b3 as _d, b4 as kd, b5 as Cd, b6 as Nd, j as Dd, b7 as Ad, b8 as tl, b9 as mn, ba as nl, bb as rl, bc as Ir, bd as sl, be as Ta, bf as Oa, bg as Ea, bh as Ia, bi as dt, bj as Ra, bk as _n, bl as Wn, bm as Un, bn as Kn, bo as Qn, bp as Fd, bq as br, br as al, bs as Rr, bt as ot, bu as il, bv as as, bw as ol, bx as Pa, by as La, bz as Td, bA as Od, bB as Ed, bC as Id, bD as Rd, bE as ll, bF as Pd, bG as Ld, bH as Md, bI as Bd, bJ as cl, bK as jd, bL as Vd, bM as $d, bN as ul, bO as zd, bP as Zd, bQ as qd, bR as Wd, I as Ud, bS as Kd, bT as Qd, bU as Hd, bV as Gd, bW as Xd, bX as Yd } from "./F0AiChat-BCNtjNO0.js";
+import { cl as r0, i as s0, cx as a0, cF as i0, h as o0, F as l0, a as c0, C as u0, b as d0, bY as f0, bZ as m0, b_ as h0, b$ as p0, c0 as g0, c1 as v0, c3 as b0, c4 as y0, c5 as x0, c6 as w0, ca as S0, cb as _0, cB as k0, k as C0, ce as N0, cf as D0, cg as A0, ch as F0, cj as T0, ck as O0, cm as E0, cd as I0, ci as R0, cC as P0, c7 as L0, c8 as M0, c9 as B0, cw as j0, cr as V0, cu as $0, g as z0, cq as Z0, cG as q0, cp as W0, co as U0, c2 as K0, c as Q0, cn as H0, cs as G0, d as X0, cy as Y0, cz as J0, cA as e1, cH as t1, cc as n1, ct as r1, f as s1, e as a1, cE as i1, cv as o1, cD as l1 } from "./F0AiChat-BCNtjNO0.js";
 import { jsx as c, jsxs as N, Fragment as He } from "react/jsx-runtime";
 import * as Ct from "react";
 import Y, { forwardRef as st, useRef as K, useImperativeHandle as Jd, Children as Pr, useCallback as P, useMemo as z, useState as te, useEffect as le, createElement as yr, isValidElement as dl, Fragment as fl, useLayoutEffect as ef, createContext as It, memo as ml, useReducer as tf, useContext as nt, cloneElement as nf, PureComponent as rf, useId as Ma } from "react";
 import { unstable_batchedUpdates as xr, createPortal as sf, flushSync as af } from "react-dom";
-import { C as of, S as bi, a as lf, f as Ds, L as Bn, b as cf, A as uf, i as wr, c as hl, E as df, g as Nr, d as ff, e as mf, h as hf, j as bn, k as pl, u as pf, G as gf, l as vf, m as yi, r as bf, n as yf, o as gl, p as xf, B as vl, X as bl, Y as Xs, q as wf, s as yl, t as Sf, v as _f, w as kf, x as Cf, y as Nf, z as Df, D as Af, F as Ff, H as xi, I as Tf, J as Of, K as Ef, M as If, N as Rf, O as Pf, P as Lf, Q as Mf, V as Bf, R as Ys, T as jf, U as Vf, W as $f, Z as xl, _ as Ba, $ as wl, a0 as zf, a1 as Zf, a2 as qf, a3 as Wf, a4 as Uf, a5 as Kf, a6 as Qf } from "./index-CCcCCEfU.js";
-import { a7 as u1, aa as d1, a8 as f1, a9 as m1, ab as h1 } from "./index-CCcCCEfU.js";
-import { A as g1, F as v1, c as b1, d as y1, b as x1, a as w1, o as S1, u as _1 } from "./F0HILActionConfirmation-ot92kVFT.js";
+import { C as of, S as bi, a as lf, f as Ds, L as Bn, b as cf, A as uf, i as wr, c as hl, E as df, g as Nr, d as ff, e as mf, h as hf, j as bn, k as pl, u as pf, G as gf, l as vf, m as yi, r as bf, n as yf, o as gl, p as xf, B as vl, X as bl, Y as Xs, q as wf, s as yl, t as Sf, v as _f, w as kf, x as Cf, y as Nf, z as Df, D as Af, F as Ff, H as xi, I as Tf, J as Of, K as Ef, M as If, N as Rf, O as Pf, P as Lf, Q as Mf, V as Bf, R as Ys, T as jf, U as Vf, W as $f, Z as xl, _ as Ba, $ as wl, a0 as zf, a1 as Zf, a2 as qf, a3 as Wf, a4 as Uf, a5 as Kf, a6 as Qf } from "./index-8e9inWY-.js";
+import { a7 as u1, aa as d1, a8 as f1, a9 as m1, ab as h1 } from "./index-8e9inWY-.js";
+import { A as g1, F as v1, c as b1, d as y1, b as x1, a as w1, o as S1, u as _1 } from "./F0HILActionConfirmation-4KT5qQii.js";
 import { defaultTranslations as C1 } from "./i18n-provider-defaults.js";
 const Hf = {
   xs: 1,

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

@@ -408,7 +408,7 @@ export declare const defaultTranslations: {
         readonly unpinChat: "Unpin chat";
         readonly deleteChat: "Delete chat";
         readonly ask: "Ask One";
-        readonly viewProfile: "View profile";
+        readonly view: "View";
         readonly tools: "Tools";
         readonly credits: {
             readonly title: "Credits";
@@ -445,6 +445,8 @@ export declare const defaultTranslations: {
                 readonly actionLabel: "Get credits";
             };
         };
+        readonly attachFile: "Attach file";
+        readonly removeFile: "Remove";
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -737,11 +739,6 @@ declare module "gridstack" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -789,3 +786,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}

package/dist/i18n-provider-defaults.js

@@ -408,7 +408,7 @@ const e = {
     unpinChat: "Unpin chat",
     deleteChat: "Delete chat",
     ask: "Ask One",
-    viewProfile: "View profile",
+    view: "View",
     tools: "Tools",
     credits: {
       title: "Credits",
@@ -445,6 +445,8 @@ const e = {
         actionLabel: "Get credits"
       }
     },
+    attachFile: "Attach file",
+    removeFile: "Remove",
     growth: {
       demoCard: {
         title: "See {{moduleName}} in action",