Jordan-Hall / Jordan-Hall/browser

[P1][UI-02] Deterministic component catalogue

Open
#50 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

Programme: #1
Epic: #19

## Objective
Ship a trusted component system rich enough that most generated experiences are compositions of tested software rather than generated executable code.

## Scope
- Tables, cards, feeds, timelines, articles, forms, calendars, charts, media/source panels, file browsers and code/diff views.
- Deterministic sorting, filtering, grouping, pagination, selection and navigation.
- Stable focus, scroll and component identity across data refreshes.
- Standard source/freshness/uncertainty/permission indicators.
- Action components bound to typed capability proposals.
- Accessibility behavior and keyboard interaction per component.
- Design tokens and density/layout variants controlled by user preferences.

## Product rules
- Common interactions never require inference.
- Data updates change bound content without regenerating the whole layout.
- Components expose provider/source semantics needed for trust, not just polished visuals.

## Acceptance criteria
- [ ] Sorting/filtering/grouping/selection performs without a model call.
- [ ] Focus and scroll remain stable during incremental data refresh where possible.
- [ ] Every interactive component has keyboard and assistive-tech behavior.
- [ ] Action controls cannot bypass UI-01 validation/SEC-02 authorization.
- [ ] Source/freshness/uncertainty states are consistently renderable across catalogue components.
- [ ] Component-level performance budgets are covered by regression tests.

## Dependencies
- UI-01
- WS-01

**First phase:** P1
**Maturity target:** P5
**Owner:** workspace-ui-data

## Task issues
- [ ] #409 `UI-02.T01` — Build design tokens and renderer contracts
- [ ] #410 `UI-02.T02` — Implement tables and comparison cards
- [ ] #411 `UI-02.T03` — Implement feeds, timelines and articles
- [ ] #412 `UI-02.T04` — Implement forms, calendars and bounded actions
- [ ] #413 `UI-02.T05` — Implement file, code, diff and evidence views
- [ ] #414 `UI-02.T06` — Implement charts and media with source context
- [ ] #415 `UI-02.T07` — Integrate stable refresh and reusable interactions
- [ ] #416 `UI-02.T08` — Qualify accessibility and performance

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reading the dependencies UI-01 and WS-01, then use task issues #409–#416 to identify the first bounded work item. Review the acceptance criteria and confirm that the selected component work covers deterministic interactions, stable refresh behavior, accessibility, authorization boundaries, source states, and performance regression tests.

Written by the indexing model from the issue text.

Assessment

Domain
accessibility, design, frontend, performance
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.