# XWUIShipmentWorkbench

A list-detail workbench for shipments in transit: a roster pane
(`basic/XWUIList`) selects into a detail pane that composes
`basic/XWUICardShipment` (tracking number, carrier, route, ETA, weight/dims,
tags), `basic/XWUITrackingTimeline` (tracking event history - only when the
shipment has `events`) and `basic/XWUIQuickActions` (Track and Contact
Carrier are always available; Cancel and Mark Delivered drop out once the
shipment's status is already `delivered` or `cancelled`). Selection defaults
to the first shipment and is controllable via `data.selectedId`; a click on a
roster row, a call to `selectShipment(id)`, and a `host.data = {...}` write on
the custom element all go through the same path.

`data.loading` and `data.error` take precedence over the roster and leave the
detail pane blank, so a host wiring this to a real fetch does not need a
separate skeleton component.

This is the first component in `industry/logistics/`, wired into
`XWUISuperLogistics`'s `logistics-shipments` menu leaf (2026-09-12); the
remaining seven leaves still mount the shell's placeholder.

## Basic Usage

Three shipments spanning delivered, in-transit and exception states, so every
gated detail widget (tracking timeline, Cancel action, Mark Delivered action)
is visible on at least one of them.

```api
```