# XWUIStockWorkbench

A list-detail workbench for SKU/warehouse stock positions: a roster pane
(`basic/XWUIList`) selects into a detail pane that composes
`basic/XWUIProgressBar` (stock level vs reorder point, colored by status),
`basic/XWUIDescriptionList` (warehouse, unit, reorder point, status),
`basic/XWUITable` (recent `transactions`, when present) and
`basic/XWUIQuickActions` (Adjust/Transfer/Count, plus Reorder - shown only
when the item is actually low or out of stock). Selection defaults to the
first item and is controllable via `data.selectedId`; a click on a roster
row, a call to `selectItem(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/inventory/` - it is what
`XWUISuperInventory` mounts for its `inv-stock` menu leaf.
`inv-warehouses`, `inv-transfers`, `inv-adjustments`, `inv-suppliers` and
`inv-reports` still mount the shell's placeholder.

## Basic Usage

Three stock items spanning in-stock, low-stock and out-of-stock, so every
gated detail widget (transactions table, Reorder action) is visible on at
least one of them.

```api
```