md2lineflex 0.1.0__tar.gz

md2lineflex-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 parkwestlabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

md2lineflex-0.1.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: md2lineflex
+Version: 0.1.0
+Summary: Markdown to LINE FlexMessage Converter
+Keywords: markdown,LINE,flexmessage
+Author: parkwestlabs
+Author-email: parkwestlabs <281970052+parkwestlabs@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: line-bot-sdk>=3.25.0
+Requires-Dist: mdformat>=1.0.0
+Requires-Dist: mdformat-gfm>=1.0.0
+Requires-Dist: mistletoe>=1.6.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# md2lineflex - Markdown to LINE FlexMessage Converter
+
+[![PyPI version](https://badge.fury.io/py/md2lineflex.svg)](https://badge.fury.io/py/md2lineflex)
+[![Python Versions](https://img.shields.io/pypi/pyversions/md2lineflex.svg)](https://pypi.org/project/md2lineflex/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A lightweight Python library that converts **Markdown text into LINE Bot Flex Messages** effortlessly.
+
+Designed especially for LLM / Chatbot developers who want to render Markdown outputs (from OpenAI, Claude, etc.) as beautiful, structured LINE Flex Messages instead of plain text.
+
+---
+
+## Features
+
+- 🚀 **Zero-Config Conversion:** Simply pass a Markdown string and get a LINE Messaging API compatible `FlexMessage` object or `dict`.
+- 🎨 **Rich Component Support:** Supports Headings, Paragraphs, Lists, Code Blocks, Quotes, Links, Images, and Tables.
+- 🔗 **Flexible Link Handling:** Render links as embedded URLs, inline text, or interactive LINE URI Action Buttons.
+- 🛡️ **Type Safe:** Fully typed with `py.typed` marker (PEP 561) for modern IDE auto-completion.
+
+---
+
+## Installation
+
+```bash
+# Using uv (Recommended)
+uv add md2lineflex
+
+# Using pip
+pip install md2lineflex
+```
+
+Prerequisite: Python `>= 3.10` and `line-bot-sdk >= 3.0.0`
+
+---
+
+## Quickstart
+
+````python
+from linebot.v3.messaging import PushMessageRequest
+from md2lineflex import to_flex
+
+md_text = """
+## Hello LINE Bot!
+
+This is **bold text** generated from Markdown.
+
+- Feature 1: Automatic Flex Box layout
+- Feature 2: Supports [Links](https://example.com)
+
+```python
+print("Hello World")
+```
+"""
+
+# Convert Markdown to FlexMessage object
+flex_message = to_flex(md_text, link_mode="button")
+
+# Send via LINE Messaging API SDK
+request = PushMessageRequest(to="USER_ID", messages=[flex_message])
+messaging_api.push_message(request)
+````
+
+---
+
+## Options
+
+### Link Modes (`link_mode`)
+
+You can control how Markdown links `[Title](https://...)` are rendered in the Flex Message:
+
+| Mode | Description |
+| :--- | :--- |
+| `button` **(Default)** | Appends interactive URI action buttons below the text block. |
+| `action` | Renders links in text format: `Title (https://...)`. |
+| `url_text` | Renders links in text format: `Title [https://...]`. |
+
+```python
+flex_msg = to_flex(md_text, link_mode="button")
+```
+
+---
+
+## Development & Contributing
+
+See [DEVELOPMENT.md](DEVELOPMENT.md) for local setup, running tests, and contribution guidelines.
+
+---
+
+## License
+
+This project is licensed under the MIT License.

md2lineflex-0.1.0/README.md

@@ -0,0 +1,91 @@
+# md2lineflex - Markdown to LINE FlexMessage Converter
+
+[![PyPI version](https://badge.fury.io/py/md2lineflex.svg)](https://badge.fury.io/py/md2lineflex)
+[![Python Versions](https://img.shields.io/pypi/pyversions/md2lineflex.svg)](https://pypi.org/project/md2lineflex/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A lightweight Python library that converts **Markdown text into LINE Bot Flex Messages** effortlessly.
+
+Designed especially for LLM / Chatbot developers who want to render Markdown outputs (from OpenAI, Claude, etc.) as beautiful, structured LINE Flex Messages instead of plain text.
+
+---
+
+## Features
+
+- 🚀 **Zero-Config Conversion:** Simply pass a Markdown string and get a LINE Messaging API compatible `FlexMessage` object or `dict`.
+- 🎨 **Rich Component Support:** Supports Headings, Paragraphs, Lists, Code Blocks, Quotes, Links, Images, and Tables.
+- 🔗 **Flexible Link Handling:** Render links as embedded URLs, inline text, or interactive LINE URI Action Buttons.
+- 🛡️ **Type Safe:** Fully typed with `py.typed` marker (PEP 561) for modern IDE auto-completion.
+
+---
+
+## Installation
+
+```bash
+# Using uv (Recommended)
+uv add md2lineflex
+
+# Using pip
+pip install md2lineflex
+```
+
+Prerequisite: Python `>= 3.10` and `line-bot-sdk >= 3.0.0`
+
+---
+
+## Quickstart
+
+````python
+from linebot.v3.messaging import PushMessageRequest
+from md2lineflex import to_flex
+
+md_text = """
+## Hello LINE Bot!
+
+This is **bold text** generated from Markdown.
+
+- Feature 1: Automatic Flex Box layout
+- Feature 2: Supports [Links](https://example.com)
+
+```python
+print("Hello World")
+```
+"""
+
+# Convert Markdown to FlexMessage object
+flex_message = to_flex(md_text, link_mode="button")
+
+# Send via LINE Messaging API SDK
+request = PushMessageRequest(to="USER_ID", messages=[flex_message])
+messaging_api.push_message(request)
+````
+
+---
+
+## Options
+
+### Link Modes (`link_mode`)
+
+You can control how Markdown links `[Title](https://...)` are rendered in the Flex Message:
+
+| Mode | Description |
+| :--- | :--- |
+| `button` **(Default)** | Appends interactive URI action buttons below the text block. |
+| `action` | Renders links in text format: `Title (https://...)`. |
+| `url_text` | Renders links in text format: `Title [https://...]`. |
+
+```python
+flex_msg = to_flex(md_text, link_mode="button")
+```
+
+---
+
+## Development & Contributing
+
+See [DEVELOPMENT.md](DEVELOPMENT.md) for local setup, running tests, and contribution guidelines.
+
+---
+
+## License
+
+This project is licensed under the MIT License.

md2lineflex-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[project]
+name = "md2lineflex"
+version = "0.1.0"
+description = "Markdown to LINE FlexMessage Converter"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "markdown",
+    "LINE",
+    "flexmessage",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "line-bot-sdk>=3.25.0",
+    "mdformat>=1.0.0",
+    "mdformat-gfm>=1.0.0",
+    "mistletoe>=1.6.0",
+]
+
+[[project.authors]]
+name = "parkwestlabs"
+email = "281970052+parkwestlabs@users.noreply.github.com"
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.16.4",
+    "syrupy>=5.5.3",
+]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D",
+    "TC",
+    "CPY",
+    "COM812",
+    "G004",
+    "INP001",
+]
+allowed-confusables = [
+    "（",
+    "）",
+    "：",
+    "？",
+    "！",
+    "＆",
+    "＋",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*" = [
+    "S101",
+    "ANN201",
+    "PLR2004",
+    "ERA001",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=src --cov-branch --cov-report=term-missing --cov-report=html"
+
+[tool.coverage.report]
+fail_under = 90
+
+[tool.coverage.run]
+omit = ["*/__init__.py"]

md2lineflex-0.1.0/pyproject.toml.orig

@@ -0,0 +1,63 @@
+[project]
+name = "md2lineflex"
+version = "0.1.0"
+description = "Markdown to LINE FlexMessage Converter"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["markdown", "LINE", "flexmessage"]
+authors = [
+    { name = "parkwestlabs", email = "281970052+parkwestlabs@users.noreply.github.com" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "line-bot-sdk>=3.25.0",
+    "mdformat>=1.0.0",
+    "mdformat-gfm>=1.0.0",
+    "mistletoe>=1.6.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.16.4",
+    "syrupy>=5.5.3",
+]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D",
+    "TC",
+    "CPY",
+    "COM812",
+    "G004",     # Logging statement uses f-string
+    "INP001",   # an implicit namespace package
+]
+# RUF001, RUF002, RUF003 のすべてで「？」を無視する
+allowed-confusables = ["（", "）", "：", "？", "！", "＆", "＋"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*" = [
+    "S101",     # Use of assert
+    "ANN201",   # Missing return type annotation for public function
+    "PLR2004",  # Magic value used in comparison
+    "ERA001",   # Found commented-out code
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=src --cov-branch --cov-report=term-missing --cov-report=html"
+
+[tool.coverage.report]
+fail_under = 90
+
+[tool.coverage.run]
+omit = [
+    "*/__init__.py",
+]

md2lineflex-0.1.0/src/md2lineflex/__init__.py

@@ -0,0 +1,11 @@
+from importlib.metadata import PackageNotFoundError, version
+
+from md2lineflex.md_to_flex import to_flex
+
+try:
+    __version__ = version("md2lineflex")
+except PackageNotFoundError:
+    # 開発中（未インストール状態）のフォールバック
+    __version__ = "0.0.0"
+
+__all__ = ["__version__", "to_flex"]

md2lineflex-0.1.0/src/md2lineflex/flex_components.py

@@ -0,0 +1,214 @@
+from linebot.v3.messaging import (
+    FlexBox,
+    FlexButton,
+    FlexComponent,
+    FlexImage,
+    FlexSeparator,
+    FlexSpan,
+    FlexText,
+    URIAction,
+)
+
+from md2lineflex.theme import EMPTY_CHAR, Color, Margin, Size
+
+# 共通フォールバックオブジェクト
+EMPTY_SPAN = FlexSpan(text=EMPTY_CHAR)
+# contents に渡す用のリスト（読み取り専用想定）
+EMPTY_SPANS = [EMPTY_SPAN]
+
+
+def heading_component(text: str, level: int) -> FlexText:
+    # text が空文字や None だった場合に半角スペース1文字にフォールバック
+    safe_text = text if text and text.strip() else EMPTY_CHAR
+
+    size_map = {1: Size.HEADING_H1, 2: Size.HEADING_H2}
+    size = size_map.get(level, Size.BODY)
+
+    return FlexText(
+        text=safe_text,
+        weight="bold",
+        size=size,
+        color=Color.HEADING,
+        wrap=True,
+        margin=Margin.HEADING,
+    )  # pyright: ignore[reportCallIssue]
+
+
+def paragraph_component(spans: list[FlexSpan]) -> FlexText:
+    return FlexText(
+        size=Size.BODY,
+        wrap=True,
+        margin=Margin.PARAGRAPH,
+        color=Color.BODY,
+        contents=spans or EMPTY_SPANS,
+    )  # pyright: ignore[reportCallIssue]
+
+
+def code_block_component(raw_code: str) -> FlexBox:
+    return FlexBox(
+        layout="vertical",
+        backgroundColor=Color.BG_CODE_BLOCK,
+        cornerRadius="sm",
+        paddingAll="md",
+        margin=Margin.BLOCK,
+        contents=[
+            FlexText(
+                text=raw_code or EMPTY_CHAR,
+                size=Size.CODE,
+                color=Color.CODE_BLOCK_TEXT,  # abb2bf
+                wrap=True,
+            )  # pyright: ignore[reportCallIssue]
+        ],
+    )
+
+
+def list_item_component(
+    prefix: str,
+    spans: list[FlexSpan],
+    extras: list[FlexButton] | None = None,
+) -> FlexBox:
+    # 行頭記号用テキスト
+    prefix_component = FlexText(
+        text=prefix or EMPTY_CHAR,
+        size=Size.BODY,
+        color=Color.MUTED,
+        flex=0,  # 幅固定
+    )  # pyright: ignore[reportCallIssue]
+
+    # 本文用テキスト (contents に spans を配置)
+    text_component = FlexText(
+        text=EMPTY_CHAR,  # デフォルト
+        size=Size.BODY,
+        color=Color.BODY,
+        wrap=True,
+        flex=1,  # 残りの幅を占有
+        contents=spans or EMPTY_SPANS,
+    )  # pyright: ignore[reportCallIssue]
+
+    row_box = FlexBox(
+        layout="baseline",
+        spacing="sm",
+        contents=[prefix_component, text_component],
+    )  # pyright: ignore[reportCallIssue]
+
+    item_contents: list[FlexComponent] = [row_box]
+
+    # リンクボタン等の追加要素（extras）があれば下部に追加
+    if extras:
+        item_contents.extend(extras)
+
+    return FlexBox(
+        layout="vertical",
+        spacing="xs",
+        margin=Margin.LIST_ITEM,
+        contents=item_contents,
+    )  # pyright: ignore[reportCallIssue]
+
+
+def quote_box_component(contents: list[FlexComponent]) -> FlexBox:
+    # 引用テキストにスタイル (斜体・グレー色) を適用
+    for item in contents:
+        if isinstance(item, FlexText):
+            item.style = "italic"
+            item.color = Color.QUOTE
+
+    # contents が万が一空の場合は空のテキストコンポーネントを補填 (None 回避)
+    if not contents:
+        empty_text = FlexText(
+            size=Size.BODY,
+            style="italic",
+            color=Color.QUOTE,
+            wrap=True,
+            contents=EMPTY_SPANS,
+        )  # pyright: ignore[reportCallIssue]
+        contents = [empty_text]
+
+    # 引用デザインを適用した FlexBox
+    return FlexBox(
+        type="box",
+        layout="vertical",
+        spacing="xs",
+        backgroundColor=Color.BG_QUOTE,
+        borderColor=Color.BORDER,
+        borderWidth="semi-bold",
+        paddingAll="md",
+        margin=Margin.BLOCK,
+        contents=contents,  # 絶対に None にならない list
+    )  # pyright: ignore[reportCallIssue]
+
+
+def link_button_component(link_text: str, target_url: str) -> FlexButton:
+    return FlexButton(
+        style="secondary",
+        height="sm",
+        margin="sm",
+        action=URIAction(
+            type="uri",
+            label=f"開く: {link_text[:12]}",
+            uri=target_url,
+        ),  # pyright: ignore[reportCallIssue]
+    )  # pyright: ignore[reportCallIssue]
+
+
+def image_component(url: str) -> FlexImage:
+    return FlexImage(
+        url=url,
+        size="full",
+        aspectMode="fit",
+        margin=Margin.BLOCK,
+    )  # pyright: ignore[reportCallIssue]
+
+
+def separator_component() -> FlexSeparator:
+    return FlexSeparator(margin=Margin.HEADING, color=Color.SEPARATOR)
+
+
+def table_cell_component(
+    spans: list[FlexSpan], flex: int = 1, *, is_header: bool = False
+) -> FlexBox:
+    """表の 1 セルを生成 (ヘッダーの場合は太字・背景色を設定)"""
+    # ヘッダーの場合は文字を太字に補正（個別指定がなければ）
+    if is_header:
+        for span in spans:
+            if not span.weight:
+                span.weight = "bold"
+
+    text_comp = FlexText(
+        type="text",
+        contents=spans or EMPTY_SPANS,
+        size=Size.TABLE_CELL,
+        color=Color.HEADING if is_header else Color.BODY,
+        wrap=True,
+        flex=flex,
+    )  # pyright: ignore[reportCallIssue]
+
+    return FlexBox(
+        layout="vertical",
+        contents=[text_comp],
+        flex=flex,
+        paddingAll="xs",
+        backgroundColor=Color.BG_TABLE_HEADER if is_header else Color.BG_TABLE_BODY,
+    )  # pyright: ignore[reportCallIssue]
+
+
+def table_row_component(cells: list[FlexBox], *, is_header: bool = False) -> FlexBox:
+    """表の 1 行を横並び (horizontal) で生成"""
+    return FlexBox(
+        layout="horizontal",
+        contents=cells,
+        spacing="xs",
+        borderWidth="1px" if is_header else "none",
+        borderColor=Color.BORDER,
+    )  # pyright: ignore[reportCallIssue]
+
+
+def table_component(rows: list[FlexBox]) -> FlexBox:
+    """表全体のコンテナを生成"""
+    return FlexBox(
+        layout="vertical",
+        contents=rows,
+        spacing="2px",  # 行間の微小スキマ（区切り線っぽく見せる効果）
+        margin=Margin.BLOCK,
+        backgroundColor=Color.BG_TABLE_BORDER,  # 背景色をグレーにして枠線効果を出す
+        paddingAll="1px",
+    )  # pyright: ignore[reportCallIssue]

md2lineflex-0.1.0/src/md2lineflex/flex_message_renderer.py

@@ -0,0 +1,341 @@
+import json
+from typing import Literal
+
+from linebot.v3.messaging import (
+    FlexBox,
+    FlexBubble,
+    FlexButton,
+    FlexComponent,
+    FlexSpan,
+    FlexText,
+)
+from mistletoe.base_renderer import BaseRenderer
+from mistletoe.block_token import (
+    BlockCode,
+    CodeFence,
+    Document,
+    Heading,
+    List,
+    ListItem,
+    Paragraph,
+    Quote,
+    Table,
+    TableCell,
+    TableRow,
+    ThematicBreak,
+)
+from mistletoe.span_token import (
+    Emphasis,
+    HtmlSpan,
+    Image,
+    InlineCode,
+    LineBreak,
+    Link,
+    RawText,
+    Strikethrough,
+    Strong,
+)
+from mistletoe.token import Token
+
+from md2lineflex.flex_components import (
+    code_block_component,
+    heading_component,
+    image_component,
+    link_button_component,
+    list_item_component,
+    paragraph_component,
+    quote_box_component,
+    separator_component,
+    table_cell_component,
+    table_component,
+    table_row_component,
+)
+from md2lineflex.str_utils import to_json_utf8
+
+LinkMode = Literal["url_text", "action", "button"]
+
+# content 属性を持つ末端トークンの型定義 (型エイリアス)
+LeafToken = RawText | LineBreak | HtmlSpan
+
+# LINE Flex Message の構造
+# - ブロック要素: FlexBox や FlexBubble（レイアウトの入れ物）
+# - インライン要素: FlexText の中に入れる FlexSpan（文字装飾）
+
+# mistletoe → LINE Flex Message
+# Paragraph, Heading, List 等:
+#   render_* で受けて FlexComponent を組み立てる
+# Strong, Emphasis, Link 等:
+#   _parse_span_tokens と _convert_child_to_span で一括して FlexSpan 群に変換する
+
+
+class FlexMessageRenderer(BaseRenderer):
+    """Markdown AST を LINE Flex Message (Bubble) 用の JSON 文字列に変換するRenderer"""
+
+    def __init__(self, link_mode: LinkMode = "url_text") -> None:
+        super().__init__()
+        self.link_mode: LinkMode = link_mode
+
+    # --- インライン要素 (spans & extra components) の抽出 ---
+
+    def _parse_span_tokens(
+        self, token: Token
+    ) -> tuple[list[FlexSpan], list[FlexButton]]:
+        """子要素から Flex Text 用の spans と、追加のコンポーネント (ボタン等) を抽出"""
+        spans: list[FlexSpan] = []
+        extras: list[FlexButton] = []
+
+        for child in token.children or []:
+            span = self._convert_child_to_span(child, self.link_mode)
+            if span:
+                spans.append(span)
+
+                # リンクボタン (extra) の抽出 (Link かつ button モード時のみ)
+                if isinstance(child, Link) and self.link_mode == "button":
+                    link_text = self._get_plain_text(child)
+                    link_button = link_button_component(link_text, child.target)
+                    extras.append(link_button)
+
+            # Paragraph やその他の容器トークンの場合は再帰的に子要素を解析
+            elif child.children:
+                sub_spans, sub_extras = self._parse_span_tokens(child)
+                spans.extend(sub_spans)
+                extras.extend(sub_extras)
+
+            # その他の未対応インライン要素（安全策）
+            else:
+                fallback_text = self._get_plain_text(child)
+                if fallback_text:
+                    spans.append(FlexSpan(text=fallback_text))
+
+        return spans, extras
+
+    def _convert_child_to_span(  # noqa: PLR0911
+        self, child: Token, link_mode: LinkMode
+    ) -> FlexSpan | None:
+        text = self._get_plain_text(child)
+
+        match child:
+            case RawText():
+                # 空文字の場合は半角スペースにして LINE 仕様違反を防ぐ
+                return FlexSpan(text=child.content or " ")
+            case LineBreak():
+                return FlexSpan(text="\n")
+            case Strong():  # 太字
+                return FlexSpan(text=text, weight="bold")
+            case Emphasis():  # 斜体
+                return FlexSpan(text=text, style="italic", color="#555555")
+            case Strikethrough():
+                return FlexSpan(text=text, decoration="line-through")
+            case InlineCode():  # 行内コード
+                return FlexSpan(text=f" {text} ", color="#0052cc", weight="bold")
+            case Link():  # リンク ([text](url))
+                if link_mode == "action":
+                    return FlexSpan(text=f"{text} ({child.target})", color="#06c755", weight="bold")  # fmt: skip  # noqa: E501
+                if link_mode == "button":
+                    return FlexSpan(text=text, weight="bold", color="#06c755")
+                return FlexSpan(text=f"{text} [{child.target}]")
+            case _:
+                return None
+
+    def _get_plain_text(self, token: Token) -> str:
+        """純粋な文字列だけを取り出すヘルパー"""
+
+        # 1. content 属性を持つ末端ノードなら文字列を返す
+        if isinstance(token, LeafToken):
+            return token.content
+
+        # 2. children を持つ容器ノードなら子要素をたどる (再帰処理)
+        if token.children is not None:
+            return "".join(self._get_plain_text(child) for child in token.children)
+
+        # 3. Image などの特殊要素、又は children が None の場合はテキストなし (空文字)
+        return ""
+
+    # -------------------------------------------------------------------------
+    # Helper Methods (共通処理)
+    # -------------------------------------------------------------------------
+    def _render_children(self, token: Token) -> list[FlexComponent]:
+        """
+        子トークン群をレンダリングし、FlexComponent オブジェクトのリストとして集約する
+        """
+        contents: list[FlexComponent] = []
+
+        for child in token.children or []:
+            rendered_str = self.render(child)
+            if not rendered_str or not rendered_str.strip():
+                continue
+
+            parsed = json.loads(rendered_str.strip())
+
+            # 単体要素をリストに統一してイテレート処理を共通化
+            items = parsed if isinstance(parsed, list) else [parsed]
+
+            contents.extend([FlexComponent.from_dict(item) for item in items])
+
+        return contents
+
+    # -------------------------------------------------------------------------
+    # Block Renderers (ブロック要素のレンダリング)
+    # -------------------------------------------------------------------------
+    def render_document(self, token: Document) -> str:
+        contents = self._render_children(token)
+
+        # ドキュメントが空の場合の最小表示保証
+        if not contents:
+            # 空の Markdown の場合は安全なプレースホルダーテキストを設置
+            contents = [heading_component(" ", 3)]
+
+        # FlexBox と FlexBubble のインスタンスを from_dict で生成する
+        body_box = FlexBox(
+            layout="vertical",
+            spacing="md",
+            contents=contents,
+        )  # pyright: ignore[reportCallIssue]
+
+        bubble = FlexBubble(body=body_box)
+
+        return to_json_utf8(bubble.to_dict())
+
+    def render_heading(self, token: Heading) -> str:
+        text = self._get_plain_text(token)
+        heading = heading_component(text, token.level)
+        return to_json_utf8(heading.to_dict())
+
+    def render_paragraph(self, token: Paragraph) -> str:
+        children = list(token.children or [])
+
+        # 段落内に画像単体のみが含まれる場合の判定
+        if len(children) == 1 and isinstance(children[0], Image):
+            img_token = children[0]
+            image = image_component(img_token.src)
+            return to_json_utf8(image.to_dict())
+
+        spans, extras = self._parse_span_tokens(token)
+
+        # 段落テキスト（FlexText オブジェクト）を作成
+        para = paragraph_component(spans)
+
+        # 段落本体と追加のリンクボタン群をまとめる（すべて FlexComponent）
+        components: list[FlexComponent] = [para, *extras]
+
+        # リストを JSON 化して返却
+        return to_json_utf8([c.to_dict() for c in components])
+
+    def render_list(self, token: List) -> str:
+        """リスト全体をレンダリング"""
+        list_boxes: list[FlexComponent] = []
+
+        # 連番管理用の状態フラグとカウンター
+        is_ordered: bool | None = None
+        current_num = 0
+
+        # 最初の ListItem の leader (例: "1.", "-", "*") から番号付きリストか判定
+        for child in token.children or []:
+            if not isinstance(child, ListItem):
+                continue
+
+            if is_ordered is None:
+                leader = child.leader
+                clean_leader = leader.strip().rstrip(".")
+
+                # プレフィックスの先頭が数字（例: "1"）なら番号付きリストと判定
+                is_ordered = clean_leader.isdigit()
+                if is_ordered:
+                    current_num = int(clean_leader)
+
+            # プレフィックスの生成
+            if is_ordered:
+                prefix = f"{current_num}."
+                current_num += 1  # 2, 3... と自動インクリメント
+            else:
+                prefix = "•"
+
+            # 子要素 (インライン装飾) の解析
+            item_json = self.render_list_item(child, prefix)
+            item_dict = json.loads(item_json)
+            list_boxes.append(FlexComponent.from_dict(item_dict))
+
+        list_container = FlexBox(
+            layout="vertical",
+            spacing="xs",
+            margin="md",
+            contents=list_boxes,
+        )  # pyright: ignore[reportCallIssue]
+        return to_json_utf8(list_container.to_dict())
+
+    def render_list_item(self, token: ListItem, prefix: str = "•") -> str:
+        """リスト項目 1 つを JSON 文字列としてレンダリング"""
+        spans: list[FlexSpan] = []
+        extras: list[FlexButton] = []
+
+        # ListItem の子要素（Paragraph や RawText 等）から Span と Extras を抽出
+        for child in token.children or []:
+            child_spans, child_extras = self._parse_span_tokens(child)
+            spans.extend(child_spans)
+            extras.extend(child_extras)
+
+        list_item = list_item_component(prefix, spans, extras)
+
+        return to_json_utf8(list_item.to_dict())
+
+    def render_block_code(self, token: CodeFence | BlockCode) -> str:
+        """CodeFence と BlockCode の両方がここにルーティングされる"""
+        raw_code = self._get_plain_text(token).strip()
+        code_block = code_block_component(raw_code)
+        return to_json_utf8(code_block.to_dict())
+
+    def render_quote(self, token: Quote) -> str:
+        """引用 (>) ブロックの描画"""
+        contents = self._render_children(token)
+
+        # 引用ブロック内の全テキスト要素の上マージンを無効化して余白重複を防ぐ
+        for item in contents:
+            if isinstance(item, FlexText):
+                item.margin = "none"
+
+        quote_box = quote_box_component(contents)
+        return to_json_utf8(quote_box.to_dict())
+
+    def render_thematic_break(self, token: ThematicBreak) -> str:  # noqa: ARG002
+        """水平線 (---)"""
+        separator = separator_component()
+        return to_json_utf8(separator.to_dict())
+
+    def render_table(self, token: Table) -> str:
+        """Markdown Table を FlexBox のグリッドレイアウトとして描画"""
+        row_boxes: list[FlexBox] = []
+
+        # ヘッダー行 (token.header) の処理
+        if token.header is not None:
+            header_box = self._render_table_row(token.header, is_header=True)
+            if header_box:
+                row_boxes.append(header_box)
+
+        # 本文データ行 (token.children) の処理
+        for child in token.children or []:
+            # Table の children には必ず TableRow が入っているはず
+            if not isinstance(child, TableRow):
+                continue
+
+            row_box = self._render_table_row(child, is_header=False)
+            if row_box:
+                row_boxes.append(row_box)
+
+        # 表全体 Component の作成
+        table_container = table_component(row_boxes)
+        return to_json_utf8(table_container.to_dict())
+
+    def _render_table_row(self, row: TableRow, *, is_header: bool) -> FlexBox | None:
+        cell_boxes: list[FlexBox] = []
+
+        for cell in row.children or []:
+            if isinstance(cell, TableCell):
+                spans, _ = self._parse_span_tokens(cell)
+                if not spans:
+                    spans = [FlexSpan(text=" ")]  # 空セル対策
+                cell_boxes.append(table_cell_component(spans, is_header=is_header))
+
+        if not cell_boxes:
+            return None
+
+        return table_row_component(cell_boxes, is_header=is_header)

md2lineflex-0.1.0/src/md2lineflex/llm_utils.py

@@ -0,0 +1,14 @@
+import re
+
+import mdformat
+
+
+def clean_llm_output(text: str) -> str:
+    # 1. 太字のアスタリスクを除去
+    no_bold = re.sub(r"\*\*(.*?)\*\*", r"\1", text)
+
+    # 2. リストやテーブルを含めて綺麗なMarkdownに整形
+    formatted_text = mdformat.text(no_bold, extensions=["gfm"])
+
+    # 3. チャットUI用に末尾の改行を除去する
+    return formatted_text.rstrip("\n")

md2lineflex-0.1.0/src/md2lineflex/md_to_flex.py

@@ -0,0 +1,45 @@
+import json
+
+from linebot.v3.messaging import FlexMessage
+from mistletoe.block_token import Document
+
+from md2lineflex.flex_message_renderer import FlexMessageRenderer, LinkMode
+from md2lineflex.llm_utils import clean_llm_output
+
+
+def to_flex(md_text: str, link_mode: LinkMode = "button") -> FlexMessage:
+    """
+    統合型 Markdown -> LINE SDK FlexMessage 変換関数
+
+    1. Markdown text から FlexMessage オブジェクトを生成
+    2. LINE Bot SDK で送信
+       (flex_msg は linebot.v3.messaging.FlexMessage と互換性があります)
+
+    Example:
+        ```python
+        flex_msg = to_flex(md_text)
+        messaging_api.push_message(
+            PushMessageRequest(
+                to="USER_ID",
+                messages=[flex_msg]
+            )
+        )
+        ```
+    """
+    alt_text = clean_llm_output(md_text)
+
+    with FlexMessageRenderer(link_mode) as renderer:
+        # Document 全体の Bubble 構造（JSON文字列）を取得
+        json_str = renderer.render(Document(md_text.splitlines(keepends=True)))
+        bubble_dict = json.loads(json_str)
+
+        # FlexMessage 全体を dict 形式で組み立てて from_dict で変換する
+        # altText フィールドは 最大 400 文字らしい
+        flex_message_dict = {
+            "type": "flex",
+            "altText": alt_text.strip()[:400],
+            "contents": bubble_dict,
+        }
+
+        # from_dict を使うことで Pylance の引数不足エラーを回避
+        return FlexMessage.from_dict(flex_message_dict)

md2lineflex-0.1.0/src/md2lineflex/str_utils.py

@@ -0,0 +1,6 @@
+import json
+
+
+def to_json_utf8(data: dict | list[dict]) -> str:
+    """dict または list[dict] を UTF-8（日本語そのまま）の JSON 文字列に変換する"""
+    return json.dumps(data, ensure_ascii=False)

md2lineflex-0.1.0/src/md2lineflex/theme.py

@@ -0,0 +1,49 @@
+"""LINE Flex Message 用のテーマ・デザイン定数"""
+
+# ------------------------------------------------------------------------------
+# フォールバック定数
+# ------------------------------------------------------------------------------
+# LINE Flex Message 仕様（text の空文字禁止）を満たすための共通フォールバック定数
+EMPTY_CHAR = " "
+
+
+# ------------------------------------------------------------------------------
+# カラーパレット (Color Palette)
+# ------------------------------------------------------------------------------
+class Color:
+    # テキストカラー
+    HEADING = "#111111"  # 見出し・ヘッダー用（濃い黒）
+    BODY = "#333333"  # 本文・標準テキスト用
+    MUTED = "#888888"  # 補足・リスト記号用
+    QUOTE = "#555555"  # 引用テキスト用
+    CODE_INLINE = "#0052cc"  # インラインコード用 (Jira風アクセントブルー)
+    CODE_BLOCK_TEXT = "#f8f8f2"  # コードブロック文字色 (Monokai風)
+
+    # 背景色
+    BG_QUOTE = "#f8f9fa"  # 引用ブロック背景色
+    BG_CODE_BLOCK = "#272822"  # コードブロック背景色
+    BG_TABLE_HEADER = "#f0f0f0"  # 表ヘッダー背景色
+    BG_TABLE_BODY = "#ffffff"  # 表セル背景色
+    BG_TABLE_BORDER = "#e0e0e0"  # 表の外枠・区切り色
+
+    # ボーダー・区切り線
+    BORDER = "#cccccc"
+    SEPARATOR = "#e0e0e0"
+
+
+# ------------------------------------------------------------------------------
+# レイアウト・スタイル定数
+# ------------------------------------------------------------------------------
+class Size:
+    HEADING_H1 = "xl"
+    HEADING_H2 = "lg"
+    BODY = "sm"
+    CODE = "xs"
+    TABLE_CELL = "xs"
+
+
+class Margin:
+    HEADING = "lg"
+    PARAGRAPH = "md"
+    LIST_ITEM = "sm"
+    BLOCK = "md"