v0.26.0 — PPTX/PDF rendering, update checker uses GitHub

- Add PPTX renderer (hybrid PNG background + editable text overlays)
- Add PDF renderer for image templates
- Version check now fetches from GitHub releases instead of npm
- Update install instructions to use curl installer

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: tomtev

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "loopwind",
-  "version": "0.25.11",
+  "version": "0.26.0",
   "description": "A CLI tool for generating images and videos from JSX templates using Tailwind CSS.",
   "type": "module",
   "bin": {
@@ -50,6 +50,7 @@
     "loopwind": "^0.25.7",
     "open": "^10.0.0",
     "ora": "^8.0.1",
+    "pdf-lib": "^1.17.1",
     "pptxgenjs": "^4.0.1",
     "qrcode": "^1.5.4",
     "react": "^18.2.0",

package.json

@@ -42,7 +42,7 @@ program
   .description('Render a template file to an image or video')
   .option('-p, --props <file>', 'Props file (JSON) - deprecated, use positional argument instead')
   .option('-o, --out <file>', 'Output file path')
-  .option('--format <format>', 'Output format (png, svg, webp, jpg, jpeg)', 'png')
+  .option('--format <format>', 'Output format (png, svg, webp, jpg, jpeg, pptx, pdf)', 'png')
   .option('--frames-only', 'Render video frames only (no encoding)')
   .option('--crf <number>', 'Video quality (0-51, lower = better quality)', '23')
   .option('--ffmpeg', 'Use FFmpeg for faster encoding (requires FFmpeg installed)')

src/cli.ts

@@ -12,7 +12,7 @@ import { checkForUpdates } from '../lib/version-check.js';
 interface RenderOptions {
   props?: string;
   out?: string;
-  format?: 'png' | 'svg' | 'webp' | 'jpg' | 'jpeg' | 'mp4' | 'gif';
+  format?: 'png' | 'svg' | 'webp' | 'jpg' | 'jpeg' | 'mp4' | 'gif' | 'pptx' | 'pdf';
   framesOnly?: boolean;
   crf?: number;
   ffmpeg?: boolean;
@@ -32,7 +32,7 @@ export async function renderCommand(
     const result = await updateCheck;
     if (result?.isOutdated) {
       console.log(chalk.dim(`Update available: ${result.currentVersion} → ${chalk.green(result.latestVersion)}`));
-      console.log(chalk.dim(`Run: ${chalk.cyan('npm install -g loopwind@latest')}\n`));
+      console.log(chalk.dim(`Run: ${chalk.cyan('curl -fsSL https://loopwind.dev/install.sh | bash')}\n`));
     }
   };
 
@@ -66,14 +66,68 @@ export async function renderCommand(
     const meta = await loadTemplateMeta(templateName);
     const templateType = meta.type || 'image';
 
-    // Check for unsupported types
-    if (templateType === 'presentation') {
-      spinner.fail(chalk.yellow('Presentation rendering is not yet implemented'));
-      console.log(chalk.dim(`\nPresentation rendering will be available in a future release.`));
-      console.log(chalk.dim(`Presentations will export multi-page PDFs with React + Tailwind.\n`));
+    // Guard: --format pptx on non-presentation template
+    if (options.format === 'pptx' && templateType !== 'presentation') {
+      spinner.fail(chalk.red(`--format pptx is only supported for presentation templates`));
+      console.log(chalk.dim(`\nTemplate "${templateName}" is type "${templateType}".`));
+      console.log(chalk.dim(`To create a presentation, set meta.type = "presentation" and define meta.presentation.slides.\n`));
       process.exit(1);
     }
 
+    // Handle presentation templates
+    if (templateType === 'presentation') {
+      const { renderPptx } = await import('../lib/pptx-renderer.js');
+
+      // Parse props
+      spinner.text = 'Loading props...';
+      const propsInput = propsArg || options.props;
+      const props = await parseProps(propsInput);
+
+      // Validate template and props
+      spinner.text = 'Validating template...';
+      const validation = await validateTemplateForRendering(templateName, props);
+
+      if (!validation.valid) {
+        spinner.fail(chalk.red('Template validation failed'));
+        console.log();
+        for (const error of validation.errors) {
+          console.log(chalk.red(`  ✗ ${error.field}: ${error.message}`));
+          if (error.suggestion) {
+            console.log(chalk.dim(`    → ${error.suggestion}`));
+          }
+          console.log();
+        }
+        console.log(chalk.yellow('Fix the errors above and try again.\n'));
+        process.exit(1);
+      }
+
+      const baseName = templateName.endsWith('.tsx')
+        ? path.basename(templateName, '.tsx')
+        : templateName;
+      const outputPath = options.out || `${baseName}.pptx`;
+
+      spinner.text = 'Rendering presentation slides...';
+      const slideCount = meta.presentation?.slides?.length ?? 0;
+
+      await renderPptx(templateName, props, outputPath, {
+        onProgress: (slide, total, phase) => {
+          if (phase === 'render') {
+            spinner.text = `Rendering slide ${slide}/${total}...`;
+          } else {
+            spinner.text = `Assembling PPTX (${total} slides)...`;
+          }
+        },
+      });
+
+      spinner.succeed(chalk.green(`Successfully rendered PPTX to ${chalk.bold(outputPath)}`));
+      console.log(chalk.dim(`\nTemplate: ${templateName}`));
+      console.log(chalk.dim(`Slides: ${slideCount}`));
+      console.log(chalk.dim(`Output: ${path.resolve(outputPath)}\n`));
+
+      await showUpdateNotification();
+      return;
+    }
+
     if (templateType === 'website') {
       spinner.fail(chalk.yellow('Website rendering is not yet implemented'));
       console.log(chalk.dim(`\nWebsite rendering will be available in a future release.`));
@@ -210,9 +264,27 @@ export async function renderCommand(
       return;
     }
 
+    // Handle PDF format for image templates
+    if (options.format === 'pdf') {
+      const { renderPdf } = await import('../lib/pdf-renderer.js');
+
+      const outputPath = options.out || `${baseName}.pdf`;
+
+      spinner.text = 'Rendering to PDF...';
+      await renderPdf(templateName, props, outputPath);
+
+      spinner.succeed(chalk.green(`Successfully rendered PDF to ${chalk.bold(outputPath)}`));
+      console.log(chalk.dim(`\nTemplate: ${templateName}`));
+      console.log(chalk.dim(`Format: PDF`));
+      console.log(chalk.dim(`Output: ${path.resolve(outputPath)}\n`));
+
+      await showUpdateNotification();
+      return;
+    }
+
     // Handle image templates
     // Filter out video formats for image templates
-    const imageFormat = (options.format === 'mp4' || options.format === 'gif')
+    const imageFormat = (options.format === 'mp4' || options.format === 'gif' || options.format === 'pptx')
       ? 'png'
       : (options.format || 'png');
     const defaultFileName = `${baseName}.${imageFormat}`;

src/commands/render.ts

@@ -0,0 +1,34 @@
+import { PDFDocument } from 'pdf-lib';
+import fs from 'fs/promises';
+import { renderToPNG } from './renderer.js';
+import { loadTemplateMeta } from './utils.js';
+import type { TemplateProps } from '../types/template.js';
+
+/**
+ * Render a template to a PDF file.
+ *
+ * Renders the template to PNG via the existing pipeline,
+ * then embeds the PNG into a single-page PDF sized to match
+ * the template dimensions.
+ */
+export async function renderPdf(
+  templateName: string,
+  props: TemplateProps,
+  outputPath: string,
+): Promise<void> {
+  const meta = await loadTemplateMeta(templateName);
+  const width = meta.size?.width ?? 1920;
+  const height = meta.size?.height ?? 1080;
+
+  // Render template to PNG buffer
+  const pngBuffer = await renderToPNG(templateName, props);
+
+  // Create PDF with page sized to template dimensions (72 DPI points)
+  const pdf = await PDFDocument.create();
+  const pngImage = await pdf.embedPng(pngBuffer);
+  const page = pdf.addPage([width, height]);
+  page.drawImage(pngImage, { x: 0, y: 0, width, height });
+
+  const pdfBytes = await pdf.save();
+  await fs.writeFile(outputPath, pdfBytes);
+}