codewave-openclaw-installer 2.1.11 → 2.1.12

package/skills/ppt-master/scripts/svg_page_gen.py

@@ -0,0 +1,871 @@
+#!/usr/bin/env python3
+"""
+svg_page_gen.py v5 - Batch SVG page generator for PPT Master.
+13+ layout types aligned with v4 reference PPT design language.
+"""
+
+import json, sys, os, argparse, math, base64
+
+FONT = "Microsoft YaHei, PingFang SC, Helvetica, Arial, sans-serif"
+W, H = 1280, 720
+
+PRIMARY = "#003366"
+ACCENT_GOLD = "#D4AF37"
+TEXT_DARK = "#1A1A2E"
+TEXT_MID = "#64748B"
+TEXT_LIGHT = "#94A3B8"
+WHITE = "#FFFFFF"
+PANEL_BG = "#FFFFFF"
+PANEL_OPACITY = 0.88
+
+ACCENTS = ["#003366", "#00838F", "#2E7D32", "#C23531", "#6A1B9A", "#AD1457", "#E65100", "#37474F"]
+
+def esc(t):
+    if not t: return ""
+    return str(t).replace("&","&amp;").replace("<","&lt;").replace(">","&gt;")
+
+def load_bg(path):
+    if not path or not os.path.exists(path): return None
+    ext = os.path.splitext(path)[1].lower().lstrip(".")
+    mime = {"png":"image/png","jpg":"image/jpeg","jpeg":"image/jpeg","webp":"image/webp"}.get(ext,"image/png")
+    try:
+        with open(path,"rb") as f: d = base64.b64encode(f.read()).decode()
+    except IOError as e:
+        print(f"  Warning: Cannot read background image '{path}': {e}", file=sys.stderr)
+        return None
+    return f"data:{mime};base64,{d}"
+
+def bg_image(L, uri):
+    if uri:
+        L.append(f'<image href="{uri}" x="0" y="0" width="{W}" height="{H}" preserveAspectRatio="xMidYMid slice"/>')
+    else:
+        L.append(f'<defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1"><stop offset="0%" stop-color="#f0f4f8"/><stop offset="100%" stop-color="#e2e8f0"/></linearGradient></defs><rect width="{W}" height="{H}" fill="url(#bg)"/>')
+
+def page_footer(L, pname, pnum):
+    fy = H - 20
+    if pname:
+        L.append(f'<text x="{W/2}" y="{fy}" text-anchor="middle" font-family="{FONT}" font-size="9" fill="{TEXT_LIGHT}">{esc(pname)}</text>')
+    if pnum is not None:
+        L.append(f'<text x="{W-20}" y="{fy}" text-anchor="end" font-family="{FONT}" font-size="9" fill="{TEXT_LIGHT}">{pnum:02d}</text>')
+
+def page_title_bar(L, title):
+    L.append(f'<rect x="60" y="24" width="4" height="36" rx="2" fill="{PRIMARY}"/>')
+    L.append(f'<text x="76" y="50" font-family="{FONT}" font-size="22.5" font-weight="bold" fill="{PRIMARY}">{esc(title)}</text>')
+
+def panel(L, x, y, w, h, rx=10, opacity=PANEL_OPACITY, header_color=None, header_h=5):
+    L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{w:.1f}" height="{h:.1f}" rx="{rx}" fill="{PANEL_BG}" opacity="{opacity}"/>')
+    if header_color:
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{w:.1f}" height="{header_h}" rx="{min(rx, header_h)}" fill="{header_color}"/>')
+
+def _bullets(L, items, x, y, max_y, fs=10.5, color=TEXT_DARK, spacing=20):
+    for b in items:
+        if y + 12 > max_y: break
+        L.append(f'<text x="{x}" y="{y+10}" font-family="{FONT}" font-size="{fs}" fill="{color}">\u2022 {esc(b)}</text>')
+        y += spacing
+    return y
+
+# ==================== PAGE RENDERERS ====================
+
+def render_cover(pg, L, bg, pname):
+    bg_image(L, bg)
+    L.append(f'<rect width="{W}" height="{H}" fill="#000000" opacity="0.45"/>')
+    L.append(f'<rect x="80" y="200" width="4" height="200" rx="2" fill="{ACCENT_GOLD}"/>')
+    org = pg.get("organization","")
+    if org:
+        L.append(f'<text x="108" y="240" font-family="{FONT}" font-size="16.5" font-weight="bold" fill="{ACCENT_GOLD}">{esc(org)}</text>')
+    L.append(f'<text x="108" y="300" font-family="{FONT}" font-size="33" font-weight="bold" fill="{WHITE}">{esc(pg.get("title",""))}</text>')
+    sub = pg.get("subtitle","")
+    if sub:
+        L.append(f'<text x="108" y="345" font-family="{FONT}" font-size="21" fill="#E0E0E0">{esc(sub)}</text>')
+    L.append(f'<rect x="80" y="380" width="400" height="1" fill="{ACCENT_GOLD}"/>')
+    bidder = pg.get("bidder","")
+    if bidder:
+        L.append(f'<text x="108" y="420" font-family="{FONT}" font-size="15" fill="#E0E0E0">{esc(bidder)}</text>')
+    date = pg.get("date","")
+    if date:
+        L.append(f'<text x="108" y="450" font-family="{FONT}" font-size="13.5" fill="{TEXT_LIGHT}">{esc(date)}</text>')
+
+def render_toc(pg, L, bg, pname):
+    bg_image(L, bg)
+    page_title_bar(L, pg.get("title", "目录"))
+    items = pg.get("items", [])
+    cols = 2
+    per = math.ceil(len(items) / cols) if items else 1
+    gap, iw, ih = 12, (W - 120 - 12) / 2, 76
+    for i, item in enumerate(items):
+        col, row = i // per, i % per
+        x, y = 60 + col * (iw + gap), 80 + row * (ih + gap)
+        color = ACCENTS[i % len(ACCENTS)]
+        panel(L, x, y, iw, ih, 8, 0.9)
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="5" height="{ih}" rx="2" fill="{color}"/>')
+        L.append(f'<text x="{x+20}" y="{y+28}" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{color}">{esc(item.get("num",""))}</text>')
+        L.append(f'<text x="{x+52}" y="{y+28}" font-family="{FONT}" font-size="16" font-weight="bold" fill="{TEXT_DARK}">{esc(item.get("title",""))}</text>')
+        L.append(f'<text x="{x+52}" y="{y+52}" font-family="{FONT}" font-size="10.5" fill="{TEXT_MID}">{esc(item.get("desc",""))}</text>')
+    page_footer(L, pname, pg.get("page_num"))
+
+def render_chapter(pg, L, bg, pname):
+    bg_image(L, bg)
+    L.append(f'<rect width="{W}" height="{H}" fill="#000000" opacity="0.35"/>')
+    num = pg.get("chapter_num","01")
+    L.append(f'<text x="640" y="280" text-anchor="middle" font-family="{FONT}" font-size="100" font-weight="bold" fill="{PRIMARY}" opacity="0.15">{esc(num)}</text>')
+    L.append(f'<text x="640" y="370" text-anchor="middle" font-family="{FONT}" font-size="36" font-weight="bold" fill="{WHITE}">{esc(pg.get("title",""))}</text>')
+    sub = pg.get("subtitle","")
+    if sub:
+        L.append(f'<text x="640" y="410" text-anchor="middle" font-family="{FONT}" font-size="15" fill="#E0E0E0">{esc(sub)}</text>')
+    page_footer(L, pname, pg.get("page_num"))
+
+def render_ending(pg, L, bg, pname):
+    bg_image(L, bg)
+    L.append(f'<rect width="{W}" height="{H}" fill="#000000" opacity="0.35"/>')
+    L.append(f'<text x="640" y="270" text-anchor="middle" font-family="{FONT}" font-size="36" font-weight="bold" fill="{WHITE}">{esc(pg.get("title","感谢聆听"))}</text>')
+    sub = pg.get("subtitle","")
+    if sub:
+        L.append(f'<text x="640" y="315" text-anchor="middle" font-family="{FONT}" font-size="15" fill="#E0E0E0">{esc(sub)}</text>')
+    L.append(f'<rect x="540" y="335" width="200" height="2" rx="1" fill="{ACCENT_GOLD}" opacity="0.6"/>')
+    points = pg.get("points", pg.get("contacts",[]))
+    if points:
+        cols = min(len(points), 4)
+        pw = 160
+        sx = (W - cols * pw) / 2
+        for pi, pt in enumerate(points):
+            cx = sx + pi * pw + pw/2
+            L.append(f'<text x="{cx:.0f}" y="390" text-anchor="middle" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{ACCENT_GOLD}">{esc(pt)}</text>')
+
+# ==================== CONTENT LAYOUTS ====================
+
+def _layout_radial(L, sections):
+    """Center circle + left/right lists with connecting lines (v4 slide 2)."""
+    cx, cy, cr = W/2, H/2 - 20, 80
+    # Outer + inner circle
+    L.append(f'<circle cx="{cx}" cy="{cy}" r="{cr+10}" fill="none" stroke="{PRIMARY}" stroke-width="1.5" opacity="0.3"/>')
+    L.append(f'<circle cx="{cx}" cy="{cy}" r="{cr}" fill="{PRIMARY}" opacity="0.08"/>')
+    # Center label
+    center_text = sections[0].get("title","") if sections else ""
+    L.append(f'<text x="{cx}" y="{cy-5}" text-anchor="middle" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(center_text)}</text>')
+    center_sub = sections[0].get("subtitle","") if sections else ""
+    if center_sub:
+        L.append(f'<text x="{cx}" y="{cy+15}" text-anchor="middle" font-family="{FONT}" font-size="9.8" fill="{TEXT_MID}">{esc(center_sub)}</text>')
+    # Left items (sections[1] if exists)
+    left_items = sections[1].get("bullets",[]) if len(sections) > 1 else []
+    left_title = sections[1].get("title","") if len(sections) > 1 else ""
+    if left_title:
+        L.append(f'<text x="140" y="100" font-family="{FONT}" font-size="12" font-weight="bold" fill="{PRIMARY}">{esc(left_title)}</text>')
+    for i, item in enumerate(left_items[:6]):
+        iy = 130 + i * 42
+        color = ACCENTS[i % len(ACCENTS)]
+        panel(L, 60, iy, 240, 36, 6, 0.88, color, 4)
+        L.append(f'<text x="80" y="{iy+23}" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">{esc(item)}</text>')
+        # Connecting line
+        L.append(f'<line x1="300" y1="{iy+18}" x2="{cx-cr-10}" y2="{cy}" stroke="{TEXT_LIGHT}" stroke-width="0.8" opacity="0.5"/>')
+    # Right items
+    right_items = sections[2].get("bullets",[]) if len(sections) > 2 else []
+    right_title = sections[2].get("title","") if len(sections) > 2 else ""
+    if right_title:
+        L.append(f'<text x="{W-140}" y="100" text-anchor="end" font-family="{FONT}" font-size="12" font-weight="bold" fill="{PRIMARY}">{esc(right_title)}</text>')
+    for i, item in enumerate(right_items[:6]):
+        iy = 130 + i * 42
+        color = ACCENTS[(i+3) % len(ACCENTS)]
+        panel(L, W-300, iy, 240, 36, 6, 0.88, color, 4)
+        L.append(f'<text x="{W-280}" y="{iy+23}" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">{esc(item)}</text>')
+        L.append(f'<line x1="{W-300}" y1="{iy+18}" x2="{cx+cr+10}" y2="{cy}" stroke="{TEXT_LIGHT}" stroke-width="0.8" opacity="0.5"/>')
+
+def _layout_columns_n(L, sections, n=None):
+    """N equal vertical card columns with colored header + item lists (v4 slide 3)."""
+    ns = len(sections)
+    cols = n or min(ns, 5)
+    gap = 10
+    top_y = 80
+    # Optional banner
+    banner_sec = None
+    if sections and sections[0].get("is_banner"):
+        banner_sec = sections[0]
+        sections = sections[1:]
+        ns -= 1
+        cols = n or min(ns, 5)
+        panel(L, 60, 74, W-120, 42, 8, 0.85)
+        # Icon circle
+        L.append(f'<circle cx="88" cy="95" r="12" fill="{PRIMARY}" opacity="0.1"/>')
+        L.append(f'<text x="108" y="90" font-family="{FONT}" font-size="12" font-weight="bold" fill="{PRIMARY}">{esc(banner_sec.get("title",""))}</text>')
+        for bi, b in enumerate(banner_sec.get("bullets",[])[:2]):
+            L.append(f'<text x="108" y="{104+bi*14}" font-family="{FONT}" font-size="9.8" fill="{TEXT_MID}">{esc(b)}</text>')
+        top_y = 126
+    cw = (W - 120 - (cols-1)*gap) / cols
+    ch = H - top_y - 40
+    for si, sec in enumerate(sections[:cols]):
+        x = 60 + si * (cw + gap)
+        y = top_y
+        color = ACCENTS[si % len(ACCENTS)]
+        # Card with colored header
+        panel(L, x, y, cw, ch, 8, 0.88)
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{cw:.1f}" height="36" rx="8" fill="{color}"/>')
+        L.append(f'<rect x="{x:.1f}" y="{y+28:.1f}" width="{cw:.1f}" height="8" fill="{color}"/>')
+        # Header text
+        L.append(f'<text x="{x+cw/2:.1f}" y="{y+23}" text-anchor="middle" font-family="{FONT}" font-size="12" font-weight="bold" fill="{WHITE}">{esc(sec.get("title",""))}</text>')
+        # Items with separator lines
+        ty = y + 48
+        for bi, b in enumerate(sec.get("bullets",[])):
+            if ty + 14 > y + ch - 8: break
+            if bi > 0:
+                L.append(f'<line x1="{x+8}" y1="{ty-4}" x2="{x+cw-8}" y2="{ty-4}" stroke="#E0E0E0" stroke-width="0.5"/>')
+            L.append(f'<text x="{x+cw/2:.1f}" y="{ty+10}" text-anchor="middle" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">{esc(b)}</text>')
+            ty += 28
+
+def _layout_layers(L, sections):
+    """Horizontal stacked layers with optional left sidebar label (v4 slide 4)."""
+    ns = len(sections)
+    gap = 6
+    sidebar_w = 40
+    has_sidebar = any(s.get("sidebar_label") for s in sections)
+    lx = 60 + (sidebar_w if has_sidebar else 0)
+    lw = W - lx - 60
+    layer_h = (H - 100 - (ns-1)*gap) / ns
+    for si, sec in enumerate(sections):
+        y = 80 + si * (layer_h + gap)
+        color = ACCENTS[si % len(ACCENTS)]
+        # Layer band
+        panel(L, lx, y, lw, layer_h, 6, 0.88)
+        L.append(f'<rect x="{lx:.1f}" y="{y:.1f}" width="{lw:.1f}" height="5" rx="3" fill="{color}"/>')
+        # Layer title (centered top)
+        title = sec.get("title","")
+        L.append(f'<text x="{lx+lw/2:.1f}" y="{y+22}" text-anchor="middle" font-family="{FONT}" font-size="12" font-weight="bold" fill="{PRIMARY}">{esc(title)}</text>')
+        # Sub-items as horizontal pills
+        items = sec.get("bullets",[])
+        if items:
+            n_items = len(items)
+            pill_gap = 8
+            pill_w = min((lw - 20 - (n_items-1)*pill_gap) / n_items, 200)
+            total_pw = n_items * pill_w + (n_items-1) * pill_gap
+            px_start = lx + (lw - total_pw) / 2
+            py = y + 30
+            for pi, item in enumerate(items):
+                px = px_start + pi * (pill_w + pill_gap)
+                L.append(f'<rect x="{px:.1f}" y="{py:.1f}" width="{pill_w:.1f}" height="28" rx="5" fill="{color}" opacity="0.12"/>')
+                L.append(f'<text x="{px+pill_w/2:.1f}" y="{py+18}" text-anchor="middle" font-family="{FONT}" font-size="9.8" fill="{TEXT_DARK}">{esc(item)}</text>')
+        # Sidebar label
+        if has_sidebar and sec.get("sidebar_label"):
+            L.append(f'<text x="70" y="{y+layer_h/2}" font-family="{FONT}" font-size="10" fill="{PRIMARY}" transform="rotate(-90 70 {y+layer_h/2})">{esc(sec["sidebar_label"])}</text>')
+        # Arrow between layers
+        if si < ns - 1:
+            ay = y + layer_h + gap/2
+            L.append(f'<polygon points="{lx+lw/2-5},{ay-3} {lx+lw/2+5},{ay-3} {lx+lw/2},{ay+3}" fill="{TEXT_LIGHT}"/>')
+
+def _layout_left_detail_right_grid(L, sections):
+    """Left large detail panel + right 2x2 card grid (v4 slide 5)."""
+    left_w = (W - 140) * 0.38
+    ph = H - 120
+    # Left panel
+    panel(L, 60, 80, left_w, ph, 10, 0.88)
+    y = 108
+    if sections:
+        sec0 = sections[0]
+        # Icon area
+        L.append(f'<circle cx="88" cy="{y}" r="10" fill="{PRIMARY}" opacity="0.1"/>')
+        st = sec0.get("title","")
+        if st:
+            L.append(f'<text x="86" y="{y+26}" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(st)}</text>')
+            y += 36
+        for b in sec0.get("bullets",[]):
+            if y + 14 > 80 + ph - 8: break
+            L.append(f'<text x="86" y="{y+12}" font-family="{FONT}" font-size="11.2" fill="{TEXT_DARK}">\u2022 {esc(b)}</text>')
+            y += 24
+        # Subsection titles
+        sub_title = sec0.get("subtitle","")
+        if sub_title:
+            y += 12
+            L.append(f'<text x="86" y="{y+12}" font-family="{FONT}" font-size="12" font-weight="bold" fill="{PRIMARY}">{esc(sub_title)}</text>')
+            y += 24
+    # Right grid (2x2 or Nx2)
+    right_secs = sections[1:] if len(sections) > 1 else []
+    rx = 60 + left_w + 20
+    rw = W - rx - 60
+    n = len(right_secs)
+    cols = 2
+    rows = math.ceil(n / cols)
+    gap = 12
+    cw = (rw - (cols-1)*gap) / cols
+    ch = (ph - (rows-1)*gap) / rows
+    for si, sec in enumerate(right_secs):
+        col, row = si % cols, si // cols
+        cx = rx + col*(cw+gap)
+        cy = 80 + row*(ch+gap)
+        color = ACCENTS[(si+1) % len(ACCENTS)]
+        panel(L, cx, cy, cw, ch, 8, 0.88, color, 5)
+        # Icon placeholder
+        L.append(f'<circle cx="{cx+cw/2:.1f}" cy="{cy+24}" r="10" fill="{color}" opacity="0.15"/>')
+        st = sec.get("title","")
+        ty = cy + 42
+        if st:
+            L.append(f'<text x="{cx+14}" y="{ty}" font-family="{FONT}" font-size="12" font-weight="bold" fill="{PRIMARY}">{esc(st)}</text>')
+            ty += 22
+        for b in sec.get("bullets",[]):
+            if ty + 12 > cy + ch - 8: break
+            L.append(f'<text x="{cx+14}" y="{ty+10}" font-family="{FONT}" font-size="10.5" fill="{TEXT_MID}">{esc(b)}</text>')
+            ty += 20
+
+def _layout_tall_cards(L, sections):
+    """Tall vertical cards with icon area, big number, title, bullets (v4 slide 6)."""
+    ns = len(sections)
+    cols = min(ns, 4)
+    gap = 14
+    cw = (W - 120 - (cols-1)*gap) / cols
+    ch = H - 120
+    for si, sec in enumerate(sections[:cols]):
+        x = 60 + si * (cw + gap)
+        y = 80
+        color = ACCENTS[si % len(ACCENTS)]
+        panel(L, x, y, cw, ch, 8, 0.88)
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{cw:.1f}" height="5" rx="2" fill="{color}"/>')
+        # Icon circle
+        L.append(f'<circle cx="{x+cw/2:.1f}" cy="{y+40}" r="18" fill="{color}" opacity="0.1"/>')
+        # Big number (gold)
+        highlight = sec.get("highlight","")
+        ty = y + 72
+        if highlight:
+            L.append(f'<text x="{x+cw/2:.1f}" y="{ty+20}" text-anchor="middle" font-family="{FONT}" font-size="27" font-weight="bold" fill="{ACCENT_GOLD}">{esc(highlight)}</text>')
+            ty += 45
+        # Title
+        st = sec.get("title","")
+        if st:
+            L.append(f'<text x="{x+cw/2:.1f}" y="{ty+10}" text-anchor="middle" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(st)}</text>')
+            ty += 28
+        # Bullets
+        for b in sec.get("bullets",[]):
+            if ty + 12 > y + ch - 8: break
+            L.append(f'<text x="{x+14}" y="{ty+10}" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">\u2022 {esc(b)}</text>')
+            ty += 20
+        # Bottom subtitle
+        sub = sec.get("subtitle","")
+        if sub:
+            L.append(f'<text x="{x+cw/2:.1f}" y="{y+ch-12}" text-anchor="middle" font-family="{FONT}" font-size="9.8" fill="{TEXT_MID}">{esc(sub)}</text>')
+
+def _layout_grid(L, sections, cols=3, rows=None):
+    """Generic NxM card grid with icon + title + bullets (v4 slide 8 = 2x3, slide 12 = 2x2)."""
+    ns = len(sections)
+    if rows is None: rows = math.ceil(ns / cols)
+    gap = 14
+    cw = (W - 120 - (cols-1)*gap) / cols
+    ch = (H - 120 - (rows-1)*gap) / rows
+    for si, sec in enumerate(sections[:cols*rows]):
+        col, row = si % cols, si // cols
+        x = 60 + col*(cw+gap)
+        y = 80 + row*(ch+gap)
+        color = ACCENTS[si % len(ACCENTS)]
+        panel(L, x, y, cw, ch, 8, 0.88)
+        # Left accent bar
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="4" height="{ch:.1f}" rx="2" fill="{color}"/>')
+        # Icon placeholder
+        L.append(f'<rect x="{x+14}" y="{y+14}" width="28" height="28" rx="6" fill="{color}" opacity="0.12"/>')
+        # Title
+        st = sec.get("title","")
+        ty = y + 56
+        if st:
+            L.append(f'<text x="{x+14}" y="{y+36}" font-family="{FONT}" font-size="12" font-weight="bold" fill="{PRIMARY}">{esc(st)}</text>')
+        # Divider
+        L.append(f'<line x1="{x+10}" y1="{ty-6}" x2="{x+cw-10}" y2="{ty-6}" stroke="#E0E0E0" stroke-width="0.5"/>')
+        # Bullets
+        for b in sec.get("bullets",[]):
+            if ty + 12 > y + ch - 8: break
+            L.append(f'<text x="{x+14}" y="{ty+10}" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">\u2022 {esc(b)}</text>')
+            ty += 20
+
+def _layout_split_half(L, sections):
+    """Left/right 50-50 split panels, each with colored header bar + detail list (v4 slide 9)."""
+    gap = 14
+    pw = (W - 120 - gap) / 2
+    ph = H - 120
+    for si, sec in enumerate(sections[:2]):
+        x = 60 + si * (pw + gap)
+        y = 80
+        color = ACCENTS[si % len(ACCENTS)]
+        panel(L, x, y, pw, ph, 8, 0.88)
+        # Colored header bar
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{pw:.1f}" height="38" rx="8" fill="{color}"/>')
+        L.append(f'<rect x="{x:.1f}" y="{y+30:.1f}" width="{pw:.1f}" height="8" fill="{color}"/>')
+        # Header icon + title
+        L.append(f'<circle cx="{x+20}" cy="{y+19}" r="8" fill="{WHITE}" opacity="0.3"/>')
+        st = sec.get("title","")
+        L.append(f'<text x="{x+36}" y="{y+24}" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{WHITE}">{esc(st)}</text>')
+        # Items with labels + descriptions
+        ty = y + 52
+        for b in sec.get("bullets",[]):
+            if ty + 14 > y + ph - 8: break
+            if isinstance(b, dict):
+                label = b.get("label","")
+                desc = b.get("desc","")
+                L.append(f'<text x="{x+14}" y="{ty+12}" font-family="{FONT}" font-size="11.2" font-weight="bold" fill="{TEXT_DARK}">{esc(label)}</text>')
+                ty += 20
+                if desc:
+                    L.append(f'<text x="{x+20}" y="{ty+10}" font-family="{FONT}" font-size="10.5" fill="{TEXT_MID}">{esc(desc)}</text>')
+                    ty += 18
+                L.append(f'<line x1="{x+10}" y1="{ty+2}" x2="{x+pw-10}" y2="{ty+2}" stroke="#E0E0E0" stroke-width="0.5"/>')
+                ty += 8
+            else:
+                L.append(f'<text x="{x+14}" y="{ty+12}" font-family="{FONT}" font-size="11.2" fill="{TEXT_DARK}">{esc(b)}</text>')
+                ty += 24
+                L.append(f'<line x1="{x+10}" y1="{ty-4}" x2="{x+pw-10}" y2="{ty-4}" stroke="#E0E0E0" stroke-width="0.5"/>')
+
+def _layout_matrix_plus_metrics(L, sections):
+    """Top matrix/table area + bottom big-number cards (v4 slide 10)."""
+    # Top area: first section as matrix
+    top_h = (H - 120) * 0.48
+    bot_y = 80 + top_h + 14
+    bot_h = H - bot_y - 40
+    if sections:
+        sec0 = sections[0]
+        panel(L, 60, 80, W-120, top_h, 8, 0.88)
+        st = sec0.get("title","")
+        if st:
+            L.append(f'<text x="86" y="106" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(st)}</text>')
+        # Render bullets as labeled rows
+        ty = 124
+        for b in sec0.get("bullets",[]):
+            if ty + 14 > 80 + top_h - 8: break
+            if isinstance(b, dict):
+                label = b.get("label","")
+                items = b.get("items",[])
+                L.append(f'<text x="86" y="{ty+12}" font-family="{FONT}" font-size="11.2" fill="{TEXT_DARK}">{esc(label)}</text>')
+                # Render items as pills
+                px = 200
+                for item in items:
+                    pw_pill = min(len(str(item))*8+16, 120)
+                    L.append(f'<rect x="{px}" y="{ty}" width="{pw_pill}" height="22" rx="4" fill="{PRIMARY}" opacity="0.08"/>')
+                    L.append(f'<text x="{px+pw_pill/2:.0f}" y="{ty+15}" text-anchor="middle" font-family="{FONT}" font-size="9.8" fill="{TEXT_DARK}">{esc(item)}</text>')
+                    px += pw_pill + 8
+                ty += 30
+            else:
+                L.append(f'<text x="86" y="{ty+12}" font-family="{FONT}" font-size="11.2" fill="{TEXT_DARK}">\u2022 {esc(b)}</text>')
+                ty += 24
+    # Bottom: metric cards
+    bot_secs = sections[1:] if len(sections) > 1 else []
+    n = len(bot_secs)
+    cols = min(n, 3) if n > 0 else 3
+    gap = 14
+    mcw = (W - 120 - (cols-1)*gap) / cols
+    for mi, sec in enumerate(bot_secs[:cols]):
+        mx = 60 + mi * (mcw + gap)
+        color = ACCENTS[mi % len(ACCENTS)]
+        panel(L, mx, bot_y, mcw, bot_h, 8, 0.88)
+        L.append(f'<rect x="{mx:.1f}" y="{bot_y:.1f}" width="{mcw:.1f}" height="4" rx="2" fill="{color}"/>')
+        # Icon
+        L.append(f'<circle cx="{mx+mcw/2:.1f}" cy="{bot_y+24}" r="12" fill="{color}" opacity="0.12"/>')
+        # Big number
+        highlight = sec.get("highlight","")
+        L.append(f'<text x="{mx+mcw/2:.1f}" y="{bot_y+bot_h*0.5}" text-anchor="middle" font-family="{FONT}" font-size="27" font-weight="bold" fill="{ACCENT_GOLD}">{esc(highlight)}</text>')
+        # Label
+        L.append(f'<text x="{mx+mcw/2:.1f}" y="{bot_y+bot_h*0.68}" text-anchor="middle" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(sec.get("title",""))}</text>')
+        # Desc
+        desc = sec.get("subtitle","")
+        if desc:
+            L.append(f'<text x="{mx+mcw/2:.1f}" y="{bot_y+bot_h*0.82}" text-anchor="middle" font-family="{FONT}" font-size="9.8" fill="{TEXT_MID}">{esc(desc)}</text>')
+
+def _layout_zigzag_timeline(L, sections):
+    """Alternating up/down nodes on center timeline line (v4 slide 11)."""
+    ns = len(sections)
+    # Horizontal timeline line
+    line_y = H * 0.5
+    L.append(f'<line x1="80" y1="{line_y}" x2="{W-80}" y2="{line_y}" stroke="{TEXT_LIGHT}" stroke-width="1.5"/>')
+    step = (W - 200) / max(ns - 1, 1)
+    node_r = 8
+    card_w = min(step - 20, 150)
+    card_h = 140
+    for si, sec in enumerate(sections):
+        nx = 100 + si * step
+        is_up = si % 2 == 0
+        # Node dot
+        L.append(f'<circle cx="{nx:.0f}" cy="{line_y}" r="{node_r}" fill="{ACCENTS[si % len(ACCENTS)]}"/>')
+        L.append(f'<circle cx="{nx:.0f}" cy="{line_y}" r="{node_r-3}" fill="{WHITE}"/>')
+        # Vertical connector
+        if is_up:
+            cy = line_y - card_h - 20
+            L.append(f'<line x1="{nx:.0f}" y1="{line_y-node_r}" x2="{nx:.0f}" y2="{cy+card_h}" stroke="{TEXT_LIGHT}" stroke-width="1"/>')
+        else:
+            cy = line_y + 20
+            L.append(f'<line x1="{nx:.0f}" y1="{line_y+node_r}" x2="{nx:.0f}" y2="{cy}" stroke="{TEXT_LIGHT}" stroke-width="1"/>')
+        # Card
+        cx = nx - card_w/2
+        color = ACCENTS[si % len(ACCENTS)]
+        panel(L, cx, cy, card_w, card_h, 6, 0.88, color, 4)
+        # Phase name
+        L.append(f'<text x="{nx:.0f}" y="{cy+22}" text-anchor="middle" font-family="{FONT}" font-size="11" font-weight="bold" fill="{PRIMARY}">{esc(sec.get("title",""))}</text>')
+        # Bullets
+        ty = cy + 36
+        for b in sec.get("bullets",[]):
+            if ty + 12 > cy + card_h - 8: break
+            L.append(f'<text x="{cx+8}" y="{ty+10}" font-family="{FONT}" font-size="9.8" fill="{TEXT_DARK}">{esc(b)}</text>')
+            ty += 16
+        # Duration label
+        dur = sec.get("duration", sec.get("subtitle",""))
+        if dur:
+            L.append(f'<text x="{nx:.0f}" y="{cy+card_h-8}" text-anchor="middle" font-family="{FONT}" font-size="9" fill="{TEXT_MID}">{esc(dur)}</text>')
+
+def _layout_people_cards(L, sections):
+    """Horizontal people cards with avatar circle + role + bullets + bottom banner (v4 slide 13)."""
+    ns = len(sections)
+    # Check if last section is a banner
+    banner = None
+    if sections and sections[-1].get("is_banner"):
+        banner = sections[-1]
+        sections = sections[:-1]
+        ns -= 1
+    cols = min(ns, 4)
+    gap = 10
+    cw = (W - 120 - (cols-1)*gap) / cols
+    ch = H - 120 - (80 if banner else 0)
+    for si, sec in enumerate(sections[:cols]):
+        x = 60 + si * (cw + gap)
+        y = 80
+        color = ACCENTS[si % len(ACCENTS)]
+        panel(L, x, y, cw, ch, 8, 0.88)
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{cw:.1f}" height="4" rx="2" fill="{color}"/>')
+        # Avatar circle
+        acx = x + cw/2
+        L.append(f'<circle cx="{acx:.0f}" cy="{y+42}" r="26" fill="{color}" opacity="0.08" stroke="{color}" stroke-width="1.5"/>')
+        # Role title
+        L.append(f'<text x="{acx:.0f}" y="{y+84}" text-anchor="middle" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(sec.get("title",""))}</text>')
+        # Subtitle (experience)
+        sub = sec.get("subtitle","")
+        if sub:
+            L.append(f'<text x="{acx:.0f}" y="{y+102}" text-anchor="middle" font-family="{FONT}" font-size="10.5" fill="{color}">{esc(sub)}</text>')
+        # Bullets
+        ty = y + 116
+        for b in sec.get("bullets",[]):
+            if ty + 12 > y + ch - 8: break
+            L.append(f'<text x="{x+14}" y="{ty+10}" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">\u2022 {esc(b)}</text>')
+            ty += 20
+    # Bottom banner
+    if banner:
+        by = 80 + ch + 10
+        panel(L, 60, by, W-120, 60, 8, 0.88)
+        bt = banner.get("title","")
+        if bt:
+            L.append(f'<text x="{W/2}" y="{by+20}" text-anchor="middle" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(bt)}</text>')
+        items = banner.get("bullets",[])
+        n = len(items)
+        if n:
+            iw = (W - 160) / n
+            for bi, b in enumerate(items):
+                bx = 80 + bi * iw + iw/2
+                L.append(f'<text x="{bx:.0f}" y="{by+42}" text-anchor="middle" font-family="{FONT}" font-size="10.5" fill="{TEXT_MID}">{esc(b)}</text>')
+
+def _layout_case_cards(L, sections):
+    """3 tall case study cards with header, sections dividers, checkmark results (v4 slide 14)."""
+    ns = len(sections)
+    cols = min(ns, 3)
+    gap = 12
+    cw = (W - 120 - (cols-1)*gap) / cols
+    ch = H - 120
+    for si, sec in enumerate(sections[:cols]):
+        x = 60 + si * (cw + gap)
+        y = 80
+        color = ACCENTS[si % len(ACCENTS)]
+        panel(L, x, y, cw, ch, 8, 0.88)
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{cw:.1f}" height="4" rx="2" fill="{color}"/>')
+        # Icon + company name
+        L.append(f'<circle cx="{x+20}" cy="{y+24}" r="10" fill="{color}" opacity="0.12"/>')
+        L.append(f'<text x="{x+36}" y="{y+28}" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(sec.get("title",""))}</text>')
+        # Industry tag
+        sub = sec.get("subtitle","")
+        if sub:
+            L.append(f'<text x="{x+14}" y="{y+48}" font-family="{FONT}" font-size="9.8" fill="{TEXT_MID}">{esc(sub)}</text>')
+        # Divider
+        L.append(f'<line x1="{x+10}" y1="{y+56}" x2="{x+cw-10}" y2="{y+56}" stroke="#E0E0E0" stroke-width="0.5"/>')
+        # Sections (background, solution, results)
+        ty = y + 68
+        for b in sec.get("bullets",[]):
+            if ty + 14 > y + ch - 8: break
+            if isinstance(b, dict):
+                label = b.get("label","")
+                items = b.get("items",[])
+                L.append(f'<text x="{x+14}" y="{ty+10}" font-family="{FONT}" font-size="11.2" font-weight="bold" fill="{TEXT_DARK}">{esc(label)}</text>')
+                ty += 22
+                for item in items:
+                    if ty + 12 > y + ch - 8: break
+                    prefix = "\u2713 " if label.startswith("\u6210") or "result" in label.lower() else "\u2022 "
+                    L.append(f'<text x="{x+20}" y="{ty+10}" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">{prefix}{esc(item)}</text>')
+                    ty += 18
+                ty += 6
+            else:
+                L.append(f'<text x="{x+14}" y="{ty+10}" font-family="{FONT}" font-size="10.5" fill="{TEXT_DARK}">\u2022 {esc(b)}</text>')
+                ty += 20
+
+def _layout_metrics_grid(L, sections):
+    """2x3 or NxM grid of big number highlight cards (v4 slide 15)."""
+    ns = len(sections)
+    cols = min(ns, 3)
+    rows = math.ceil(ns / cols)
+    gap = 14
+    cw = (W - 120 - (cols-1)*gap) / cols
+    ch = (H - 120 - (rows-1)*gap) / rows
+    for si, sec in enumerate(sections[:cols*rows]):
+        col, row = si % cols, si // cols
+        x = 60 + col*(cw+gap)
+        y = 80 + row*(ch+gap)
+        color = ACCENTS[si % len(ACCENTS)]
+        panel(L, x, y, cw, ch, 10, 0.88)
+        L.append(f'<rect x="{x:.1f}" y="{y:.1f}" width="{cw:.1f}" height="4" rx="2" fill="{color}"/>')
+        # Icon
+        L.append(f'<circle cx="{x+cw/2:.1f}" cy="{y+ch*0.22}" r="14" fill="{color}" opacity="0.1"/>')
+        # Big number (gold)
+        highlight = sec.get("highlight","")
+        L.append(f'<text x="{x+cw/2:.1f}" y="{y+ch*0.48}" text-anchor="middle" font-family="{FONT}" font-size="27" font-weight="bold" fill="{ACCENT_GOLD}">{esc(highlight)}</text>')
+        # Label
+        L.append(f'<text x="{x+cw/2:.1f}" y="{y+ch*0.65}" text-anchor="middle" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(sec.get("title",""))}</text>')
+        # Desc
+        desc = sec.get("subtitle","")
+        if desc:
+            L.append(f'<text x="{x+cw/2:.1f}" y="{y+ch*0.8}" text-anchor="middle" font-family="{FONT}" font-size="9.8" fill="{TEXT_MID}">{esc(desc)}</text>')
+
+def _layout_full_width(L, sections):
+    """Single full-width panel with all sections stacked."""
+    pw, ph = W - 120, H - 120
+    panel(L, 60, 80, pw, ph, 10, 0.88)
+    y = 108
+    for sec in sections:
+        st = sec.get("title","")
+        if st:
+            L.append(f'<text x="86" y="{y+16}" font-family="{FONT}" font-size="13.5" font-weight="bold" fill="{PRIMARY}">{esc(st)}</text>')
+            y += 30
+        for b in sec.get("bullets",[]):
+            L.append(f'<text x="86" y="{y+12}" font-family="{FONT}" font-size="11.2" fill="{TEXT_DARK}">\u2022 {esc(b)}</text>')
+            y += 24
+        y += 16
+
+# ==================== SMART LAYOUT SELECTION ====================
+
+LAYOUT_MAP = {
+    "radial": _layout_radial,
+    "columns": _layout_columns_n,
+    "columns_5": lambda L, s: _layout_columns_n(L, s, 5),
+    "columns_4": lambda L, s: _layout_columns_n(L, s, 4),
+    "columns_3": lambda L, s: _layout_columns_n(L, s, 3),
+    "layers": _layout_layers,
+    "left_right": _layout_left_detail_right_grid,
+    "left_detail_right_grid": _layout_left_detail_right_grid,
+    "tall_cards": _layout_tall_cards,
+    "grid_2x3": lambda L, s: _layout_grid(L, s, 3, 2),
+    "grid_2x2": lambda L, s: _layout_grid(L, s, 2, 2),
+    "grid_3x2": lambda L, s: _layout_grid(L, s, 2, 3),
+    "split_half": _layout_split_half,
+    "matrix_metrics": _layout_matrix_plus_metrics,
+    "matrix_plus_metrics": _layout_matrix_plus_metrics,
+    "zigzag_timeline": _layout_zigzag_timeline,
+    "zigzag": _layout_zigzag_timeline,
+    "people_cards": _layout_people_cards,
+    "people": _layout_people_cards,
+    "case_cards": _layout_case_cards,
+    "cases": _layout_case_cards,
+    "metrics_grid": _layout_metrics_grid,
+    "full": _layout_full_width,
+}
+
+def _auto_select_layout(sections):
+    """Smart layout selection based on content structure."""
+    ns = len(sections)
+    has_highlights = any(s.get("highlight") for s in sections)
+    has_banners = any(s.get("is_banner") for s in sections)
+    has_sidebar = any(s.get("sidebar_label") for s in sections)
+    total_bullets = sum(len(s.get("bullets",[])) for s in sections)
+    has_dict_bullets = any(isinstance(b, dict) for s in sections for b in s.get("bullets",[]))
+    
+    # Specific patterns
+    if has_sidebar:
+        return "layers"
+    if has_highlights and ns >= 6:
+        return "metrics_grid"
+    if has_highlights and ns >= 3:
+        return "tall_cards"
+    if ns == 1:
+        return "full"
+    if ns == 2 and has_dict_bullets:
+        return "split_half"
+    if ns == 2 and total_bullets > 8:
+        return "left_right"
+    if ns == 2:
+        return "split_half"
+    if ns == 3 and has_highlights:
+        return "tall_cards"
+    if ns == 3 and total_bullets <= 12:
+        return "columns_3"
+    if ns == 3:
+        return "grid_2x3"  # Will show as 1x3
+    if ns == 4 and total_bullets <= 16:
+        return "grid_2x2"
+    if ns == 4:
+        return "tall_cards"
+    if ns == 5:
+        return "columns_5"
+    if ns == 6:
+        return "grid_2x3"
+    return "columns"
+
+def render_content(pg, L, bg, pname):
+    """Content page with 13+ layout modes, smart auto-selection."""
+    bg_image(L, bg)
+    page_title_bar(L, pg.get("title",""))
+    sections = pg.get("sections", [])
+    
+    # Optional subtitle banner
+    banner = pg.get("subtitle","")
+    if banner:
+        panel(L, 60, 68, W-120, 28, 6, 0.8)
+        L.append(f'<text x="80" y="87" font-family="{FONT}" font-size="10.5" fill="{PRIMARY}">{esc(banner)}</text>')
+    
+    layout = pg.get("layout", "auto")
+    if layout == "auto":
+        layout = _auto_select_layout(sections)
+    
+    renderer = LAYOUT_MAP.get(layout, _layout_full_width)
+    renderer(L, sections)
+    page_footer(L, pname, pg.get("page_num"))
+
+# Keep legacy renderers as aliases
+def render_cards(pg, L, bg, pname):
+    """Cards page -> delegates to content with cards layout."""
+    cards = pg.get("cards",[])
+    # Convert cards to sections format
+    sections = []
+    for c in cards:
+        desc = c.get("desc",[])
+        if isinstance(desc, str): desc = [desc]
+        sections.append({"title": c.get("title",""), "bullets": desc})
+    pg2 = dict(pg)
+    pg2["sections"] = sections
+    if not pg2.get("layout"):
+        pg2["layout"] = "columns"
+    render_content(pg2, L, bg, pname)
+
+def render_metrics(pg, L, bg, pname):
+    """Metrics page -> delegates to content with metrics_grid layout."""
+    metrics = pg.get("metrics",[])
+    sections = []
+    for m in metrics:
+        sections.append({"title": m.get("label",""), "highlight": m.get("value",""), "subtitle": m.get("desc","")})
+    pg2 = dict(pg)
+    pg2["sections"] = sections
+    pg2["layout"] = "metrics_grid"
+    render_content(pg2, L, bg, pname)
+
+def render_timeline(pg, L, bg, pname):
+    """Timeline -> delegates to content with zigzag_timeline layout."""
+    phases = pg.get("phases",[])
+    sections = []
+    for p in phases:
+        sections.append({"title": p.get("name",""), "bullets": [p.get("label","")] if p.get("label") else [], "duration": p.get("duration",""), "subtitle": p.get("duration","")})
+    pg2 = dict(pg)
+    pg2["sections"] = sections
+    pg2["layout"] = "zigzag_timeline"
+    render_content(pg2, L, bg, pname)
+
+def render_team(pg, L, bg, pname):
+    """Team -> delegates to content with people_cards layout."""
+    members = pg.get("members",[])
+    sections = []
+    for m in members:
+        s = {"title": m.get("role", m.get("name","")), "subtitle": m.get("exp",""), "bullets": []}
+        if m.get("name"): s["bullets"].append(m["name"])
+        if m.get("cert"): s["bullets"].append(m["cert"])
+        sections.append(s)
+    pg2 = dict(pg)
+    pg2["sections"] = sections
+    pg2["layout"] = "people_cards"
+    render_content(pg2, L, bg, pname)
+
+RENDERERS = {
+    "cover": render_cover, "toc": render_toc, "chapter": render_chapter,
+    "content": render_content, "cards": render_cards, "metrics": render_metrics,
+    "timeline": render_timeline, "team": render_team, "ending": render_ending,
+}
+
+def generate(pg, total, bg_uri, pname):
+    L = [f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {W} {H}" width="{W}" height="{H}">']
+    ptype = pg.get("type","content")
+    renderer = RENDERERS.get(ptype, render_content)
+    renderer(pg, L, bg_uri, pname)
+    L.append('</svg>')
+    return "\n".join(L)
+
+def main():
+    try:
+        _main_impl()
+    except KeyboardInterrupt:
+        print("\nInterrupted by user.")
+        sys.exit(130)
+    except SystemExit:
+        raise
+    except Exception as e:
+        print(f"Fatal error: {type(e).__name__}: {e}", file=sys.stderr)
+        sys.exit(1)
+
+def _main_impl():
+    p = argparse.ArgumentParser(description="PPT Master SVG Page Generator v5")
+    p.add_argument("input", help="JSON page definitions file")
+    p.add_argument("-o","--output", required=True, help="Output directory")
+    p.add_argument("--width", type=int, default=1280)
+    p.add_argument("--height", type=int, default=720)
+    p.add_argument("--bg", default=None, help="Background image file path (fallback)")
+    args = p.parse_args()
+
+    global W, H
+    W, H = args.width, args.height
+
+    try:
+        os.makedirs(args.output, exist_ok=True)
+    except OSError as e:
+        print(f"Error: Cannot create output directory '{args.output}': {e}", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        with open(args.input, "r", encoding="utf-8") as f:
+            spec = json.load(f)
+    except FileNotFoundError:
+        print(f"Error: Input file not found: {args.input}", file=sys.stderr)
+        sys.exit(1)
+    except json.JSONDecodeError as e:
+        print(f"Error: Invalid JSON in '{args.input}': {e}", file=sys.stderr)
+        sys.exit(1)
+    except IOError as e:
+        print(f"Error: Cannot read input file '{args.input}': {e}", file=sys.stderr)
+        sys.exit(1)
+
+    pages = spec.get("pages", [])
+    total = len(pages)
+    pname = spec.get("project_name", "")
+    global_bg_path = args.bg or spec.get("background_image")
+    global_bg_uri = load_bg(global_bg_path)
+    if global_bg_uri:
+        print(f"  BG   global: {global_bg_path} ({len(global_bg_uri)//1024}KB)")
+
+    gen_count = skip_count = fail_count = 0
+    failed_pages = []
+    for pg in pages:
+        fn = pg.get("file")
+        if not fn: continue
+        if pg.get("skip"):
+            skip_count += 1
+            print(f"  SKIP {fn}")
+            continue
+        try:
+            page_bg_path = pg.get("background_image")
+            bg_uri = load_bg(page_bg_path) if page_bg_path else global_bg_uri
+            svg = generate(pg, total, bg_uri, pname)
+            out_path = os.path.join(args.output, fn)
+            with open(out_path, "w", encoding="utf-8") as f:
+                f.write(svg)
+            gen_count += 1
+            layout = pg.get("layout","auto")
+            print(f"  OK   {fn} ({len(svg)} bytes) [{layout}]")
+        except IOError as e:
+            fail_count += 1
+            failed_pages.append(fn)
+            print(f"  FAIL {fn}: write error: {e}", file=sys.stderr)
+        except Exception as e:
+            fail_count += 1
+            failed_pages.append(fn)
+            print(f"  FAIL {fn}: {type(e).__name__}: {e}", file=sys.stderr)
+
+    print(f"\nDone: {gen_count} generated, {skip_count} skipped, {fail_count} failed, {total} total")
+    if failed_pages:
+        print(f"Failed pages: {', '.join(failed_pages)}", file=sys.stderr)
+
+if __name__ == "__main__":
+    main()