@12-apps/ui 6.22.0 → 6.24.0

package/dist/{chunk-PMS3H3OO.js → chunk-DF2FFYZ7.js}

@@ -1,3 +1,6 @@
+import {
+  LightboxCurrentMedia
+} from "./chunk-2DWBJJK6.js";
 import {
   resolveLightboxProps
 } from "./chunk-UOS7DEQZ.js";
@@ -19,9 +22,6 @@ import {
 import {
   makeTestId
 } from "./chunk-56SJYTIT.js";
-import {
-  LightboxCurrentMedia
-} from "./chunk-2DWBJJK6.js";
 
 // src/components/data-display/Lightbox/Lightbox.tsx
 import Dialog from "@mui/material/Dialog/index.js";
@@ -128,4 +128,4 @@ export {
   Lightbox,
   Lightbox_default
 };
-//# sourceMappingURL=chunk-PMS3H3OO.js.map
+//# sourceMappingURL=chunk-DF2FFYZ7.js.map

package/dist/{chunk-QZBUGUOY.js → chunk-DFLTUI7W.js}

@@ -1,6 +1,3 @@
-import {
-  RangePresets
-} from "./chunk-F4RR4666.js";
 import {
   NumberBoundInput
 } from "./chunk-FV36LFPX.js";
@@ -10,6 +7,9 @@ import {
   numericRange,
   rangeChipLabel
 } from "./chunk-GCZJH4XL.js";
+import {
+  RangePresets
+} from "./chunk-F4RR4666.js";
 import {
   presetsFor
 } from "./chunk-CBOB5AV6.js";
@@ -279,4 +279,4 @@ export {
   RangePill,
   PanelRangeField
 };
-//# sourceMappingURL=chunk-QZBUGUOY.js.map
+//# sourceMappingURL=chunk-DFLTUI7W.js.map

package/dist/{chunk-WLQTHPMX.js → chunk-EJQW2IYW.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-4T6W43TO.js";
 import {
   CategorySelect
-} from "./chunk-5ZTUP65G.js";
+} from "./chunk-JM64OEU6.js";
 
 // src/components/data-display/DataViews/data-views-category-pill.tsx
 import { jsx } from "react/jsx-runtime";
@@ -79,4 +79,4 @@ export {
   emitPillDiff,
   PillControl
 };
-//# sourceMappingURL=chunk-WLQTHPMX.js.map
+//# sourceMappingURL=chunk-EJQW2IYW.js.map

package/dist/{chunk-VQAM2XZV.js → chunk-EMUBMZMA.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-4X4KM4ZB.js";
 import {
   DataViewsGrid
-} from "./chunk-PFV6RL4Q.js";
+} from "./chunk-C6KTQF4F.js";
 import {
   viewStateKey
 } from "./chunk-ZOLAYP2D.js";
@@ -178,4 +178,4 @@ function renderViewDialogs(ctl, fields, columns, views, testIdPrefix, onSaved) {
 export {
   DataViewsTableBase
 };
-//# sourceMappingURL=chunk-VQAM2XZV.js.map
+//# sourceMappingURL=chunk-EMUBMZMA.js.map

package/dist/{chunk-XFUNJYFT.js → chunk-EPNUVSNK.js}

@@ -1,9 +1,3 @@
-import {
-  useHoverCard
-} from "./chunk-SXYIXCUB.js";
-import {
-  HoverCardContent
-} from "./chunk-O26MKGIC.js";
 import {
   arrowSx,
   cardSx,
@@ -11,6 +5,12 @@ import {
   getTransformOrigin,
   sideOf
 } from "./chunk-KSLNO5NG.js";
+import {
+  useHoverCard
+} from "./chunk-SXYIXCUB.js";
+import {
+  HoverCardContent
+} from "./chunk-O26MKGIC.js";
 import {
   withDefaults
 } from "./chunk-HPK33ACY.js";
@@ -158,4 +158,4 @@ HoverCard.displayName = "HoverCard";
 export {
   HoverCard
 };
-//# sourceMappingURL=chunk-XFUNJYFT.js.map
+//# sourceMappingURL=chunk-EPNUVSNK.js.map

package/dist/{chunk-MSUSZLRE.js → chunk-EWT3WMVY.js}

@@ -1,3 +1,7 @@
+import {
+  resolveCommandProps,
+  useCommandPalette
+} from "./chunk-6DN4ZULV.js";
 import {
   commandPaperStyles,
   commandSizeStyles
@@ -6,10 +10,6 @@ import {
   CommandEmpty,
   CommandLoading
 } from "./chunk-CMK4DJDR.js";
-import {
-  resolveCommandProps,
-  useCommandPalette
-} from "./chunk-6DN4ZULV.js";
 
 // src/components/form/Command/Command.tsx
 import CloseIcon from "@mui/icons-material/Close";
@@ -302,4 +302,4 @@ export {
   CommandList,
   CommandGroup
 };
-//# sourceMappingURL=chunk-MSUSZLRE.js.map
+//# sourceMappingURL=chunk-EWT3WMVY.js.map

package/dist/{chunk-Q75SJ35X.js → chunk-GMTM6EN7.js}

@@ -1,12 +1,12 @@
 import {
   useAddressAutocomplete
-} from "./chunk-ZOUWHGV3.js";
+} from "./chunk-4MGFUPQT.js";
 import {
   AddressFallbackField
 } from "./chunk-HKKSZ7HG.js";
 import {
   AddressAutocompleteField
-} from "./chunk-TLMLEC4F.js";
+} from "./chunk-KW7H5O3K.js";
 import {
   resolveAddressProps
 } from "./chunk-MTGEJRE4.js";
@@ -35,4 +35,4 @@ export {
   AddressAutocomplete,
   AddressAutocomplete_default
 };
-//# sourceMappingURL=chunk-Q75SJ35X.js.map
+//# sourceMappingURL=chunk-GMTM6EN7.js.map

package/dist/{chunk-R6SBP5M5.js → chunk-GOWBYHYW.js}

@@ -1,10 +1,10 @@
+import {
+  chartValueFormatter
+} from "./chunk-QVWNK4JO.js";
 import {
   getChartSpecRenderer,
   getRegisteredChartSpecTypes
 } from "./chunk-WKUA6P3W.js";
-import {
-  chartValueFormatter
-} from "./chunk-QVWNK4JO.js";
 
 // src/components/data-display/Chart/chart-spec.ts
 var CHART_SEMANTIC_COLORS = [
@@ -149,4 +149,4 @@ export {
   parseChartSpec,
   specToChartProps
 };
-//# sourceMappingURL=chunk-R6SBP5M5.js.map
+//# sourceMappingURL=chunk-GOWBYHYW.js.map

package/dist/{chunk-6NZTYZP5.js → chunk-GVA5CYKP.js}

@@ -1,6 +1,6 @@
 import {
   Sheet
-} from "./chunk-ZIYMBR7K.js";
+} from "./chunk-OTH7H3IP.js";
 import {
   Dialog
 } from "./chunk-YANLN6HP.js";
@@ -162,4 +162,4 @@ AppHeaderDetails.displayName = "AppHeaderDetails";
 export {
   AppHeaderDetails
 };
-//# sourceMappingURL=chunk-6NZTYZP5.js.map
+//# sourceMappingURL=chunk-GVA5CYKP.js.map

package/dist/chunk-HMV4QMXS.js

@@ -0,0 +1,219 @@
+import {
+  freshnessOf
+} from "./chunk-XPMGFAJ3.js";
+import {
+  FLEET_DOT,
+  FLEET_ROSTER,
+  FLEET_ROW,
+  FLEET_SKELETON
+} from "./chunk-BTQZ3EX3.js";
+import {
+  Skeleton
+} from "./chunk-7VN7LFBA.js";
+
+// src/components/data-display/FleetMap/FleetRoster.tsx
+import Box from "@mui/material/Box/index.js";
+import Stack from "@mui/material/Stack/index.js";
+import Typography from "@mui/material/Typography/index.js";
+import { useTheme } from "@mui/material/styles/index.js";
+import React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function freshnessColor(freshness, theme) {
+  if (freshness === "live") return theme.palette.success.main;
+  if (freshness === "lagging") return theme.palette.warning.main;
+  return theme.palette.text.disabled;
+}
+function RowText({
+  unit,
+  copy,
+  freshness,
+  testId
+}) {
+  const theme = useTheme();
+  const meta = [
+    copy.freshness[freshness],
+    copy.lastSeen(unit.staleSeconds),
+    unit.accuracyM == null ? null : copy.accuracy(unit.accuracyM)
+  ].filter((part) => Boolean(part)).join(" \xB7 ");
+  return /* @__PURE__ */ jsxs(Stack, { sx: { minWidth: 0, flexGrow: 1 }, children: [
+    /* @__PURE__ */ jsx(
+      Typography,
+      {
+        variant: "body2",
+        component: "p",
+        "data-testid": `${testId}-label`,
+        sx: { fontWeight: theme.typography.fontWeightMedium, overflowWrap: "anywhere" },
+        children: unit.label
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Typography,
+      {
+        variant: "caption",
+        component: "p",
+        "data-testid": `${testId}-meta`,
+        sx: { color: theme.palette.text.secondary },
+        children: meta
+      }
+    )
+  ] });
+}
+function useKeptInView(selected, position) {
+  const row = React.useRef(null);
+  React.useEffect(() => {
+    const box = row.current;
+    const list = box?.parentElement;
+    if (!selected || !box || !list) return;
+    const top = box.offsetTop - list.offsetTop;
+    if (top < list.scrollTop) {
+      list.scrollTop = top;
+    } else if (top + box.offsetHeight > list.scrollTop + list.clientHeight) {
+      list.scrollTop = top + box.offsetHeight - list.clientHeight;
+    }
+  }, [selected, position]);
+  return row;
+}
+function rowSx(theme, selected) {
+  const resting = selected ? theme.palette.action.selected : "transparent";
+  return {
+    display: "flex",
+    alignItems: "center",
+    gap: theme.spacing(FLEET_ROW.gapUnits),
+    padding: theme.spacing(FLEET_ROW.paddingYUnits, FLEET_ROW.paddingXUnits),
+    // `1`, not `theme.shape.borderRadius / 4`. MUI's `sx` reads a NUMBER here as
+    // a multiple of `theme.shape.borderRadius`, so dividing the theme value out
+    // and letting `sx` multiply it back in is quadratic: measured 4px on the
+    // default theme — which is why this looked right — and 36px on a host that
+    // sets its own radius to 12. In a package whose whole premise is being
+    // re-themed, only the multiple is portable.
+    borderRadius: FLEET_ROW.radiusMultiple,
+    cursor: "pointer",
+    backgroundColor: resting,
+    "&:hover": {
+      backgroundColor: selected ? theme.palette.action.selected : theme.palette.action.hover
+    }
+  };
+}
+function FleetRow({
+  unit,
+  copy,
+  freshness,
+  selected,
+  onSelect,
+  optionId,
+  position,
+  testId
+}) {
+  const theme = useTheme();
+  const color = freshnessColor(freshness, theme);
+  const row = useKeptInView(selected, position);
+  return /* @__PURE__ */ jsxs(
+    Box,
+    {
+      ref: row,
+      role: "option",
+      "aria-selected": selected,
+      id: optionId,
+      "data-testid": testId,
+      "data-freshness": freshness,
+      onClick: () => onSelect(unit.id),
+      sx: rowSx(theme, selected),
+      children: [
+        /* @__PURE__ */ jsx(
+          Box,
+          {
+            "aria-hidden": "true",
+            "data-testid": `${testId}-dot`,
+            sx: {
+              width: FLEET_DOT.size,
+              height: FLEET_DOT.size,
+              borderRadius: "50%",
+              flexShrink: 0,
+              backgroundColor: color
+            }
+          }
+        ),
+        /* @__PURE__ */ jsx(RowText, { unit, copy, freshness, testId }),
+        unit.badge && /* @__PURE__ */ jsx(
+          Typography,
+          {
+            variant: "caption",
+            component: "span",
+            "data-testid": `${testId}-badge`,
+            sx: { color: theme.palette.text.secondary, flexShrink: 0 },
+            children: unit.badge
+          }
+        )
+      ]
+    }
+  );
+}
+function FirstLoad({ testId }) {
+  return /* @__PURE__ */ jsx(Stack, { spacing: FLEET_SKELETON.gapUnits, "data-testid": `${testId}-skeleton`, "aria-hidden": "true", children: Array.from({ length: FLEET_SKELETON.rows }, (_, row) => /* @__PURE__ */ jsx(
+    Skeleton,
+    {
+      variant: "rectangular",
+      height: FLEET_SKELETON.height,
+      borderRadius: FLEET_SKELETON.radiusMultiple
+    },
+    row
+  )) });
+}
+function FleetRoster({
+  units,
+  copy,
+  selectedId,
+  onSelect,
+  laggingAfterSeconds,
+  staleAfterSeconds,
+  loading,
+  testId,
+  onKeyDown
+}) {
+  const theme = useTheme();
+  const rowIdPrefix = React.useId();
+  const optionId = (id) => `${rowIdPrefix}-${id}`;
+  const active = units.some((unit) => unit.id === selectedId) ? selectedId : null;
+  if (loading && units.length === 0) return /* @__PURE__ */ jsx(FirstLoad, { testId });
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      role: "listbox",
+      tabIndex: 0,
+      "aria-label": copy.rosterLabel,
+      "aria-activedescendant": active ? optionId(active) : void 0,
+      "data-testid": `${testId}-roster`,
+      onKeyDown,
+      sx: {
+        display: "flex",
+        flexDirection: "column",
+        gap: theme.spacing(FLEET_ROSTER.gapUnits),
+        overflowY: "auto",
+        minWidth: 0,
+        "&:focus-visible": {
+          outline: `${FLEET_ROSTER.focusRingWidth}px solid ${theme.palette.primary.main}`,
+          outlineOffset: FLEET_ROSTER.focusRingOffset
+        }
+      },
+      children: units.map((unit, index) => /* @__PURE__ */ jsx(
+        FleetRow,
+        {
+          unit,
+          copy,
+          freshness: freshnessOf(unit.staleSeconds, laggingAfterSeconds, staleAfterSeconds),
+          selected: unit.id === active,
+          onSelect,
+          optionId: optionId(unit.id),
+          position: index,
+          testId: `${testId}-${unit.id}`
+        },
+        unit.id
+      ))
+    }
+  );
+}
+
+export {
+  FleetRoster
+};
+//# sourceMappingURL=chunk-HMV4QMXS.js.map

package/dist/chunk-HMV4QMXS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/data-display/FleetMap/FleetRoster.tsx"],"sourcesContent":["import Box from '@mui/material/Box/index.js';\nimport Stack from '@mui/material/Stack/index.js';\nimport Typography from '@mui/material/Typography/index.js';\nimport { useTheme, type SxProps, type Theme } from '@mui/material/styles/index.js';\nimport React from 'react';\n\nimport { Skeleton } from '../../layout/Skeleton/Skeleton';\n\nimport { freshnessOf } from './FleetMap.helpers';\nimport { FLEET_DOT, FLEET_ROSTER, FLEET_ROW, FLEET_SKELETON } from './FleetMap.metrics';\nimport type { FleetFreshness, FleetMapCopy, FleetUnit } from './FleetMap.types';\n\n/**\n * The roster beside the map — and the ACCESSIBLE half of this component.\n *\n * A map is a picture of positions and a screen reader cannot read a picture, so\n * the panel's information is carried by this list. That is not a consolation\n * prize: the list answers the questions a dispatcher actually asks — who is\n * reporting, how recently, and what are they carrying — and it answers them in\n * an order the map cannot express.\n *\n * The map beside it is a NAMED LANDMARK rather than an `aria-hidden` one, so a\n * reader can skip it in one gesture — see `FleetCanvas`, which carries the\n * reason it must not be hidden.\n */\n\n/** Each freshness draws from the semantic palette, never a hardcoded hex. */\nfunction freshnessColor(freshness: FleetFreshness, theme: Theme): string {\n  if (freshness === 'live') return theme.palette.success.main;\n  if (freshness === 'lagging') return theme.palette.warning.main;\n  return theme.palette.text.disabled;\n}\n\n/**\n * A row's two lines of text — the name, and the one-line summary under it.\n *\n * Split out of `FleetRow` to keep that function under the size gate, and the\n * seam is the natural one: everything here is READ, nothing is interactive.\n */\nfunction RowText({\n  unit,\n  copy,\n  freshness,\n  testId,\n}: Pick<RowProps, 'unit' | 'copy' | 'freshness' | 'testId'>): React.JSX.Element {\n  const theme = useTheme();\n\n  // Dropped rather than rendered empty: a phone that reports no accuracy radius\n  // would otherwise print a trailing separator with nothing after it.\n  const meta = [\n    copy.freshness[freshness],\n    copy.lastSeen(unit.staleSeconds),\n    unit.accuracyM == null ? null : copy.accuracy(unit.accuracyM),\n  ]\n    .filter((part): part is string => Boolean(part))\n    .join(' · ');\n\n  return (\n    <Stack sx={{ minWidth: 0, flexGrow: 1 }}>\n      <Typography\n        variant=\"body2\"\n        component=\"p\"\n        data-testid={`${testId}-label`}\n        sx={{ fontWeight: theme.typography.fontWeightMedium, overflowWrap: 'anywhere' }}\n      >\n        {unit.label}\n      </Typography>\n      <Typography\n        variant=\"caption\"\n        component=\"p\"\n        data-testid={`${testId}-meta`}\n        sx={{ color: theme.palette.text.secondary }}\n      >\n        {meta}\n      </Typography>\n    </Stack>\n  );\n}\n\n/**\n * Keep the selected row visible INSIDE the roster.\n *\n * The roster caps its own height, so a dispatcher arrowing through a fleet of\n * thirty otherwise walks the selection below the fold with nothing moving —\n * `aria-activedescendant` follows, and a SIGHTED keyboard user sees no feedback\n * at all.\n *\n * Watches the row's POSITION as well as its selectedness, because the roster\n * re-sorts on every poll: a rider who stays selected while their staleness\n * moves them down the list would otherwise slide out of view with the effect\n * never re-running.\n *\n * Arithmetic rather than `scrollIntoView({ block: 'nearest' })` because that\n * walks every scrollable ancestor, the document included, and `nearest` only\n * spares an ancestor the row is already visible in — which is exactly false\n * when the panel is off screen. Re-running on every re-sort, it would yank the\n * whole page back to the map on a timer, and drag it there on mount for any\n * board rendered below the fold with a selection already set.\n */\nfunction useKeptInView(\n  selected: boolean,\n  position: number,\n): React.RefObject<HTMLDivElement | null> {\n  const row = React.useRef<HTMLDivElement>(null);\n\n  React.useEffect(() => {\n    const box = row.current;\n    const list = box?.parentElement;\n    if (!selected || !box || !list) return;\n    const top = box.offsetTop - list.offsetTop;\n    if (top < list.scrollTop) {\n      list.scrollTop = top;\n    } else if (top + box.offsetHeight > list.scrollTop + list.clientHeight) {\n      list.scrollTop = top + box.offsetHeight - list.clientHeight;\n    }\n  }, [selected, position]);\n\n  return row;\n}\n\n/**\n * A row's own box, selected or not.\n *\n * Out of line because the hover rule needs the explanation more than the JSX\n * has room for: hover must never WEAKEN the selection. Written flat as\n * `'&:hover': { backgroundColor: action.hover }`, the pseudo-class wins on\n * specificity and repaints the selected row with the hover tint — measured at\n * `rgba(0,0,0,0.08)` idle against `rgba(0,0,0,0.04)` hovered, so pointing at\n * the selected row visually DESELECTED it and made it indistinguishable from\n * any other row under the cursor.\n */\nfunction rowSx(theme: Theme, selected: boolean): SxProps<Theme> {\n  const resting = selected ? theme.palette.action.selected : 'transparent';\n  return {\n    display: 'flex',\n    alignItems: 'center',\n    gap: theme.spacing(FLEET_ROW.gapUnits),\n    padding: theme.spacing(FLEET_ROW.paddingYUnits, FLEET_ROW.paddingXUnits),\n    // `1`, not `theme.shape.borderRadius / 4`. MUI's `sx` reads a NUMBER here as\n    // a multiple of `theme.shape.borderRadius`, so dividing the theme value out\n    // and letting `sx` multiply it back in is quadratic: measured 4px on the\n    // default theme — which is why this looked right — and 36px on a host that\n    // sets its own radius to 12. In a package whose whole premise is being\n    // re-themed, only the multiple is portable.\n    borderRadius: FLEET_ROW.radiusMultiple,\n    cursor: 'pointer',\n    backgroundColor: resting,\n    '&:hover': {\n      backgroundColor: selected ? theme.palette.action.selected : theme.palette.action.hover,\n    },\n  };\n}\n\ninterface RowProps {\n  unit: FleetUnit;\n  copy: FleetMapCopy;\n  freshness: FleetFreshness;\n  selected: boolean;\n  onSelect: (id: string) => void;\n  /** The row's DOM id, which `aria-activedescendant` points at. */\n  optionId: string;\n  /** Where the row sits in the re-sorted roster — see the scroll effect. */\n  position: number;\n  testId: string;\n}\n\nfunction FleetRow({\n  unit,\n  copy,\n  freshness,\n  selected,\n  onSelect,\n  optionId,\n  position,\n  testId,\n}: RowProps): React.JSX.Element {\n  const theme = useTheme();\n  const color = freshnessColor(freshness, theme);\n  const row = useKeptInView(selected, position);\n\n  return (\n    <Box\n      ref={row}\n      role=\"option\"\n      aria-selected={selected}\n      id={optionId}\n      data-testid={testId}\n      data-freshness={freshness}\n      onClick={() => onSelect(unit.id)}\n      sx={rowSx(theme, selected)}\n    >\n      {/* The dot repeats what the freshness word beside it already says, so it\n          is hidden rather than read twice — and colour is never the only\n          carrier of the state. */}\n      <Box\n        aria-hidden=\"true\"\n        data-testid={`${testId}-dot`}\n        sx={{\n          width: FLEET_DOT.size,\n          height: FLEET_DOT.size,\n          borderRadius: '50%',\n          flexShrink: 0,\n          backgroundColor: color,\n        }}\n      />\n      <RowText unit={unit} copy={copy} freshness={freshness} testId={testId} />\n      {unit.badge && (\n        <Typography\n          variant=\"caption\"\n          component=\"span\"\n          data-testid={`${testId}-badge`}\n          sx={{ color: theme.palette.text.secondary, flexShrink: 0 }}\n        >\n          {unit.badge}\n        </Typography>\n      )}\n    </Box>\n  );\n}\n\n/**\n * What stands in for the roster before any unit has landed.\n *\n * `aria-hidden`, because three grey bars are not information — the panel's\n * `aria-busy` and its optional announcement carry that. The radius is the same\n * MULTIPLE a real row uses rather than a raw pixel count: `Skeleton` forwards\n * the number into `sx`, where it scales with `theme.shape.borderRadius`, so a\n * literal `4` drew 16px against the rows' 4px on the default theme and 48px\n * against 12px on a re-themed host.\n */\nfunction FirstLoad({ testId }: { testId: string }): React.JSX.Element {\n  return (\n    <Stack spacing={FLEET_SKELETON.gapUnits} data-testid={`${testId}-skeleton`} aria-hidden=\"true\">\n      {Array.from({ length: FLEET_SKELETON.rows }, (_, row) => (\n        <Skeleton\n          key={row}\n          variant=\"rectangular\"\n          height={FLEET_SKELETON.height}\n          borderRadius={FLEET_SKELETON.radiusMultiple}\n        />\n      ))}\n    </Stack>\n  );\n}\n\nexport interface FleetRosterProps {\n  units: readonly FleetUnit[];\n  copy: FleetMapCopy;\n  selectedId: string | null | undefined;\n  onSelect: (id: string) => void;\n  laggingAfterSeconds: number;\n  staleAfterSeconds: number;\n  loading: boolean;\n  testId: string;\n  onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => void;\n}\n\nexport function FleetRoster({\n  units,\n  copy,\n  selectedId,\n  onSelect,\n  laggingAfterSeconds,\n  staleAfterSeconds,\n  loading,\n  testId,\n  onKeyDown,\n}: FleetRosterProps): React.JSX.Element {\n  const theme = useTheme();\n  // Generated, not derived from `dataTestId`: two boards on one page filtered\n  // from the same fleet would otherwise emit duplicate DOM ids and an ambiguous\n  // `aria-activedescendant`. Same reason the heading uses one.\n  const rowIdPrefix = React.useId();\n  const optionId = (id: string): string => `${rowIdPrefix}-${id}`;\n\n  // The selection is CONTROLLED, so it can name a unit that has since dropped\n  // out of the freshness window — a courier ending their shift mid-poll. The\n  // attribute must then be absent rather than pointing at an element that no\n  // longer renders, which announces nothing and fails an axe audit. `mapCentre`\n  // and `nextSelection` both handle the same case; this is the third place.\n  const active = units.some((unit) => unit.id === selectedId) ? selectedId : null;\n\n  // Only when there is nothing to show yet. Unmounting a populated listbox on\n  // every poll destroys the focus inside it, so a dispatcher arrowing through\n  // the roster is thrown back to the top of the page each time the data\n  // refreshes — and the rows they were reading vanish and return.\n  if (loading && units.length === 0) return <FirstLoad testId={testId} />;\n\n  return (\n    <Box\n      role=\"listbox\"\n      // A single tab stop with arrow keys inside, which is the listbox pattern:\n      // a dispatcher tabbing past a fleet of thirty should not have to press it\n      // thirty times to reach the map.\n      tabIndex={0}\n      aria-label={copy.rosterLabel}\n      aria-activedescendant={active ? optionId(active) : undefined}\n      data-testid={`${testId}-roster`}\n      onKeyDown={onKeyDown}\n      sx={{\n        display: 'flex',\n        flexDirection: 'column',\n        gap: theme.spacing(FLEET_ROSTER.gapUnits),\n        overflowY: 'auto',\n        minWidth: 0,\n        '&:focus-visible': {\n          outline: `${FLEET_ROSTER.focusRingWidth}px solid ${theme.palette.primary.main}`,\n          outlineOffset: FLEET_ROSTER.focusRingOffset,\n        },\n      }}\n    >\n      {units.map((unit, index) => (\n        <FleetRow\n          key={unit.id}\n          unit={unit}\n          copy={copy}\n          freshness={freshnessOf(unit.staleSeconds, laggingAfterSeconds, staleAfterSeconds)}\n          selected={unit.id === active}\n          onSelect={onSelect}\n          optionId={optionId(unit.id)}\n          position={index}\n          testId={`${testId}-${unit.id}`}\n        />\n      ))}\n    </Box>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-VR5HDUBK.js → chunk-HP2ODXNA.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KHG57NAE.js";
 import {
   Pagination
-} from "./chunk-W2UTDN4T.js";
+} from "./chunk-RBGOGTT2.js";
 import {
   default as default2
 } from "./chunk-6DPAWXZ3.js";
@@ -31,4 +31,4 @@ function DataViewsPagination({
 export {
   DataViewsPagination
 };
-//# sourceMappingURL=chunk-VR5HDUBK.js.map
+//# sourceMappingURL=chunk-HP2ODXNA.js.map

package/dist/{chunk-2MMEIN4T.js → chunk-I3E2QHTH.js}

@@ -4,13 +4,13 @@ import {
 } from "./chunk-5WNQJ5KS.js";
 import {
   PillControl
-} from "./chunk-WLQTHPMX.js";
+} from "./chunk-EJQW2IYW.js";
 import {
   MoreFilters
-} from "./chunk-QFJRB27Q.js";
+} from "./chunk-6LGWJFQK.js";
 import {
   RangePill
-} from "./chunk-QZBUGUOY.js";
+} from "./chunk-DFLTUI7W.js";
 import {
   CollapsedSearch,
   InlineKeyword
@@ -220,4 +220,4 @@ function FilterSlots({
 export {
   InlineFilterControls
 };
-//# sourceMappingURL=chunk-2MMEIN4T.js.map
+//# sourceMappingURL=chunk-I3E2QHTH.js.map

package/dist/{chunk-UVGRRI7N.js → chunk-IPVYEPXO.js}

@@ -1,3 +1,6 @@
+import {
+  useDateRangePicker
+} from "./chunk-OD4Z5G6G.js";
 import {
   DateRangeQuickList
 } from "./chunk-ZRHSIFWA.js";
@@ -7,9 +10,6 @@ import {
 import {
   DEFAULT_QUICK_RANGES
 } from "./chunk-QKLSHNOH.js";
-import {
-  useDateRangePicker
-} from "./chunk-OD4Z5G6G.js";
 import {
   toLocalDay
 } from "./chunk-FRAVVI4A.js";
@@ -180,4 +180,4 @@ export {
   DateRangePicker,
   DateRangePicker_default
 };
-//# sourceMappingURL=chunk-UVGRRI7N.js.map
+//# sourceMappingURL=chunk-IPVYEPXO.js.map

package/dist/{chunk-5ZTUP65G.js → chunk-JM64OEU6.js}

@@ -3,7 +3,10 @@ import {
 } from "./chunk-LMXWI3DD.js";
 import {
   CategoryPanel
-} from "./chunk-AGSBIUPV.js";
+} from "./chunk-TPLKJHNN.js";
+import {
+  useCategoryCommit
+} from "./chunk-ZAB65STX.js";
 import {
   CategoryTrigger
 } from "./chunk-KIHQE5YA.js";
@@ -16,9 +19,6 @@ import {
 import {
   useCategoryKeyHandler
 } from "./chunk-ISH42UC7.js";
-import {
-  useCategoryCommit
-} from "./chunk-ZAB65STX.js";
 import {
   summarizeSelection
 } from "./chunk-LR6MSKTT.js";
@@ -158,4 +158,4 @@ function CategorySelect(props) {
 export {
   CategorySelect
 };
-//# sourceMappingURL=chunk-5ZTUP65G.js.map
+//# sourceMappingURL=chunk-JM64OEU6.js.map

package/dist/{chunk-7BYFC2MR.js → chunk-JUHUKZGU.js}

@@ -1,17 +1,17 @@
-import {
-  AVATAR_DEFAULTS,
-  contentTypeOf,
-  pickAvatarContent
-} from "./chunk-3ZVUNSFF.js";
 import {
   AvatarView
-} from "./chunk-4SQFO4GW.js";
+} from "./chunk-NA7MIEG6.js";
 import {
   BORDER_WIDTH,
   GROUP_HOVER,
   GROUP_MAX,
   GROUP_OVERLAP
 } from "./chunk-FAITHWIO.js";
+import {
+  AVATAR_DEFAULTS,
+  contentTypeOf,
+  pickAvatarContent
+} from "./chunk-3ZVUNSFF.js";
 
 // src/components/data-display/Avatar/Avatar.tsx
 import BrokenImage from "@mui/icons-material/BrokenImage";
@@ -172,4 +172,4 @@ export {
   Avatar,
   AvatarGroup
 };
-//# sourceMappingURL=chunk-7BYFC2MR.js.map
+//# sourceMappingURL=chunk-JUHUKZGU.js.map

package/dist/chunk-JZXWCEH5.js

@@ -0,0 +1,116 @@
+import {
+  useFleetMap
+} from "./chunk-ZCPSND5Y.js";
+import {
+  FleetBody
+} from "./chunk-RP5FK3SO.js";
+import {
+  FLEET_DEFAULT_LAGGING_AFTER_SECONDS,
+  FLEET_DEFAULT_STALE_AFTER_SECONDS,
+  FLEET_PANEL
+} from "./chunk-BTQZ3EX3.js";
+import {
+  SR_ONLY_SX
+} from "./chunk-RNCQ5KHQ.js";
+import {
+  EmptyState
+} from "./chunk-25R3ITGZ.js";
+
+// src/components/data-display/FleetMap/FleetMap.tsx
+import Box from "@mui/material/Box/index.js";
+import Typography from "@mui/material/Typography/index.js";
+import { useTheme } from "@mui/material/styles/index.js";
+import React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var DEFAULT_HEIGHT = "420px";
+function FleetStatus({
+  announcement,
+  loading,
+  testId
+}) {
+  if (announcement === void 0) return null;
+  return /* @__PURE__ */ jsx(Box, { role: "status", "aria-live": "polite", "data-testid": `${testId}-status`, sx: SR_ONLY_SX, children: loading ? announcement : "" });
+}
+var FleetMap = React.memo(
+  ({
+    units,
+    copy,
+    // NO default. `undefined` is what tells the hook the caller does not own
+    // the selection; defaulting it to `null` here made every render look
+    // controlled and the uncontrolled path unreachable.
+    selectedId,
+    onSelect,
+    laggingAfterSeconds = FLEET_DEFAULT_LAGGING_AFTER_SECONDS,
+    staleAfterSeconds = FLEET_DEFAULT_STALE_AFTER_SECONDS,
+    height = DEFAULT_HEIGHT,
+    loading = false,
+    className,
+    dataTestId
+  }) => {
+    const theme = useTheme();
+    const testId = dataTestId || "fleet-map";
+    const headingId = React.useId();
+    const { ordered, active, centre, select, markers, onKeyDown } = useFleetMap(
+      units,
+      selectedId,
+      onSelect
+    );
+    return /* @__PURE__ */ jsxs(
+      Box,
+      {
+        role: "region",
+        "aria-labelledby": headingId,
+        className,
+        "data-testid": testId,
+        sx: { display: "flex", flexDirection: "column", gap: theme.spacing(FLEET_PANEL.gapUnits), minWidth: 0 },
+        children: [
+          /* @__PURE__ */ jsx(
+            Typography,
+            {
+              id: headingId,
+              variant: "subtitle1",
+              component: "h2",
+              "data-testid": `${testId}-title`,
+              sx: { fontWeight: theme.typography.fontWeightMedium },
+              children: copy.title
+            }
+          ),
+          /* @__PURE__ */ jsx(FleetStatus, { announcement: copy.loading, loading, testId }),
+          !loading && ordered.length === 0 ? /* @__PURE__ */ jsx(
+            EmptyState,
+            {
+              variant: "minimal",
+              title: copy.emptyTitle,
+              description: copy.emptyDescription,
+              dataTestId: `${testId}-empty`
+            }
+          ) : /* @__PURE__ */ jsx(
+            FleetBody,
+            {
+              ordered,
+              centre,
+              markers,
+              select,
+              onKeyDown,
+              copy,
+              selectedId: active,
+              laggingAfterSeconds,
+              staleAfterSeconds,
+              height,
+              loading,
+              testId
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+FleetMap.displayName = "FleetMap";
+var FleetMap_default = FleetMap;
+
+export {
+  FleetMap,
+  FleetMap_default
+};
+//# sourceMappingURL=chunk-JZXWCEH5.js.map