markup-plus 0.6.0__py3-none-any.whl

markup_plus/__init__.py

@@ -0,0 +1,23 @@
+"""
+Markup+ — A modern markup language with more features than Markdown.
+
+Features:
+    - Markdown-compatible syntax
+    - Variables, conditionals, loops
+    - Reusable components
+    - Charts (bar, line, pie, doughnut)
+    - Math formulas (KaTeX)
+    - Tabs, collapse, alerts, timeline
+    - Auto RTL detection (Persian, Arabic, Hebrew)
+    - Rich code blocks with copy/download/preview
+    - Light/dark themes
+"""
+
+__version__ = "0.6.0"
+__author__ = "Hossein Ataee"
+__license__ = "Markup+ — Non-Commercial License"
+
+from .renderer import to_html
+from .parser import parse_text
+
+__all__ = ["to_html", "parse_text", "__version__"]

markup_plus/__main__.py

@@ -0,0 +1,8 @@
+"""Entry point for `python -m markup_plus`."""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

markup_plus/ast.py

@@ -0,0 +1,260 @@
+"""
+Markup+ Abstract Syntax Tree (AST)
+
+Defines node types that represent the structure of a Markup+ document.
+"""
+
+from dataclasses import dataclass, field
+from typing import List, Dict, Optional, Any
+
+
+# ============================================================
+# Base
+# ============================================================
+
+@dataclass
+class Node:
+    """Base class for all AST nodes."""
+    line: int = 0
+
+
+# ============================================================
+# Block-level nodes
+# ============================================================
+
+@dataclass
+class Document(Node):
+    """Root node — contains all blocks + metadata + variables."""
+    children: List[Node] = field(default_factory=list)
+    meta: Dict[str, str] = field(default_factory=dict)
+    footnotes: Dict[str, str] = field(default_factory=dict)
+    variables: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class VariableDef(Node):
+    """@let name = value"""
+    name: str = ""
+    value: Any = None
+    raw_value: str = ""
+
+
+@dataclass
+class Heading(Node):
+    """# Heading 1, ## Heading 2, ### Heading 3"""
+    level: int = 1
+    text: str = ""
+    slug: str = ""
+
+
+@dataclass
+class Paragraph(Node):
+    """Regular paragraph."""
+    text: str = ""
+
+
+@dataclass
+class ListBlock(Node):
+    """Ordered or unordered list. `checked` for task lists."""
+    ordered: bool = False
+    items: List[str] = field(default_factory=list)
+    checked: List = field(default_factory=list)
+
+
+@dataclass
+class BlockQuote(Node):
+    """> Quoted text (can span multiple lines)"""
+    text: str = ""
+
+
+@dataclass
+class HorizontalRule(Node):
+    """--- separator"""
+    pass
+
+
+@dataclass
+class CodeBlock(Node):
+    """Fenced code block with advanced options."""
+    language: str = ""
+    code: str = ""
+    title: str = ""
+    copy: bool = True
+    download: bool = True
+    run: bool = False
+    share: bool = False
+    linenos: bool = False
+    highlight: List[int] = field(default_factory=list)
+    wrap: bool = False
+
+
+@dataclass
+class ImageBlock(Node):
+    """![alt](url "title"){options}"""
+    alt: str = ""
+    url: str = ""
+    title: str = ""
+    width: str = ""
+    height: str = ""
+    align: str = ""
+    link: str = ""
+    caption: str = ""
+    description: str = ""
+    zoomable: bool = True
+
+
+@dataclass
+class GalleryBlock(Node):
+    """@gallery {columns=N} ... @end"""
+    columns: int = 3
+    images: List[ImageBlock] = field(default_factory=list)
+    caption: str = ""
+
+
+@dataclass
+class TableBlock(Node):
+    """| Header | Header |"""
+    headers: List[str] = field(default_factory=list)
+    rows: List[List[str]] = field(default_factory=list)
+    alignments: List[str] = field(default_factory=list)
+
+
+@dataclass
+class TOCBlock(Node):
+    """@toc {title="..."}"""
+    title: str = "Table of Contents"
+
+
+# ============================================================
+# Control flow nodes (Phase 4)
+# ============================================================
+
+@dataclass
+class IfBlock(Node):
+    """@if ... @elif ... @else ... @endif"""
+    branches: List = field(default_factory=list)
+
+
+@dataclass
+class EachBlock(Node):
+    """@each item in items ... @end"""
+    item_name: str = ""
+    index_name: str = ""
+    iterable_expr: str = ""
+    children: List[Node] = field(default_factory=list)
+
+
+@dataclass
+class ImportBlock(Node):
+    """@import "path/to/file.mup" — reserved"""
+    path: str = ""
+
+
+# ============================================================
+# Rich features (Phase 5)
+# ============================================================
+
+@dataclass
+class ComponentDef(Node):
+    """@def Name(param1, param2) ... @end"""
+    name: str = ""
+    params: List[str] = field(default_factory=list)
+    children: List[Node] = field(default_factory=list)
+
+
+@dataclass
+class ComponentCall(Node):
+    """@Name(param1="value", param2="value")"""
+    name: str = ""
+    args: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class ChartBlock(Node):
+    """@chart(type="bar") data: [...] labels: [...] @end"""
+    chart_type: str = "bar"
+    data: List = field(default_factory=list)
+    labels: List[str] = field(default_factory=list)
+    title: str = ""
+    color: str = ""
+
+
+@dataclass
+class MathBlock(Node):
+    """$$ E = mc^2 $$"""
+    latex: str = ""
+    display: bool = True
+
+
+@dataclass
+class TabsBlock(Node):
+    """@tabs @tab "Title" ... @end @end"""
+    tabs: List = field(default_factory=list)
+
+
+@dataclass
+class CollapseBlock(Node):
+    """@collapse @item "Title" ... @end @end"""
+    items: List = field(default_factory=list)
+
+
+@dataclass
+class AlertBlock(Node):
+    """@note / @warning / @tip / @danger / @success ... @end"""
+    alert_type: str = "note"
+    children: List[Node] = field(default_factory=list)
+
+
+@dataclass
+class QuoteBlock(Node):
+    """@quote(author="...", source="...") Text... @end"""
+    author: str = ""
+    source: str = ""
+    text: str = ""
+
+
+@dataclass
+class TimelineBlock(Node):
+    """@timeline date: text @end"""
+    events: List = field(default_factory=list)
+
+
+# ============================================================
+# Inline-level nodes
+# ============================================================
+
+@dataclass
+class Text(Node):
+    content: str = ""
+
+
+@dataclass
+class Bold(Node):
+    content: str = ""
+
+
+@dataclass
+class Italic(Node):
+    content: str = ""
+
+
+@dataclass
+class InlineCode(Node):
+    content: str = ""
+
+
+@dataclass
+class Strikethrough(Node):
+    content: str = ""
+
+
+@dataclass
+class Link(Node):
+    text: str = ""
+    url: str = ""
+    title: str = ""
+
+
+@dataclass
+class AutoLink(Node):
+    url: str = ""

markup_plus/cli/__init__.py

@@ -0,0 +1,173 @@
+"""
+Markup+ CLI — Command-line interface.
+
+Provides the `mup` command.
+"""
+
+import sys
+
+from . import theme
+from .. import __version__
+
+
+HELP_TEXT = """
+╔══════════════════════════════════════════════════════════════╗
+║                         Markup+                              ║
+║           A modern markup language for everyone              ║
+╚══════════════════════════════════════════════════════════════╝
+
+USAGE
+    mup <command> [options]
+
+COMMANDS
+    mup <file>              Convert file to HTML
+    mup <file>.md           Convert Markdown to HTML
+    mup new <name>          Create a new .mup file
+    mup open <file>         View file in terminal
+    mup check <file>        Validate file for errors
+    mup init [name]         Create a new project
+
+OPTIONS
+    -d, --dark              Use dark theme
+    -l, --light             Use light theme (default)
+    -r, --rtl               Right-to-left layout
+        --ltr               Left-to-right layout
+    -o, --output <file>     Output file path
+        --css <file>        Apply custom CSS file
+        --debug             Show debug info
+    -h, --help              Show this help
+    -v, --version           Show version
+
+EXAMPLES
+    mup hello.mup                    Convert hello.mup
+    mup readme.md                    Convert markdown to HTML
+    mup hello.mup --dark             Dark theme
+    mup hello.mup --css theme.css    Custom CSS theme
+    mup hello.mup --debug            Show debug info
+    mup new my-doc                   Create my-doc.mup
+    mup open hello.mup               View in terminal
+    mup check hello.mup              Validate file
+"""
+
+
+def main() -> int:
+    """Main CLI entry point."""
+    args = sys.argv[1:]
+
+    # No arguments — show help
+    if not args:
+        print(HELP_TEXT)
+        return 0
+
+    # Parse global flags
+    show_help = False
+    show_version = False
+    dark = False
+    light = False
+    rtl = False
+    ltr = False
+    show_debug = False
+    output = None
+    css_file = None
+
+    remaining = []
+    i = 0
+    while i < len(args):
+        arg = args[i]
+
+        if arg in ("-h", "--help"):
+            show_help = True
+        elif arg in ("-v", "--version"):
+            show_version = True
+        elif arg in ("-d", "--dark"):
+            dark = True
+        elif arg in ("-l", "--light"):
+            light = True
+        elif arg in ("-r", "--rtl"):
+            rtl = True
+        elif arg == "--ltr":
+            ltr = True
+        elif arg == "--debug":
+            show_debug = True
+        elif arg == "--css":
+            if i + 1 < len(args):
+                css_file = args[i + 1]
+                i += 1
+            else:
+                print(theme.error("Error: --css requires a file path"))
+                return 1
+        elif arg in ("-o", "--output"):
+            if i + 1 < len(args):
+                output = args[i + 1]
+                i += 1
+            else:
+                print(theme.error("Error: --output requires a value"))
+                return 1
+        else:
+            remaining.append(arg)
+
+        i += 1
+
+    # Handle --help / --version
+    if show_help:
+        print(HELP_TEXT)
+        return 0
+
+    if show_version:
+        print(f"Markup+ v{__version__}")
+        return 0
+
+    # Determine theme
+    theme_name = "dark" if dark else "light"
+
+    # Determine direction
+    direction = None
+    if rtl:
+        direction = "rtl"
+    elif ltr:
+        direction = "ltr"
+
+    # No command
+    if not remaining:
+        print(HELP_TEXT)
+        return 0
+
+    # Dispatch commands
+    command = remaining[0]
+    command_args = remaining[1:]
+
+    from . import commands
+
+    if command == "new":
+        if not command_args:
+            print(theme.error("Error: 'new' requires a name"))
+            print(theme.dim("Usage: mup new <name>"))
+            return 1
+        return commands.new_file(command_args[0])
+
+    if command == "open":
+        if not command_args:
+            print(theme.error("Error: 'open' requires a file"))
+            print(theme.dim("Usage: mup open <file>"))
+            return 1
+        return commands.open_file(command_args[0])
+
+    if command == "check":
+        if not command_args:
+            print(theme.error("Error: 'check' requires a file"))
+            print(theme.dim("Usage: mup check <file>"))
+            return 1
+        return commands.check_file(command_args[0])
+    if command == "init":
+        name = command_args[0] if command_args else None
+        return commands.init_project(name)
+
+    # Default: treat as file path
+    return commands.build_file(
+        command,
+        theme_name=theme_name,
+        direction=direction,
+        output=output,
+        show_debug=show_debug,
+        css_file=css_file,
+    )

markup_plus/cli/__main__.py

@@ -0,0 +1,8 @@
+"""Entry point for `python -m markup_plus.cli`."""
+
+import sys
+
+from . import main
+
+if __name__ == "__main__":
+    sys.exit(main())