@thanh01.pmt/presentation-kit 0.2.1 → 0.2.3

package/dist/ai/index.js

@@ -0,0 +1,417 @@
+import { SLIDE_LAYOUT_PRESETS, getSlideLayoutPresetsByCategory, getSlideLayoutPresetById, serializeLayoutToComment, updateSlideLayoutInMarkdown, splitMarkdownSlides } from '../chunk-3IKL6SBP.js';
+import { z } from 'zod';
+
+var listSlidePresetsSchema = z.object({
+  category: z.enum([
+    "all",
+    "cover",
+    "content",
+    "split",
+    "code",
+    "metrics",
+    "diagram",
+    "quote",
+    "assessment"
+  ]).optional().describe("Optional category filter for layout presets")
+});
+var createSlideFromPresetSchema = z.object({
+  presetId: z.string().describe(
+    "ID of the layout preset: title-hero, two-column-split, code-explainer, metrics-3-card, process-flow, quote-highlight, quiz-checkpoint, tiered-practice-3cards, agenda-timeline, takeaways-summary"
+  ),
+  title: z.string().describe("Slide heading or title"),
+  subtitle: z.string().optional().describe("Optional subtitle or section context"),
+  content: z.record(z.string()).optional().describe(
+    "Key-value pairs for preset sections. For two-column-split: leftCol, rightCol. For code-explainer: code, language, notes. For metrics-3-card: card1Title, card1Val, card1Desc, etc."
+  ),
+  customMarkdownBody: z.string().optional().describe(
+    "Raw markdown body to place inside the layout container (overrides content key-value pairs if provided)"
+  ),
+  presenterNotes: z.array(z.string()).optional().describe(
+    "Teacher talk track, cold-call check questions, or scaffolding notes for this slide"
+  )
+});
+var applySlideLayoutSchema = z.object({
+  markdown: z.string().describe("Full Markdown slide deck content"),
+  slideIndex: z.number().int().min(0).describe("0-based index of the target slide to modify"),
+  presetId: z.string().optional().describe("Optional preset ID to apply to this slide"),
+  boxes: z.array(
+    z.object({
+      id: z.string(),
+      target: z.string().optional(),
+      pos: z.tuple([z.number(), z.number(), z.number(), z.number()]).describe("[x, y, width, height] in 1280x720 canvas coordinates"),
+      fontSize: z.string().optional(),
+      color: z.string().optional(),
+      textAlign: z.enum(["left", "center", "right", "justify"]).optional(),
+      style: z.string().optional()
+    })
+  ).optional().describe("Custom boxes if not using presetId")
+});
+var updatePresenterNotesSchema = z.object({
+  markdown: z.string().describe("Full Markdown slide deck content"),
+  slideIndex: z.number().int().min(0).describe("0-based index of the target slide"),
+  notes: z.array(z.string()).describe("List of speaker notes / talk tracks to set for this slide")
+});
+var generateDeckOutlineSchema = z.object({
+  topic: z.string().describe("Main subject or topic of the presentation"),
+  durationMins: z.number().int().min(3).max(120).default(15).describe("Estimated duration in minutes (5m: 5-7 slides, 15m: 12-18 slides, 30m: 25-35 slides)"),
+  audience: z.string().describe("Target audience profile (e.g. Grade 10 students, junior developers, enterprise clients)"),
+  keyObjectives: z.array(z.string()).describe("2-4 key learning or decision objectives"),
+  techStack: z.string().optional().describe("Optional programming language, framework, or hardware kit")
+});
+
+// src/ai/tools.ts
+function executeListSlidePresets(params) {
+  const category = params?.category;
+  const presets = !category || category === "all" ? SLIDE_LAYOUT_PRESETS : getSlideLayoutPresetsByCategory(category);
+  return {
+    count: presets.length,
+    presets: presets.map((p) => ({
+      id: p.id,
+      name: p.name,
+      category: p.category,
+      description: p.description,
+      boxCount: p.layout.boxes.length,
+      snippetPreview: p.markdownSnippet.split("\n").slice(0, 8).join("\n") + "\n..."
+    }))
+  };
+}
+function executeCreateSlideFromPreset(params) {
+  const preset = getSlideLayoutPresetById(params.presetId);
+  if (!preset) {
+    return {
+      success: false,
+      slideMarkdown: "",
+      error: `Preset with ID "${params.presetId}" not found. Use listSlidePresets to see available layout templates.`
+    };
+  }
+  const layoutComment = serializeLayoutToComment(preset.layout);
+  const title = params.title;
+  const subtitle = params.subtitle ? `
+### ${params.subtitle}` : "";
+  let body = params.customMarkdownBody;
+  if (!body) {
+    const c = params.content || {};
+    switch (preset.id) {
+      case "title-hero":
+        body = `${subtitle}
+
+**Presenter:** ${c.speaker || "Lead Instructor"} | **Duration:** ${c.duration || "45 mins"} | **Topic:** ${c.topic || title}`;
+        break;
+      case "two-column-split":
+        body = `<div class="columns-2">
+<div>
+
+### ${c.leftHeader || "Approach A"}
+${c.leftCol || "- Point 1\n- Point 2\n- Point 3"}
+
+</div>
+<div>
+
+### ${c.rightHeader || "Approach B"}
+${c.rightCol || "- Point 1\n- Point 2\n- Point 3"}
+
+</div>
+</div>`;
+        break;
+      case "code-explainer":
+        body = `<div class="columns-2">
+<div>
+
+\`\`\`${c.lang || "ts"}
+${c.code || "// Core implementation logic\nconst isValid = true;"}
+\`\`\`
+
+</div>
+<div>
+
+### \u{1F50D} Key Invariants:
+${c.notes || "1. **Validation:** Checks payload before processing\n2. **Execution:** Enforces deterministic state\n3. **Resilience:** Handles edge case errors"}
+
+</div>
+</div>`;
+        break;
+      case "metrics-3-card":
+        body = `<div class="columns-3">
+<div>
+
+# ${c.metric1Val || "99.9%"}
+### ${c.metric1Title || "Availability"}
+${c.metric1Desc || "Automated multi-region failover routing."}
+
+</div>
+<div>
+
+# ${c.metric2Val || "10x"}
+### ${c.metric2Title || "Throughput"}
+${c.metric2Desc || "Sub-millisecond processing latency."}
+
+</div>
+<div>
+
+# ${c.metric3Val || "0"}
+### ${c.metric3Title || "Breaches"}
+${c.metric3Desc || "Continuous SOC2 compliance auditing."}
+
+</div>
+</div>`;
+        break;
+      case "process-flow":
+        body = `\`\`\`mermaid
+${c.mermaid || "graph LR\n  A[1. Ingress] --> B[2. Gateway]\n  B --> C[3. Service]\n  C --> D[4. Storage]"}
+\`\`\`
+
+${c.summary || "- **Phase 1 & 2:** Client connection and load balancing.\n- **Phase 3 & 4:** Business logic execution and data commit."}`;
+        break;
+      case "quote-highlight":
+        body = `> "${c.quote || "Simplicity is prerequisite for reliability."}"
+> 
+> \u2014 **${c.author || "Architecture Principle"}**`;
+        break;
+      case "quiz-checkpoint":
+        body = `> **Question:** ${c.question || "Which architecture pattern best ensures reliable message delivery?"}
+
+- **A.** ${c.optA || "Direct synchronous HTTP request with short timeout"}
+- **B.** ${c.optB || "Persistent Message Queue with Dead-Letter Queue (Correct)"}
+- **C.** ${c.optC || "In-memory client cache without persistence"}
+- **D.** ${c.optD || "Silently dropping failed packets"}`;
+        break;
+      case "tiered-practice-3cards":
+        body = `<div class="columns-3">
+<div>
+
+### \u{1F949} Bronze Tier
+${c.bronze || "- Implement baseline function\n- Pass 2 sample unit tests"}
+
+</div>
+<div>
+
+### \u{1F948} Silver Tier
+${c.silver || "- Add boundary error handling\n- Optimize algorithm complexity"}
+
+</div>
+<div>
+
+### \u{1F947} Gold Tier
+${c.gold || "- Design extension feature\n- Write automated integration tests"}
+
+</div>
+</div>`;
+        break;
+      default:
+        body = preset.markdownSnippet.replace(/^<!--[\s\S]*?-->\n*/, "").replace(/^#\s+[^\n]+\n*/, "").trim();
+    }
+  }
+  const notes = params.presenterNotes && params.presenterNotes.length > 0 ? `
+
+<!--
+Presenter Notes:
+${params.presenterNotes.map((n) => `- ${n}`).join("\n")}
+-->` : `
+
+<!--
+Presenter Notes:
+- Explain the primary concept on this slide.
+- Ask a diagnostic cold-call question to check comprehension.
+-->`;
+  const slideMarkdown = `${layoutComment}
+
+## ${title}${body ? "\n\n" + body : ""}${notes}`;
+  return {
+    success: true,
+    slideMarkdown,
+    presetName: preset.name
+  };
+}
+function executeApplySlideLayout(params) {
+  let layoutData = null;
+  if (params.presetId) {
+    const preset = getSlideLayoutPresetById(params.presetId);
+    if (!preset) {
+      return {
+        success: false,
+        updatedMarkdown: params.markdown,
+        error: `Preset with ID "${params.presetId}" not found.`
+      };
+    }
+    layoutData = preset.layout;
+  } else if (params.boxes && params.boxes.length > 0) {
+    layoutData = { boxes: params.boxes };
+  }
+  const updatedMarkdown = updateSlideLayoutInMarkdown(
+    params.markdown,
+    params.slideIndex,
+    layoutData
+  );
+  return {
+    success: true,
+    updatedMarkdown
+  };
+}
+function executeUpdatePresenterNotes(params) {
+  const { frontmatter, slides } = splitMarkdownSlides(params.markdown);
+  if (params.slideIndex < 0 || params.slideIndex >= slides.length) {
+    return {
+      success: false,
+      updatedMarkdown: params.markdown,
+      error: `Slide index ${params.slideIndex} out of bounds (total slides: ${slides.length})`
+    };
+  }
+  let slideContent = slides[params.slideIndex];
+  const notesCommentRegex = /<!--\s*(?:Presenter Notes|Notes):\s*([\s\S]*?)-->/i;
+  const newNotesComment = `<!--
+Presenter Notes:
+${params.notes.map((n) => `- ${n}`).join("\n")}
+-->`;
+  if (notesCommentRegex.test(slideContent)) {
+    slideContent = slideContent.replace(notesCommentRegex, newNotesComment);
+  } else {
+    slideContent = `${slideContent.trimEnd()}
+
+${newNotesComment}`;
+  }
+  slides[params.slideIndex] = slideContent;
+  const joined = slides.join("\n---\n");
+  const updatedMarkdown = frontmatter ? `${frontmatter}
+
+${joined}` : joined;
+  return {
+    success: true,
+    updatedMarkdown
+  };
+}
+function executeGenerateDeckOutline(params) {
+  const d = params.durationMins;
+  let targetSlideCount = 12;
+  let formatLabel = "15 min (Short Talk)";
+  if (d <= 7) {
+    targetSlideCount = 6;
+    formatLabel = "5 min (Lightning Talk)";
+  } else if (d <= 20) {
+    targetSlideCount = 14;
+    formatLabel = "15 min (Short Talk)";
+  } else if (d <= 35) {
+    targetSlideCount = 28;
+    formatLabel = "30 min (Conference Talk)";
+  } else {
+    targetSlideCount = 42;
+    formatLabel = "45-60 min (Keynote / Workshop)";
+  }
+  return {
+    topic: params.topic,
+    audience: params.audience,
+    durationMins: d,
+    format: formatLabel,
+    recommendedSlideCount: targetSlideCount,
+    structureGuidelines: [
+      'Apply the "One Idea Per Slide" invariant.',
+      "Enforce Word Budget: Maximum 40 words per card or column (Zero-Scroll Invariant).",
+      "Target 16:9 aspect ratio in 1280x720 coordinate space.",
+      "Every slide must conclude with Presenter Notes: Teacher talk track + 1 diagnostic cold-call question."
+    ],
+    suggestedOutline: [
+      { slide: 1, type: "title-hero", title: `\u{1F680} ${params.topic}`, intent: "Opening hook and speaker credentialing" },
+      { slide: 2, type: "agenda-timeline", title: "\u{1F5FA}\uFE0F Session Milestones", intent: "Set time budget expectations and learning deliverables" },
+      { slide: 3, type: "two-column-split", title: "\u26A1 Problem vs Opportunity", intent: "Contrast legacy bottlenecks against the modern solution" },
+      { slide: 4, type: "process-flow", title: "\u{1F504} Architectural Flow", intent: "High-level system topology and sequence diagram" },
+      { slide: 5, type: "code-explainer", title: "\u{1F4BB} Core Code Walkthrough", intent: "Deep-dive into production implementation logic" },
+      { slide: 6, type: "metrics-3-card", title: "\u{1F4CA} Benchmark Results", intent: "Quantify performance and reliability gains" },
+      { slide: 7, type: "tiered-practice-3cards", title: "\u{1F6E0}\uFE0F Hands-On Challenge", intent: "Differentiated practice across Bronze, Silver, and Gold tiers" },
+      { slide: 8, type: "quiz-checkpoint", title: "\u{1F3AF} Formative Checkpoint", intent: "Real-time diagnostic voting to verify mastery" },
+      { slide: 9, type: "takeaways-summary", title: "\u{1F3C1} Key Takeaways", intent: "Synthesis of 3 core lessons and next action items" }
+    ].slice(0, Math.max(5, Math.min(targetSlideCount, 10)))
+  };
+}
+
+// src/ai/prompt.ts
+var SLIDE_DESIGN_PROMPT_CONTRACT = `
+# SYSTEM MANDATE: PROFESSIONAL PRESENTATION & SLIDE DESIGN INVARIANTS
+
+You are an expert Presentation Architect & Visual Designer for educational, technical, and executive decks.
+When generating or modifying Marp slide presentations, you MUST STRICTLY obey the following non-negotiable rules:
+
+---
+
+## 1. DURATION-INDEXED SLIDE PACING
+Structure decks based on allocated talk time (averaging 1.5 - 2 minutes per slide):
+- **5 min (Lightning Talk):** 5 - 7 slides [Hook -> 2-3 Core Points -> CTA / Summary]
+- **15 min (Short Tech Talk):** 12 - 16 slides [Title -> Agenda -> Hook -> 3-4 Concepts -> Lab/Demo -> Summary]
+- **30 min (Conference / Class):** 24 - 32 slides [Full 5E Learning Cycle + Interactive Formative Checkpoint]
+- **45-60 min (Keynote / Workshop):** 36 - 50 slides [Modular Micro-cycles + Tiered Hands-on Exercises]
+
+---
+
+## 2. THE "ONE IDEA PER SLIDE" RULE
+- Each slide communicates **EXACTLY ONE** pedagogical or architectural concept.
+- Never pack multiple distinct topics into a single slide.
+- If a concept has both theory and code, split into: (Slide A) Concept Diagram -> (Slide B) Code Walkthrough.
+
+---
+
+## 3. STRICT WORD BUDGET (ZERO-SCROLL INVARIANT)
+- **Hard Limit:** Maximum **35 - 40 words** per card or column.
+- Never write paragraphs longer than 2 sentences. Use structured bullets with bold anchor terms:
+  - Format: \`- **Key Concept:** Concise explanation in a single line.\`
+- Vertical scrolling inside a slide is STRICTLY FORBIDDEN. Content must fit the 16:9 (1280x720) canvas cleanly.
+
+---
+
+## 4. TWO-COLUMN & CARD BALANCED LAYOUTS
+- Avoid centered vertical walls of text. Use responsive side-by-side card wrappers:
+  \`\`\`html
+  <div class="columns-2">
+  <div>
+  ### \u{1F534} Legacy / Challenge
+  - High idle compute overhead
+  - Cascading timeout failures
+  </div>
+  <div>
+  ### \u{1F7E2} Modern / Solution
+  - Event-driven webhook streams
+  - Automatic queue backpressure
+  </div>
+  </div>
+  \`\`\`
+- For 3 metrics or bronze/silver/gold differentiation, use \`<div class="columns-3">...</div>\`.
+
+---
+
+## 5. MANDATORY PRESENTER NOTES (TEACHER TALK TRACK)
+Every single slide MUST conclude with an HTML comment block containing:
+1. **Talk Track:** 2-3 sentences of what the speaker should say out loud.
+2. **Cold-Call Check Question:** 1 diagnostic question to ask a specific student or attendee.
+3. **Scaffolding Tip:** 1 hint or real-world analogy if learners look confused.
+
+Example:
+\`\`\`markdown
+<!--
+Presenter Notes:
+- Walk through the primary bottleneck when scaling database writes under high concurrency.
+- Cold-call: "Alex, if traffic spikes 10x in 1 minute, which subsystem will experience lock contention first?"
+- Scaffolding tip: Remind the room of the I/O saturation trade-off discussed in the previous module.
+-->
+\`\`\`
+
+---
+
+## 6. MARP COMPATIBLE YAML LAYOUT HEADERS
+When a precise coordinate layout is specified, include the clean YAML block at the very top of the slide:
+\`\`\`markdown
+<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 50, 1120, 70]
+      fontSize: 2rem
+    - id: col-left
+      target: '.columns-2 > div:first-child'
+      pos: [80, 150, 530, 510]
+    - id: col-right
+      target: '.columns-2 > div:last-child'
+      pos: [670, 150, 530, 510]
+-->
+\`\`\`
+`;
+
+export { SLIDE_DESIGN_PROMPT_CONTRACT, applySlideLayoutSchema, createSlideFromPresetSchema, executeApplySlideLayout, executeCreateSlideFromPreset, executeGenerateDeckOutline, executeListSlidePresets, executeUpdatePresenterNotes, generateDeckOutlineSchema, listSlidePresetsSchema, updatePresenterNotesSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/schemas.ts","../../src/ai/tools.ts","../../src/ai/prompt.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit — AI Tool Schemas (Zod)\n// ═══════════════════════════════════════════════════════════════════════════════\n\nimport { z } from 'zod';\n\nexport const listSlidePresetsSchema = z.object({\n  category: z.enum([\n    'all',\n    'cover',\n    'content',\n    'split',\n    'code',\n    'metrics',\n    'diagram',\n    'quote',\n    'assessment',\n  ]).optional().describe('Optional category filter for layout presets'),\n});\n\nexport const createSlideFromPresetSchema = z.object({\n  presetId: z.string().describe(\n    'ID of the layout preset: title-hero, two-column-split, code-explainer, metrics-3-card, process-flow, quote-highlight, quiz-checkpoint, tiered-practice-3cards, agenda-timeline, takeaways-summary'\n  ),\n  title: z.string().describe('Slide heading or title'),\n  subtitle: z.string().optional().describe('Optional subtitle or section context'),\n  content: z.record(z.string()).optional().describe(\n    'Key-value pairs for preset sections. For two-column-split: leftCol, rightCol. For code-explainer: code, language, notes. For metrics-3-card: card1Title, card1Val, card1Desc, etc.'\n  ),\n  customMarkdownBody: z.string().optional().describe(\n    'Raw markdown body to place inside the layout container (overrides content key-value pairs if provided)'\n  ),\n  presenterNotes: z.array(z.string()).optional().describe(\n    'Teacher talk track, cold-call check questions, or scaffolding notes for this slide'\n  ),\n});\n\nexport const applySlideLayoutSchema = z.object({\n  markdown: z.string().describe('Full Markdown slide deck content'),\n  slideIndex: z.number().int().min(0).describe('0-based index of the target slide to modify'),\n  presetId: z.string().optional().describe('Optional preset ID to apply to this slide'),\n  boxes: z.array(\n    z.object({\n      id: z.string(),\n      target: z.string().optional(),\n      pos: z.tuple([z.number(), z.number(), z.number(), z.number()]).describe('[x, y, width, height] in 1280x720 canvas coordinates'),\n      fontSize: z.string().optional(),\n      color: z.string().optional(),\n      textAlign: z.enum(['left', 'center', 'right', 'justify']).optional(),\n      style: z.string().optional(),\n    })\n  ).optional().describe('Custom boxes if not using presetId'),\n});\n\nexport const updatePresenterNotesSchema = z.object({\n  markdown: z.string().describe('Full Markdown slide deck content'),\n  slideIndex: z.number().int().min(0).describe('0-based index of the target slide'),\n  notes: z.array(z.string()).describe('List of speaker notes / talk tracks to set for this slide'),\n});\n\nexport const generateDeckOutlineSchema = z.object({\n  topic: z.string().describe('Main subject or topic of the presentation'),\n  durationMins: z.number().int().min(3).max(120).default(15).describe('Estimated duration in minutes (5m: 5-7 slides, 15m: 12-18 slides, 30m: 25-35 slides)'),\n  audience: z.string().describe('Target audience profile (e.g. Grade 10 students, junior developers, enterprise clients)'),\n  keyObjectives: z.array(z.string()).describe('2-4 key learning or decision objectives'),\n  techStack: z.string().optional().describe('Optional programming language, framework, or hardware kit'),\n});\n","// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit — AI Tool Handlers\n// Pure execution handlers for Vercel AI SDK / OpenAI tool calls\n// ═══════════════════════════════════════════════════════════════════════════════\n\nimport {\n  SLIDE_LAYOUT_PRESETS,\n  getSlideLayoutPresetById,\n  getSlideLayoutPresetsByCategory,\n  type SlideLayoutCategory,\n} from '../core/layout/presets.js';\nimport {\n  updateSlideLayoutInMarkdown,\n  splitMarkdownSlides,\n  serializeLayoutToComment,\n} from '../core/layout/serializer.js';\nimport type { SlideLayoutData } from '../types.js';\n\n/**\n * Execute: listSlidePresets\n */\nexport function executeListSlidePresets(params?: { category?: string }) {\n  const category = params?.category;\n  const presets = (!category || category === 'all')\n    ? SLIDE_LAYOUT_PRESETS\n    : getSlideLayoutPresetsByCategory(category as SlideLayoutCategory);\n\n  return {\n    count: presets.length,\n    presets: presets.map(p => ({\n      id: p.id,\n      name: p.name,\n      category: p.category,\n      description: p.description,\n      boxCount: p.layout.boxes.length,\n      snippetPreview: p.markdownSnippet.split('\\n').slice(0, 8).join('\\n') + '\\n...',\n    })),\n  };\n}\n\n/**\n * Execute: createSlideFromPreset\n */\nexport function executeCreateSlideFromPreset(params: {\n  presetId: string;\n  title: string;\n  subtitle?: string;\n  content?: Record<string, string>;\n  customMarkdownBody?: string;\n  presenterNotes?: string[];\n}): { success: boolean; slideMarkdown: string; presetName?: string; error?: string } {\n  const preset = getSlideLayoutPresetById(params.presetId);\n  if (!preset) {\n    return {\n      success: false,\n      slideMarkdown: '',\n      error: `Preset with ID \"${params.presetId}\" not found. Use listSlidePresets to see available layout templates.`,\n    };\n  }\n\n  const layoutComment = serializeLayoutToComment(preset.layout);\n  const title = params.title;\n  const subtitle = params.subtitle ? `\\n### ${params.subtitle}` : '';\n\n  let body = params.customMarkdownBody;\n\n  if (!body) {\n    const c = params.content || {};\n    switch (preset.id) {\n      case 'title-hero':\n        body = `${subtitle}\\n\\n**Presenter:** ${c.speaker || 'Lead Instructor'} | **Duration:** ${c.duration || '45 mins'} | **Topic:** ${c.topic || title}`;\n        break;\n\n      case 'two-column-split':\n        body = `<div class=\"columns-2\">\\n<div>\\n\\n### ${c.leftHeader || 'Approach A'}\\n${c.leftCol || '- Point 1\\n- Point 2\\n- Point 3'}\\n\\n</div>\\n<div>\\n\\n### ${c.rightHeader || 'Approach B'}\\n${c.rightCol || '- Point 1\\n- Point 2\\n- Point 3'}\\n\\n</div>\\n</div>`;\n        break;\n\n      case 'code-explainer':\n        body = `<div class=\"columns-2\">\\n<div>\\n\\n\\`\\`\\`${c.lang || 'ts'}\\n${c.code || '// Core implementation logic\\nconst isValid = true;'}\\n\\`\\`\\`\\n\\n</div>\\n<div>\\n\\n### 🔍 Key Invariants:\\n${c.notes || '1. **Validation:** Checks payload before processing\\n2. **Execution:** Enforces deterministic state\\n3. **Resilience:** Handles edge case errors'}\\n\\n</div>\\n</div>`;\n        break;\n\n      case 'metrics-3-card':\n        body = `<div class=\"columns-3\">\\n<div>\\n\\n# ${c.metric1Val || '99.9%'}\\n### ${c.metric1Title || 'Availability'}\\n${c.metric1Desc || 'Automated multi-region failover routing.'}\\n\\n</div>\\n<div>\\n\\n# ${c.metric2Val || '10x'}\\n### ${c.metric2Title || 'Throughput'}\\n${c.metric2Desc || 'Sub-millisecond processing latency.'}\\n\\n</div>\\n<div>\\n\\n# ${c.metric3Val || '0'}\\n### ${c.metric3Title || 'Breaches'}\\n${c.metric3Desc || 'Continuous SOC2 compliance auditing.'}\\n\\n</div>\\n</div>`;\n        break;\n\n      case 'process-flow':\n        body = `\\`\\`\\`mermaid\\n${c.mermaid || 'graph LR\\n  A[1. Ingress] --> B[2. Gateway]\\n  B --> C[3. Service]\\n  C --> D[4. Storage]'}\\n\\`\\`\\`\\n\\n${c.summary || '- **Phase 1 & 2:** Client connection and load balancing.\\n- **Phase 3 & 4:** Business logic execution and data commit.'}`;\n        break;\n\n      case 'quote-highlight':\n        body = `> \"${c.quote || 'Simplicity is prerequisite for reliability.'}\"\\n> \\n> — **${c.author || 'Architecture Principle'}**`;\n        break;\n\n      case 'quiz-checkpoint':\n        body = `> **Question:** ${c.question || 'Which architecture pattern best ensures reliable message delivery?'}\\n\\n- **A.** ${c.optA || 'Direct synchronous HTTP request with short timeout'}\\n- **B.** ${c.optB || 'Persistent Message Queue with Dead-Letter Queue (Correct)'}\\n- **C.** ${c.optC || 'In-memory client cache without persistence'}\\n- **D.** ${c.optD || 'Silently dropping failed packets'}`;\n        break;\n\n      case 'tiered-practice-3cards':\n        body = `<div class=\"columns-3\">\\n<div>\\n\\n### 🥉 Bronze Tier\\n${c.bronze || '- Implement baseline function\\n- Pass 2 sample unit tests'}\\n\\n</div>\\n<div>\\n\\n### 🥈 Silver Tier\\n${c.silver || '- Add boundary error handling\\n- Optimize algorithm complexity'}\\n\\n</div>\\n<div>\\n\\n### 🥇 Gold Tier\\n${c.gold || '- Design extension feature\\n- Write automated integration tests'}\\n\\n</div>\\n</div>`;\n        break;\n\n      default:\n        body = preset.markdownSnippet.replace(/^<!--[\\s\\S]*?-->\\n*/, '').replace(/^#\\s+[^\\n]+\\n*/, '').trim();\n    }\n  }\n\n  const notes = params.presenterNotes && params.presenterNotes.length > 0\n    ? `\\n\\n<!--\\nPresenter Notes:\\n${params.presenterNotes.map(n => `- ${n}`).join('\\n')}\\n-->`\n    : `\\n\\n<!--\\nPresenter Notes:\\n- Explain the primary concept on this slide.\\n- Ask a diagnostic cold-call question to check comprehension.\\n-->`;\n\n  const slideMarkdown = `${layoutComment}\\n\\n## ${title}${body ? '\\n\\n' + body : ''}${notes}`;\n\n  return {\n    success: true,\n    slideMarkdown,\n    presetName: preset.name,\n  };\n}\n\n/**\n * Execute: applySlideLayout\n */\nexport function executeApplySlideLayout(params: {\n  markdown: string;\n  slideIndex: number;\n  presetId?: string;\n  boxes?: SlideLayoutData['boxes'];\n}): { success: boolean; updatedMarkdown: string; error?: string } {\n  let layoutData: SlideLayoutData | null = null;\n\n  if (params.presetId) {\n    const preset = getSlideLayoutPresetById(params.presetId);\n    if (!preset) {\n      return {\n        success: false,\n        updatedMarkdown: params.markdown,\n        error: `Preset with ID \"${params.presetId}\" not found.`,\n      };\n    }\n    layoutData = preset.layout;\n  } else if (params.boxes && params.boxes.length > 0) {\n    layoutData = { boxes: params.boxes };\n  }\n\n  const updatedMarkdown = updateSlideLayoutInMarkdown(\n    params.markdown,\n    params.slideIndex,\n    layoutData\n  );\n\n  return {\n    success: true,\n    updatedMarkdown,\n  };\n}\n\n/**\n * Execute: updatePresenterNotes\n */\nexport function executeUpdatePresenterNotes(params: {\n  markdown: string;\n  slideIndex: number;\n  notes: string[];\n}): { success: boolean; updatedMarkdown: string; error?: string } {\n  const { frontmatter, slides } = splitMarkdownSlides(params.markdown);\n\n  if (params.slideIndex < 0 || params.slideIndex >= slides.length) {\n    return {\n      success: false,\n      updatedMarkdown: params.markdown,\n      error: `Slide index ${params.slideIndex} out of bounds (total slides: ${slides.length})`,\n    };\n  }\n\n  let slideContent = slides[params.slideIndex];\n  const notesCommentRegex = /<!--\\s*(?:Presenter Notes|Notes):\\s*([\\s\\S]*?)-->/i;\n  const newNotesComment = `<!--\\nPresenter Notes:\\n${params.notes.map(n => `- ${n}`).join('\\n')}\\n-->`;\n\n  if (notesCommentRegex.test(slideContent)) {\n    slideContent = slideContent.replace(notesCommentRegex, newNotesComment);\n  } else {\n    slideContent = `${slideContent.trimEnd()}\\n\\n${newNotesComment}`;\n  }\n\n  slides[params.slideIndex] = slideContent;\n  const joined = slides.join('\\n---\\n');\n  const updatedMarkdown = frontmatter ? `${frontmatter}\\n\\n${joined}` : joined;\n\n  return {\n    success: true,\n    updatedMarkdown,\n  };\n}\n\n/**\n * Execute: generateDeckOutline (indexed by talk duration)\n */\nexport function executeGenerateDeckOutline(params: {\n  topic: string;\n  durationMins: number;\n  audience: string;\n  keyObjectives: string[];\n  techStack?: string;\n}) {\n  const d = params.durationMins;\n  let targetSlideCount = 12;\n  let formatLabel = '15 min (Short Talk)';\n\n  if (d <= 7) {\n    targetSlideCount = 6;\n    formatLabel = '5 min (Lightning Talk)';\n  } else if (d <= 20) {\n    targetSlideCount = 14;\n    formatLabel = '15 min (Short Talk)';\n  } else if (d <= 35) {\n    targetSlideCount = 28;\n    formatLabel = '30 min (Conference Talk)';\n  } else {\n    targetSlideCount = 42;\n    formatLabel = '45-60 min (Keynote / Workshop)';\n  }\n\n  return {\n    topic: params.topic,\n    audience: params.audience,\n    durationMins: d,\n    format: formatLabel,\n    recommendedSlideCount: targetSlideCount,\n    structureGuidelines: [\n      'Apply the \"One Idea Per Slide\" invariant.',\n      'Enforce Word Budget: Maximum 40 words per card or column (Zero-Scroll Invariant).',\n      'Target 16:9 aspect ratio in 1280x720 coordinate space.',\n      'Every slide must conclude with Presenter Notes: Teacher talk track + 1 diagnostic cold-call question.',\n    ],\n    suggestedOutline: [\n      { slide: 1, type: 'title-hero', title: `🚀 ${params.topic}`, intent: 'Opening hook and speaker credentialing' },\n      { slide: 2, type: 'agenda-timeline', title: '🗺️ Session Milestones', intent: 'Set time budget expectations and learning deliverables' },\n      { slide: 3, type: 'two-column-split', title: '⚡ Problem vs Opportunity', intent: 'Contrast legacy bottlenecks against the modern solution' },\n      { slide: 4, type: 'process-flow', title: '🔄 Architectural Flow', intent: 'High-level system topology and sequence diagram' },\n      { slide: 5, type: 'code-explainer', title: '💻 Core Code Walkthrough', intent: 'Deep-dive into production implementation logic' },\n      { slide: 6, type: 'metrics-3-card', title: '📊 Benchmark Results', intent: 'Quantify performance and reliability gains' },\n      { slide: 7, type: 'tiered-practice-3cards', title: '🛠️ Hands-On Challenge', intent: 'Differentiated practice across Bronze, Silver, and Gold tiers' },\n      { slide: 8, type: 'quiz-checkpoint', title: '🎯 Formative Checkpoint', intent: 'Real-time diagnostic voting to verify mastery' },\n      { slide: 9, type: 'takeaways-summary', title: '🏁 Key Takeaways', intent: 'Synthesis of 3 core lessons and next action items' },\n    ].slice(0, Math.max(5, Math.min(targetSlideCount, 10))),\n  };\n}\n","// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit — Slide Design Prompt Contract & System Invariants\n// \n// Modeled after battle-tested presentation orchestrators (e.g. slides-ai-plugin)\n// Provides rigorous invariants for LLM slide generation across web & PPTX.\n// ═══════════════════════════════════════════════════════════════════════════════\n\nexport const SLIDE_DESIGN_PROMPT_CONTRACT = `\n# SYSTEM MANDATE: PROFESSIONAL PRESENTATION & SLIDE DESIGN INVARIANTS\n\nYou are an expert Presentation Architect & Visual Designer for educational, technical, and executive decks.\nWhen generating or modifying Marp slide presentations, you MUST STRICTLY obey the following non-negotiable rules:\n\n---\n\n## 1. DURATION-INDEXED SLIDE PACING\nStructure decks based on allocated talk time (averaging 1.5 - 2 minutes per slide):\n- **5 min (Lightning Talk):** 5 - 7 slides [Hook -> 2-3 Core Points -> CTA / Summary]\n- **15 min (Short Tech Talk):** 12 - 16 slides [Title -> Agenda -> Hook -> 3-4 Concepts -> Lab/Demo -> Summary]\n- **30 min (Conference / Class):** 24 - 32 slides [Full 5E Learning Cycle + Interactive Formative Checkpoint]\n- **45-60 min (Keynote / Workshop):** 36 - 50 slides [Modular Micro-cycles + Tiered Hands-on Exercises]\n\n---\n\n## 2. THE \"ONE IDEA PER SLIDE\" RULE\n- Each slide communicates **EXACTLY ONE** pedagogical or architectural concept.\n- Never pack multiple distinct topics into a single slide.\n- If a concept has both theory and code, split into: (Slide A) Concept Diagram -> (Slide B) Code Walkthrough.\n\n---\n\n## 3. STRICT WORD BUDGET (ZERO-SCROLL INVARIANT)\n- **Hard Limit:** Maximum **35 - 40 words** per card or column.\n- Never write paragraphs longer than 2 sentences. Use structured bullets with bold anchor terms:\n  - Format: \\`- **Key Concept:** Concise explanation in a single line.\\`\n- Vertical scrolling inside a slide is STRICTLY FORBIDDEN. Content must fit the 16:9 (1280x720) canvas cleanly.\n\n---\n\n## 4. TWO-COLUMN & CARD BALANCED LAYOUTS\n- Avoid centered vertical walls of text. Use responsive side-by-side card wrappers:\n  \\`\\`\\`html\n  <div class=\"columns-2\">\n  <div>\n  ### 🔴 Legacy / Challenge\n  - High idle compute overhead\n  - Cascading timeout failures\n  </div>\n  <div>\n  ### 🟢 Modern / Solution\n  - Event-driven webhook streams\n  - Automatic queue backpressure\n  </div>\n  </div>\n  \\`\\`\\`\n- For 3 metrics or bronze/silver/gold differentiation, use \\`<div class=\"columns-3\">...</div>\\`.\n\n---\n\n## 5. MANDATORY PRESENTER NOTES (TEACHER TALK TRACK)\nEvery single slide MUST conclude with an HTML comment block containing:\n1. **Talk Track:** 2-3 sentences of what the speaker should say out loud.\n2. **Cold-Call Check Question:** 1 diagnostic question to ask a specific student or attendee.\n3. **Scaffolding Tip:** 1 hint or real-world analogy if learners look confused.\n\nExample:\n\\`\\`\\`markdown\n<!--\nPresenter Notes:\n- Walk through the primary bottleneck when scaling database writes under high concurrency.\n- Cold-call: \"Alex, if traffic spikes 10x in 1 minute, which subsystem will experience lock contention first?\"\n- Scaffolding tip: Remind the room of the I/O saturation trade-off discussed in the previous module.\n-->\n\\`\\`\\`\n\n---\n\n## 6. MARP COMPATIBLE YAML LAYOUT HEADERS\nWhen a precise coordinate layout is specified, include the clean YAML block at the very top of the slide:\n\\`\\`\\`markdown\n<!-- layout:\n  boxes:\n    - id: heading\n      target: h2\n      pos: [80, 50, 1120, 70]\n      fontSize: 2rem\n    - id: col-left\n      target: '.columns-2 > div:first-child'\n      pos: [80, 150, 530, 510]\n    - id: col-right\n      target: '.columns-2 > div:last-child'\n      pos: [670, 150, 530, 510]\n-->\n\\`\\`\\`\n`;\n"]}