# CapturedStep

**Kind:** Interface

**Source:** [`atloria-monorepo/packages/tour-widget/src/player.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/packages/tour-widget/src/player.ts#L14)

Atloria Tour Player — the live-DOM guided-tour engine (unchanged behaviour
from the original single-file widget; extracted so the D2 orchestrator can
drive it alongside checklists / announcements / NPS). It resolves each step's
REAL element (selector → xpath fallback), spotlights it and pins a tooltip.

D2 additions are surgical: an optional `hooks` bag lets the orchestrator
observe lifecycle (started / step viewed / a missing element / completed /
dismissed) for analytics — the rendering is untouched.

## Properties

| Property | Type |
|---|---|
| `order` | `number` |
| `action` | `'click' | 'input' | 'navigate' | 'submit'` |
| `selector` | `string` |
| `xpath` | `string` |
| `elementText` | `string` |
| `elementRole` | `string` |
| `url` | `string` |
| `boundingBox` | `{ x: number; y: number; w: number; h: number }` |
| `value` | `string` |
| `note` | `string` |
| `ts` | `number` |
