mkdocs2confluence 0.6.7__tar.gz → 0.6.8__tar.gz

{mkdocs2confluence-0.6.7/src/mkdocs2confluence.egg-info → mkdocs2confluence-0.6.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.6.7
+Version: 0.6.8
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later
@@ -288,6 +288,7 @@ extra_css:
 | Internal links `[text](page.md)` | Native Confluence page link; `#fragment` anchors preserved |
 | `awesome-pages` nav (`.pages` files) | Fully supported |
 | Edit link banner | `info` macro linking back to source in GitHub/GitLab |
+| Grid cards `<div class="grid cards" markdown>` | Native `ac:layout` multi-column sections (auto-detects 1/2/3 columns from card count); admonitions, paragraphs, and mixed content fully supported inside cards |
 
 ### YAML front matter → Page Properties
 
@@ -325,29 +326,20 @@ MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — C
 
 Any unrecognised block is preserved as a visible `warning` macro — no content is silently lost.
 
-`<div class="grid" markdown>` (Material grid cards) has no Confluence equivalent. The wrapper is stripped; inner admonitions render sequentially.
-
 ---
 
 ## Known limitations
 
 | Feature | Behaviour |
 |---|---|
-| **Admonition styling** | Native macros (`tip`, `info`, `warning`, `note`) use Confluence's fixed theme styling — no custom header/body colours. |
+| **Admonition styling** | `tip`, `info`, `warning`, `note` use Confluence's fixed native macro styling — no custom colours. `danger`, `error`, and `bug` use a custom red `panel` macro with 🚨 prefix. All other types are mapped to the nearest native macro. |
 | **Abbreviation tooltips** | No native tooltip support. First occurrence expanded inline; remainder left as-is. |
 | **Grid cards** | Wrapper stripped; inner admonitions rendered individually. |
-| **Page width** | Confluence defaults to a narrow fixed-width column. mk2conf publishes with `fullWidth: true` by default (configurable). |
 | **Page ordering** | Confluence sorts child pages alphabetically. The v2 REST API has no write endpoint for child ordering; nav order cannot be enforced. |
 | **Code language aliases** | Pygments short aliases (`py`, `js`, `yml`, `ts`, `sh`) are passed through as-is; Confluence requires full language names for syntax highlighting. |
 
 ---
 
-## Roadmap
-
-- [x] **Delete orphaned pages** — `--prune` detects and removes managed Confluence pages that have been removed from `nav:`. Manually-created pages are never deleted.
-
----
-
 ## Development
 
 See [Setup.md](Setup.md) for environment setup.

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/README.md

@@ -250,6 +250,7 @@ extra_css:
 | Internal links `[text](page.md)` | Native Confluence page link; `#fragment` anchors preserved |
 | `awesome-pages` nav (`.pages` files) | Fully supported |
 | Edit link banner | `info` macro linking back to source in GitHub/GitLab |
+| Grid cards `<div class="grid cards" markdown>` | Native `ac:layout` multi-column sections (auto-detects 1/2/3 columns from card count); admonitions, paragraphs, and mixed content fully supported inside cards |
 
 ### YAML front matter → Page Properties
 
@@ -287,29 +288,20 @@ MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — C
 
 Any unrecognised block is preserved as a visible `warning` macro — no content is silently lost.
 
-`<div class="grid" markdown>` (Material grid cards) has no Confluence equivalent. The wrapper is stripped; inner admonitions render sequentially.
-
 ---
 
 ## Known limitations
 
 | Feature | Behaviour |
 |---|---|
-| **Admonition styling** | Native macros (`tip`, `info`, `warning`, `note`) use Confluence's fixed theme styling — no custom header/body colours. |
+| **Admonition styling** | `tip`, `info`, `warning`, `note` use Confluence's fixed native macro styling — no custom colours. `danger`, `error`, and `bug` use a custom red `panel` macro with 🚨 prefix. All other types are mapped to the nearest native macro. |
 | **Abbreviation tooltips** | No native tooltip support. First occurrence expanded inline; remainder left as-is. |
 | **Grid cards** | Wrapper stripped; inner admonitions rendered individually. |
-| **Page width** | Confluence defaults to a narrow fixed-width column. mk2conf publishes with `fullWidth: true` by default (configurable). |
 | **Page ordering** | Confluence sorts child pages alphabetically. The v2 REST API has no write endpoint for child ordering; nav order cannot be enforced. |
 | **Code language aliases** | Pygments short aliases (`py`, `js`, `yml`, `ts`, `sh`) are passed through as-is; Confluence requires full language names for syntax highlighting. |
 
 ---
 
-## Roadmap
-
-- [x] **Delete orphaned pages** — `--prune` detects and removes managed Confluence pages that have been removed from `nav:`. Manually-created pages are never deleted.
-
----
-
 ## Development
 
 See [Setup.md](Setup.md) for environment setup.

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs2confluence"
-version = "0.6.7"
+version = "0.6.8"
 description = "Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more"
 readme = "README.md"
 license = { text = "GPL-3.0-or-later" }

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8/src/mkdocs2confluence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.6.7
+Version: 0.6.8
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later
@@ -288,6 +288,7 @@ extra_css:
 | Internal links `[text](page.md)` | Native Confluence page link; `#fragment` anchors preserved |
 | `awesome-pages` nav (`.pages` files) | Fully supported |
 | Edit link banner | `info` macro linking back to source in GitHub/GitLab |
+| Grid cards `<div class="grid cards" markdown>` | Native `ac:layout` multi-column sections (auto-detects 1/2/3 columns from card count); admonitions, paragraphs, and mixed content fully supported inside cards |
 
 ### YAML front matter → Page Properties
 
@@ -325,29 +326,20 @@ MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — C
 
 Any unrecognised block is preserved as a visible `warning` macro — no content is silently lost.
 
-`<div class="grid" markdown>` (Material grid cards) has no Confluence equivalent. The wrapper is stripped; inner admonitions render sequentially.
-
 ---
 
 ## Known limitations
 
 | Feature | Behaviour |
 |---|---|
-| **Admonition styling** | Native macros (`tip`, `info`, `warning`, `note`) use Confluence's fixed theme styling — no custom header/body colours. |
+| **Admonition styling** | `tip`, `info`, `warning`, `note` use Confluence's fixed native macro styling — no custom colours. `danger`, `error`, and `bug` use a custom red `panel` macro with 🚨 prefix. All other types are mapped to the nearest native macro. |
 | **Abbreviation tooltips** | No native tooltip support. First occurrence expanded inline; remainder left as-is. |
 | **Grid cards** | Wrapper stripped; inner admonitions rendered individually. |
-| **Page width** | Confluence defaults to a narrow fixed-width column. mk2conf publishes with `fullWidth: true` by default (configurable). |
 | **Page ordering** | Confluence sorts child pages alphabetically. The v2 REST API has no write endpoint for child ordering; nav order cannot be enforced. |
 | **Code language aliases** | Pygments short aliases (`py`, `js`, `yml`, `ts`, `sh`) are passed through as-is; Confluence requires full language names for syntax highlighting. |
 
 ---
 
-## Roadmap
-
-- [x] **Delete orphaned pages** — `--prune` detects and removes managed Confluence pages that have been removed from `nav:`. Manually-created pages are never deleted.
-
----
-
 ## Development
 
 See [Setup.md](Setup.md) for environment setup.

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/src/mkdocs_to_confluence/emitter/xhtml.py

@@ -34,6 +34,7 @@ from mkdocs_to_confluence.ir.nodes import (
     FootnoteBlock,
     FootnoteRef,
     FrontMatter,
+    GridCards,
     HorizontalRule,
     ImageNode,
     InlineHtmlNode,
@@ -188,6 +189,8 @@ def _emit_node(node: IRNode) -> str:
         return _emit_front_matter(node)
     if isinstance(node, FootnoteBlock):
         return _emit_footnote_block(node)
+    if isinstance(node, GridCards):
+        return _emit_grid_cards(node)
     if isinstance(node, UnsupportedBlock):
         return _emit_unsupported(node)
     # Inline nodes at block level (shouldn't normally appear, but be safe)
@@ -479,6 +482,51 @@ def _emit_expandable(node: Expandable) -> str:
     )
 
 
+def _grid_layout_type(n: int) -> str:
+    """Choose an ``ac:layout-section`` type for *n* grid cards.
+
+    Rules (minimise empty cells, prefer fewer rows):
+    - 1 card  → ``single``
+    - divisible by 3 → ``three_equal``
+    - otherwise → ``two_equal``
+    """
+    if n == 1:
+        return "single"
+    if n % 3 == 0:
+        return "three_equal"
+    return "two_equal"
+
+
+def _emit_grid_cards(node: GridCards) -> str:
+    """Emit a Material grid cards block as a native ``ac:layout`` section.
+
+    Each card maps to one ``ac:layout-cell``.  The column count is auto-detected
+    from the number of cards: 1 → single, 3/6/9/… → three_equal, else two_equal.
+    Empty padding cells are added when the last row is not full.
+    """
+    items = node.items
+    layout_type = _grid_layout_type(len(items))
+    cols = 1 if layout_type == "single" else (3 if layout_type == "three_equal" else 2)
+
+    rows: list[list[tuple[IRNode, ...]]] = []
+    for start in range(0, len(items), cols):
+        rows.append(list(items[start : start + cols]))
+
+    parts: list[str] = ["<ac:layout>\n"]
+    for row in rows:
+        parts.append(f'  <ac:layout-section ac:type="{layout_type}">\n')
+        for card_nodes in row:
+            parts.append("    <ac:layout-cell>\n")
+            parts.append(emit(card_nodes))
+            parts.append("    </ac:layout-cell>\n")
+        # Pad last row with empty cells if needed.
+        for _ in range(cols - len(row)):
+            parts.append("    <ac:layout-cell><p /></ac:layout-cell>\n")
+        parts.append("  </ac:layout-section>\n")
+    parts.append("</ac:layout>\n")
+    return "".join(parts)
+
+
 def _emit_unsupported(node: UnsupportedBlock) -> str:
     safe = html.escape(node.raw)
     return (

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/src/mkdocs_to_confluence/ir/__init__.py

@@ -28,6 +28,7 @@ from mkdocs_to_confluence.ir.nodes import (
     FootnoteBlock,
     FootnoteDef,
     FootnoteRef,
+    GridCards,
     HorizontalRule,
     ImageNode,
     # Inline HTML nodes
@@ -105,6 +106,7 @@ __all__ = [
     "ContentTabs",
     "Tab",
     "Expandable",
+    "GridCards",
     # Degradation
     "UnsupportedBlock",
     # Footnotes

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/src/mkdocs_to_confluence/ir/nodes.py

@@ -444,6 +444,21 @@ class FootnoteBlock(IRNode):
     items: tuple[FootnoteDef, ...]
 
 
+# ── Grid cards ───────────────────────────────────────────────────────────────
+
+
+@dataclass(frozen=True)
+class GridCards(IRNode):
+    """Material for MkDocs ``<div class="grid cards" markdown>`` layout.
+
+    Each element of *items* is a tuple of IR nodes representing one card.
+    The emitter maps this to a native ``ac:layout`` multi-column section,
+    choosing ``two_equal`` or ``three_equal`` based on the number of cards.
+    """
+
+    items: tuple[tuple[IRNode, ...], ...]
+
+
 # ── Graceful degradation ──────────────────────────────────────────────────────
 
 
@@ -489,3 +504,7 @@ def walk(node: IRNode) -> Generator[IRNode, None, None]:
             for item in value:
                 if isinstance(item, IRNode):
                     yield from walk(item)
+                elif isinstance(item, tuple):
+                    for sub in item:
+                        if isinstance(sub, IRNode):
+                            yield from walk(sub)

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/src/mkdocs_to_confluence/parser/markdown.py

@@ -66,6 +66,7 @@ from mkdocs_to_confluence.ir.nodes import (
     FootnoteBlock,
     FootnoteDef,
     FootnoteRef,
+    GridCards,
     HorizontalRule,
     ImageNode,
     InlineHtmlNode,
@@ -201,6 +202,11 @@ class _DefListToken:
     items: list[_DefListItemData]
 
 
+@dataclass
+class _GridCardsToken:
+    cards: list[list[_Token]]  # each inner list = tokens for one card
+
+
 _Token = Union[
     _HeadingToken,
     _CodeToken,
@@ -214,6 +220,7 @@ _Token = Union[
     _TableToken,
     _FootnoteDefToken,
     _DefListToken,
+    _GridCardsToken,
 ]
 
 
@@ -255,6 +262,41 @@ _FOOTNOTE_REF_RE = re.compile(r'^\[\^(?P<label>[^\]]+)\]')
 # Matches a definition list definition line:  :   text
 _DEFLIST_DEF_RE = re.compile(r'^:\s+(?P<text>.+)$')
 
+# Matches <div class="grid cards" markdown> (with or without quotes around class value).
+_GRID_CARD_DIV_RE = re.compile(
+    r'^\s*<div\b[^>]*\bclass=["\'][^"\']*\bgrid\s+cards\b[^"\']*["\'][^>]*>\s*$',
+    re.IGNORECASE,
+)
+_CLOSE_DIV_RE = re.compile(r'^\s*</div>\s*$', re.IGNORECASE)
+
+
+def _tokenize_grid_cards(inner_lines: list[str]) -> _GridCardsToken:
+    """Convert the inner lines of a grid cards div into a ``_GridCardsToken``.
+
+    Two card formats are supported:
+
+    * **Bullet list** — each list item is one card::
+
+        - :icon: **Title** — description text
+
+    * **Admonition list** — each admonition is one card::
+
+        !!! tip "Title"
+            Body content
+    """
+    inner_tokens = _tokenize("\n".join(inner_lines))
+
+    # Bullet list: each item becomes a card (a single paragraph).
+    if len(inner_tokens) == 1 and isinstance(inner_tokens[0], _BulletListToken):
+        cards: list[list[_Token]] = [
+            [_ParagraphToken(lines=[item.text])]
+            for item in inner_tokens[0].items
+        ]
+        return _GridCardsToken(cards=cards)
+
+    # All other cases: each top-level token is one card.
+    return _GridCardsToken(cards=[[tok] for tok in inner_tokens])
+
 
 def _tokenize(text: str) -> list[_Token]:
     """Convert *text* into a flat list of tokens.
@@ -268,6 +310,25 @@ def _tokenize(text: str) -> list[_Token]:
     while i < len(lines):
         line = lines[i]
 
+        # ── Grid cards div ───────────────────────────────────────────────────
+        if _GRID_CARD_DIV_RE.match(line):
+            i += 1
+            inner_lines: list[str] = []
+            depth = 1
+            while i < len(lines) and depth > 0:
+                if _GRID_CARD_DIV_RE.match(lines[i]):
+                    depth += 1
+                elif _CLOSE_DIV_RE.match(lines[i]):
+                    depth -= 1
+                    if depth == 0:
+                        i += 1
+                        break
+                if depth > 0:
+                    inner_lines.append(lines[i])
+                i += 1
+            tokens.append(_tokenize_grid_cards(inner_lines))
+            continue
+
         # ── Fenced code block ────────────────────────────────────────────────
         fence_m = _FENCE_OPEN_RE.match(line)
         if fence_m:
@@ -1055,6 +1116,13 @@ def _build_tree(
             )
             _append_content(DefinitionList(items=dl_items), stack, root)
 
+        elif isinstance(token, _GridCardsToken):
+            card_ir = tuple(
+                _build_tree(card_tokens, fn_map=_fn)
+                for card_tokens in token.cards
+            )
+            _append_content(GridCards(items=card_ir), stack, root)
+
     # Close all remaining open sections.
     _close_from_level(0, stack, root)
 

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/src/mkdocs_to_confluence/preprocess/includes.py

@@ -43,6 +43,12 @@ _SNIPPET_RE = re.compile(r'^--8<--\s+"(?P<path>[^"]+)"\s*$')
 
 # Raw HTML block wrappers that have no Confluence equivalent — stripped silently.
 # Matches opening tags like <div class="grid" markdown> and bare </div>.
+# Note: <div class="grid cards" markdown> is NOT stripped here — it is parsed
+# by the tokenizer and converted to a GridCards IR node.
+_GRID_CARD_RE = re.compile(
+    r'^\s*<div\b[^>]*\bclass=["\'][^"\']*\bgrid\s+cards\b[^"\']*["\'][^>]*>\s*$',
+    re.IGNORECASE,
+)
 _STRIP_TAG_RE = re.compile(
     r'^\s*<div\b[^>]*\bmarkdown\b[^>]*>\s*$'   # <div ... markdown ...>
     r'|^\s*</div>\s*$',                          # </div>
@@ -111,11 +117,16 @@ def strip_unsupported_html(text: str) -> str:
 
     Strips ``<div ... markdown ...>`` opening tags and bare ``</div>`` closing
     tags.  The content inside is preserved — only the wrapper lines are dropped.
+
+    ``<div class="grid cards" markdown>`` blocks are preserved intact — they are
+    handled by the parser and converted to native ``ac:layout`` grid sections.
+
     Tags inside fenced code blocks are left untouched.
     """
     lines = text.splitlines(keepends=True)
     result: list[str] = []
     tracker = FenceTracker()
+    grid_depth = 0  # >0 means we are inside a grid cards div
 
     for line in lines:
         stripped = line.rstrip("\n").rstrip("\r")
@@ -125,6 +136,21 @@ def strip_unsupported_html(text: str) -> str:
         if was_in_fence or tracker.in_fence:
             result.append(line)
             continue
+
+        # Grid card opener — preserve and track nesting depth.
+        if _GRID_CARD_RE.match(stripped):
+            grid_depth += 1
+            result.append(line)
+            continue
+
+        if grid_depth > 0:
+            # Inside a grid card block: preserve all content, including </div>.
+            if re.match(r'^\s*</div>\s*$', stripped, re.IGNORECASE):
+                grid_depth -= 1
+            result.append(line)
+            continue
+
+        # Outside grid cards: strip other markdown div wrappers.
         if _STRIP_TAG_RE.match(stripped):
             continue  # drop the wrapper line silently
         result.append(line)

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/tests/test_emitter.py

@@ -458,3 +458,88 @@ class TestMermaidEmitter:
         out = emit((node,))
         assert 'ac:align="center"' in out
         assert 'ri:filename="diag.png"' in out
+
+
+class TestGridCardsEmitter:
+    def test_two_cards_uses_two_equal(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import GridCards, Paragraph, TextNode
+        node = GridCards(items=(
+            (Paragraph((TextNode("Fast"),)),),
+            (Paragraph((TextNode("Secure"),)),),
+        ))
+        out = emit((node,))
+        assert 'ac:type="two_equal"' in out
+        assert out.count("<ac:layout-cell>") == 2
+        assert "Fast" in out
+        assert "Secure" in out
+
+    def test_three_cards_uses_three_equal(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import GridCards, Paragraph, TextNode
+        node = GridCards(items=(
+            (Paragraph((TextNode("A"),)),),
+            (Paragraph((TextNode("B"),)),),
+            (Paragraph((TextNode("C"),)),),
+        ))
+        out = emit((node,))
+        assert 'ac:type="three_equal"' in out
+        assert out.count("<ac:layout-cell>") == 3
+
+    def test_one_card_uses_single(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import GridCards, Paragraph, TextNode
+        node = GridCards(items=(
+            (Paragraph((TextNode("Only"),)),),
+        ))
+        out = emit((node,))
+        assert 'ac:type="single"' in out
+
+    def test_four_cards_uses_two_equal_two_rows(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import GridCards, Paragraph, TextNode
+        cards = tuple(
+            (Paragraph((TextNode(f"Card {i}"),)),) for i in range(4)
+        )
+        node = GridCards(items=cards)
+        out = emit((node,))
+        assert 'ac:type="two_equal"' in out
+        assert out.count("<ac:layout-section") == 2
+        assert out.count("<ac:layout-cell>") == 4
+
+    def test_six_cards_uses_three_equal_two_rows(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import GridCards, Paragraph, TextNode
+        cards = tuple(
+            (Paragraph((TextNode(f"Card {i}"),)),) for i in range(6)
+        )
+        node = GridCards(items=cards)
+        out = emit((node,))
+        assert 'ac:type="three_equal"' in out
+        assert out.count("<ac:layout-section") == 2
+
+    def test_five_cards_pads_last_row(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import GridCards, Paragraph, TextNode
+        cards = tuple(
+            (Paragraph((TextNode(f"Card {i}"),)),) for i in range(5)
+        )
+        node = GridCards(items=cards)
+        out = emit((node,))
+        # 5 items with two_equal → 3 rows, last has 1 real + 1 padded cell
+        assert 'ac:type="two_equal"' in out
+        assert out.count("<ac:layout-cell>") == 6  # 5 real + 1 padding
+
+    def test_admonition_inside_card(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import Admonition, GridCards, Paragraph, TextNode
+        adm = Admonition(
+            kind="tip",
+            title="Speed",
+            collapsible=False,
+            children=(Paragraph((TextNode("Fast"),)),),
+        )
+        node = GridCards(items=((adm,), (Paragraph((TextNode("Other"),)),)))
+        out = emit((node,))
+        assert 'ac:name="tip"' in out
+        assert "Speed" in out
+
+    def test_wraps_in_ac_layout(self) -> None:
+        from mkdocs_to_confluence.ir.nodes import GridCards, Paragraph, TextNode
+        node = GridCards(items=((Paragraph((TextNode("x"),)),),))
+        out = emit((node,))
+        assert out.startswith("<ac:layout>")
+        assert "</ac:layout>" in out

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/tests/test_ir.py

@@ -17,6 +17,7 @@ from mkdocs_to_confluence.ir import (
     ContentTabs,
     Document,
     Expandable,
+    GridCards,
     HorizontalRule,
     ImageNode,
     InsertNode,
@@ -588,3 +589,28 @@ class TestNodeEquality:
         node = TextNode("key")
         d = {node: "value"}
         assert d[TextNode("key")] == "value"
+
+
+class TestGridCardsNode:
+    def test_basic_construction(self) -> None:
+        card1 = (TextNode("Fast"),)
+        card2 = (TextNode("Secure"),)
+        node = GridCards(items=(card1, card2))
+        assert len(node.items) == 2
+        assert node.items[0][0] == TextNode("Fast")
+
+    def test_immutable(self) -> None:
+        node = GridCards(items=((TextNode("x"),),))
+        with pytest.raises(dataclasses.FrozenInstanceError):
+            node.items = ()  # type: ignore[misc]
+
+    def test_equality(self) -> None:
+        a = GridCards(items=((TextNode("x"),),))
+        b = GridCards(items=((TextNode("x"),),))
+        assert a == b
+
+    def test_walk_yields_children(self) -> None:
+        inner = TextNode("hello")
+        node = GridCards(items=((inner,),))
+        found = list(walk(node))
+        assert inner in found

{mkdocs2confluence-0.6.7 → mkdocs2confluence-0.6.8}/tests/test_parser.py

@@ -1228,3 +1228,62 @@ class TestKeyboardKeys:
         para = first(parse("C++ is a language\n"), Paragraph)
         text = "".join(n.text for n in para.children if isinstance(n, TextNode))
         assert "C++" in text
+
+
+class TestGridCards:
+    def test_bullet_list_items_become_cards(self) -> None:
+        from mkdocs_to_confluence.ir import GridCards, Paragraph
+        md = (
+            '<div class="grid cards" markdown>\n'
+            "- **Fast** — compiles quickly\n"
+            "- **Secure** — no credentials stored\n"
+            "</div>\n"
+        )
+        nodes = parse(md)
+        gc = next(n for n in nodes if isinstance(n, GridCards))
+        assert len(gc.items) == 2
+        assert any(isinstance(n, Paragraph) for n in gc.items[0])
+        assert any(isinstance(n, Paragraph) for n in gc.items[1])
+
+    def test_admonition_items_become_cards(self) -> None:
+        from mkdocs_to_confluence.ir import Admonition, GridCards
+        md = (
+            '<div class="grid cards" markdown>\n'
+            '\n'
+            '!!! tip "Card 1"\n'
+            '    First card content\n'
+            '\n'
+            '!!! info "Card 2"\n'
+            '    Second card content\n'
+            '\n'
+            '</div>\n'
+        )
+        nodes = parse(md)
+        gc = next(n for n in nodes if isinstance(n, GridCards))
+        assert len(gc.items) == 2
+        assert any(isinstance(n, Admonition) for n in gc.items[0])
+        assert any(isinstance(n, Admonition) for n in gc.items[1])
+
+    def test_single_card(self) -> None:
+        from mkdocs_to_confluence.ir import GridCards
+        md = (
+            '<div class="grid cards" markdown>\n'
+            "- Only one card\n"
+            "</div>\n"
+        )
+        nodes = parse(md)
+        gc = next(n for n in nodes if isinstance(n, GridCards))
+        assert len(gc.items) == 1
+
+    def test_three_cards(self) -> None:
+        from mkdocs_to_confluence.ir import GridCards
+        md = (
+            '<div class="grid cards" markdown>\n'
+            "- Card A\n"
+            "- Card B\n"
+            "- Card C\n"
+            "</div>\n"
+        )
+        nodes = parse(md)
+        gc = next(n for n in nodes if isinstance(n, GridCards))
+        assert len(gc.items) == 3