Skip to content

refactor(ui,settings): unify Select wrappers into one primitive + dead selector sweep - #254

Merged
jackwener merged 1 commit into
mainfrom
yuejing/round-ab-shared-select-primitive
Jun 25, 2026
Merged

refactor(ui,settings): unify Select wrappers into one primitive + dead selector sweep#254
jackwener merged 1 commit into
mainfrom
yuejing/round-ab-shared-select-primitive

Conversation

@jackwener

Copy link
Copy Markdown
Member

Summary

Bundled Round A (dead selector sweep) + Round B (shared Rich Select primitive + call-site migration) per @kenji styles inventory task #128 (notes/maka-styles-css-inventory-2026-06-25-task-128.md) and @WAWQAQ thread #my-ai:b26d4b58 msg dea869c5 / 61862591 ("做久一点 / 一次多做点", kenji handed off to me).

Round B — shared SettingsSelect primitive

  • New packages/ui/src/primitives/settings-select.tsx. Option type [value, label, icon?]; width variant (compact | select | full); trigger uses SelectValue's function-child so the collapsed picked state renders the same icon + label row as the popup items (the bug fix that PR fix(ui,styles): Plan Reminder trigger logo + 100vh→100dvh sweep (kenji round 3 #2, #6) #250 only landed for Plan Reminder is now baked into the primitive itself).
  • PlanReminderSelect in components.tsx collapses to a thin <SettingsSelect width=\"full\" {...props} /> specialization. Both surfaces use one source of truth.
  • SettingsModal.tsx drops its local SettingsSelect definition; the 5 existing call sites (Daily Review 分析模型 / Proxy 代理协议 / Gateway 监听地址 / Bot 域名 / Usage 状态筛选) automatically pick up the imported primitive — same [value, label] props still work.
  • CSS: rename .maka-plan-select* / .settingsBaseSelectTrigger*.settingsSelect* family. .settingsBaseSelectPopup block dropped (no consumers). .settingsRow[data-control-width=\"select\"] and .settingsField[data-orient=\"horizontal\"] keep the same width contract, now keyed off .settingsSelectTrigger.

Round A — dead selector sweep

Per kenji inventory the following had zero JSX/TSX consumers; re-verified each:

  • .maka-nav-primary (3 rules under .maka-session-panel[data-collapsed=\"true\"])
  • .maka-skill-workbench-rail

Both promoted into renderer-style-pruning-contract.test.ts's retired-hook list (alongside the 12 already locked there). Contract test passes after deletion.

Net

+162 / -148. One source of truth for Settings + Plan Reminder Select chrome; one less wrapper; ~24 lines of dead CSS gone. Round C (ChoiceCard/RadioCard) and Round D (CSS ownership split) still on kenji's plan.

Test plan

  • pnpm -F @maka/ui build — clean.
  • tsc --noEmit -p apps/desktop/tsconfig.renderer.json — only the pre-existing unrelated TS2366 at line 5790.
  • node --test dist/main/__tests__/renderer-style-pruning-contract.test.js — pass (1/1).
  • Daily Review 分析模型 select renders + selects + collapsed trigger keeps the same chrome as before.
  • Plan Reminder 平台 select shows brand logo in both items AND collapsed trigger.
  • Proxy / Gateway / Bot / Usage selects still render at 320px on horizontal field rows.

… one primitive + dead selector sweep

@kenji styles inventory task #128
(`notes/maka-styles-css-inventory-2026-06-25-task-128.md`) flagged that
`styles.css` (14066 lines) had become the product's UI database, with
the Settings select and Plan Reminder select drifted into two
near-identical wrappers + two CSS recipes. The Plan Reminder copy
got a real bug fix (selected-trigger icon) in PR #250; the Settings
copy never did.

@WAWQAQ msg `dea869c5` "做久一点 / 一次多做点" + msg `61862591`
authorizing this round; coordination ack `a137b9d7`. This bundles
Round A (dead selector sweep) and Round B (shared Rich Select
primitive + call-site migration) into one PR.

**Round B — shared SettingsSelect primitive.**
- New `packages/ui/src/primitives/settings-select.tsx`. Option type
  `[value, label, icon?]`; `width` variant (`compact` | `select` |
  `full`); the trigger uses `SelectValue`'s function-child so the
  collapsed picked state renders the same icon + label row as the
  popup items.
- `PlanReminderSelect` in `components.tsx` collapsed to a thin
  `<SettingsSelect width="full" {...props} />` specialization. Both
  surfaces now share one source of truth.
- `SettingsModal.tsx` drops its local `SettingsSelect` definition; the
  5 existing call sites (Daily Review 分析模型, Proxy 代理协议, Gateway
  监听地址, Bot 域名, Usage 状态筛选) automatically pick up the imported
  primitive — same `[value, label]` props still work.
- CSS: rename `.maka-plan-select*` / `.settingsBaseSelectTrigger*` →
  `.settingsSelect*` family on the primitive side; drop the
  `.settingsBaseSelectPopup` block that no longer has a consumer.
  `.settingsRow[data-control-width="select"]` and
  `.settingsField[data-orient="horizontal"]` keep the same width
  contract, now keyed off `.settingsSelectTrigger`.

**Round A — dead selector sweep.**
Per @kenji inventory the following had zero JSX/TSX consumers; I
re-verified each with `grep --include='*.tsx'`:
  - `.maka-nav-primary` (3 rules under `.maka-session-panel[data-
    collapsed="true"]`)
  - `.maka-skill-workbench-rail`

Promoted both into `renderer-style-pruning-contract.test.ts`'s
retired-hook list alongside the 12 already locked there. The contract
test (`✔ does not keep CSS for retired renderer hooks`) passes after
the deletion.

Net: +162 / -148 lines. One source of truth for the Settings/Plan
Reminder Select chrome; one less wrapper and ~24 lines of dead CSS to
maintain. Round C (ChoiceCard/RadioCard) and Round D (CSS ownership
split) still on @kenji's plan.
@jackwener
jackwener merged commit 618e850 into main Jun 25, 2026
@jackwener
jackwener deleted the yuejing/round-ab-shared-select-primitive branch June 25, 2026 11:32
jackwener added a commit that referenced this pull request Jun 25, 2026
…onnectionStatus) (#255)

* refactor(ui,settings): unify SettingsSelect + PlanReminderSelect into one primitive + dead selector sweep

@kenji styles inventory task #128
(`notes/maka-styles-css-inventory-2026-06-25-task-128.md`) flagged that
`styles.css` (14066 lines) had become the product's UI database, with
the Settings select and Plan Reminder select drifted into two
near-identical wrappers + two CSS recipes. The Plan Reminder copy
got a real bug fix (selected-trigger icon) in PR #250; the Settings
copy never did.

@WAWQAQ msg `dea869c5` "做久一点 / 一次多做点" + msg `61862591`
authorizing this round; coordination ack `a137b9d7`. This bundles
Round A (dead selector sweep) and Round B (shared Rich Select
primitive + call-site migration) into one PR.

**Round B — shared SettingsSelect primitive.**
- New `packages/ui/src/primitives/settings-select.tsx`. Option type
  `[value, label, icon?]`; `width` variant (`compact` | `select` |
  `full`); the trigger uses `SelectValue`'s function-child so the
  collapsed picked state renders the same icon + label row as the
  popup items.
- `PlanReminderSelect` in `components.tsx` collapsed to a thin
  `<SettingsSelect width="full" {...props} />` specialization. Both
  surfaces now share one source of truth.
- `SettingsModal.tsx` drops its local `SettingsSelect` definition; the
  5 existing call sites (Daily Review 分析模型, Proxy 代理协议, Gateway
  监听地址, Bot 域名, Usage 状态筛选) automatically pick up the imported
  primitive — same `[value, label]` props still work.
- CSS: rename `.maka-plan-select*` / `.settingsBaseSelectTrigger*` →
  `.settingsSelect*` family on the primitive side; drop the
  `.settingsBaseSelectPopup` block that no longer has a consumer.
  `.settingsRow[data-control-width="select"]` and
  `.settingsField[data-orient="horizontal"]` keep the same width
  contract, now keyed off `.settingsSelectTrigger`.

**Round A — dead selector sweep.**
Per @kenji inventory the following had zero JSX/TSX consumers; I
re-verified each with `grep --include='*.tsx'`:
  - `.maka-nav-primary` (3 rules under `.maka-session-panel[data-
    collapsed="true"]`)
  - `.maka-skill-workbench-rail`

Promoted both into `renderer-style-pruning-contract.test.ts`'s
retired-hook list alongside the 12 already locked there. The contract
test (`✔ does not keep CSS for retired renderer hooks`) passes after
the deletion.

Net: +162 / -148 lines. One source of truth for the Settings/Plan
Reminder Select chrome; one less wrapper and ~24 lines of dead CSS to
maintain. Round C (ChoiceCard/RadioCard) and Round D (CSS ownership
split) still on @kenji's plan.

* chore(css): drop 2 more verified-dead selectors + lock in retired-hook contract

Round A-extended (yuejing 2026-06-25). @WAWQAQ 「继续」 (msg
`76e36d3b`) after #254 landed. Sticking to zero-visual-risk cleanup
while @kenji is offline and the ChoiceCard / RadioCard primitive
(Round C) still needs a visual-smoke harness to be safe.

Found two more selectors with zero JSX/TSX consumers via the standard
sweep against `apps/desktop/src/renderer/styles.css`:

- `.providerCatalog` — bare base class. `.providerCatalogRow` /
  `.providerCatalogTitle` / `.providerCatalogDesc` etc. are live in
  `ProvidersPanel.tsx`, but nothing renders the bare class itself.
- `.connectionStatus[data-ok="false"]` — combinator. No element ever
  carries the `connectionStatus` class in the renderer; the live
  status arm in the codebase is `.settingsConnectionBadge[data-tone]`,
  and `.providerError` (the other arm of the same rule) is unrelated
  and stays.

Both promoted into `renderer-style-pruning-contract.test.ts`'s
retired-hook list (now locks 16). `\.${hook}\b` boundary keeps the
live `.providerCatalogRow` / `.settingsConnectionBadge` siblings
clear.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant