@12-apps/ui 6.22.0 → 6.23.0

package/src/components/data-display/FleetMap/tests.md

@@ -0,0 +1,79 @@
+# FleetMap Test Status Tracking
+
+## Test Files Status
+
+- [x] `FleetMap.test.stories.tsx` created
+- [x] `__tests__/fleet-map-helpers.test.ts` created — the four pure decisions,
+      at their boundaries, where a story is expensive to stage and an
+      off-by-one reads identically on screen
+- [x] `__tests__/fleet-map-hook.test.ts` created — the two decisions the DOM
+      cannot show: `centre`'s IDENTITY across a poll, and who owns the
+      selection across a re-render
+- [x] `__tests__/fleet-map-guards.test.tsx` created — the behaviours the review
+      rounds added guards for, in the suite CI actually runs (`test-storybook`
+      is deliberately not wired into this repo's CI)
+- [x] `__tests__/fleet-map-theme.test.tsx` created — the row and its first-load
+      skeleton under two host themes, because a radius that looks right on the
+      default one is not evidence in a package built to be re-themed
+- [x] All applicable test categories implemented
+
+## Storybook Tests Status
+
+### Test Results
+
+| Test Name | Status | Pass/Fail | Notes |
+| --- | --- | --- | --- |
+| Basic Interaction | Running | PASS | rows render, roster ordered freshest first |
+| Freshness | Running | PASS | three states, words not colour, caller formats |
+| Thresholds are props | Running | PASS | same fleet reads differently on tighter bounds |
+| Selection | Running | PASS | click reports, `aria-selected` on one row only |
+| Keyboard Navigation | Running | PASS | one tab stop, arrows move and wrap |
+| Screen Reader | Running | PASS | region, named listbox, map named not hidden |
+| Empty State | Running | PASS | empty state renders, no map canvas |
+| Loading State | Running | PASS | busy, skeletons, NOT the empty state, and silent |
+| Edge Cases | Running | PASS | one unit, long name, no badge, zero seconds |
+| Active Descendant | Running | PASS | points at a row that exists, id is generated |
+| Stale Selection | Running | PASS | a selection that left the fleet dangles nothing |
+| Loading Announcement | Running | PASS | `role="status"` carries `copy.loading` |
+| Loading Keeps Roster | Running | PASS | a poll over a populated roster keeps the listbox |
+| Uncontrolled Selection | Running | PASS | works with neither selection prop passed |
+| Controlled Without Handler | Running | PASS | arrows left un-prevented for the page |
+| Idle Announcement Region | Running | PASS | the live region exists, and is empty, while idle |
+
+Legend: Pending | Running | PASS | FAIL
+
+Not implemented, and why: **Form Interaction** — the component has no form.
+**Focus Management** — covered inside Keyboard Navigation, since the listbox's
+single tab stop IS its focus contract. **Performance** — the roster is a short
+list by construction (a fleet is people, not rows), so a render benchmark would
+measure the fixture rather than the component.
+
+## Static Stories Status
+
+- [x] Default story
+- [x] Empty state
+- [x] Loading state
+- [x] One unit
+- [x] All stale
+- [x] Tight thresholds
+- [x] Long names / no accuracy
+- [x] Selectable (controlled)
+- [x] Compact height
+
+## Lint Status
+
+- [x] No lint errors
+- [x] No warnings
+- [x] Clean under `eslint.flakiness.config.mjs`
+
+## TypeCheck Status
+
+- [x] No type errors
+- [x] All props properly typed, no `any`
+
+## Overall Component Status
+
+- [x] Lint clean
+- [x] TypeCheck clean
+- [x] Stories working
+- [x] Unit tests passing (35: 16 helpers + 8 hook + 9 guards + 2 theme)

package/src/components/data-display/FleetMap/track.md

@@ -0,0 +1,50 @@
+# FleetMap
+
+Where a set of tracked units is right now: a map beside the roster that reads
+it. Product-free — it draws labelled dots with a freshness, and every word plus
+the two formatters arrive through `copy`. Built for a delivery fleet and
+deliberately not named after one.
+
+## Props
+
+| prop | effect |
+| --- | --- |
+| `units` | who is reporting; empty renders the empty state rather than an empty map |
+| `copy` | every word, and the `lastSeen` / `accuracy` formatters |
+| `selectedId` | controlled selection; the map centres on it |
+| `onSelect` | fired by a row click, each arrow-key move, and a pin click (mouse only — the pin is not focusable) |
+| `laggingAfterSeconds` | when a unit stops reading as `live` |
+| `staleAfterSeconds` | when it stops reading as `lagging` |
+| `height` | the map's height |
+| `loading` | first-load skeletons, map and roster `aria-busy` |
+| `className` | on the panel root |
+| `dataTestId` | root TEST id; DOM ids are generated separately |
+
+## Lint
+
+Clean, including the flakiness config.
+
+## Type Errors
+
+None.
+
+## Testing Scenarios
+
+Freshness at both thresholds and at their collapse; the centroid fallback and
+the Atlantic-null for an empty fleet; roster order and its tie-break; selection
+wrapping at both ends and a selection that has left the fleet; the empty state
+against the loading state, which are opposite messages.
+
+## Storybook Tests List
+
+`BasicInteraction`, `FreshnessTest`, `ThresholdsAreProps`, `SelectionTest`,
+`KeyboardNavigationTest`, `ControlledWithoutHandlerTest`, `ScreenReaderTest`,
+`ActiveDescendantTest`, `StaleSelectionTest`, `EmptyStateTest`,
+`LoadingStateTest`, `IdleAnnouncementRegionTest`, `LoadingAnnouncementTest`,
+`LoadingKeepsThePopulatedRosterTest`, `UncontrolledSelectionTest`,
+`EdgeCaseTest`.
+
+## Current
+
+Shipped. Its first consumer is an adopter's courier-tracking panel, which
+composes it with its own transport and its own words.

package/src/components/data-display/index.ts

@@ -17,6 +17,7 @@ export * from './InteractiveTooltip';
 export * from './LazyImage';
 export * from './Lightbox';
 export * from './LoadingState';
+export * from './FleetMap';
 export * from './MapPreview';
 export * from './Popover';
 export * from './Progress';

package/src/components/feedback/ConfirmAction/ConfirmAction.md

@@ -61,13 +61,19 @@ escape hatch for the same button in a context where the action is harmless.
 Refs are not forwarded (the HOC renders trigger + popup as a fragment, so there
 is no single node to hand back). Use `<ConfirmAction>` where a ref is needed.
 
-### `ConfirmButton` — the HOC, pre-applied
+### `createConfirmButton` — the HOC, pre-applied
 
-`withConfirmation(Button)` with the shared wording already in place. Use it when
-you just want a guarded button and have no reason to build your own wrapper.
+`withConfirmation(Button)`, wrapped up for you. Use it when you just want a
+guarded button and have no reason to build your own wrapper.
+
+A FACTORY rather than a ready-made component, because the wording it bakes in is
+the caller's: it takes the host's `ConfirmActionCopy` and its error sentence, and
+returns the button. Build it once at module scope and use it like any other.
 
 ```tsx
-import { ConfirmButton } from '@12-apps/ui/feedback/ConfirmAction';
+import { createConfirmButton } from '@12-apps/ui/feedback/ConfirmAction';
+
+const ConfirmButton = createConfirmButton(PT_BR_CONFIRM_ACTION_COPY, 'Algo deu errado.');
 
 <ConfirmButton
   color="danger"

package/dist/chunk-X3HL5C6H.js

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-X3HL5C6H.js.map