pymdownx-mahjong 1.0.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

pymdownx_mahjong/__init__.py

@@ -20,4 +20,4 @@ __all__ = [
     "superfences_validator",
 ]
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"

pymdownx_mahjong/assets/README.md

@@ -0,0 +1,3 @@
+Original assets by https://github.com/FluffyStuff/riichi-mahjong-tiles, available in the public domain.
+
+Some assets have been recolored, tweaks, minified, or otherwise modified.

pymdownx_mahjong/css/mahjong.css

@@ -23,7 +23,7 @@
     --mahjong-error-border: #dc2626;
     --mahjong-error-color: #fca5a5;
     --mahjong-tile-bg: #1e1e1e;
-    --mahjong-tile-border: #9a9a8a;
+    --mahjong-tile-border: #47473e;
     --mahjong-tile-shadow: rgba(0, 0, 0, 0.3);
 }
 
@@ -48,7 +48,7 @@
     display: contents;
 }
 
-/* Main container */
+/* NOTE Main container */
 .mahjong-hand {
     display: block;
     margin: 1em 0;
@@ -58,24 +58,24 @@
     border-radius: 4px;
 }
 
-/* Override MkDocs Material theme figure margins */
+/* NOTE Override MkDocs Material/Zensical theme figure margins */
 .md-typeset .mahjong-hand {
     margin-left: 1rem;
 }
 
-/* Hand row - contains left (tiles/melds), draw, and right (dora) sections */
+/* NOTE Hand row - contains left (tiles/melds), draw, and right (dora) sections */
 .mahjong-hand-row {
     display: flex;
     flex-wrap: nowrap;
     align-items: flex-end;
 }
 
-/* Left section - closed tiles and melds */
+/* NOTE Left section - closed tiles and melds */
 .mahjong-hand-left {
     flex: 0 0 auto;
 }
 
-/* Draw tile section - separated from main hand */
+/* NOTE Draw tile section */
 .mahjong-hand-draw {
     flex: 0 0 auto;
     margin-left: calc(var(--mahjong-meld-gap) * 0.75);
@@ -96,13 +96,13 @@
     pointer-events: none;
 }
 
-/* Melds section - after draw tile */
+/* NOTE Melds section - after draw tile */
 .mahjong-hand-melds {
     flex: 0 0 auto;
     margin-left: calc(var(--mahjong-meld-gap) * 0.75);
 }
 
-/* Tiles container - flexbox layout */
+/* NOTE Tiles container - flexbox layout */
 .mahjong-tiles {
     display: flex;
     flex-wrap: wrap;
@@ -110,7 +110,7 @@
     gap: var(--mahjong-tile-gap);
 }
 
-/* Individual tile - styled like physical riichi tiles */
+/* NOTE Individual tile - styled like physical riichi tiles */
 .mahjong-tile {
     display: inline-flex;
     align-items: center;
@@ -122,9 +122,6 @@
     background: var(--mahjong-tile-bg);
     border: 2px solid var(--mahjong-tile-border);
     border-radius: 6px;
-    box-shadow:
-        1px 2px 3px var(--mahjong-tile-shadow),
-        inset 0 1px 0 rgba(255, 255, 255, 0.3);
     padding: 2px;
     box-sizing: border-box;
     position: relative;
@@ -144,6 +141,8 @@
 /* Rotated tile (called from another player) */
 .mahjong-tile-rotated {
     transform: rotate(90deg);
+    will-change: transform;
+    backface-visibility: hidden;
     margin-left: calc(var(--mahjong-tile-gap) * 6);
     margin-right: calc(var(--mahjong-tile-gap) * 6);
     position: relative;

pymdownx_mahjong/inline.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Final
 
 from markdown.inlinepatterns import InlineProcessor
 
@@ -17,7 +17,7 @@ if TYPE_CHECKING:
 # Pattern matches :123m:, :1z:, :0m: (red dora), etc.
 # Must be valid MPSZ: one or more groups of digits followed by m/p/s/z
 # Examples: :1m:, :123p:, :5z:, :0s:, :123m456p:
-INLINE_TILE_PATTERN = r":([0-9]+[mpsz])+:"
+INLINE_TILE_PATTERN: Final[str] = r":([0-9]+[mpsz])+:"
 
 
 class MahjongInlineProcessor(InlineProcessor):

pymdownx_mahjong/parser.py

@@ -3,8 +3,10 @@
 from __future__ import annotations
 
 import re
+from collections import Counter
 from dataclasses import dataclass, field
 from enum import Enum
+from typing import Final, Pattern
 
 from .tiles import TileInfo, get_tile_info, is_valid_tile
 
@@ -127,11 +129,11 @@ class MahjongParser:
     """
 
     # Pattern for a group of numbers followed by a suit
-    TILE_GROUP_PATTERN = re.compile(r"([0-9]+)([mpsz])")
+    TILE_GROUP_PATTERN: Final[Pattern[str]] = re.compile(r"([0-9]+)([mpsz])")
 
     # Pattern for melds: (tiles<) or [tiles] with optional source marker inside brackets
     # For added kan, use + to mark the added tile: (111+1m<)
-    MELD_PATTERN = re.compile(r"(\[|\()([0-9]+)(\+)?([0-9])?([mpsz])([<^>])?(\]|\))")
+    MELD_PATTERN: Final[Pattern[str]] = re.compile(r"(\[|\()([0-9]+)(\+)?([0-9])?([mpsz])([<^>])?(\]|\))")
 
     def __init__(self) -> None:
         self.errors: list[str] = []
@@ -163,6 +165,9 @@ class MahjongParser:
         # Parse closed tiles
         hand.closed_tiles = self._parse_tiles(closed_part)
 
+        # Validate tile counts (max 4 of each tile type)
+        self._validate_tile_counts(hand)
+
         if self.errors:
             raise ParseError("; ".join(self.errors))
 
@@ -336,6 +341,32 @@ class MahjongParser:
 
         return numbers[1] == numbers[0] + 1 and numbers[2] == numbers[1] + 1
 
+    def _validate_tile_counts(self, hand: Hand) -> None:
+        """Validate that no tile appears more than 4 times.
+
+        In Mahjong, there are exactly 4 copies of each tile type.
+        Having more than 4 of the same tile is invalid.
+
+        Args:
+            hand: The Hand object to validate
+        """
+        # Count all tiles including melds
+        # Note: Red 5 (0) and regular 5 are different tiles, so we count them separately
+        all_tiles = list(hand.closed_tiles)
+        for meld in hand.melds:
+            all_tiles.extend(meld.tiles)
+        if hand.draw_tile:
+            all_tiles.append(hand.draw_tile)
+
+        counts = Counter((t.suit, t.number) for t in all_tiles)
+
+        for (suit, number), count in counts.items():
+            if count > 4:
+                tile_notation = f"{number}{suit}"
+                self.errors.append(
+                    f"Invalid tile count: {tile_notation} appears {count} times (max 4)"
+                )
+
 
 def parse_hand(notation: str) -> Hand:
     """Convenience function to parse a hand notation.

pymdownx_mahjong/renderer.py

@@ -2,23 +2,47 @@
 
 from __future__ import annotations
 
+import functools
 import html
 import importlib.resources
 import re
 from pathlib import Path
+from typing import Final, Pattern
 
 from .parser import Hand, Meld, MeldType, Tile
 from .tiles import TileInfo, get_special_tile
 
 # Pre-compiled regex patterns for SVG processing
-_RE_XML_DECL = re.compile(r"<\?xml[^?]*\?>")
-_RE_SODIPODI_SELF = re.compile(r"<sodipodi:namedview[^>]*/>")
-_RE_SODIPODI_FULL = re.compile(r"<sodipodi:namedview[^>]*>.*?</sodipodi:namedview>", re.DOTALL)
-_RE_METADATA = re.compile(r"<metadata[^>]*>.*?</metadata>", re.DOTALL)
-_RE_WIDTH = re.compile(r'width="[^"]*"')
-_RE_HEIGHT = re.compile(r'height="[^"]*"')
+_RE_XML_DECL: Final[Pattern[str]] = re.compile(r"<\?xml[^?]*\?>")
+_RE_SODIPODI_SELF: Final[Pattern[str]] = re.compile(r"<sodipodi:namedview[^>]*/>")
+_RE_SODIPODI_FULL: Final[Pattern[str]] = re.compile(r"<sodipodi:namedview[^>]*>.*?</sodipodi:namedview>", re.DOTALL)
+_RE_METADATA: Final[Pattern[str]] = re.compile(r"<metadata[^>]*>.*?</metadata>", re.DOTALL)
+_RE_WIDTH: Final[Pattern[str]] = re.compile(r'width="[^"]*"')
+_RE_HEIGHT: Final[Pattern[str]] = re.compile(r'height="[^"]*"')
 # Pattern to find IDs in SVGs
-_RE_ID = re.compile(r'id="([^"]+)"')
+_RE_ID: Final[Pattern[str]] = re.compile(r'id="([^"]+)"')
+
+
+@functools.lru_cache(maxsize=128)
+def _load_svg_from_package(asset_name: str, theme: str) -> str:
+    """Load SVG content from package resources with caching.
+
+    This is a module-level cached function to avoid repeated file I/O
+    for the same tile assets across multiple renderer instances.
+
+    Args:
+        asset_name: Name of the asset (e.g., '1m', 'back')
+        theme: Theme to load ('light' or 'dark')
+
+    Returns:
+        Raw SVG content string
+
+    Raises:
+        FileNotFoundError: If the asset doesn't exist
+    """
+    assets = importlib.resources.files("pymdownx_mahjong") / "assets" / theme
+    svg_file = assets / f"{asset_name}.svg"
+    return svg_file.read_text(encoding="utf-8")
 
 
 class MahjongRenderer:
@@ -62,7 +86,6 @@ class MahjongRenderer:
         self.show_labels = show_labels
         self.inline_svg = inline_svg
         self.assets_path = Path(assets_path) if assets_path else None
-        self._svg_cache: dict[tuple[str, str], str] = {}
         self._svg_id_counter = 0
 
     def render(
@@ -290,17 +313,12 @@ class MahjongRenderer:
             SVG content string with unique IDs
         """
         theme = theme or (self.theme if self.theme != "auto" else "light")
-        cache_key = (theme, info.asset_name)
 
-        # Cache raw loaded SVG content (before ID uniquification)
-        if cache_key not in self._svg_cache:
-            svg_content = self._load_svg(info, theme)
-            # Process but don't add unique IDs yet - cache the base processed version
-            svg_content = self._process_svg(svg_content, unique_prefix=None)
-            self._svg_cache[cache_key] = svg_content
+        # Load and process SVG (package assets use module-level LRU cache)
+        svg_content = self._load_svg(info, theme)
+        svg_content = self._process_svg(svg_content)
 
-        # Get cached SVG and make IDs unique for this instance
-        svg_content = self._svg_cache[cache_key]
+        # Make IDs unique for this instance
         self._svg_id_counter += 1
         return self._make_ids_unique(svg_content, f"mj{self._svg_id_counter}_")
 
@@ -342,32 +360,28 @@ class MahjongRenderer:
         """
         theme = theme or (self.theme if self.theme != "auto" else "light")
 
-        # Try custom assets path first
+        # Try custom assets path first (not cached since it's user-specific)
         if self.assets_path:
             svg_path = self.assets_path / theme / f"{info.asset_name}.svg"
             if svg_path.exists():
                 return svg_path.read_text(encoding="utf-8")
 
-        # Fall back to package assets
+        # Fall back to package assets (uses module-level LRU cache)
         try:
-            assets = importlib.resources.files("pymdownx_mahjong") / "assets" / theme
-            svg_file = assets / f"{info.asset_name}.svg"
-            return svg_file.read_text(encoding="utf-8")
+            return _load_svg_from_package(info.asset_name, theme)
         except (FileNotFoundError, TypeError):
             # Return a placeholder SVG
             return self._placeholder_svg(info)
 
-    def _process_svg(self, svg_content: str, unique_prefix: str | None = None) -> str:
+    def _process_svg(self, svg_content: str) -> str:
         """Process SVG content for inline use.
 
         - Removes XML declaration
         - Removes unnecessary metadata
         - Adds sizing attributes
-        - Makes IDs unique to avoid conflicts when multiple SVGs are on the same page
 
         Args:
             svg_content: Raw SVG content
-            unique_prefix: Optional prefix to make IDs unique
 
         Returns:
             Processed SVG content
@@ -384,10 +398,6 @@ class MahjongRenderer:
         svg_content = _RE_WIDTH.sub(f'width="{self.tile_width}"', svg_content, count=1)
         svg_content = _RE_HEIGHT.sub(f'height="{self.tile_height}"', svg_content, count=1)
 
-        # Make IDs unique if prefix is provided
-        if unique_prefix:
-            svg_content = self._make_ids_unique(svg_content, unique_prefix)
-
         return svg_content.strip()
 
     def _make_ids_unique(self, svg_content: str, prefix: str) -> str:

pymdownx_mahjong/tiles.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import NamedTuple
+from typing import Final, NamedTuple
 
 
 class TileInfo(NamedTuple):
@@ -12,7 +12,7 @@ class TileInfo(NamedTuple):
     display_name: str
 
 
-TILE_DATABASE: dict[tuple[str, int], TileInfo] = {
+TILE_DATABASE: Final[dict[tuple[str, int], TileInfo]] = {
     # Manzu
     ("m", 1): TileInfo("1m", "1 Man"),
     ("m", 2): TileInfo("2m", "2 Man"),
@@ -57,7 +57,7 @@ TILE_DATABASE: dict[tuple[str, int], TileInfo] = {
     ("z", 7): TileInfo("7z", "Red Dragon"),
 }
 
-SPECIAL_TILES: dict[str, TileInfo] = {
+SPECIAL_TILES: Final[dict[str, TileInfo]] = {
     "back": TileInfo("back", "Face Down"),
     "blank": TileInfo("blank", "Blank"),
     "front": TileInfo("front", "Front"),

{pymdownx_mahjong-1.0.0.dist-info → pymdownx_mahjong-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymdownx-mahjong
-Version: 1.0.0
+Version: 1.1.0
 Summary: Python Markdown extension to render and stylize Mahjong tiles.
 Project-URL: Homepage, https://github.com/tylernguyen/pymdownx-mahjong
 Project-URL: Documentation, https://github.com/tylernguyen/pymdownx-mahjong
@@ -35,9 +35,15 @@ Requires-Dist: mkdocs-material>=9.0; extra == 'mkdocs'
 Requires-Dist: mkdocs>=1.4; extra == 'mkdocs'
 Description-Content-Type: text/markdown
 
+![PyPI - Version](https://img.shields.io/pypi/v/pymdownx-mahjong)
+
 # PyMdown Mahjong
 
-Extensions for [Python Markdown](https://python-markdown.github.io) that aids writing Mahjong content
+[Python Markdown](https://python-markdown.github.io) extension to render and stylize Mahjong tiles. Designed for use with [MkDocs](https://github.com/mkdocs/mkdocs) and [Zensical](https://github.com/zensical/zensical).
+
+## Documentation
+
+Demo and documentation can be found at [https://tylernguyen.github.io/pymdownx-mahjong/](https://tylernguyen.github.io/pymdownx-mahjong/).
 
 ## License
 

{pymdownx_mahjong-1.0.0.dist-info → pymdownx_mahjong-1.1.0.dist-info}/RECORD

@@ -1,11 +1,12 @@
-pymdownx_mahjong/__init__.py,sha256=3w2615_eJnY6sN3k_hBgEJue3dRFY13KhVZmHBHLPNk,644
+pymdownx_mahjong/__init__.py,sha256=mYyokR5i1zy1YoN3kFGPfL-VwlQgMH0yPyS12AT-Ki4,644
 pymdownx_mahjong/extension.py,sha256=aCRMkMQ8c0eenpcyR5eyLdN_OND9JpYFeRxodOeJyGo,6688
-pymdownx_mahjong/inline.py,sha256=2yQ9mM1qLFIin_2UBI_Kml8DOAN6J2jsgGri1ImHc4g,2429
-pymdownx_mahjong/parser.py,sha256=gw4_ZQUHviWHAr0DmnTVFoKUID_dElCqxpMgl7m9cMA,11217
-pymdownx_mahjong/renderer.py,sha256=xFwzjVQbqFrMnXmaKMwa3-9tXbTKgXmpkIuEK3VMhmg,16814
+pymdownx_mahjong/inline.py,sha256=QxnOmiZ-6cKjrLWsmNJwCCK3FVAjPvTgv97hfNnnnWg,2448
+pymdownx_mahjong/parser.py,sha256=I8wDlZO6oPMhTCqC0NFmsZJOQZCCCXyc78mk3vmmwcQ,12396
+pymdownx_mahjong/renderer.py,sha256=Lk52VCrULtwq9dGWr6J-E1_ZJAlO93nJDVSC0I_mhYI,16947
 pymdownx_mahjong/superfences.py,sha256=LXzG6P2EB8dU9A_5ncFbTJEA4Jy6RLwjjYXZS2wSjhs,3099
-pymdownx_mahjong/tiles.py,sha256=BD4XlnOfH0Z3_xMhyLDAvxi6tPzMf5j4okPSsw1nzh4,2562
+pymdownx_mahjong/tiles.py,sha256=ltA1xJeS9fVcZQyUwaIjyl1mHEZ0Kr_QUKy1jhCapDM,2583
 pymdownx_mahjong/utils.py,sha256=aHKX4wDCGM_rvaOwFIbd9qVJHpzzUjXWMviLxdwZrdo,2637
+pymdownx_mahjong/assets/README.md,sha256=HDNhZZlt8ffTER1fVNcTayUnFqOmB3tXoocT8iZgCz0,179
 pymdownx_mahjong/assets/dark/0m.svg,sha256=wTa3OxyZziCtsk5hqLpLJig-1IbQPo_XrMrox5wZFzU,18773
 pymdownx_mahjong/assets/dark/0p.svg,sha256=Ge4V_vOYTJtqSOI89YmxP451WsNOL3Pv_A8-apdYrI8,23308
 pymdownx_mahjong/assets/dark/0s.svg,sha256=mErmM8konoHN5XlNwuffYEJNczrawQo1800kQlAg1VA,32913
@@ -86,9 +87,9 @@ pymdownx_mahjong/assets/light/9s.svg,sha256=WjNpR3IUty3ccnEwq9CpcSbLr3A-ta0yJqWx
 pymdownx_mahjong/assets/light/back.svg,sha256=HPAJfchslm_1uZQzpY8FUNF2s8hmbARGkhxNMlfnkQk,11245
 pymdownx_mahjong/assets/light/blank.svg,sha256=uKGioQLfrCZsSbMr66iDXv4w9lKHEqGym1l098-q5DM,8499
 pymdownx_mahjong/assets/light/front.svg,sha256=63TB5953_-10TDRd7K_kJnHoqt-6wd05MEGV2AcNsks,11906
-pymdownx_mahjong/css/mahjong.css,sha256=z-AuTffSmu4_Rrh8VnoYjx8ZHL2DV-8ATbNKdoTg4Bc,9336
-pymdownx_mahjong-1.0.0.dist-info/METADATA,sha256=fS6tItQex0QDQakUjZa6n9skBTrhgIR8NTiBQGIOx7c,1871
-pymdownx_mahjong-1.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-pymdownx_mahjong-1.0.0.dist-info/entry_points.txt,sha256=dEty6XpsYCWl45PeRYHiH9ORxwSZA64LQU8gWF1CuyU,72
-pymdownx_mahjong-1.0.0.dist-info/licenses/LICENSE,sha256=Mnpx_G3eVz7AX5uTHGPaZWHJYiJYu4Y2_l01PsksHdg,19921
-pymdownx_mahjong-1.0.0.dist-info/RECORD,,
+pymdownx_mahjong/css/mahjong.css,sha256=OpO9RR-UPFAbPF6Q8Wuz0Ak_Pg9rOrOsMAtnP0oj5LE,9307
+pymdownx_mahjong-1.1.0.dist-info/METADATA,sha256=8uXHaggPvIhroHgD2VdYNfDiJdtmM99XXAgIGjnlslc,2213
+pymdownx_mahjong-1.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+pymdownx_mahjong-1.1.0.dist-info/entry_points.txt,sha256=dEty6XpsYCWl45PeRYHiH9ORxwSZA64LQU8gWF1CuyU,72
+pymdownx_mahjong-1.1.0.dist-info/licenses/LICENSE,sha256=Mnpx_G3eVz7AX5uTHGPaZWHJYiJYu4Y2_l01PsksHdg,19921
+pymdownx_mahjong-1.1.0.dist-info/RECORD,,