yumiamd 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Biagio Scaglia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.d.ts

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

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

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

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACpC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+export declare const VERSION = "0.1.2";
+export declare function printHelp(): string;
+export declare function runCli(argv: string[]): {
+    exitCode: number;
+    output: string;
+};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,wBAAgB,SAAS,IAAI,MAAM,CAmBlC;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA+K3E"}

package/dist/cli.js

@@ -0,0 +1,187 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseYumia } from '@biagioscaglia/yumia-parser';
+import { DefaultLayoutEngine } from '@biagioscaglia/yumia-layout';
+export const VERSION = '0.1.2';
+export function printHelp() {
+    return `
+YumiaMD — Markdown-based presentation compiler (v${VERSION})
+
+Usage:
+  yumia <command> [options] [file]
+
+Commands:
+  init [name]        Scaffold a new YumiaMD presentation project
+  validate <file>    Validate a .yumia.md presentation syntax and structure
+  lint <file>        Analyze presentation for layout overflows and accessibility
+  inspect <file>     Inspect the AST and geometric layout tree
+  build <file>       Compile a presentation to target formats (planned)
+
+Options:
+  --layout           Show computed geometric bounding boxes in 'inspect'
+  -h, --help         Show this help message
+  -v, --version      Show CLI version
+`.trim();
+}
+export function runCli(argv) {
+    const args = argv.slice(2);
+    if (args.length === 0 || args.includes('-h') || args.includes('--help')) {
+        return { exitCode: 0, output: printHelp() };
+    }
+    if (args.includes('-v') || args.includes('--version')) {
+        return { exitCode: 0, output: `yumia v${VERSION}` };
+    }
+    const command = args[0];
+    const target = args[1];
+    if (command === 'init') {
+        const projectName = target || 'yumia-deck';
+        const projectDir = join(process.cwd(), projectName);
+        try {
+            mkdirSync(projectDir, { recursive: true });
+            mkdirSync(join(projectDir, 'assets'), { recursive: true });
+            mkdirSync(join(projectDir, 'themes'), { recursive: true });
+            const sampleContent = `---
+title: ${projectName}
+theme: default
+---
+
+# ${projectName}
+Presentation authoring with YumiaMD.
+
+:::notes
+Opening slide introducing the project.
+:::
+
+---
+
+# Architecture
+
+:::columns ratios="50:50"
+
+:::column
+:::card Philosophy
+- Plain Markdown source
+- Semantic directives
+:::
+:::
+
+:::column
+:::card Output
+- Native editable PPTX
+- Clean vector PDF
+:::
+:::
+
+:::
+`.trim();
+            writeFileSync(join(projectDir, 'presentation.yumia.md'), sampleContent, 'utf-8');
+            return {
+                exitCode: 0,
+                output: `✓ Created presentation project '${projectName}' at ./${projectName}\n  Edit ./${projectName}/presentation.yumia.md to get started!`,
+            };
+        }
+        catch (err) {
+            return {
+                exitCode: 1,
+                output: `✗ Initialization failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    if (command === 'validate') {
+        if (!target) {
+            return { exitCode: 1, output: 'Error: Please specify a file to validate.' };
+        }
+        try {
+            const source = readFileSync(target, 'utf-8');
+            const presentation = parseYumia(source);
+            return {
+                exitCode: 0,
+                output: `✓ Presentation '${target}' is valid. Detected ${presentation.slides.length} slide(s).`,
+            };
+        }
+        catch (err) {
+            return {
+                exitCode: 1,
+                output: `✗ Validation failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    if (command === 'lint') {
+        if (!target) {
+            return { exitCode: 1, output: 'Error: Please specify a file to lint.' };
+        }
+        try {
+            const source = readFileSync(target, 'utf-8');
+            const presentation = parseYumia(source);
+            const engine = new DefaultLayoutEngine();
+            const layout = engine.computePresentation(presentation);
+            const issues = [];
+            layout.slides.forEach((slideResult, index) => {
+                const slideNum = index + 1;
+                if (slideResult.overflow) {
+                    issues.push(`⚠ Slide ${slideNum}: Content exceeds slide height by ~${Math.round(slideResult.overflowAmount || 0)}px`);
+                }
+                const slide = presentation.slides[index];
+                if (slide.elements.length === 0) {
+                    issues.push(`⚠ Slide ${slideNum}: Slide has no content elements.`);
+                }
+            });
+            if (issues.length === 0) {
+                return {
+                    exitCode: 0,
+                    output: `✓ Yumia Lint: All ${presentation.slides.length} slide(s) passed with 0 issues.`,
+                };
+            }
+            else {
+                return {
+                    exitCode: 0,
+                    output: `Yumia Lint Report for '${target}':\n\n${issues.join('\n')}\n\nFound ${issues.length} warning(s).`,
+                };
+            }
+        }
+        catch (err) {
+            return {
+                exitCode: 1,
+                output: `✗ Linting failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    if (command === 'inspect') {
+        if (!target) {
+            return { exitCode: 1, output: 'Error: Please specify a file to inspect.' };
+        }
+        try {
+            const source = readFileSync(target, 'utf-8');
+            const presentation = parseYumia(source);
+            if (args.includes('--layout')) {
+                const engine = new DefaultLayoutEngine();
+                const layout = engine.computePresentation(presentation);
+                return {
+                    exitCode: 0,
+                    output: JSON.stringify(layout, null, 2),
+                };
+            }
+            return {
+                exitCode: 0,
+                output: JSON.stringify(presentation, null, 2),
+            };
+        }
+        catch (err) {
+            return {
+                exitCode: 1,
+                output: `✗ Inspection failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    if (command === 'build') {
+        return {
+            exitCode: 0,
+            output: `[planned] Compiling '${target ?? 'presentation'}' via YumiaCompiler...`,
+        };
+    }
+    return {
+        exitCode: 1,
+        output: `Unknown command: '${command}'. Run 'yumia --help' for available commands.`,
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "yumiamd",
+  "version": "0.1.2",
+  "description": "Command line interface and compiler for YumiaMD presentations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "yumia": "./dist/bin.js",
+    "yumiamd": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@biagioscaglia/yumia-ast": "0.1.2",
+    "@biagioscaglia/yumia-core": "0.1.2",
+    "@biagioscaglia/yumia-layout": "0.1.2",
+    "@biagioscaglia/yumia-parser": "0.1.2",
+    "@biagioscaglia/yumia-theme": "0.1.2"
+  },
+  "keywords": [
+    "yumia",
+    "presentation",
+    "cli"
+  ],
+  "author": "Biagio Scaglia",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/biagio-scaglia/Yumia-MD.git"
+  },
+  "homepage": "https://github.com/biagio-scaglia/Yumia-MD#readme",
+  "bugs": {
+    "url": "https://github.com/biagio-scaglia/Yumia-MD/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}