@factorialco/f0-react 7.26.0 → 7.28.0

package/dist/experimental.d.ts

@@ -5657,6 +5657,14 @@ declare const defaultTranslations: {
         readonly remove: "Remove favorite";
     };
     readonly notifications: "Notifications";
+    readonly toasts: {
+        readonly clearAll: "Clear all";
+        readonly messages: "Messages";
+        readonly moreMessages: {
+            readonly one: "+{{count}} more message";
+            readonly other: "+{{count}} more messages";
+        };
+    };
     readonly ai: {
         readonly openChat: "Open Chat with One AI";
         readonly closeChat: "Close Chat with One AI";
@@ -11434,6 +11442,12 @@ autoFocus?: boolean;
 * combobox — has to be tabbable, or focus can leave it and never come back.
 */
 tabIndex?: number;
+/**
+* Replaces the magnifier. For a field that finds things by some other means
+* than matching text — a question put to an assistant — and should not
+* promise that it matches text.
+*/
+icon?: IconType;
 } & Pick<InputFieldProps<string>, "onChange" | "name" | "size" | "role" | "aria-activedescendant" | "aria-autocomplete" | "aria-controls" | "aria-expanded" | "onFocus" | "onBlur" | "onKeyDown" | "loading" | "disabled" | "placeholder" | "clearable"> & RefAttributes<HTMLInputElement>>;
 
 export declare type F0SearchInputProps = {
@@ -11447,6 +11461,12 @@ export declare type F0SearchInputProps = {
      * combobox — has to be tabbable, or focus can leave it and never come back.
      */
     tabIndex?: number;
+    /**
+     * Replaces the magnifier. For a field that finds things by some other means
+     * than matching text — a question put to an assistant — and should not
+     * promise that it matches text.
+     */
+    icon?: IconType;
 } & Pick<InputFieldProps<string>, "size" | "loading" | "clearable" | "placeholder" | "disabled" | "onBlur" | "onFocus" | "onChange" | "name" | "role" | "onKeyDown" | "aria-controls" | "aria-expanded" | "aria-activedescendant" | "aria-autocomplete">;
 
 /**
@@ -15367,6 +15387,11 @@ declare type OneDataCollectionGeneric = <R extends RecordType, Filters extends F
 declare type OneDataCollectionProps<R extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition, ItemActions extends ItemActionsDefinition<R>, NavigationFilters extends NavigationFiltersDefinition, Grouping extends GroupingDefinition<R>> = {
     source: DataCollectionSource<R, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping>;
     visualizations: readonly Visualization<R, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping>[];
+    /**
+     * An entry listed above the filters inside the panel, with a pane of its
+     * own. For a way of narrowing the list that is not one filter.
+     */
+    quickFilter?: QuickFilterDefinition;
     onSelectItems?: OnSelectItemsCallback<R, Filters>;
     onBulkAction?: OnBulkActionCallback<R, Filters>;
     /**
@@ -15540,6 +15565,11 @@ declare type OneFilterPickerRootProps<Definition extends FiltersDefinition> = {
     onChange: (value: FiltersState<Definition>) => void;
     /** The children of the component */
     children?: React.ReactNode;
+    /**
+     * An entry listed before the filters inside the panel, with a pane of its
+     * own. For a way of filtering that is not one filter.
+     */
+    quickFilter?: QuickFilterDefinition;
     /** The mode of the component */
     mode?: FiltersMode;
     /** Callback fired when filters open state is changed */
@@ -16036,6 +16066,15 @@ export declare type PresetDefinition<Filters extends FiltersDefinition> = {
      * boundary.
      */
     settings?: unknown;
+    /**
+     * Whatever the quick filter captured of its own narrowing, from
+     * {@link QuickFilterDefinition.capture}, handed back to `restore` when this
+     * view is applied. Opaque here: a view that narrows the list by something that
+     * is not a filter — a question, a saved lookup — would otherwise be saved as
+     * the filters it happens to have set, which for a narrowing that sets none at
+     * all is a view that shows everything.
+     */
+    quickFilter?: unknown;
     /** Function to count the number of items that match the filter */
     itemsCount?: (filters: FiltersState<Filters>) => Promise<number | undefined> | number | undefined;
 };
@@ -16309,6 +16348,89 @@ declare type Pulse = (typeof pulses)[number];
 
 declare const pulses: readonly ["superNegative", "negative", "neutral", "positive", "superPositive"];
 
+/**
+ * A way of narrowing the list that is not one filter: an entry listed above
+ * the filters inside the panel, with a pane of its own when picked. A natural
+ * language question, a saved view, "my team".
+ */
+export declare type QuickFilterDefinition = {
+    /** The entry's label in the filter list */
+    label: string;
+    /** Icon drawn before that label */
+    icon?: IconType;
+    /**
+     * Whether what is applied to the list right now came from this entry. The
+     * panel opens on the filter that carries a value when something is applied;
+     * when that something is the quick filter's own answer, it opens on the
+     * entry instead, so the reader returns to the question they asked rather
+     * than to one of the filters it set.
+     */
+    active?: boolean;
+    /**
+     * The pane shown when the entry is picked. f0 draws the entry and nothing
+     * else; the pane is the consumer's.
+     *
+     * `stage` merges into the draft the apply button commits — the same draft
+     * the filter panes write — so a staged key shows in the list at once, a
+     * tick made afterwards survives Apply, and nothing lingers past it. Pass a
+     * key with `undefined` to clear it. Nothing reaches the list until Apply.
+     */
+    render: (api: {
+        stage: (filters: Record<string, unknown>) => void;
+    }) => ReactNode;
+    /**
+     * Whether the quick filter is working on an answer right now. The collection
+     * shows it where it shows its own — a spinner beside the list's controls — so
+     * that a reader who asked and then closed the panel can still see that an
+     * answer is coming.
+     */
+    loading?: boolean;
+    /**
+     * What this entry has put on the list, in a form a saved view can hold. Called
+     * when a view is saved and whenever the current view is compared with one;
+     * `undefined` means the list is not showing this entry's work.
+     *
+     * Opaque to f0, which stores it and hands it back — the entry is the only thing
+     * that knows what its own narrowing is made of. Keep it small and serializable:
+     * it goes wherever saved views are kept. A reference, a question, an id — not a
+     * result, which would be stale by the time the view is opened again.
+     */
+    capture?: () => unknown;
+    /**
+     * Puts that back, with whatever `capture` returned, when a saved view is
+     * applied — and with `undefined` for a view that has none of this entry's work
+     * in it, which means clear whatever is there.
+     *
+     * Called after the view's filters, so a narrowing that depends on them can be
+     * worked out against the state they leave behind.
+     */
+    restore?: (state: unknown) => void;
+    /**
+     * Called when the apply button is pressed while this entry's pane is the one
+     * showing, just before the draft is committed and the panel closes.
+     *
+     * The button says "apply filters" and the reader has this pane in front of
+     * them, so whatever they have entered here is part of what they are applying.
+     * Without this, a pane that keeps its own unsubmitted state — a typed
+     * question, an unconfirmed choice — watches the panel close over it and
+     * appear to do nothing.
+     */
+    onApply?: () => void;
+    /**
+     * A chip in the applied-filters row for what the quick filter has put on
+     * the list that no filter chip can show — a set of rows, a computed column.
+     * Without it that narrowing has no surface once the panel closes, and the
+     * list reads as broken rather than as filtered. Listed first; its close
+     * control and the row's Clear both call `onRemove`, and clicking it opens
+     * the panel. Shown even while a preset stands in for the filter chips,
+     * because no preset stands in for this.
+     */
+    chip?: {
+        label: string;
+        onRemove: () => void;
+    };
+};
+
 export declare const RadarChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<RadarChartProps<ChartConfig_2> & {
 dataTestId?: string;
 } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
@@ -19930,10 +20052,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        videoEmbed: {
-            setVideoEmbed: (options: {
-                src: string;
-            }) => ReturnType;
+        transcript: {
+            insertTranscript: (data: TranscriptData) => ReturnType;
         };
     }
 }
@@ -19941,8 +20061,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        transcript: {
-            insertTranscript: (data: TranscriptData) => ReturnType;
+        videoEmbed: {
+            setVideoEmbed: (options: {
+                src: string;
+            }) => ReturnType;
         };
     }
 }

package/dist/experimental.js

@@ -1,7 +1,7 @@
-import { v as s, t, A as i, b as o, L as r, bg as n, bf as l, bh as S, B as d, w as g, y as b, N as u, bn as C, bo as c, bx as m, x as P, C as F, bm as p, by as h, D as M, z as T, a5 as I, bT as E, b_ as A, M as f, bS as L, E as B, d as R, g as y, l as D, ap as k, aq as v, an as O, G as W, bc as _, F as N, aw as H, h as x, aB as V, ax as w, ay as G, az as U, n as z, o as K, H as j, bB as X, bC as Q, bq as Y, av as q, bF as J, bQ as Z, bi as $, aQ as aa, aA as ea, aO as sa, aN as ta, aG as ia, aP as oa, a8 as ra, bA as na, W as la, ah as Sa, J as da, O as ga, K as ba, c2 as ua, X as Ca, P as ca, Q as ma, T as Pa, bj as Fa, R as pa, bO as ha, bU as Ma, S as Ta, ab as Ia, ac as Ea, a0 as Aa, a1 as fa, a2 as La, $ as Ba, a3 as Ra, Y as ya, a4 as Da, a6 as ka, a7 as va, a9 as Oa, aa as Wa, ad as _a, ae as Na, af as Ha, bY as xa, bX as Va, be as wa, bd as Ga, bl as Ua, bz as za, bw as Ka, bk as ja, ag as Xa, br as Qa, bZ as Ya, c0 as qa, bp as Ja, bu as Za, bs as $a, c1 as ae, bv as ee, bt as se, b$ as te, e as ie, i as oe, aW as re, ak as ne, am as le, aJ as Se, bW as de, bV as ge, al as be, ar as ue, f as Ce, b7 as ce, bb as me, b5 as Pe, b6 as Fe, b3 as pe, b4 as he, b8 as Me, b9 as Te, b2 as Ie, j as Ee, k as Ae, ba as fe, bI as Le, bG as Be, au as Re, as as ye, at as De, aS as ke, bR as ve, bH as Oe, p as We, q as _e, m as Ne, aZ as He, I as xe, r as Ve, a_ as we, bM as Ge, aV as Ue, aU as ze, a$ as Ke, bE as je, bJ as Xe, ai as Qe, b0 as Ye, bP as qe, aR as Je, aT as Ze, aX as $e, aY as as, c as es, ao as ss, aj as ts, u as is, aC as os, aD as rs, aE as ns, aF as ls, bD as Ss, aK as ds, aL as gs, aH as bs, aI as us, V as Cs, U as cs, _ as ms, Z as Ps, aM as Fs, b1 as ps, bN as hs, bL as Ms, bK as Ts } from "./experimental-CpvI08wg.js";
-import { ea as Es, eL as As, eK as fs, eX as Ls, r as Bs, eI as Rs, cE as ys, cA as Ds, cB as ks, dO as vs, cn as Os, cn as Ws, cj as _s, eE as Ns, cH as Hs, eq as xs, cI as Vs, e_ as ws, eJ as Gs, eT as Us, eU as zs, e9 as Ks, eY as js, k as Xs, eb as Qs, d2 as Ys, eH as qs, dR as Js, eM as Zs, T as $s, h as at, ck as et, eV as st, e$ as tt, eW as it, eZ as ot, eS as rt, eP as nt, eR as lt, eN as St, eF as dt, eG as gt, eA as bt, eQ as ut, eO as Ct, dS as ct } from "./F0CanvasPanel-DxLBBpm0.js";
-import { aK as Pt, aL as Ft, af as pt, ag as ht, ad as Mt, aq as Tt, m as It, ah as Et, aV as At, am as ft, aU as Lt, ap as Bt, ae as Rt, aI as yt, ar as Dt, aX as kt, aW as vt, az as Ot, aA as Wt, as as _t, aD as Nt, F as Ht, ac as xt, aF as Vt, aC as wt, ax as Gt, av as Ut, a$ as zt, aw as Kt, aG as jt, aH as Xt, ai as Qt, aY as Yt, aZ as qt, ay as Jt, aJ as Zt, aR as $t, O as ai, aT as ei, aj as si, b1 as ti, al as ii, an as oi, aD as ri, a_ as ni, aE as li, aB as Si, b0 as di, ak as gi, W as bi, ao as ui, ab as Ci, a9 as ci, aa as mi, aO as Pi, aP as Fi, aM as pi, b2 as hi, aS as Mi, au as Ti, at as Ii, u as Ei, t as Ai, aN as fi, aQ as Li, Q as Bi } from "./MapProvider-BYegpc30.js";
-import { b as yi, e as Di, i as ki, g as vi, h as Oi, a as Wi, R as _i, l as Ni, f as Hi, j as xi, k as Vi, u as wi } from "./F0Map-DNeWhe4i.js";
+import { v as s, t, A as i, b as o, L as r, bg as n, bf as l, bh as S, B as d, w as g, y as b, N as u, bn as C, bo as c, bx as m, x as P, C as F, bm as p, by as T, D as h, z as M, a5 as I, bT as E, b_ as A, M as f, bS as L, E as B, d as R, g as y, l as D, ap as v, aq as k, an as O, G as W, bc as _, F as N, aw as H, h as x, aB as V, ax as w, ay as G, az as U, n as z, o as K, H as j, bB as X, bC as Q, bq as Y, av as q, bF as J, bQ as Z, bi as $, aQ as aa, aA as ea, aO as sa, aN as ta, aG as ia, aP as oa, a8 as ra, bA as na, W as la, ah as Sa, J as da, O as ga, K as ba, c2 as ua, X as Ca, P as ca, Q as ma, T as Pa, bj as Fa, R as pa, bO as Ta, bU as ha, S as Ma, ab as Ia, ac as Ea, a0 as Aa, a1 as fa, a2 as La, $ as Ba, a3 as Ra, Y as ya, a4 as Da, a6 as va, a7 as ka, a9 as Oa, aa as Wa, ad as _a, ae as Na, af as Ha, bY as xa, bX as Va, be as wa, bd as Ga, bl as Ua, bz as za, bw as Ka, bk as ja, ag as Xa, br as Qa, bZ as Ya, c0 as qa, bp as Ja, bu as Za, bs as $a, c1 as ae, bv as ee, bt as se, b$ as te, e as ie, i as oe, aW as re, ak as ne, am as le, aJ as Se, bW as de, bV as ge, al as be, ar as ue, f as Ce, b7 as ce, bb as me, b5 as Pe, b6 as Fe, b3 as pe, b4 as Te, b8 as he, b9 as Me, b2 as Ie, j as Ee, k as Ae, ba as fe, bI as Le, bG as Be, au as Re, as as ye, at as De, aS as ve, bR as ke, bH as Oe, p as We, q as _e, m as Ne, aZ as He, I as xe, r as Ve, a_ as we, bM as Ge, aV as Ue, aU as ze, a$ as Ke, bE as je, bJ as Xe, ai as Qe, b0 as Ye, bP as qe, aR as Je, aT as Ze, aX as $e, aY as as, c as es, ao as ss, aj as ts, u as is, aC as os, aD as rs, aE as ns, aF as ls, bD as Ss, aK as ds, aL as gs, aH as bs, aI as us, V as Cs, U as cs, _ as ms, Z as Ps, aM as Fs, b1 as ps, bN as Ts, bL as hs, bK as Ms } from "./experimental-Drx9E2I8.js";
+import { ea as Es, eL as As, eK as fs, eX as Ls, r as Bs, eI as Rs, cE as ys, cA as Ds, cB as vs, dO as ks, cn as Os, cn as Ws, cj as _s, eE as Ns, cH as Hs, eq as xs, cI as Vs, e_ as ws, eJ as Gs, eT as Us, eU as zs, e9 as Ks, eY as js, k as Xs, eb as Qs, d2 as Ys, eH as qs, dR as Js, eM as Zs, T as $s, h as at, ck as et, eV as st, e$ as tt, eW as it, eZ as ot, eS as rt, eP as nt, eR as lt, eN as St, eF as dt, eG as gt, eA as bt, eQ as ut, eO as Ct, dS as ct } from "./F0CanvasPanel-CMwh5HFX.js";
+import { aL as Pt, aM as Ft, ag as pt, ah as Tt, ae as ht, ar as Mt, o as It, ai as Et, aW as At, an as ft, aV as Lt, aq as Bt, af as Rt, aJ as yt, as as Dt, aY as vt, aX as kt, aA as Ot, aB as Wt, at as _t, aE as Nt, F as Ht, ad as xt, aG as Vt, aD as wt, ay as Gt, aw as Ut, b0 as zt, ax as Kt, aH as jt, aI as Xt, aj as Qt, aZ as Yt, a_ as qt, az as Jt, aK as Zt, aS as $t, O as ai, aU as ei, ak as si, b2 as ti, am as ii, ao as oi, aE as ri, a$ as ni, aF as li, aC as Si, b1 as di, al as gi, W as bi, ap as ui, ac as Ci, aa as ci, ab as mi, aP as Pi, aQ as Fi, aN as pi, b3 as Ti, aT as hi, av as Mi, au as Ii, u as Ei, v as Ai, aO as fi, aR as Li, T as Bi } from "./MapProvider-C4kRQyql.js";
+import { b as yi, e as Di, i as vi, g as ki, h as Oi, a as Wi, R as _i, l as Ni, f as Hi, j as xi, k as Vi, u as wi } from "./F0Map-DwKK15l3.js";
 export {
   Pt as AUTO_PER_PAGE_MAX,
   Ft as AUTO_PER_PAGE_MIN_RESERVED_ROWS,
@@ -14,10 +14,10 @@ export {
   n as AreaChartWidget,
   l as AutoGrid,
   Es as Badge,
-  ht as BarChart,
+  Tt as BarChart,
   S as BarChartWidget,
   d as BaseActivityItemList,
-  Mt as BaseBanner,
+  ht as BaseBanner,
   g as BaseCelebration,
   b as BaseCommunityPost,
   As as BaseTabs,
@@ -25,7 +25,7 @@ export {
   u as Breadcrumbs,
   C as CalendarEvent,
   c as CalendarEventList,
-  Tt as CardSelectableContainer,
+  Mt as CardSelectableContainer,
   It as Carousel,
   Et as CategoryBarChart,
   m as CategoryBarSection,
@@ -33,11 +33,11 @@ export {
   F as CelebrationSkeleton,
   p as ChartWidgetEmptyState,
   Ls as Chip,
-  h as ClockInControls,
+  T as ClockInControls,
   At as CoachmarkProvider,
   ft as ComboChart,
-  M as CommunityPost,
-  T as CommunityPostSkeleton,
+  h as CommunityPost,
+  M as CommunityPostSkeleton,
   I as CompanySelector,
   Bs as Counter,
   E as DEFAULT_EXPECTED_ITEMS_COUNT,
@@ -52,14 +52,14 @@ export {
   Bt as F0ActionBar,
   Rt as F0AiBanner,
   R as F0AiCallout,
-  ks as F0AvatarModule,
-  vs as F0ButtonToggle,
+  vs as F0AvatarModule,
+  ks as F0ButtonToggle,
   y as F0Callout,
   Os as F0CardHorizontal,
   Ws as F0CardRow,
   D as F0CarouselDialog,
-  k as F0Chat,
-  v as F0ChatProvider,
+  v as F0Chat,
+  k as F0ChatProvider,
   O as F0CommandPaletteProvider,
   W as F0CommunityPostsCarousel,
   _ as F0ENPSButton,
@@ -69,8 +69,8 @@ export {
   Dt as F0LocationInput,
   yi as F0Map,
   Di as F0MapControls,
-  ki as F0MapList,
-  vi as F0MapSidebar,
+  vi as F0MapList,
+  ki as F0MapSidebar,
   Oi as F0MapSidebarToggle,
   Wi as F0MapSkeleton,
   H as F0Meeting,
@@ -79,8 +79,8 @@ export {
   w as F0MeetingRoom,
   G as F0MeetingSlot,
   U as F0MeetingSurface,
-  kt as F0NotesTextEditor,
-  vt as F0NotesTextEditorSkeleton,
+  vt as F0NotesTextEditor,
+  kt as F0NotesTextEditorSkeleton,
   Ot as F0NumberInput,
   Wt as F0NumberInputInline,
   _t as F0PhoneInput,
@@ -150,9 +150,9 @@ export {
   ri as ResourceHeader,
   js as RichTextDisplay,
   ni as RichTextEditor,
-  ha as SLOT_ROW_BLEED,
-  Ma as SLOT_SKELETON_ITEM_TESTID,
-  Ta as ScrollArea,
+  Ta as SLOT_ROW_BLEED,
+  ha as SLOT_SKELETON_ITEM_TESTID,
+  Ma as ScrollArea,
   Ia as SearchBar,
   li as SectionHeader,
   Xs as Select,
@@ -165,8 +165,8 @@ export {
   Ra as SidebarChatListSkeleton,
   ya as SidebarChatProvider,
   Da as SidebarCollapsibleSection,
-  ka as SidebarFooter,
-  va as SidebarHeader,
+  va as SidebarFooter,
+  ka as SidebarHeader,
   Oa as SidebarPanelHeader,
   Wa as SidebarRail,
   _a as SidebarTabPanel,
@@ -230,9 +230,9 @@ export {
   Pe as f0MeetingDisconnectReasons,
   Fe as f0MeetingPermissions,
   pe as f0MeetingPresences,
-  he as f0MeetingStatuses,
-  Me as f0MeetingSurfaceDestinations,
-  Te as f0MeetingSurfaceModes,
+  Te as f0MeetingStatuses,
+  he as f0MeetingSurfaceDestinations,
+  Me as f0MeetingSurfaceModes,
   Ie as f0MeetingTrackKinds,
   Ee as f0ProgressSeriesColors,
   Ae as f0ProgressSeriesSizes,
@@ -251,9 +251,9 @@ export {
   ye as isSystemMessage,
   De as isUserMessage,
   gt as isValidPhoneValue,
-  ke as layoutGrid,
-  hi as listIconColors,
-  ve as listMoreButtonClass,
+  ve as layoutGrid,
+  Ti as listIconColors,
+  ke as listMoreButtonClass,
   Oe as listSlot,
   We as locationInputSizes,
   _e as locationParts,
@@ -263,7 +263,7 @@ export {
   xe as oneListItemRowClassName,
   Ve as phoneInputSizes,
   we as placementFromRect,
-  Mi as predefinedPresets,
+  hi as predefinedPresets,
   Ge as railActionTones,
   ut as rangeSeparator,
   Ue as reorderForSpeakers,
@@ -273,7 +273,7 @@ export {
   je as resolveSlotRenderer,
   Xe as resolveWidgetHeader,
   Qe as seedFromStorage,
-  Ti as selectSizes,
+  Mi as selectSizes,
   Ii as selectVariants,
   Ye as settlePlacement,
   qe as slotRowBleed,
@@ -307,7 +307,7 @@ export {
   Fs as useTrackBinding,
   Bi as useWidgetIsWide,
   ps as viewportRect,
-  hs as widgetChrome,
-  Ms as widgetParamsAreComplete,
-  Ts as widgetTitle
+  Ts as widgetChrome,
+  hs as widgetParamsAreComplete,
+  Ms as widgetTitle
 };