slidemark 0.1.0__py3-none-any.whl

slidemark/__init__.py

@@ -0,0 +1,8 @@
+"""SlideMark: token-efficient Markdown -> native, editable PowerPoint for AI agents."""
+
+from .build import build
+from .ir import Deck, Slide
+from .parser import parse
+
+__all__ = ["Deck", "Slide", "build", "parse"]
+__version__ = "0.1.0"

slidemark/build.py

@@ -0,0 +1,60 @@
+"""End-to-end pipeline: text -> Deck -> layout -> .pptx."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from .ir import Deck
+from .layout import layout_slide
+from .lint import lint_deck
+from .parser import parse
+from .template import deck_theme, template_size
+
+
+def build(source: str | Path, out: str | Path, *, base_dir: str | Path | None = None) -> Deck:
+    """Build a .pptx from text or a .md/.json/.html path. Returns the Deck (with diagnostics)."""
+    exts = (".md", ".json", ".html")
+    is_path = isinstance(source, Path) or ("\n" not in source and str(source).endswith(exts))
+    if is_path:
+        path = Path(source)
+        base_dir = base_dir or path.parent
+        if path.suffix == ".json":
+            from .jsonio import load_deck
+
+            deck = load_deck(path)
+            if any(d.rule == "bad-json" for d in deck.diagnostics):
+                return deck
+            return build_deck(deck, out, base_dir)
+        text = path.read_text(encoding="utf-8")
+    else:
+        text = str(source)
+    return build_deck(parse(text), out, base_dir)
+
+
+def build_deck(deck: Deck, out: str | Path, base_dir: str | Path | None = None) -> Deck:
+    """Layout + lint + render a parsed Deck. Lint findings already reported by layout are deduped."""
+    deck.attrs.setdefault("base_dir", str(base_dir or Path.cwd()))
+    theme, diags = deck_theme(deck, deck.attrs["base_dir"])
+    deck.diagnostics.extend(diags)
+    if size := template_size(theme):
+        deck.size = size  # the template's slide size wins
+    try:
+        placed = [layout_slide(slide, deck, theme, i) for i, slide in enumerate(deck.slides)]
+    finally:
+        if any(s.html is not None for s in deck.slides):
+            from .layout.htmlslide import close_shared
+
+            close_shared()  # one Playwright at a time: the renderer opens its own for pictures
+    seen = {(d.rule, d.slide) for d in deck.diagnostics}
+    deck.diagnostics.extend(d for d in lint_deck(deck, placed, theme) if (d.rule, d.slide) not in seen)
+    try:  # the per-slide fit map of `slidemark build` (fit.py): read off the layout result, never fatal
+        from .fit import fit_report
+
+        deck.attrs["fit_map"], sparse = fit_report(deck, placed, theme)
+        deck.diagnostics.extend(sparse)  # info `sparse`: a slide that stays empty after growth
+    except Exception:
+        deck.attrs.pop("fit_map", None)
+    from .render import render  # python-pptx loads only when a file is written
+
+    render(deck, placed, theme, out)
+    return deck