@factorialco/f0-react 6.56.0 → 6.57.1

package/dist/experimental.d.ts

@@ -3582,8 +3582,8 @@ export declare type DateNavigationOptions = {
 };
 
 declare type DateNavigationOptions_2 = {
-    granularity?: GranularityDefinitionKey[] | GranularityDefinitionKey;
-    defaultGranularity?: GranularityDefinitionKey;
+    granularity?: NavigationGranularityKey[] | NavigationGranularityKey;
+    defaultGranularity?: NavigationGranularityKey;
     min?: Date;
     max?: Date;
     presets?: DatePreset[];
@@ -3616,14 +3616,14 @@ export declare type DatePeriodsDefinition = {
     periods: DatePeriod[];
 };
 
-declare type DatePickerCompareTo = Partial<Record<GranularityDefinitionKey, CompareToDef[]>>;
+declare type DatePickerCompareTo = Partial<Record<NavigationGranularityKey, CompareToDef[]>>;
 
 declare interface DatePickerPopupProps {
     onSelect?: (value: DatePickerValue | undefined) => void;
     value?: DatePickerValue;
     defaultValue?: DatePickerValue;
     presets?: DatePreset[];
-    granularities?: GranularityDefinitionKey[];
+    granularities?: NavigationGranularityKey[];
     minDate?: Date;
     maxDate?: Date;
     disabled?: boolean;
@@ -3648,7 +3648,7 @@ declare interface DatePickerPopupProps {
 
 export declare type DatePickerValue = {
     value: DateRangeComplete | undefined;
-    granularity: GranularityDefinitionKey;
+    granularity: NavigationGranularityKey;
 };
 
 export declare interface DatePreset {
@@ -3679,7 +3679,7 @@ export declare type DateStringFormat = "default" | "long";
 declare type DateValue = {
     value: DateRangeComplete;
     valueString: string;
-    granularity: GranularityDefinitionKey;
+    granularity: NavigationGranularityKey;
 };
 
 /**
@@ -8514,7 +8514,7 @@ export declare function generateCSVContent<R extends RecordType, Filters extends
  */
 export declare function getAutoPerPageMinHeight(rowHeight?: number): number;
 
-export declare const getGranularityDefinition: (granularityKey: GranularityDefinitionKey) => GranularityDefinition;
+export declare const getGranularityDefinition: (granularityKey: NavigationGranularityKey) => GranularityDefinition;
 
 /**
  * Get granularity definitions with week granularity configured with the specified weekStartsOn.
@@ -8528,7 +8528,7 @@ export declare const getGranularityDefinition: (granularityKey: GranularityDefin
  */
 export declare function getGranularityDefinitions(options?: WeekStartsOn | GranularityDefinitionsOptions): Record<string, GranularityDefinition>;
 
-export declare const getGranularitySimpleDefinition: (granularityKey: GranularityDefinitionKey) => GranularityDefinitionSimple;
+export declare const getGranularitySimpleDefinition: (granularityKey: NavigationGranularityKey) => GranularityDefinitionSimple;
 
 /**
  * Get the primaryActionsItems from the primaryActionsDefinition or the actions property
@@ -8600,7 +8600,6 @@ export declare const granularityDefinitions: {
     readonly halfyear: GranularityDefinition;
     readonly year: GranularityDefinition;
     readonly range: GranularityDefinition;
-    readonly periods: GranularityDefinition;
 };
 
 export declare type GranularityDefinitionSimple = Pick<GranularityDefinition, "toRangeString" | "toString">;
@@ -9046,6 +9045,13 @@ export declare interface HomeRenderCtx {
      * { slotRowBleed}).
      */
     isLastSlot?: boolean;
+    /**
+     * WHAT THE CARD IS SHOWING, when its header carries a `headerSelect`: the
+     * option the reader is on. A slot renderer that owns its own data reads this
+     * to fetch for it — the switcher is in the header, the fetching is here, and
+     * neither needs the host to hold the value.
+     */
+    selection?: string;
 }
 
 /**
@@ -9111,7 +9117,29 @@ export declare interface HomeSlotParamsMap {
  * `alert` and `status` are EXCLUSIVE — `Widget` throws when given both — so the
  * type says so rather than leaving it to blow up at runtime.
  */
-export declare type HomeWidgetChrome = Pick<WidgetProps, "action" | "summaries" | "headerControls"> & ({
+export declare type HomeWidgetChrome = Pick<WidgetProps, "action" | "summaries" | "headerControls"> & {
+    /**
+     * THE CARD'S OWN BUTTONS, in the header's top-right — as DATA, so a host that
+     * builds its widgets as data ("Write post", pointing at a route) can put one
+     * there without handing over a React node.
+     *
+     * `F0ButtonProps`, the same shape `action` takes, so a button can carry an
+     * `href` and be a real link. Drawn `ghost`/`sm` unless they say otherwise:
+     * this row is the TITLE's, and a filled button beside a title reads as the
+     * card's subject rather than as something you press.
+     *
+     * Keep it to one or two. What the card can do that needs no button belongs in
+     * `actions`, the overflow menu.
+     */
+    headerActions?: F0ButtonProps[];
+    /**
+     * WHAT THE CARD IS SHOWING, as a select in the same row — a scope switcher, as
+     * data. See {@link WidgetHeaderSelect}: `SlotWidget` keeps the choice and
+     * hands it to the slots as `ctx.selection`, so a widget declared as data can
+     * still be switched without its host holding the value.
+     */
+    headerSelect?: WidgetHeaderSelect;
+} & ({
     alert?: WidgetProps["alert"];
     status?: never;
 } | {
@@ -10312,6 +10340,16 @@ export declare type NavigationFiltersState<Definition extends Record<string, Nav
  */
 export declare type NavigationFilterValue<T> = T extends DateNavigatorFilterDefinition ? DateValue : T extends undefined ? undefined : never;
 
+/**
+ * The keys a date navigation can be set to. `periods` is not a member of the
+ * static record — it has no definition until a consumer supplies its ranges —
+ * so it widens only the types that can actually render it. Keeping it out of
+ * `GranularityDefinitionKey` is what stops it leaking into every exhaustive map
+ * over that key, in places (form-field presets, compare-to) where it can do
+ * nothing.
+ */
+export declare type NavigationGranularityKey = GranularityDefinitionKey | "periods";
+
 declare type NavigationItem = Pick<LinkProps, "href" | "exactMatch" | "onClick"> & {
     label: string;
 } & DataAttributes_2;
@@ -11819,6 +11857,13 @@ declare type RequisitionProfile = {
 
 export declare type ResolvedRecordType<R> = R extends RecordType ? R : RecordType;
 
+/**
+ * The definition behind a key with no consumer data to build it from. Only
+ * `periods` has one: its empty definition renders the "no periods" state, which
+ * is what a periods value without periods means.
+ */
+export declare const resolveGranularityDefinition: (key: NavigationGranularityKey) => GranularityDefinition;
+
 /** A renderer entry in its full form — a bare function is just its `render`. */
 export declare const resolveSlotRenderer: (entry: SlotRendererEntry | undefined) => {
     render: SlotRenderer;
@@ -12577,7 +12622,7 @@ export declare const slotRowBleed: (ctx: HomeRenderCtx) => string;
  */
 export declare type SlotSkeletonRenderer<P = unknown> = (params: P, ctx: HomeSkeletonCtx) => ReactNode;
 
-export declare function SlotWidget({ header, params, fullHeight, action, summaries, headerControls, alert, status, slots, loading, slotRenderers, actions, flipped, onFlipBack, isDragging, ctx, }: SlotWidgetProps): JSX_2.Element;
+export declare function SlotWidget({ header, params, fullHeight, action, summaries, headerControls, headerActions, headerSelect, alert, status, slots, loading, slotRenderers, actions, flipped, onFlipBack, isDragging, ctx, }: SlotWidgetProps): JSX_2.Element;
 
 /**
  * A widget's CONTENT: the slot stack, with the dividers between slots and the
@@ -14355,6 +14400,34 @@ export declare type WidgetEmptyStateProps = {
     actions?: Action_2[];
 };
 
+/**
+ * A SELECT IN THE WIDGET'S HEADER: which of several things the card is showing.
+ *
+ * The value lives in `SlotWidget`, not in the host — that is the point of it.
+ * A host that builds its widgets as plain data has nowhere to keep a live
+ * choice: params persist (and turn a switcher into a saved setting), and page
+ * state means the page knowing about one particular widget. So the card keeps
+ * it, hands it down to its slots (`ctx.selection`), and tells the host through
+ * `onChange` if it wants to know.
+ *
+ * It is therefore a SESSION choice: the card starts at `value` every time it
+ * mounts. A choice that should outlive the visit is a param, not this.
+ */
+export declare interface WidgetHeaderSelect {
+    /** What the reader can switch between. The first one is the default. */
+    options: Array<{
+        value: string;
+        label: string;
+        icon?: IconType;
+    }>;
+    /** Which one the card starts on. Defaults to the first option. */
+    value?: string;
+    /** The trigger names the selection, so this is what says what KIND it is. */
+    tooltip?: string;
+    /** Told when the reader picks another one. The card switches either way. */
+    onChange?: (value: string) => void;
+}
+
 export declare function WidgetHighlightButton({ label, count, icon, iconClassName, onClick, }: Props_7): JSX_2.Element;
 
 export declare function WidgetInboxList({ items, minSize, onClickItem, showAllItems, onVisibleItemsChange, }: Props_9): JSX_2.Element;
@@ -14727,18 +14800,6 @@ declare module "@tiptap/core" {
 }
 
 
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number, options?: {
-                placeholder?: string;
-            }) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
-        };
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         fontSize: {
@@ -14760,6 +14821,18 @@ declare module "@tiptap/core" {
 }
 
 
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number, options?: {
+                placeholder?: string;
+            }) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
+        };
+    }
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         moodTracker: {

package/dist/experimental.js

@@ -1,22 +1,22 @@
-import { t as s, s as t, A as i, a as o, I as r, aq as n, ap as l, ar as d, B as S, v as C, x as g, K as m, ax as u, ay as c, aH as b, w as h, C as P, aw as p, aI as T, z as I, y as F, a2 as E, b0 as A, b7 as B, J as y, a$ as L, E as D, b as W, af as k, ag as v, D as O, am as _, F as x, i as N, l as R, n as f, j as H, c as M, p as V, q as w, H as G, aL as z, aM as U, aA as j, al as Y, aQ as q, as as K, a5 as X, aK as J, T as Q, ab as $, O as Z, bb as aa, U as ea, P as sa, L as ta, M as ia, at as oa, R as ra, aZ as na, b1 as la, S as da, a6 as Sa, a7 as Ca, Z as ga, _ as ma, $ as ua, Y as ca, a0 as ba, V as ha, a1 as Pa, a3 as pa, a4 as Ta, a8 as Ia, a9 as Fa, b5 as Ea, b4 as Aa, ao as Ba, an as ya, av as La, aJ as Da, aG as Wa, au as ka, aa as va, aB as Oa, b6 as _a, b9 as xa, az as Na, aE as Ra, aC as fa, ba as Ha, aF as Ma, aD as Va, b8 as wa, d as Ga, ae as za, b3 as Ua, b2 as ja, ai as Ya, f as qa, k as Ka, o as Xa, g as Ja, h as Qa, aT as $a, aR as Za, aj as ae, ak as ee, aP as se, aS as te, e as ie, r as oe, aX as re, aO as ne, aU as le, ac as de, a_ as Se, u as Ce, ad as ge, ah as me, aN as ue, Q as ce, N as be, G as he, X as Pe, W as pe, aY as Te, aW as Ie, aV as Fe } from "./experimental-KRMYiuya.js";
-import { dN as Ae, eo as Be, en as ye, eA as Le, dk as De, el as We, cd as ke, c3 as ve, ca as Oe, eg as _e, bY as xe, bY as Ne, bR as Re, eh as fe, cg as He, d_ as Me, ci as Ve, eD as we, em as Ge, ew as ze, ex as Ue, d5 as je, eB as Ye, k as qe, dO as Ke, cM as Xe, ek as Je, eq as Qe, ep as $e, T as Ze, h as as, bS as es, ey as ss, eE as ts, ez as is, eC as os, ev as rs, es as ns, eu as ls, er as ds, ei as Ss, ej as Cs, ec as gs, et as ms } from "./F0CanvasPanel-BUG53OPZ.js";
-import { aw as cs, ax as bs, a5 as hs, a6 as Ps, a3 as ps, ag as Ts, C as Is, a7 as Fs, aI as Es, ac as As, aH as Bs, af as ys, a4 as Ls, au as Ds, aK as Ws, aJ as ks, am as vs, ah as Os, ap as _s, aN as xs, a2 as Ns, ar as Rs, ao as fs, aj as Hs, aP as Ms, ak as Vs, as as ws, at as Gs, a8 as zs, aL as Us, aM as js, al as Ys, av as qs, aE as Ks, O as Xs, aG as Js, a9 as Qs, aR as $s, ab as Zs, ad as at, ap as et, aO as st, aq as tt, an as it, aQ as ot, aa as rt, W as nt, ae as lt, a1 as dt, $ as St, a0 as Ct, aA as gt, aB as mt, ay as ut, aF as ct, ai as bt, aC as ht, l as Pt, az as pt, aD as Tt, y as It } from "./CoachmarkProvider-C7PonJWi.js";
+import { t as s, s as t, A as i, a as o, I as r, aq as n, ap as l, ar as d, B as S, v as C, x as g, K as m, ax as u, ay as c, aH as b, w as h, C as P, aw as p, aI as T, z as F, y as I, a2 as E, b0 as A, b7 as B, J as y, a$ as L, E as D, b as W, af as k, ag as v, D as O, am as _, F as f, i as x, l as N, n as R, j as H, c as M, p as V, q as w, H as G, aL as z, aM as U, aA as j, al as Y, aQ as q, as as K, a5 as X, aK as J, T as Q, ab as $, O as Z, bb as aa, U as ea, P as sa, L as ta, M as ia, at as oa, R as ra, aZ as na, b1 as la, S as da, a6 as Sa, a7 as Ca, Z as ga, _ as ma, $ as ua, Y as ca, a0 as ba, V as ha, a1 as Pa, a3 as pa, a4 as Ta, a8 as Fa, a9 as Ia, b5 as Ea, b4 as Aa, ao as Ba, an as ya, av as La, aJ as Da, aG as Wa, au as ka, aa as va, aB as Oa, b6 as _a, b9 as fa, az as xa, aE as Na, aC as Ra, ba as Ha, aF as Ma, aD as Va, b8 as wa, d as Ga, ae as za, b3 as Ua, b2 as ja, ai as Ya, f as qa, k as Ka, o as Xa, g as Ja, h as Qa, aT as $a, aR as Za, aj as ae, ak as ee, aP as se, aS as te, e as ie, r as oe, aX as re, aO as ne, aU as le, ac as de, a_ as Se, u as Ce, ad as ge, ah as me, aN as ue, Q as ce, N as be, G as he, X as Pe, W as pe, aY as Te, aW as Fe, aV as Ie } from "./experimental-DBE84eYE.js";
+import { dN as Ae, eo as Be, en as ye, eB as Le, dk as De, el as We, cd as ke, c3 as ve, ca as Oe, eg as _e, bY as fe, bY as xe, bR as Ne, eh as Re, cg as He, d_ as Me, ci as Ve, eE as we, em as Ge, ex as ze, ey as Ue, d5 as je, eC as Ye, k as qe, dO as Ke, cM as Xe, ek as Je, eq as Qe, ep as $e, T as Ze, h as as, bS as es, ez as ss, eF as ts, eA as is, eD as os, ew as rs, et as ns, ev as ls, er as ds, ei as Ss, ej as Cs, ec as gs, eu as ms, es as us } from "./F0CanvasPanel-CZf80ymn.js";
+import { aw as bs, ax as hs, a5 as Ps, a6 as ps, a3 as Ts, ag as Fs, C as Is, a7 as Es, aI as As, ac as Bs, aH as ys, af as Ls, a4 as Ds, au as Ws, aK as ks, aJ as vs, am as Os, ah as _s, ap as fs, aN as xs, a2 as Ns, ar as Rs, ao as Hs, aj as Ms, aP as Vs, ak as ws, as as Gs, at as zs, a8 as Us, aL as js, aM as Ys, al as qs, av as Ks, aE as Xs, O as Js, aG as Qs, a9 as $s, aR as Zs, ab as at, ad as et, ap as st, aO as tt, aq as it, an as ot, aQ as rt, aa as nt, W as lt, ae as dt, a1 as St, $ as Ct, a0 as gt, aA as mt, aB as ut, ay as ct, aF as bt, ai as ht, aC as Pt, l as pt, az as Tt, aD as Ft, y as It } from "./CoachmarkProvider-B8wLEqxh.js";
 export {
-  cs as AUTO_PER_PAGE_MAX,
-  bs as AUTO_PER_PAGE_MIN_RESERVED_ROWS,
+  bs as AUTO_PER_PAGE_MAX,
+  hs as AUTO_PER_PAGE_MIN_RESERVED_ROWS,
   s as ActivityItemList,
   t as ActivityItemListSkeleton,
   i as AiPromotionChat,
   o as AiPromotionChatProvider,
   r as ApplicationFrame,
-  hs as AreaChart,
+  Ps as AreaChart,
   n as AreaChartWidget,
   l as AutoGrid,
   Ae as Badge,
-  Ps as BarChart,
+  ps as BarChart,
   d as BarChartWidget,
   S as BaseActivityItemList,
-  ps as BaseBanner,
+  Ts as BaseBanner,
   C as BaseCelebration,
   g as BaseCommunityPost,
   Be as BaseTabs,
@@ -24,19 +24,19 @@ export {
   m as Breadcrumbs,
   u as CalendarEvent,
   c as CalendarEventList,
-  Ts as CardSelectableContainer,
+  Fs as CardSelectableContainer,
   Is as Carousel,
-  Fs as CategoryBarChart,
+  Es as CategoryBarChart,
   b as CategoryBarSection,
   h as Celebration,
   P as CelebrationSkeleton,
   p as ChartWidgetEmptyState,
   Le as Chip,
   T as ClockInControls,
-  Es as CoachmarkProvider,
-  As as ComboChart,
-  I as CommunityPost,
-  F as CommunityPostSkeleton,
+  As as CoachmarkProvider,
+  Bs as ComboChart,
+  F as CommunityPost,
+  I as CommunityPostSkeleton,
   E as CompanySelector,
   De as Counter,
   A as DEFAULT_EXPECTED_ITEMS_COUNT,
@@ -44,72 +44,72 @@ export {
   y as DaytimePage,
   We as DetailsItem,
   ke as DetailsItemsList,
-  Bs as Dialog,
+  ys as Dialog,
   ve as Dropdown,
   L as EVENT_LIST_GAP,
   D as EntitySelect,
-  ys as F0ActionBar,
-  Ls as F0AiBanner,
+  Ls as F0ActionBar,
+  Ds as F0AiBanner,
   Oe as F0AvatarModule,
   _e as F0ButtonToggle,
   W as F0Callout,
-  xe as F0CardHorizontal,
-  Ne as F0CardRow,
+  fe as F0CardHorizontal,
+  xe as F0CardRow,
   k as F0Chat,
   v as F0ChatProvider,
   O as F0CommunityPostsCarousel,
   _ as F0ENPSButton,
-  x as F0EmojiPicker,
-  Re as F0FileItem,
-  Ds as F0FormEditableTable,
-  N as F0Map,
-  R as F0MapControls,
-  f as F0MapList,
+  f as F0EmojiPicker,
+  Ne as F0FileItem,
+  Ws as F0FormEditableTable,
+  x as F0Map,
+  N as F0MapControls,
+  R as F0MapList,
   H as F0MapSkeleton,
   M as F0MeetingCard,
-  Ws as F0NotesTextEditor,
-  ks as F0NotesTextEditorSkeleton,
-  vs as F0NumberInput,
-  Os as F0PhoneInput,
-  fe as F0ProgressSeries,
-  _s as F0ResourceHeader,
+  ks as F0NotesTextEditor,
+  vs as F0NotesTextEditorSkeleton,
+  Os as F0NumberInput,
+  _s as F0PhoneInput,
+  Re as F0ProgressSeries,
+  fs as F0ResourceHeader,
   He as F0RichTextDisplay,
   xs as F0RichTextEditor,
   Me as F0SearchInput,
   V as F0SegmentedBar,
   Ns as F0SegmentedControl,
   Rs as F0TableOfContent,
-  fs as F0TextAreaInput,
+  Hs as F0TextAreaInput,
   Ve as F0TextInput,
   w as F0VersionHistory,
-  Hs as F1SearchBox,
-  Ms as FILE_TYPES,
+  Ms as F1SearchBox,
+  Vs as FILE_TYPES,
   we as FileItem,
   G as HighlightBanner,
   z as HomeSlotItem,
   U as HomeSlotItems,
   j as IndicatorsList,
-  Vs as Input,
-  ws as Item,
-  Gs as ItemSectionHeader,
+  ws as Input,
+  Gs as Item,
+  zs as ItemSectionHeader,
   Y as LATEST,
   q as LIST_COMPACT_AFTER,
-  zs as LineChart,
+  Us as LineChart,
   K as LineChartWidget,
   X as Menu,
   Ge as MobileDropdown,
   J as NewHomeLayout,
-  Us as NotesTextEditor,
-  js as NotesTextEditorSkeleton,
-  Ys as NumberInput,
+  js as NotesTextEditor,
+  Ys as NotesTextEditorSkeleton,
+  qs as NumberInput,
   Q as OmniButton,
   $ as OneApprovalHistory,
   ze as OneCalendar,
   Ue as OneCalendarInternal,
-  qs as OneDataCollection,
-  Ks as OneDateNavigator,
-  Xs as OneEmptyState,
-  Js as OnePagination,
+  Ks as OneDataCollection,
+  Xs as OneDateNavigator,
+  Js as OneEmptyState,
+  Qs as OnePagination,
   Z as OnePersonListItem,
   aa as OneRestrictComponent,
   ea as Page,
@@ -117,20 +117,20 @@ export {
   ta as PageHeaderNavigationContext,
   ia as PageHeaderNavigationProvider,
   je as PageNavigation,
-  Qs as PieChart,
+  $s as PieChart,
   oa as PieChartWidget,
-  $s as PrivateBox,
-  Zs as ProgressBarChart,
-  at as RadarChart,
+  Zs as PrivateBox,
+  at as ProgressBarChart,
+  et as RadarChart,
   ra as Reactions,
-  et as ResourceHeader,
+  st as ResourceHeader,
   Ye as RichTextDisplay,
-  st as RichTextEditor,
+  tt as RichTextEditor,
   na as SLOT_ROW_BLEED,
   la as SLOT_SKELETON_ITEM_TESTID,
   da as ScrollArea,
   Sa as SearchBar,
-  tt as SectionHeader,
+  it as SectionHeader,
   qe as Select,
   Ke as Shortcut,
   Ca as Sidebar,
@@ -143,8 +143,8 @@ export {
   Pa as SidebarCollapsibleSection,
   pa as SidebarFooter,
   Ta as SidebarHeader,
-  Ia as SidebarTabPanel,
-  Fa as SidebarTabs,
+  Fa as SidebarTabPanel,
+  Ia as SidebarTabs,
   Ea as SlotWidget,
   Aa as SlotWidgetContent,
   Xe as Spinner,
@@ -155,38 +155,38 @@ export {
   Qe as Tabs,
   $e as TabsSkeleton,
   Da as TasksList,
-  it as Textarea,
+  ot as Textarea,
   Ze as ToggleGroup,
   as as ToggleGroupItem,
   es as Tooltip,
   Wa as TwoColumnsList,
-  ot as UPLOAD_INPUT_ID,
-  rt as VerticalBarChart,
+  rt as UPLOAD_INPUT_ID,
+  nt as VerticalBarChart,
   ka as VerticalBarChartWidget,
   va as VirtualList,
   ss as WeekStartDay,
   ts as Weekdays,
-  nt as Widget,
+  lt as Widget,
   Oa as WidgetAvatarsListItem,
   _a as WidgetCatalog,
-  xa as WidgetEmptyState,
-  Na as WidgetHighlightButton,
-  Ra as WidgetInboxList,
-  fa as WidgetInboxListItem,
+  fa as WidgetEmptyState,
+  xa as WidgetHighlightButton,
+  Na as WidgetInboxList,
+  Ra as WidgetInboxListItem,
   Ha as WidgetSection,
   Ma as WidgetSimpleList,
   Va as WidgetSimpleListItem,
   wa as WidgetStrip,
-  lt as actionBarStatuses,
+  dt as actionBarStatuses,
   Ga as attendeesDisplays,
-  dt as buttonToggleColors,
-  St as buttonToggleSizes,
-  Ct as buttonToggleVariants,
+  St as buttonToggleColors,
+  Ct as buttonToggleSizes,
+  gt as buttonToggleVariants,
   is as chipVariants,
   za as coachmarks,
   Ua as defaultSlotRenderers,
   ja as defaultSlotSkeleton,
-  gt as downloadAsCSV,
+  mt as downloadAsCSV,
   Ya as f0ChatSenderColors,
   qa as f0EmojiPickerSizes,
   os as f0FileItemSizes,
@@ -195,8 +195,8 @@ export {
   Ja as f0ProgressSeriesColors,
   Qa as f0ProgressSeriesSizes,
   $a as fromParams,
-  mt as generateCSVContent,
-  ut as getAutoPerPageMinHeight,
+  ut as generateCSVContent,
+  ct as getAutoPerPageMinHeight,
   rs as getGranularityDefinition,
   ns as getGranularityDefinitions,
   ls as getGranularitySimpleDefinition,
@@ -211,21 +211,22 @@ export {
   ie as meetingStates,
   gs as modules,
   oe as phoneInputSizes,
-  ct as predefinedPresets,
+  bt as predefinedPresets,
   re as railActionTones,
   ms as rangeSeparator,
+  us as resolveGranularityDefinition,
   ne as resolveSlotRenderer,
   le as resolveWidgetHeader,
   de as seedFromStorage,
-  bt as selectSizes,
+  ht as selectSizes,
   Se as slotRowBleed,
   Ce as useAiPromotionChat,
-  ht as useDataCollectionData,
+  Pt as useDataCollectionData,
   ge as useDataCollectionItemNavigation,
-  Pt as useDataCollectionSource,
-  pt as useExportAction,
+  pt as useDataCollectionSource,
+  Tt as useExportAction,
   me as useF0Chat,
-  Tt as useInfiniteScrollPagination,
+  Ft as useInfiniteScrollPagination,
   ue as useIsBulkChange,
   ce as usePageHeaderItemNavigation,
   be as usePageHeaderNavigation,
@@ -234,6 +235,6 @@ export {
   pe as useSidebarChats,
   It as useWidgetIsWide,
   Te as widgetChrome,
-  Ie as widgetParamsAreComplete,
-  Fe as widgetTitle
+  Fe as widgetParamsAreComplete,
+  Ie as widgetTitle
 };

package/dist/f0.d.ts

@@ -4448,8 +4448,8 @@ export declare type DateNavigationOptions = {
 };
 
 declare type DateNavigationOptions_2 = {
-    granularity?: GranularityDefinitionKey[] | GranularityDefinitionKey;
-    defaultGranularity?: GranularityDefinitionKey;
+    granularity?: NavigationGranularityKey[] | NavigationGranularityKey;
+    defaultGranularity?: NavigationGranularityKey;
     min?: Date;
     max?: Date;
     presets?: DatePreset[];
@@ -4482,14 +4482,14 @@ export declare type DatePeriodsDefinition = {
     periods: DatePeriod[];
 };
 
-declare type DatePickerCompareTo = Partial<Record<GranularityDefinitionKey, CompareToDef[]>>;
+declare type DatePickerCompareTo = Partial<Record<NavigationGranularityKey, CompareToDef[]>>;
 
 declare interface DatePickerPopupProps {
     onSelect?: (value: DatePickerValue_2 | undefined) => void;
     value?: DatePickerValue_2;
     defaultValue?: DatePickerValue_2;
     presets?: DatePreset[];
-    granularities?: GranularityDefinitionKey[];
+    granularities?: NavigationGranularityKey[];
     minDate?: Date;
     maxDate?: Date;
     disabled?: boolean;
@@ -4518,7 +4518,7 @@ export declare type DatePickerValue = DatePickerValue_2;
 
 declare type DatePickerValue_2 = {
     value: DateRangeComplete | undefined;
-    granularity: GranularityDefinitionKey;
+    granularity: NavigationGranularityKey;
 };
 
 export declare interface DatePreset {
@@ -4606,7 +4606,7 @@ export declare type DateStringFormat = "default" | "long";
 declare type DateValue = {
     value: DateRangeComplete;
     valueString: string;
-    granularity: GranularityDefinitionKey;
+    granularity: NavigationGranularityKey;
 };
 
 declare type DefaultAction = BannerAction;
@@ -9699,7 +9699,9 @@ export declare const F0DatePicker: WithDataTestIdReturnType_3<typeof F0DatePicke
 
 declare function F0DatePicker_2({ onChange, value, presets, granularities, minDate, maxDate, open, showIcon, displayFormat, selectOnCellOnly, ...inputProps }: F0DatePickerProps): JSX_2.Element;
 
-export declare type F0DatePickerProps = Pick<DatePickerPopupProps, "granularities" | "minDate" | "maxDate" | "presets" | "open" | "onOpenChange" | "selectOnCellOnly"> & {
+export declare type F0DatePickerProps = Pick<DatePickerPopupProps, "minDate" | "maxDate" | "presets" | "open" | "onOpenChange" | "selectOnCellOnly"> & {
+    /** The picker has no `periods` prop, so it can only offer the calendar granularities. */
+    granularities?: GranularityDefinitionKey[];
     showIcon?: boolean;
     /** Controls how the selected date is displayed in the input. Defaults to "long" (e.g. "01 Aug 2025"). Use "default" for dd/MM/yyyy. */
     displayFormat?: DateStringFormat;
@@ -13934,7 +13936,7 @@ export declare function getEmojiLabel(emoji: string): string;
  */
 export declare function getF0Config(schema: ZodTypeAny): F0FieldConfig | undefined;
 
-export declare const getGranularityDefinition: (granularityKey: GranularityDefinitionKey) => GranularityDefinition;
+export declare const getGranularityDefinition: (granularityKey: NavigationGranularityKey) => GranularityDefinition;
 
 /**
  * Get granularity definitions with week granularity configured with the specified weekStartsOn.
@@ -13948,7 +13950,7 @@ export declare const getGranularityDefinition: (granularityKey: GranularityDefin
  */
 export declare function getGranularityDefinitions(options?: WeekStartsOn | GranularityDefinitionsOptions): Record<string, GranularityDefinition>;
 
-export declare const getGranularitySimpleDefinition: (granularityKey: GranularityDefinitionKey) => GranularityDefinitionSimple;
+export declare const getGranularitySimpleDefinition: (granularityKey: NavigationGranularityKey) => GranularityDefinitionSimple;
 
 /**
  * Non-hook version for extracting definition outside of React components.
@@ -14008,7 +14010,6 @@ export declare const granularityDefinitions: {
     readonly halfyear: GranularityDefinition;
     readonly year: GranularityDefinition;
     readonly range: GranularityDefinition;
-    readonly periods: GranularityDefinition;
 };
 
 export declare type GranularityDefinitionSimple = Pick<GranularityDefinition, "toRangeString" | "toString">;
@@ -15534,6 +15535,16 @@ declare type NavigationFiltersState<Definition extends Record<string, Navigation
  */
 declare type NavigationFilterValue<T> = T extends DateNavigatorFilterDefinition ? DateValue : T extends undefined ? undefined : never;
 
+/**
+ * The keys a date navigation can be set to. `periods` is not a member of the
+ * static record — it has no definition until a consumer supplies its ranges —
+ * so it widens only the types that can actually render it. Keeping it out of
+ * `GranularityDefinitionKey` is what stops it leaking into every exhaustive map
+ * over that key, in places (form-field presets, compare-to) where it can do
+ * nothing.
+ */
+export declare type NavigationGranularityKey = GranularityDefinitionKey | "periods";
+
 declare type NavigationItem = Pick<LinkProps, "href" | "exactMatch" | "onClick"> & {
     label: string;
 } & DataAttributes_2;
@@ -17130,6 +17141,13 @@ export declare interface ResolvedStepAnswer {
     cancelled?: boolean;
 }
 
+/**
+ * The definition behind a key with no consumer data to build it from. Only
+ * `periods` has one: its empty definition renders the "no periods" state, which
+ * is what a periods value without periods means.
+ */
+export declare const resolveGranularityDefinition: (key: NavigationGranularityKey) => GranularityDefinition;
+
 /**
  * Normalizes the three `fetchItemNeighbors` return channels (sync value,
  * Promise, Observable of PromiseState) into a single one-shot Promise.
@@ -20250,18 +20268,6 @@ declare module "@tiptap/core" {
 }
 
 
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number, options?: {
-                placeholder?: string;
-            }) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
-        };
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         fontSize: {
@@ -20283,6 +20289,18 @@ declare module "@tiptap/core" {
 }
 
 
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number, options?: {
+                placeholder?: string;
+            }) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
+        };
+    }
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         moodTracker: {