yumiamd 0.1.4 → 0.1.5

package/README.md

@@ -0,0 +1,148 @@
+# 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.
+
+[![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)
+
+---
+
+## ⚡ Quick Start (Zero Install)
+
+You can run YumiaMD immediately without installing anything:
+
+```bash
+# Initialize a starter presentation
+npx yumiamd init my-deck
+
+# Compile presentation to an editable PowerPoint (.pptx)
+npx yumiamd build presentation.yumia.md --out presentation.pptx
+```
+
+---
+
+## 📦 Installation
+
+### Global CLI Installation
+
+```bash
+npm install -g yumiamd
+# or
+pnpm add -g yumiamd
+# or
+yarn global add yumiamd
+```
+
+### Local Project Dependency
+
+```bash
+npm install yumiamd
+# or
+pnpm add yumiamd
+```
+
+---
+
+## 🚀 CLI Commands
+
+Once installed globally or locally, the `yumia` / `yumiamd` commands are available in your terminal:
+
+```bash
+# Initialize a new presentation template
+yumia init my-presentation
+
+# Validate markdown syntax and AST structure
+yumia validate presentation.yumia.md
+
+# Lint presentation for vertical overflow and layout issues
+yumia lint presentation.yumia.md
+
+# Inspect parsed AST and computed layout bounding boxes
+yumia inspect presentation.yumia.md --layout
+
+# Compile to PowerPoint (.pptx)
+yumia build presentation.yumia.md --out dist/presentation.pptx
+```
+
+---
+
+## 📝 Syntax Example (`presentation.yumia.md`)
+
+```markdown
+---
+title: System Architecture & Workflow
+theme: default
+author: Biagio Scaglia
+---
+
+# High-Performance Presentation Engine
+
+Deterministic compilation from Markdown directly to native PowerPoint slides.
+
+:::notes
+Opening slide introducing the core architectural vision.
+:::
+
+---
+
+# Architecture & Capabilities
+
+:::columns ratios="50:50"
+
+:::column
+:::card Core Engine
+
+- 100% Deterministic placement
+- Zero runtime dependencies
+- TypeScript-first architecture
+  :::
+  :::
+
+:::column
+:::card Native PowerPoint Export
+
+- Headings, cards, shapes & notes
+- Fully editable OpenXML objects
+- Compatible with PowerPoint & Google Slides
+  :::
+  :::
+
+:::
+```
+
+---
+
+## 💻 JavaScript / TypeScript API
+
+You can also use `yumiamd` programmatically inside your Node.js or TypeScript backend / tools:
+
+```typescript
+import { compile, parse, layoutEngine } from 'yumiamd';
+import fs from 'node:fs';
+
+const markdown = fs.readFileSync('presentation.yumia.md', 'utf-8');
+
+// 1. Compile directly to PPTX buffer / file
+const { buffer, errors } = await compile(markdown, { format: 'pptx' });
+
+if (errors.length === 0) {
+  fs.writeFileSync('output.pptx', buffer);
+  console.log('✅ Presentation generated successfully!');
+}
+```
+
+---
+
+## ✨ 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.
+- 🎨 **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.
+
+---
+
+## 📄 License
+
+MIT © [Biagio Scaglia](https://github.com/biagio-scaglia)

package/dist/bin.d.ts

@@ -1,3 +1 @@
 #!/usr/bin/env node
-export {};
-//# sourceMappingURL=bin.d.ts.map

package/dist/bin.js

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
-import { runCli } from './cli.js';
-const result = await runCli(process.argv);
+import {
+  runCli
+} from "./chunk-MKQASLAK.js";
+
+// src/bin.ts
+var result = await runCli(process.argv);
 if (result.output) {
-    if (result.exitCode === 0) {
-        console.log(result.output);
-    }
-    else {
-        console.error(result.output);
-    }
+  if (result.exitCode === 0) {
+    console.log(result.output);
+  } else {
+    console.error(result.output);
+  }
 }
 process.exit(result.exitCode);
-//# sourceMappingURL=bin.js.map