mirror of
https://github.com/kovidgoyal/kitty.git
synced 2026-06-26 19:01:27 +00:00
64abd87a9e
Implements modern wide gamut color formats with CSS Color Module Level 4 gamut mapping, addressing PR feedback with Go implementation, performance benchmarks, and reorganized documentation. Features: - OKLCH (perceptually uniform color space) - CIE LAB (device-independent color space) - CSS Color 4 compliant gamut mapping algorithm - Inline comment support in color config parsing Addressing PR Feedback: 1. Go Implementation (tools/utils/style/): - Complete OKLCH and LAB parsing with gamut mapping - Matches Python implementation structure - Comprehensive test suite (all tests passing) - Performance benchmarks showing acceptable overhead 2. Performance Benchmarks: - OKLCH: ~4.6 µs/op - LAB: ~1.5 µs/op - 10 mixed colors: ~13 µs total - Typical config (50 colors): <0.5ms startup impact 3. Documentation Reorganization: - Moved detailed color docs to docs/wide-gamut-colors.rst - Configuration docs now link to separate documentation - Reduces size of main configuration documentation Gamut Mapping: - Binary search chroma reduction from CSS Color Module Level 4 - Preserves lightness and hue while reducing chroma for out-of-gamut colors - Uses deltaE OK (JND threshold: 0.02) for perceptual difference - Ensures graceful degradation on sRGB displays Python Implementation: - parse_oklch(): OKLCH color parsing with gamut mapping - parse_lab(): CIE LAB parsing with gamut mapping via OKLCH conversion - lab_to_oklch(): LAB to OKLCH conversion for consistent gamut mapping - oklch_to_srgb_gamut_map(): CSS Color 4 gamut mapping algorithm - srgb_to_oklab(): Reverse conversion for deltaE calculations - deltaE_ok(): Perceptual color difference in OKLab space Go Implementation: - colorspaces.go: All color space conversions and gamut mapping - wrapper.go: ParseColor() updated to support OKLCH and LAB - Comprehensive test coverage with benchmarks - Matches Python implementation behavior Robustness: - NaN and infinity validation in all color parsing functions - Defense-in-depth with validation at parsing and gamut mapping levels - Returns None/error for invalid input (consistent error handling) - Validates before clamping operations to prevent NaN propagation Files changed: - Python: kitty/rgb.py, kitty_tests/datatypes.py (+250 lines) - Go: tools/utils/style/colorspaces.go, wrapper.go (+350 lines, tests) - Docs: docs/wide-gamut-colors.rst (moved from inline) - Config: kitty/options/definition.py (simplified, links to docs) References: - CSS Color Module Level 4: https://www.w3.org/TR/css-color-4/ - OKLCH Color Space: https://bottosson.github.io/posts/oklab/ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| _static | ||
| _templates | ||
| kittens | ||
| screenshots | ||
| actions.rst | ||
| basic.rst | ||
| binary.rst | ||
| build.rst | ||
| changelog.rst | ||
| clipboard.rst | ||
| color-stack.rst | ||
| conf.py | ||
| conf.rst | ||
| deccara.rst | ||
| desktop-notifications.rst | ||
| extract-rst-targets.py | ||
| faq.rst | ||
| file-transfer-protocol.rst | ||
| glossary.rst | ||
| graphics-protocol.rst | ||
| index.rst | ||
| installer.sh | ||
| integrations.rst | ||
| intro_vid.rst | ||
| invocation.rst | ||
| keyboard-protocol.rst | ||
| kittens_intro.rst | ||
| launch.rst | ||
| layouts.rst | ||
| Makefile | ||
| mapping.rst | ||
| marks.rst | ||
| misc-protocol.rst | ||
| multiple-cursors-protocol.rst | ||
| notifications.py | ||
| open_actions.rst | ||
| overview.rst | ||
| performance.rst | ||
| pipe.rst | ||
| pointer-shapes.rst | ||
| press-mentions.rst | ||
| protocol-extensions.rst | ||
| quake-screenshots.rst | ||
| quickstart.rst | ||
| rc_protocol.rst | ||
| remote-control.rst | ||
| requirements.txt | ||
| sessions.rst | ||
| shell-integration.rst | ||
| support.html | ||
| support.rst | ||
| text-sizing-protocol.rst | ||
| underlines.rst | ||
| unscroll.rst | ||
| wide-gamut-colors.rst | ||