Upgrade coloraide

.github/workflows/build.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
@@ -39,7 +39,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
@@ -59,7 +59,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
       uses: actions/setup-python@v4
       with:

.github/workflows/deploy.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python

CHANGES.md

@@ -1,5 +1,12 @@
 # ColorHelper
 
+## 6.4
+
+-   **NEW**: Upgrade ColorAide.
+-   **NEW**: Note in documentation and settings a new gamut mapping  
+    method, `oklch-raytrace`, which does a chroma reduction much  
+    faster and closer than the current suggested CSS algorithm.
+
 ## 6.3.2
 
 - **FIX**: Fix missing requirement for `math.isclose` in ColorAide  

ch_picker.py

@@ -109,7 +109,7 @@ def get_color_map_square_hsv(self, mode='hsv'):
         global default_border
         global color_scale
 
-        hue, saturation, value = alg.no_nans(self.color.convert(mode)[:-1])
+        hue, saturation, value = self.color.convert(mode).coords(nans=False)
 
         r_sat = saturation
         r_val = value
@@ -248,7 +248,7 @@ def get_color_map_square(self, mode='hsl'):
         global default_border
         global color_scale
 
-        hue, saturation, lightness = alg.no_nans(self.color.convert(mode)[:-1])
+        hue, saturation, lightness = self.color.convert(mode).coords(nans=False)
 
         r_sat = saturation
         r_lit = lightness

color_helper.sublime-settings

@@ -117,7 +117,7 @@
     "gamut_space": "srgb",
 
     // Gamut mapping approach
-    // Supported methods are: `lch-chroma`, `oklch-chroma`, and `clip` (default).
+    // Supported methods are: `lch-chroma`, `oklch-chroma`, `oklch-raytrace`, and `clip` (default).
     // `lch-chroma` was the original default before this was configurable.
     "gamut_map": "clip",
 
@@ -135,7 +135,6 @@
         // "ColorHelper.lib.coloraide.spaces.acescc.ACEScc",
         // "ColorHelper.lib.coloraide.spaces.acescg.ACEScg",
         // "ColorHelper.lib.coloraide.spaces.acescct.ACEScct",
-        // "ColorHelper.lib.coloraide.spaces.cam16.CAM16",
         // "ColorHelper.lib.coloraide.spaces.cam16_jmh.CAM16JMh",
         // "ColorHelper.lib.coloraide.spaces.cam16_ucs.CAM16UCS",
         // "ColorHelper.lib.coloraide.spaces.cam16_ucs.CAM16SCD",
@@ -149,7 +148,7 @@
         // "ColorHelper.lib.coloraide.spaces.hunter_lab.HunterLab",
         // "ColorHelper.lib.coloraide.spaces.ictcp.ICtCp",
         // "ColorHelper.lib.coloraide.spaces.igtgpg.IgTgPg",
-        // "ColorHelper.lib.coloraide.spaces.itp.ITP",
+        // "ColorHelper.lib.coloraide.spaces.ipt.IPT",
         // "ColorHelper.lib.coloraide.spaces.jzazbz.Jzazbz",
         // "ColorHelper.lib.coloraide.spaces.jzczhz.JzCzhz",
         // "ColorHelper.lib.coloraide.spaces.lch99o.LCh99o",
@@ -158,6 +157,7 @@
         // "ColorHelper.lib.coloraide.spaces.rec2100_hlg.Rec2100HLG",
         // "ColorHelper.lib.coloraide.spaces.rec2100_pq.Rec2100PQ",
         // "ColorHelper.lib.coloraide.spaces.rlab.RLAB",
+        // "ColorHelper.lib.coloraide.spaces.ryb.RYB",
         // "ColorHelper.lib.coloraide.spaces.xyb.XYB",
         // "ColorHelper.lib.coloraide.spaces.xyy.xyY",
         "ColorHelper.lib.coloraide.spaces.hsluv.HSLuv",
@@ -257,7 +257,8 @@
             "output": [
                 {"space": "srgb", "format": {"hex": true}},
                 {"space": "srgb", "format": {"comma": true, "precision": 3}},
-                {"space": "hsl", "format": {"comma": true, "precision": 3}}
+                {"space": "hsl", "format": {"comma": true, "precision": 3}},
+                {"space": "hwb", "format": {"comma": true, "precision": 3}}
             ]
         },
         "tmtheme": {

custom/ahex.py

@@ -36,18 +36,16 @@ class ASRGB(sRGB):
 
     COLOR_FORMAT = False
 
-    @classmethod
-    def match(cls, string, start=0, fullmatch=True):
+    def match(self, string, start=0, fullmatch=True):
         """Match a CSS color string."""
 
         m = MATCH.match(string, start)
         if m is not None and (not fullmatch or m.end(0) == len(string)):
             return split_channels(m.group(0)), m.end(0)
         return None
 
-    @classmethod
     def to_string(
-        cls, parent, *, options=None, alpha=None, precision=None, fit=True, none=False, **kwargs
+        self, parent, *, options=None, alpha=None, precision=None, fit=True, none=False, **kwargs
     ):
         """Convert to Hex format."""
 

custom/ass_abgr.py

@@ -32,17 +32,15 @@ def split_channels(color: str):
 class AssABGR(sRGB):
     """ASS `ABGR` color space."""
 
-    @classmethod
-    def match(cls, string: str, start: int = 0, fullmatch: bool = True):
+    def match(self, string: str, start: int = 0, fullmatch: bool = True):
         """Match a color string."""
 
         m = MATCH.match(string, start)
         if m is not None and (not fullmatch or m.end(0) == len(string)):
             return split_channels(m.group("color")), m.end(0)
         return None
 
-    @classmethod
-    def to_string(cls, parent, *, options=None, alpha=None, precision=None, fit=True, none=False, **kwargs):
+    def to_string(self, parent, *, options=None, alpha=None, precision=None, fit=True, none=False, **kwargs):
         """Convert color to `&HAABBGGRR`."""
 
         options = kwargs

custom/hex_0x.py

@@ -1,4 +1,4 @@
-"""Custon color that looks for colors of format `#RRGGBBAA` as `#AARRGGBB`."""
+"""Custom color that looks for colors of format `#RRGGBBAA` as `#AARRGGBB`."""
 from ..lib.coloraide.spaces.srgb.css import sRGB
 from ..lib.coloraide.css import parse, serialize
 import re
@@ -10,18 +10,16 @@
 class HexSRGB(sRGB):
     """SRGB that looks for alpha first in hex format."""
 
-    @classmethod
-    def match(cls, string, start=0, fullmatch=True):
+    def match(self, string, start=0, fullmatch=True):
         """Match a CSS color string."""
 
         m = MATCH.match(string, start)
         if m is not None and (not fullmatch or m.end(0) == len(string)):
             return parse.parse_hex(m.group(0).replace('0x', '#', 1)), m.end(0)
         return None
 
-    @classmethod
     def to_string(
-        cls, parent, *, alpha=None, precision=None, fit=True, none=False, **kwargs
+        self, parent, *, alpha=None, precision=None, fit=True, none=False, **kwargs
     ):
         """Convert to CSS."""
 

custom/st_colormod.py

@@ -184,33 +184,35 @@ def handle_vars(string, variables, parents=None):
 class HWB(HWBORIG):
     """HWB class that allows commas."""
 
-    @classmethod
-    def match(cls, string, start=0, fullmatch=True):
+    def match(self, string, start=0, fullmatch=True):
         """Match a CSS color string."""
 
         m = HWB_MATCH.match(string, start)
         if m is not None and (not fullmatch or m.end(0) == len(string)):
             return parse.parse_channels(
                 list(RE_CHAN_VALUE.findall(string[m.end(1) + 1:m.end(0) - 1])),
-                cls.CHANNELS, scaled=True
+                self.CHANNELS, scaled=True
             ), m.end(0)
         return None
 
-    @classmethod
     def to_string(
-        cls,
+        self,
         parent,
         *,
         alpha=None,
         precision=None,
-        percent: bool = True,
+        percent=None,
         fit=True,
         none=False,
+        color: bool = False,
         comma: bool = False,
         **kwargs
     ) -> str:
         """Convert to CSS."""
 
+        if percent is None:
+            percent = False if color else True
+
         return serialize.serialize_css(
             parent,
             func='hwb',

custom/tmtheme.py

@@ -695,9 +695,8 @@ def name2hex(name):
 class SRGBX11(sRGB):
     """sRGB class."""
 
-    @classmethod
     def to_string(
-        cls, parent, *, alpha=None, precision=None, fit=True, none=False, **kwargs
+        self, parent, *, alpha=None, precision=None, fit=True, none=False, **kwargs
     ):
         """Convert to CSS."""
 
@@ -727,8 +726,7 @@ def to_string(
 
         return value
 
-    @classmethod
-    def match(cls, string, start=0, fullmatch=True):
+    def match(self, string, start=0, fullmatch=True):
         """Match a CSS color string."""
 
         m = MATCH.match(string, start)

docs/src/markdown/settings/previews.md

@@ -88,7 +88,7 @@ else in the code.
 
 ```js
     // Gamut mapping approach
-    // Supported methods are: `lch-chroma`, `oklch-chroma`, and `clip` (default).
+    // Supported methods are: `lch-chroma`, `oklch-chroma`, `oklch-raytrace`, and `clip` (default).
     // `lch-chroma` was the original default before this was configurable.
     "gamut_map": "clip",
 ```

lib/coloraide/__meta__.py

@@ -1,4 +1,5 @@
 """Meta related things."""
+from __future__ import annotations
 from collections import namedtuple
 import re
 
@@ -83,7 +84,7 @@ def __new__(
         cls,
         major: int, minor: int, micro: int, release: str = "final",
         pre: int = 0, post: int = 0, dev: int = 0
-    ) -> "Version":
+    ) -> Version:
         """Validate version info."""
 
         # Ensure all parts are positive integers.
@@ -192,5 +193,5 @@ def parse_version(ver: str) -> Version:
     return Version(major, minor, micro, release, pre, post, dev)
 
 
-__version_info__ = Version(2, 9, 1, "final", post=1)
+__version_info__ = Version(3, 3, 1, "final")
 __version__ = __version_info__._get_canonical()