docs(color-handle): add Phase 1 migration plan#6414
Conversation
Add the 1st-gen to 2nd-gen migration plan for color-handle, covering API surface, dependencies, breaking changes, core/SWC split architecture, and the SWC-2295 adaptive white-first border contrast (WCAG 1.4.11) a11y work. Confirmed decisions: core/SWC split mirroring color-loupe, color-loupe kept built-in (not slotted), and grow-on-focus as the focus indicator. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
📚 Branch Preview Links🔍 First Generation Visual Regression Test ResultsWhen a visual regression test fails (or has previously failed while working on this branch), its results can be found in the following URLs:
Deployed to Azure Blob Storage: If the changes are expected, update the |
Update the color-handle migration plan after reviewing the Figma S2 / Web (Desktop scale) spec and incorporating team decisions: - Wire Epic SWC-2137 throughout. - Capture the Figma property model (State, Show handle fill, Show color loupe) and the box-model note (outer border excluded from handle size). - Ship the new fill option now (B8); keep open unchanged; keep focused unchanged, documenting the RSP focus-vs-click model (enlarge only on parent focus, click without parent focus opens the loupe). - Mark Q1/Q3/Q4/Q5/Q7 resolved; source the adaptive dual-border algorithm from the now-present accessibility migration analysis. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…notes - Update references now that the color-handle accessibility-migration-analysis.md is present; mark Q4 resolved and source a11y items from it. - Resolve Q6: the color-loupe half of SWC-2295 is kept separate and ships as a fast-follow PR; out of scope for this migration. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Rajdeepc
added
the
2nd gen
2 participants
Description
Adds the Phase 1 (Preparation) 1st-gen → 2nd-gen migration plan for
color-handleatCONTRIBUTOR-DOCS/03_project-planning/03_components/color-handle/migration-plan.md. Planning output only — no component code changes. Also includes the auto-regenerated CONTRIBUTOR-DOCS navigation (breadcrumbs/TOC) for the new file.Motivation and context
color-handleis queued for 2nd-gen migration. Its dependencies are already migrated (color-loupe;opacity-checkerboardas a shared stylesheet), so it is unblocked. This plan documents the 1st-gen surface, breaking changes, the core/SWC split architecture, and the new accessibility work from SWC-2295.Confirmed decisions
ColorHandleBasein core,swc-color-handlein SWC), mirroring the migratedcolor-loupe.color/open/focused/disabled) unchanged. Supersedes the prior SWC-1134 exception.Related issue(s)
Reviewer notes
This is a plan for review, not implementation. Open questions are tracked in the plan's Blockers section:
S2 / Web (Desktop scale)reference missingfocusedpublic/reflected vs internal-onlyAccessibility testing checklist
N/A for this PR — documentation/planning only, no runnable component changes. The plan itself defines the a11y requirements (WCAG 1.4.11 non-text contrast) to be implemented and tested in later phases.