@factorialco/f0-react 10.9.0 → 10.10.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.
@@ -10265,7 +10265,7 @@ declare namespace index_d_exports {
10265
10265
  * `id` and a `type`. No title — the section names it — so its card is
10266
10266
  * headless. It is one of three kinds:
10267
10267
  * - {@link AgenticHomeStaticElement} — content that IS the spec
10268
- * (`shortcuts`): written once, and never stale.
10268
+ * (`shortcuts`, `text`): written once, and never stale.
10269
10269
  * - {@link AgenticHomeDataElement} — WHAT to draw (`stats`, `charts`,
10270
10270
  * `list`, `timeline`, `events`, `posts`, and display options) and WHERE
10271
10271
  * its data comes from: an {@link AgenticHomeDataSource}. Never values.
@@ -10275,12 +10275,21 @@ declare namespace index_d_exports {
10275
10275
  * included. A static element is one. For a data element the HOST resolves
10276
10276
  * its source into one, outside the component, and passes it in
10277
10277
  * {@link F0AgenticHomeProps.sources} keyed by element id.
10278
+ * - {@link AgenticHomeAccessoryView} — what isn't on the page but behind an
10279
+ * id: sections, or one host widget the host draws whole. An
10280
+ * `openAccessoryView` action opens it in a dialog or a drawer, as the view's
10281
+ * TYPE says. The host declares the types it accepts
10282
+ * ({@link AgenticHomeAccessoryViewType}), each with its own rules.
10278
10283
  *
10279
10284
  * A stored spec never holds data, as an analytics dashboard item never holds
10280
10285
  * its rows: a number written into storage is wrong once it changes.
10281
10286
  *
10282
10287
  * {@link AgenticHomeRules} limit all of it — sections, elements per section,
10283
- * items per block, which types share a section — and are JSON too.
10288
+ * items per block, which block types are allowed and which share a section —
10289
+ * and are JSON too.
10290
+ *
10291
+ * Element ids are unique across the Home AND its accessory views: sources and
10292
+ * action contexts are keyed by them, with no view to tell them apart.
10284
10293
  */
10285
10294
  /** Bumped on any change a stored spec must be migrated for. */
10286
10295
  export declare const AGENTIC_HOME_SPEC_VERSION = 1;
@@ -10325,6 +10334,22 @@ type AgenticHomeAction = {
10325
10334
  type: "event";
10326
10335
  id: string;
10327
10336
  payload?: AgenticHomeJsonObject;
10337
+ } |
10338
+ /**
10339
+ * Open the spec's accessory view with this `id`. `F0AgenticHome` opens it
10340
+ * itself, and still reports the press to `onAction`. An id with no view (or
10341
+ * one the rules left out) opens nothing.
10342
+ *
10343
+ * `params` are the values of the view's declared
10344
+ * {@link AgenticHomeAccessoryView.params} — row ids taken from what was
10345
+ * pressed, so the view is about that item. They must be exactly the ones
10346
+ * the view declares: a missing or undeclared one is reported
10347
+ * (`accessoryViewParams`), and the view doesn't open.
10348
+ */
10349
+ {
10350
+ type: "openAccessoryView";
10351
+ id: string;
10352
+ params?: Record<string, string>;
10328
10353
  };
10329
10354
  /** A button: what it says, how it looks, what it does. */
10330
10355
  interface AgenticHomeButton {
@@ -10333,6 +10358,21 @@ interface AgenticHomeButton {
10333
10358
  variant?: ButtonVariant;
10334
10359
  action: AgenticHomeAction;
10335
10360
  }
10361
+ /**
10362
+ * What a data block draws when it has nothing to show: f0's empty state — an
10363
+ * emoji, a title, a line of description and at most two buttons — inside the
10364
+ * block's card. JSON like the rest of the spec: the buttons are action
10365
+ * descriptors.
10366
+ */
10367
+ interface AgenticHomeEmptyState {
10368
+ /** "Nothing waiting on you". */
10369
+ title: string;
10370
+ description?: string;
10371
+ /** One emoji: "🎉". Omitted, a neutral one. */
10372
+ emoji?: string;
10373
+ /** At most two; any more are left out. */
10374
+ actions?: AgenticHomeButton[];
10375
+ }
10336
10376
  /** A hover action on a list row. Same as a button, drawn as the row's own. */
10337
10377
  interface AgenticHomeRowAction {
10338
10378
  label: string;
@@ -10366,6 +10406,19 @@ type AgenticHomeAvatar = {
10366
10406
  icon: AgenticHomeIcon;
10367
10407
  color?: ListIconColor;
10368
10408
  };
10409
+ /** What every data element may decide, whatever its source returns. */
10410
+ interface AgenticHomeDisplayBase {
10411
+ /**
10412
+ * What it draws with no items. Wins over the resolved block's own `empty`;
10413
+ * with neither, a generic "no data" one.
10414
+ */
10415
+ empty?: AgenticHomeEmptyState;
10416
+ /**
10417
+ * With no items, draw nothing at all — no empty state — once its source
10418
+ * has answered. While it loads it still draws its skeleton.
10419
+ */
10420
+ hideWhenEmpty?: boolean;
10421
+ }
10369
10422
  /** One entry of a section's menu, or a line between groups of them. */
10370
10423
  type AgenticHomeMenuItem = {
10371
10424
  type?: "item";
@@ -10382,6 +10435,10 @@ interface AgenticHomeActionContext {
10382
10435
  elementId?: string;
10383
10436
  /** The row, stat, item or shortcut it came from. */
10384
10437
  itemId?: string;
10438
+ /** The accessory view it was pressed in, when it was in one. */
10439
+ accessoryViewId?: string;
10440
+ /** The params that view was opened with, when it was opened with any. */
10441
+ accessoryViewParams?: Record<string, string>;
10385
10442
  }
10386
10443
  //#endregion
10387
10444
  //#region src/domains/platform/home/Home/F0AgenticHome/blocks/ChartsBlock/types.d.ts
@@ -10456,9 +10513,11 @@ interface AgenticHomeChart {
10456
10513
  interface AgenticHomeChartsBlock {
10457
10514
  type: "charts";
10458
10515
  charts: AgenticHomeChart[];
10516
+ /** Drawn instead of the items when there are none. */
10517
+ empty?: AgenticHomeEmptyState;
10459
10518
  }
10460
10519
  /** How a `charts` element reads its numbers, whatever its source returns. */
10461
- interface AgenticHomeChartsDisplay {
10520
+ interface AgenticHomeChartsDisplay extends AgenticHomeDisplayBase {
10462
10521
  /** Wins over each resolved chart's own `format`. */
10463
10522
  format?: AgenticHomeChartFormat;
10464
10523
  }
@@ -10482,6 +10541,8 @@ interface AgenticHomeEvent {
10482
10541
  interface AgenticHomeEventsBlock {
10483
10542
  type: "events";
10484
10543
  events: AgenticHomeEvent[];
10544
+ /** Drawn instead of the items when there are none. */
10545
+ empty?: AgenticHomeEmptyState;
10485
10546
  }
10486
10547
  //#endregion
10487
10548
  //#region src/domains/platform/home/Home/F0AgenticHome/blocks/ListBlock/types.d.ts
@@ -10516,8 +10577,10 @@ interface AgenticHomeListRow {
10516
10577
  /** Makes the row a real link. Required when the schema's `clickBehavior` is "link". */
10517
10578
  href?: string;
10518
10579
  /**
10519
- * What pressing the row does, over its `href`: a `navigate` makes it a
10520
- * link, anything else (a `goToSection`) a button.
10580
+ * What pressing the row does: a `navigate` makes it a real link, like
10581
+ * `href` (and wins over it); anything else — a `goToSection`, or an
10582
+ * `openAccessoryView` about this row — makes the row a button. Either way
10583
+ * the press is reported to `onAction` with the row's id as `itemId`.
10521
10584
  */
10522
10585
  action?: AgenticHomeAction;
10523
10586
  actions?: AgenticHomeRowAction[];
@@ -10541,20 +10604,12 @@ interface AgenticHomeListBlock {
10541
10604
  schema: ListSchema;
10542
10605
  rows: AgenticHomeListRow[];
10543
10606
  /** Drawn instead of the rows when there are none. */
10544
- empty?: {
10545
- title: string;
10546
- description?: string;
10547
- };
10607
+ empty?: AgenticHomeEmptyState;
10548
10608
  }
10549
10609
  /** How a `list` element draws its rows, whatever its source returns. */
10550
- interface AgenticHomeListDisplay {
10610
+ interface AgenticHomeListDisplay extends AgenticHomeDisplayBase {
10551
10611
  /** Wins over the resolved block's own `schema`. */
10552
10612
  schema?: ListSchema;
10553
- /** Wins over the resolved block's own `empty`. */
10554
- empty?: {
10555
- title: string;
10556
- description?: string;
10557
- };
10558
10613
  /** Wins over the resolved block's own `title`. */
10559
10614
  title?: string;
10560
10615
  /** Wins over the resolved block's own `bare`. */
@@ -10584,6 +10639,8 @@ interface AgenticHomePost {
10584
10639
  interface AgenticHomePostsBlock {
10585
10640
  type: "posts";
10586
10641
  posts: AgenticHomePost[];
10642
+ /** Drawn instead of the items when there are none. */
10643
+ empty?: AgenticHomeEmptyState;
10587
10644
  }
10588
10645
  //#endregion
10589
10646
  //#region src/domains/platform/home/Home/F0AgenticHome/blocks/ShortcutsBlock/types.d.ts
@@ -10627,6 +10684,20 @@ interface AgenticHomeStat {
10627
10684
  interface AgenticHomeStatsBlock {
10628
10685
  type: "stats";
10629
10686
  stats: AgenticHomeStat[];
10687
+ /** Drawn instead of the items when there are none. */
10688
+ empty?: AgenticHomeEmptyState;
10689
+ }
10690
+ //#endregion
10691
+ //#region src/domains/platform/home/Home/F0AgenticHome/blocks/TextBlock/types.d.ts
10692
+ /**
10693
+ * A `text` block: prose, as markdown — paragraphs, headings (`#` draws under
10694
+ * the section's title), `**bold**`, `*italics*`, lists, `[links](href)` and
10695
+ * `code`. Raw HTML and images are not drawn: they print as text. One item
10696
+ * for `maxItems`. Static: it lives in the spec.
10697
+ */
10698
+ interface AgenticHomeTextBlock {
10699
+ type: "text";
10700
+ text: string;
10630
10701
  }
10631
10702
  //#endregion
10632
10703
  //#region src/domains/platform/home/Home/F0AgenticHome/blocks/TimelineBlock/types.d.ts
@@ -10648,6 +10719,8 @@ interface AgenticHomeTimelineItem {
10648
10719
  interface AgenticHomeTimelineBlock {
10649
10720
  type: "timeline";
10650
10721
  items: AgenticHomeTimelineItem[];
10722
+ /** Drawn instead of the items when there are none. */
10723
+ empty?: AgenticHomeEmptyState;
10651
10724
  }
10652
10725
  //#endregion
10653
10726
  //#region src/domains/platform/home/Home/F0AgenticHome/types/blocks.d.ts
@@ -10658,8 +10731,7 @@ interface AgenticHomeTimelineBlock {
10658
10731
  type AgenticHomeDataBlock = AgenticHomeStatsBlock | AgenticHomeChartsBlock | AgenticHomeListBlock | AgenticHomeTimelineBlock | AgenticHomeEventsBlock | AgenticHomePostsBlock;
10659
10732
  type AgenticHomeDataBlockType = AgenticHomeDataBlock["type"];
10660
10733
  /** A block whose content is static: it is written into the spec. */
10661
- type AgenticHomeStaticBlock = AgenticHomeShortcutsBlock;
10662
- type AgenticHomeStaticBlockType = AgenticHomeStaticBlock["type"];
10734
+ type AgenticHomeStaticBlock = AgenticHomeShortcutsBlock | AgenticHomeTextBlock;
10663
10735
  /**
10664
10736
  * What a block draws, by `type`, items included. A discriminated union so
10665
10737
  * what reaches the organism is checked: a type it doesn't know is an error,
@@ -10670,28 +10742,16 @@ type AgenticHomeBlockType = AgenticHomeBlock["type"];
10670
10742
  //#endregion
10671
10743
  //#region src/domains/platform/home/Home/F0AgenticHome/types/elements.d.ts
10672
10744
  /**
10673
- * Where an element's data comes from. Opaque to f0: the HOST resolves it,
10674
- * outside the component, and passes the result in
10675
- * {@link F0AgenticHomeProps.sources}.
10745
+ * Where an element's data comes from. Opaque to f0: it names its `kind` and
10746
+ * holds whatever that kind needs, as JSON — a host widget's id, a cube query,
10747
+ * an app resource and its filters. The HOST decides which kinds exist,
10748
+ * resolves them outside the component, and passes the result in
10749
+ * {@link F0AgenticHomeProps.sources} under the element's id. f0 never reads
10750
+ * it, so a new kind needs no f0 change.
10676
10751
  */
10677
- type AgenticHomeDataSource = AgenticHomeWidgetSource | AgenticHomeCubeSource;
10678
- /**
10679
- * A host Home widget, by its id in the host's catalog ("needs-you",
10680
- * "clock-in", "events"…), with the params it is configured with.
10681
- */
10682
- interface AgenticHomeWidgetSource {
10683
- kind: "widget";
10684
- id: string;
10685
- params?: AgenticHomeJsonObject;
10686
- }
10687
- /**
10688
- * A semantic-cube query, executed by the host as it executes an analytics
10689
- * dashboard item's. Its `querySpec` is opaque here.
10690
- */
10691
- interface AgenticHomeCubeSource {
10692
- kind: "cube";
10693
- querySpec: AgenticHomeJsonObject;
10694
- }
10752
+ type AgenticHomeDataSource = {
10753
+ kind: string;
10754
+ } & AgenticHomeJsonObject;
10695
10755
  /**
10696
10756
  * What every element carries. No title: the section heading names it, and
10697
10757
  * its card is drawn headless — a list's `display.title` is the one exception.
@@ -10703,16 +10763,16 @@ interface AgenticHomeElementBase {
10703
10763
  */
10704
10764
  id: string;
10705
10765
  }
10706
- /** An element whose content IS the spec: a `shortcuts` block. */
10766
+ /** An element whose content IS the spec: a `shortcuts` or `text` block. */
10707
10767
  type AgenticHomeStaticElement = AgenticHomeElementBase & AgenticHomeStaticBlock;
10708
10768
  /** Display options by data element type. Data-free. */
10709
10769
  interface AgenticHomeDisplayByType {
10710
- stats: never;
10770
+ stats: AgenticHomeDisplayBase;
10711
10771
  charts: AgenticHomeChartsDisplay;
10712
10772
  list: AgenticHomeListDisplay;
10713
- timeline: never;
10714
- events: never;
10715
- posts: never;
10773
+ timeline: AgenticHomeDisplayBase;
10774
+ events: AgenticHomeDisplayBase;
10775
+ posts: AgenticHomeDisplayBase;
10716
10776
  }
10717
10777
  /** A data element of one type. */
10718
10778
  interface AgenticHomeDataElementOf<T extends AgenticHomeDataBlockType> extends AgenticHomeElementBase {
@@ -10738,7 +10798,7 @@ type AgenticHomeDataElement = { [T in AgenticHomeDataBlockType]: AgenticHomeData
10738
10798
  */
10739
10799
  interface AgenticHomeWidgetElement extends AgenticHomeElementBase {
10740
10800
  type: "widget";
10741
- source: AgenticHomeWidgetSource;
10801
+ source: AgenticHomeDataSource;
10742
10802
  /** How many placeholder items to draw while it loads. */
10743
10803
  expectedItemsCount?: number;
10744
10804
  }
@@ -10754,7 +10814,8 @@ type AgenticHomeElementType = AgenticHomeElement["type"];
10754
10814
  * drawn as an error and reported to `onRulesViolation` (`sourceType`);
10755
10815
  * - for a `widget` element, a host `widget` — a Home widget item with its own
10756
10816
  * slots, drawn headless through `SlotWidget` with the host's
10757
- * `slotRenderers`.
10817
+ * `slotRenderers`; `bare`, its slots are drawn without the card, for a
10818
+ * widget that is already a surface of its own.
10758
10819
  *
10759
10820
  * Either way it is the host's runtime data, never stored in the spec.
10760
10821
  */
@@ -10770,9 +10831,26 @@ type AgenticHomeSourceState = {
10770
10831
  } | {
10771
10832
  status: "ready";
10772
10833
  widget: HomeWidgetItem;
10834
+ bare?: boolean;
10773
10835
  block?: never;
10774
10836
  };
10775
10837
  //#endregion
10838
+ //#region src/domains/platform/home/Home/F0AgenticHome/context/mentionsContext.d.ts
10839
+ /**
10840
+ * A record named in a section's text, written `[label](mention:<type>:<id>)`:
10841
+ * a person, a contract, a policy… The host knows what it is; the Home only
10842
+ * finds it in the text.
10843
+ */
10844
+ interface AgenticHomeMention {
10845
+ /** The record's type, as the host names it (`employees.employee`). */
10846
+ type: string;
10847
+ id: string;
10848
+ /** The words the text names it by. */
10849
+ label: string;
10850
+ }
10851
+ /** How the host draws a mention, such as underlined, with the record's card on hover. */
10852
+ type AgenticHomeMentionRenderer = (mention: AgenticHomeMention) => ReactNode;
10853
+ //#endregion
10776
10854
  //#region src/domains/platform/home/Home/F0AgenticHome/types/rules.d.ts
10777
10855
  /**
10778
10856
  * What one element type may do. Every field is optional: a rule only limits
@@ -10814,6 +10892,12 @@ interface AgenticHomeBlockRule {
10814
10892
  * the server. Nothing is limited unless a rule says so.
10815
10893
  */
10816
10894
  interface AgenticHomeRules {
10895
+ /**
10896
+ * The only element types allowed, `widget` included: a `widget` element is
10897
+ * allowed only if listed. Others are dropped — checked on the spec, where
10898
+ * every element's type is known. Omitted, every type is allowed.
10899
+ */
10900
+ allowedBlockTypes?: AgenticHomeElementType[];
10817
10901
  /** Most sections on the page. Later ones are dropped. */
10818
10902
  maxSections?: number;
10819
10903
  /** Most elements in one section. Later ones are dropped. */
@@ -10830,11 +10914,69 @@ interface AgenticHomeRules {
10830
10914
  */
10831
10915
  lead?: Omit<AgenticHomeRules, "maxSections" | "lead">;
10832
10916
  }
10833
- /** One way a spec broke the rules, and what was done about it. */
10834
- type AgenticHomeRuleViolation = {
10917
+ /**
10918
+ * One way a spec broke the rules, and what was done about it. A violation
10919
+ * inside an accessory view names it in `accessoryViewId`.
10920
+ */
10921
+ type AgenticHomeRuleViolation = ({
10835
10922
  rule: "maxSections";
10836
10923
  limit: number;
10837
10924
  droppedSectionIds: string[];
10925
+ } | {
10926
+ rule: "allowedBlockTypes";
10927
+ sectionId: string;
10928
+ elementId: string;
10929
+ blockType: AgenticHomeElementType;
10930
+ } | {
10931
+ /** The view's `type` isn't one of the host's `accessoryViewTypes`. */
10932
+ rule: "accessoryViewType";
10933
+ viewType: string;
10934
+ } | {
10935
+ /**
10936
+ * An `openAccessoryView` whose `params` aren't exactly the view's
10937
+ * declared ones: some missing (or empty), or some the view doesn't
10938
+ * declare. The view doesn't open from it. `elementId` and `itemId` say
10939
+ * which block and item hold the action, when a block does.
10940
+ */
10941
+ rule: "accessoryViewParams";
10942
+ viewId: string;
10943
+ missingParams: string[];
10944
+ undeclaredParams: string[];
10945
+ elementId?: string;
10946
+ itemId?: string;
10947
+ } | {
10948
+ /** A Home section without a title: only accessory views allow that. */
10949
+ rule: "sectionTitle";
10950
+ sectionId: string;
10951
+ } | {
10952
+ /**
10953
+ * An accessory view with no body it can draw: neither `sections` nor a
10954
+ * `widget` element (of type `widget`), or both. Left out: a view is
10955
+ * one or the other.
10956
+ */
10957
+ rule: "accessoryViewBody";
10958
+ } | {
10959
+ /** A shape slot got fewer elements than its `min`. */
10960
+ rule: "shapeMin";
10961
+ slotIndex: number;
10962
+ min: number;
10963
+ count: number;
10964
+ } | {
10965
+ /** A text in a shape slot is outside the slot's length range. Left out. */
10966
+ rule: "shapeText";
10967
+ slotIndex: number;
10968
+ elementId: string;
10969
+ length: number;
10970
+ minLength?: number;
10971
+ maxLength?: number;
10972
+ } | {
10973
+ /**
10974
+ * An element past what the shape takes. Left out. `slotIndex` is the
10975
+ * slot the matching stopped after — the last one, or -1 for none.
10976
+ */
10977
+ rule: "shapeExtra";
10978
+ slotIndex: number;
10979
+ elementId: string;
10838
10980
  } | {
10839
10981
  rule: "maxElementsPerSection";
10840
10982
  sectionId: string;
@@ -10889,6 +11031,8 @@ type AgenticHomeRuleViolation = {
10889
11031
  elementId: string;
10890
11032
  itemId: string;
10891
11033
  expected: AgenticHomeAction["type"][];
11034
+ }) & {
11035
+ accessoryViewId?: string;
10892
11036
  };
10893
11037
  //#endregion
10894
11038
  //#region src/domains/platform/home/Home/F0AgenticHome/types/spec.d.ts
@@ -10915,13 +11059,185 @@ interface AgenticHomeSection {
10915
11059
  * update" — in a menu beside its title.
10916
11060
  */
10917
11061
  actions?: AgenticHomeMenuItem[];
11062
+ /**
11063
+ * Drawn in place of the section's elements when ALL of them are data
11064
+ * elements whose sources answered with no items: one empty state for the
11065
+ * section, over its blocks' own. The heading, prose and follow-ups stay. A
11066
+ * section holding static content or a widget is never empty.
11067
+ */
11068
+ empty?: AgenticHomeEmptyState;
11069
+ /**
11070
+ * When the section is empty (see `empty`), draw nothing at all — not even
11071
+ * its heading. Wins over `empty`.
11072
+ */
11073
+ hideWhenEmpty?: boolean;
11074
+ }
11075
+ /**
11076
+ * A section of an accessory view: a Home section whose `title` is optional.
11077
+ * The dialog's title already names the view, so a section can be just its
11078
+ * prose and elements; with no title and no menu it draws no header at all.
11079
+ * Only here — a Home section with no title is left out by the rules.
11080
+ */
11081
+ type AgenticHomeAccessoryViewSection = Omit<AgenticHomeSection, "title"> & {
11082
+ title?: string;
11083
+ };
11084
+ /**
11085
+ * What every accessory view carries, whatever its body: f0 owns the shell —
11086
+ * the dialog or drawer, its title and footer, opening it with its params and
11087
+ * closing it.
11088
+ */
11089
+ interface AgenticHomeAccessoryViewBase {
11090
+ /** What `openAccessoryView` actions point at. Unique within the spec. */
11091
+ id: string;
11092
+ /** One of the host's accessory view types: "approval_accessory_view". */
11093
+ type: string;
11094
+ /** The dialog or drawer's title. */
11095
+ title: string;
11096
+ description?: string;
11097
+ /**
11098
+ * The names of the values the view is about — `["itemId"]` — so one view
11099
+ * can show whichever row it is opened from. An `openAccessoryView` must
11100
+ * supply every one of them, and no other, in its `params`. The host resolves
11101
+ * the view's data elements for those values (see
11102
+ * {@link F0AgenticHomeProps.onAccessoryViewOpen}). Omitted, it takes none.
11103
+ */
11104
+ params?: string[];
11105
+ /**
11106
+ * What can be done with what the view shows — "Approve", "Reject" — in the
11107
+ * dialog's own footer, never in its body. The first is the primary action
11108
+ * (`variant: "critical"` makes it destructive); the rest are secondary, in
11109
+ * a menu past the first. Pressing one reports it to `onAction` with the
11110
+ * view's `accessoryViewId`, then closes the view. A `navigate` is reported
11111
+ * too, but drawn as a button: the footer has no links, so the host follows
11112
+ * it.
11113
+ */
11114
+ actions?: AgenticHomeButton[];
10918
11115
  }
11116
+ /** An accessory view whose body is the spec's own sections. */
11117
+ interface AgenticHomeSectionsAccessoryView extends AgenticHomeAccessoryViewBase {
11118
+ /**
11119
+ * Drawn like the Home's, top to bottom, but smaller — never above the
11120
+ * dialog's title — and none of them is a lead. A section here may have no
11121
+ * title.
11122
+ */
11123
+ sections: AgenticHomeAccessoryViewSection[];
11124
+ widget?: never;
11125
+ }
11126
+ /** An accessory view whose body is one host widget, drawn by the host. */
11127
+ interface AgenticHomeWidgetAccessoryView extends AgenticHomeAccessoryViewBase {
11128
+ /**
11129
+ * The whole body: a host widget — a work item's detail page, say — drawn
11130
+ * edge to edge, with no section, heading or card around it. Resolved like
11131
+ * any `widget` element: the host answers it in `sources` under its `id`
11132
+ * (`$view.<param>` in its `source.params` stands for the value the view was
11133
+ * opened with, as in a sectioned view's sources) and draws its slots with
11134
+ * `slotRenderers`.
11135
+ */
11136
+ widget: AgenticHomeWidgetElement;
11137
+ sections?: never;
11138
+ }
11139
+ /**
11140
+ * What isn't on the page but behind an id — a request's details, an
11141
+ * approval's history, a work item's whole page — opened by an
11142
+ * `openAccessoryView` action from anything pressable. Its body is the spec's
11143
+ * own `sections`, or one host `widget`. How it is presented (dialog or
11144
+ * drawer) and what it may hold are decided by its `type`, which the host
11145
+ * declares in {@link F0AgenticHomeProps.accessoryViewTypes}; the spec only
11146
+ * names it.
11147
+ */
11148
+ type AgenticHomeAccessoryView = AgenticHomeSectionsAccessoryView | AgenticHomeWidgetAccessoryView;
10919
11149
  interface AgenticHomeSpec {
10920
11150
  version: typeof AGENTIC_HOME_SPEC_VERSION;
10921
11151
  sections: AgenticHomeSection[];
11152
+ /** Views the sections can open. Not drawn until an action opens one. */
11153
+ accessoryViews?: AgenticHomeAccessoryView[];
11154
+ }
11155
+ /** How wide an accessory view's dialog or drawer is. */
11156
+ declare const accessoryViewWidths: readonly ["md", "lg", "xl"];
11157
+ type AgenticHomeAccessoryViewWidth = (typeof accessoryViewWidths)[number];
11158
+ /**
11159
+ * A kind of accessory view the host accepts, and how it is drawn. The host
11160
+ * decides the presentation, not the spec: the agent that writes specs picks a
11161
+ * type, and the type carries the rest.
11162
+ */
11163
+ interface AgenticHomeAccessoryViewType {
11164
+ /** What views name in their `type`: "approval_accessory_view". */
11165
+ type: string;
11166
+ /** A centred dialog, or a drawer from the side of the page. */
11167
+ presentation: "dialog" | "drawer";
11168
+ /**
11169
+ * How wide the dialog or drawer is: `lg` or `xl` for a host widget that
11170
+ * draws a whole page, with a side rail. Default `md`.
11171
+ */
11172
+ width?: AgenticHomeAccessoryViewWidth;
11173
+ /**
11174
+ * The body fills the dialog or drawer edge to edge, with no padding of its
11175
+ * own: for a host widget that draws a whole page and brings its own gutter.
11176
+ * Default `false`.
11177
+ */
11178
+ bleed?: boolean;
11179
+ /**
11180
+ * What a view of this type may hold. The Home's `rules` don't apply to
11181
+ * accessory views; omitted, a view of this type is unlimited. A widget body
11182
+ * is one element of type `widget`: it needs `widget` in `allowedBlockTypes`
11183
+ * when they are set.
11184
+ */
11185
+ rules?: AgenticHomeRules;
11186
+ /**
11187
+ * The strict shape a sectioned view of this type must have: an ordered pattern its
11188
+ * elements must match, read top to bottom across its sections. Elements are
11189
+ * matched greedily, slot by slot. What doesn't fit — an element left over,
11190
+ * a text outside its length range — is left out and reported, as is a slot
11191
+ * under its `min`; the elements that DO match still draw, so a view that
11192
+ * breaks its shape degrades rather than vanishes. Checked after `rules`.
11193
+ */
11194
+ shape?: AgenticHomeShapeSlot[];
11195
+ }
11196
+ /**
11197
+ * One slot of an accessory view type's {@link AgenticHomeAccessoryViewType.shape}:
11198
+ * how many consecutive elements of which types it takes.
11199
+ */
11200
+ interface AgenticHomeShapeSlot {
11201
+ /** The element types that may fill it. */
11202
+ types: AgenticHomeElementType[];
11203
+ /** Fewest elements it needs. Default 1; 0 makes it optional. */
11204
+ min?: number;
11205
+ /** Most elements it takes. Default 1. */
11206
+ max?: number;
11207
+ /**
11208
+ * For a `text` element in this slot: the length of its markdown source,
11209
+ * trimmed. A text outside the range doesn't match, and is left out.
11210
+ */
11211
+ text?: {
11212
+ minLength?: number;
11213
+ maxLength?: number;
11214
+ };
11215
+ }
11216
+ /**
11217
+ * An accessory view as it was opened: its id, and the values of its declared
11218
+ * params (`{}` for a view that declares none).
11219
+ */
11220
+ interface AgenticHomeOpenAccessoryView {
11221
+ id: string;
11222
+ params: Record<string, string>;
10922
11223
  }
10923
11224
  //#endregion
10924
11225
  //#region src/domains/platform/home/Home/F0AgenticHome/types/props.d.ts
11226
+ /**
11227
+ * A button the host puts beside the greeting, such as "Regenerate". Host UI,
11228
+ * not spec data: it is passed to the component, never stored, so it holds a
11229
+ * handler and an icon component.
11230
+ */
11231
+ interface F0AgenticHomeGreetingAction {
11232
+ label: string;
11233
+ icon?: IconType;
11234
+ onClick: () => void;
11235
+ /** The work it started is running: the button shows its loading state. */
11236
+ loading?: boolean;
11237
+ disabled?: boolean;
11238
+ /** Icon only; the label stays its accessible name and tooltip. */
11239
+ hideLabel?: boolean;
11240
+ }
10925
11241
  interface F0AgenticHomeProps {
10926
11242
  spec: AgenticHomeSpec;
10927
11243
  /** The greeting over the page, computed by the host for this visit. */
@@ -10929,12 +11245,42 @@ interface F0AgenticHomeProps {
10929
11245
  title: string;
10930
11246
  subtitle?: string;
10931
11247
  };
11248
+ /**
11249
+ * The host's buttons on the greeting's row, at its right — such as
11250
+ * "Regenerate", which asks the backend to compose the spec again. They wrap
11251
+ * under the greeting on narrow widths.
11252
+ */
11253
+ greetingActions?: F0AgenticHomeGreetingAction[];
11254
+ /**
11255
+ * The spec is being composed again. While true, every data and widget
11256
+ * element draws its type's skeleton, static content (titles, prose,
11257
+ * shortcuts, text) stays, and the sections are marked `aria-busy`.
11258
+ */
11259
+ regenerating?: boolean;
10932
11260
  /**
10933
11261
  * The data, resolved by the host from each data and widget element's
10934
11262
  * `source`, keyed by element id: the spec only says where it comes from.
10935
11263
  * An element with no entry draws as loading.
10936
11264
  */
10937
11265
  sources?: Record<string, AgenticHomeSourceState>;
11266
+ /**
11267
+ * Which open accessory view the entries in `sources` for ITS elements were
11268
+ * resolved for. Read only for a view that declares `params`: until
11269
+ * `sourcesFor` names that view with the very params it is open with, its
11270
+ * data elements draw their skeletons — so a view opened again for another
11271
+ * row never shows the previous row's data. Set it together with those
11272
+ * entries, to the `{ id, params }` that {@link onAccessoryViewOpen} got.
11273
+ */
11274
+ sourcesFor?: AgenticHomeOpenAccessoryView;
11275
+ /**
11276
+ * Told each time an accessory view opens — again for the same params, or
11277
+ * for others — with its id and params. The host resolves the view's data
11278
+ * elements for those params, and passes them in `sources` with
11279
+ * {@link sourcesFor} saying what they answer.
11280
+ */
11281
+ onAccessoryViewOpen?: (view: AgenticHomeOpenAccessoryView) => void;
11282
+ /** Told when the open accessory view closes. */
11283
+ onAccessoryViewClose?: () => void;
10938
11284
  /**
10939
11285
  * Every press that isn't a plain navigation — and navigations too, after
10940
11286
  * the link has been followed, so the host can track them.
@@ -10943,8 +11289,8 @@ interface F0AgenticHomeProps {
10943
11289
  /**
10944
11290
  * Drawn under the lead section's title (under the greeting when the spec
10945
11291
  * has no sections): the host's own UI, such as the One composer
10946
- * (`F0AiChatTextArea`). The one prop that isn't data — it belongs to the
10947
- * page around the Home, not to the stored spec.
11292
+ * (`F0AiChatTextArea`). Like `greetingActions`, not data — it belongs to
11293
+ * the page around the Home, not to the stored spec.
10948
11294
  */
10949
11295
  composer?: ReactNode;
10950
11296
  /**
@@ -10967,12 +11313,24 @@ interface F0AgenticHomeProps {
10967
11313
  * for a spec that fits. Without it, violations are a console warning.
10968
11314
  */
10969
11315
  onRulesViolation?: (violations: AgenticHomeRuleViolation[]) => void;
11316
+ /**
11317
+ * The accessory view types this host accepts: how each is presented and the
11318
+ * rules its views are drawn within. A spec's view whose type isn't here is
11319
+ * left out and reported (`accessoryViewType`). Omitted, no view opens.
11320
+ */
11321
+ accessoryViewTypes?: AgenticHomeAccessoryViewType[];
10970
11322
  /**
10971
11323
  * Renderers for the visualizations of the host widgets that `widget`
10972
11324
  * elements resolve to (`{ status: "ready", widget }`), merged over f0's
10973
11325
  * built-in ones — the same map `NewHomeLayout` takes.
10974
11326
  */
10975
11327
  slotRenderers?: SlotRenderers;
11328
+ /**
11329
+ * Draws the records a section's text names, written
11330
+ * `[label](mention:<type>:<id>)` — say underlined, with the record's card on
11331
+ * hover. Omitted, a mention reads as its label.
11332
+ */
11333
+ renderMention?: AgenticHomeMentionRenderer;
10976
11334
  }
10977
11335
  //#endregion
10978
11336
  //#region src/domains/platform/home/Home/F0AgenticHome/F0AgenticHome.d.ts
@@ -10983,8 +11341,8 @@ interface F0AgenticHomeProps {
10983
11341
  * its source, and the host resolves it outside the component and passes it
10984
11342
  * in `sources`. Everything it takes is plain data, so a host can store the
10985
11343
  * spec and draw it on every visit without asking anyone to compose it again.
10986
- * The one exception is `composer`, the host's own UI under the lead
10987
- * section's title.
11344
+ * The exceptions are the host's own UI: `composer` under the lead section's
11345
+ * title and `greetingActions` beside the greeting.
10988
11346
  *
10989
11347
  * @experimental This is an experimental component use it at your own risk
10990
11348
  */
@@ -11012,30 +11370,6 @@ interface F0AgenticHomeBlockProps {
11012
11370
  */
11013
11371
  export declare const F0AgenticHomeBlock: import("react").ForwardRefExoticComponent<F0AgenticHomeBlockProps & import("react").RefAttributes<HTMLDivElement>>;
11014
11372
  //#endregion
11015
- //#region src/domains/platform/home/Home/F0AgenticHome/rules/apply.d.ts
11016
- /**
11017
- * The spec within `rules`, and every way it wasn't. Pure: the same spec and
11018
- * rules always give the same result, so a host can run it before storing a
11019
- * spec as well as `F0AgenticHome` does before drawing one.
11020
- *
11021
- * Order matters and is fixed: sections are capped first, then within each
11022
- * section `maxPerSection` and `combinesWith` drop elements in the order they
11023
- * come, then `maxElementsPerSection` keeps the first ones left, and each kept
11024
- * static block is cut to its `maxItems` — a data element's block is cut once
11025
- * resolved, by {@link applyRulesToSources}. Then every `goToSection` must
11026
- * name another section still on the page (always, rules or not), and each
11027
- * static block's items meet its `itemActions`. The lead section's own rules
11028
- * (`lead`) stand in for the rest where they set them.
11029
- */
11030
- export declare const applyAgenticHomeRules: (spec: AgenticHomeSpec, rules: AgenticHomeRules) => {
11031
- spec: AgenticHomeSpec;
11032
- violations: AgenticHomeRuleViolation[];
11033
- };
11034
- //#endregion
11035
- //#region src/domains/platform/home/Home/F0AgenticHome/rules/itemCount.d.ts
11036
- /** How many items a block holds — the count `maxItems` limits. */
11037
- export declare const itemCountOf: (block: AgenticHomeBlock) => number;
11038
- //#endregion
11039
11373
  //#region src/domains/platform/home/Home/F0AgenticHome/rules/recommended.d.ts
11040
11374
  /**
11041
11375
  * A starting point, from the Home prototype: enough for a day's briefing and
@@ -11050,6 +11384,8 @@ export declare const itemCountOf: (block: AgenticHomeBlock) => number;
11050
11384
  * block's actions, which is what a section's `followUps` are for.
11051
11385
  * - **The briefing points the way**: the lead section's list rows each go to
11052
11386
  * a section below (`goToSection`), so the briefing is the page's index.
11387
+ * - **One text block per section**: two read as one text split in two, and
11388
+ * the section's own `text` is already there for the short version.
11053
11389
  */
11054
11390
  export declare const RECOMMENDED_AGENTIC_HOME_RULES: AgenticHomeRules;
11055
11391
  //#endregion
@@ -11331,4 +11667,4 @@ export declare const ScrollArea: WithDataTestIdReturnType<import("react").Forwar
11331
11667
  scrollMargin?: number;
11332
11668
  } & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLElement | SVGElement>>>;
11333
11669
  //#endregion
11334
- export { ActionBarGroup, ActionBarItem, ActionBarStatus, type ActionDefinition, type AgenticHomeAction, type AgenticHomeActionContext, type AgenticHomeAvatar, type AgenticHomeBlock, type AgenticHomeBlockRule, type AgenticHomeBlockType, type AgenticHomeButton, type AgenticHomeChart, type AgenticHomeChartFormat, type AgenticHomeChartSeries, type AgenticHomeChartSpec, type AgenticHomeChartsBlock, type AgenticHomeChartsDisplay, type AgenticHomeCubeSource, type AgenticHomeDataBlock, type AgenticHomeDataBlockType, type AgenticHomeDataElement, type AgenticHomeDataElementOf, type AgenticHomeDataSource, type AgenticHomeDisplayByType, type AgenticHomeElement, type AgenticHomeElementType, type AgenticHomeEvent, type AgenticHomeEventsBlock, type AgenticHomeIcon, type AgenticHomeJsonObject, type AgenticHomeJsonValue, type AgenticHomeListBlock, type AgenticHomeListDisplay, type AgenticHomeListRow, type AgenticHomeMenuItem, type AgenticHomePost, type AgenticHomePostsBlock, type AgenticHomeRowAction, type AgenticHomeRuleViolation, type AgenticHomeRules, type AgenticHomeSection, type AgenticHomeShortcut, type AgenticHomeShortcutsBlock, type AgenticHomeSourceState, type AgenticHomeSpec, type AgenticHomeStat, type AgenticHomeStaticBlock, type AgenticHomeStaticBlockType, type AgenticHomeStaticElement, type AgenticHomeStatsBlock, type AgenticHomeTimelineBlock, type AgenticHomeTimelineItem, type AgenticHomeWidgetElement, type AgenticHomeWidgetSource, type AiCalloutAction, type AiCalloutFinding, type AiCalloutStatus, AiPromotionChat, AiPromotionChatProvider, type AiPromotionChatProviderProps, type AppliedCollectionState, AreaChart, type AttendeesDisplay, Badge, BadgeProps, BannerAction, BarChart, BaseBanner, BaseBannerProps, BaseDataAdapter, BaseFetchOptions, BasePaginatedResponse, BaseResponse, BaseTabs, type BulkAction, type BulkActionDefinition, BulkActionsDefinition, ButtonToggleColor, ButtonToggleSize, ButtonToggleVariant, type CSVExportOptions, CalendarDate, CalendarMode, CalendarSelection, CalendarView, CardSelectableContainer, type CardSelectableContainerProps, type CardSelectableItem, type CardSelectableMultipleProps, type CardSelectableSingleProps, type CardSelectableValue, CategoryBarChart, Chip, ChipProps, type ClockInControlsProps, type ClockInControlsVariant, type ClockInLocation, type ClockInProject, type CoachmarkAction, type CoachmarkEnd, type CoachmarkEndReason, type CoachmarkGuidance, type CoachmarkGuidanceOptions, type CoachmarkGuidanceStep, type CoachmarkId, type CoachmarkOptions, type CoachmarkSequenceOptions, type CoachmarkSingleOptions, type CoachmarkStep, type CoachmarkTarget, type CollectionProps, ComboChart, type CommandAction, type CommandActionRisk, type CommandAssistant, type CommandAvailability, type CommandEntityAction, type CommandEntityActionGroup, type CommandEntityAvatar, type CommandEntityProvider, type CommandEntityRef, type CommandGroup, type CommandImpact, type CommandPaletteLabels, type CommandParamOption, type CommandParamStep, type CommandParamValues, type CommandRowAction, type CommandRowColor, type CommandRunContext, CurrentFilters, type CurrentVersion, type CustomVisualizationProps, DataAdapter, DataCollectionBaseFetchOptions, DataCollectionDataAdapter, DataCollectionPaginatedFetchOptions, DataCollectionSource, DataCollectionSourceDefinition, DataSource, DataSourceDefinition, type DateFilterDefinition, DateNavigationOptions, DatePeriod, DatePeriodsDefinition, DatePickerValue, DatePreset, type DateRange, type DateRangeComplete, DateRangeError, type DateRangeString, DateStringFormat, type DeleteBlockNotesTextEditorPageDocumentPatch, DetailsItem, DetailsItemContent, DetailsItemType, Dropdown, type DropdownItem, type DropdownItemLabel, type DropdownItemObject, type DropdownItemPanel, type DropdownItemSeparator, type DropdownItemSubmenu, type DropdownItemSwitch, type EnhancementOption, type ExcelExportOptions, type ExtractPropertyKeys, F0ActionBar, F0ActionBarRef, type F0AgenticHomeBlockProps, type F0AgenticHomeProps, type F0AiCalloutProps, F0AvatarModule, type F0AvatarModuleProps, F0ButtonToggle, F0ButtonToggleProps, F0CardHorizontal, F0CardHorizontal as F0CardRow, F0CardHorizontalProps, type F0ChatAttachSource, type F0ChatAttachedKind, type F0ChatAttachment, type F0ChatCapabilities, type F0ChatCardAttachment, type F0ChatChannel, type F0ChatChannelStatus, type F0ChatChannelType, type F0ChatComposableAttachment, type F0ChatCreatePostInput, type F0ChatDraftPost, type F0ChatEditInput, type F0ChatEmojiSource, type F0ChatEvents, type F0ChatFileAttachment, type F0ChatForwardedFrom, type F0ChatHeaderAction, type F0ChatHistoryLimit, type F0ChatHistoryLimitDismissAction, type F0ChatImageAttachment, type F0ChatItem, type F0ChatLinkPreview, type F0ChatLocationAttachment, type F0ChatMention, type F0ChatMessage, type F0ChatMessageReply, type F0ChatMessageStatus, type F0ChatMessageTranslation, type F0ChatPinnedPost, type F0ChatPost, type F0ChatPostAction, type F0ChatPostAttachment, type F0ChatPostCommunity, type F0ChatPostEvent, type F0ChatPostRequiredAction, type F0ChatProps, type F0ChatReaction, type F0ChatReactionSource, type F0ChatRuntime, type F0ChatScheduledPost, type F0ChatSearchResult, type F0ChatSendInput, type F0ChatSenderColor, type F0ChatShelfAction, type F0ChatStatus, type F0ChatSurface, type F0ChatSystemEvent, type F0ChatSystemMessage, type F0ChatSystemPayload, type F0ChatUser, type F0ChatUserAction, type F0ChatVoiceAttachment, type F0CommandPaletteApi, type F0CommandPaletteProviderProps, type F0ENPSButtonProps, type F0EmojiPickerProps, type F0EmojiPickerSize, F0FileAction, F0FileItem, F0FileItemProps, F0FileItemSize, type F0FormEditableTableColumn, type F0FormEditableTableProps, F0LocationInput, F0LocationInputChangeMeta, F0LocationInputProps, F0LocationInputShapeProps, F0LocationInputValue, F0LocationSearchContext, F0LocationSuggestion, F0Map, type F0MapArc, type F0MapArea, type F0MapControlLabels, F0MapControls, type F0MapControlsProps, type F0MapHandle, type F0MapLineColor, type F0MapLineStyle, F0MapList, type F0MapListProps, type F0MapMarkerVariant, type F0MapMarkerVariantProps, type F0MapPoint, type F0MapProjection, type F0MapProps, type F0MapProvider, type F0MapRoute, F0MapSidebar, type F0MapSidebarProps, F0MapSidebarToggle, type F0MapSidebarToggleProps, F0MapSkeleton, type F0MapSkeletonProps, type F0MapStyle, type F0MapViewport, type F0MapViewportInset, type F0MeetingCardProps, type F0MeetingRoomProps, type F0MeetingRoster, type F0MeetingStable, type F0MeetingTile, F0NotesTextEditor, F0NotesTextEditorHandle, F0NotesTextEditorProps, F0NotesTextEditorSkeleton, F0NotesTextEditorSkeletonProps, F0NumberInput, F0NumberInputInline, F0NumberInputInlineProps, F0NumberInputProps, F0PhoneInput, F0PhoneInputChangeMeta, F0PhoneInputProps, F0PhoneInputValue, F0ProgressSeries, type F0ProgressSeriesBar, type F0ProgressSeriesColor, type F0ProgressSeriesOptions, type F0ProgressSeriesProps, type F0ProgressSeriesSize, type F0ResizableHandleProps, type F0ResizablePanelProps, type F0ResizableProps, F0ResourceHeader, F0ResourceHeader as ResourceHeader, F0ResourceHeaderProps, type F0ResourceHeaderProps as ResourceHeaderProps, F0RichTextDisplay, F0RichTextDisplayHandle, F0RichTextDisplayProps, F0RichTextEditor, F0RichTextEditorHandle, F0RichTextEditorProps, F0RichTextEditorSkeletonProps, F0SearchInput, F0SearchInputProps, type F0SegmentedBarProps, F0SegmentedControlItem, F0SegmentedControlProps, F0SelectItemMetadata, F0SelectItemObject, type F0SelectItemObject as SelectItemObject, F0SelectItemProps, type F0SelectItemProps as SelectItemProps, F0SelectProps, type F0SelectProps as SelectProps, F0SelectTagProp, F0SelectVariant, F0TextAreaInput, F0TextAreaInputInline, F0TextAreaInputInlineProps, F0TextAreaInputProps, F0TextInput, F0TextInputInline, F0TextInputInlineProps, type F0TextInputProps, type F0TimelineItem, type F0TimelineProps, type F0VersionHistoryProps, F1SearchBox, FILE_TYPES, FileAction, FileItem, FileItemProps, FileItemSize, FileType, type FilterDefinition, FilterOptions, type FilterValue, FilterValueByKey, FiltersDefinition, FiltersMode, FiltersState, GranularityDefinition, GranularityDefinitionKey, GranularityDefinitionSimple, GranularityDefinitionsOptions, type GraphVisualizationOptions, type GridSolution, type GridSolverInput, type GroupMetadataItem, GroupingDefinition, GroupingLevelState, GroupingState, type HeaderProps, type HeaderSecondaryAction, type HeaderStatusProps, type HomeTrackingOptions, type HomeWidgetActionEvent, type HomeWidgetActionKind, type HomeWidgetItemActivateEvent, type ImageUploadConfig, type InFilterDefinition, InfiniteScrollPaginatedResponse, Input, InputProps, type InsertAfterNotesTextEditorPageDocumentPatch, type InsertBeforeNotesTextEditorPageDocumentPatch, type ItemActionsDefinition, ItemNeighborsFetchOptions, ItemNeighborsId, ItemNeighborsResponse, Lane, LineChart, type ListIconColor, type ListIconPaletteColor, LocationInputSize, LocationPart, type MAX_EXPANDED_ACTIONS, type MapUnplaced, type MapVisualizationOptions, type MeetingAttendee, type MeetingJoin, type MeetingSignalStore, type MeetingState, type MentionedUser, type MentionsConfig, type Message, type MetadataItem, type MetadataItemValue, MobileDropdown, ModuleId, type NavigationFilter, type NavigationFilterComponentProps, type NavigationFilterDefinition, type NavigationFilterDefinitionBase, type NavigationFilterValue, type NavigationFiltersDefinition, type NavigationFiltersState, NavigationGranularityKey, NavigationProps, NavigationTarget, NotesTextEditor, NotesTextEditorHandle, type NotesTextEditorPageDocumentPatch, NotesTextEditorProps, NotesTextEditorSkeleton, NotesTextEditorSkeletonProps, type NotesTextEditorSnapshot, type NumberFilterDefinition, NumberInput, type NumberInputPopoverConfig, NumberInputProps, type OnBulkActionCallback, type OnLoadDataCallback, type OnLoadErrorCallback, OnSelectItemsCallback, OneCalendar, OneCalendarInternal, type OneCalendarInternalProps, OneCalendarProps, OneEmptyState, type OneFilterPicker, OptionalCalendarSelection, PageBasedPaginatedResponse, type PageHeaderItemNavigationInput, PageNavigation, PaginatedDataAdapter, PaginatedFetchOptions, PaginatedResponse, PaginationInfo, PaginationType, PhoneInputSize, PieChart, PresetDefinition, PresetSettings, PresetsDefinition, PrevNextDateNavigation, type PrimaryActionButton, type PrimaryActionItemDefinition, type PrimaryActionsDefinitionFn, type PrimaryDropdownAction, ProgressBarChart, PromiseOrObservable, QuickFilterDefinition, RadarChart, RecordType, type ReplaceBlockNotesTextEditorPageDocumentPatch, type ReplaceContentNotesTextEditorPageDocumentPatch, type ResizableDirection, ResolvedRecordType, RichTextDisplay, RichTextDisplayHandle, RichTextDisplayProps, RichTextEditor, RichTextEditorHandle, RichTextEditorProps, RichTextEditorSkeletonProps, type SearchFilterDefinition, SearchPreview, SearchPreviewPage, SearchPreviewResultData, type SecondaryActionGroup, type SecondaryActionItem, type SecondaryActionSplitItem, type SecondaryActionsDefinition, type SecondaryActionsItems, type SeedTarget, type SeedableDefinition, type SegmentColorToken, F0Select as Select, SelectedItemState, SelectedItems, SelectedItemsDetailedStatus, SelectedItemsState, SelectedState, SelectionId, Shortcut, type SidePanelContent, type SidePanelLayout, type SidePanelViewDefinition, SortOrder, SortingKey, SortingsDefinition, SortingsState, SortingsStateMultiple, Spinner, type SpotlightSolution, type SpotlightSolverInput, type SummariesDefinition, type SummaryKey, type SummaryType, type TOCAction, type TOCItem, type TOCItemAction, type TOCProps, TabItem, type TableVisualizationType, Tabs, TabsProps, TabsSkeleton, type TemplateVariable, type TemplateVariablesConfig, Textarea, TextareaProps, ToggleGroup, ToggleGroupItem, Tooltip, TooltipGroup, type TooltipGroupProps, type TooltipProps, type TopLevelAppendNotesTextEditorPageDocumentPatch, type TopLevelPrependNotesTextEditorPageDocumentPatch, type TranscribeFn, UPLOAD_INPUT_ID, type UpsellActionDefinition, type UpsellActionDefinitionFn, type UseDataCollectionItemNavigationProps, type UseDataCollectionItemNavigationReturn, type UsePageHeaderItemNavigationConfig, type User, type Version, type VersionAuthor, VerticalBarChart, type ViewportInset, type VisualizationFilterOverrides, WeekStartDay, type WeekStartsOn, Weekdays, type WidgetContainerSide, type WidgetVirtualization, WiggleOptions, actionBarStatuses, type actionType, buttonToggleColors, buttonToggleSizes, buttonToggleVariants, chipVariants, defaultMapStyle, type editorStateType, type enhanceConfig, type enhanceTextParams, type enhancedTextResponse, f0FileItemSizes, f0MapMarkerVariants, f0MapStyles, f0ProgressSeriesColors, f0ProgressSeriesSizes, type filesConfig, type filterActions, type filterItemActions, getGranularityDefinition, getGranularityDefinitions, getGranularitySimpleDefinition, type getPrimaryActions, type getSecondaryActions, type getUpsellAction, googleMapStyles, googlePinlessMapStyles, granularityDefinitions, type heightType, isPossiblePhoneValue, isValidPhoneValue, type isVisibleAction, type lastIntentType, listIconColors, locationInputSizes, locationParts, modules, phoneInputSizes, predefinedPresets, type primaryActionType, rangeSeparator, resolveGranularityDefinition, type resultType, type secondaryActionType, type secondaryActionsType, selectSizes, selectVariants, type subActionType };
11670
+ export { ActionBarGroup, ActionBarItem, ActionBarStatus, type ActionDefinition, type AgenticHomeAccessoryView, type AgenticHomeAccessoryViewType, type AgenticHomeAction, type AgenticHomeActionContext, type AgenticHomeAvatar, type AgenticHomeChart, type AgenticHomeChartFormat, type AgenticHomeDataBlock, type AgenticHomeDataBlockType, type AgenticHomeElement, type AgenticHomeEvent, type AgenticHomeIcon, type AgenticHomeListRow, type AgenticHomeMention, type AgenticHomeMentionRenderer, type AgenticHomeOpenAccessoryView, type AgenticHomePost, type AgenticHomeRowAction, type AgenticHomeRuleViolation, type AgenticHomeRules, type AgenticHomeSection, type AgenticHomeSourceState, type AgenticHomeSpec, type AgenticHomeStat, type AgenticHomeTimelineItem, type AiCalloutAction, type AiCalloutFinding, type AiCalloutStatus, AiPromotionChat, AiPromotionChatProvider, type AiPromotionChatProviderProps, type AppliedCollectionState, AreaChart, type AttendeesDisplay, Badge, BadgeProps, BannerAction, BarChart, BaseBanner, BaseBannerProps, BaseDataAdapter, BaseFetchOptions, BasePaginatedResponse, BaseResponse, BaseTabs, type BulkAction, type BulkActionDefinition, BulkActionsDefinition, ButtonToggleColor, ButtonToggleSize, ButtonToggleVariant, type CSVExportOptions, CalendarDate, CalendarMode, CalendarSelection, CalendarView, CardSelectableContainer, type CardSelectableContainerProps, type CardSelectableItem, type CardSelectableMultipleProps, type CardSelectableSingleProps, type CardSelectableValue, CategoryBarChart, Chip, ChipProps, type ClockInControlsProps, type ClockInControlsVariant, type ClockInLocation, type ClockInProject, type CoachmarkAction, type CoachmarkEnd, type CoachmarkEndReason, type CoachmarkGuidance, type CoachmarkGuidanceOptions, type CoachmarkGuidanceStep, type CoachmarkId, type CoachmarkOptions, type CoachmarkSequenceOptions, type CoachmarkSingleOptions, type CoachmarkStep, type CoachmarkTarget, type CollectionProps, ComboChart, type CommandAction, type CommandActionRisk, type CommandAssistant, type CommandAvailability, type CommandEntityAction, type CommandEntityActionGroup, type CommandEntityAvatar, type CommandEntityProvider, type CommandEntityRef, type CommandGroup, type CommandImpact, type CommandPaletteLabels, type CommandParamOption, type CommandParamStep, type CommandParamValues, type CommandRowAction, type CommandRowColor, type CommandRunContext, CurrentFilters, type CurrentVersion, type CustomVisualizationProps, DataAdapter, DataCollectionBaseFetchOptions, DataCollectionDataAdapter, DataCollectionPaginatedFetchOptions, DataCollectionSource, DataCollectionSourceDefinition, DataSource, DataSourceDefinition, type DateFilterDefinition, DateNavigationOptions, DatePeriod, DatePeriodsDefinition, DatePickerValue, DatePreset, type DateRange, type DateRangeComplete, DateRangeError, type DateRangeString, DateStringFormat, type DeleteBlockNotesTextEditorPageDocumentPatch, DetailsItem, DetailsItemContent, DetailsItemType, Dropdown, type DropdownItem, type DropdownItemLabel, type DropdownItemObject, type DropdownItemPanel, type DropdownItemSeparator, type DropdownItemSubmenu, type DropdownItemSwitch, type EnhancementOption, type ExcelExportOptions, type ExtractPropertyKeys, F0ActionBar, F0ActionBarRef, type F0AgenticHomeBlockProps, type F0AgenticHomeGreetingAction, type F0AgenticHomeProps, type F0AiCalloutProps, F0AvatarModule, type F0AvatarModuleProps, F0ButtonToggle, F0ButtonToggleProps, F0CardHorizontal, F0CardHorizontal as F0CardRow, F0CardHorizontalProps, type F0ChatAttachSource, type F0ChatAttachedKind, type F0ChatAttachment, type F0ChatCapabilities, type F0ChatCardAttachment, type F0ChatChannel, type F0ChatChannelStatus, type F0ChatChannelType, type F0ChatComposableAttachment, type F0ChatCreatePostInput, type F0ChatDraftPost, type F0ChatEditInput, type F0ChatEmojiSource, type F0ChatEvents, type F0ChatFileAttachment, type F0ChatForwardedFrom, type F0ChatHeaderAction, type F0ChatHistoryLimit, type F0ChatHistoryLimitDismissAction, type F0ChatImageAttachment, type F0ChatItem, type F0ChatLinkPreview, type F0ChatLocationAttachment, type F0ChatMention, type F0ChatMessage, type F0ChatMessageReply, type F0ChatMessageStatus, type F0ChatMessageTranslation, type F0ChatPinnedPost, type F0ChatPost, type F0ChatPostAction, type F0ChatPostAttachment, type F0ChatPostCommunity, type F0ChatPostEvent, type F0ChatPostRequiredAction, type F0ChatProps, type F0ChatReaction, type F0ChatReactionSource, type F0ChatRuntime, type F0ChatScheduledPost, type F0ChatSearchResult, type F0ChatSendInput, type F0ChatSenderColor, type F0ChatShelfAction, type F0ChatStatus, type F0ChatSurface, type F0ChatSystemEvent, type F0ChatSystemMessage, type F0ChatSystemPayload, type F0ChatUser, type F0ChatUserAction, type F0ChatVoiceAttachment, type F0CommandPaletteApi, type F0CommandPaletteProviderProps, type F0ENPSButtonProps, type F0EmojiPickerProps, type F0EmojiPickerSize, F0FileAction, F0FileItem, F0FileItemProps, F0FileItemSize, type F0FormEditableTableColumn, type F0FormEditableTableProps, F0LocationInput, F0LocationInputChangeMeta, F0LocationInputProps, F0LocationInputShapeProps, F0LocationInputValue, F0LocationSearchContext, F0LocationSuggestion, F0Map, type F0MapArc, type F0MapArea, type F0MapControlLabels, F0MapControls, type F0MapControlsProps, type F0MapHandle, type F0MapLineColor, type F0MapLineStyle, F0MapList, type F0MapListProps, type F0MapMarkerVariant, type F0MapMarkerVariantProps, type F0MapPoint, type F0MapProjection, type F0MapProps, type F0MapProvider, type F0MapRoute, F0MapSidebar, type F0MapSidebarProps, F0MapSidebarToggle, type F0MapSidebarToggleProps, F0MapSkeleton, type F0MapSkeletonProps, type F0MapStyle, type F0MapViewport, type F0MapViewportInset, type F0MeetingCardProps, type F0MeetingRoomProps, type F0MeetingRoster, type F0MeetingStable, type F0MeetingTile, F0NotesTextEditor, F0NotesTextEditorHandle, F0NotesTextEditorProps, F0NotesTextEditorSkeleton, F0NotesTextEditorSkeletonProps, F0NumberInput, F0NumberInputInline, F0NumberInputInlineProps, F0NumberInputProps, F0PhoneInput, F0PhoneInputChangeMeta, F0PhoneInputProps, F0PhoneInputValue, F0ProgressSeries, type F0ProgressSeriesBar, type F0ProgressSeriesColor, type F0ProgressSeriesOptions, type F0ProgressSeriesProps, type F0ProgressSeriesSize, type F0ResizableHandleProps, type F0ResizablePanelProps, type F0ResizableProps, F0ResourceHeader, F0ResourceHeader as ResourceHeader, F0ResourceHeaderProps, type F0ResourceHeaderProps as ResourceHeaderProps, F0RichTextDisplay, F0RichTextDisplayHandle, F0RichTextDisplayProps, F0RichTextEditor, F0RichTextEditorHandle, F0RichTextEditorProps, F0RichTextEditorSkeletonProps, F0SearchInput, F0SearchInputProps, type F0SegmentedBarProps, F0SegmentedControlItem, F0SegmentedControlProps, F0SelectItemMetadata, F0SelectItemObject, type F0SelectItemObject as SelectItemObject, F0SelectItemProps, type F0SelectItemProps as SelectItemProps, F0SelectProps, type F0SelectProps as SelectProps, F0SelectTagProp, F0SelectVariant, F0TextAreaInput, F0TextAreaInputInline, F0TextAreaInputInlineProps, F0TextAreaInputProps, F0TextInput, F0TextInputInline, F0TextInputInlineProps, type F0TextInputProps, type F0TimelineItem, type F0TimelineProps, type F0VersionHistoryProps, F1SearchBox, FILE_TYPES, FileAction, FileItem, FileItemProps, FileItemSize, FileType, type FilterDefinition, FilterOptions, type FilterValue, FilterValueByKey, FiltersDefinition, FiltersMode, FiltersState, GranularityDefinition, GranularityDefinitionKey, GranularityDefinitionSimple, GranularityDefinitionsOptions, type GraphVisualizationOptions, type GridSolution, type GridSolverInput, type GroupMetadataItem, GroupingDefinition, GroupingLevelState, GroupingState, type HeaderProps, type HeaderSecondaryAction, type HeaderStatusProps, type HomeTrackingOptions, type HomeWidgetActionEvent, type HomeWidgetActionKind, type HomeWidgetItemActivateEvent, type ImageUploadConfig, type InFilterDefinition, InfiniteScrollPaginatedResponse, Input, InputProps, type InsertAfterNotesTextEditorPageDocumentPatch, type InsertBeforeNotesTextEditorPageDocumentPatch, type ItemActionsDefinition, ItemNeighborsFetchOptions, ItemNeighborsId, ItemNeighborsResponse, Lane, LineChart, type ListIconColor, type ListIconPaletteColor, LocationInputSize, LocationPart, type MAX_EXPANDED_ACTIONS, type MapUnplaced, type MapVisualizationOptions, type MeetingAttendee, type MeetingJoin, type MeetingSignalStore, type MeetingState, type MentionedUser, type MentionsConfig, type Message, type MetadataItem, type MetadataItemValue, MobileDropdown, ModuleId, type NavigationFilter, type NavigationFilterComponentProps, type NavigationFilterDefinition, type NavigationFilterDefinitionBase, type NavigationFilterValue, type NavigationFiltersDefinition, type NavigationFiltersState, NavigationGranularityKey, NavigationProps, NavigationTarget, NotesTextEditor, NotesTextEditorHandle, type NotesTextEditorPageDocumentPatch, NotesTextEditorProps, NotesTextEditorSkeleton, NotesTextEditorSkeletonProps, type NotesTextEditorSnapshot, type NumberFilterDefinition, NumberInput, type NumberInputPopoverConfig, NumberInputProps, type OnBulkActionCallback, type OnLoadDataCallback, type OnLoadErrorCallback, OnSelectItemsCallback, OneCalendar, OneCalendarInternal, type OneCalendarInternalProps, OneCalendarProps, OneEmptyState, type OneFilterPicker, OptionalCalendarSelection, PageBasedPaginatedResponse, type PageHeaderItemNavigationInput, PageNavigation, PaginatedDataAdapter, PaginatedFetchOptions, PaginatedResponse, PaginationInfo, PaginationType, PhoneInputSize, PieChart, PresetDefinition, PresetSettings, PresetsDefinition, PrevNextDateNavigation, type PrimaryActionButton, type PrimaryActionItemDefinition, type PrimaryActionsDefinitionFn, type PrimaryDropdownAction, ProgressBarChart, PromiseOrObservable, QuickFilterDefinition, RadarChart, RecordType, type ReplaceBlockNotesTextEditorPageDocumentPatch, type ReplaceContentNotesTextEditorPageDocumentPatch, type ResizableDirection, ResolvedRecordType, RichTextDisplay, RichTextDisplayHandle, RichTextDisplayProps, RichTextEditor, RichTextEditorHandle, RichTextEditorProps, RichTextEditorSkeletonProps, type SearchFilterDefinition, SearchPreview, SearchPreviewPage, SearchPreviewResultData, type SecondaryActionGroup, type SecondaryActionItem, type SecondaryActionSplitItem, type SecondaryActionsDefinition, type SecondaryActionsItems, type SeedTarget, type SeedableDefinition, type SegmentColorToken, F0Select as Select, SelectedItemState, SelectedItems, SelectedItemsDetailedStatus, SelectedItemsState, SelectedState, SelectionId, Shortcut, type SidePanelContent, type SidePanelLayout, type SidePanelViewDefinition, SortOrder, SortingKey, SortingsDefinition, SortingsState, SortingsStateMultiple, Spinner, type SpotlightSolution, type SpotlightSolverInput, type SummariesDefinition, type SummaryKey, type SummaryType, type TOCAction, type TOCItem, type TOCItemAction, type TOCProps, TabItem, type TableVisualizationType, Tabs, TabsProps, TabsSkeleton, type TemplateVariable, type TemplateVariablesConfig, Textarea, TextareaProps, ToggleGroup, ToggleGroupItem, Tooltip, TooltipGroup, type TooltipGroupProps, type TooltipProps, type TopLevelAppendNotesTextEditorPageDocumentPatch, type TopLevelPrependNotesTextEditorPageDocumentPatch, type TranscribeFn, UPLOAD_INPUT_ID, type UpsellActionDefinition, type UpsellActionDefinitionFn, type UseDataCollectionItemNavigationProps, type UseDataCollectionItemNavigationReturn, type UsePageHeaderItemNavigationConfig, type User, type Version, type VersionAuthor, VerticalBarChart, type ViewportInset, type VisualizationFilterOverrides, WeekStartDay, type WeekStartsOn, Weekdays, type WidgetContainerSide, type WidgetVirtualization, WiggleOptions, actionBarStatuses, type actionType, buttonToggleColors, buttonToggleSizes, buttonToggleVariants, chipVariants, defaultMapStyle, type editorStateType, type enhanceConfig, type enhanceTextParams, type enhancedTextResponse, f0FileItemSizes, f0MapMarkerVariants, f0MapStyles, f0ProgressSeriesColors, f0ProgressSeriesSizes, type filesConfig, type filterActions, type filterItemActions, getGranularityDefinition, getGranularityDefinitions, getGranularitySimpleDefinition, type getPrimaryActions, type getSecondaryActions, type getUpsellAction, googleMapStyles, googlePinlessMapStyles, granularityDefinitions, type heightType, isPossiblePhoneValue, isValidPhoneValue, type isVisibleAction, type lastIntentType, listIconColors, locationInputSizes, locationParts, modules, phoneInputSizes, predefinedPresets, type primaryActionType, rangeSeparator, resolveGranularityDefinition, type resultType, type secondaryActionType, type secondaryActionsType, selectSizes, selectVariants, type subActionType };