ViewCapture

Defined in: packages/xray/src/plate.ts:165

One capture of a component within one viewport view — [min, max) in px, either side open-ended when undefined. The id-form { tree, rules } shape emit projects a measured View into (ADR 0004). The disk/wire shape is StoredPlate (below); this is the framework-neutral per-View capture shape, exported for consumers reading the id-form projection directly.

Properties

diagnostics?

optional diagnostics?: CaptureDiagnostic[]

Defined in: packages/xray/src/plate.ts:180

TRANSIENT, dev-only capture diagnostics (why this view may be lower fidelity). Captured in the browser (mirrored onto ViewIR.diagnostics); the dev client logs it and posts it alongside the StoredPlate (so the Vite server can print the same text). It MUST NEVER be persisted: it is not part of the committed StoredPlate disk shape, the validator does not carry it, and the POST envelope keeps it in a SIBLING field that never reaches the stored artifact (ADR 0008). Absent in production (the prod adapter ships no capture). See diagnostics.ts and ADR 0008.

---

max?

optional max?: number

Defined in: packages/xray/src/plate.ts:169

---

min?

optional min?: number

Defined in: packages/xray/src/plate.ts:168

---

rules

rules: PlateRule[]

Defined in: packages/xray/src/plate.ts:171

---

tree

tree: PlateNode

Defined in: packages/xray/src/plate.ts:170

---

width

width: number

Defined in: packages/xray/src/plate.ts:167

Viewport width at capture time.