punkshell

1486 Commits

1 Branch

1 Tag

173 MiB

Commit Graph

Author	SHA1	Message	Date
Julian Noble	91fa500e24	Project logo: two-colour bracket mark, master + web set (src/assets/logo) Replaces the busy pixel-art punk1 artwork - unreadable below ~32px - with a flat two-colour mark: a mohawked terminal plate enclosing Tcl's [ ] command substitution, Emerald #0FA36B on ink #03120C. Drawn on a 64x64 grid to hold at 16px and verified by rendering at true pixel size on both light and dark plates, rather than judging it large and hoping. src/assets/logo/ is the icon MASTER, distinct from the build-consumed copies at src/runtime/punk1.ico and src/vfs/_vfscommon.vfs/punk1.ico. Those are deliberately untouched and remain a user-directed swap. punk-mark.svg/.ico outline plate (primary) alternative/punk-mark-solid.* solid plate web/ favicon set legacy/ retired punk1 artwork, moved from repo root make-ico.ps1 keeps the .ico reproducible: rsvg-convert for true-alpha rasterizing (never browser screenshots - they bake in a background and lose the alpha the icon depends on), then a hand-assembled ICONDIR. PE icons carry 16/24/32/48/64/128 as uncompressed BGRA DIBs plus a PNG-compressed 256, keeping that entry ~5KB instead of ~265KB - each entry becomes a separate RT_ICON in every embedding kit. Regeneration is deterministic, byte-identical across runs. The web set inverts those tradeoffs. favicon.ico is 16/32/48 all-PNG (2.5KB, fetched on every cold page load) and is web-only: all-PNG is precisely what GDI+ and tklib's ico package cannot read. web/icon.svg carries a prefers-color-scheme block serving the outline plate to light tab bars and the solid plate to dark - something an .ico structurally cannot do - verified by rendering under forced dark. The apple-touch and PWA rasters are deliberately opaque, since iOS ignores transparency and composites against black. Two decoder limits are recorded in the new AGENTS.md as properties of the readers, not defects in the files: legacy GDI+ silently returns the 128px frame when asked for 256 (WIC, which Explorer and the taskbar use, reads all seven), and tklib's ico package parses DIB entries only. Root and src AGENTS.md gain Child DOX Index entries. Both converted to LF per the root line-ending policy, which explicitly declines diff-minimisation as a reason to preserve CRLF. No punkproject.toml bump: these assets are a non-shipped surface until a build consumer is repointed. Fossil still tracks the three legacy files at their old root paths and needs the rename at the next catch-up checkin. Claude-Session: https://claude.ai/code/session_01YNjnq6oDzecknLg7AuWZgU Assisted-by: harness=claude; primary-model=claude-opus-5[1m]; api-location=anthropic.com	1 month ago

Author

SHA1

Message

Date

Julian Noble

91fa500e24

Project logo: two-colour bracket mark, master + web set (src/assets/logo)

Replaces the busy pixel-art punk1 artwork - unreadable below ~32px - with a flat
two-colour mark: a mohawked terminal plate enclosing Tcl's [ ] command
substitution, Emerald #0FA36B on ink #03120C. Drawn on a 64x64 grid to hold at
16px and verified by rendering at true pixel size on both light and dark plates,
rather than judging it large and hoping.

src/assets/logo/ is the icon MASTER, distinct from the build-consumed copies at
src/runtime/punk1.ico and src/vfs/_vfscommon.vfs/punk1.ico. Those are
deliberately untouched and remain a user-directed swap.

  punk-mark.svg/.ico              outline plate (primary)
  alternative/punk-mark-solid.*   solid plate
  web/                            favicon set
  legacy/                         retired punk1 artwork, moved from repo root

make-ico.ps1 keeps the .ico reproducible: rsvg-convert for true-alpha
rasterizing (never browser screenshots - they bake in a background and lose the
alpha the icon depends on), then a hand-assembled ICONDIR. PE icons carry
16/24/32/48/64/128 as uncompressed BGRA DIBs plus a PNG-compressed 256, keeping
that entry ~5KB instead of ~265KB - each entry becomes a separate RT_ICON in
every embedding kit. Regeneration is deterministic, byte-identical across runs.

The web set inverts those tradeoffs. favicon.ico is 16/32/48 all-PNG (2.5KB,
fetched on every cold page load) and is web-only: all-PNG is precisely what GDI+
and tklib's ico package cannot read. web/icon.svg carries a prefers-color-scheme
block serving the outline plate to light tab bars and the solid plate to dark -
something an .ico structurally cannot do - verified by rendering under forced
dark. The apple-touch and PWA rasters are deliberately opaque, since iOS ignores
transparency and composites against black.

Two decoder limits are recorded in the new AGENTS.md as properties of the
readers, not defects in the files: legacy GDI+ silently returns the 128px frame
when asked for 256 (WIC, which Explorer and the taskbar use, reads all seven),
and tklib's ico package parses DIB entries only.

Root and src AGENTS.md gain Child DOX Index entries. Both converted to LF per
the root line-ending policy, which explicitly declines diff-minimisation as a
reason to preserve CRLF.

No punkproject.toml bump: these assets are a non-shipped surface until a build
consumer is repointed. Fossil still tracks the three legacy files at their old
root paths and needs the rename at the next catch-up checkin.

Claude-Session: https://claude.ai/code/session_01YNjnq6oDzecknLg7AuWZgU
Assisted-by: harness=claude; primary-model=claude-opus-5[1m]; api-location=anthropic.com

1 month ago

1 Commits (2dbf635b99a23f8fb151e06bdb68a471a1f781e6)