markdown-to-document-cli 1.1.4 → 1.2.8

package/dist/utils/dependencyChecker.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Dependency Checker - Proactive installation guidance
+ *
+ * Checks for required dependencies and provides user-friendly installation instructions
+ */
+export interface DependencyStatus {
+    name: string;
+    required: boolean;
+    installed: boolean;
+    version?: string;
+    installInstructions: InstallInstructions;
+}
+export interface InstallInstructions {
+    description: string;
+    macOS: string[];
+    linux: string[];
+    windows: string[];
+    notes?: string;
+}
+export declare class DependencyChecker {
+    /**
+     * Check if a command is available
+     */
+    private isCommandAvailable;
+    /**
+     * Check Node.js
+     */
+    private checkNode;
+    /**
+     * Check Pandoc
+     */
+    private checkPandoc;
+    /**
+     * Check PDF engines (at least one should be available)
+     */
+    private checkPdfEngines;
+    /**
+     * Check Python (optional, for WeasyPrint)
+     */
+    private checkPython;
+    /**
+     * Check all dependencies
+     */
+    checkAll(): Promise<{
+        allRequired: boolean;
+        hasPdfEngine: boolean;
+        dependencies: DependencyStatus[];
+        pdfEngines: DependencyStatus[];
+    }>;
+    /**
+     * Display installation instructions for a dependency
+     */
+    displayInstallInstructions(dep: DependencyStatus): void;
+    /**
+     * Display comprehensive dependency report
+     */
+    displayDependencyReport(): Promise<boolean>;
+    /**
+     * Quick check - returns true if ready to convert
+     */
+    quickCheck(format: 'epub' | 'pdf' | 'both'): Promise<boolean>;
+}
+//# sourceMappingURL=dependencyChecker.d.ts.map

package/dist/utils/dependencyChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyChecker.d.ts","sourceRoot":"","sources":["../../src/utils/dependencyChecker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,mBAAmB,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAiB;IAC1B;;OAEG;YACW,kBAAkB;IAahC;;OAEG;YACW,SAAS;IAiBvB;;OAEG;YACW,WAAW;IAiBzB;;OAEG;YACW,eAAe;IAoD7B;;OAEG;YACW,WAAW;IAmBzB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,gBAAgB,EAAE,CAAC;QACjC,UAAU,EAAE,gBAAgB,EAAE,CAAC;KAClC,CAAC;IAkBF;;OAEG;IACH,0BAA0B,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IA6BvD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IA0EjD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CActE"}

package/dist/utils/dependencyChecker.js

@@ -0,0 +1,268 @@
+/**
+ * Dependency Checker - Proactive installation guidance
+ *
+ * Checks for required dependencies and provides user-friendly installation instructions
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import chalk from 'chalk';
+const execFileAsync = promisify(execFile);
+export class DependencyChecker {
+    /**
+     * Check if a command is available
+     */
+    async isCommandAvailable(command, args = ['--version']) {
+        try {
+            const { stdout } = await execFileAsync(command, args, { timeout: 3000 });
+            const versionMatch = stdout.match(/(\d+\.\d+(?:\.\d+)?)/);
+            return {
+                available: true,
+                version: versionMatch ? versionMatch[1] : 'installed'
+            };
+        }
+        catch {
+            return { available: false };
+        }
+    }
+    /**
+     * Check Node.js
+     */
+    async checkNode() {
+        const result = await this.isCommandAvailable('node');
+        return {
+            name: 'Node.js',
+            required: true,
+            installed: result.available,
+            version: result.version,
+            installInstructions: {
+                description: 'JavaScript 런타임 - CLI가 실행되는 기반',
+                macOS: ['brew install node', '또는 https://nodejs.org 에서 다운로드'],
+                linux: ['sudo apt-get install nodejs npm', '또는 https://nodejs.org 에서 다운로드'],
+                windows: ['winget install OpenJS.NodeJS', '또는 https://nodejs.org 에서 다운로드'],
+                notes: 'Node.js 18 이상 권장'
+            }
+        };
+    }
+    /**
+     * Check Pandoc
+     */
+    async checkPandoc() {
+        const result = await this.isCommandAvailable('pandoc');
+        return {
+            name: 'Pandoc',
+            required: true,
+            installed: result.available,
+            version: result.version,
+            installInstructions: {
+                description: '문서 변환 엔진 - EPUB/PDF 생성의 핵심',
+                macOS: ['brew install pandoc'],
+                linux: ['sudo apt-get install pandoc'],
+                windows: ['winget install --id JohnMacFarlane.Pandoc'],
+                notes: 'Pandoc 2.19 이상 필요'
+            }
+        };
+    }
+    /**
+     * Check PDF engines (at least one should be available)
+     */
+    async checkPdfEngines() {
+        const engines = [
+            {
+                name: 'WeasyPrint',
+                command: 'weasyprint',
+                description: 'PDF 생성 엔진 (추천) - 가장 쉽고 한글 지원 우수',
+                macOS: ['pip3 install weasyprint', '또는 pip install weasyprint'],
+                linux: ['pip3 install weasyprint', '또는 pip install weasyprint'],
+                windows: ['pip install weasyprint'],
+                notes: 'Python이 필요합니다: https://python.org'
+            },
+            {
+                name: 'XeLaTeX',
+                command: 'xelatex',
+                description: 'PDF 생성 엔진 (한글 최적화) - 전문 출판 품질',
+                macOS: ['brew install --cask basictex', 'eval "$(/usr/libexec/path_helper)"'],
+                linux: ['sudo apt-get install texlive-xetex texlive-fonts-recommended'],
+                windows: ['https://www.tug.org/texlive/ 에서 설치'],
+                notes: '설치 후 터미널 재시작 필요'
+            },
+            {
+                name: 'PDFLaTeX',
+                command: 'pdflatex',
+                description: 'PDF 생성 엔진 (기본) - 표준 LaTeX',
+                macOS: ['brew install --cask basictex'],
+                linux: ['sudo apt-get install texlive-latex-base'],
+                windows: ['https://www.tug.org/texlive/ 에서 설치'],
+                notes: '설치 후 터미널 재시작 필요'
+            }
+        ];
+        const results = [];
+        for (const engine of engines) {
+            const result = await this.isCommandAvailable(engine.command);
+            results.push({
+                name: engine.name,
+                required: false,
+                installed: result.available,
+                version: result.version,
+                installInstructions: {
+                    description: engine.description,
+                    macOS: engine.macOS,
+                    linux: engine.linux,
+                    windows: engine.windows,
+                    notes: engine.notes
+                }
+            });
+        }
+        return results;
+    }
+    /**
+     * Check Python (optional, for WeasyPrint)
+     */
+    async checkPython() {
+        const result = await this.isCommandAvailable('python3', ['--version']);
+        const result2 = !result.available ? await this.isCommandAvailable('python', ['--version']) : result;
+        return {
+            name: 'Python',
+            required: false,
+            installed: result.available || result2.available,
+            version: result.version || result2.version,
+            installInstructions: {
+                description: 'WeasyPrint 설치에 필요 (선택사항)',
+                macOS: ['brew install python3'],
+                linux: ['sudo apt-get install python3 python3-pip'],
+                windows: ['winget install Python.Python.3', '또는 https://python.org 에서 다운로드'],
+                notes: 'WeasyPrint를 사용하려면 필요합니다'
+            }
+        };
+    }
+    /**
+     * Check all dependencies
+     */
+    async checkAll() {
+        const node = await this.checkNode();
+        const pandoc = await this.checkPandoc();
+        const python = await this.checkPython();
+        const pdfEngines = await this.checkPdfEngines();
+        const dependencies = [node, pandoc, python];
+        const allRequired = node.installed && pandoc.installed;
+        const hasPdfEngine = pdfEngines.some(engine => engine.installed);
+        return {
+            allRequired,
+            hasPdfEngine,
+            dependencies,
+            pdfEngines
+        };
+    }
+    /**
+     * Display installation instructions for a dependency
+     */
+    displayInstallInstructions(dep) {
+        const platform = process.platform;
+        const instructions = dep.installInstructions;
+        console.log(chalk.yellow(`\n📦 ${dep.name} 설치 방법:`));
+        console.log(chalk.gray(`   ${instructions.description}\n`));
+        if (platform === 'darwin') {
+            console.log(chalk.cyan('   macOS:'));
+            instructions.macOS.forEach(cmd => {
+                console.log(chalk.white(`   $ ${cmd}`));
+            });
+        }
+        else if (platform === 'win32') {
+            console.log(chalk.cyan('   Windows:'));
+            instructions.windows.forEach(cmd => {
+                console.log(chalk.white(`   > ${cmd}`));
+            });
+        }
+        else {
+            console.log(chalk.cyan('   Linux:'));
+            instructions.linux.forEach(cmd => {
+                console.log(chalk.white(`   $ ${cmd}`));
+            });
+        }
+        if (instructions.notes) {
+            console.log(chalk.gray(`\n   💡 ${instructions.notes}`));
+        }
+    }
+    /**
+     * Display comprehensive dependency report
+     */
+    async displayDependencyReport() {
+        console.log(chalk.cyan.bold('\n🔍 의존성 확인 중...\n'));
+        const { allRequired, hasPdfEngine, dependencies, pdfEngines } = await this.checkAll();
+        // Show required dependencies
+        console.log(chalk.bold('필수 의존성:'));
+        dependencies.filter(d => d.required).forEach(dep => {
+            if (dep.installed) {
+                console.log(chalk.green(`  ✅ ${dep.name} ${dep.version ? `(v${dep.version})` : ''}`));
+            }
+            else {
+                console.log(chalk.red(`  ❌ ${dep.name} - 설치 필요`));
+            }
+        });
+        // Show PDF engines
+        console.log(chalk.bold('\nPDF 생성 엔진 (최소 1개 필요):'));
+        pdfEngines.forEach(engine => {
+            if (engine.installed) {
+                console.log(chalk.green(`  ✅ ${engine.name} ${engine.version ? `(v${engine.version})` : ''}`));
+            }
+            else {
+                console.log(chalk.gray(`  ⚪ ${engine.name} - 미설치`));
+            }
+        });
+        // Show optional dependencies
+        const optional = dependencies.filter(d => !d.required);
+        if (optional.length > 0) {
+            console.log(chalk.bold('\n선택 의존성:'));
+            optional.forEach(dep => {
+                if (dep.installed) {
+                    console.log(chalk.green(`  ✅ ${dep.name} ${dep.version ? `(v${dep.version})` : ''}`));
+                }
+                else {
+                    console.log(chalk.gray(`  ⚪ ${dep.name} - 미설치`));
+                }
+            });
+        }
+        // If missing required dependencies, show installation instructions
+        if (!allRequired) {
+            console.log(chalk.red.bold('\n⚠️  필수 의존성이 누락되었습니다!\n'));
+            dependencies.filter(d => d.required && !d.installed).forEach(dep => {
+                this.displayInstallInstructions(dep);
+            });
+            return false;
+        }
+        // If no PDF engine, show recommendations
+        if (!hasPdfEngine) {
+            console.log(chalk.yellow.bold('\n⚠️  PDF 생성 엔진이 없습니다!\n'));
+            console.log(chalk.yellow('PDF 파일을 생성하려면 최소 1개의 PDF 엔진이 필요합니다.'));
+            console.log(chalk.yellow('EPUB만 생성하려면 이 단계를 건너뛸 수 있습니다.\n'));
+            // Show WeasyPrint first (recommended)
+            const weasyprint = pdfEngines.find(e => e.name === 'WeasyPrint');
+            if (weasyprint) {
+                this.displayInstallInstructions(weasyprint);
+            }
+            console.log(chalk.gray('\n또는 다른 PDF 엔진을 선택하세요:'));
+            pdfEngines.filter(e => e.name !== 'WeasyPrint').forEach(engine => {
+                console.log(chalk.gray(`  • ${engine.name}: ${engine.installInstructions.description}`));
+            });
+            console.log(chalk.cyan('\n💡 전체 설치 가이드: https://github.com/goodlookingprokim/markdown-to-document-cli#-필수-요구사항\n'));
+        }
+        if (allRequired && hasPdfEngine) {
+            console.log(chalk.green.bold('\n✅ 모든 의존성이 준비되었습니다!\n'));
+        }
+        return allRequired;
+    }
+    /**
+     * Quick check - returns true if ready to convert
+     */
+    async quickCheck(format) {
+        const { allRequired, hasPdfEngine } = await this.checkAll();
+        if (!allRequired) {
+            return false;
+        }
+        // If PDF is needed but no engine available
+        if ((format === 'pdf' || format === 'both') && !hasPdfEngine) {
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=dependencyChecker.js.map

package/dist/utils/dependencyChecker.js.map

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

package/dist/utils/pathValidator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Path Validator - Robust file path handling and validation
+ *
+ * Handles common path issues:
+ * - Backslash escapes in paths
+ * - Quoted paths
+ * - Spaces in paths
+ * - Relative vs absolute paths
+ * - Path existence validation
+ */
+export interface PathValidationResult {
+    valid: boolean;
+    normalizedPath?: string;
+    error?: string;
+    suggestions?: string[];
+}
+export declare class PathValidator {
+    /**
+     * Normalize and clean a file path
+     * Handles backslashes, quotes, and other common issues
+     */
+    static normalizePath(inputPath: string): string;
+    /**
+     * Validate a file path and provide helpful feedback
+     */
+    static validatePath(inputPath: string): PathValidationResult;
+    /**
+     * Generate helpful suggestions based on the invalid path
+     */
+    private static generatePathSuggestions;
+    /**
+     * Display validation error with helpful suggestions
+     */
+    static displayValidationError(result: PathValidationResult): void;
+    /**
+     * Interactive path input with validation
+     */
+    static promptForValidPath(initialPath?: string): Promise<string | null>;
+    /**
+     * Quick validation for CLI arguments
+     */
+    static quickValidate(inputPath: string): {
+        valid: boolean;
+        path?: string;
+        error?: string;
+    };
+}
+//# sourceMappingURL=pathValidator.d.ts.map

package/dist/utils/pathValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathValidator.d.ts","sourceRoot":"","sources":["../../src/utils/pathValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,aAAa;IACtB;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAuB/C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB;IA0D5D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAwCtC;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAwBjE;;OAEG;WACU,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwB7E;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAQ7F"}

package/dist/utils/pathValidator.js

@@ -0,0 +1,188 @@
+/**
+ * Path Validator - Robust file path handling and validation
+ *
+ * Handles common path issues:
+ * - Backslash escapes in paths
+ * - Quoted paths
+ * - Spaces in paths
+ * - Relative vs absolute paths
+ * - Path existence validation
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+export class PathValidator {
+    /**
+     * Normalize and clean a file path
+     * Handles backslashes, quotes, and other common issues
+     */
+    static normalizePath(inputPath) {
+        let cleaned = inputPath.trim();
+        // Remove surrounding quotes (single or double)
+        cleaned = cleaned.replace(/^['"]|['"]$/g, '');
+        // Replace escaped spaces (\ ) with regular spaces
+        cleaned = cleaned.replace(/\\\s/g, ' ');
+        // Replace other escaped characters
+        cleaned = cleaned.replace(/\\(.)/g, '$1');
+        // Normalize path separators and resolve
+        cleaned = path.normalize(cleaned);
+        // Resolve to absolute path if relative
+        if (!path.isAbsolute(cleaned)) {
+            cleaned = path.resolve(process.cwd(), cleaned);
+        }
+        return cleaned;
+    }
+    /**
+     * Validate a file path and provide helpful feedback
+     */
+    static validatePath(inputPath) {
+        if (!inputPath || inputPath.trim() === '') {
+            return {
+                valid: false,
+                error: '파일 경로가 비어있습니다.',
+                suggestions: [
+                    '파일을 터미널로 드래그 앤 드롭하세요',
+                    '또는 절대 경로를 입력하세요: /Users/username/document.md'
+                ]
+            };
+        }
+        const normalizedPath = this.normalizePath(inputPath);
+        // Check if file exists
+        if (!fs.existsSync(normalizedPath)) {
+            const suggestions = this.generatePathSuggestions(normalizedPath);
+            return {
+                valid: false,
+                normalizedPath,
+                error: `파일을 찾을 수 없습니다: ${normalizedPath}`,
+                suggestions
+            };
+        }
+        // Check if it's a file (not a directory)
+        const stats = fs.statSync(normalizedPath);
+        if (!stats.isFile()) {
+            return {
+                valid: false,
+                normalizedPath,
+                error: `디렉토리가 아닌 파일을 선택해야 합니다: ${normalizedPath}`,
+                suggestions: [
+                    '마크다운 파일(.md)을 선택하세요',
+                    '디렉토리 내의 특정 파일을 지정하세요'
+                ]
+            };
+        }
+        // Check if it's a markdown file
+        if (!normalizedPath.endsWith('.md')) {
+            return {
+                valid: false,
+                normalizedPath,
+                error: `마크다운 파일(.md)이 아닙니다: ${normalizedPath}`,
+                suggestions: [
+                    '파일 확장자가 .md인지 확인하세요',
+                    '예: document.md, README.md'
+                ]
+            };
+        }
+        return {
+            valid: true,
+            normalizedPath
+        };
+    }
+    /**
+     * Generate helpful suggestions based on the invalid path
+     */
+    static generatePathSuggestions(invalidPath) {
+        const suggestions = [];
+        const dirname = path.dirname(invalidPath);
+        const basename = path.basename(invalidPath);
+        // Check if directory exists
+        if (fs.existsSync(dirname)) {
+            suggestions.push(`디렉토리는 존재합니다: ${dirname}`);
+            // Try to find similar files
+            try {
+                const files = fs.readdirSync(dirname);
+                const mdFiles = files.filter(f => f.endsWith('.md'));
+                if (mdFiles.length > 0) {
+                    suggestions.push(`이 디렉토리의 마크다운 파일:`);
+                    mdFiles.slice(0, 5).forEach(f => {
+                        suggestions.push(`  - ${path.join(dirname, f)}`);
+                    });
+                    if (mdFiles.length > 5) {
+                        suggestions.push(`  ... 그 외 ${mdFiles.length - 5}개 파일`);
+                    }
+                }
+            }
+            catch {
+                // Ignore permission errors
+            }
+        }
+        else {
+            suggestions.push('디렉토리가 존재하지 않습니다');
+            suggestions.push('경로를 다시 확인하세요');
+        }
+        // Common mistakes
+        if (invalidPath.includes('\\')) {
+            suggestions.push('⚠️  백슬래시(\\)가 포함되어 있습니다');
+            suggestions.push('파일을 드래그 앤 드롭하거나 따옴표 없이 경로를 입력하세요');
+        }
+        return suggestions;
+    }
+    /**
+     * Display validation error with helpful suggestions
+     */
+    static displayValidationError(result) {
+        console.log(chalk.red(`\n❌ ${result.error}\n`));
+        if (result.suggestions && result.suggestions.length > 0) {
+            console.log(chalk.yellow('💡 도움말:'));
+            result.suggestions.forEach(suggestion => {
+                if (suggestion.startsWith('  -')) {
+                    console.log(chalk.gray(suggestion));
+                }
+                else if (suggestion.startsWith('⚠️')) {
+                    console.log(chalk.yellow(`   ${suggestion}`));
+                }
+                else {
+                    console.log(chalk.cyan(`   • ${suggestion}`));
+                }
+            });
+            console.log();
+        }
+        console.log(chalk.cyan('📝 올바른 경로 입력 방법:'));
+        console.log(chalk.gray('   1. 파일을 터미널 창으로 드래그 앤 드롭'));
+        console.log(chalk.gray('   2. 절대 경로 입력: /Users/username/document.md'));
+        console.log(chalk.gray('   3. 상대 경로 입력: ./docs/document.md'));
+        console.log();
+    }
+    /**
+     * Interactive path input with validation
+     */
+    static async promptForValidPath(initialPath) {
+        let attempts = 0;
+        const maxAttempts = 3;
+        while (attempts < maxAttempts) {
+            const inputPath = initialPath || '';
+            const result = this.validatePath(inputPath);
+            if (result.valid && result.normalizedPath) {
+                return result.normalizedPath;
+            }
+            this.displayValidationError(result);
+            attempts++;
+            if (attempts >= maxAttempts) {
+                console.log(chalk.red('❌ 최대 시도 횟수를 초과했습니다.\n'));
+                return null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Quick validation for CLI arguments
+     */
+    static quickValidate(inputPath) {
+        const result = this.validatePath(inputPath);
+        return {
+            valid: result.valid,
+            path: result.normalizedPath,
+            error: result.error
+        };
+    }
+}
+//# sourceMappingURL=pathValidator.js.map

package/dist/utils/pathValidator.js.map

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

package/dist/utils/themeUtils.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Theme and Preset Utility Functions
+ * Centralized helpers for theme/preset filtering, validation, and listing
+ */
+import type { CoverTheme, TypographyPreset, TypographyPresetId } from '../types/index.js';
+/**
+ * Get all available cover theme IDs
+ */
+export declare function getCoverThemeIds(): string[];
+/**
+ * Get cover theme by ID
+ */
+export declare function getCoverTheme(id: string): CoverTheme | undefined;
+/**
+ * Check if a cover theme ID is valid
+ */
+export declare function isValidCoverTheme(id: string): boolean;
+/**
+ * Get cover themes filtered by category
+ */
+export declare function getCoverThemesByCategory(category: string): CoverTheme[];
+/**
+ * Get cover themes grouped by category
+ */
+export declare function getCoverThemesGrouped(): Record<string, CoverTheme[]>;
+/**
+ * Get cover theme categories with theme counts
+ */
+export declare function getCoverThemeCategorySummary(): {
+    category: string;
+    count: number;
+    themes: string[];
+}[];
+/**
+ * Get all available typography preset IDs
+ */
+export declare function getTypographyPresetIds(): TypographyPresetId[];
+/**
+ * Get typography preset by ID
+ */
+export declare function getTypographyPreset(id: string): TypographyPreset | undefined;
+/**
+ * Check if a typography preset ID is valid
+ */
+export declare function isValidTypographyPreset(id: string): boolean;
+/**
+ * Get typography presets by category (basic, content, document)
+ */
+export declare function getTypographyPresetsByCategory(category: 'basic' | 'content' | 'document'): TypographyPreset[];
+/**
+ * Get typography presets grouped by category
+ */
+export declare function getTypographyPresetsGrouped(): Record<string, TypographyPreset[]>;
+/**
+ * Generate help text for cover themes
+ */
+export declare function generateCoverThemeHelpText(): string;
+/**
+ * Generate help text for typography presets
+ */
+export declare function generateTypographyPresetHelpText(): string;
+/**
+ * Validate and return cover theme, with fallback to default
+ */
+export declare function validateCoverTheme(id: string | undefined, defaultId?: string): CoverTheme;
+/**
+ * Validate and return typography preset ID, with fallback to default
+ */
+export declare function validateTypographyPreset(id: string | undefined, defaultId?: TypographyPresetId): TypographyPresetId;
+//# sourceMappingURL=themeUtils.d.ts.map