<!-- 04_VISUAL/xwui/xwui-lib/xwui-lib-super/src/display/XWUIFlowLanes/XWUIFlowLanes.md -->
# XWUIFlowLanes

TODO(agent): one paragraph: what it shows, what the user can do, and which existing XWUI contracts it composes (REF_06 section 2.2).

## Basic Usage

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Four items, one selected and one disabled.
```

## Data

`items[]`: `{ id, label, value?, disabled? }`. `selectedId`: the selected id or null (host-owned; `onSelect` reports a change).

## Options

| Option | Default | What it does |
| --- | --- | --- |
| `title` | locale pack `xwui.flow_lanes.title` | Heading. |
| `ariaLabel` | the title | Accessible name of the list. |
| `emptyText` | locale pack `xwui.flow_lanes.empty` | Text of the empty state. |
| `density` | `'comfortable'` | `'compact'` tightens the rows. |
| `locale`, `numberingSystem` | page language, `'latn'` | Number formatting. |

## Events and methods

`onSelect(id)`; `select(id)`, `getSelectedId()`, `updateData(patch)`, `updateConfig(patch)`, `getElement()`, `destroy()`.

## Stack view (the board on a floor)

`view: 'stack'` lays the board on a floor through an `@exonware/xw3d/css3d` stage (`camera` default yaw -7, pitch 50, zoom 0.94;
perspective 1100 px; the world turns about its 60 percent line). The view emits one host-owned stage and the lanes subtree as
`view.world`; the adapter mounts that subtree into the stage with a view mount of its own, so keys, events, roving focus and icon
hosts work as in the flat view. xw3d writes every perspective, transform and `transform-style` (the lane chain keeps the floor's 3D,
the tank stands 30 degrees up); the sheet has no CSS 3D. Switching from flat to stack eases the camera; a stack board with no
adapter (`projectView`) draws flat. The camera is logical and mirrors on a right-to-left page.

## Accessibility and RTL

A labelled region holding a `listbox` of `option`s with a roving tab stop: ArrowDown and ArrowUp move it (disabled items are skipped, the ends wrap), Home and End jump, Enter and Space select. Selection is `aria-selected` plus a weight change and an inline-start bar, never colour alone. Logical properties only; direction comes from the parent `dir`; numbers use Western digits unless `numberingSystem` says otherwise.

```api
```
