M3: swatch libraries — library panel, generated libraries, save and load, gradient libraries (M3.56–M3.58)

[bflatastic]

Part of M3 (Paint & appearance). Swatch libraries: a library panel with our own code-generated libraries, saving and loading libraries, and gradient libraries. Nothing is taken from Illustrator's bundled libraries; every palette is computed and named by us.

• M3.56: library panel and generated libraries.
  • Opening it: Window ▸ Swatch Libraries and the Swatches panel's library button open a floating, read-only library panel with thumbnail and list views, a find field, a libraries menu, previous/next arrows and Add to Swatches.
  • Using it: clicking a swatch adds it and applies it to the active proxy (Alt: the other proxy) in one undo step.
  • Default Swatches restores the defaults.
  • Libraries: nine, computed from OKLCH colours: Web Safe 216, Grays and Neutrals, Earth Tones, Skin Tone Ramps, Pastels, Brights, Metallic Gradients, Perceptual Scales, Harmony Sets.
  • Commands: swatch.library.list, swatch.library.get {library}, swatch.library.add {library, names?, apply?, focus?} (skips swatches the document already has), swatch.resetDefaults {replace?}. UI command window.swatchLibrary {library}.
  • Shared panel: panels/library_panel.rs is generic (LibraryKind), so graphic style libraries can reuse it.
• M3.57: saving and loading libraries.
  • Formats (color/src/palette_io.rs): .vcswatches (lossless JSON: models, global, spot, groups); .gpl palettes (RGB, # Group: headers, other tools' comments and headers read); CSS custom properties (escaped, write-only).
  • Commands: swatch.library.save {path?, format?, names?, name?, user?} returns {data} without a path. swatch.library.load {path?|data?|dataBase64?, name?} also loads another document's swatches.
  • User libraries: saved to <prefs dir>/Swatches, they appear under User Defined.
  • Opening files: a .vcswatches or .gpl file opens in the library panel, and the open dialogs gain a "Swatch libraries" filter.
• M3.58: gradient libraries and gradient swatch options.
  • Five generated gradient libraries.
  • Swatch Options on a gradient swatch shows the name and the gradient, and OK renames it.
  • swatch.edit {paint?} replaces a swatch's paint with one of the same kind, and Alt-dropping a paint on a matching swatch uses it.

docs/mcp.md and docs/control-protocol.md cover the commands and the saveSwatchLibrary dialog.

Known limits:

• One library panel at a time.
• Library swatches can't be dragged straight onto art.
• Renaming a gradient swatch doesn't update gradient links in art.

Checks

Rebased onto 1ea13b5 (#26). cargo xtask ci passes all 7 steps on this tree: 1,530 tests, 0 failed.

New tests:

• every library is deterministic, unique and in gamut;
• Web Safe has 216 colours;
• add skips duplicates in one undo step;
• the submenu lists every library;
• .vcswatches round-trips CMYK, spot and groups;
• .gpl headers and comments;
• CSS escaping;
• every generated gradient has two or more sorted stops;
• rename.

🤖 Generated with Claude Code