npm - claude-presentation-master - Versions diffs - 1.0.1 → 2.1.0 - Mend

claude-presentation-master 1.0.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/LICENSE +1 -1
package/README.md +383 -603
package/assets/presentation-engine.css +410 -0
package/assets/presentation-knowledge.yaml +707 -0
package/bin/cli.js +57 -21
package/dist/index.d.mts +935 -81
package/dist/index.d.ts +935 -81
package/dist/index.js +8923 -1410
package/dist/index.mjs +8915 -1410
package/package.json +13 -12

package/README.md CHANGED Viewed

@@ -2,762 +2,542 @@
 <div align="center">
-![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
-![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)
+![NPM Version](https://img.shields.io/npm/v/claude-presentation-master)
+![Downloads](https://img.shields.io/npm/dm/claude-presentation-master)
 ![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)
-![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)
+![Zero Cost](https://img.shields.io/badge/cost-FREE-success)
-**Generate world-class presentations using expert methodologies from the world's best presentation coaches.**
+### World-Class Presentations from Any Content — Zero Cost, Zero API Keys
-[Installation](#installation) •
-[Quick Start](#quick-start) •
-[Documentation](#documentation) •
-[Examples](#examples) •
-[API Reference](#api-reference)
+**7 Presentation Types • Expert Methodologies • QA Validation • Auto-Remediation**
+[Install Now](#installation) •
+[See It Work](#quick-start) •
+[Presentation Types](#7-presentation-types) •
+[Expert Knowledge](#the-knowledge-base)
 </div>
 ---
-## What is Claude Presentation Master?
-Claude Presentation Master is a TypeScript/Node.js library that transforms your content into professionally designed presentations. Unlike simple slide generators, it applies proven methodologies from world-renowned presentation experts:
-- **Nancy Duarte** (Slide:ology, Resonate) - Sparkline narrative structure, STAR moments
-- **Garr Reynolds** (Presentation Zen) - Signal-to-noise ratio, visual simplicity
-- **Carmine Gallo** (Talk Like TED) - Rule of Three, emotional connection
-- **Chris Anderson** (TED Talks) - One powerful idea per presentation
-- **Barbara Minto** (McKinsey) - Pyramid Principle, SCQA structure
+## What's New in v2.1.0
-The library enforces quality through **real visual validation** using Playwright, ensuring your presentations meet a 95/100 minimum quality score before they're considered complete.
-### Key Differentiators
-| Feature | Other Tools | Claude Presentation Master |
-|---------|-------------|---------------------------|
-| Quality Control | None or basic linting | Real visual QA with Playwright screenshots |
-| Expert Methods | Generic templates | 40+ expert methodologies encoded |
-| Word Limits | User must count | Automatically enforced per mode |
-| Layout Validation | None | Whitespace %, balance, contrast measured |
-| Accessibility | Often ignored | WCAG AA compliance built-in |
-| API Dependency | Usually required | **Works 100% offline** |
+- **7 Specialized Presentation Types** — TED Keynote, Sales Pitch, Consulting Deck, Investment Banking, Investor Pitch, Technical Presentation, All Hands
+- **Strategy Pattern Architecture** — Each type uses its own expert methodology (Duarte for keynotes, Minto for consulting, etc.)
+- **Investment Banking Charts** — Football field, waterfall, sources & uses tables, comparable companies analysis
+- **Professional Typography** — Google Fonts for each presentation type (Libre Baskerville for IB, Space Grotesk for technical, etc.)
+- **Hallucination Detection** — Zero-tolerance fact checking ensures all content is sourced from your input
+- **Auto-Remediation** — Automatically fixes quality issues until 95/100 threshold is met
+- **100% Zero Cost** — No API keys, no subscriptions, runs entirely on your machine
 ---
-## Installation
+## The Scenario
-```bash
-# npm
-npm install claude-presentation-master
+You're deep in a Claude Code session. You've built something real:
+- A product strategy
+- A quarterly business review
+- An investor pitch
+- A project plan
+- A competitive analysis
-# yarn
-yarn add claude-presentation-master
+Now you need slides.
-# pnpm
-pnpm add claude-presentation-master
-```
+**What usually happens:**
-### Post-Installation
+You ask Claude to make a presentation. You get walls of text, generic bullet points, and amateur formatting. You spend the next two hours manually fixing everything in PowerPoint. Or you give up and just build it from scratch.
-The first time you run visual QA, Playwright will download browser binaries:
+**What happens with this library:**
-```bash
-npx playwright install chromium
+```
+Your Claude project context
+         ↓
+   One command
+         ↓
+Professional presentation (HTML or PowerPoint)
+Ready to present. Ready to send to clients.
 ```
 ---
-## Quick Start
-### Option 1: CLI (Command Line)
+## 7 Presentation Types
-```bash
-# Generate a keynote-style presentation
-cpm generate my-content.md --mode keynote --format html,pptx
+The engine automatically detects your content and applies the right expert methodology:
-# Validate an existing presentation
-cpm validate presentation.html --mode keynote
+| Type | Expert Methodology | Visual Style | Best For |
+|------|-------------------|--------------|----------|
+| **TED Keynote** | Nancy Duarte (Sparkline) | Bold, minimal, black backgrounds | Conference talks, inspiration |
+| **Sales Pitch** | Robert Cialdini (Persuasion) | Trust blue, success green | Closing deals, demos |
+| **Consulting Deck** | Barbara Minto (Pyramid Principle) | McKinsey blue, action titles | Strategy, recommendations |
+| **Investment Banking** | Analyst Academy | Navy + gold, serif fonts | M&A, valuations, pitchbooks |
+| **Investor Pitch** | Sequoia/YC frameworks | Clean, startup purple | Fundraising, board decks |
+| **Technical Presentation** | Edward Tufte (Data-ink) | Dark mode, Space Grotesk | Architecture, engineering |
+| **All Hands Meeting** | Internal comms best practices | Corporate blue, win green | Company updates, celebrations |
-# See all options
-cpm --help
-```
+### Investment Banking Specialty Charts
-### Option 2: Programmatic API
+For IB presentations, the engine generates industry-standard visualizations:
 ```typescript
-import { generate } from 'claude-presentation-master';
-import { writeFileSync } from 'fs';
-const result = await generate({
-  content: `
-# Revolutionizing Customer Experience
-## The Problem
-Today's customers expect instant, personalized service.
-Yet 73% report frustration with current support systems.
-## Our Solution
-AI-powered support that understands context and delivers
-human-quality responses in seconds, not hours.
-## The Results
-- 90% faster resolution times
-- 4.8/5 customer satisfaction
-- 60% cost reduction
+// Football Field Valuation Chart
+engine.addFootballFieldChart(slide, {
+  title: 'Valuation Summary',
+  methodologies: [
+    { name: 'DCF', low: 42, mid: 48, high: 55 },
+    { name: 'Comps', low: 38, mid: 45, high: 52 },
+    { name: 'Precedents', low: 44, mid: 50, high: 58 }
+  ],
+  currentPrice: 46
+});
-## Next Steps
-Join our pilot program and transform your customer experience.
-  `,
-  contentType: 'markdown',
-  mode: 'keynote',
-  format: ['html', 'pptx'],
-  title: 'Customer Experience Revolution',
-  author: 'Your Name',
-  qaThreshold: 95
+// Waterfall Chart
+engine.addWaterfallChart(slide, {
+  title: 'Enterprise Value Bridge',
+  startLabel: 'Equity Value',
+  startValue: 850000,
+  steps: [
+    { label: 'Plus: Debt', value: 250000 },
+    { label: 'Less: Cash', value: -150000 },
+    { label: 'EV', value: 950000, isTotal: true }
+  ]
 });
-// Check the quality score
-console.log(`Quality Score: ${result.score}/100`);
-console.log(`Slide Count: ${result.metadata.slideCount}`);
-console.log(`Frameworks Applied: ${result.metadata.frameworks.join(', ')}`);
+// Sources & Uses Table
+engine.addSourcesUsesTable(slide, {
+  title: 'Transaction Financing',
+  sources: [
+    { label: 'Senior Debt', amount: 500000 },
+    { label: 'Equity', amount: 300000 }
+  ],
+  uses: [
+    { label: 'Purchase Price', amount: 750000 },
+    { label: 'Fees & Expenses', amount: 50000 }
+  ]
+});
-// Save the outputs
-if (result.outputs.html) {
-  writeFileSync('presentation.html', result.outputs.html);
-}
-if (result.outputs.pptx) {
-  writeFileSync('presentation.pptx', result.outputs.pptx);
-}
+// Comparable Companies Table
+engine.addCompsTable(slide, {
+  title: 'Trading Comparables',
+  columns: ['EV/Revenue', 'EV/EBITDA', 'P/E'],
+  companies: [
+    { name: 'Company A', values: [3.2, 12.5, 18.3] },
+    { name: 'Company B', values: [2.8, 10.2, 15.7] },
+    { name: 'Target Co', values: [2.5, 9.8, 14.2], highlight: true }
+  ],
+  medianRow: true
+});
 ```
 ---
-## How It Works
-### The Pipeline
+## Professional Typography
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    YOUR CONTENT (Markdown/JSON/YAML)            │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      1. CONTENT ANALYSIS                        │
-│  • Extract SCQA structure (Situation, Complication, Question,   │
-│    Answer) using Barbara Minto's Pyramid Principle              │
-│  • Identify Sparkline narrative arc (What Is vs What Could Be)  │
-│  • Find STAR moments (Something They'll Always Remember)        │
-│  • Extract key messages (max 3 - Rule of Three)                 │
-│  • Generate action titles (McKinsey style)                      │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      2. SLIDE GENERATION                        │
-│  • Select appropriate slide types based on content              │
-│  • Apply mode constraints (keynote: 6-25 words, business: 40-80)│
-│  • Structure narrative flow with proper pacing                  │
-│  • Add section dividers, transitions, and closing               │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      3. OUTPUT GENERATION                       │
-│  • HTML: Reveal.js with animations, Chart.js, Mermaid           │
-│  • PPTX: PptxGenJS with proper positioning and styling          │
-│  • Apply theme colors, typography, and visual hierarchy         │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      4. QA VALIDATION                           │
-│  • Screenshot each slide with Playwright                        │
-│  • Calculate whitespace percentage (target: 35%+ keynote)       │
-│  • Measure layout balance (center of mass analysis)             │
-│  • Check contrast ratios (WCAG 4.5:1 minimum)                   │
-│  • Validate expert principle compliance                         │
-│  • Generate 0-100 score with detailed breakdown                 │
-└─────────────────────────────────────────────────────────────────┘
-                                │
-                                ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                    5. THRESHOLD ENFORCEMENT                     │
-│  • Score >= 95: ✅ Return presentation                          │
-│  • Score < 95: ❌ Throw QAFailureError with improvement list    │
-└─────────────────────────────────────────────────────────────────┘
-```
-### The Knowledge Base
+Each presentation type loads appropriate Google Fonts (zero cost):
-The package includes a 6,300+ line knowledge base (`presentation-knowledge.yaml`) containing:
-- **40+ Expert Methodologies**: Encoded principles from presentation masters
-- **Framework Selector**: Automatically chooses the best framework for your audience
-- **Slide Type Definitions**: 20+ slide types with constraints and templates
-- **QA Scoring Rubric**: Detailed validation rules with point values
-- **Mode Configurations**: Keynote vs Business rules and limits
-This knowledge base powers every decision the engine makes, ensuring expert-level quality without requiring AI API calls.
+| Type | Heading Font | Body Font | Personality |
+|------|-------------|-----------|-------------|
+| TED Keynote | DM Sans | DM Sans | Modern, bold |
+| Sales Pitch | Poppins | Poppins | Friendly, approachable |
+| Consulting | IBM Plex Sans | IBM Plex Sans | Clean, corporate |
+| Investment Banking | Libre Baskerville | IBM Plex Sans | Classic, authoritative |
+| Investor Pitch | DM Sans | Source Sans Pro | Startup, modern |
+| Technical | Space Grotesk | Source Sans Pro | Precision, engineering |
+| All Hands | Source Sans Pro | Source Sans Pro | Clear, professional |
 ---
-## Presentation Modes
+## Quality Assurance System
-### Keynote Mode
+### Bulletproof QA Pipeline
-Optimized for **high-impact presentations** like TED talks, product launches, and keynotes.
+Every presentation goes through a rigorous validation pipeline:
-| Constraint | Value |
-|------------|-------|
-| Words per slide | 6-25 maximum |
-| Whitespace | 35%+ of slide area |
-| Ideas per slide | Exactly 1 |
-| Bullet points | Avoided (use single statements) |
-| Reading time | < 3 seconds per slide |
+```
+Content Analysis → Slide Generation → QA Validation → Auto-Remediation → Final Output
+                                           ↓
+                           [Loops until 95/100 threshold met]
+```
-**Best for**: Conferences, product launches, investor pitches, inspirational talks
+### What Gets Validated
-### Business Mode
+| Category | Checks |
+|----------|--------|
+| **Content** | Word count per slide, bullet count, one-idea-per-slide |
+| **Visual** | Whitespace %, font consistency, color count |
+| **Structure** | Title slide present, conclusion slide, logical flow |
+| **Expert Rules** | Glance test (3-second rule), Rule of Three, Pyramid structure |
+| **Accessibility** | WCAG contrast ratios, minimum font sizes |
+| **Hallucination** | Every fact must be traceable to source content |
-Optimized for **information-rich presentations** like board meetings, strategy reviews, and training.
+### Hallucination Detection
-| Constraint | Value |
-|------------|-------|
-| Words per slide | 40-80 |
-| Whitespace | 25%+ of slide area |
-| Ideas per slide | 1-2 maximum |
-| Bullet points | Up to 5 per slide |
-| Data density | Medium to high |
+The engine includes a **zero-tolerance hallucination detector**:
-**Best for**: Board meetings, quarterly reviews, training sessions, documentation
+```typescript
+// The engine checks every statistic, quote, and claim
+const factCheck = await hallucinationDetector.checkForHallucinations(
+  slides,
+  originalContent,
+  contentAnalysis
+);
+// If unverified facts are found, they're automatically flagged and removed
+if (!factCheck.passed) {
+  slides = hallucinationDetector.remediate(slides, factCheck);
+  console.log(`Removed ${factCheck.issues.length} unverified claims`);
+}
+```
 ---
-## Slide Types
+## Installation
-### Universal Slides (Both Modes)
-| Type | Description | Use Case |
-|------|-------------|----------|
-| `title` | Opening slide with title and subtitle | Always first |
-| `section-divider` | Section break with dark background | Between major sections |
-| `quote` | Blockquote with attribution | Expert quotes, testimonials |
-| `big-number` | Large statistic with context | Dramatic data points |
-| `cta` | Call to action | Near the end |
-| `thank-you` | Closing slide | Always last |
-### Keynote-Specific Slides
-| Type | Description | Use Case |
-|------|-------------|----------|
-| `big-idea` | Single powerful statement, large text | Core message delivery |
-| `single-statement` | One sentence, centered | Key points |
-| `full-image` | Full-bleed image with text overlay | Emotional impact |
-### Business-Specific Slides
-| Type | Description | Use Case |
-|------|-------------|----------|
-| `agenda` | Numbered list of topics | After title slide |
-| `bullet-points` | Title with bullet list | Detailed information |
-| `two-column` | Split layout (text + image/data) | Comparison, illustration |
-| `three-column` | Three equal columns | Feature comparison |
-| `comparison` | Side-by-side with divider | Before/after, pros/cons |
-| `timeline` | Chronological events | History, roadmap |
-| `process` | Step-by-step flow with arrows | Workflows, procedures |
-| `metrics-grid` | KPI dashboard layout | Performance data |
-| `screenshot` | Product screenshot with caption | Demo, walkthrough |
-| `screenshot-left` | Screenshot on left, text on right | Feature explanation |
-| `screenshot-right` | Text on left, screenshot on right | Feature explanation |
-| `social-proof` | Customer testimonials | Trust building |
-| `case-study` | Challenge/Solution/Results | Customer success |
-| `pricing` | Pricing table | Sales presentations |
-| `team` | Team member grid | About us |
-| `features` | Feature list with icons | Product overview |
+```bash
+npm install claude-presentation-master
+```
----
+**Optional** (for visual regression testing):
+```bash
+npx playwright install chromium
+```
-## Themes
+That's it. **No API keys. No subscriptions. Zero cost.**
-```typescript
-type ThemeName =
-  | 'default'         // Clean, professional
-  | 'light-corporate' // Traditional business
-  | 'modern-tech'     // Contemporary tech look
-  | 'minimal'         // Maximum whitespace, B&W
-  | 'warm'            // Earthy, approachable
-  | 'creative';       // Bold, artistic
-```
+---
-### Theme Preview
+## Quick Start
-| Theme | Primary | Accent | Best For |
-|-------|---------|--------|----------|
-| `default` | Dark navy | Coral red | General use |
-| `light-corporate` | Slate blue | Ocean blue | Enterprise, finance |
-| `modern-tech` | Deep navy | Electric pink | Startups, tech |
-| `minimal` | Pure black | Black | Design, luxury |
-| `warm` | Brown | Orange | Food, hospitality |
-| `creative` | Purple | Pink | Marketing, design |
+### From the Command Line
----
+```bash
+# TED-style keynote presentation
+cpm generate keynote-talk.md --mode keynote --format html
-## QA Scoring System
+# Consulting strategy deck
+cpm generate strategy.md --mode business --format pptx
-Every presentation is validated against a 100-point rubric:
+# Investment banking pitchbook
+cpm generate deal-memo.md --type investment_banking --format pptx
-### Score Breakdown
+# Generate both formats
+cpm generate quarterly-review.md --mode business --format html,pptx
+```
-| Category | Weight | What's Checked |
-|----------|--------|----------------|
-| **Visual Quality** | 35% | Whitespace %, layout balance, contrast ratio, font count, color count |
-| **Content Quality** | 30% | Word limits, action titles, glance test, signal-to-noise, one idea rule |
-| **Expert Compliance** | 25% | Duarte, Reynolds, Gallo, Anderson principles |
-| **Accessibility** | 10% | WCAG level, contrast issues, font sizes, color-blind safety |
+### From Your Code
-### Grading Scale
+```typescript
+import { PresentationEngine } from 'claude-presentation-master';
-| Score | Grade | Status |
-|-------|-------|--------|
-| 95-100 | A+ | ✅ Excellent - Ready to present |
-| 90-94 | A | ⚠️ Good - Minor improvements suggested |
-| 85-89 | A- | ⚠️ Acceptable - Several issues to address |
-| 80-84 | B+ | ❌ Below standard - Significant issues |
-| < 80 | B or lower | ❌ Fails - Major redesign needed |
+const engine = new PresentationEngine();
-### Threshold Enforcement
+const result = await engine.generate({
+  content: `
+# Series A Pitch
-By default, the library **rejects presentations scoring below 95**:
+## The Problem
+Enterprise teams waste 40% of time on manual data entry.
+$50B market. Growing 23% annually.
-```typescript
-try {
-  const result = await generate(config);
-} catch (error) {
-  if (error instanceof QAFailureError) {
-    console.log(`Score: ${error.score}/100`);
-    console.log(`Threshold: ${error.threshold}`);
-    console.log('Issues to fix:');
-    error.getIssues().forEach(issue => console.log(`  - ${issue}`));
-  }
-}
-```
+## Our Solution
+AI-powered automation that learns from your workflow.
+Currently serving 150 enterprise customers.
-You can lower the threshold (not recommended):
+## Traction
+- $2.4M ARR (up from $800K last year)
+- 94% customer retention
+- NPS score of 72
-```typescript
-const result = await generate({
-  ...config,
-  qaThreshold: 80  // Accept lower quality (NOT RECOMMENDED)
+## The Ask
+Raising $15M to expand into Europe and build enterprise sales team.
+  `,
+  contentType: 'markdown',
+  title: 'Series A Pitch',
+  mode: 'keynote',
+  format: ['html', 'pptx'],
+  author: 'Founder Name'
 });
-```
----
-## Media Providers
+// Guaranteed 95/100 quality or higher
+console.log(`Score: ${result.score}/100`);
+console.log(`Grade: ${result.metadata.grade}`);
-All media features work **without API keys**.
+// Save outputs
+fs.writeFileSync('pitch.html', result.outputs.html);
+fs.writeFileSync('pitch.pptx', result.outputs.pptx);
+```
-### Images
+### Specifying Presentation Type
 ```typescript
-import { createDefaultImageProvider } from 'claude-presentation-master';
-// Default: Uses placeholder images (picsum.photos)
-const provider = createDefaultImageProvider();
-// With local images
-const provider = createDefaultImageProvider({
-  localImages: {
-    'team-photo': './images/team.jpg',
-    'product-screenshot': './images/product.png',
-    'logo': './images/logo.svg'
-  }
+// Let the engine auto-detect (recommended)
+const result = await engine.generate({
+  content: dealMemo,
+  mode: 'business',
+  format: ['pptx']
 });
+// Engine detects "investment_banking" from content keywords
-// With Unsplash (optional API key for better rate limits)
-const provider = createDefaultImageProvider({
-  unsplashKey: process.env.UNSPLASH_ACCESS_KEY  // Optional
+// Or specify explicitly
+const result = await engine.generate({
+  content: techSpec,
+  mode: 'keynote',
+  presentationType: 'technical_presentation',
+  format: ['html']
 });
 ```
-**Image Provider Priority:**
-1. Local images (exact match)
-2. Unsplash API (if key provided)
-3. Unsplash Source (no key needed)
-4. Placeholder (always works)
+---
-### Charts
+## The Knowledge Base
-```typescript
-import { createDefaultChartProvider } from 'claude-presentation-master';
-const chartProvider = createDefaultChartProvider();
-// Generate a chart
-const chart = await chartProvider.generateChart({
-  type: 'bar',
-  data: {
-    labels: ['Q1', 'Q2', 'Q3', 'Q4'],
-    datasets: [{
-      label: 'Revenue ($M)',
-      data: [10, 15, 22, 31]
-    }]
-  },
-  title: 'Quarterly Revenue Growth',
-  palette: 'professional'  // 'default' | 'professional' | 'vibrant' | 'monochrome'
-});
+This isn't a template library. It's a **complete expert system** — 6,300+ lines of encoded expertise.
-// chart.html - For HTML output (Chart.js canvas)
-// chart.imageUrl - For PPTX output (QuickChart.io URL)
-```
+### What's Inside
-**Supported Chart Types:**
-- `bar` - Bar chart
-- `line` - Line chart
-- `pie` - Pie chart
-- `doughnut` - Doughnut chart
-- `radar` - Radar chart
-- `polarArea` - Polar area chart
-- `scatter` - Scatter plot
-- `bubble` - Bubble chart
+**From McKinsey, BCG, Bain:**
+- Pyramid Principle — Lead with the answer
+- SCQA Framework — Situation → Complication → Question → Answer
+- Action Titles — "Revenue grew 23%" not "Revenue Analysis"
+- One Message Per Slide — Every slide has exactly one job
+- Chart Callouts — Always tell the audience what to see
-### Diagrams (Mermaid)
+**From Nancy Duarte (Slide:ology, Resonate):**
+- Sparkline Structure — Alternate between "what is" and "what could be"
+- STAR Moments — Something They'll Always Remember
+- Glance Test — Understand it in 3 seconds or less
+- Signal-to-Noise — Maximize meaning, eliminate clutter
-```typescript
-const chartProvider = createDefaultChartProvider();
-// Generate flowchart
-const flowchart = chartProvider.generateFlowchart([
-  { id: 'A', label: 'Start', next: ['B'] },
-  { id: 'B', label: 'Process', next: ['C', 'D'] },
-  { id: 'C', label: 'Option 1', next: ['E'] },
-  { id: 'D', label: 'Option 2', next: ['E'] },
-  { id: 'E', label: 'End' }
-]);
-// Generate timeline
-const timeline = chartProvider.generateTimeline([
-  { date: '2020', title: 'Company Founded' },
-  { date: '2021', title: 'Series A' },
-  { date: '2022', title: 'Product Launch' },
-  { date: '2023', title: '1M Users' }
-]);
-```
+**From Garr Reynolds (Presentation Zen):**
+- Simplicity — When in doubt, leave it out
+- Restraint — Resist the urge to add
+- Visual over Verbal — Show, don't tell
----
+**From Carmine Gallo (Talk Like TED):**
+- Rule of Three — Human memory works in threes
+- 18-Minute Rule — Optimal presentation length
+- Emotional Connection — Touch hearts before minds
-## API Reference
+**From Edward Tufte:**
+- Data-Ink Ratio — Every drop of ink should represent data
+- Chartjunk Elimination — No 3D effects, no decorative gridlines
+- Graphical Integrity — Never distort data for visual effect
-### `generate(config)`
+**From Barbara Minto (The Pyramid Principle):**
+- Top-Down Communication — Conclusion first, support second
+- MECE Grouping — Mutually Exclusive, Collectively Exhaustive
+- Vertical Logic — Each level supports the one above
-Generate a presentation from content.
+**From Robert Cialdini (Influence):**
+- Social Proof — Show who else succeeded
+- Scarcity — Limited time, limited availability
+- Authority — Credentials and expertise
+- Reciprocity — Give value first
-```typescript
-async function generate(config: PresentationConfig): Promise<PresentationResult>
-```
+---
-**Parameters:**
+## Two Modes × Seven Types
-```typescript
-interface PresentationConfig {
-  // Required
-  content: string;                    // Your content
-  contentType: 'markdown' | 'json' | 'yaml' | 'text';
-  mode: 'keynote' | 'business';
-  format: ('html' | 'pptx')[];
-  title: string;
+### Presentation Modes
-  // Optional
-  theme?: ThemeName;                  // Default: 'default'
-  author?: string;
-  subject?: string;
-  qaThreshold?: number;               // Default: 95
-  skipQA?: boolean;                   // Default: false (NOT RECOMMENDED)
-  minify?: boolean;                   // Minify HTML output
-  customCSS?: string;                 // Additional CSS
-  customTemplates?: Record<string, string>;  // Handlebars overrides
-}
-```
+**Keynote Mode** — For inspiring and persuading
+- 6-15 words per slide (like Steve Jobs)
+- 40%+ whitespace
+- One idea per slide
+- Emotional narrative structure
+- Big visuals, minimal text
-**Returns:**
+**Business Mode** — For informing and documenting
+- 40-80 words per slide
+- Action titles (full sentences that state conclusions)
+- Data with callouts
+- Structured with Pyramid Principle
+- Charts, tables, metrics grids
-```typescript
-interface PresentationResult {
-  outputs: {
-    html?: string;      // Reveal.js HTML
-    pptx?: Buffer;      // PowerPoint file
-  };
-  qaResults: QAResults; // Detailed QA breakdown
-  score: number;        // 0-100 quality score
-  metadata: {
-    title: string;
-    author: string;
-    generatedAt: string;
-    mode: 'keynote' | 'business';
-    slideCount: number;
-    wordCount: number;
-    avgWordsPerSlide: number;
-    estimatedDuration: number;  // Minutes
-    frameworks: string[];       // Applied expert frameworks
-  };
-}
-```
+### Presentation Types (Auto-Detected)
-### `validate(presentation, options)`
+| Keyword Triggers | Detected Type |
+|-----------------|---------------|
+| "TED", "keynote", "inspire" | `ted_keynote` |
+| "sales", "demo", "prospect" | `sales_pitch` |
+| "strategy", "recommendation", "McKinsey" | `consulting_deck` |
+| "M&A", "valuation", "DCF", "pitchbook" | `investment_banking` |
+| "Series A", "raise", "investor" | `investor_pitch` |
+| "API", "architecture", "system design" | `technical_presentation` |
+| "all hands", "company update", "quarterly" | `all_hands` |
-Validate an existing HTML presentation.
+---
-```typescript
-async function validate(
-  presentation: string | Buffer,
-  options?: {
-    mode?: 'keynote' | 'business';
-    threshold?: number;
-    strictMode?: boolean;
-  }
-): Promise<QAResults & { score: number }>
-```
+## Output Formats
-### Error Classes
+### HTML Presentations (Reveal.js)
-```typescript
-// Thrown when configuration is invalid
-class ValidationError extends Error {
-  errors: string[];
-}
+Modern, web-native slides:
+- Share via URL — just send a link
+- Works on any device — desktop, tablet, phone
+- Keyboard shortcuts: `S` for speaker notes, `F` for fullscreen
+- Embedded CSS with presentation-type-specific theming
+- Glass morphism effects, smooth transitions
-// Thrown when QA score is below threshold
-class QAFailureError extends Error {
-  score: number;
-  threshold: number;
-  qaResults: QAResults;
+### PowerPoint (PPTX)
-  getIssues(): string[];  // List of issues to fix
-}
-```
+Traditional format:
+- Opens in Microsoft PowerPoint
+- Fully editable
+- Send to clients who expect PPTX
+- Print to PDF for handouts
+- Includes IB specialty charts (football field, waterfall, etc.)
 ---
-## CLI Reference
+## Quality Scores
-```
-Claude Presentation Master v1.0.0
-USAGE:
-  cpm <command> [options]
-COMMANDS:
-  generate <input>    Generate presentation from input file
-  validate <file>     Validate an existing HTML presentation
-  info                Show package information
-OPTIONS:
-  -o, --output <dir>  Output directory (default: ./output)
-  -m, --mode <mode>   keynote or business (default: keynote)
-  -f, --format <fmt>  html, pptx, or html,pptx (default: html)
-  -t, --theme <name>  Theme name
-  --title <title>     Presentation title
-  --author <name>     Author name
-  --threshold <num>   QA threshold 0-100 (default: 95)
-  --skip-qa           Skip QA (NOT recommended)
-  -h, --help          Show help
-  -v, --version       Show version
-EXAMPLES:
-  cpm generate deck.md -m keynote -f html,pptx
-  cpm generate report.yaml -m business -o ./slides
-  cpm validate presentation.html --threshold 90
-```
+Every presentation gets a quality score:
+| Score | Grade | Status |
+|-------|-------|--------|
+| 97-100 | A+ | Exceptional |
+| 93-96 | A | Excellent |
+| 90-92 | A- | Very Good |
+| 85-89 | B+ | Good |
+| 80-84 | B | Acceptable |
+| 75-79 | B- | Needs Work |
+| < 75 | C or below | Blocked (auto-remediation applied) |
+**Default threshold: 95/100**
+The engine will automatically remediate issues (up to 5 iterations) until the threshold is met. If it can't reach 95, it delivers the best result with a detailed report of remaining issues.
 ---
-## Examples
+## Zero Cost Guarantee
-### Example 1: Investor Pitch (Keynote Mode)
+| Component | Cost | Notes |
+|-----------|------|-------|
+| NPM Package | FREE | MIT License |
+| Dependencies | FREE | pptxgenjs, reveal.js, marked, etc. |
+| Fonts | FREE | Google Fonts CDN |
+| QA Validation | FREE | Built-in validators |
+| Visual Testing | FREE | Playwright (optional) |
+| API Keys | NONE | Runs 100% locally |
-```typescript
-const result = await generate({
-  content: `
-# Acme AI - Revolutionizing Customer Support
+**No subscriptions. No usage limits. No API costs.**
-## The $400B Problem
-Companies spend $400 billion annually on customer support.
-Yet 67% of customers prefer self-service over speaking to a representative.
+---
-## Our Solution
-Acme AI delivers human-quality support responses in under 3 seconds,
-handling 80% of inquiries without human intervention.
+## FAQ
-## Traction
-- 50+ enterprise customers
-- $5M ARR (300% YoY growth)
-- 95% customer retention
+**Does this require an API key?**
+No. Everything runs locally on your machine.
-## The Team
-Former leaders from Google, Amazon, and Salesforce
-with 50+ years combined experience in AI and customer success.
+**What's the difference between mode and type?**
+- **Mode** (`keynote` or `business`) controls word counts and visual density
+- **Type** (e.g., `investment_banking`) selects the expert methodology and theming
-## The Ask
-$20M Series B to expand into European markets
-and launch our enterprise platform.
-  `,
-  contentType: 'markdown',
-  mode: 'keynote',
-  format: ['html', 'pptx'],
-  title: 'Acme AI - Series B',
-  theme: 'modern-tech'
-});
-```
+**Can I customize the output?**
+Yes. HTML is just HTML. PPTX opens in PowerPoint. Edit freely.
-### Example 2: Quarterly Business Review (Business Mode)
+**What if I don't like the auto-detected type?**
+Specify it explicitly: `presentationType: 'consulting_deck'`
-```typescript
-const result = await generate({
-  content: `
-# Q4 2024 Business Review
-## Executive Summary
-Q4 exceeded targets across all key metrics.
-Revenue grew 25% QoQ while maintaining profitability.
-## Financial Performance
-- Revenue: $12.5M (+25% QoQ)
-- Gross Margin: 72% (+3pp)
-- Operating Expenses: $8.2M (-5%)
-- Net Income: $1.8M (first profitable quarter)
-## Customer Metrics
-- New Customers: 127 (+40%)
-- Churn Rate: 2.1% (-0.5pp)
-- NPS Score: 72 (+8 points)
-- Average Contract Value: $45,000 (+15%)
-## Product Updates
-1. Launched AI Assistant v2.0
-2. Released mobile app for iOS and Android
-3. Added 15 new integrations
-4. Improved API response time by 40%
-## Challenges
-- Hiring senior engineers remains difficult
-- Supply chain issues delayed hardware launch
-- Competitor launched similar feature
-## Q1 2025 Priorities
-1. Launch enterprise tier
-2. Expand sales team by 5 reps
-3. Open European data center
-4. Achieve SOC 2 Type II certification
-  `,
-  contentType: 'markdown',
-  mode: 'business',
-  format: ['html', 'pptx'],
-  title: 'Q4 2024 Business Review',
-  theme: 'light-corporate'
-});
-```
+**Does it work with Claude Code?**
+Yes — that's exactly what it's designed for.
-### Example 3: With Custom Templates
+**What about images?**
+The engine generates placeholder boxes. Replace with your actual images.
-```typescript
-const result = await generate({
-  content: myContent,
-  contentType: 'markdown',
-  mode: 'keynote',
-  format: ['html'],
-  title: 'Custom Presentation',
-  customTemplates: {
-    'title': `
-      <section class="slide slide-title custom-title">
-        <div class="slide-content">
-          <div class="logo">YOUR LOGO</div>
-          <h1>{{title}}</h1>
-          <p class="subtitle">{{subtitle}}</p>
-          <p class="date">{{date}}</p>
-        </div>
-      </section>
-    `
-  },
-  customCSS: `
-    .custom-title {
-      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-    }
-    .custom-title h1 {
-      color: white;
-    }
-  `
-});
-```
+**Can I lower the quality threshold?**
+Yes, but not recommended: `qaThreshold: 80`
 ---
-## Troubleshooting
+## Themes
-### "QA score below threshold"
+| Theme | Look | Best For |
+|-------|------|----------|
+| `default` | Dark executive | General use |
+| `consulting-classic` | Cream + navy | McKinsey/BCG style |
+| `modern-tech` | Light + teal | Startups |
+| `minimal` | Maximum whitespace | Design-focused |
+| `dark-executive` | Dark mode | Screen presentations |
+| `investment-banking` | Navy + gold | Finance |
-Your presentation didn't meet the 95/100 quality bar. Check the error for specific issues:
+---
-```typescript
-catch (error) {
-  if (error instanceof QAFailureError) {
-    console.log('Issues to fix:');
-    error.getIssues().forEach(issue => {
-      console.log(`  - ${issue}`);
-    });
-  }
-}
-```
+## Slide Types
-Common fixes:
-- Reduce word count per slide (keynote: max 25, business: max 80)
-- Increase whitespace (remove clutter)
-- Ensure proper contrast (4.5:1 minimum)
-- Use only 1-2 font families
-- Limit colors to 5 or fewer
+**Keynote Mode:**
+Title • Big Idea • Single Statement • Full Image • Big Number • Quote • CTA • Thank You
-### "Playwright browsers not found"
+**Business Mode:**
+Title • Agenda • Bullet Points • Two Column • Three Column • Metrics Grid • Timeline • Process Flow • Comparison • Case Study • Section Divider • Thank You
-Run the Playwright installation:
+**Investment Banking (PPTX):**
+Football Field Chart • Waterfall Chart • Sources & Uses Table • Comparable Companies Table
-```bash
-npx playwright install chromium
-```
+---
-### "Module not found"
+## API Reference
-Ensure you've built the package:
+### PresentationEngine
-```bash
-npm run build
-```
+```typescript
+const engine = new PresentationEngine();
----
+const result = await engine.generate({
+  // Required
+  content: string,           // Your source content
+  title: string,             // Presentation title
+  mode: 'keynote' | 'business',
+  format: ('html' | 'pptx')[],
-## Contributing
+  // Optional
+  contentType?: 'markdown' | 'text' | 'html',
+  presentationType?: PresentationType,  // Auto-detected if omitted
+  author?: string,
+  theme?: string,
+  qaThreshold?: number,      // Default: 95
+});
-See [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for development setup and guidelines.
+// Result
+interface PresentationResult {
+  outputs: {
+    html?: string,
+    pptx?: Buffer
+  },
+  score: number,             // Quality score 0-100
+  qaResults: QAResults,      // Detailed validation results
+  metadata: PresentationMetadata
+}
+```
 ---
 ## License
-MIT License - see [LICENSE](./LICENSE) for details.
+MIT — free to use, modify, and distribute.
 ---
 ## Author
-**Stuart Kerr**
-<stuart@isovision.ai>
-[Isovision.ai](https://isovision.ai)
+**Stuart Kerr** — [Isovision.ai](https://isovision.ai)
+Questions? [stuart@isovision.ai](mailto:stuart@isovision.ai)
 ---
 <div align="center">
-**Built with expert methodologies from the world's best presentation coaches.**
+**Stop fighting with slides. Start presenting.**
+```bash
+npm install claude-presentation-master
+```
+**100% Free • Zero API Keys • Runs Locally**
-Nancy Duarte • Garr Reynolds • Carmine Gallo • Chris Anderson • Barbara Minto
+Built on methodologies from:
+McKinsey • BCG • Bain • Nancy Duarte • Garr Reynolds • Carmine Gallo
+Chris Anderson • Barbara Minto • Edward Tufte • Robert Cialdini
 </div>