adobe / spectrum-web-components / 27861032329

96%

push

github

docs(color-handle): add Phase 1 migration plan (#6414)

* docs(color-handle): add Phase 1 migration plan

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>

* chore(color-handle): minor fix

* docs(color-handle): reconcile plan with Figma S2 and team API decisions

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>

* docs(color-handle): resolve a11y-analysis and color-loupe sequencing 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>

* docs(color-handle): address PR review feedback

- Renumber the fill breaking change B8 -> B7 to close the numbering gap.
- Drop the specific package version reference from the 1st-gen surface.
- Replace em dashes per .ai/rules/text-fo... (continued)

6014 of 6456 branches covered (93.15%)

Branch coverage included in aggregate %.

37901 of 39172 relevant lines covered (96.76%)

458.98 hits per line