@factorialco/f0-react 4.66.2 → 4.68.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -38,6 +38,7 @@ import { DotTagCellValue } from './types/dotTag';
38
38
  import { DotTagCellValue as DotTagCellValue_2 } from './experimental';
39
39
  import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
40
40
  import { EmployeeItemProps } from './types';
41
+ import { F0EmojiPickerProps as F0EmojiPickerProps_2 } from './types';
41
42
  import { F0SegmentedControlProps as F0SegmentedControlProps_2 } from './types';
42
43
  import { F0SelectProps as F0SelectProps_2 } from './types';
43
44
  import { F0TagBalanceProps as F0TagBalanceProps_2 } from './types';
@@ -811,7 +812,7 @@ declare type Approver = {
811
812
  status: Status;
812
813
  };
813
814
 
814
- export declare const AreaChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig> & {
815
+ export declare const AreaChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig> & {
815
816
  lineType?: "step" | "linear" | "natural" | "monotoneX";
816
817
  marginTop?: number;
817
818
  canBeBlurred?: boolean;
@@ -940,7 +941,7 @@ export declare type BannerAction = {
940
941
  icon?: IconType;
941
942
  };
942
943
 
943
- export declare const BarChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig> & {
944
+ export declare const BarChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig> & {
944
945
  type?: "simple" | "stacked" | "stacked-by-sign";
945
946
  label?: boolean;
946
947
  legend?: boolean;
@@ -1008,7 +1009,7 @@ declare type BaseAvatarProps = {
1008
1009
 
1009
1010
  declare type BaseAvatarProps_2 = ComponentProps<typeof BaseAvatar>;
1010
1011
 
1011
- export declare const BaseBanner: WithDataTestIdReturnType_3<ForwardRefExoticComponent<BaseBannerProps & RefAttributes<HTMLDivElement>> & {
1012
+ export declare const BaseBanner: WithDataTestIdReturnType_4<ForwardRefExoticComponent<BaseBannerProps & RefAttributes<HTMLDivElement>> & {
1012
1013
  Skeleton: ForwardRefExoticComponent<RefAttributes<HTMLDivElement>>;
1013
1014
  }>;
1014
1015
 
@@ -1950,7 +1951,7 @@ declare type CardVisualizationOptions<T, _Filters extends FiltersDefinition, _So
1950
1951
  /**
1951
1952
  * @experimental This is an experimental component use it at your own risk
1952
1953
  */
1953
- export declare const Carousel: WithDataTestIdReturnType_5<({ children, columns, showArrows, showDots, autoplay, delay, showPeek, doubleColumns, }: CarouselProps) => default_2.JSX.Element>;
1954
+ export declare const Carousel: WithDataTestIdReturnType_3<({ children, columns, showArrows, showDots, autoplay, delay, showPeek, doubleColumns, }: CarouselProps) => default_2.JSX.Element>;
1954
1955
 
1955
1956
  declare interface CarouselBreakpoints {
1956
1957
  default?: ColumnNumber;
@@ -1975,7 +1976,7 @@ declare interface CarouselProps {
1975
1976
  }[];
1976
1977
  }
1977
1978
 
1978
- export declare const CategoryBarChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<CategoryBarProps & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
1979
+ export declare const CategoryBarChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<CategoryBarProps & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
1979
1980
 
1980
1981
  declare interface CategoryBarProps_2 {
1981
1982
  data: {
@@ -2032,7 +2033,7 @@ declare interface ChartComputation {
2032
2033
  /**
2033
2034
  * @experimental This is an experimental component use it at your own risk
2034
2035
  */
2035
- export declare const ChartWidgetEmptyState: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Props_6 & RefAttributes<HTMLDivElement>>>;
2036
+ export declare const ChartWidgetEmptyState: WithDataTestIdReturnType_3<ForwardRefExoticComponent<Props_6 & RefAttributes<HTMLDivElement>>>;
2036
2037
 
2037
2038
  declare interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
2038
2039
  type: "bar";
@@ -2439,7 +2440,7 @@ declare const columnWidths: {
2439
2440
  readonly fit: 1;
2440
2441
  };
2441
2442
 
2442
- export declare const ComboChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig> & {
2443
+ export declare const ComboChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig> & {
2443
2444
  label?: boolean;
2444
2445
  legend?: boolean;
2445
2446
  showValueUnderLabel?: boolean;
@@ -3120,7 +3121,7 @@ declare type DateValue = {
3120
3121
  /**
3121
3122
  * @experimental This is an experimental component use it at your own risk
3122
3123
  */
3123
- export declare const DaytimePage: WithDataTestIdReturnType_5<typeof _DaytimePage>;
3124
+ export declare const DaytimePage: WithDataTestIdReturnType_3<typeof _DaytimePage>;
3124
3125
 
3125
3126
  declare function _DaytimePage({ children, header, period, embedded, hideOneSwitch, }: DaytimePageProps): JSX_2.Element;
3126
3127
 
@@ -3761,7 +3762,9 @@ declare const defaultTranslations: {
3761
3762
  readonly cancelRecording: "Cancel recording";
3762
3763
  readonly dropFilesHere: "Drop your files here";
3763
3764
  readonly removeFile: "Remove";
3765
+ readonly removeNamedFile: "Remove {{name}}";
3764
3766
  readonly tooManyFilesError: "You can attach up to {{maxFiles}} files at once";
3767
+ readonly fileTooLargeError: "Each file must be {{maxFileSize}} or smaller";
3765
3768
  readonly fileUploadError: "Upload failed";
3766
3769
  readonly micPermissionDenied: "Microphone access is blocked. Allow it in your browser settings to dictate.";
3767
3770
  readonly micError: "Couldn't access the microphone.";
@@ -3797,6 +3800,7 @@ declare const defaultTranslations: {
3797
3800
  readonly reply: "Reply";
3798
3801
  readonly react: "Add reaction";
3799
3802
  readonly download: "Download";
3803
+ readonly downloadNamedFile: "Download {{name}}";
3800
3804
  readonly removeQuote: "Remove quote";
3801
3805
  readonly edit: "Edit";
3802
3806
  readonly editing: "Editing";
@@ -3810,7 +3814,10 @@ declare const defaultTranslations: {
3810
3814
  readonly previousImage: "Previous image";
3811
3815
  readonly nextImage: "Next image";
3812
3816
  readonly openDocument: "Open document";
3817
+ readonly openNamedDocument: "Open {{name}}";
3813
3818
  readonly documentPreview: "Document preview";
3819
+ readonly videoPlayerLabel: "Video player: {{name}}";
3820
+ readonly loadingVideo: "Loading video: {{name}}";
3814
3821
  readonly photo: "Photo";
3815
3822
  readonly photoCount: {
3816
3823
  readonly one: "{{count}} photo";
@@ -4165,7 +4172,7 @@ export declare interface DeleteBlockNotesTextEditorPageDocumentPatch {
4165
4172
  /**
4166
4173
  * @experimental This is an experimental component use it at your own risk
4167
4174
  */
4168
- export declare const DetailsItem: WithDataTestIdReturnType_5<ForwardRefExoticComponent<DetailsItemType & RefAttributes<HTMLDivElement>>>;
4175
+ export declare const DetailsItem: WithDataTestIdReturnType_3<ForwardRefExoticComponent<DetailsItemType & RefAttributes<HTMLDivElement>>>;
4169
4176
 
4170
4177
  export declare type DetailsItemContent = (ComponentProps<typeof DataList.Item> & {
4171
4178
  type: "item";
@@ -4782,7 +4789,7 @@ declare interface F0AlertProps {
4782
4789
  onClose?: () => void;
4783
4790
  }
4784
4791
 
4785
- declare const F0AvatarAlert: WithDataTestIdReturnType_5<({ type, size, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, }: AlertAvatarProps_2) => JSX_2.Element>;
4792
+ declare const F0AvatarAlert: WithDataTestIdReturnType_3<({ type, size, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, }: AlertAvatarProps_2) => JSX_2.Element>;
4786
4793
 
4787
4794
  declare type F0AvatarCompanyProps = {
4788
4795
  name: string;
@@ -4878,7 +4885,7 @@ declare type F0AvatarListPropsAvatars = {
4878
4885
  avatars: (Omit<FileAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
4879
4886
  };
4880
4887
 
4881
- export declare const F0AvatarModule: WithDataTestIdReturnType_5<typeof F0AvatarModule_2>;
4888
+ export declare const F0AvatarModule: WithDataTestIdReturnType_3<typeof F0AvatarModule_2>;
4882
4889
 
4883
4890
  /**
4884
4891
  * Module avatar
@@ -5186,7 +5193,11 @@ export declare type F0ChatChannel = {
5186
5193
  * factorial sources these from its own data (e.g. HR vacation status).
5187
5194
  */
5188
5195
  statuses?: F0ChatChannelStatus[];
5189
- /** Group only. */
5196
+ /**
5197
+ * Group only. Total channel members, including the current user. F0 compares
5198
+ * `memberCount - 1` with the unique other members in `readBy` (or its count
5199
+ * fallback) before showing the all-read footer state.
5200
+ */
5190
5201
  memberCount?: number;
5191
5202
  /** DM only — the counterpart, used for the header identity hover card. */
5192
5203
  user?: F0ChatUser;
@@ -5221,6 +5232,17 @@ export declare type F0ChatFileAttachment = {
5221
5232
  name: string;
5222
5233
  size?: number;
5223
5234
  mimeType?: string;
5235
+ /** Poster used when a video file renders through the inline F0VideoPlayer. */
5236
+ thumbnailUrl?: string;
5237
+ /**
5238
+ * Optional captions/audio-description sources for video files. Passed
5239
+ * directly to F0VideoPlayer; ignored for non-video files.
5240
+ */
5241
+ videoContent?: VideoPlayerContent;
5242
+ /** Initial locale for localized video audio and accessibility content. */
5243
+ videoDefaultLanguage?: string;
5244
+ /** Declare that a video file has no audio, so captions are not required. */
5245
+ videoSilent?: boolean;
5224
5246
  /** 0–100 while uploading; undefined once done. */
5225
5247
  progress?: number;
5226
5248
  };
@@ -5353,9 +5375,14 @@ export declare type F0ChatMessage = {
5353
5375
  */
5354
5376
  mentionedEveryone?: boolean;
5355
5377
  /**
5356
- * Group read receipts — how many other members have read this message.
5357
- * Approximated by counting members whose last-read pointer is at/after this
5358
- * message (Stream exposes no per-message reader list).
5378
+ * Group read receipts — the other members who have read this message.
5379
+ * Hosts derive this from their transport's per-member read pointers.
5380
+ */
5381
+ readBy?: F0ChatUser[];
5382
+ /**
5383
+ * Group read-receipt count for hosts that cannot provide reader identities.
5384
+ * Prefer `readBy` when identities are available; F0 derives its count from
5385
+ * `readBy.length`.
5359
5386
  */
5360
5387
  readByCount?: number;
5361
5388
  /**
@@ -5388,7 +5415,10 @@ export declare type F0ChatMessageReply = {
5388
5415
  * shows a tappable critical alert whose menu is reduced to Retry / Delete.
5389
5416
  * `delivered` (reached the counterpart's device, not read yet) is for backends
5390
5417
  * that distinguish it — Stream doesn't, so the factorial adapter never emits it
5391
- * and those messages go straight from `sent` to `read`.
5418
+ * and those messages go straight from `sent` to `read`. In groups, `read`
5419
+ * should only be emitted when all other channel members have read the message;
5420
+ * F0 also guards that transition with `channel.memberCount` and the available
5421
+ * `readBy` / `readByCount`.
5392
5422
  */
5393
5423
  export declare type F0ChatMessageStatus = "sending" | "sent" | "delivered" | "read" | "failed";
5394
5424
 
@@ -5422,6 +5452,10 @@ export declare type F0ChatReaction = {
5422
5452
  emoji: string;
5423
5453
  count: number;
5424
5454
  reactedByMe: boolean;
5455
+ /**
5456
+ * People who reacted with this emoji. Hosts may omit this initial list and
5457
+ * provide {@link F0ChatRuntime.loadReactionUsers} to resolve it lazily.
5458
+ */
5425
5459
  users?: F0ChatUser[];
5426
5460
  };
5427
5461
 
@@ -5482,6 +5516,13 @@ export declare type F0ChatRuntime = {
5482
5516
  retryMessage: (id: string) => void | Promise<void>;
5483
5517
  loadOlder: () => void;
5484
5518
  toggleReaction: (messageId: string, emoji: string) => void | Promise<void>;
5519
+ /**
5520
+ * Resolve the complete user list for one reaction on demand. F0 calls this
5521
+ * when the reaction receives pointer hover or keyboard focus and caches the
5522
+ * result while its count is unchanged. Omit when every reaction already
5523
+ * carries its complete {@link F0ChatReaction.users} list.
5524
+ */
5525
+ loadReactionUsers?: (messageId: string, emoji: string) => Promise<F0ChatUser[]>;
5485
5526
  /**
5486
5527
  * Delete a message that exists server-side (soft delete → tombstone, or hard
5487
5528
  * delete → removed from `messages`).
@@ -5529,6 +5570,13 @@ export declare type F0ChatRuntime = {
5529
5570
  * textarea (mirrors the AI chat). Omit for no limit.
5530
5571
  */
5531
5572
  maxFiles?: number;
5573
+ /**
5574
+ * Maximum size in bytes for each file selected, dropped, or pasted into the
5575
+ * composer. When any file exceeds the limit, the composer rejects the whole
5576
+ * batch before calling `uploadFiles` and keeps the validation error visible
5577
+ * until the next attachment attempt. Omit for no size limit.
5578
+ */
5579
+ maxFileSizeBytes?: number;
5532
5580
  /**
5533
5581
  * Optional voice dictation — same signature as the AI chat (streams partials).
5534
5582
  * Not part of the Stream transport; a host wires it to its own speech service
@@ -5692,6 +5740,53 @@ export declare type F0ChatVoiceAttachment = {
5692
5740
  name?: string;
5693
5741
  };
5694
5742
 
5743
+ /**
5744
+ * @experimental This is an experimental component, use it at your own risk.
5745
+ */
5746
+ export declare const F0EmojiPicker: WithDataTestIdReturnType_3< {
5747
+ ({ label, value, defaultValue, onChange, clearable, disabled, locale, size, }: F0EmojiPickerProps_2): JSX_2.Element;
5748
+ displayName: string;
5749
+ }>;
5750
+
5751
+ export declare interface F0EmojiPickerProps {
5752
+ /**
5753
+ * Accessible label and tooltip for the trigger button.
5754
+ */
5755
+ label: string;
5756
+ /**
5757
+ * Selected emoji. Use with `onChange` to control the component.
5758
+ */
5759
+ value?: string | null;
5760
+ /**
5761
+ * Initially selected emoji when the component is uncontrolled.
5762
+ */
5763
+ defaultValue?: string | null;
5764
+ /**
5765
+ * Called with the selected emoji, or `null` when cleared.
5766
+ */
5767
+ onChange?: (emoji: string | null) => void;
5768
+ /**
5769
+ * Allows clearing the selected emoji from the picker.
5770
+ */
5771
+ clearable?: boolean;
5772
+ /**
5773
+ * Prevents opening the picker and changing the selected emoji.
5774
+ */
5775
+ disabled?: boolean;
5776
+ /**
5777
+ * Locale used by the search and category labels in the picker.
5778
+ */
5779
+ locale?: string;
5780
+ /**
5781
+ * Size of the trigger avatar.
5782
+ */
5783
+ size?: F0EmojiPickerSize;
5784
+ }
5785
+
5786
+ export declare type F0EmojiPickerSize = (typeof f0EmojiPickerSizes)[number];
5787
+
5788
+ export declare const f0EmojiPickerSizes: readonly ["sm", "md", "lg"];
5789
+
5695
5790
  export declare type F0FileAction = {
5696
5791
  icon?: IconType;
5697
5792
  label: string;
@@ -6358,13 +6453,13 @@ export declare type F0SelectTagProp = string | {
6358
6453
  /**
6359
6454
  * @experimental This is an experimental component use it at your own risk
6360
6455
  */
6361
- export declare const F0TableOfContent: WithDataTestIdReturnType_5<typeof _F0TableOfContent>;
6456
+ export declare const F0TableOfContent: WithDataTestIdReturnType_3<typeof _F0TableOfContent>;
6362
6457
 
6363
6458
  declare function _F0TableOfContent(props: TOCProps): JSX_2.Element;
6364
6459
 
6365
- declare const F0TagAlert: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Props_5 & RefAttributes<HTMLDivElement>>>;
6460
+ declare const F0TagAlert: WithDataTestIdReturnType_3<ForwardRefExoticComponent<Props_5 & RefAttributes<HTMLDivElement>>>;
6366
6461
 
6367
- declare const F0TagBalance: WithDataTestIdReturnType_5<ForwardRefExoticComponent<F0TagBalanceProps_2 & RefAttributes<HTMLDivElement>>>;
6462
+ declare const F0TagBalance: WithDataTestIdReturnType_3<ForwardRefExoticComponent<F0TagBalanceProps_2 & RefAttributes<HTMLDivElement>>>;
6368
6463
 
6369
6464
  declare type F0TagBalanceProps = {
6370
6465
  /**
@@ -6396,7 +6491,7 @@ declare type F0TagBalanceProps = {
6396
6491
  formatterOptions?: undefined;
6397
6492
  });
6398
6493
 
6399
- declare const F0TagCompany: WithDataTestIdReturnType_5<ForwardRefExoticComponent<F0TagCompanyProps & RefAttributes<HTMLDivElement>>>;
6494
+ declare const F0TagCompany: WithDataTestIdReturnType_3<ForwardRefExoticComponent<F0TagCompanyProps & RefAttributes<HTMLDivElement>>>;
6400
6495
 
6401
6496
  declare type F0TagListProps<T extends TagType_2> = {
6402
6497
  /**
@@ -6418,9 +6513,9 @@ declare type F0TagListProps<T extends TagType_2> = {
6418
6513
  remainingCount?: number;
6419
6514
  };
6420
6515
 
6421
- declare const F0TagPerson: WithDataTestIdReturnType_5<ForwardRefExoticComponent<F0TagPersonProps & RefAttributes<HTMLDivElement>>>;
6516
+ declare const F0TagPerson: WithDataTestIdReturnType_3<ForwardRefExoticComponent<F0TagPersonProps & RefAttributes<HTMLDivElement>>>;
6422
6517
 
6423
- declare const F0TagRaw: WithDataTestIdReturnType_5<ForwardRefExoticComponent<F0TagRawProps_2 & RefAttributes<HTMLDivElement>>>;
6518
+ declare const F0TagRaw: WithDataTestIdReturnType_3<ForwardRefExoticComponent<F0TagRawProps_2 & RefAttributes<HTMLDivElement>>>;
6424
6519
 
6425
6520
  declare type F0TagRawProps = {
6426
6521
  /**
@@ -6463,7 +6558,7 @@ declare interface F0TagStatusProps {
6463
6558
  additionalAccessibleText?: string;
6464
6559
  }
6465
6560
 
6466
- declare const F0TagTeam: WithDataTestIdReturnType_5<ForwardRefExoticComponent<F0TagTeamProps & RefAttributes<HTMLDivElement>>>;
6561
+ declare const F0TagTeam: WithDataTestIdReturnType_3<ForwardRefExoticComponent<F0TagTeamProps & RefAttributes<HTMLDivElement>>>;
6467
6562
 
6468
6563
  /**
6469
6564
  * F0TextAreaInput is the writable multi-line text field for forms — a box
@@ -7596,7 +7691,7 @@ declare type Level = (typeof levels)[number];
7596
7691
 
7597
7692
  declare const levels: readonly ["info", "warning", "critical", "positive"];
7598
7693
 
7599
- export declare const LineChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig> & {
7694
+ export declare const LineChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig> & {
7600
7695
  lineType?: "natural" | "linear";
7601
7696
  } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
7602
7697
 
@@ -7625,6 +7720,26 @@ declare interface LoadingStateProps {
7625
7720
  label: string;
7626
7721
  }
7627
7722
 
7723
+ /** A single value, or the same value provided in multiple languages. */
7724
+ declare type Localized<T> = T | LocalizedOption<T>[];
7725
+
7726
+ /**
7727
+ * Shared helpers for content that can be provided in one language (a plain
7728
+ * value) or several (a list of per-locale entries) — used by the media players
7729
+ * for captions, descriptions, transcriptions and summaries.
7730
+ */
7731
+ declare interface LocalizedOption<T> {
7732
+ /** BCP-47 language tag, e.g. `"en"`, `"es"`, `"en-US"`. */
7733
+ locale: string;
7734
+ /**
7735
+ * Display label for the language picker. Defaults to the language name for
7736
+ * `locale` (via `Intl.DisplayNames`), so this is only needed to override it.
7737
+ */
7738
+ label?: string;
7739
+ /** The value for this locale. */
7740
+ value: T;
7741
+ }
7742
+
7628
7743
  export declare const MAX_EXPANDED_ACTIONS = 2;
7629
7744
 
7630
7745
  export declare type MentionedUser = {
@@ -8240,7 +8355,7 @@ action: BulkAction,
8240
8355
  /**
8241
8356
  * @experimental This is an experimental component use it at your own risk
8242
8357
  */
8243
- export declare const OneApprovalHistory: WithDataTestIdReturnType_5<FC<OneApprovalHistoryProps>>;
8358
+ export declare const OneApprovalHistory: WithDataTestIdReturnType_3<FC<OneApprovalHistoryProps>>;
8244
8359
 
8245
8360
  declare type OneApprovalHistoryProps = {
8246
8361
  steps: ApprovalStep[];
@@ -8547,7 +8662,7 @@ declare interface OnePaginationProps {
8547
8662
  /**
8548
8663
  * @experimental This is an experimental component use it at your own risk
8549
8664
  */
8550
- export declare const OnePersonListItem: WithDataTestIdReturnType_5<default_2.ForwardRefExoticComponent<OnePersonListItemProps & default_2.RefAttributes<HTMLDivElement>> & {
8665
+ export declare const OnePersonListItem: WithDataTestIdReturnType_3<default_2.ForwardRefExoticComponent<OnePersonListItemProps & default_2.RefAttributes<HTMLDivElement>> & {
8551
8666
  Skeleton: () => default_2.JSX.Element;
8552
8667
  }>;
8553
8668
 
@@ -8634,7 +8749,7 @@ declare interface OverflowListProps<T> {
8634
8749
  /**
8635
8750
  * @experimental This is an experimental component use it at your own risk
8636
8751
  */
8637
- export declare const Page: WithDataTestIdReturnType_5<typeof _Page>;
8752
+ export declare const Page: WithDataTestIdReturnType_3<typeof _Page>;
8638
8753
 
8639
8754
  declare function _Page({ children, header, embedded }: PageProps): JSX_2.Element;
8640
8755
 
@@ -8803,7 +8918,7 @@ declare type PersonProfile = {
8803
8918
 
8804
8919
  declare type PersonTagProps = ComponentProps<typeof F0TagPerson>;
8805
8920
 
8806
- export declare const PieChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<PieChartProps & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
8921
+ export declare const PieChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<PieChartProps & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
8807
8922
 
8808
8923
  export declare const PieChartWidget: ForwardRefExoticComponent<Omit<WidgetProps_2 & {
8809
8924
  chart: PieChartProps_2;
@@ -8962,7 +9077,7 @@ declare const privateProps_5: readonly [];
8962
9077
 
8963
9078
  declare const privateProps_6: readonly ["compact"];
8964
9079
 
8965
- declare const privateProps_7: readonly ["delay"];
9080
+ declare const privateProps_7: readonly ["delay", "onOpen"];
8966
9081
 
8967
9082
  declare type ProductUpdate = {
8968
9083
  title: string;
@@ -9013,7 +9128,7 @@ declare type ProductUpdatesProp = {
9013
9128
  };
9014
9129
  };
9015
9130
 
9016
- export declare const ProgressBarChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig_2> & {
9131
+ export declare const ProgressBarChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig_2> & {
9017
9132
  value: number;
9018
9133
  max?: number;
9019
9134
  label?: string;
@@ -9150,7 +9265,7 @@ declare type Pulse = (typeof pulses)[number];
9150
9265
 
9151
9266
  declare const pulses: readonly ["superNegative", "negative", "neutral", "positive", "superPositive"];
9152
9267
 
9153
- export declare const RadarChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<RadarChartProps<ChartConfig_2> & {
9268
+ export declare const RadarChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<RadarChartProps<ChartConfig_2> & {
9154
9269
  dataTestId?: string;
9155
9270
  } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
9156
9271
 
@@ -9174,6 +9289,8 @@ declare interface ReactionProps {
9174
9289
  initialCount: number;
9175
9290
  hasReacted?: boolean;
9176
9291
  users?: User_2[];
9292
+ /** Resolve the complete user list on first hover or keyboard focus. */
9293
+ loadUsers?: () => Promise<User_2[]>;
9177
9294
  onInteraction?: (emoji: string) => void;
9178
9295
  size?: "sm" | "md" | "lg";
9179
9296
  }
@@ -9544,7 +9661,7 @@ declare const shortcutVariants: (props?: ({
9544
9661
  className?: ClassValue;
9545
9662
  })) | undefined) => string;
9546
9663
 
9547
- export declare const Sidebar: WithDataTestIdReturnType_5<typeof _Sidebar>;
9664
+ export declare const Sidebar: WithDataTestIdReturnType_3<typeof _Sidebar>;
9548
9665
 
9549
9666
  declare function _Sidebar({ header, body, footer, onFooterDropdownClick, }: SidebarProps): JSX_2.Element;
9550
9667
 
@@ -9607,7 +9724,7 @@ export declare type SidebarChatAction = {
9607
9724
 
9608
9725
  export declare type SidebarChatActions = Omit<SidebarChatStore, "groups" | "activeChatId" | "unreadChatsCount">;
9609
9726
 
9610
- export declare const SidebarChatBlankState: WithDataTestIdReturnType_3<typeof _SidebarChatBlankState>;
9727
+ export declare const SidebarChatBlankState: WithDataTestIdReturnType_4<typeof _SidebarChatBlankState>;
9611
9728
 
9612
9729
  /**
9613
9730
  * Compact blank state for a sidebar conversation list. Shared by the people
@@ -10343,7 +10460,7 @@ export declare type TableVisualizationType = "table" | "editableTable";
10343
10460
  /**
10344
10461
  * @experimental This is an experimental component use it at your own risk
10345
10462
  */
10346
- export declare const Tabs: WithDataTestIdReturnType_5<FC<TabsProps> & {
10463
+ export declare const Tabs: WithDataTestIdReturnType_3<FC<TabsProps> & {
10347
10464
  Skeleton: FC<Pick<TabsProps, "secondary">>;
10348
10465
  }>;
10349
10466
 
@@ -10604,13 +10721,14 @@ export declare const ToggleGroupItem: React_2.ForwardRefExoticComponent<Omit<Tog
10604
10721
  /**
10605
10722
  * @experimental This is an experimental component use it at your own risk
10606
10723
  */
10607
- export declare const Tooltip: WithDataTestIdReturnType_5<(props: TooltipProps) => default_2.JSX.Element>;
10724
+ export declare const Tooltip: WithDataTestIdReturnType_3<(props: TooltipProps) => default_2.JSX.Element>;
10608
10725
 
10609
10726
  declare type TooltipInternalProps = {
10610
10727
  children: default_2.ReactNode;
10611
10728
  shortcut?: ComponentProps<typeof Shortcut>["keys"];
10612
10729
  delay?: number;
10613
10730
  instant?: boolean;
10731
+ onOpen?: () => void;
10614
10732
  } & ({
10615
10733
  label: string;
10616
10734
  description?: string;
@@ -11103,7 +11221,7 @@ export declare interface VersionAuthor {
11103
11221
  src?: string;
11104
11222
  }
11105
11223
 
11106
- export declare const VerticalBarChart: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig_2> & {
11224
+ export declare const VerticalBarChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<ChartPropsBase<ChartConfig_2> & {
11107
11225
  label?: boolean;
11108
11226
  showRatio?: boolean;
11109
11227
  valueFormatter?: (value: string | number | undefined) => string | number;
@@ -11118,6 +11236,56 @@ declare const VerticalOverflowList: {
11118
11236
  displayName: string;
11119
11237
  };
11120
11238
 
11239
+ /**
11240
+ * Structured content for the video player.
11241
+ *
11242
+ * Every field accepts either a single value or a localized list
11243
+ * (`[{ locale, label?, value }]`) — pass several languages and a language
11244
+ * selector appears in the controls. A single shared selection drives captions,
11245
+ * descriptions and the described source together (each falls back to its first
11246
+ * entry for languages it doesn't provide). See `F0VideoPlayerProps.defaultLanguage`.
11247
+ *
11248
+ * `captions` are timed text shown over the video during playback (WCAG 2.1
11249
+ * SC 1.2.2, Captions). Pass either a WebVTT resource URL or a raw WebVTT string
11250
+ * (the player turns raw VTT into a blob track, so no CORS setup is needed); a
11251
+ * remote URL requires the video host to allow cross-origin reads. When omitted,
11252
+ * the player uses any caption/subtitle track embedded in the video file. A
11253
+ * captions toggle in the controls shows/hides them (a filled glyph when on, a
11254
+ * line glyph when off).
11255
+ *
11256
+ * Audio description (WCAG 2.1 SC 1.2.5) conveys on-screen visual information as
11257
+ * audio, complementary to captions — both are independent and can be on at
11258
+ * once. Provide it in one of two ways, toggled with the audio-description
11259
+ * control (a filled "AD" badge when on, a line badge when off):
11260
+ * - `describedSrc`: a pre-produced media rendition with description mixed into
11261
+ * the audio. Toggling swaps the source, preserving position and play state.
11262
+ * Highest quality; assumed the same length as `src`.
11263
+ * - `descriptions`: a WebVTT `kind="descriptions"` script (URL or raw VTT),
11264
+ * delivered at runtime — the video pauses on each cue so the description can
11265
+ * be spoken (extended audio description), then resumes. Used only when
11266
+ * `describedSrc` is absent.
11267
+ */
11268
+ declare interface VideoPlayerContent {
11269
+ /**
11270
+ * WebVTT URL, or raw WebVTT content, for captions shown during playback.
11271
+ * Localizable — pass a per-locale list to offer captions in several languages.
11272
+ */
11273
+ captions?: Localized<string>;
11274
+ /**
11275
+ * A pre-produced described media source (description mixed into the audio),
11276
+ * swapped in when audio description is enabled. Takes precedence over
11277
+ * `descriptions`. Should match `src`'s duration so the position carries
11278
+ * across the swap. Localizable.
11279
+ */
11280
+ describedSrc?: Localized<string>;
11281
+ /**
11282
+ * WebVTT URL, or raw WebVTT content, of a `kind="descriptions"` script.
11283
+ * Delivered at runtime with extended (pausing) audio description when no
11284
+ * `describedSrc` is provided. Localizable.
11285
+ */
11286
+ descriptions?: Localized<string>;
11287
+ }
11288
+
11121
11289
  /**
11122
11290
  * @experimental This is an experimental component use it at your own risk
11123
11291
  */
@@ -11297,7 +11465,7 @@ declare type WelcomeSuggestionClickEvent = {
11297
11465
  /**
11298
11466
  * @experimental This is an experimental component use it at your own risk
11299
11467
  */
11300
- export declare const Widget: WithDataTestIdReturnType_5<default_2.ForwardRefExoticComponent<WidgetProps & {
11468
+ export declare const Widget: WithDataTestIdReturnType_3<default_2.ForwardRefExoticComponent<WidgetProps & {
11301
11469
  children: ReactNode;
11302
11470
  } & default_2.RefAttributes<HTMLDivElement>> & {
11303
11471
  Skeleton: default_2.ForwardRefExoticComponent<WidgetSkeletonProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -11322,7 +11490,7 @@ export declare type WidgetAvatarsListItemProps = {
11322
11490
  /**
11323
11491
  * @experimental This is an experimental component use it at your own risk
11324
11492
  */
11325
- export declare const WidgetEmptyState: WithDataTestIdReturnType_5<typeof _WidgetEmptyState>;
11493
+ export declare const WidgetEmptyState: WithDataTestIdReturnType_3<typeof _WidgetEmptyState>;
11326
11494
 
11327
11495
  declare function _WidgetEmptyState({ title, description, emoji, actions, }: WidgetEmptyStateProps): JSX_2.Element;
11328
11496
 
@@ -11376,7 +11544,7 @@ export declare interface WidgetProps {
11376
11544
  /**
11377
11545
  * @experimental This is an experimental component use it at your own risk
11378
11546
  */
11379
- export declare const WidgetSection: WithDataTestIdReturnType_5<ForwardRefExoticComponent< {
11547
+ export declare const WidgetSection: WithDataTestIdReturnType_3<ForwardRefExoticComponent< {
11380
11548
  children?: ReactNode | undefined;
11381
11549
  } & {
11382
11550
  title?: string;