@factorialco/f0-react 7.22.0 → 7.24.0

package/dist/experimental.d.ts

@@ -2,16 +2,16 @@ import { AiCalloutAction as AiCalloutAction_2 } from './types';
 import { AiCalloutFinding as AiCalloutFinding_2 } from './types';
 import { AiCalloutStatus as AiCalloutStatus_2 } from './types';
 import { AlertAvatarProps as AlertAvatarProps_2 } from './F0AvatarAlert';
-import { AlertTagCellValue } from './types/alertTag';
-import { AlertTagCellValue as AlertTagCellValue_2 } from './experimental';
-import { AmountCellValue } from './types/amount';
-import { AmountCellValue as AmountCellValue_2 } from './experimental';
+import { AlertTagCellValue } from './experimental';
+import { AlertTagCellValue as AlertTagCellValue_2 } from './types/alertTag';
+import { AmountCellValue } from './experimental';
+import { AmountCellValue as AmountCellValue_2 } from './types/amount';
 import { AnchorHTMLAttributes } from 'react';
 import { AreaChartWidgetProps } from './AreaChartWidget';
 import { AriaAttributes } from 'react';
 import { AutoFill as AutoFill_2 } from 'react';
-import { AvatarListCellValue } from './types/avatarList';
-import { AvatarListCellValue as AvatarListCellValue_2 } from './experimental';
+import { AvatarListCellValue } from './experimental';
+import { AvatarListCellValue as AvatarListCellValue_2 } from './types/avatarList';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import { BarChartProps } from './experimental';
 import { BarSeriesCellValue } from './types/barSeries';
@@ -23,8 +23,8 @@ import { ChartConfig } from './experimental';
 import { ChartConfig as ChartConfig_2 } from './utils/types';
 import { ChartPropsBase } from './utils/types';
 import { ClassValue } from 'cva';
-import { CompanyCellValue } from './types/company';
-import { CompanyCellValue as CompanyCellValue_2 } from './experimental';
+import { CompanyCellValue } from './experimental';
+import { CompanyCellValue as CompanyCellValue_2 } from './types/company';
 import { CompanyItemProps } from './types';
 import { ComponentProps } from 'react';
 import { CompoundCellValue } from './types/compound';
@@ -32,14 +32,14 @@ import { Context } from 'react';
 import { CountCellValue } from './types/count';
 import { CountryCellValue } from './types/country';
 import { DataAttributes as DataAttributes_2 } from './experimental';
-import { DateCellValue } from './types/date';
-import { DateCellValue as DateCellValue_2 } from './experimental';
+import { DateCellValue } from './experimental';
+import { DateCellValue as DateCellValue_2 } from './types/date';
 import { DateFilterOptions } from './DateFilter/DateFilter';
 import { default as default_2 } from 'react';
 import { DeltaCellValue } from './types/delta';
 import { Dispatch } from 'react';
-import { DotTagCellValue } from './types/dotTag';
-import { DotTagCellValue as DotTagCellValue_2 } from './experimental';
+import { DotTagCellValue } from './experimental';
+import { DotTagCellValue as DotTagCellValue_2 } from './types/dotTag';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import { EmployeeItemProps } from './types';
 import { F0CommandPaletteProviderProps as F0CommandPaletteProviderProps_2 } from './types';
@@ -56,10 +56,10 @@ import { F0TagRawProps as F0TagRawProps_2 } from './types';
 import { F0TagTeamProps } from './types';
 import { f1Colors } from '@factorialco/f0-core';
 import { FC } from 'react';
-import { FileCellValue } from './types/file';
-import { FileCellValue as FileCellValue_2 } from './experimental';
-import { FolderCellValue } from './types/folder';
-import { FolderCellValue as FolderCellValue_2 } from './experimental';
+import { FileCellValue } from './experimental';
+import { FileCellValue as FileCellValue_2 } from './types/file';
+import { FolderCellValue } from './experimental';
+import { FolderCellValue as FolderCellValue_2 } from './types/folder';
 import { ForwardedRef } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { HourDistributionCellValue } from './types/hourDistribution';
@@ -77,19 +77,19 @@ import { LineChartConfig } from './experimental';
 import { LineChartProps } from './experimental';
 import { LineChartPropsBase } from './utils/types';
 import { LongTextCellValue } from './types/longText';
-import { NumberCellValue } from './types/number';
-import { NumberCellValue as NumberCellValue_2 } from './experimental';
+import { NumberCellValue } from './experimental';
+import { NumberCellValue as NumberCellValue_2 } from './types/number';
 import { NumberFilterOptions } from './NumberFilter/NumberFilter';
 import { Observable } from 'zen-observable-ts';
 import { PercentageCellValue } from './types/percentage';
-import { PersonCellValue } from './types/person';
-import { PersonCellValue as PersonCellValue_2 } from './experimental';
+import { PersonCellValue } from './experimental';
+import { PersonCellValue as PersonCellValue_2 } from './types/person';
 import { PieChartProps } from './PieChart';
 import { PieChartProps as PieChartProps_2 } from './experimental';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import { PopoverProps } from '@radix-ui/react-popover';
-import { ProgressBarCellValue } from './types/progressBar';
-import { ProgressBarCellValue as ProgressBarCellValue_2 } from './experimental';
+import { ProgressBarCellValue } from './experimental';
+import { ProgressBarCellValue as ProgressBarCellValue_2 } from './types/progressBar';
 import { ProgressSeriesCellValue } from './types/progressSeries';
 import { Props as Props_5 } from './types';
 import { PropsWithChildren } from 'react';
@@ -103,29 +103,29 @@ import { RefAttributes } from 'react';
 import { RefObject } from 'react';
 import { ScrollAreaProps } from '@radix-ui/react-scroll-area';
 import { SearchFilterOptions } from './SearchFilter/SearchFilter';
-import { StatusCellValue } from './types/status';
-import { StatusCellValue as StatusCellValue_2 } from './experimental';
+import { StatusCellValue } from './experimental';
+import { StatusCellValue as StatusCellValue_2 } from './types/status';
 import { SummaryCellValue } from './types/summary';
 import { SVGProps } from 'react';
 import { TagAlertProps } from './experimental';
 import { TagBalanceProps } from './experimental';
-import { TagCellValue } from './types/tag';
-import { TagCellValue as TagCellValue_2 } from './experimental';
+import { TagCellValue } from './experimental';
+import { TagCellValue as TagCellValue_2 } from './types/tag';
 import { TagDotProps } from './experimental';
-import { TagListCellValue } from './types/tagList';
-import { TagListCellValue as TagListCellValue_2 } from './experimental';
+import { TagListCellValue } from './experimental';
+import { TagListCellValue as TagListCellValue_2 } from './types/tagList';
 import { TagListProps } from './experimental';
 import { TagRawProps } from './experimental';
 import { TagStatusProps } from './experimental';
 import { TagType } from './experimental';
-import { TeamCellValue } from './types/team';
-import { TeamCellValue as TeamCellValue_2 } from './experimental';
+import { TeamCellValue } from './experimental';
+import { TeamCellValue as TeamCellValue_2 } from './types/team';
 import { TeamItemProps } from './types';
 import { TextareaHTMLAttributes } from 'react';
-import { TextCellValue } from './types/text';
-import { TextCellValue as TextCellValue_2 } from './experimental';
+import { TextCellValue } from './experimental';
+import { TextCellValue as TextCellValue_2 } from './types/text';
 import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
-import { ValueDisplayRendererContext as ValueDisplayRendererContext_2 } from './experimental';
+import { ValueDisplayRendererContext } from './experimental';
 import { VariantProps } from 'cva';
 import { VerticalBarChartProps } from './experimental';
 import { VirtualItem } from '@tanstack/react-virtual';
@@ -2378,22 +2378,22 @@ declare type CardPropertyDefinition<T> = PropertyDefinition_2<T> & {
 };
 
 declare const cardPropertyRenderers: {
-    readonly text: (args: TextCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly number: (args: NumberCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly date: (args: DateCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly amount: (args: AmountCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly person: (args: PersonCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly company: (args: CompanyCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly team: (args: TeamCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly status: (args: StatusCellValue_2) => default_2.JSX.Element;
-    readonly tag: (args: TagCellValue_2) => default_2.JSX.Element;
-    readonly avatarList: (args: AvatarListCellValue_2, meta: ValueDisplayRendererContext_2) => default_2.JSX.Element;
-    readonly tagList: (args: TagListCellValue_2) => default_2.JSX.Element;
-    readonly alertTag: (args: AlertTagCellValue_2) => default_2.JSX.Element;
-    readonly dotTag: (args: DotTagCellValue_2) => default_2.JSX.Element;
-    readonly file: (args: FileCellValue_2) => default_2.JSX.Element;
-    readonly folder: (args: FolderCellValue_2) => default_2.JSX.Element;
-    readonly progressBar: (args: ProgressBarCellValue_2, _meta: ValueDisplayRendererContext_2) => default_2.JSX.Element | null;
+    readonly text: (args: TextCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly number: (args: NumberCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly date: (args: DateCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly amount: (args: AmountCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly person: (args: PersonCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly company: (args: CompanyCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly team: (args: TeamCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly status: (args: StatusCellValue) => default_2.JSX.Element;
+    readonly tag: (args: TagCellValue) => default_2.JSX.Element;
+    readonly avatarList: (args: AvatarListCellValue, meta: ValueDisplayRendererContext) => default_2.JSX.Element;
+    readonly tagList: (args: TagListCellValue) => default_2.JSX.Element;
+    readonly alertTag: (args: AlertTagCellValue) => default_2.JSX.Element;
+    readonly dotTag: (args: DotTagCellValue) => default_2.JSX.Element;
+    readonly file: (args: FileCellValue) => default_2.JSX.Element;
+    readonly folder: (args: FolderCellValue) => default_2.JSX.Element;
+    readonly progressBar: (args: ProgressBarCellValue, _meta: ValueDisplayRendererContext) => default_2.JSX.Element | null;
 };
 
 declare type CardPropertyType = keyof typeof cardPropertyRenderers;
@@ -3567,6 +3567,7 @@ declare type CollectionVisualizations<Record extends RecordType, Filters extends
     card: VisualizacionTypeDefinition<CardCollectionProps<Record, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping>>;
     kanban: VisualizacionTypeDefinition<KanbanCollectionProps<Record, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping>>;
     graph: VisualizacionTypeDefinition<GraphCollectionProps<Record, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping>, GraphVisualizationSettings>;
+    map: VisualizacionTypeDefinition<MapCollectionProps<Record, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping>>;
 };
 
 declare const collectionVisualizations: CollectionVisualizations<RecordType, FiltersDefinition, SortingsDefinition, SummariesDefinition, ItemActionsDefinition<RecordType>, NavigationFiltersDefinition, GroupingDefinition<RecordType>>;
@@ -5499,6 +5500,7 @@ declare const defaultTranslations: {
             readonly list: "List";
             readonly kanban: "Kanban";
             readonly graph: "Graph";
+            readonly map: "Map";
             readonly pagination: {
                 readonly of: "of";
             };
@@ -5506,6 +5508,11 @@ declare const defaultTranslations: {
             readonly reset: "Reset to default";
             readonly viewSelectorLabel: "Select view";
         };
+        readonly map: {
+            readonly notOnMap: "Not on map";
+            readonly onMap: "On map";
+            readonly notOnMapCount: "{{count}} not on map";
+        };
         readonly table: {
             readonly seeMoreChildren: "See more";
             readonly settings: {
@@ -6398,11 +6405,15 @@ declare const defaultTranslations: {
         readonly loadError: "Couldn't load the map.";
         readonly retry: "Retry";
         readonly currentLocation: "Your location";
+        readonly panel: "Map panel";
+        readonly detailPanel: "Map detail panel";
         readonly controls: {
             readonly zoomIn: "Zoom in";
             readonly zoomOut: "Zoom out";
             readonly fit: "Fit to markers";
             readonly locate: "My location";
+            readonly showPanel: "Show panel";
+            readonly hidePanel: "Hide panel";
         };
     };
     readonly wizard: {
@@ -6691,6 +6702,10 @@ export declare function downloadAsCSV<R extends RecordType, Filters extends Filt
  */
 export declare const Dropdown: (props: DropdownProps) => JSX_2.Element;
 
+declare type DropdownContentVariant = (typeof dropdownContentVariants)[number];
+
+declare const dropdownContentVariants: readonly ["expanded", "reduced"];
+
 declare type DropdownInternalProps = {
     items: DropdownItem[];
     icon?: IconType;
@@ -6717,6 +6732,14 @@ declare type DropdownInternalProps = {
      * focus back and forth until the call stack gives out.
      */
     container?: HTMLElement | null;
+    /**
+     * Caps the width of the menu content.
+     * - "expanded": (default) sizes to content, same as today.
+     * - "reduced": caps the menu at 300px, e.g. when an item's `description`
+     *   is long enough to otherwise stretch the menu.
+     * @default "expanded"
+     */
+    contentVariant?: DropdownContentVariant;
 } & DataAttributes_3;
 
 export declare type DropdownItem = DropdownItemObject | DropdownItemSeparator | DropdownItemLabel;
@@ -10166,6 +10189,17 @@ export declare interface F0MapProps extends WithDataTestIdProps {
      * grown pin) stays driven by `selectedMarkerId`.
      */
     highlightedId?: string | null;
+    /**
+     * Region covered by the consumer's own chrome, in screen px - a panel opened
+     * over the map. Camera moves land their target in the free area, and a
+     * change replays the last move. The map's own panels are folded in already.
+     */
+    viewportInset?: F0MapViewportInset;
+    /**
+     * Re-center a clicked marker in the free area, at the current zoom. Defaults
+     * to `false`. The `focusMarker` handle is the one that also zooms in.
+     */
+    centerOnMarkerClick?: boolean;
     /**
      * Frame all markers on load. Defaults to `true` when no `initialViewport` is
      * given, `false` otherwise (an explicit viewport wins).
@@ -10210,11 +10244,33 @@ export declare interface F0MapProps extends WithDataTestIdProps {
     showCurrentLocation?: boolean;
     /**
      * Edge-to-edge presentation. `false` (default) frames the map as a card -
-     * large rounded corners, a secondary border, and controls inset 16px. `true`
-     * drops the frame so the map bleeds to its container's edges, with controls
-     * inset 24px.
+     * large rounded corners and a secondary border. `true` drops the frame so the
+     * map bleeds to its container's edges. The controls sit 8px off the edges
+     * either way.
      */
     fullScreen?: boolean;
+    /** Shows the side panel's toggle in the top-left corner. */
+    onSidebarToggle?: () => void;
+    /** Whether the side panel is open. Defaults to `false`. */
+    sidebarExpanded?: boolean;
+    /** A control beside the toggle while the panel is closed, e.g. a count that opens it. */
+    sidebarToggleAddon?: ReactNode;
+    /** A control at the start of the open panel's header row, opposite its toggle. */
+    sidebarHeaderStart?: ReactNode;
+    /** Side panel content, edge to edge: it brings its own insets and scrolling. */
+    sidebar?: ReactNode;
+    /** A second panel, opened beside the side panel while `detailOpen`. */
+    detail?: ReactNode;
+    /**
+     * Whether the detail panel is open. Defaults to `false`. While it is, Escape
+     * ends the selection, which is what closes it.
+     */
+    detailOpen?: boolean;
+    /**
+     * Clear the selection on a background click. Defaults to `true`. Turn it off
+     * when the selection opens something that must be dismissed deliberately.
+     */
+    clearSelectionOnBackgroundClick?: boolean;
     /**
      * Map projection. `"mercator"` (default) is the flat web map; `"globe"`
      * renders the world as a 3D sphere at low zoom and eases into mercator as you
@@ -10244,6 +10300,52 @@ export declare interface F0MapRoute extends F0MapLineStyle {
     coordinates: [number, number][];
 }
 
+/**
+ * A map side panel on the overlay material. Stays mounted and transitions out
+ * of frame (the map clips it), `inert` while away. A CSS transition, so no
+ * ancestor `MotionConfig` can override it (`ApplicationFrame` sets one).
+ */
+export declare const F0MapSidebar: ({ children, open, offsetX, offsetY, width, entrance, headerStart, headerEnd, ariaLabel, dataTestId, }: F0MapSidebarProps) => JSX_2.Element;
+
+export declare interface F0MapSidebarProps extends WithDataTestIdProps {
+    /** Content, edge to edge: it brings its own insets and scrolling. */
+    children?: ReactNode;
+    open: boolean;
+    /** Distance from the map's left edge, in px. */
+    offsetX: number;
+    /** Distance from the map's top edge, in px. Defaults to the shared inset. */
+    offsetY?: number;
+    /** Panel width, in px. */
+    width: number;
+    /**
+     * `"slide"` (default) travels in from the map's edge. `"grow"` scales into
+     * place, for a panel opening beside another it would otherwise cross.
+     */
+    entrance?: "slide" | "grow";
+    /** A control at the start of the panel's header row; takes the room left. */
+    headerStart?: ReactNode;
+    /** A control at the far end of that row. */
+    headerEnd?: ReactNode;
+    /** Defaults to the map's panel label. */
+    ariaLabel?: string;
+}
+
+/**
+ * Opens and closes the map's side panel, with the application sidebar's icon.
+ * Presentational, like `F0MapControls`: `F0Map` positions it and owns the state.
+ */
+export declare const F0MapSidebarToggle: ForwardRefExoticComponent<F0MapSidebarToggleProps & RefAttributes<HTMLButtonElement>>;
+
+export declare interface F0MapSidebarToggleProps extends WithDataTestIdProps {
+    /** Whether the panel this button controls is currently open. */
+    expanded: boolean;
+    onToggle: () => void;
+    /** Overrides the default show / hide label. */
+    label?: string;
+    /** Drop the overlay card, for the toggle inside a panel. */
+    bare?: boolean;
+}
+
 /**
  * Loading placeholder: a plain pulsing surface in the shared `Skeleton`
  * component's tone. Shown while a consumer is still fetching what the map
@@ -10287,6 +10389,25 @@ export declare interface F0MapViewport {
     zoom?: number;
 }
 
+/**
+ * Region of the map (in screen px) covered by external chrome - typically a
+ * side panel the consumer opens over it. Every camera move (fit, focus, reveal)
+ * shifts its target so the point lands centred in the *free* area beside the
+ * panel instead of behind it. The side is encoded by which key is set: a
+ * right-hand panel sets `right`, a left-hand one or RTL sets `left`.
+ *
+ * The consumer supplies the value - `F0Map` has no notion of the panel. For a
+ * fixed-width drawer pass its width while it is open (e.g. `{ right: 480 }`)
+ * and `undefined` / `{}` while it is closed. Omitted or `0` on every side
+ * behaves exactly as if there were no inset.
+ */
+export declare interface F0MapViewportInset {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+
 /**
  * Makes a meeting available to the app and renders its surface.
  *
@@ -13993,6 +14114,105 @@ export declare type LocationPart = (typeof locationParts)[number];
 /** Every part the manual entry block renders, in the order it renders them */
 export declare const locationParts: readonly ["country", "addressLine1", "addressLine2", "city", "state", "postalCode"];
 
+declare type MapCollectionProps<Record extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition, ItemActions extends ItemActionsDefinition<Record>, NavigationFilters extends NavigationFiltersDefinition, Grouping extends GroupingDefinition<Record>> = CollectionProps<Record, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping, MapVisualizationOptions<Record, Filters, Sortings>>;
+
+/** Selection handles handed to the panels, so their content can drive the map. */
+declare type MapSidebarApi<R extends RecordType> = {
+    /** Select a record (or clear with `null`), flying to its marker if it has one. */
+    select: (record: R | null) => void;
+    selectedRecordId: string | null;
+    /**
+     * What the map did with a record: `"placed"`, `"unplaced"` (no reason
+     * given), or the `MapUnplaced` kind. Per record, so it also answers in the
+     * search's flat list.
+     */
+    placement: (record: R) => "placed" | "unplaced" | MapUnplaced["kind"];
+};
+
+/**
+ * Why a record has no position, returned from `coordinates` instead of one.
+ * `incomplete`: it should have a location and doesn't (an unfilled or
+ * ungeocodable address) - the case somebody can fix.
+ */
+export declare type MapUnplaced = {
+    kind: "incomplete";
+};
+
+/**
+ * Options for the map visualization: records projected onto coordinates. Only
+ * reading a record's position is required; how markers look and behave is
+ * `F0Map`'s concern.
+ */
+export declare type MapVisualizationOptions<R extends RecordType, _Filters extends FiltersDefinition, _Sortings extends SortingsDefinition> = {
+    /**
+     * A record's `[longitude, latitude]`. `null` or a `MapUnplaced` draws no
+     * marker, and the record is listed under "Not on map" instead. No geocoding
+     * happens here: resolve coordinates server-side.
+     */
+    coordinates: (record: R) => [number, number] | null | MapUnplaced;
+    /** Label beside the marker. Omitted means an unlabelled pin. */
+    label?: (record: R) => string;
+    /** Marker variant per record. Defaults to `default`. */
+    marker?: (record: R) => F0MapMarkerVariantProps;
+    /** A record's id. Defaults to `String(record.id)`, like the graph view. */
+    getRecordId?: (record: R) => string;
+    /**
+     * Controlled selection, `null` for none. Pass it whenever something outside
+     * the map can end the selection, like closing the panel `onSelect` opened.
+     */
+    selectedRecordId?: string | null;
+    /**
+     * Fired when the selection changes: a marker click, a reveal, a panel row,
+     * or `null` when it clears. If it opens your own chrome over the map, report
+     * the region it covers through `viewportInset`.
+     */
+    onSelect?: (record: R | null) => void;
+    /**
+     * Flies to a record and selects it, e.g. from an external search. Pair it
+     * with the collection's `searchSelectionNonce` so a repeat pick flies again.
+     */
+    revealRecordId?: string | null;
+    /** Region covered by your own chrome. The map's own panels are folded in. */
+    viewportInset?: F0MapViewportInset;
+    /** Initial camera. Defaults to framing every marker. */
+    initialViewport?: F0MapViewport;
+    /** Show the navigation controls (locate / fit / zoom). Defaults to `true`. */
+    showControls?: boolean;
+    /** Fired with the side panel's new open state. */
+    onSidebarToggle?: (expanded: boolean) => void;
+    /** Map projection. Defaults to `"mercator"`. */
+    projection?: F0MapProjection;
+    /**
+     * Rendering engine. Defaults to the one the app sets on `F0Provider`, so a
+     * product that configures Google gets it here too; set it only to override
+     * that for this view.
+     */
+    provider?: F0MapProvider;
+    /**
+     * Records to request in the one page the map loads, capped at the map's
+     * recommended marker ceiling.
+     */
+    markerLimit?: number;
+    /** Accessible label for the map region. */
+    ariaLabel?: string;
+    /**
+     * Rows of the side panel, for the records of one section ("Not on map",
+     * then "On map") or for the matches of the panel's search. They are the
+     * records the map is drawing, from the same load. Return rows only: the
+     * panel owns the scrolling. `select` drives the same selection a marker
+     * click does.
+     */
+    sidebar?: (records: R[], api: MapSidebarApi<R>) => ReactNode;
+    /**
+     * Text the panel's search matches a record against. Given it, the panel's
+     * header offers a search over the records the panel holds; the toolbar's
+     * search still narrows the whole view.
+     */
+    sidebarSearchText?: (record: R) => string;
+    /** Detail panel for the selected record, beside the side panel. */
+    detail?: (record: R, api: MapSidebarApi<R>) => ReactNode;
+};
+
 declare const markerColors: readonly ["neutral", "grey", "radical", "malibu", "viridian", "flubber", "grass", "camel", "indigo", "lilac", "orange", "purple", "yellow", "red", "army", "smoke", "barbie"];
 
 export declare const MAX_EXPANDED_ACTIONS = 2;
@@ -15213,6 +15433,14 @@ declare type OneDataCollectionProps<R extends RecordType, Filters extends Filter
     savingViewsDisabled?: boolean;
     /** Visualization index rendered on mount, before async storage/URL restore — lets a consumer boot straight into the persisted view and skip the default→restore bounce. Defaults to 0. */
     initialVisualization?: number;
+    /**
+     * Caps the width of the primary actions dropdown menu (the one shown
+     * when a `primaryActions` item has a `description`).
+     * - "expanded": (default) sizes to content, same as today.
+     * - "reduced": caps the menu at 300px, for long descriptions.
+     * @default "expanded"
+     */
+    primaryActionsMenuVariant?: DropdownContentVariant;
 };
 
 export declare const OneDateNavigator: typeof OneDateNavigatorInternal;
@@ -15313,6 +15541,61 @@ declare type OneFilterPickerRootProps<Definition extends FiltersDefinition> = {
     onPresetAction?: () => void;
 };
 
+/**
+ * A compact row in a list of things: `OnePersonListItem`'s anatomy without the
+ * person assumption, so it serves workplaces, teams, companies or files alike.
+ *
+ * @experimental This is an experimental component use it at your own risk
+ */
+export declare const OneListItem: WithDataTestIdReturnType_3<default_2.ForwardRefExoticComponent<OneListItemProps & default_2.RefAttributes<HTMLDivElement>> & {
+Skeleton: () => default_2.JSX.Element;
+}>;
+
+export declare type OneListItemProps = {
+    /** Any avatar variant, so the item can stand for whatever the list is of. */
+    avatar?: AvatarVariant;
+    title: string;
+    description?: string;
+    /** Facts under the title, rendered inline and separated by a middot. */
+    bottomTags?: Omit<F0TagRawProps, "noBorder">[];
+    /** Fields under the subtitle, with `F0Card`'s metadata shape and renderers. */
+    metadata?: CardMetadata[];
+    rightTag?: Props_4;
+    /**
+     * An icon at the row's right edge for a fact about the item (not an action,
+     * so not a button), explained by its tooltip.
+     */
+    rightIcon?: {
+        icon: IconType;
+        tooltip: string;
+        tooltipDescription?: string;
+    };
+    actions?: {
+        primary?: {
+            icon?: IconType;
+            label: string;
+            onClick: () => void;
+        };
+        secondary?: {
+            icon: IconType;
+            /** Accessible name - the button shows only its icon. */
+            label?: string;
+            onClick: () => void;
+        };
+    };
+    /** Tooltip beside the title, for a caveat that doesn't fit in the row. */
+    info?: string;
+    onClick: () => void;
+    withPointerCursor?: boolean;
+    /** The row currently acted on, e.g. open in a detail view. Sets `aria-current`. */
+    selected?: boolean;
+};
+
+/** Shared by the item and its skeleton, so both occupy the same box. */
+export declare const oneListItemRowClassName = "flex w-full flex-row flex-wrap items-start gap-2 rounded-md border p-2 focus:outline focus:outline-1 focus:outline-offset-1 focus:outline-f1-border-selected-bold";
+
+export declare const OneListItemSkeleton: () => default_2.JSX.Element;
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -16057,6 +16340,13 @@ export declare interface ReactionsProps {
     };
 }
 
+/**
+ * Soft ceiling for marker count. Markers are DOM elements with JS screen-space
+ * clustering - designed for workplace-scale datasets. Beyond this, pan/zoom
+ * starts to stutter; thousands of points need a GL-native clustering path.
+ */
+export declare const RECOMMENDED_MAX_MARKERS = 200;
+
 /**
  * Utility type to get all possible paths through an object using dot notation
  * @template T - The object type to traverse
@@ -18628,7 +18918,7 @@ declare type VacancyProfile = {
     vacancyType?: string;
 };
 
-declare type ValueDisplayRendererContext = {
+declare type ValueDisplayRendererContext_2 = {
     visualization: ValueDisplayVisualizationType;
     i18n: TranslationsType;
     tableAlign?: ValueDisplayTableAlignment;
@@ -18646,34 +18936,34 @@ declare type ValueDisplayRendererDefinition = {
 }[keyof typeof valueDisplayRenderers];
 
 declare const valueDisplayRenderers: {
-    readonly text: (args: TextCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly longText: (args: LongTextCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly number: (args: NumberCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly date: (args: DateCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly amount: (args: AmountCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly compound: (args: CompoundCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly avatarList: (args: AvatarListCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly status: (args: StatusCellValue) => JSX_2.Element;
-    readonly alertTag: (args: AlertTagCellValue) => JSX_2.Element;
-    readonly person: (args: PersonCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly percentage: (args: PercentageCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element | null;
-    readonly progressBar: (args: ProgressBarCellValue, _meta: ValueDisplayRendererContext) => JSX_2.Element | null;
-    readonly progressSeries: (args: ProgressSeriesCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly barSeries: (args: BarSeriesCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly categoryBarChart: (args: CategoryBarChartCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly hourDistribution: (args: HourDistributionCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly company: (args: CompanyCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly team: (args: TeamCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly tag: (args: TagCellValue) => JSX_2.Element;
-    readonly dotTag: (args: DotTagCellValue) => JSX_2.Element;
-    readonly tagList: (args: TagListCellValue) => JSX_2.Element;
-    readonly icon: (args: IconCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly file: (args: FileCellValue) => JSX_2.Element;
-    readonly folder: (args: FolderCellValue) => JSX_2.Element;
-    readonly country: (args: CountryCellValue, context: ValueDisplayRendererContext) => JSX_2.Element;
+    readonly text: (args: TextCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly longText: (args: LongTextCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly number: (args: NumberCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly date: (args: DateCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly amount: (args: AmountCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly compound: (args: CompoundCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly avatarList: (args: AvatarListCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly status: (args: StatusCellValue_2) => JSX_2.Element;
+    readonly alertTag: (args: AlertTagCellValue_2) => JSX_2.Element;
+    readonly person: (args: PersonCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly percentage: (args: PercentageCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element | null;
+    readonly progressBar: (args: ProgressBarCellValue_2, _meta: ValueDisplayRendererContext_2) => JSX_2.Element | null;
+    readonly progressSeries: (args: ProgressSeriesCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly barSeries: (args: BarSeriesCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly categoryBarChart: (args: CategoryBarChartCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly hourDistribution: (args: HourDistributionCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly company: (args: CompanyCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly team: (args: TeamCellValue_2, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly tag: (args: TagCellValue_2) => JSX_2.Element;
+    readonly dotTag: (args: DotTagCellValue_2) => JSX_2.Element;
+    readonly tagList: (args: TagListCellValue_2) => JSX_2.Element;
+    readonly icon: (args: IconCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly file: (args: FileCellValue_2) => JSX_2.Element;
+    readonly folder: (args: FolderCellValue_2) => JSX_2.Element;
+    readonly country: (args: CountryCellValue, context: ValueDisplayRendererContext_2) => JSX_2.Element;
     readonly delta: (args: DeltaCellValue) => JSX_2.Element;
-    readonly summary: (args: SummaryCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
-    readonly count: (args: CountCellValue, meta: ValueDisplayRendererContext) => JSX_2.Element;
+    readonly summary: (args: SummaryCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
+    readonly count: (args: CountCellValue, meta: ValueDisplayRendererContext_2) => JSX_2.Element;
 };
 
 declare type ValueDisplayTableAlignment = "left" | "right";
@@ -18850,6 +19140,11 @@ declare type Visualization<R extends RecordType, Filters extends FiltersDefiniti
     type: "graph";
     /** Configuration options for graph visualization */
     options: GraphVisualizationOptions<R, Filters, Sortings>;
+} & VisualizationFilterOverrides<Filters, Sortings> & VisualizationLabelOverrides) | ({
+    /** Map-based visualization type */
+    type: "map";
+    /** Configuration options for map visualization */
+    options: MapVisualizationOptions<R, Filters, Sortings>;
 } & VisualizationFilterOverrides<Filters, Sortings> & VisualizationLabelOverrides) | ({
     /** Human-readable label for the visualization */
     label: string;