yumiamd 0.1.5 → 0.1.7

package/README.md

@@ -1,7 +1,7 @@
 # YumiaMD (`yumiamd`)
 
 > **A Markdown-based presentation language & compiler designed for humans and AI.**  
-> Author decks in clean Markdown and compile directly to **100% native, editable PowerPoint (.pptx)** presentations, vector PDFs, and interactive HTML5 slides.
+> Author slide decks in clean Markdown and compile directly to **100% native, editable PowerPoint (.pptx)** presentations, vector PDFs, and interactive HTML5 slides.
 
 [![npm version](https://img.shields.io/npm/v/yumiamd.svg?color=blue)](https://www.npmjs.com/package/yumiamd)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/biagio-scaglia/Yumia-MD/blob/main/LICENSE)
@@ -10,13 +10,13 @@
 
 ## ⚡ Quick Start (Zero Install)
 
-You can run YumiaMD immediately without installing anything:
+You can run YumiaMD immediately without installing anything via `npx`:
 
 ```bash
 # Initialize a starter presentation
 npx yumiamd init my-deck
 
-# Compile presentation to an editable PowerPoint (.pptx)
+# Compile presentation directly to an editable PowerPoint (.pptx)
 npx yumiamd build presentation.yumia.md --out presentation.pptx
 ```
 
@@ -44,7 +44,7 @@ pnpm add yumiamd
 
 ---
 
-## 🚀 CLI Commands
+## 🚀 CLI Commands & AI Tooling
 
 Once installed globally or locally, the `yumia` / `yumiamd` commands are available in your terminal:
 
@@ -52,16 +52,19 @@ Once installed globally or locally, the `yumia` / `yumiamd` commands are availab
 # Initialize a new presentation template
 yumia init my-presentation
 
-# Validate markdown syntax and AST structure
-yumia validate presentation.yumia.md
+# Validate markdown syntax and AST structure (supports --json for CI & AI agents)
+yumia validate presentation.yumia.md --json
 
 # Lint presentation for vertical overflow and layout issues
-yumia lint presentation.yumia.md
+yumia lint presentation.yumia.md --json
 
 # Inspect parsed AST and computed layout bounding boxes
 yumia inspect presentation.yumia.md --layout
 
-# Compile to PowerPoint (.pptx)
+# Export machine-readable JSON schema for LLMs & AI prompt generation
+yumia schema
+
+# Compile to native editable PowerPoint (.pptx)
 yumia build presentation.yumia.md --out dist/presentation.pptx
 ```
 
@@ -71,8 +74,9 @@ yumia build presentation.yumia.md --out dist/presentation.pptx
 
 ```markdown
 ---
-title: System Architecture & Workflow
+title: System Architecture & Capabilities
 theme: default
+aspectRatio: '16:9'
 author: Biagio Scaglia
 ---
 
@@ -109,37 +113,57 @@ Opening slide introducing the core architectural vision.
   :::
 
 :::
+
+---
+
+# Feature Comparison
+
+| 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              |
 ```
 
 ---
 
 ## 💻 JavaScript / TypeScript API
 
-You can also use `yumiamd` programmatically inside your Node.js or TypeScript backend / tools:
+You can also use `yumiamd` programmatically inside your Node.js or TypeScript backend, CLI tools, and AI pipelines:
 
 ```typescript
-import { compile, parse, layoutEngine } from 'yumiamd';
+import { compile, parse, YumiaCompiler } from 'yumiamd';
 import fs from 'node:fs';
 
 const markdown = fs.readFileSync('presentation.yumia.md', 'utf-8');
 
-// 1. Compile directly to PPTX buffer / file
+// 1. Validate syntax and collect diagnostics
+const compiler = new YumiaCompiler();
+const validation = compiler.validate(markdown);
+console.log(`Valid: ${validation.valid}, Slides: ${validation.slideCount}`);
+
+// 2. Compile directly to PPTX buffer
 const { buffer, errors } = await compile(markdown, { format: 'pptx' });
 
 if (errors.length === 0) {
   fs.writeFileSync('output.pptx', buffer);
   console.log('✅ Presentation generated successfully!');
 }
+
+// 3. Export JSON schema for LLM generation
+const schema = compiler.getSchema();
 ```
 
 ---
 
 ## ✨ Key Features
 
-- 🎯 **Native Object Principle**: Slides compiled to PowerPoint are **NOT** rasterized screenshot images. Headings, bullet points, cards, and speaker notes are generated as **100% native vector PowerPoint shapes & textboxes** that you can click, re-format, and edit in Microsoft PowerPoint or Google Slides.
-- 📐 **Deterministic Layout Engine**: Semantic multi-column grids, flex cards, and auto-spacing.
+- 🎯 **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"`).
+- 📐 **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.
+- 🤖 **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-MKQASLAK.js";
+} from "./chunk-GMIVPFBA.js";
 
 // src/bin.ts
 var result = await runCli(process.argv);