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

pymdownx_mahjong/__init__.py

@@ -4,7 +4,7 @@ from .extension import MahjongExtension, makeExtension
 from .inline import INLINE_TILE_PATTERN, MahjongInlineProcessor
 from .parser import Hand, MahjongParser, Meld, Tile
 from .renderer import MahjongRenderer
-from .superfences import superfences_formatter, superfences_validator
+from .superfences import configure_superfences, superfences_formatter, superfences_validator
 
 __all__ = [
     "MahjongExtension",
@@ -18,6 +18,7 @@ __all__ = [
     "Hand",
     "superfences_formatter",
     "superfences_validator",
+    "configure_superfences",
 ]
 
-__version__ = "1.1.0"
+__version__ = "1.2.0"

pymdownx_mahjong/extension.py

@@ -19,6 +19,15 @@ if TYPE_CHECKING:
     from markdown.blockparser import BlockParser
 
 
+def _to_bool(value: Any) -> bool:
+    """Convert a value to boolean, handling string 'true'/'false'."""
+    if isinstance(value, bool):
+        return value
+    if isinstance(value, str):
+        return value.lower() in ("true", "1", "yes")
+    return bool(value)
+
+
 class MahjongBlockProcessor(BlockProcessor):
     """Block processor that handles ```mahjong fenced code blocks.
 
@@ -43,10 +52,9 @@ class MahjongBlockProcessor(BlockProcessor):
         self.mj_parser = MahjongParser()
         self.renderer = MahjongRenderer(
             theme=config.get("theme", "light"),
-            css_class=config.get("css_class", "mahjong-hand"),
-            show_labels=config.get("show_labels", True),
-            inline_svg=config.get("inline_svg", True),
+            inline_svg=_to_bool(config.get("inline_svg", True)),
             assets_path=config.get("assets_path"),
+            closed_kan_style=config.get("closed_kan_style", "outer"),
         )
 
     def test(self, parent: etree.Element, block: str) -> bool:
@@ -158,13 +166,13 @@ class MahjongExtension(markdown.Extension):
             **kwargs: Configuration options
         """
         # Define configuration options with defaults
+        # Note: Use strings for boolean defaults for YAML compatibility
         self.config = {
             "theme": ["auto", "Color theme: 'light', 'dark', or 'auto'"],
-            "css_class": ["mahjong-hand", "CSS class for container"],
-            "show_labels": [True, "Show tile names as title attributes"],
-            "inline_svg": [True, "Inline SVG content vs img tags"],
+            "inline_svg": ["true", "Inline SVG content vs img tags"],
             "assets_path": ["", "Custom path to SVG assets"],
-            "enable_inline": [True, "Enable inline tile syntax (:1m:)"],
+            "enable_inline": ["true", "Enable inline tile syntax (:1m:)"],
+            "closed_kan_style": ["outer", "Closed kan style: 'outer' or 'inner'"],
         }
         super().__init__(**kwargs)
 
@@ -184,7 +192,7 @@ class MahjongExtension(markdown.Extension):
 
         # Register inline processor if enabled
         # Priority 76 to run before pymdownx.emoji (which uses 75)
-        if config.get("enable_inline", True):
+        if _to_bool(config.get("enable_inline", True)):
             inline_processor = MahjongInlineProcessor(INLINE_TILE_PATTERN, md, config)
             md.inlinePatterns.register(inline_processor, "mahjong_inline", 76)
 

pymdownx_mahjong/inline.py

@@ -20,6 +20,15 @@ if TYPE_CHECKING:
 INLINE_TILE_PATTERN: Final[str] = r":([0-9]+[mpsz])+:"
 
 
+def _to_bool(value: Any) -> bool:
+    """Convert a value to boolean, handling string 'true'/'false'."""
+    if isinstance(value, bool):
+        return value
+    if isinstance(value, str):
+        return value.lower() in ("true", "1", "yes")
+    return bool(value)
+
+
 class MahjongInlineProcessor(InlineProcessor):
     """Inline processor for mahjong tile notation.
 
@@ -40,10 +49,9 @@ class MahjongInlineProcessor(InlineProcessor):
         self.parser = MahjongParser()
         self.renderer = MahjongRenderer(
             theme=config.get("theme", "auto"),
-            css_class="mahjong-inline",
-            show_labels=config.get("show_labels", True),
-            inline_svg=config.get("inline_svg", True),
+            inline_svg=_to_bool(config.get("inline_svg", True)),
             assets_path=config.get("assets_path"),
+            css_class="mahjong-inline",
         )
 
     def handleMatch(self, m: re.Match, data: str) -> tuple[str | None, int | None, int | None]:

pymdownx_mahjong/renderer.py

@@ -50,9 +50,8 @@ class MahjongRenderer:
 
     Configuration options:
         theme: 'light', 'dark', or 'auto'
-        css_class: CSS class for the container
-        show_labels: Whether to show tile names as titles
-        inline_svg: Whether to inline SVG or use img tags
+        closed_kan_style: 'outer' (default) or 'inner'
+        inline_svg: Whether to inline SVG content (vs using img tags)
     """
 
     DEFAULT_TILE_WIDTH = 45
@@ -63,19 +62,21 @@ class MahjongRenderer:
     def __init__(
         self,
         theme: str = "light",
-        css_class: str = "mahjong-hand",
-        show_labels: bool = True,
         inline_svg: bool = True,
         assets_path: str | Path | None = None,
+        closed_kan_style: str = "outer",
+        css_class: str = "mahjong-hand",
     ) -> None:
         """Initialize the renderer.
 
         Args:
             theme: Color theme ('light', 'dark', or 'auto')
-            css_class: CSS class for the container element
-            show_labels: Show tile names as title attributes
             inline_svg: Inline SVG content vs img tags
             assets_path: Custom path to SVG assets
+            closed_kan_style: Style for closed kan back tiles:
+                'outer' (default) - back tiles on edges (back, front, front, back)
+                'inner' - back tiles in middle (front, back, back, front)
+            css_class: CSS class for container (internal use)
         """
         self.theme = theme
         self.tile_width = self.DEFAULT_TILE_WIDTH
@@ -83,9 +84,9 @@ class MahjongRenderer:
         self.tile_gap = self.DEFAULT_TILE_GAP
         self.meld_gap = self.DEFAULT_MELD_GAP
         self.css_class = css_class
-        self.show_labels = show_labels
         self.inline_svg = inline_svg
         self.assets_path = Path(assets_path) if assets_path else None
+        self.closed_kan_style = closed_kan_style
         self._svg_id_counter = 0
 
     def render(
@@ -209,7 +210,7 @@ class MahjongRenderer:
             classes.append("mahjong-tile-added")
 
         class_str = " ".join(classes)
-        title_attr = f' title="{info.display_name}"' if self.show_labels else ""
+        title_attr = f' title="{info.display_name}"'
 
         if self.inline_svg:
             svg_content = self._get_themed_svg_content(info)
@@ -271,9 +272,18 @@ class MahjongRenderer:
                 parts.append(self._render_tile(meld.tiles[2]))
         else:
             for i, tile in enumerate(meld.tiles):
-                # For closed kan, show back tiles for middle two
-                if meld.meld_type == MeldType.KAN_CLOSED and i in (1, 2):
-                    parts.append(self._render_back_tile())
+                # For closed kan, show back tiles based on style setting
+                if meld.meld_type == MeldType.KAN_CLOSED:
+                    if self.closed_kan_style == "inner":
+                        # 'inner': back tiles in middle: front, back, back, front
+                        is_back = i in (1, 2)
+                    else:
+                        # Default 'outer': back tiles on edges: back, front, front, back
+                        is_back = i in (0, 3)
+                    if is_back:
+                        parts.append(self._render_back_tile())
+                    else:
+                        parts.append(self._render_tile(tile))
                 else:
                     parts.append(self._render_tile(tile))
 

pymdownx_mahjong/superfences.py

@@ -17,20 +17,32 @@ class _SuperfencesState:
     """Encapsulates global state for superfences integration.
 
     Uses lazy initialization to create parser/renderer on first use.
+    Allows configuration via configure() method.
     """
 
     def __init__(self) -> None:
         self._renderer: MahjongRenderer | None = None
         self._parser: MahjongParser | None = None
+        self._config: dict[str, Any] = {}
+
+    def configure(self, **kwargs: Any) -> None:
+        """Configure the superfences state.
+
+        Args:
+            **kwargs: Configuration options (theme, closed_kan_style, etc.)
+        """
+        self._config.update(kwargs)
+        # Reset renderer to apply new config
+        self._renderer = None
 
     @property
     def renderer(self) -> MahjongRenderer:
         """Get or create the renderer instance."""
         if self._renderer is None:
             self._renderer = MahjongRenderer(
-                theme="auto",
-                show_labels=True,
-                inline_svg=True,
+                theme=self._config.get("theme", "auto"),
+                inline_svg=self._config.get("inline_svg", True),
+                closed_kan_style=self._config.get("closed_kan_style", "outer"),
             )
         return self._renderer
 
@@ -46,6 +58,24 @@ class _SuperfencesState:
 _state = _SuperfencesState()
 
 
+def configure_superfences(**kwargs: Any) -> None:
+    """Configure the superfences integration.
+
+    Call this before using superfences to set options like closed_kan_style.
+
+    Example:
+        from pymdownx_mahjong import configure_superfences
+        configure_superfences(closed_kan_style='outer')
+
+    Args:
+        **kwargs: Configuration options
+            - theme: 'light', 'dark', or 'auto'
+            - closed_kan_style: 'outer' or 'inner'
+            - inline_svg: bool
+    """
+    _state.configure(**kwargs)
+
+
 def superfences_validator(
     language: str,
     inputs: dict[str, str],
@@ -65,6 +95,14 @@ def superfences_validator(
     Returns:
         True if this is a valid mahjong fence
     """
+    # Try to get config from the markdown instance's extension
+    if hasattr(md, 'registeredExtensions'):
+        for ext in md.registeredExtensions:
+            if hasattr(ext, 'config') and 'closed_kan_style' in ext.config:
+                config = {key: ext.getConfig(key) for key in ext.config}
+                _state.configure(**config)
+                break
+
     return language == "mahjong"
 
 

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: pymdownx-mahjong
-Version: 1.1.0
+Version: 1.2.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
+Project-URL: Documentation, https://tylernguyen.github.io/pymdownx-mahjong/
 Project-URL: Repository, https://github.com/tylernguyen/pymdownx-mahjong
 Project-URL: Issues, https://github.com/tylernguyen/pymdownx-mahjong/issues
 Author: Tyler Nguyen
@@ -41,7 +41,7 @@ Description-Content-Type: text/markdown
 
 [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
 
 Demo and documentation can be found at [https://tylernguyen.github.io/pymdownx-mahjong/](https://tylernguyen.github.io/pymdownx-mahjong/).
 

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

@@ -1,9 +1,9 @@
-pymdownx_mahjong/__init__.py,sha256=mYyokR5i1zy1YoN3kFGPfL-VwlQgMH0yPyS12AT-Ki4,644
-pymdownx_mahjong/extension.py,sha256=aCRMkMQ8c0eenpcyR5eyLdN_OND9JpYFeRxodOeJyGo,6688
-pymdownx_mahjong/inline.py,sha256=QxnOmiZ-6cKjrLWsmNJwCCK3FVAjPvTgv97hfNnnnWg,2448
+pymdownx_mahjong/__init__.py,sha256=TTW8ssjfwCA9CCZLi2_ISzBMdiiIC_0ukY2yYGMDbvc,696
+pymdownx_mahjong/extension.py,sha256=HC-S_EUtSOyHHwJ72aDDsfyUGqxVUIwwycKpeap9YqY,6939
+pymdownx_mahjong/inline.py,sha256=Q0_wxP4mR3DOOa3pH4d8EDmffOc9VV0eiyPIKFC5P50,2667
 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/renderer.py,sha256=wl_wJSntg-7YGIfD6aVgdI0rokOpr4Qz2oFVWG49BQQ,17522
+pymdownx_mahjong/superfences.py,sha256=7rsTfhSlYZE25uwEJTfzmEDWUSblqvX0jMGnstwh92c,4493
 pymdownx_mahjong/tiles.py,sha256=ltA1xJeS9fVcZQyUwaIjyl1mHEZ0Kr_QUKy1jhCapDM,2583
 pymdownx_mahjong/utils.py,sha256=aHKX4wDCGM_rvaOwFIbd9qVJHpzzUjXWMviLxdwZrdo,2637
 pymdownx_mahjong/assets/README.md,sha256=HDNhZZlt8ffTER1fVNcTayUnFqOmB3tXoocT8iZgCz0,179
@@ -88,8 +88,8 @@ pymdownx_mahjong/assets/light/back.svg,sha256=HPAJfchslm_1uZQzpY8FUNF2s8hmbARGkh
 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=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,,
+pymdownx_mahjong-1.2.0.dist-info/METADATA,sha256=S4NGo2aiURkBQXW-Z_oll-1cMjq4W8grUkzjLe1SP6Y,2222
+pymdownx_mahjong-1.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+pymdownx_mahjong-1.2.0.dist-info/entry_points.txt,sha256=dEty6XpsYCWl45PeRYHiH9ORxwSZA64LQU8gWF1CuyU,72
+pymdownx_mahjong-1.2.0.dist-info/licenses/LICENSE,sha256=Mnpx_G3eVz7AX5uTHGPaZWHJYiJYu4Y2_l01PsksHdg,19921
+pymdownx_mahjong-1.2.0.dist-info/RECORD,,