app icon: regal engraved dragon (owner's ArtCraft drawing), Dock/taskbar/launcher wiring, palette docs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

assets/app-icon/LICENSE.txt

@@ -0,0 +1,12 @@
+VectorCraft app icon (vectorcraft.svg, vectorcraft-small.svg and every file derived from them in this
+directory: vectorcraft-1024.png, vectorcraft-macos-512.png, vectorcraft.icns, vectorcraft.ico, hicolor/).
+
+Original artwork made for this project by the project owner, drawn in ArtCraft and vectorised for
+VectorCraft (no third-party material). Licensed like the rest of VectorCraft, under either of
+
+  * Apache License, Version 2.0 (https://www.apache.org/licenses/LICENSE-2.0)
+  * MIT license (https://opensource.org/licenses/MIT)
+
+at your option.
+
+Regenerate the derived files with packaging/icons.sh.

assets/app-icon/README.md

@@ -0,0 +1,51 @@
+# VectorCraft app icon
+
+**Creature:** a regal engraved dragon, VectorCraft's mascot.
+
+**Style:** an engraving-style portrait in the Crafting Apps owl template (the FilmCraft owl): a tight
+head-and-shoulders portrait on a full-bleed field, no frame or roundel, with the body running off the tile.
+
+**Palette** (exactly three colours):
+
+| Colour | Hex | Used for |
+|---|---|---|
+| Ink | `#0b0b0c` | line work and contour |
+| Paper | `#efe9dc` | the figure |
+| VectorCraft colour | `#e8573f` | the full-bleed field |
+
+**Tile:** `viewBox="0 0 512 512"`, a rounded square with `rx=112`, clipped. The macOS files add Apple's
+transparent margin (tile = 824/1024 of the canvas); Windows and Linux use the tile edge to edge.
+
+**Provenance:** the owner's original ArtCraft drawing (2880 px, keyed to the palette), vectorised with
+craftrules `assets/logo-options/_tools/vectorize_tile.py`. The drawing is kept in craftrules at
+`craftrules/assets/app-icons/vectorcraft/source.png`, not here. `vectorcraft.svg` is the canonical
+artwork. Licence: see `LICENSE.txt`.
+
+## Files
+
+| File | What | Used by |
+|---|---|---|
+| `vectorcraft.svg` | master vector (traced at 2048 px, about 700 KB) | source for everything below |
+| `vectorcraft-small.svg` | lighter vector (traced at 1024 px, about 370 KB) | `hicolor/scalable` |
+| `vectorcraft-1024.png` | full tile, 1024 px | docs, store listings |
+| `vectorcraft-macos-512.png` | tile with Apple margin, 512 px | runtime Dock icon (`apps/vectorcraft/src/main.rs`) |
+| `vectorcraft.icns` | macOS icon set, 16 to 1024 px | `cargo xtask bundle` (`CFBundleIconFile`) |
+| `vectorcraft.ico` | Windows icon, 16 to 256 px | `apps/vectorcraft/build.rs` (embedded in the `.exe`) |
+| `hicolor/<size>/apps/ai.storyteller.vectorcraft.png` | Linux theme icons, 16 to 512 px; the 256 one is also the runtime icon on Windows and Linux | `packaging/linux/ai.storyteller.vectorcraft.desktop` |
+| `hicolor/scalable/apps/ai.storyteller.vectorcraft.svg` | Linux scalable icon | as above |
+
+## How it reaches each OS
+
+- **macOS:** the app sets the Dock / app-switcher icon at runtime (`ViewportBuilder::with_icon`); the
+  `.app` from `cargo xtask bundle` carries `vectorcraft.icns`.
+- **Windows:** `build.rs` embeds `vectorcraft.ico` and VERSIONINFO with `winresource` (taskbar, Start
+  menu, Explorer, Alt-Tab); the runtime icon covers the title bar.
+- **Linux:** install `packaging/linux/ai.storyteller.vectorcraft.desktop` to `share/applications/` and
+  `hicolor/` to `share/icons/`. The app sets its Wayland app ID / X11 class to
+  `ai.storyteller.vectorcraft`, so the dock matches the window to the launcher.
+
+## Regenerate
+
+Edit or replace `vectorcraft.svg` (and `vectorcraft-small.svg`), then run `packaging/icons.sh`
+(needs `resvg`; `iconutil` on macOS for the `.icns`). It writes every PNG, the `.ico` (via
+`cargo xtask ico`) and the `.icns`.