astrolabe/docs/ux-second-pass.md

UX second pass — batched council review

A running parking lot of small UX / interaction decisions deferred for a batched /council review, rather than gating each one the moment it surfaces. Append quirks here as they come up; resolve them together in one pass, record the resolution into the contract (docs/architecture/09+10 and the relevant docs/spec/), then delete the row.

Open

• Extract-to-Dataset has no keyboard accelerator — its sibling editor actions (wrap / config, in spec-transform-actions / spec-config-actions) register an F1-palette command and a lightbulb; Extract is toolbar-only (runExtract in services/extract-action.ts), because it opens a modal rather than making an in-place undoable edit, so the palette/lightbulb fit awkwardly. Decide whether to add a palette command anyway for parity (a keyboard path to open the modal at the cursor), or leave toolbar-only.

• Storage-full copy implies a per-tier budget, but quota is whole-origin — the messages say "snippet storage is full" / "dataset storage is full" and tell the user to delete that entity's items, yet IndexedDB quota is shared across the whole origin. Per-tier framing is more actionable (deleting the tier you're saving into does free space) but misstates the scope. Decide: keep the actionable per-tier framing, or switch to a whole-origin "Storage is full — free space (the Storage monitor shows what's using it)". Affects both storageErrorNotification and entityStorageErrorNotification in services/storage-errors.ts and the import-quota copy in services/transfer.ts.

Deferred (not design debts, revisit on demand)

• Drag-and-drop field assignment — chips are click/keyboard-first by design; drag would be a progressive enhancement on top of the chooser model, not a replacement. Revisit if real usage asks for it (likely alongside Phase 4 faceting, where drag-to-shelf reads most naturally).

• Theme Builder config editor stays a plain textarea (decided 2026-06-13) — a second Monaco mount is heavy inside a modal for an occasional surface; the parse error is the feedback channel that matters. Revisit only if real usage asks for config completions. The gallery's per-card captions stand as the canvas charts' text alternative.