MertCapkin-GraphCraft 0.1.1__tar.gz → 2.0.0__tar.gz

{mertcapkin_graphcraft-0.1.1/scripts/MertCapkin_GraphCraft.egg-info → mertcapkin_graphcraft-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MertCapkin_GraphCraft
-Version: 0.1.1
+Version: 2.0.0
 Summary: Mobile game/app design layer on GraphStack — design graph, style packs, aesthetic engine
 Author: GraphCraft contributors
 License: MIT
@@ -22,10 +22,12 @@ Provides-Extra: graphstack
 Requires-Dist: MertCapkin_GraphStack[graphify]<5,>=4.7; extra == "graphstack"
 Provides-Extra: graphify
 Requires-Dist: graphifyy<0.9,>=0.7; extra == "graphify"
+Provides-Extra: visual
+Requires-Dist: pillow>=9; extra == "visual"
 Provides-Extra: dev
 Requires-Dist: pytest>=7; extra == "dev"
 Provides-Extra: full
-Requires-Dist: MertCapkin_GraphCraft[dev,graphify,graphstack]; extra == "full"
+Requires-Dist: MertCapkin_GraphCraft[dev,graphify,graphstack,visual]; extra == "full"
 Dynamic: license-file
 
 <div align="center">
@@ -56,16 +58,22 @@ GraphCraft   → design layer      (graphcraft-out/, design-system/)
 
 **Requirements:** Python 3.8+, Git, [Cursor](https://cursor.sh)
 
-### Install (PyPI — after v0.1.1 release)
+### Install (PyPI)
 
 ```powershell
 pip install "MertCapkin_GraphCraft[graphstack]"
 ```
 
-### Install (GitHub — works now)
+For visual review and aesthetic PNG checks, add the `visual` extra:
 
 ```powershell
-pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v0.1.1"
+pip install "MertCapkin_GraphCraft[graphstack,visual]"
+```
+
+### Install (GitHub)
+
+```powershell
+pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v2.0.0"
 ```
 
 GraphStack + Graphify install automatically via the `[graphstack]` extra from PyPI.
@@ -156,7 +164,14 @@ Full detail: [docs/FLOW.md](docs/FLOW.md) · [orchestrator/GRAPHCRAFT.md](orches
 | `graphcraft design query "screens"` | GraphCraft | Query design graph |
 | `graphcraft design validate` | GraphCraft | Validate design graph |
 | `graphcraft design harmony` | GraphCraft | Component harmony check |
+| `graphcraft design evaluate` | GraphCraft | Aesthetic rubric (contrast, touch targets) |
+| `graphcraft design bridge` | GraphCraft | Design ↔ code bridge map |
 | `graphcraft stitch import .` | GraphCraft | Import Stitch prototype |
+| `graphcraft stitch mcp install` | GraphCraft | Stitch MCP for Cursor |
+| `graphcraft visual review` | GraphCraft | PNG reference vs implementation |
+| `graphcraft ui validate all` | GraphCraft | Validate UI lib vs design tokens |
+| `graphcraft cycle status` | GraphCraft | Design phase + GraphStack role |
+| `graphcraft gate check` | GraphCraft | Design gate before ui-core edits |
 | `python -m graphstack cycle start …` | GraphStack | Start dev cycle |
 | `python -m graphstack graph query "…"` | GraphStack | Query code graph |
 

{mertcapkin_graphcraft-0.1.1 → mertcapkin_graphcraft-2.0.0}/README.md

@@ -26,16 +26,22 @@ GraphCraft   → design layer      (graphcraft-out/, design-system/)
 
 **Requirements:** Python 3.8+, Git, [Cursor](https://cursor.sh)
 
-### Install (PyPI — after v0.1.1 release)
+### Install (PyPI)
 
 ```powershell
 pip install "MertCapkin_GraphCraft[graphstack]"
 ```
 
-### Install (GitHub — works now)
+For visual review and aesthetic PNG checks, add the `visual` extra:
 
 ```powershell
-pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v0.1.1"
+pip install "MertCapkin_GraphCraft[graphstack,visual]"
+```
+
+### Install (GitHub)
+
+```powershell
+pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v2.0.0"
 ```
 
 GraphStack + Graphify install automatically via the `[graphstack]` extra from PyPI.
@@ -126,7 +132,14 @@ Full detail: [docs/FLOW.md](docs/FLOW.md) · [orchestrator/GRAPHCRAFT.md](orches
 | `graphcraft design query "screens"` | GraphCraft | Query design graph |
 | `graphcraft design validate` | GraphCraft | Validate design graph |
 | `graphcraft design harmony` | GraphCraft | Component harmony check |
+| `graphcraft design evaluate` | GraphCraft | Aesthetic rubric (contrast, touch targets) |
+| `graphcraft design bridge` | GraphCraft | Design ↔ code bridge map |
 | `graphcraft stitch import .` | GraphCraft | Import Stitch prototype |
+| `graphcraft stitch mcp install` | GraphCraft | Stitch MCP for Cursor |
+| `graphcraft visual review` | GraphCraft | PNG reference vs implementation |
+| `graphcraft ui validate all` | GraphCraft | Validate UI lib vs design tokens |
+| `graphcraft cycle status` | GraphCraft | Design phase + GraphStack role |
+| `graphcraft gate check` | GraphCraft | Design gate before ui-core edits |
 | `python -m graphstack cycle start …` | GraphStack | Start dev cycle |
 | `python -m graphstack graph query "…"` | GraphStack | Query code graph |
 

{mertcapkin_graphcraft-0.1.1 → mertcapkin_graphcraft-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "MertCapkin_GraphCraft"
-version = "0.1.1"
+version = "2.0.0"
 description = "Mobile game/app design layer on GraphStack — design graph, style packs, aesthetic engine"
 readme = "README.md"
 license = { text = "MIT" }
@@ -24,8 +24,9 @@ dependencies = ["pyyaml>=6"]
 [project.optional-dependencies]
 graphstack = ["MertCapkin_GraphStack[graphify]>=4.7,<5"]
 graphify = ["graphifyy>=0.7,<0.9"]
+visual = ["pillow>=9"]
 dev = ["pytest>=7"]
-full = ["MertCapkin_GraphCraft[graphstack,graphify,dev]"]
+full = ["MertCapkin_GraphCraft[graphstack,graphify,visual,dev]"]
 
 [project.urls]
 Homepage = "https://github.com/MertCapkin/GraphCraft"

{mertcapkin_graphcraft-0.1.1 → mertcapkin_graphcraft-2.0.0/scripts/MertCapkin_GraphCraft.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MertCapkin_GraphCraft
-Version: 0.1.1
+Version: 2.0.0
 Summary: Mobile game/app design layer on GraphStack — design graph, style packs, aesthetic engine
 Author: GraphCraft contributors
 License: MIT
@@ -22,10 +22,12 @@ Provides-Extra: graphstack
 Requires-Dist: MertCapkin_GraphStack[graphify]<5,>=4.7; extra == "graphstack"
 Provides-Extra: graphify
 Requires-Dist: graphifyy<0.9,>=0.7; extra == "graphify"
+Provides-Extra: visual
+Requires-Dist: pillow>=9; extra == "visual"
 Provides-Extra: dev
 Requires-Dist: pytest>=7; extra == "dev"
 Provides-Extra: full
-Requires-Dist: MertCapkin_GraphCraft[dev,graphify,graphstack]; extra == "full"
+Requires-Dist: MertCapkin_GraphCraft[dev,graphify,graphstack,visual]; extra == "full"
 Dynamic: license-file
 
 <div align="center">
@@ -56,16 +58,22 @@ GraphCraft   → design layer      (graphcraft-out/, design-system/)
 
 **Requirements:** Python 3.8+, Git, [Cursor](https://cursor.sh)
 
-### Install (PyPI — after v0.1.1 release)
+### Install (PyPI)
 
 ```powershell
 pip install "MertCapkin_GraphCraft[graphstack]"
 ```
 
-### Install (GitHub — works now)
+For visual review and aesthetic PNG checks, add the `visual` extra:
 
 ```powershell
-pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v0.1.1"
+pip install "MertCapkin_GraphCraft[graphstack,visual]"
+```
+
+### Install (GitHub)
+
+```powershell
+pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v2.0.0"
 ```
 
 GraphStack + Graphify install automatically via the `[graphstack]` extra from PyPI.
@@ -156,7 +164,14 @@ Full detail: [docs/FLOW.md](docs/FLOW.md) · [orchestrator/GRAPHCRAFT.md](orches
 | `graphcraft design query "screens"` | GraphCraft | Query design graph |
 | `graphcraft design validate` | GraphCraft | Validate design graph |
 | `graphcraft design harmony` | GraphCraft | Component harmony check |
+| `graphcraft design evaluate` | GraphCraft | Aesthetic rubric (contrast, touch targets) |
+| `graphcraft design bridge` | GraphCraft | Design ↔ code bridge map |
 | `graphcraft stitch import .` | GraphCraft | Import Stitch prototype |
+| `graphcraft stitch mcp install` | GraphCraft | Stitch MCP for Cursor |
+| `graphcraft visual review` | GraphCraft | PNG reference vs implementation |
+| `graphcraft ui validate all` | GraphCraft | Validate UI lib vs design tokens |
+| `graphcraft cycle status` | GraphCraft | Design phase + GraphStack role |
+| `graphcraft gate check` | GraphCraft | Design gate before ui-core edits |
 | `python -m graphstack cycle start …` | GraphStack | Start dev cycle |
 | `python -m graphstack graph query "…"` | GraphStack | Query code graph |
 

mertcapkin_graphcraft-2.0.0/scripts/MertCapkin_GraphCraft.egg-info/SOURCES.txt

@@ -0,0 +1,104 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+scripts/MertCapkin_GraphCraft.egg-info/PKG-INFO
+scripts/MertCapkin_GraphCraft.egg-info/SOURCES.txt
+scripts/MertCapkin_GraphCraft.egg-info/dependency_links.txt
+scripts/MertCapkin_GraphCraft.egg-info/entry_points.txt
+scripts/MertCapkin_GraphCraft.egg-info/requires.txt
+scripts/MertCapkin_GraphCraft.egg-info/top_level.txt
+scripts/graphcraft/__init__.py
+scripts/graphcraft/__main__.py
+scripts/graphcraft/bootstrap.py
+scripts/graphcraft/cli.py
+scripts/graphcraft/constants.py
+scripts/graphcraft/design_audit.py
+scripts/graphcraft/design_brief_utils.py
+scripts/graphcraft/design_state.py
+scripts/graphcraft/doctor.py
+scripts/graphcraft/gate_cmd.py
+scripts/graphcraft/init_cmd.py
+scripts/graphcraft/installer.py
+scripts/graphcraft/aesthetic/__init__.py
+scripts/graphcraft/aesthetic/cli.py
+scripts/graphcraft/aesthetic/config_loader.py
+scripts/graphcraft/aesthetic/contrast.py
+scripts/graphcraft/aesthetic/evaluate.py
+scripts/graphcraft/aesthetic/research.py
+scripts/graphcraft/assets/.graphcraft-assets-version
+scripts/graphcraft/assets/graphcraft.config.yaml
+scripts/graphcraft/assets/.cursor/commands/graphcraft.md
+scripts/graphcraft/assets/.cursor/rules/graphcraft.mdc
+scripts/graphcraft/assets/.cursor/skills/design-strategist/DESIGN_STRATEGIST.md
+scripts/graphcraft/assets/.cursor/skills/designer/DESIGNER.md
+scripts/graphcraft/assets/.cursor/skills/mobile-app/MOBILE_APP.md
+scripts/graphcraft/assets/.cursor/skills/mobile-game/MOBILE_GAME.md
+scripts/graphcraft/assets/.cursor/skills/stitch-import/STITCH_IMPORT.md
+scripts/graphcraft/assets/.cursor/skills/visual-review/VISUAL_REVIEW.md
+scripts/graphcraft/assets/.stitch/metadata.template.json
+scripts/graphcraft/assets/design-system/tokens.base.json
+scripts/graphcraft/assets/design-system/tokens.json
+scripts/graphcraft/assets/design-system/components/button.example.yaml
+scripts/graphcraft/assets/design/screens/login.example.yaml
+scripts/graphcraft/assets/handoff/AESTHETIC_BRIEF.md
+scripts/graphcraft/assets/handoff/DESIGN_BRIEF.md
+scripts/graphcraft/assets/orchestrator/GRAPHCRAFT.md
+scripts/graphcraft/assets/packages/assets/README.md
+scripts/graphcraft/assets/packages/ui-core/README.md
+scripts/graphcraft/assets/packages/ui-core/flutter/README.md
+scripts/graphcraft/assets/packages/ui-core/flutter/pubspec.yaml
+scripts/graphcraft/assets/packages/ui-core/flutter/lib/graphcraft_ui_core.dart
+scripts/graphcraft/assets/packages/ui-core/flutter/lib/tokens.dart
+scripts/graphcraft/assets/packages/ui-core/flutter/lib/components/button_primary.dart
+scripts/graphcraft/assets/packages/ui-core/flutter/lib/screens/login_screen.dart
+scripts/graphcraft/assets/packages/ui-core/godot/README.md
+scripts/graphcraft/assets/packages/ui-core/godot/plugin.cfg
+scripts/graphcraft/assets/packages/ui-core/godot/plugin.gd
+scripts/graphcraft/assets/packages/ui-core/godot/tokens.gd
+scripts/graphcraft/assets/packages/ui-core/godot/components/button_primary.gd
+scripts/graphcraft/assets/packages/ui-core/godot/screens/login_screen.gd
+scripts/graphcraft/assets/packages/ui-core/rn/README.md
+scripts/graphcraft/assets/packages/ui-core/rn/package.json
+scripts/graphcraft/assets/packages/ui-core/rn/tsconfig.json
+scripts/graphcraft/assets/packages/ui-core/rn/src/index.ts
+scripts/graphcraft/assets/packages/ui-core/rn/src/theme.ts
+scripts/graphcraft/assets/packages/ui-core/rn/src/tokens.ts
+scripts/graphcraft/assets/packages/ui-core/rn/src/components/ButtonPrimary.tsx
+scripts/graphcraft/assets/packages/ui-core/rn/src/components/index.ts
+scripts/graphcraft/assets/packages/ui-core/rn/src/screens/LoginScreen.tsx
+scripts/graphcraft/assets/packages/ui-core/unity/GraphCraft.UI.asmdef
+scripts/graphcraft/assets/packages/ui-core/unity/README.md
+scripts/graphcraft/assets/packages/ui-core/unity/Runtime/Components/ButtonPrimary.cs
+scripts/graphcraft/assets/packages/ui-core/unity/Runtime/Screens/LoginScreen.cs
+scripts/graphcraft/assets/packages/ui-core/unity/Runtime/Tokens/DesignTokens.cs
+scripts/graphcraft/assets/packs/mobile-app/STACKS.md
+scripts/graphcraft/assets/packs/mobile-game/STACKS.md
+scripts/graphcraft/assets/packs/stitch/README.md
+scripts/graphcraft/assets/packs/styles/minimal-dark/style.yaml
+scripts/graphcraft/assets/packs/styles/warm-light/style.yaml
+scripts/graphcraft/cycle/__init__.py
+scripts/graphcraft/cycle/cli.py
+scripts/graphcraft/design_graph/__init__.py
+scripts/graphcraft/design_graph/bridge.py
+scripts/graphcraft/design_graph/builder.py
+scripts/graphcraft/design_graph/cli.py
+scripts/graphcraft/design_graph/harmony.py
+scripts/graphcraft/design_graph/query.py
+scripts/graphcraft/design_graph/report.py
+scripts/graphcraft/design_graph/schema.py
+scripts/graphcraft/design_graph/stitch_adapter.py
+scripts/graphcraft/stitch/__init__.py
+scripts/graphcraft/stitch/cli.py
+scripts/graphcraft/stitch/fetch.py
+scripts/graphcraft/stitch/import_cmd.py
+scripts/graphcraft/stitch/mcp.py
+scripts/graphcraft/stitch/validate.py
+scripts/graphcraft/ui/__init__.py
+scripts/graphcraft/ui/cli.py
+scripts/graphcraft/ui/tokens_emit.py
+scripts/graphcraft/ui/validate.py
+scripts/graphcraft/visual/__init__.py
+scripts/graphcraft/visual/cli.py
+scripts/graphcraft/visual/png_utils.py
+scripts/graphcraft/visual/review.py

{mertcapkin_graphcraft-0.1.1 → mertcapkin_graphcraft-2.0.0}/scripts/MertCapkin_GraphCraft.egg-info/requires.txt

@@ -4,10 +4,13 @@ pyyaml>=6
 pytest>=7
 
 [full]
-MertCapkin_GraphCraft[dev,graphify,graphstack]
+MertCapkin_GraphCraft[dev,graphify,graphstack,visual]
 
 [graphify]
 graphifyy<0.9,>=0.7
 
 [graphstack]
 MertCapkin_GraphStack[graphify]<5,>=4.7
+
+[visual]
+pillow>=9

{mertcapkin_graphcraft-0.1.1 → mertcapkin_graphcraft-2.0.0}/scripts/graphcraft/__init__.py

@@ -1,8 +1,8 @@
 """GraphCraft — mobile game/app design layer on GraphStack.
 
 Entry point: ``python -m graphcraft <command>``
-Commands: ``init``, ``install``, ``doctor``, ``design``, ``stitch``
+Commands: ``init``, ``install``, ``doctor``, ``design``, ``stitch``, ``aesthetic``, ``visual``, ``ui``, ``cycle``, ``gate``
 """
 
-__version__ = "0.1.1"
+__version__ = "2.0.0"
 __all__ = ["__version__"]

mertcapkin_graphcraft-2.0.0/scripts/graphcraft/aesthetic/__init__.py

@@ -0,0 +1 @@
+"""GraphCraft aesthetic engine."""

mertcapkin_graphcraft-2.0.0/scripts/graphcraft/aesthetic/cli.py

@@ -0,0 +1,79 @@
+"""Aesthetic engine CLI."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from ..constants import DESIGN_GRAPH_JSON
+from ..design_graph.query import load_graph
+from .evaluate import format_evaluate_summary, run_evaluate, write_aesthetic_report
+from .research import init_inspiration, validate_inspiration
+
+
+def run(argv: list[str]) -> int:
+    if not argv or argv[0] in ("-h", "--help"):
+        print("Usage: graphcraft aesthetic <evaluate|research> ...")
+        return 0
+
+    cmd, rest = argv[0], argv[1:]
+
+    if cmd == "evaluate":
+        p = argparse.ArgumentParser(prog="graphcraft aesthetic evaluate")
+        p.add_argument("root", nargs="?", default=".")
+        p.add_argument("--screen", default=None)
+        p.add_argument("--style", default=None)
+        p.add_argument("--graph", default=str(DESIGN_GRAPH_JSON))
+        args = p.parse_args(rest)
+        root = Path(args.root).resolve()
+        graph_path = Path(args.graph)
+        if not graph_path.is_file():
+            print(f"Missing {graph_path} — run: graphcraft design update .")
+            return 1
+        result = run_evaluate(
+            root,
+            load_graph(graph_path),
+            screen_id=args.screen,
+            style_id=args.style,
+        )
+        report_path = write_aesthetic_report(root, result)
+        print(format_evaluate_summary(result))
+        print(f"  -> {report_path}")
+        return 0 if result["overall"] in ("PASS", "WARN") else 1
+
+    if cmd == "research":
+        if not rest or rest[0] in ("-h", "--help"):
+            print("Usage: graphcraft aesthetic research <init|validate> [root]")
+            return 0
+        action = rest[0]
+        sub_rest = rest[1:]
+        p = argparse.ArgumentParser(prog=f"graphcraft aesthetic research {action}")
+        p.add_argument("root", nargs="?", default=".")
+        p.add_argument("--force", action="store_true", help="overwrite INSPIRATION.md (init only)")
+        args = p.parse_args(sub_rest)
+        root = Path(args.root).resolve()
+
+        if action == "init":
+            path = init_inspiration(root, force=args.force)
+            print(f"Created {path}")
+            return 0
+
+        if action == "validate":
+            issues = validate_inspiration(root)
+            if issues:
+                for i in issues:
+                    print(f"  ISSUE: {i}")
+                return 1
+            print("INSPIRATION validation: PASS")
+            return 0
+
+        print(f"Unknown research action: {action}")
+        return 1
+
+    print(f"Unknown aesthetic subcommand: {cmd}")
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(run(sys.argv[1:]))

mertcapkin_graphcraft-2.0.0/scripts/graphcraft/aesthetic/config_loader.py

@@ -0,0 +1,47 @@
+"""Load GraphCraft project configuration."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+try:
+    import yaml
+except ImportError:
+    yaml = None  # type: ignore
+
+from ..constants import CONFIG_FILE, STYLES_DIR
+
+
+def load_config(root: Path) -> dict[str, Any]:
+    path = root / CONFIG_FILE
+    if not path.is_file():
+        return {}
+    if yaml is None:
+        raise RuntimeError("PyYAML required: pip install pyyaml")
+    data = yaml.safe_load(path.read_text(encoding="utf-8"))
+    return data if isinstance(data, dict) else {}
+
+
+def active_style_id(config: dict[str, Any]) -> str:
+    style = (config.get("design") or {}).get("style", "style:minimal-dark")
+    return str(style)
+
+
+def aesthetic_settings(config: dict[str, Any]) -> dict[str, Any]:
+    return dict(config.get("aesthetic") or {})
+
+
+def design_settings(config: dict[str, Any]) -> dict[str, Any]:
+    return dict(config.get("design") or {})
+
+
+def load_style_pack(root: Path, style_id: str) -> dict[str, Any]:
+    if yaml is None:
+        raise RuntimeError("PyYAML required: pip install pyyaml")
+    slug = style_id.split(":", 1)[-1] if ":" in style_id else style_id
+    path = root / STYLES_DIR / slug / "style.yaml"
+    if not path.is_file():
+        return {}
+    data = yaml.safe_load(path.read_text(encoding="utf-8"))
+    return data if isinstance(data, dict) else {}

mertcapkin_graphcraft-2.0.0/scripts/graphcraft/aesthetic/contrast.py

@@ -0,0 +1,49 @@
+"""WCAG contrast helpers for token hex values."""
+
+from __future__ import annotations
+
+import re
+from typing import Tuple
+
+
+_HEX_RE = re.compile(r"^#([0-9a-fA-F]{6})$")
+
+
+def parse_hex(color: str) -> Tuple[float, float, float] | None:
+    color = color.strip()
+    if not _HEX_RE.match(color):
+        return None
+    r = int(color[1:3], 16) / 255.0
+    g = int(color[3:5], 16) / 255.0
+    b = int(color[5:7], 16) / 255.0
+    return r, g, b
+
+
+def _linearize(channel: float) -> float:
+    if channel <= 0.03928:
+        return channel / 12.92
+    return ((channel + 0.055) / 1.055) ** 2.4
+
+
+def relative_luminance(rgb: Tuple[float, float, float]) -> float:
+    r, g, b = (_linearize(c) for c in rgb)
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b
+
+
+def contrast_ratio(foreground: str, background: str) -> float | None:
+    fg = parse_hex(foreground)
+    bg = parse_hex(background)
+    if fg is None or bg is None:
+        return None
+    l1 = relative_luminance(fg)
+    l2 = relative_luminance(bg)
+    lighter = max(l1, l2)
+    darker = min(l1, l2)
+    return (lighter + 0.05) / (darker + 0.05)
+
+
+def passes_contrast(foreground: str, background: str, minimum: float = 4.5) -> bool | None:
+    ratio = contrast_ratio(foreground, background)
+    if ratio is None:
+        return None
+    return ratio >= minimum