claude-presentation-master 3.8.7 → 3.9.0

package/dist/index.d.mts

@@ -714,9 +714,20 @@ declare class SlideGeneratorV2 {
      * RULES:
      * 1. Tables ALWAYS become table slides - NEVER extract to metrics
      * 2. Empty sections are SKIPPED - no blank divider slides
-     * 3. Sections with minimal content are combined into statement slides
+     * 3. H3 headings become individual slides with ACTION TITLES (critical for consulting)
+     * 4. Sections with minimal content are combined into statement slides
      */
     private processSectionContent;
+    /**
+     * Split tokens into subsections based on H3 headers.
+     * H3 headers become ACTION TITLES for consulting decks.
+     */
+    private splitIntoSubsections;
+    /**
+     * Process a subsection (H3) into a slide.
+     * The H3 title IS the action title.
+     */
+    private processSubsection;
     /**
      * Create a table slide - render the table as-is, no extraction.
      */
@@ -758,6 +769,264 @@ declare class SlideGeneratorV2 {
 }
 declare function createSlideGeneratorV2(type?: PresentationType): SlideGeneratorV2;
 
+/**
+ * Renderer V2 - Clean, Professional, No Garbage
+ *
+ * Renders slides to HTML and PDF with:
+ * - Tables as actual tables (not mangled metrics)
+ * - Complete bullets (never truncated)
+ * - Clean professional CSS (no random stock photos)
+ * - McKinsey/BCG consulting style (WHITE background, strong hierarchy)
+ * - Automatic PDF generation alongside HTML
+ */
+
+type ThemeStyle = 'mckinsey' | 'dark' | 'minimal' | 'corporate' | 'startup';
+declare class RendererV2 {
+    private theme;
+    private presentationType;
+    /**
+     * Create renderer with theme based on presentation type.
+     * @param presentationType - The type of deck being created (determines theme)
+     * @param themeOverride - Optional explicit theme override
+     */
+    constructor(presentationType?: PresentationType, themeOverride?: ThemeStyle);
+    /**
+     * Render slides to complete HTML document.
+     */
+    render(slides: SlideV2[], title?: string): string;
+    /**
+     * Render slides to both HTML and PDF files.
+     * Always generates both formats for easy sharing.
+     */
+    renderToFiles(slides: SlideV2[], outputPath: string, title?: string): Promise<{
+        htmlPath: string;
+        pdfPath: string;
+    }>;
+    /**
+     * Render slides directly to PDF using Puppeteer.
+     * Creates a printable PDF with one slide per page.
+     */
+    renderToPDF(slides: SlideV2[], outputPath: string, title?: string): Promise<Uint8Array>;
+    /**
+     * Render HTML optimized for PDF printing (no reveal.js, static pages).
+     */
+    private renderForPrint;
+    /**
+     * McKinsey-style print HTML (white background, professional).
+     */
+    private getMcKinseyPrintHTML;
+    /**
+     * Dark theme print HTML (legacy).
+     */
+    private getDarkPrintHTML;
+    /**
+     * Render slide content (shared between HTML and PDF renderers).
+     */
+    private renderSlideContent;
+    /**
+     * Render a single slide.
+     */
+    private renderSlide;
+    /**
+     * Title slide - big, bold, centered.
+     */
+    private renderTitleSlide;
+    /**
+     * Section divider - transition slide.
+     */
+    private renderSectionSlide;
+    /**
+     * Bullet slide - the workhorse.
+     */
+    private renderBulletSlide;
+    /**
+     * Table slide - render tables properly.
+     */
+    private renderTableSlide;
+    /**
+     * Render a table as clean HTML.
+     */
+    private renderTable;
+    /**
+     * Metrics slide - big numbers with labels.
+     */
+    private renderMetricsSlide;
+    /**
+     * Statement slide - single powerful message.
+     */
+    private renderStatementSlide;
+    /**
+     * Call to action slide.
+     */
+    private renderCTASlide;
+    /**
+     * Thank you slide.
+     */
+    private renderThankYouSlide;
+    /**
+     * Format bullet text - handle bold, arrows, etc.
+     */
+    private formatBulletText;
+    /**
+     * Escape HTML special characters.
+     */
+    private escapeHtml;
+    /**
+     * Professional CSS - McKinsey/BCG consulting style.
+     */
+    private getCSS;
+    /**
+     * McKinsey/BCG Consulting Style - WHITE background, professional hierarchy.
+     */
+    private getMcKinseyCSS;
+    /**
+     * Dark theme CSS (legacy).
+     */
+    private getDarkCSS;
+}
+/**
+ * Create a renderer with theme matched to the presentation type.
+ *
+ * @param presentationType - Type of deck (consulting_deck, keynote, etc.)
+ * @param themeOverride - Optional explicit theme to use instead of auto-mapping
+ *
+ * Theme mapping:
+ * - consulting_deck, board_presentation, internal_update → McKinsey (white, professional)
+ * - keynote, sales_pitch, technical → Dark (dramatic)
+ * - training, workshop, all_hands → Minimal (clean, readable)
+ * - product_demo, investor_pitch → Startup (modern dark)
+ * - executive_briefing → Corporate (professional)
+ */
+declare function createRendererV2(presentationType?: PresentationType, themeOverride?: ThemeStyle): RendererV2;
+
+/**
+ * PresentationEngineV2 - Knowledge-Driven Excellence
+ *
+ * This engine orchestrates the ENTIRE presentation creation flow:
+ * 1. Analyze content to detect presentation type
+ * 2. Load design specs from Knowledge Base
+ * 3. Generate slides following expert methodologies
+ * 4. Enhance with images (optional, needs API key)
+ * 5. Review ruthlessly (must score 95/100+)
+ * 6. Output ONLY if quality passes
+ *
+ * The Knowledge Base drives EVERYTHING:
+ * - Presentation type detection
+ * - Design specs (colors, fonts, spacing)
+ * - Slide structure and word limits
+ * - Quality criteria and scoring
+ */
+
+interface DesignSpecs {
+    wordsPerSlide: {
+        min: number;
+        max: number;
+        ideal: number;
+    };
+    whitespace: string;
+    bulletPoints: {
+        max: number;
+    };
+    fonts: {
+        title: number;
+        body: number;
+        minimum: number;
+    };
+    theme: ThemeStyle;
+    structure: string;
+    experts: string[];
+}
+interface SlideReview {
+    slideIndex: number;
+    title: string;
+    score: number;
+    issues: string[];
+    suggestions: string[];
+    passed: boolean;
+}
+interface DeckReview {
+    overallScore: number;
+    slideReviews: SlideReview[];
+    deckIssues: string[];
+    flow: 'excellent' | 'good' | 'needs_work' | 'poor';
+    passed: boolean;
+    summary: string;
+}
+interface EngineOptions {
+    /** Override detected presentation type */
+    presentationType?: PresentationType;
+    /** Override theme selection */
+    themeOverride?: ThemeStyle;
+    /** API key for image generation (optional) */
+    imageApiKey?: string;
+    /** Minimum quality score (default: 95) */
+    minScore?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Maximum remediation attempts per slide */
+    maxRemediationAttempts?: number;
+}
+interface EngineResult {
+    slides: SlideV2[];
+    html: string;
+    pdfPath?: string;
+    presentationType: PresentationType;
+    designSpecs: DesignSpecs;
+    review: DeckReview;
+    warnings: string[];
+}
+declare class PresentationEngineV2 {
+    private options;
+    constructor(options?: EngineOptions);
+    private log;
+    /**
+     * Generate a world-class presentation from markdown content.
+     * Follows knowledge base specs and demands 95+ quality score.
+     */
+    generate(markdown: string, title?: string): Promise<EngineResult>;
+    /**
+     * Detect presentation type from content analysis.
+     */
+    private detectPresentationType;
+    /**
+     * Should we recommend images for this presentation?
+     */
+    private shouldRecommendImages;
+    /**
+     * Ruthlessly review the deck against knowledge base criteria.
+     */
+    private reviewDeck;
+    /**
+     * Review a single slide against quality criteria.
+     */
+    private reviewSlide;
+    /**
+     * Check if title is an action/insight title vs. just a topic.
+     */
+    private isActionTitle;
+    /**
+     * Assess the flow and narrative structure of the deck.
+     */
+    private assessFlow;
+    /**
+     * Attempt to remediate failing slides.
+     */
+    private remediateSlides;
+    /**
+     * Count words in a slide.
+     */
+    private countWords;
+}
+declare function createPresentationEngineV2(options?: EngineOptions): PresentationEngineV2;
+/**
+ * Generate a presentation with automatic type detection and ruthless quality control.
+ * Throws if quality score is below 95/100.
+ */
+declare function generatePresentation(markdown: string, options?: EngineOptions & {
+    title?: string;
+    outputPath?: string;
+}): Promise<EngineResult>;
+
 /**
  * VisualDesignSystem - KB-Driven Visual Design Configuration
  *
@@ -1293,136 +1562,6 @@ declare class Renderer {
 declare function getRenderer(): Renderer;
 declare function initRenderer(): Promise<Renderer>;
 
-/**
- * Renderer V2 - Clean, Professional, No Garbage
- *
- * Renders slides to HTML and PDF with:
- * - Tables as actual tables (not mangled metrics)
- * - Complete bullets (never truncated)
- * - Clean professional CSS (no random stock photos)
- * - McKinsey/BCG consulting style (WHITE background, strong hierarchy)
- * - Automatic PDF generation alongside HTML
- */
-
-type ThemeStyle = 'mckinsey' | 'dark' | 'minimal' | 'corporate' | 'startup';
-declare class RendererV2 {
-    private theme;
-    private presentationType;
-    /**
-     * Create renderer with theme based on presentation type.
-     * @param presentationType - The type of deck being created (determines theme)
-     * @param themeOverride - Optional explicit theme override
-     */
-    constructor(presentationType?: PresentationType, themeOverride?: ThemeStyle);
-    /**
-     * Render slides to complete HTML document.
-     */
-    render(slides: SlideV2[], title?: string): string;
-    /**
-     * Render slides to both HTML and PDF files.
-     * Always generates both formats for easy sharing.
-     */
-    renderToFiles(slides: SlideV2[], outputPath: string, title?: string): Promise<{
-        htmlPath: string;
-        pdfPath: string;
-    }>;
-    /**
-     * Render slides directly to PDF using Puppeteer.
-     * Creates a printable PDF with one slide per page.
-     */
-    renderToPDF(slides: SlideV2[], outputPath: string, title?: string): Promise<Uint8Array>;
-    /**
-     * Render HTML optimized for PDF printing (no reveal.js, static pages).
-     */
-    private renderForPrint;
-    /**
-     * McKinsey-style print HTML (white background, professional).
-     */
-    private getMcKinseyPrintHTML;
-    /**
-     * Dark theme print HTML (legacy).
-     */
-    private getDarkPrintHTML;
-    /**
-     * Render slide content (shared between HTML and PDF renderers).
-     */
-    private renderSlideContent;
-    /**
-     * Render a single slide.
-     */
-    private renderSlide;
-    /**
-     * Title slide - big, bold, centered.
-     */
-    private renderTitleSlide;
-    /**
-     * Section divider - transition slide.
-     */
-    private renderSectionSlide;
-    /**
-     * Bullet slide - the workhorse.
-     */
-    private renderBulletSlide;
-    /**
-     * Table slide - render tables properly.
-     */
-    private renderTableSlide;
-    /**
-     * Render a table as clean HTML.
-     */
-    private renderTable;
-    /**
-     * Metrics slide - big numbers with labels.
-     */
-    private renderMetricsSlide;
-    /**
-     * Statement slide - single powerful message.
-     */
-    private renderStatementSlide;
-    /**
-     * Call to action slide.
-     */
-    private renderCTASlide;
-    /**
-     * Thank you slide.
-     */
-    private renderThankYouSlide;
-    /**
-     * Format bullet text - handle bold, arrows, etc.
-     */
-    private formatBulletText;
-    /**
-     * Escape HTML special characters.
-     */
-    private escapeHtml;
-    /**
-     * Professional CSS - McKinsey/BCG consulting style.
-     */
-    private getCSS;
-    /**
-     * McKinsey/BCG Consulting Style - WHITE background, professional hierarchy.
-     */
-    private getMcKinseyCSS;
-    /**
-     * Dark theme CSS (legacy).
-     */
-    private getDarkCSS;
-}
-/**
- * Create a renderer with theme matched to the presentation type.
- *
- * @param presentationType - Type of deck (consulting_deck, keynote, etc.)
- * @param themeOverride - Optional explicit theme to use instead of auto-mapping
- *
- * Theme mapping:
- * - consulting_deck, board_presentation, internal_update → McKinsey (white, professional)
- * - keynote, sales_pitch, technical → Dark (dramatic)
- * - training, workshop, all_hands → Minimal (clean, readable)
- * - product_demo, investor_pitch → Startup (modern dark)
- * - executive_briefing → Corporate (professional)
- */
-declare function createRendererV2(presentationType?: PresentationType, themeOverride?: ThemeStyle): RendererV2;
-
 /**
  * NanoBanana Pro Image Generation Provider
  *
@@ -1683,4 +1822,4 @@ interface GenerateResult {
  */
 declare function generate(options: GenerateOptions): Promise<GenerateResult>;
 
-export { CodeQualityValidator, type ValidationResult as CodeValidationResult, type ContentAnalysis, ContentAnalyzer, DeckQualityReviewer, type DeckScore, type GenerateOptions, type GenerateResult, type HardcodedViolation, type ImageGenerationRequest, type ImageGenerationResult, KnowledgeGateway, type MetricData, type NanoBananaConfig, NanoBananaProvider, type OutputFormat, type PresentationMetadata, type PresentationMode, type PresentationResult, type PresentationType, type QualitativeDeckReview, type QualitativeSlideReview, type RemediationResult, Remediator, Renderer, RendererV2, type Slide, type SlideContent as SlideContentV2, SlideGenerator, SlideGeneratorV2, SlideQualityReviewer, type SlideScore, type SlideType as SlideTypeV2, type SlideV2, type TableData, VERSION, type Violation, VisualDesignSystem, createNanoBananaProvider, createRendererV2, createSlideGeneratorV2, generate, getContentAnalyzer, getDeckQualityReviewer, getKB, getNanoBananaPrompt, getRemediator, getRenderer, getSlideGenerator, getSlideQualityReviewer, getVisualDesignSystem, initContentAnalyzer, initDeckQualityReviewer, initKB, initRemediator, initRenderer, initSlideGenerator, initSlideQualityReviewer, initVisualDesignSystem, runCodeQualityCheck, validateCodeQuality };
+export { CodeQualityValidator, type ValidationResult as CodeValidationResult, type ContentAnalysis, ContentAnalyzer, DeckQualityReviewer, type DeckScore, type GenerateOptions, type GenerateResult, type HardcodedViolation, type ImageGenerationRequest, type ImageGenerationResult, KnowledgeGateway, type MetricData, type NanoBananaConfig, NanoBananaProvider, type OutputFormat, PresentationEngineV2, type PresentationMetadata, type PresentationMode, type PresentationResult, type PresentationType, type QualitativeDeckReview, type QualitativeSlideReview, type RemediationResult, Remediator, Renderer, RendererV2, type Slide, type SlideContent as SlideContentV2, SlideGenerator, SlideGeneratorV2, SlideQualityReviewer, type SlideScore, type SlideType as SlideTypeV2, type SlideV2, type TableData, VERSION, type Violation, VisualDesignSystem, createNanoBananaProvider, createPresentationEngineV2, createRendererV2, createSlideGeneratorV2, generate, generatePresentation, getContentAnalyzer, getDeckQualityReviewer, getKB, getNanoBananaPrompt, getRemediator, getRenderer, getSlideGenerator, getSlideQualityReviewer, getVisualDesignSystem, initContentAnalyzer, initDeckQualityReviewer, initKB, initRemediator, initRenderer, initSlideGenerator, initSlideQualityReviewer, initVisualDesignSystem, runCodeQualityCheck, validateCodeQuality };