@michelabboud/visual-forge-mcp 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -5,7 +5,190 @@ All notable changes to Visual Forge MCP will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.11.0] - 2026-01-17
+
+### Added 📄 **PDF Generation System**
+
+Visual Forge now includes a complete PDF generation module using the Typst typesetting engine.
+
+#### New MCP Tools
+- **`pdf_generate`** - Generate PDF from markdown/Typst source
+  - Supports Typst (primary) and XeLaTeX (fallback) engines
+  - Automatic WebP to PNG conversion for PDF compatibility
+  - Custom templates, fonts, margins, and metadata
+  - Table of contents generation
+- **`pdf_generate_batch`** - Batch process multiple files
+  - Concurrent generation with configurable parallelism
+  - Shared options across all files
+  - Progress tracking per file
+- **`pdf_check_engine`** - Check engine availability
+  - Verify Typst and XeLaTeX installation
+  - Get version information
+- **`pdf_list_templates`** - List available templates
+  - Built-in "visual-forge" branded template
+  - Support for custom .typ templates
+
+#### Architecture
+- **New module**: `src/pdf/` with:
+  - `pdf-types.ts` - TypeScript type definitions
+  - `image-converter.ts` - WebP to PNG conversion using Sharp
+  - `typst-engine.ts` - Main Typst PDF engine
+  - `index.ts` - Module exports
+- **New template**: `templates/visual-forge.typ` - AWS-branded Typst template with callout boxes
+
+#### Performance Benchmarks
+| Metric | Typst | XeLaTeX |
+|--------|-------|---------|
+| Speed (large doc) | 2,646ms | 3,157ms |
+| File Size | 746KB | 157KB |
+| Binary Size | ~40MB | ~2.5GB |
+
+#### Key Features
+- Automatic fallback from Typst to XeLaTeX if Typst fails
+- WebP images automatically converted to PNG
+- Optional emoji sanitization for PDF compatibility
+- Caching of converted images to avoid re-conversion
+- Cross-platform font defaults (DejaVu family)
+
+---
+
+### Fixed 🔴 **Critical Bug Fixes**
+
+#### Issue #1: Placeholder Replacement Failure (CRITICAL)
+**Problem:** After image generation, placeholders in markdown files were NOT replaced with actual image links. All placeholders remained unchanged despite successful generation.
+
+**Root Cause:** PlaceholderManager was replacing placeholders using a generic regex that matched ANY placeholder, causing sequential replacements to overwrite each other. Only the last image's replacement survived.
+
+**Fix Applied:**
+- Added `imageId` field to all placeholder blocks for unique identification
+- Updated regex to match specific placeholder by imageId: `imageId: <unique-id>`
+- Changed replacement logic to target exact placeholder, not just first match
+- Added error logging when placeholder not found
+
+**Files Changed:**
+- `src/placeholders/placeholder-manager.ts`: Updated `insertPlaceholder()` and `replacePlaceholder()`
+
+**Result:** ✅ Each image now correctly replaces its own specific placeholder
+
+---
+
+#### Issue #2 & #3: Session Isolation Failure (CRITICAL)
+**Problem:** Statistics showed images from ALL sessions (52 images, 32 failures from different files), not just current session (10 images).
+
+**Root Cause:** `vf_generate_session` was pulling all images from global state instead of filtering by current session.
+
+**Fix Applied:**
+- Filter generated images by current session's imageIds before verification
+- Calculate session-specific costs (sum from session images only)
+- Update statistics to show only current session data
+
+**Files Changed:**
+- `src/workflow/workflow-tools.ts`: Lines 456-473 (session filtering), 629-638 (cost calculation)
+
+**Result:** ✅ Statistics now accurate for current session only
+
+---
+
+#### Issue #4: Image Status Not Updating (HIGH)
+**Problem:** Image status remained stuck at `placeholder_added` despite successful generation.
+
+**Root Cause:** No status update after verification step.
+
+**Fix Applied:**
+- Added status update to `generated` after successful file verification
+- Status progression now works: `placeholder_added` → `generated` → `inserted_into_document`
+
+**Files Changed:**
+- `src/workflow/workflow-tools.ts`: Lines 508-517 (status update after verification)
+
+**Result:** ✅ Image status correctly tracks generation progress
+
+---
+
+#### Issue #5: Cost Tracking Showing $0 (MEDIUM)
+**Problem:** Total cost reported as $0 despite generating 10 images via Gemini API.
+
+**Root Cause:** Using global `updatedState.costs.totalCost` instead of calculating session-specific cost.
+
+**Fix Applied:**
+- Calculate session cost by summing `metadata.actualCost` from verified session images
+- Return session-specific cost in tool response
+
+**Files Changed:**
+- `src/workflow/workflow-tools.ts`: Lines 629-638 (session cost calculation), Line 663 (return statement)
+
+**Result:** ✅ Accurate cost tracking per session
+
+---
+
+### Added 🎨 **Smart Image Optimization System**
+
+#### Intelligent Format Selection
+- **New: Optimization Strategy Manager** (`src/utils/optimization-strategy-manager.ts`)
+  - Automatically recommends optimal format based on image type
+  - Hero images → WebP (90% quality, best compression)
+  - Screenshots → PNG lossy (95% quality, pixel-perfect)
+  - Diagrams/Flowcharts → PNG lossy (95% quality, sharp text)
+  - Architecture diagrams → PNG lossy (95% quality, precision)
+  - Icons → WebP (85% quality, smallest size, no watermark)
+  - Illustrations → WebP (88% quality, balanced)
+  - Charts → PNG lossy (92% quality, data accuracy)
+
+#### All Formats Still Generated
+- **No reduction in output** - Still generates WebP, JPEG, PNG, and Original
+- **Smart recommendation** - System marks which format to use in document
+- **Maximum flexibility** - All formats available for different contexts
+- **Automatic insertion** - Placeholder replacement uses recommended format
+
+#### Advanced User Override
+- **New: `preferredFormat` metadata field**
+  - Allow advanced users to override smart selection
+  - Specify in image placeholder: `preferredFormat: jpeg`
+  - Supported values: `webp`, `jpeg`, `png`, `original`
+  - Falls back to smart recommendation if not specified
+
+#### Enhanced Type System
+- **Updated `ImageSpec.metadata`** - Added `preferredFormat` field
+- **Updated `GeneratedImageMetadata`** - Added `multiFormat` object with:
+  - List of all generated formats
+  - Recommended format and path
+  - Recommendation reasoning
+  - Watermark status
+
+#### Quality Optimization by Type
+- **Type-specific quality settings** - Each image type gets optimal quality levels
+- **Intelligent watermarking** - Icons don't get watermarked (too small)
+- **PNG optimization** - Smart lossy/lossless selection per type
+
+#### Transparency & Logging
+- **Detailed logging** - Every image logs smart optimization decision
+- **Reasoning provided** - Explains why format was chosen
+- **All formats tracked** - Metadata includes all generated formats
+
+#### Documentation
+- **New Guide**: `docs/guides/smart-optimization-guide.md`
+  - Comprehensive explanation of smart optimization
+  - Format recommendations by image type
+  - Use case examples (web, PDF, technical docs)
+  - Advanced override instructions
+  - Performance comparisons
+  - Troubleshooting guide
+
+#### Technical Changes
+- **Updated Files**:
+  - `src/utils/optimization-strategy-manager.ts` (NEW - 300+ lines)
+  - `src/utils/multi-format-optimizer.ts` - Added recommendation parameters
+  - `src/providers/base-provider.ts` - Uses smart optimization
+  - `src/types/image-spec.ts` - Added `preferredFormat` field
+  - `src/types/generation.ts` - Added `multiFormat` metadata
+  - `src/workflow/workflow-tools.ts` - Updated validation messages
+
+#### Benefits
+- ✅ **Optimal quality** - Right format for each use case
+- ✅ **Better performance** - WebP for web, PNG for technical content
+- ✅ **User choice** - Can still override when needed
+- ✅ **Transparency** - Clear reasoning for every decision
+- ✅ **Backward compatible** - Existing workflows unaffected
 
 ---
 

package/README.md

@@ -7,7 +7,7 @@
 An MCP (Model Context Protocol) server that automates AI image generation for technical documentation. Parse markdown files containing image prompts and generate professional images using multiple AI providers.
 
 [![npm version](https://img.shields.io/npm/v/@michelabboud/visual-forge-mcp.svg)](https://www.npmjs.com/package/@michelabboud/visual-forge-mcp)
-[![Version](https://img.shields.io/badge/version-0.9.0-blue.svg)](https://github.com/michelabboud/visual-forge-mcp)
+[![Version](https://img.shields.io/badge/version-0.11.0-blue.svg)](https://github.com/michelabboud/visual-forge-mcp)
 [![License](https://img.shields.io/badge/License-Personal%20Use%20Only-red.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D24.0.0-brightgreen.svg)](https://nodejs.org/)
 
@@ -43,6 +43,7 @@ An MCP (Model Context Protocol) server that automates AI image generation for te
 - **📊 Cost Tracking**: Real-time cost monitoring and estimates per provider
 - **🎯 Smart Rate Limiting**: Token bucket algorithm prevents API bans
 - **🔒 Automatic Backups**: File backup system with approve/restore workflow (optional, enabled by default)
+- **📄 PDF Generation** ✨ NEW v0.11.0: Generate PDFs from markdown using Typst engine with XeLaTeX fallback, custom templates, and automatic WebP to PNG conversion
 - **🌐 Universal MCP Support**: Compatible with 24+ MCP clients (tested with Claude Code, Claude Desktop, Zed)
 
 ---

package/dist/pdf/image-converter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Visual Forge MCP - Image Converter
+ * Converts WebP images to PNG/JPG for PDF compatibility
+ */
+import { ImageConversionResult } from './pdf-types.js';
+/**
+ * Image converter for PDF compatibility
+ * WebP images are not supported by LaTeX/Typst, so we convert them to PNG
+ */
+export declare class ImageConverter {
+    private outputDir;
+    private convertedCache;
+    constructor(outputDir?: string);
+    /**
+     * Convert a WebP image to PNG
+     */
+    convertWebPToPNG(imagePath: string): Promise<ImageConversionResult>;
+    /**
+     * Convert multiple images
+     */
+    convertImages(imagePaths: string[]): Promise<ImageConversionResult[]>;
+    /**
+     * Extract image paths from markdown content
+     */
+    extractImagePaths(content: string, baseDir: string): string[];
+    /**
+     * Process markdown content, converting WebP references to PNG
+     */
+    processMarkdownImages(content: string, baseDir: string): Promise<{
+        content: string;
+        conversions: ImageConversionResult[];
+    }>;
+    /**
+     * Escape special regex characters
+     */
+    private escapeRegex;
+    /**
+     * Clean up converted images
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get conversion statistics
+     */
+    getStats(): {
+        totalConverted: number;
+        cachePath: string;
+    };
+}
+/**
+ * Default image converter instance
+ */
+export declare const imageConverter: ImageConverter;
+//# sourceMappingURL=image-converter.d.ts.map

package/dist/pdf/image-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-converter.d.ts","sourceRoot":"","sources":["../../src/pdf/image-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAkC;gBAE5C,SAAS,CAAC,EAAE,MAAM;IAI9B;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA8EzE;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAW3E;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAqB7D;;OAEG;IACG,qBAAqB,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,qBAAqB,EAAE,CAAA;KAAE,CAAC;IA4BrE;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;OAEG;IACH,QAAQ,IAAI;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAM1D;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/pdf/image-converter.js

@@ -0,0 +1,179 @@
+/**
+ * Visual Forge MCP - Image Converter
+ * Converts WebP images to PNG/JPG for PDF compatibility
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import sharp from 'sharp';
+import { logger } from '../utils/index.js';
+/**
+ * Image converter for PDF compatibility
+ * WebP images are not supported by LaTeX/Typst, so we convert them to PNG
+ */
+export class ImageConverter {
+    outputDir;
+    convertedCache = new Map();
+    constructor(outputDir) {
+        this.outputDir = outputDir || './.pdf-images';
+    }
+    /**
+     * Convert a WebP image to PNG
+     */
+    async convertWebPToPNG(imagePath) {
+        const absolutePath = path.resolve(imagePath);
+        const ext = path.extname(imagePath).toLowerCase();
+        // Skip if not WebP
+        if (ext !== '.webp') {
+            return {
+                originalPath: imagePath,
+                convertedPath: imagePath,
+                converted: false,
+            };
+        }
+        // Check cache
+        if (this.convertedCache.has(absolutePath)) {
+            return {
+                originalPath: imagePath,
+                convertedPath: this.convertedCache.get(absolutePath),
+                converted: true,
+            };
+        }
+        try {
+            // Ensure output directory exists
+            await fs.mkdir(this.outputDir, { recursive: true });
+            // Generate output path
+            const basename = path.basename(imagePath, '.webp');
+            const outputPath = path.join(this.outputDir, `${basename}.png`);
+            // Check if file exists
+            try {
+                await fs.access(absolutePath);
+            }
+            catch {
+                return {
+                    originalPath: imagePath,
+                    convertedPath: imagePath,
+                    converted: false,
+                    error: `File not found: ${imagePath}`,
+                };
+            }
+            // Convert using Sharp
+            await sharp(absolutePath)
+                .png({
+                quality: 90,
+                compressionLevel: 6,
+            })
+                .toFile(outputPath);
+            // Cache the result
+            this.convertedCache.set(absolutePath, outputPath);
+            logger.info('Converted WebP to PNG', {
+                original: imagePath,
+                converted: outputPath,
+            });
+            return {
+                originalPath: imagePath,
+                convertedPath: outputPath,
+                converted: true,
+            };
+        }
+        catch (error) {
+            logger.error('Failed to convert WebP image', {
+                imagePath,
+                error: error.message,
+            });
+            return {
+                originalPath: imagePath,
+                convertedPath: imagePath,
+                converted: false,
+                error: error.message,
+            };
+        }
+    }
+    /**
+     * Convert multiple images
+     */
+    async convertImages(imagePaths) {
+        const results = [];
+        for (const imagePath of imagePaths) {
+            const result = await this.convertWebPToPNG(imagePath);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Extract image paths from markdown content
+     */
+    extractImagePaths(content, baseDir) {
+        const imageRegex = /!\[([^\]]*)\]\(([^)]+)\)/g;
+        const paths = [];
+        let match;
+        while ((match = imageRegex.exec(content)) !== null) {
+            const imagePath = match[2];
+            // Skip URLs
+            if (imagePath.startsWith('http://') || imagePath.startsWith('https://')) {
+                continue;
+            }
+            // Resolve relative paths
+            const absolutePath = path.isAbsolute(imagePath)
+                ? imagePath
+                : path.resolve(baseDir, imagePath);
+            paths.push(absolutePath);
+        }
+        return paths;
+    }
+    /**
+     * Process markdown content, converting WebP references to PNG
+     */
+    async processMarkdownImages(content, baseDir) {
+        const imagePaths = this.extractImagePaths(content, baseDir);
+        const conversions = [];
+        let processedContent = content;
+        for (const imagePath of imagePaths) {
+            const result = await this.convertWebPToPNG(imagePath);
+            conversions.push(result);
+            if (result.converted && result.convertedPath !== result.originalPath) {
+                // Replace the path in content
+                const relativePath = path.relative(baseDir, result.convertedPath);
+                processedContent = processedContent.replace(new RegExp(this.escapeRegex(result.originalPath), 'g'), relativePath);
+                // Also replace relative paths
+                const originalRelative = path.relative(baseDir, result.originalPath);
+                processedContent = processedContent.replace(new RegExp(this.escapeRegex(originalRelative), 'g'), relativePath);
+            }
+        }
+        return { content: processedContent, conversions };
+    }
+    /**
+     * Escape special regex characters
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Clean up converted images
+     */
+    async cleanup() {
+        try {
+            await fs.rm(this.outputDir, { recursive: true, force: true });
+            this.convertedCache.clear();
+            logger.info('Cleaned up converted images', { dir: this.outputDir });
+        }
+        catch (error) {
+            logger.warn('Failed to clean up converted images', {
+                error: error.message,
+            });
+        }
+    }
+    /**
+     * Get conversion statistics
+     */
+    getStats() {
+        return {
+            totalConverted: this.convertedCache.size,
+            cachePath: this.outputDir,
+        };
+    }
+}
+/**
+ * Default image converter instance
+ */
+export const imageConverter = new ImageConverter();
+//# sourceMappingURL=image-converter.js.map

package/dist/pdf/image-converter.js.map

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

package/dist/pdf/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Visual Forge MCP - PDF Generation Module
+ * Exports PDF generation functionality
+ */
+export * from './pdf-types.js';
+export { ImageConverter, imageConverter } from './image-converter.js';
+export { TypstEngine, typstEngine, generatePDF, generateBatchPDF, } from './typst-engine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pdf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pdf/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/pdf/index.js

@@ -0,0 +1,11 @@
+/**
+ * Visual Forge MCP - PDF Generation Module
+ * Exports PDF generation functionality
+ */
+// Types
+export * from './pdf-types.js';
+// Image converter
+export { ImageConverter, imageConverter } from './image-converter.js';
+// Typst engine
+export { TypstEngine, typstEngine, generatePDF, generateBatchPDF, } from './typst-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/pdf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pdf/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAQ;AACR,cAAc,gBAAgB,CAAC;AAE/B,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtE,eAAe;AACf,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/pdf/pdf-types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Visual Forge MCP - PDF Generation Types
+ * Type definitions for PDF generation with Typst engine
+ */
+/**
+ * Supported PDF engines
+ */
+export type PDFEngine = 'typst' | 'xelatex';
+/**
+ * Paper sizes for PDF generation
+ */
+export type PaperSize = 'a4' | 'letter' | 'a5' | 'legal';
+/**
+ * Document metadata for PDF
+ */
+export interface DocumentMetadata {
+    title?: string;
+    author?: string;
+    date?: string;
+    abstract?: string;
+    subject?: string;
+    keywords?: string[];
+    logo?: string;
+}
+/**
+ * Font configuration for PDF generation
+ */
+export interface FontOptions {
+    mainFont?: string;
+    sansFont?: string;
+    monoFont?: string;
+    fontSize?: number;
+}
+/**
+ * Page margin configuration
+ */
+export interface MarginOptions {
+    top?: string;
+    bottom?: string;
+    left?: string;
+    right?: string;
+}
+/**
+ * PDF generation options
+ */
+export interface PDFGenerationOptions {
+    /** Input markdown file path */
+    inputPath: string;
+    /** Output PDF file path */
+    outputPath: string;
+    /** PDF engine to use (default: typst) */
+    engine?: PDFEngine;
+    /** Custom Typst template path */
+    template?: string;
+    /** Document metadata */
+    metadata?: DocumentMetadata;
+    /** Font options */
+    fonts?: FontOptions;
+    /** Page margins */
+    margins?: MarginOptions;
+    /** Paper size (default: a4) */
+    paperSize?: PaperSize;
+    /** Include table of contents */
+    includeToc?: boolean;
+    /** Convert WebP images to PNG */
+    convertWebP?: boolean;
+    /** Remove emojis from content */
+    sanitizeEmoji?: boolean;
+    /** Working directory for relative paths */
+    workingDirectory?: string;
+}
+/**
+ * PDF generation result
+ */
+export interface PDFGenerationResult {
+    /** Whether generation succeeded */
+    success: boolean;
+    /** Output PDF file path */
+    outputPath?: string;
+    /** File size in bytes */
+    fileSize?: number;
+    /** Page count */
+    pageCount?: number;
+    /** Generation time in milliseconds */
+    duration?: number;
+    /** Engine used */
+    engine: PDFEngine;
+    /** Error message if failed */
+    error?: string;
+    /** Warnings during generation */
+    warnings?: string[];
+    /** Images converted from WebP */
+    convertedImages?: string[];
+}
+/**
+ * Batch PDF generation options
+ */
+export interface BatchPDFOptions {
+    /** Input files to process */
+    files: string[];
+    /** Output directory */
+    outputDir: string;
+    /** Shared options for all files */
+    options?: Omit<PDFGenerationOptions, 'inputPath' | 'outputPath'>;
+    /** Concurrency for parallel generation */
+    concurrency?: number;
+}
+/**
+ * Batch PDF generation result
+ */
+export interface BatchPDFResult {
+    /** Total files processed */
+    totalFiles: number;
+    /** Successfully generated */
+    successful: number;
+    /** Failed generations */
+    failed: number;
+    /** Total time in milliseconds */
+    totalDuration: number;
+    /** Individual results */
+    results: PDFGenerationResult[];
+}
+/**
+ * Image conversion result
+ */
+export interface ImageConversionResult {
+    /** Original image path */
+    originalPath: string;
+    /** Converted image path */
+    convertedPath: string;
+    /** Whether conversion was needed */
+    converted: boolean;
+    /** Error if conversion failed */
+    error?: string;
+}
+/**
+ * Preprocessor options for markdown
+ */
+export interface PreprocessOptions {
+    /** Convert WebP images to PNG */
+    convertWebP?: boolean;
+    /** Remove/replace emojis */
+    sanitizeEmoji?: boolean;
+    /** Base directory for image resolution */
+    baseDir?: string;
+    /** Output directory for converted images */
+    outputDir?: string;
+}
+/**
+ * Preprocessor result
+ */
+export interface PreprocessResult {
+    /** Preprocessed markdown content */
+    content: string;
+    /** Converted images */
+    convertedImages: ImageConversionResult[];
+    /** Warnings during preprocessing */
+    warnings: string[];
+}
+/**
+ * Typst template information
+ */
+export interface TemplateInfo {
+    /** Template name */
+    name: string;
+    /** Template file path */
+    path: string;
+    /** Template description */
+    description?: string;
+    /** Supported features */
+    features?: string[];
+}
+/**
+ * PDF engine capabilities
+ */
+export interface EngineCapabilities {
+    /** Engine name */
+    name: string;
+    /** Whether engine is available */
+    available: boolean;
+    /** Engine version */
+    version?: string;
+    /** Supported output formats */
+    outputFormats: string[];
+    /** Supported input formats */
+    inputFormats: string[];
+    /** Available templates */
+    templates: TemplateInfo[];
+}
+//# sourceMappingURL=pdf-types.d.ts.map

package/dist/pdf/pdf-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-types.d.ts","sourceRoot":"","sources":["../../src/pdf/pdf-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,mBAAmB;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mBAAmB;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gCAAgC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;IACjE,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0BAA0B;IAC1B,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B"}