claude-presentation-master 7.2.0 → 7.2.1

package/bin/cli.js

@@ -445,6 +445,12 @@ async function runGenerate(inputPath, options, generate) {
       console.log(`✅ PPTX saved: ${pptxPath}`);
     }
 
+    if (result.outputs.pdf) {
+      const pdfPath = resolve(outputDir, `${baseFilename}.pdf`);
+      writeFileSync(pdfPath, result.outputs.pdf);
+      console.log(`✅ PDF saved: ${pdfPath}`);
+    }
+
     // Show results
     const avgWords = result.metadata.avgWordsPerSlide?.toFixed(1) ?? 'N/A';
     const totalWords = result.metadata.wordCount || result.metadata.totalWords || 0;

package/dist/index.d.mts

@@ -3,7 +3,7 @@
  * @module types
  */
 type PresentationMode$1 = 'keynote' | 'business';
-type OutputFormat = 'html' | 'pptx';
+type OutputFormat = 'html' | 'pptx' | 'pdf';
 type ThemeName = 'default' | 'light-corporate' | 'modern-tech' | 'minimal' | 'warm' | 'creative';
 type PresentationType$1 = 'ted_keynote' | 'sales_pitch' | 'consulting_deck' | 'investment_banking' | 'investor_pitch' | 'technical_presentation' | 'all_hands';
 interface PresentationConfig {
@@ -45,6 +45,8 @@ interface PresentationConfig {
     images?: string[];
     /** Base path for resolving image paths */
     imageBasePath?: string;
+    /** Generate PDF alongside HTML (default: true when format includes 'html') */
+    generatePdf?: boolean;
 }
 type SlideType = 'title' | 'agenda' | 'section-divider' | 'thank-you' | 'big-idea' | 'single-statement' | 'big-number' | 'full-image' | 'quote' | 'two-column' | 'three-column' | 'bullet-points' | 'screenshot' | 'screenshot-left' | 'screenshot-right' | 'comparison' | 'timeline' | 'process' | 'metrics-grid' | 'pricing' | 'team' | 'features' | 'chart' | 'table' | 'social-proof' | 'case-study' | 'cta';
 interface Slide {
@@ -96,6 +98,26 @@ interface MetricData {
     change?: string;
     trend?: 'up' | 'down' | 'neutral';
 }
+/** Legacy slide format for backwards compatibility */
+interface LegacySlide {
+    index: number;
+    type: string;
+    title: string;
+    content: {
+        subtitle?: string | undefined;
+        statement?: string | undefined;
+        body?: string | undefined;
+        bullets?: string[] | undefined;
+        metrics?: MetricData[] | undefined;
+        quote?: {
+            text: string;
+            attribution?: string | undefined;
+        } | undefined;
+        callToAction?: string | undefined;
+    };
+    notes?: string | undefined;
+    template: string;
+}
 interface QAResults {
     /** Visual quality results */
     visual: VisualQAResults;
@@ -157,7 +179,7 @@ interface GlanceTestResult {
     wordCount: number;
     readingTime: number;
     passed: boolean;
-    recommendation?: string;
+    recommendation?: string | undefined;
 }
 interface SignalNoiseResult {
     slideIndex: number;
@@ -172,7 +194,7 @@ interface OneIdeaResult {
     ideaCount: number;
     mainIdea: string;
     passed: boolean;
-    conflictingIdeas?: string[];
+    conflictingIdeas?: string[] | undefined;
 }
 interface ExpertQAResults {
     /** Nancy Duarte validation */
@@ -229,11 +251,47 @@ interface QAIssue {
     /** Suggested fix */
     suggestion?: string;
 }
+/** Result from 7-dimension QA scoring */
+interface SevenDimensionQAResult {
+    passed: boolean;
+    score: number;
+    visual: {
+        whitespacePercentage: number;
+        layoutBalance: number;
+        colorContrast: number;
+    };
+    content: {
+        perSlide: SlideContentScore[];
+        issues: Array<{
+            dimension: string;
+            message: string;
+            slideIndex?: number;
+        }>;
+    };
+    accessibility: {
+        wcagLevel: string;
+        issues: Array<{
+            dimension: string;
+            message: string;
+            slideIndex?: number;
+        }>;
+    };
+    issues: Array<{
+        severity: string;
+        message: string;
+        slideIndex?: number;
+        dimension: string;
+    }>;
+    dimensions: Record<string, number>;
+    iterations: unknown[];
+    report: string;
+}
 interface PresentationResult {
     /** Generated outputs */
     outputs: {
         html?: string;
         pptx?: Buffer;
+        pdf?: Buffer;
     };
     /** QA validation results */
     qaResults: QAResults;
@@ -457,6 +515,7 @@ declare class PresentationEngine {
     private qaEngine;
     private htmlGenerator;
     private pptxGenerator;
+    private pdfGenerator;
     private kb;
     constructor();
     /**
@@ -555,6 +614,7 @@ interface ColorPalette {
     contrast_ratio: string;
 }
 type PresentationType = 'ted_keynote' | 'sales_pitch' | 'consulting_deck' | 'investment_banking' | 'investor_pitch' | 'technical_presentation' | 'all_hands';
+type KnowledgeBaseData = Record<string, any>;
 declare class KnowledgeGateway {
     private kb;
     private loaded;
@@ -629,11 +689,11 @@ declare class KnowledgeGateway {
     /**
      * Get story framework by name
      */
-    getStoryFramework(name: 'sparkline' | 'scqa' | 'pyramid' | 'scr'): any;
+    getStoryFramework(name: 'sparkline' | 'scqa' | 'pyramid' | 'scr'): unknown;
     /**
      * Get expert principles by name
      */
-    getExpertPrinciples(expertName: string): any;
+    getExpertPrinciples(expertName: string): unknown;
     /**
      * Get Duarte's glance test requirements
      */
@@ -657,7 +717,7 @@ declare class KnowledgeGateway {
     /**
      * Get chart selection guidance
      */
-    getChartGuidance(purpose: 'comparison' | 'composition' | 'distribution' | 'relationship'): any;
+    getChartGuidance(purpose: 'comparison' | 'composition' | 'distribution' | 'relationship'): unknown;
     /**
      * Get charts to avoid
      */
@@ -665,7 +725,7 @@ declare class KnowledgeGateway {
     /**
      * Get investment banking pitch book structure
      */
-    getIBPitchBookStructure(type: 'ma_sell_side' | 'ma_buy_side' | 'ipo_pitchbook'): any;
+    getIBPitchBookStructure(type: 'ma_sell_side' | 'ma_buy_side' | 'ipo_pitchbook'): unknown;
     /**
      * Check if knowledge base is loaded
      */
@@ -673,7 +733,7 @@ declare class KnowledgeGateway {
     /**
      * Get the full knowledge base (for advanced queries)
      */
-    getRawKB(): any;
+    getRawKB(): KnowledgeBaseData;
     /**
      * Get allowed slide types for a specific presentation type.
      * CRITICAL: SlideFactory must ONLY use types from this list.
@@ -995,6 +1055,11 @@ declare class ContentAnalyzer {
      * CRITICAL: Must strip headers, CTA text, and fragments
      */
     private extractFirstSentence;
+    /**
+     * Extract metrics from natural language text
+     * Handles formats like "40% productivity loss", "$2.5M investment"
+     */
+    private extractMetricsFromText;
 }
 
 /**
@@ -1198,7 +1263,7 @@ declare class SlideGenerator {
      * - Content pattern to slide type mapping
      * - Slide validation against KB rules
      */
-    generate(analysis: ContentAnalysis$1, type?: PresentationType): Promise<Slide[]>;
+    generate(analysis: ContentAnalysis$1, type?: PresentationType): Promise<LegacySlide[]>;
     /**
      * Convert new Slide format to legacy format for backwards compatibility
      */
@@ -1358,6 +1423,15 @@ declare class ScoreCalculator {
  * CRITICAL: All thresholds come from the knowledge base
  */
 
+interface RevealApi {
+    getTotalSlides?: () => number;
+    slide?: (index: number) => void;
+}
+declare global {
+    interface Window {
+        Reveal?: RevealApi;
+    }
+}
 declare class QAEngine {
     private browser;
     private kb;
@@ -1698,6 +1772,18 @@ declare class RevealJsGenerator {
      * Lighten a hex color
      */
     private lightenColor;
+    /**
+     * Check if a palette is "dark mode" (dark background, light text)
+     */
+    private isDarkPalette;
+    /**
+     * Get relative luminance of a hex color (0-1, 0=black, 1=white)
+     */
+    private getLuminance;
+    /**
+     * Darken a hex color
+     */
+    private darkenColor;
     /**
      * Get theme-specific styles - KB-DRIVEN
      */
@@ -2101,4 +2187,4 @@ declare const _default: {
     VERSION: string;
 };
 
-export { type AccessibilityResults, AutoFixEngine, type AutoFixResult, type ChartData, type ChartDataset, ChartJsProvider, type ChartProvider, type ChartRequest, type ChartResult, type ChartType, type ColorPalette, CompositeChartProvider, CompositeImageProvider, type ContentAnalysis$1 as ContentAnalysis, ContentAnalyzer, type ContentPattern, ContentPatternClassifier, type ContentQAResults, type ContentSection$1 as ContentSection, type ContrastIssue, type DimensionIssue, type DimensionScore, type ExpertQAResults, type ExpertValidation, type FixResult, type FontSizeIssue, type GlanceTestResult, type ImageData, type ImageProvider, type ImageRequest, type ImageResult, type IterationRecord, IterativeQAEngine, type IterativeQAOptions, type IterativeQAResult, KnowledgeGateway, LocalImageProvider, MermaidProvider, type MetricData, type OneIdeaResult, type OutputFormat, PlaceholderImageProvider, PowerPointGenerator, type PresentationConfig, PresentationEngine, type PresentationMetadata, type PresentationMode$1 as PresentationMode, type PresentationResult, type PresentationType, QAEngine, QAFailureError, type QAIssue, type QAResults, QuickChartProvider, RevealJsGenerator, type SCQAStructure, ScoreCalculator, type ScoringWeights, type SevenDimensionResult, SevenDimensionScorer, type SignalNoiseResult, type Slide, type SlideContentScore, type SlideData, SlideFactory, SlideGenerator, type SlideTemplate, type SlideType, type SlideValidationResult, type SlideVisualScore, type SparklineStructure, type StoryStructure, TemplateEngine, TemplateNotFoundError, type ThemeName, type TypographyRules, UnsplashImageProvider, VERSION, ValidationError, type ValidationRules, type VisualQAResults, createAutoFixEngine, createDefaultChartProvider, createDefaultImageProvider, createIterativeQAEngine, createSlideFactory, _default as default, generate, getKnowledgeGateway, initSlideGenerator, validate };
+export { type AccessibilityResults, AutoFixEngine, type AutoFixResult, type ChartData, type ChartDataset, ChartJsProvider, type ChartProvider, type ChartRequest, type ChartResult, type ChartType, type ColorPalette, CompositeChartProvider, CompositeImageProvider, type ContentAnalysis$1 as ContentAnalysis, ContentAnalyzer, type ContentPattern, ContentPatternClassifier, type ContentQAResults, type ContentSection$1 as ContentSection, type ContrastIssue, type DimensionIssue, type DimensionScore, type ExpertQAResults, type ExpertValidation, type FixResult, type FontSizeIssue, type GlanceTestResult, type ImageData, type ImageProvider, type ImageRequest, type ImageResult, type IterationRecord, IterativeQAEngine, type IterativeQAOptions, type IterativeQAResult, KnowledgeGateway, type LegacySlide, LocalImageProvider, MermaidProvider, type MetricData, type OneIdeaResult, type OutputFormat, PlaceholderImageProvider, PowerPointGenerator, type PresentationConfig, PresentationEngine, type PresentationMetadata, type PresentationMode$1 as PresentationMode, type PresentationResult, type PresentationType, QAEngine, QAFailureError, type QAIssue, type QAResults, QuickChartProvider, RevealJsGenerator, type SCQAStructure, ScoreCalculator, type ScoringWeights, type SevenDimensionQAResult, type SevenDimensionResult, SevenDimensionScorer, type SignalNoiseResult, type Slide, type SlideContentScore, type SlideData, SlideFactory, SlideGenerator, type SlideTemplate, type SlideType, type SlideValidationResult, type SlideVisualScore, type SparklineStructure, type StoryStructure, TemplateEngine, TemplateNotFoundError, type ThemeName, type TypographyRules, UnsplashImageProvider, VERSION, ValidationError, type ValidationRules, type VisualQAResults, createAutoFixEngine, createDefaultChartProvider, createDefaultImageProvider, createIterativeQAEngine, createSlideFactory, _default as default, generate, getKnowledgeGateway, initSlideGenerator, validate };

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * @module types
  */
 type PresentationMode$1 = 'keynote' | 'business';
-type OutputFormat = 'html' | 'pptx';
+type OutputFormat = 'html' | 'pptx' | 'pdf';
 type ThemeName = 'default' | 'light-corporate' | 'modern-tech' | 'minimal' | 'warm' | 'creative';
 type PresentationType$1 = 'ted_keynote' | 'sales_pitch' | 'consulting_deck' | 'investment_banking' | 'investor_pitch' | 'technical_presentation' | 'all_hands';
 interface PresentationConfig {
@@ -45,6 +45,8 @@ interface PresentationConfig {
     images?: string[];
     /** Base path for resolving image paths */
     imageBasePath?: string;
+    /** Generate PDF alongside HTML (default: true when format includes 'html') */
+    generatePdf?: boolean;
 }
 type SlideType = 'title' | 'agenda' | 'section-divider' | 'thank-you' | 'big-idea' | 'single-statement' | 'big-number' | 'full-image' | 'quote' | 'two-column' | 'three-column' | 'bullet-points' | 'screenshot' | 'screenshot-left' | 'screenshot-right' | 'comparison' | 'timeline' | 'process' | 'metrics-grid' | 'pricing' | 'team' | 'features' | 'chart' | 'table' | 'social-proof' | 'case-study' | 'cta';
 interface Slide {
@@ -96,6 +98,26 @@ interface MetricData {
     change?: string;
     trend?: 'up' | 'down' | 'neutral';
 }
+/** Legacy slide format for backwards compatibility */
+interface LegacySlide {
+    index: number;
+    type: string;
+    title: string;
+    content: {
+        subtitle?: string | undefined;
+        statement?: string | undefined;
+        body?: string | undefined;
+        bullets?: string[] | undefined;
+        metrics?: MetricData[] | undefined;
+        quote?: {
+            text: string;
+            attribution?: string | undefined;
+        } | undefined;
+        callToAction?: string | undefined;
+    };
+    notes?: string | undefined;
+    template: string;
+}
 interface QAResults {
     /** Visual quality results */
     visual: VisualQAResults;
@@ -157,7 +179,7 @@ interface GlanceTestResult {
     wordCount: number;
     readingTime: number;
     passed: boolean;
-    recommendation?: string;
+    recommendation?: string | undefined;
 }
 interface SignalNoiseResult {
     slideIndex: number;
@@ -172,7 +194,7 @@ interface OneIdeaResult {
     ideaCount: number;
     mainIdea: string;
     passed: boolean;
-    conflictingIdeas?: string[];
+    conflictingIdeas?: string[] | undefined;
 }
 interface ExpertQAResults {
     /** Nancy Duarte validation */
@@ -229,11 +251,47 @@ interface QAIssue {
     /** Suggested fix */
     suggestion?: string;
 }
+/** Result from 7-dimension QA scoring */
+interface SevenDimensionQAResult {
+    passed: boolean;
+    score: number;
+    visual: {
+        whitespacePercentage: number;
+        layoutBalance: number;
+        colorContrast: number;
+    };
+    content: {
+        perSlide: SlideContentScore[];
+        issues: Array<{
+            dimension: string;
+            message: string;
+            slideIndex?: number;
+        }>;
+    };
+    accessibility: {
+        wcagLevel: string;
+        issues: Array<{
+            dimension: string;
+            message: string;
+            slideIndex?: number;
+        }>;
+    };
+    issues: Array<{
+        severity: string;
+        message: string;
+        slideIndex?: number;
+        dimension: string;
+    }>;
+    dimensions: Record<string, number>;
+    iterations: unknown[];
+    report: string;
+}
 interface PresentationResult {
     /** Generated outputs */
     outputs: {
         html?: string;
         pptx?: Buffer;
+        pdf?: Buffer;
     };
     /** QA validation results */
     qaResults: QAResults;
@@ -457,6 +515,7 @@ declare class PresentationEngine {
     private qaEngine;
     private htmlGenerator;
     private pptxGenerator;
+    private pdfGenerator;
     private kb;
     constructor();
     /**
@@ -555,6 +614,7 @@ interface ColorPalette {
     contrast_ratio: string;
 }
 type PresentationType = 'ted_keynote' | 'sales_pitch' | 'consulting_deck' | 'investment_banking' | 'investor_pitch' | 'technical_presentation' | 'all_hands';
+type KnowledgeBaseData = Record<string, any>;
 declare class KnowledgeGateway {
     private kb;
     private loaded;
@@ -629,11 +689,11 @@ declare class KnowledgeGateway {
     /**
      * Get story framework by name
      */
-    getStoryFramework(name: 'sparkline' | 'scqa' | 'pyramid' | 'scr'): any;
+    getStoryFramework(name: 'sparkline' | 'scqa' | 'pyramid' | 'scr'): unknown;
     /**
      * Get expert principles by name
      */
-    getExpertPrinciples(expertName: string): any;
+    getExpertPrinciples(expertName: string): unknown;
     /**
      * Get Duarte's glance test requirements
      */
@@ -657,7 +717,7 @@ declare class KnowledgeGateway {
     /**
      * Get chart selection guidance
      */
-    getChartGuidance(purpose: 'comparison' | 'composition' | 'distribution' | 'relationship'): any;
+    getChartGuidance(purpose: 'comparison' | 'composition' | 'distribution' | 'relationship'): unknown;
     /**
      * Get charts to avoid
      */
@@ -665,7 +725,7 @@ declare class KnowledgeGateway {
     /**
      * Get investment banking pitch book structure
      */
-    getIBPitchBookStructure(type: 'ma_sell_side' | 'ma_buy_side' | 'ipo_pitchbook'): any;
+    getIBPitchBookStructure(type: 'ma_sell_side' | 'ma_buy_side' | 'ipo_pitchbook'): unknown;
     /**
      * Check if knowledge base is loaded
      */
@@ -673,7 +733,7 @@ declare class KnowledgeGateway {
     /**
      * Get the full knowledge base (for advanced queries)
      */
-    getRawKB(): any;
+    getRawKB(): KnowledgeBaseData;
     /**
      * Get allowed slide types for a specific presentation type.
      * CRITICAL: SlideFactory must ONLY use types from this list.
@@ -995,6 +1055,11 @@ declare class ContentAnalyzer {
      * CRITICAL: Must strip headers, CTA text, and fragments
      */
     private extractFirstSentence;
+    /**
+     * Extract metrics from natural language text
+     * Handles formats like "40% productivity loss", "$2.5M investment"
+     */
+    private extractMetricsFromText;
 }
 
 /**
@@ -1198,7 +1263,7 @@ declare class SlideGenerator {
      * - Content pattern to slide type mapping
      * - Slide validation against KB rules
      */
-    generate(analysis: ContentAnalysis$1, type?: PresentationType): Promise<Slide[]>;
+    generate(analysis: ContentAnalysis$1, type?: PresentationType): Promise<LegacySlide[]>;
     /**
      * Convert new Slide format to legacy format for backwards compatibility
      */
@@ -1358,6 +1423,15 @@ declare class ScoreCalculator {
  * CRITICAL: All thresholds come from the knowledge base
  */
 
+interface RevealApi {
+    getTotalSlides?: () => number;
+    slide?: (index: number) => void;
+}
+declare global {
+    interface Window {
+        Reveal?: RevealApi;
+    }
+}
 declare class QAEngine {
     private browser;
     private kb;
@@ -1698,6 +1772,18 @@ declare class RevealJsGenerator {
      * Lighten a hex color
      */
     private lightenColor;
+    /**
+     * Check if a palette is "dark mode" (dark background, light text)
+     */
+    private isDarkPalette;
+    /**
+     * Get relative luminance of a hex color (0-1, 0=black, 1=white)
+     */
+    private getLuminance;
+    /**
+     * Darken a hex color
+     */
+    private darkenColor;
     /**
      * Get theme-specific styles - KB-DRIVEN
      */
@@ -2101,4 +2187,4 @@ declare const _default: {
     VERSION: string;
 };
 
-export { type AccessibilityResults, AutoFixEngine, type AutoFixResult, type ChartData, type ChartDataset, ChartJsProvider, type ChartProvider, type ChartRequest, type ChartResult, type ChartType, type ColorPalette, CompositeChartProvider, CompositeImageProvider, type ContentAnalysis$1 as ContentAnalysis, ContentAnalyzer, type ContentPattern, ContentPatternClassifier, type ContentQAResults, type ContentSection$1 as ContentSection, type ContrastIssue, type DimensionIssue, type DimensionScore, type ExpertQAResults, type ExpertValidation, type FixResult, type FontSizeIssue, type GlanceTestResult, type ImageData, type ImageProvider, type ImageRequest, type ImageResult, type IterationRecord, IterativeQAEngine, type IterativeQAOptions, type IterativeQAResult, KnowledgeGateway, LocalImageProvider, MermaidProvider, type MetricData, type OneIdeaResult, type OutputFormat, PlaceholderImageProvider, PowerPointGenerator, type PresentationConfig, PresentationEngine, type PresentationMetadata, type PresentationMode$1 as PresentationMode, type PresentationResult, type PresentationType, QAEngine, QAFailureError, type QAIssue, type QAResults, QuickChartProvider, RevealJsGenerator, type SCQAStructure, ScoreCalculator, type ScoringWeights, type SevenDimensionResult, SevenDimensionScorer, type SignalNoiseResult, type Slide, type SlideContentScore, type SlideData, SlideFactory, SlideGenerator, type SlideTemplate, type SlideType, type SlideValidationResult, type SlideVisualScore, type SparklineStructure, type StoryStructure, TemplateEngine, TemplateNotFoundError, type ThemeName, type TypographyRules, UnsplashImageProvider, VERSION, ValidationError, type ValidationRules, type VisualQAResults, createAutoFixEngine, createDefaultChartProvider, createDefaultImageProvider, createIterativeQAEngine, createSlideFactory, _default as default, generate, getKnowledgeGateway, initSlideGenerator, validate };
+export { type AccessibilityResults, AutoFixEngine, type AutoFixResult, type ChartData, type ChartDataset, ChartJsProvider, type ChartProvider, type ChartRequest, type ChartResult, type ChartType, type ColorPalette, CompositeChartProvider, CompositeImageProvider, type ContentAnalysis$1 as ContentAnalysis, ContentAnalyzer, type ContentPattern, ContentPatternClassifier, type ContentQAResults, type ContentSection$1 as ContentSection, type ContrastIssue, type DimensionIssue, type DimensionScore, type ExpertQAResults, type ExpertValidation, type FixResult, type FontSizeIssue, type GlanceTestResult, type ImageData, type ImageProvider, type ImageRequest, type ImageResult, type IterationRecord, IterativeQAEngine, type IterativeQAOptions, type IterativeQAResult, KnowledgeGateway, type LegacySlide, LocalImageProvider, MermaidProvider, type MetricData, type OneIdeaResult, type OutputFormat, PlaceholderImageProvider, PowerPointGenerator, type PresentationConfig, PresentationEngine, type PresentationMetadata, type PresentationMode$1 as PresentationMode, type PresentationResult, type PresentationType, QAEngine, QAFailureError, type QAIssue, type QAResults, QuickChartProvider, RevealJsGenerator, type SCQAStructure, ScoreCalculator, type ScoringWeights, type SevenDimensionQAResult, type SevenDimensionResult, SevenDimensionScorer, type SignalNoiseResult, type Slide, type SlideContentScore, type SlideData, SlideFactory, SlideGenerator, type SlideTemplate, type SlideType, type SlideValidationResult, type SlideVisualScore, type SparklineStructure, type StoryStructure, TemplateEngine, TemplateNotFoundError, type ThemeName, type TypographyRules, UnsplashImageProvider, VERSION, ValidationError, type ValidationRules, type VisualQAResults, createAutoFixEngine, createDefaultChartProvider, createDefaultImageProvider, createIterativeQAEngine, createSlideFactory, _default as default, generate, getKnowledgeGateway, initSlideGenerator, validate };