yumiamd 0.1.16 → 0.1.18

package/README.md

@@ -16,6 +16,9 @@ You can run YumiaMD immediately without installing anything via `npx`:
 # Initialize a starter presentation
 npx yumiamd init my-deck
 
+# Launch instant dev server with live-reload
+npx yumiamd dev presentation.yumia.md --open
+
 # Compile presentation directly to an editable PowerPoint (.pptx)
 npx yumiamd build presentation.yumia.md --out presentation.pptx
 ```
@@ -64,6 +67,9 @@ yumia build presentation.yumia.md --format pdf --out dist/presentation.pdf
 # Compile to standalone interactive HTML5 presentation deck (.html)
 yumia build presentation.yumia.md --format html --out dist/presentation.html
 
+# Deploy presentation deck (static, GitHub Pages, or Vercel)
+yumia deploy presentation.yumia.md --provider gh-pages --out public
+
 # Watch presentation file and recompile automatically on save
 yumia watch presentation.yumia.md --format pdf
 
@@ -96,6 +102,9 @@ author: Biagio Scaglia
 
 Deterministic compilation from Markdown directly to native PowerPoint slides.
 
+:::badge text="v0.1.15" variant="primary" :::
+:::badge text="Multi-Target" variant="success" :::
+
 :::notes
 Opening slide introducing the core architectural vision.
 :::
@@ -128,14 +137,26 @@ Opening slide introducing the core architectural vision.
 
 ---
 
-# Feature Comparison
+# Native Charts & Data Visuals
+
+:::chart type="bar" title="Execution Speed" labels="Parser, Layout, PDF, PPTX" data="1200, 850, 430, 680"
+
+---
+
+# Roadmap Timeline
+
+:::timeline layout="horizontal"
+
+- [Phase 1] AST & Compiler Core
+- [Phase 2] Multi-Format Renderers
+- [Phase 3] Rich Directives & Charts
+- [Phase 4] Cloud Deployments
+  :::
+
+:::step
 
-| Feature                  | YumiaMD                          | Legacy HTML Deck Tools               |
-| :----------------------- | :------------------------------- | :----------------------------------- |
-| **Output Type**          | Native OpenXML Shapes & Text     | Flat rasterized images / screenshots |
-| **Full Editability**     | ✅ 100% Editable in PowerPoint   | ❌ Read-only image slides            |
-| **Deterministic Layout** | ✅ Pixel-exact bounding boxes    | ❌ Browser rendering variance        |
-| **AI / Agent Tooling**   | ✅ Machine-readable schema & CLI | ❌ Complex DOM scraping              |
+- 🚀 Seamless deployment via `yumia deploy`
+  :::
 ```
 
 ---
@@ -171,8 +192,10 @@ const schema = compiler.getSchema();
 
 ## ✨ Key Features
 
-- 🎯 **Native Object Principle**: Slides compiled to PowerPoint are **NOT** rasterized screenshot images. Headings, bullet points, cards, tables, and speaker notes are generated as **100% native vector PowerPoint shapes, tables & textboxes** that you can click, re-format, and edit in Microsoft PowerPoint or Google Slides.
-- 📊 **Native Tables & Multicolumn**: Full support for Markdown tables and semantic responsive multi-column layouts with customizable ratio splits (`ratios="50:50"` or `"30:70"`).
+- 🎯 **Native Object Principle**: Slides compiled to PowerPoint are **NOT** rasterized screenshot images. Headings, bullet points, cards, tables, charts, badges, and speaker notes are generated as **100% native vector PowerPoint shapes, tables & textboxes** that you can click, re-format, and edit in Microsoft PowerPoint or Google Slides.
+- 📊 **Native Charts & Diagrams**: Full support for `:::chart` (bar, line, pie, doughnut) and `:::mermaid` diagrams across HTML, PDF, and PowerPoint.
+- ⏳ **Timelines, Compare & Steps**: Rich layout directives including `:::timeline`, `:::compare`, and click-to-reveal `:::step` animations.
+- 🚀 **One-Command Cloud Deploy**: Instantly deploy decks to GitHub Pages, Vercel, or static web servers with `yumia deploy`.
 - 📐 **Deterministic Layout Engine**: Exact coordinate calculations for stack, columns, cards, and automatic overflow detection.
 - 🎨 **Semantic Design Tokens**: Built-in themes with typography scales, color palettes, and contrast-safe themes.
 - 🤖 **AI-Friendly Format**: Clean Markdown syntax designed for LLM prompts and agentic workflows, complete with `yumia schema` and `--json` CLI diagnostics.

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-UPUEFJLX.js";
+} from "./chunk-SP4B4UF7.js";
 
 // src/bin.ts
 var result = await runCli(process.argv);

package/dist/{chunk-UPUEFJLX.js → chunk-SP4B4UF7.js}

@@ -475,7 +475,9 @@ var DefaultYumiaParser = class {
         let closed = false;
         while (i < lines.length) {
           const innerLine = lines[i]?.trim() ?? "";
-          const isSingleLine = innerLine.startsWith(":::metric") || innerLine.startsWith(":::layout") || innerLine.startsWith(":::badge") && (innerLine.includes("text=") || innerLine.includes("variant=")) || innerLine.startsWith(":::chart") && innerLine.includes("data=");
+          const isInlineClosed = innerLine.startsWith(":::") && innerLine.endsWith(":::") && innerLine.length > 5;
+          const isSeparator = innerLine === ":::vs" || innerLine.startsWith(":::vs ");
+          const isSingleLine = isInlineClosed || isSeparator || innerLine.startsWith(":::metric") || innerLine.startsWith(":::layout") || innerLine.startsWith(":::badge") && (innerLine.includes("text=") || innerLine.includes("variant=")) || innerLine.startsWith(":::chart") && innerLine.includes("data=");
           if (innerLine.startsWith(":::") && innerLine.length > 3 && !isSingleLine) {
             nestedCount++;
           } else if (innerLine === ":::") {
@@ -695,7 +697,9 @@ var DefaultYumiaParser = class {
         let nestedCount = 1;
         while (i < lines.length) {
           const innerLine = lines[i]?.trim() ?? "";
-          const isSingleLine = innerLine.startsWith(":::metric") || innerLine.startsWith(":::layout");
+          const isInlineClosed = innerLine.startsWith(":::") && innerLine.endsWith(":::") && innerLine.length > 5;
+          const isSeparator = innerLine === ":::vs" || innerLine.startsWith(":::vs ");
+          const isSingleLine = isInlineClosed || isSeparator || innerLine.startsWith(":::metric") || innerLine.startsWith(":::layout") || innerLine.startsWith(":::badge") && (innerLine.includes("text=") || innerLine.includes("variant=")) || innerLine.startsWith(":::chart") && innerLine.includes("data=");
           if (innerLine.startsWith(":::") && innerLine.length > 3 && !isSingleLine) {
             nestedCount++;
           } else if (innerLine === ":::") {
@@ -2096,6 +2100,30 @@ var YumiaCompiler = class {
         directives: {
           type: "object",
           properties: {
+            chart: {
+              syntax: ':::chart type="bar|line|pie|doughnut" title="..." labels="..." data="..."',
+              description: "Native editable chart for PowerPoint, PDF vector paths, and interactive SVG"
+            },
+            mermaid: {
+              syntax: ":::mermaid\\ngraph LR\\n  A --> B\\n:::",
+              description: "Flowcharts, sequence diagrams, and architecture maps via Mermaid"
+            },
+            timeline: {
+              syntax: ':::timeline [layout="horizontal|vertical"]\\n- [Date] Title: Description\\n:::',
+              description: "Roadmap and milestone timeline nodes with connector lines"
+            },
+            compare: {
+              syntax: ':::compare left="Left Title" right="Right Title"\\n- Left Item\\n:::vs\\n- Right Item\\n:::',
+              description: "Side-by-side comparison boxes with versus badge"
+            },
+            badge: {
+              syntax: ':::badge text="..." [variant="primary|success|warning|danger|info|accent"] :::',
+              description: "Compact inline status pill element"
+            },
+            step: {
+              syntax: ":::step\\nProgressive reveal content\\n:::",
+              description: "Click-to-reveal fragment step animation"
+            },
             columns: {
               syntax: ':::columns [ratios="50:50"]\\n:::column\\n...\\n:::\\n:::',
               description: "Multi-column grid layout"
@@ -2126,6 +2154,16 @@ var YumiaCompiler = class {
     };
   }
 };
+var defaultCompiler = new YumiaCompiler();
+function parse(source, options) {
+  return defaultCompiler.parse(source, options);
+}
+function validate(source) {
+  return defaultCompiler.validate(source);
+}
+function lint(sourceOrPresentation, options) {
+  return defaultCompiler.lint(sourceOrPresentation, options);
+}
 
 // ../renderer-pptx/dist/renderer.js
 import pptxgen from "pptxgenjs";
@@ -2919,10 +2957,42 @@ var HtmlRenderer = class {
   <title>${this.escapeHtml(title)}</title>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;600&family=Outfit:wght@600;700;800&display=swap" rel="stylesheet">
   <script type="module">
     import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
-    mermaid.initialize({ startOnLoad: true, theme: 'dark', securityLevel: 'loose' });
+    try {
+      mermaid.initialize({
+        startOnLoad: false,
+        theme: 'dark',
+        securityLevel: 'loose',
+        themeVariables: {
+          darkMode: true,
+          background: '${theme.colors.background}',
+          primaryColor: '${theme.colors.primary}',
+          primaryTextColor: '#ffffff',
+          primaryBorderColor: '${theme.colors.primary}',
+          lineColor: '${theme.colors.accent || theme.colors.primary}',
+          secondaryColor: '${theme.colors.surface}',
+          tertiaryColor: '${theme.colors.surface}'
+        }
+      });
+      window.mermaid = mermaid;
+      window.renderMermaidInSlide = async function(slideEl) {
+        if (!slideEl || !window.mermaid) return;
+        const nodes = Array.from(slideEl.querySelectorAll('.mermaid:not([data-processed="true"])'));
+        if (nodes.length > 0) {
+          try {
+            await window.mermaid.run({ nodes: nodes });
+          } catch (e) {
+            console.warn('Mermaid render notice:', e);
+          }
+        }
+      };
+      // Auto-render visible slide if present
+      const cur = document.querySelector('.yumia-slide-wrapper.active');
+      if (cur) window.renderMermaidInSlide(cur);
+    } catch (err) {
+      console.warn('Mermaid load notice:', err);
+    }
   </script>
   <style>
     :root {
@@ -3449,14 +3519,36 @@ var HtmlRenderer = class {
     /* Mermaid Container */
     .mermaid-container {
       background: rgba(10, 10, 18, 0.6);
-      border: 1px solid var(--yumia-border);
+      border: 1.5px solid var(--yumia-border);
       border-radius: var(--yumia-radius-card);
-      padding: 1rem;
+      padding: 1.5rem;
       margin: 1rem 0;
       display: flex;
       justify-content: center;
+      align-items: center;
       overflow: auto;
       width: 100%;
+      min-height: 240px;
+    }
+
+    .mermaid-container pre.mermaid,
+    .mermaid-container .mermaid {
+      background: transparent !important;
+      border: none !important;
+      padding: 0 !important;
+      margin: 0 !important;
+      font-size: 1rem;
+      color: #fff;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      width: 100%;
+    }
+
+    .mermaid-container svg {
+      max-width: 100%;
+      height: auto;
+      max-height: 420px;
     }
 
     /* Progressive Reveal (Step Builds) */
@@ -3783,6 +3875,12 @@ var HtmlRenderer = class {
         if (broadcast && syncChannel) {
           syncChannel.postMessage({ index: currentIdx });
         }
+
+        setTimeout(() => {
+          if (window.renderMermaidInSlide && slides[currentIdx]) {
+            window.renderMermaidInSlide(slides[currentIdx]);
+          }
+        }, 50);
       }
 
       function openSpeakerWindow() {
@@ -3887,6 +3985,13 @@ var HtmlRenderer = class {
             const rawNotes = slides[currentIdx].getAttribute('data-notes');
             notesBox.innerHTML = rawNotes ? rawNotes : '<em style="color:var(--yumia-muted);">No notes provided for this slide.</em>';
           }
+
+          setTimeout(() => {
+            if (window.renderMermaidInSlide) {
+              if (curBox) window.renderMermaidInSlide(curBox);
+              if (nextBox) window.renderMermaidInSlide(nextBox);
+            }
+          }, 50);
         }
 
         window.addEventListener('keydown', (e) => {
@@ -4753,7 +4858,7 @@ function startDevServer(filePath, options = {}) {
 // src/cli.ts
 import { mkdirSync, readFileSync as readFileSync2, watch as fsWatch, writeFileSync } from "fs";
 import { basename, dirname, extname, join, resolve as resolve2 } from "path";
-var VERSION = "0.1.16";
+var VERSION = "0.1.18";
 function printHelp() {
   return `
 YumiaMD \u2014 Markdown-based presentation compiler (v${VERSION})
@@ -5306,6 +5411,9 @@ export {
   createTheme,
   YumiaLinter,
   YumiaCompiler,
+  parse,
+  validate,
+  lint,
   cleanFontFace,
   parseInlineMarkdown,
   PptxRenderer,

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export * from '@yumiamd/renderer-pptx';
 export * from '@yumiamd/renderer-html';
 export * from '@yumiamd/renderer-pdf';
 
-declare const VERSION = "0.1.16";
+declare const VERSION = "0.1.18";
 declare function printHelp(): string;
 declare function runCli(argv: string[]): Promise<{
     exitCode: number;

package/dist/index.js

@@ -36,15 +36,18 @@ import {
   createTimeline,
   cyberpunkTheme,
   defaultTheme,
+  lint,
   minimalTheme,
+  parse,
   parseInlineMarkdown,
   parseYumia,
   printHelp,
   resolveTheme,
   runCli,
   startDevServer,
-  terminalTheme
-} from "./chunk-UPUEFJLX.js";
+  terminalTheme,
+  validate
+} from "./chunk-SP4B4UF7.js";
 export {
   DEFAULT_VIEWPORT,
   DefaultLayoutEngine,
@@ -83,12 +86,15 @@ export {
   createTimeline,
   cyberpunkTheme,
   defaultTheme,
+  lint,
   minimalTheme,
+  parse,
   parseInlineMarkdown,
   parseYumia,
   printHelp,
   resolveTheme,
   runCli,
   startDevServer,
-  terminalTheme
+  terminalTheme,
+  validate
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yumiamd",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Command line interface and compiler for YumiaMD presentations",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,15 +21,15 @@
   },
   "devDependencies": {
     "tsup": "^8.5.1",
-    "@yumiamd/core": "0.1.16",
-    "@yumiamd/renderer": "0.1.16",
-    "@yumiamd/ast": "0.1.16",
-    "@yumiamd/layout": "0.1.16",
-    "@yumiamd/parser": "0.1.16",
-    "@yumiamd/renderer-html": "0.1.16",
-    "@yumiamd/renderer-pptx": "0.1.16",
-    "@yumiamd/theme": "0.1.16",
-    "@yumiamd/renderer-pdf": "0.1.16"
+    "@yumiamd/ast": "0.1.18",
+    "@yumiamd/renderer": "0.1.18",
+    "@yumiamd/layout": "0.1.18",
+    "@yumiamd/core": "0.1.18",
+    "@yumiamd/theme": "0.1.18",
+    "@yumiamd/renderer-html": "0.1.18",
+    "@yumiamd/parser": "0.1.18",
+    "@yumiamd/renderer-pptx": "0.1.18",
+    "@yumiamd/renderer-pdf": "0.1.18"
   },
   "keywords": [
     "yumia",