Add Palette Manager hover details layout and restore user/source palette sort controls - PR_26124_029-palette-hover-and-sort-controls

Author: DavidQ

docs/dev/reports/PR_26124_029_report.md

@@ -0,0 +1,25 @@
+# PR_26124_029 Palette Hover And Sort Controls
+
+## Summary
+- Moved source swatch details out of the color tile overlay and into a below-tile details panel.
+- Hover/focus details now show name, symbol, hex, and source without overlapping neighboring tiles.
+- Added User Palette sort selector.
+- Added Source Palette sort selector.
+- Added reusable `tools/common/PaletteSortService.js` for original/source order, hue, saturation, brightness, and name sorting.
+- Sorting is view-only and does not mutate `tools.palette-browser.swatches` or read-only source palettes.
+
+## Sort Note
+- Existing archive confirmed a prior palette sort set of Name, Hue, Saturation, and Lightness in `docs/archive/tools/SpriteEditor_old_keep/modules/controlSurfaceRightPanel.js`.
+- The new Brightness option uses the same HSL lightness metric while keeping the requested Name option.
+
+## Validation
+- `node --check tools/common/PaletteSortService.js`
+- `node --check tools/palette-manager-v2/main.js`
+- `node --check tools/palette-manager-v2/modules/PaletteManagerApp.js`
+- `node --check tools/palette-manager-v2/modules/SwatchRow.js`
+- `node --check tools/palette-manager-v2/controls/UserPaletteControl.js`
+- `node --check tools/palette-manager-v2/controls/SourcePaletteBrowserControl.js`
+- Sort service smoke check confirmed original order returns unchanged ordering and name sort does not mutate the source array.
+
+## Package
+- Delta ZIP: `tmp/PR_26124_029-palette-hover-and-sort-controls_delta.zip`

docs/dev/reports/codex_changed_files.txt

@@ -1,18 +1,25 @@
 # git status --short
-AM docs/dev/reports/PR_26124_028_report.md
-M  docs/dev/reports/codex_changed_files.txt
-MM docs/dev/reports/codex_review.diff
-MM src/engine/paletteList.js
-M  tools/palette-manager-v2/controls/SourcePaletteBrowserControl.js
-M  tools/palette-manager-v2/index.html
-M  tools/palette-manager-v2/modules/PaletteManagerApp.js
-M  tools/palette-manager-v2/modules/SwatchRow.js
-M  tools/palette-manager-v2/paletteManagerV2.css
+M docs/dev/reports/codex_review.diff
+ M tools/palette-manager-v2/controls/SourcePaletteBrowserControl.js
+ M tools/palette-manager-v2/controls/UserPaletteControl.js
+ M tools/palette-manager-v2/index.html
+ M tools/palette-manager-v2/main.js
+ M tools/palette-manager-v2/modules/PaletteManagerApp.js
+ M tools/palette-manager-v2/modules/SwatchRow.js
+ M tools/palette-manager-v2/paletteManagerV2.css
+?? docs/dev/reports/PR_26124_029_report.md
+?? tools/common/PaletteSortService.js
 
 # git diff --stat (excluding codex review artifacts)
-docs/dev/reports/PR_26124_028_report.md |  4 ++--
- src/engine/paletteList.js               | 26 ++++++++++++++++----------
- 2 files changed, 18 insertions(+), 12 deletions(-)
+.../controls/SourcePaletteBrowserControl.js        | 15 +++++++
+ .../controls/UserPaletteControl.js                 | 20 ++++++++-
+ tools/palette-manager-v2/index.html                |  8 ++++
+ tools/palette-manager-v2/main.js                   |  2 +
+ .../modules/PaletteManagerApp.js                   | 48 ++++++++++++++++++++--
+ tools/palette-manager-v2/modules/SwatchRow.js      | 11 +++--
+ tools/palette-manager-v2/paletteManagerV2.css      | 44 +++++++++++---------
+ 7 files changed, 119 insertions(+), 29 deletions(-)
 
 # untracked file additions
-(no output)
+ docs/dev/reports/PR_26124_029_report.md | 25 +
+ tools/common/PaletteSortService.js | 121 +