@thanh01.pmt/presentation-kit 0.2.0 → 0.2.2

package/dist/ai/index.d.cts

@@ -0,0 +1,206 @@
+import { z } from 'zod';
+import { c as SlideLayoutCategory } from '../presets-JpoJbNKE.cjs';
+import { b as SlideLayoutData } from '../types-DnR81ReX.cjs';
+
+declare const listSlidePresetsSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodEnum<["all", "cover", "content", "split", "code", "metrics", "diagram", "quote", "assessment"]>>;
+}, "strip", z.ZodTypeAny, {
+    category?: "all" | "cover" | "content" | "split" | "code" | "metrics" | "diagram" | "quote" | "assessment" | undefined;
+}, {
+    category?: "all" | "cover" | "content" | "split" | "code" | "metrics" | "diagram" | "quote" | "assessment" | undefined;
+}>;
+declare const createSlideFromPresetSchema: z.ZodObject<{
+    presetId: z.ZodString;
+    title: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    customMarkdownBody: z.ZodOptional<z.ZodString>;
+    presenterNotes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    presetId: string;
+    title: string;
+    content?: Record<string, string> | undefined;
+    subtitle?: string | undefined;
+    customMarkdownBody?: string | undefined;
+    presenterNotes?: string[] | undefined;
+}, {
+    presetId: string;
+    title: string;
+    content?: Record<string, string> | undefined;
+    subtitle?: string | undefined;
+    customMarkdownBody?: string | undefined;
+    presenterNotes?: string[] | undefined;
+}>;
+declare const applySlideLayoutSchema: z.ZodObject<{
+    markdown: z.ZodString;
+    slideIndex: z.ZodNumber;
+    presetId: z.ZodOptional<z.ZodString>;
+    boxes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+        pos: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        fontSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<["left", "center", "right", "justify"]>>;
+        style: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }, {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    markdown: string;
+    slideIndex: number;
+    presetId?: string | undefined;
+    boxes?: {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }[] | undefined;
+}, {
+    markdown: string;
+    slideIndex: number;
+    presetId?: string | undefined;
+    boxes?: {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }[] | undefined;
+}>;
+declare const updatePresenterNotesSchema: z.ZodObject<{
+    markdown: z.ZodString;
+    slideIndex: z.ZodNumber;
+    notes: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    markdown: string;
+    slideIndex: number;
+    notes: string[];
+}, {
+    markdown: string;
+    slideIndex: number;
+    notes: string[];
+}>;
+declare const generateDeckOutlineSchema: z.ZodObject<{
+    topic: z.ZodString;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    audience: z.ZodString;
+    keyObjectives: z.ZodArray<z.ZodString, "many">;
+    techStack: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    durationMins: number;
+    audience: string;
+    keyObjectives: string[];
+    techStack?: string | undefined;
+}, {
+    topic: string;
+    audience: string;
+    keyObjectives: string[];
+    durationMins?: number | undefined;
+    techStack?: string | undefined;
+}>;
+
+/**
+ * Execute: listSlidePresets
+ */
+declare function executeListSlidePresets(params?: {
+    category?: string;
+}): {
+    count: number;
+    presets: {
+        id: string;
+        name: string;
+        category: SlideLayoutCategory;
+        description: string;
+        boxCount: number;
+        snippetPreview: string;
+    }[];
+};
+/**
+ * Execute: createSlideFromPreset
+ */
+declare function executeCreateSlideFromPreset(params: {
+    presetId: string;
+    title: string;
+    subtitle?: string;
+    content?: Record<string, string>;
+    customMarkdownBody?: string;
+    presenterNotes?: string[];
+}): {
+    success: boolean;
+    slideMarkdown: string;
+    presetName?: string;
+    error?: string;
+};
+/**
+ * Execute: applySlideLayout
+ */
+declare function executeApplySlideLayout(params: {
+    markdown: string;
+    slideIndex: number;
+    presetId?: string;
+    boxes?: SlideLayoutData['boxes'];
+}): {
+    success: boolean;
+    updatedMarkdown: string;
+    error?: string;
+};
+/**
+ * Execute: updatePresenterNotes
+ */
+declare function executeUpdatePresenterNotes(params: {
+    markdown: string;
+    slideIndex: number;
+    notes: string[];
+}): {
+    success: boolean;
+    updatedMarkdown: string;
+    error?: string;
+};
+/**
+ * Execute: generateDeckOutline (indexed by talk duration)
+ */
+declare function executeGenerateDeckOutline(params: {
+    topic: string;
+    durationMins: number;
+    audience: string;
+    keyObjectives: string[];
+    techStack?: string;
+}): {
+    topic: string;
+    audience: string;
+    durationMins: number;
+    format: string;
+    recommendedSlideCount: number;
+    structureGuidelines: string[];
+    suggestedOutline: {
+        slide: number;
+        type: string;
+        title: string;
+        intent: string;
+    }[];
+};
+
+declare 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: `- **Kh\u00E1i ni\u1EC7m then ch\u1ED1t:** M\u00F4 t\u1EA3 s\u00FAc t\u00EDch trong 1 d\u00F2ng.`\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  ### \uD83D\uDD34 C\u0169 / Th\u00E1ch Th\u1EE9c\n  - ...\n  </div>\n  <div>\n  ### \uD83D\uDFE2 M\u1EDBi / Gi\u1EA3i Ph\u00E1p\n  - ...\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.\n3. **Scaffolding Tip:** 1 hint if students look confused.\n\nExample:\n```markdown\n<!--\nPresenter Notes:\n- Tr\u00ECnh b\u00E0y \u0111i\u1EC3m ngh\u1EBDn l\u1EDBn nh\u1EA5t trong vi\u1EC7c m\u1EDF r\u1ED9ng quy m\u00F4 d\u1EEF li\u1EC7u.\n- Cold-call: \"Em Nguy\u1EC5n V\u0103n B, n\u1EBFu s\u1ED1 l\u01B0\u1EE3ng request t\u0103ng g\u1EA5p 10 l\u1EA7n th\u00EC \u0111i\u1EC3m n\u00E0o s\u1EBD s\u1EADp \u0111\u1EA7u ti\u00EAn?\"\n- G\u1EE3i \u00FD g\u1EE3i m\u1EDF: Nh\u1EAFc h\u1ECDc vi\u00EAn nh\u1EDB l\u1EA1i kh\u00E1i ni\u1EC7m I/O bottleneck \u1EDF b\u00E0i tr\u01B0\u1EDBc.\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";
+
+export { SLIDE_DESIGN_PROMPT_CONTRACT, applySlideLayoutSchema, createSlideFromPresetSchema, executeApplySlideLayout, executeCreateSlideFromPreset, executeGenerateDeckOutline, executeListSlidePresets, executeUpdatePresenterNotes, generateDeckOutlineSchema, listSlidePresetsSchema, updatePresenterNotesSchema };

package/dist/ai/index.d.ts

@@ -0,0 +1,206 @@
+import { z } from 'zod';
+import { c as SlideLayoutCategory } from '../presets-B1N2_jKl.js';
+import { b as SlideLayoutData } from '../types-DnR81ReX.js';
+
+declare const listSlidePresetsSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodEnum<["all", "cover", "content", "split", "code", "metrics", "diagram", "quote", "assessment"]>>;
+}, "strip", z.ZodTypeAny, {
+    category?: "all" | "cover" | "content" | "split" | "code" | "metrics" | "diagram" | "quote" | "assessment" | undefined;
+}, {
+    category?: "all" | "cover" | "content" | "split" | "code" | "metrics" | "diagram" | "quote" | "assessment" | undefined;
+}>;
+declare const createSlideFromPresetSchema: z.ZodObject<{
+    presetId: z.ZodString;
+    title: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    customMarkdownBody: z.ZodOptional<z.ZodString>;
+    presenterNotes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    presetId: string;
+    title: string;
+    content?: Record<string, string> | undefined;
+    subtitle?: string | undefined;
+    customMarkdownBody?: string | undefined;
+    presenterNotes?: string[] | undefined;
+}, {
+    presetId: string;
+    title: string;
+    content?: Record<string, string> | undefined;
+    subtitle?: string | undefined;
+    customMarkdownBody?: string | undefined;
+    presenterNotes?: string[] | undefined;
+}>;
+declare const applySlideLayoutSchema: z.ZodObject<{
+    markdown: z.ZodString;
+    slideIndex: z.ZodNumber;
+    presetId: z.ZodOptional<z.ZodString>;
+    boxes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+        pos: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        fontSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<["left", "center", "right", "justify"]>>;
+        style: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }, {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    markdown: string;
+    slideIndex: number;
+    presetId?: string | undefined;
+    boxes?: {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }[] | undefined;
+}, {
+    markdown: string;
+    slideIndex: number;
+    presetId?: string | undefined;
+    boxes?: {
+        id: string;
+        pos: [number, number, number, number];
+        target?: string | undefined;
+        fontSize?: string | undefined;
+        color?: string | undefined;
+        textAlign?: "left" | "center" | "right" | "justify" | undefined;
+        style?: string | undefined;
+    }[] | undefined;
+}>;
+declare const updatePresenterNotesSchema: z.ZodObject<{
+    markdown: z.ZodString;
+    slideIndex: z.ZodNumber;
+    notes: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    markdown: string;
+    slideIndex: number;
+    notes: string[];
+}, {
+    markdown: string;
+    slideIndex: number;
+    notes: string[];
+}>;
+declare const generateDeckOutlineSchema: z.ZodObject<{
+    topic: z.ZodString;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    audience: z.ZodString;
+    keyObjectives: z.ZodArray<z.ZodString, "many">;
+    techStack: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    durationMins: number;
+    audience: string;
+    keyObjectives: string[];
+    techStack?: string | undefined;
+}, {
+    topic: string;
+    audience: string;
+    keyObjectives: string[];
+    durationMins?: number | undefined;
+    techStack?: string | undefined;
+}>;
+
+/**
+ * Execute: listSlidePresets
+ */
+declare function executeListSlidePresets(params?: {
+    category?: string;
+}): {
+    count: number;
+    presets: {
+        id: string;
+        name: string;
+        category: SlideLayoutCategory;
+        description: string;
+        boxCount: number;
+        snippetPreview: string;
+    }[];
+};
+/**
+ * Execute: createSlideFromPreset
+ */
+declare function executeCreateSlideFromPreset(params: {
+    presetId: string;
+    title: string;
+    subtitle?: string;
+    content?: Record<string, string>;
+    customMarkdownBody?: string;
+    presenterNotes?: string[];
+}): {
+    success: boolean;
+    slideMarkdown: string;
+    presetName?: string;
+    error?: string;
+};
+/**
+ * Execute: applySlideLayout
+ */
+declare function executeApplySlideLayout(params: {
+    markdown: string;
+    slideIndex: number;
+    presetId?: string;
+    boxes?: SlideLayoutData['boxes'];
+}): {
+    success: boolean;
+    updatedMarkdown: string;
+    error?: string;
+};
+/**
+ * Execute: updatePresenterNotes
+ */
+declare function executeUpdatePresenterNotes(params: {
+    markdown: string;
+    slideIndex: number;
+    notes: string[];
+}): {
+    success: boolean;
+    updatedMarkdown: string;
+    error?: string;
+};
+/**
+ * Execute: generateDeckOutline (indexed by talk duration)
+ */
+declare function executeGenerateDeckOutline(params: {
+    topic: string;
+    durationMins: number;
+    audience: string;
+    keyObjectives: string[];
+    techStack?: string;
+}): {
+    topic: string;
+    audience: string;
+    durationMins: number;
+    format: string;
+    recommendedSlideCount: number;
+    structureGuidelines: string[];
+    suggestedOutline: {
+        slide: number;
+        type: string;
+        title: string;
+        intent: string;
+    }[];
+};
+
+declare 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: `- **Kh\u00E1i ni\u1EC7m then ch\u1ED1t:** M\u00F4 t\u1EA3 s\u00FAc t\u00EDch trong 1 d\u00F2ng.`\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  ### \uD83D\uDD34 C\u0169 / Th\u00E1ch Th\u1EE9c\n  - ...\n  </div>\n  <div>\n  ### \uD83D\uDFE2 M\u1EDBi / Gi\u1EA3i Ph\u00E1p\n  - ...\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.\n3. **Scaffolding Tip:** 1 hint if students look confused.\n\nExample:\n```markdown\n<!--\nPresenter Notes:\n- Tr\u00ECnh b\u00E0y \u0111i\u1EC3m ngh\u1EBDn l\u1EDBn nh\u1EA5t trong vi\u1EC7c m\u1EDF r\u1ED9ng quy m\u00F4 d\u1EEF li\u1EC7u.\n- Cold-call: \"Em Nguy\u1EC5n V\u0103n B, n\u1EBFu s\u1ED1 l\u01B0\u1EE3ng request t\u0103ng g\u1EA5p 10 l\u1EA7n th\u00EC \u0111i\u1EC3m n\u00E0o s\u1EBD s\u1EADp \u0111\u1EA7u ti\u00EAn?\"\n- G\u1EE3i \u00FD g\u1EE3i m\u1EDF: Nh\u1EAFc h\u1ECDc vi\u00EAn nh\u1EDB l\u1EA1i kh\u00E1i ni\u1EC7m I/O bottleneck \u1EDF b\u00E0i tr\u01B0\u1EDBc.\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";
+
+export { SLIDE_DESIGN_PROMPT_CONTRACT, applySlideLayoutSchema, createSlideFromPresetSchema, executeApplySlideLayout, executeCreateSlideFromPreset, executeGenerateDeckOutline, executeListSlidePresets, executeUpdatePresenterNotes, generateDeckOutlineSchema, listSlidePresetsSchema, updatePresenterNotesSchema };