114 lines
5.4 KiB
Markdown
114 lines
5.4 KiB
Markdown
---
|
|
status: draft
|
|
system: ui
|
|
requirements:
|
|
- REQ-UI-SIDEBAR-TASK-ROW-PRESENTATION-001
|
|
---
|
|
|
|
# Sidebar Task Row Presentation System Design
|
|
|
|
## Purpose and boundaries
|
|
|
|
The UI system owns this independent task-row presentation contract. Task and integration systems
|
|
continue to own timestamps, task state, and change-request status.
|
|
|
|
This refinement changes only the compact trailing slot. It does not change saved view data,
|
|
provider state, task navigation, or the full relative-time formatter used by other surfaces.
|
|
|
|
## Requirement mapping
|
|
|
|
| Requirement | Design sections |
|
|
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `REQ-UI-SIDEBAR-TASK-ROW-PRESENTATION-001` | [Trailing layout](#trailing-layout), [Compact elapsed time](#compact-elapsed-time), [Responsive behavior](#responsive-behavior), [Accessibility](#accessibility) |
|
|
|
|
## Components and responsibilities
|
|
|
|
- `TaskItem` resolves the saved presentation and supplies the selected timestamp and trailing value.
|
|
- `TaskItemTrailing` owns the compact Git changes, relative time, change-request status, and menu
|
|
layout.
|
|
- `TaskMenuButton` keeps the established context-menu dispatch and focus semantics.
|
|
- `lib/i18n/formats.ts` owns a sidebar-only elapsed-time formatter and its locale-aware unit tokens.
|
|
- `app/globals.css` keeps the existing phone rule that exposes a 44 CSS pixel task action.
|
|
|
|
## Trailing layout
|
|
|
|
The change-request branch uses one flex cluster. The status is the only width-bearing item while a
|
|
fine-pointer row is idle. The menu wrapper has zero width and does not create a blank trailing gap.
|
|
|
|
Outer-row hover or focus expands the menu wrapper to the button width. The menu appears beside the
|
|
status. The status stays mounted and keeps its pointer and keyboard disclosure behavior.
|
|
|
|
The branch omits the complete cluster when no status exists. The established menu-only fallback
|
|
continues to expose task actions.
|
|
|
|
The relative-time branch keeps its existing overlay swap. Its visual time column has a fixed width,
|
|
right-aligned text, and tabular numbers. Hover or menu-open state replaces the time with the menu in
|
|
that same column on fine pointers.
|
|
|
|
## Compact elapsed time
|
|
|
|
The sidebar uses a dedicated formatter. It does not change `formatRelativeTime`, because plugins and
|
|
other product surfaces depend on full localized relative phrases.
|
|
|
|
The formatter calculates elapsed time from the selected timestamp. It clamps future clock skew to
|
|
zero and floors each completed unit. It selects these buckets:
|
|
|
|
| Elapsed value | Display unit |
|
|
| -------------------- | ------------ |
|
|
| Less than 60 seconds | seconds |
|
|
| Less than 60 minutes | minutes |
|
|
| Less than 24 hours | hours |
|
|
| Less than 7 days | days |
|
|
| Less than 365 days | weeks |
|
|
| 365 days or more | years |
|
|
|
|
The visual output contains one localized integer and one compact unit token. It never contains a
|
|
direction word or an idiomatic calendar phrase. Values above 99 years use a bounded `99+` magnitude
|
|
so the visual column remains stable.
|
|
|
|
Message-catalog keys define the six compact units for every shipped locale. This gives the UI a
|
|
stable width on system WebKit runtimes without a new `Intl.DurationFormat` compatibility boundary.
|
|
|
|
Invalid or empty input returns no display value. `TaskItemTrailing` then renders no time column and
|
|
does not reserve an empty gap.
|
|
|
|
## Responsive behavior
|
|
|
|
Desktop and other fine-pointer layouts use hover and focus disclosure. The idle change-request
|
|
status uses the far-right edge. The menu consumes width only while it is visible.
|
|
|
|
The phone task-switcher drawer remains the nearest shipped mobile exemplar. The row stays the
|
|
primary action. The existing mobile CSS keeps the task menu visible with a 44 CSS pixel target, so
|
|
touch users do not depend on hover. The change-request status remains passive on coarse pointers.
|
|
|
|
The sidebar task list remains the only scroll owner. The change does not add an overlay, safe-area
|
|
boundary, or horizontal scroll region.
|
|
|
|
## Accessibility
|
|
|
|
The change-request status keeps its current focusable tooltip trigger. Keyboard focus can reach the
|
|
status and the task menu without overlap.
|
|
|
|
The compact visual timestamp exposes the full localized `formatRelativeTime` result as its
|
|
accessible name. The visual token is not the only time description.
|
|
|
|
## Failure behavior
|
|
|
|
A missing change-request status falls back to the menu-only branch. An invalid timestamp omits the
|
|
time column. Neither case changes the saved view or reports a user-facing error.
|
|
|
|
## Tests
|
|
|
|
Unit tests cover every time boundary, future clock skew, invalid input, the 99-year bound, and all
|
|
shipped locales. Component tests cover idle width, hover/focus classes, status reachability, menu
|
|
fallback, and the fixed time column.
|
|
|
|
Desktop Playwright coverage proves the idle status reaches the row edge and hover reveals the menu
|
|
without covering the status. Mobile Playwright coverage proves the visible touch action, primary
|
|
row navigation, fixed time column, and absence of document horizontal overflow.
|
|
|
|
## Related designs
|
|
|
|
- [PR Task Status Summary](pr-task-status-summary.md)
|
|
- [Sidebar Task Focus](sidebar-task-focus.md)
|