python-color-math 0.2.21__tar.gz → 0.2.22__tar.gz

{python_color_math-0.2.21/python_color_math.egg-info → python_color_math-0.2.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-color-math
-Version: 0.2.21
+Version: 0.2.22
 Summary: A fast, local semantic LaTeX colorizer for Markdown, Jupyter, and LaTeX math equations.
 Author: Aditya
 License: MIT License

{python_color_math-0.2.21 → python_color_math-0.2.22}/color_math/__init__.py

@@ -13,7 +13,7 @@ from .undo import uncolor_text
 
 from .ipython import ColorMath, colormath, load_ipython_extension, unload_ipython_extension
 
-__version__ = "0.2.21"
+__version__ = "0.2.22"
 
 __all__ = [
     "__version__",

{python_color_math-0.2.21 → python_color_math-0.2.22}/color_math/config.py

@@ -610,26 +610,82 @@ RAINBOW_DELIMITER_COLORS: list[str] = [
 
 
 VARIABLE_HASH_PALETTE: list[str] = [
-    "#7aa2f7",  # Tokyo Blue
-    "#7dcfff",  # Tokyo Cyan
-    "#bb9af7",  # Tokyo Purple
-    "#f7768e",  # Tokyo Pink
-    "#e0af68",  # Tokyo Orange/Gold
-    "#9ece6a",  # Tokyo Green
-    "#2ac3de",  # Light Cyan
-    "#ff9e64",  # Peach
+    "#7aa2f7",  # 0: Tokyo Blue
+    "#7dcfff",  # 1: Tokyo Cyan
+    "#bb9af7",  # 2: Tokyo Purple
+    "#f7768e",  # 3: Tokyo Pink
+    "#e0af68",  # 4: Tokyo Orange/Gold
+    "#9ece6a",  # 5: Tokyo Green
+    "#2ac3de",  # 6: Light Cyan/Teal
+    "#ff9e64",  # 7: Peach
 ]
 
+CANONICAL_VARIABLE_SLOTS: dict[str, int] = {
+    # 1. Spatial 3D Cartesian coordinates: guaranteed maximum pairwise separation
+    "x": 0,  # Tokyo Blue
+    "y": 4,  # Tokyo Gold
+    "z": 5,  # Tokyo Green
+
+    # 2. Coefficients: high-contrast against (x, y, z) and within the group
+    "a": 2,  # Tokyo Purple
+    "b": 3,  # Tokyo Pink
+    "c": 6,  # Light Cyan/Teal
+    "d": 7,  # Peach
+
+    # 3. Parameters / Velocity / Substitutions
+    "u": 1,  # Tokyo Cyan
+    "v": 2,  # Tokyo Purple
+    "w": 4,  # Tokyo Gold
+
+    # 4. Discrete summation & matrix indices
+    "i": 4,  # Tokyo Gold
+    "j": 0,  # Tokyo Blue
+    "k": 3,  # Tokyo Pink
+    "l": 5,  # Tokyo Green
+    "m": 2,  # Tokyo Purple
+    "n": 6,  # Light Cyan/Teal
+
+    # 5. Calculus & Analysis duals
+    "s": 3,  # Tokyo Pink
+    "t": 1,  # Tokyo Cyan
+    "p": 0,  # Tokyo Blue
+    "q": 7,  # Peach
+
+    # 6. Thermodynamics & State
+    "P": 3,  # Tokyo Pink
+    "V": 0,  # Tokyo Blue
+    "T": 4,  # Tokyo Gold
+
+    # 7. Greek letters & canonical duals
+    "\\theta": 4, "θ": 4, "𝜗": 4, "ϑ": 4,
+    "\\phi": 2, "\\varphi": 2, "ϕ": 2, "φ": 2, "𝜙": 2, "𝜑": 2,
+    "\\psi": 2, "ψ": 2, "𝜓": 2,
+    "\\epsilon": 2, "\\varepsilon": 2, "ε": 2, "𝜀": 2,
+    "\\delta": 5, "δ": 5, "𝛿": 5,
+    "\\alpha": 2, "α": 2, "𝛼": 2,
+    "\\beta": 3, "β": 3, "𝛽": 3,
+    "\\gamma": 5, "γ": 5, "𝛾": 5,
+    "\\omega": 7, "ω": 7, "𝜔": 7,
+    "\\lambda": 6, "λ": 6, "𝜆": 6,
+}
 
-def hash_string_to_color(s: str, palette: list[str] = VARIABLE_HASH_PALETTE) -> str:
-    """Deterministic string hashing for variable data-flow coloring."""
+
+def hash_string_to_slot(s: str, num_slots: int = 8) -> int:
+    """Dispersive hash mapping identifiers to palette slots with golden ratio dispersion."""
+    if s in CANONICAL_VARIABLE_SLOTS:
+        return CANONICAL_VARIABLE_SLOTS[s] % num_slots
+
+    # Knuth 32-bit multiplicative hash with golden ratio constant 2654435761 (0x9E3779B9)
     h = 0
     for char in s:
-        h = (h * 31 + ord(char)) & 0xFFFFFFFF
-        if h >= 0x80000000:
-            h -= 0x100000000
-    idx = abs(h) % len(palette)
-    return palette[idx]
+        h = ((h << 5) - h + ord(char)) & 0xFFFFFFFF
+    return ((h * 2654435761) & 0xFFFFFFFF) % num_slots
+
+
+def hash_string_to_color(s: str, palette: list[str] = VARIABLE_HASH_PALETTE) -> str:
+    """Deterministic string hashing for variable data-flow coloring with harmonic disambiguation."""
+    slot = hash_string_to_slot(s, len(palette))
+    return palette[slot]
 
 
 @dataclass

{python_color_math-0.2.21 → python_color_math-0.2.22}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-color-math"
-version = "0.2.21"
+version = "0.2.22"
 description = "A fast, local semantic LaTeX colorizer for Markdown, Jupyter, and LaTeX math equations."
 readme = "README.md"
 requires-python = ">=3.10"

{python_color_math-0.2.21 → python_color_math-0.2.22/python_color_math.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-color-math
-Version: 0.2.21
+Version: 0.2.22
 Summary: A fast, local semantic LaTeX colorizer for Markdown, Jupyter, and LaTeX math equations.
 Author: Aditya
 License: MIT License

{python_color_math-0.2.21 → python_color_math-0.2.22}/python_color_math.egg-info/SOURCES.txt

@@ -70,6 +70,7 @@ tests/test_features.py
 tests/test_frontmatter.py
 tests/test_fuzz.py
 tests/test_gui.py
+tests/test_harmonic_tuples.py
 tests/test_ipython.py
 tests/test_mcp_hardcore.py
 tests/test_mcp_server.py

python_color_math-0.2.22/tests/test_harmonic_tuples.py

@@ -0,0 +1,84 @@
+"""Unit tests for Harmonic Tuple Disambiguation & Perceptual Contrast."""
+
+import unittest
+from color_math.config import (
+    VARIABLE_HASH_PALETTE,
+    CANONICAL_VARIABLE_SLOTS,
+    hash_string_to_color,
+    hash_string_to_slot,
+)
+from color_math.converters.block import convert_text
+from color_math.config import ColorMathOptions
+
+
+class TestHarmonicTupleDisambiguation(unittest.TestCase):
+    def test_spatial_coordinates_distinct(self):
+        """Verify (x, y, z) are assigned mutually distinct, contrasting colors."""
+        col_x = hash_string_to_color("x")
+        col_y = hash_string_to_color("y")
+        col_z = hash_string_to_color("z")
+        self.assertNotEqual(col_x, col_y)
+        self.assertNotEqual(col_y, col_z)
+        self.assertNotEqual(col_x, col_z)
+
+    def test_coefficients_distinct(self):
+        """Verify (a, b, c, d) are mutually distinct."""
+        col_a = hash_string_to_color("a")
+        col_b = hash_string_to_color("b")
+        col_c = hash_string_to_color("c")
+        col_d = hash_string_to_color("d")
+        colors = {col_a, col_b, col_c, col_d}
+        self.assertEqual(len(colors), 4)
+
+    def test_parameters_distinct(self):
+        """Verify (u, v, w) are mutually distinct."""
+        col_u = hash_string_to_color("u")
+        col_v = hash_string_to_color("v")
+        col_w = hash_string_to_color("w")
+        colors = {col_u, col_v, col_w}
+        self.assertEqual(len(colors), 3)
+
+    def test_indices_distinct(self):
+        """Verify (i, j, k, l) are mutually distinct."""
+        col_i = hash_string_to_color("i")
+        col_j = hash_string_to_color("j")
+        col_k = hash_string_to_color("k")
+        col_l = hash_string_to_color("l")
+        colors = {col_i, col_j, col_k, col_l}
+        self.assertEqual(len(colors), 4)
+
+    def test_linear_combination_cross_contrast(self):
+        """Verify in ax + by + cz, all six variables receive distinct colors."""
+        vars_to_test = ["a", "x", "b", "y", "c", "z"]
+        colors = [hash_string_to_color(v) for v in vars_to_test]
+        # In term 1: a != x
+        self.assertNotEqual(colors[0], colors[1])
+        # In term 2: b != y
+        self.assertNotEqual(colors[2], colors[3])
+        # In term 3: c != z
+        self.assertNotEqual(colors[4], colors[5])
+        # All 6 must be unique!
+        self.assertEqual(len(set(colors)), 6)
+
+    def test_rendered_linear_combination_equation(self):
+        """Verify full math expression rendering of ax + by + cz = d."""
+        eq = "$$ax + by + cz = d$$"
+        opts = ColorMathOptions.all_enabled()
+        res = convert_text(eq, options=opts)
+        self.assertIn(r"\textcolor{#bb9af7}{a}", res)
+        self.assertIn(r"\textcolor{#7aa2f7}{x}", res)
+        self.assertIn(r"\textcolor{#f7768e}{b}", res)
+        self.assertIn(r"\textcolor{#e0af68}{y}", res)
+        self.assertIn(r"\textcolor{#2ac3de}{c}", res)
+        self.assertIn(r"\textcolor{#9ece6a}{z}", res)
+
+    def test_dispersive_hash_unknown_variables(self):
+        """Verify arbitrary variables receive deterministic slots."""
+        s1 = hash_string_to_slot("var1")
+        s2 = hash_string_to_slot("var1")
+        self.assertEqual(s1, s2)
+        self.assertTrue(0 <= s1 < 8)
+
+
+if __name__ == "__main__":
+    unittest.main()

{python_color_math-0.2.21 → python_color_math-0.2.22}/tests/test_mcp_hardcore.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import asyncio
 import json
+from pathlib import Path
 import tempfile
 import time
 import unittest

{python_color_math-0.2.21 → python_color_math-0.2.22}/tests/test_mcp_server.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from pathlib import Path
 import tempfile
 import unittest
 try: