@thanh01.pmt/presentation-kit 0.1.1 → 0.2.1

package/dist/{chunk-RCHOTRWI.js → chunk-PAHIW5IX.js}

@@ -1,3 +1,4 @@
+import yaml from 'js-yaml';
 import { Marp } from '@marp-team/marp-core';
 
 // src/core/arrow-converter.ts
@@ -388,9 +389,13 @@ function generateScopedCss(tokens, containerId = "marp-container") {
 }
 
 /* Slide Inner Section (1280x720 Canvas Coordinate Scale) */
+#${safeId} section:not([data-background-color]):not([style*="background"]),
+#${safeId} foreignObject > section:not([data-background-color]):not([style*="background"]) {
+  background-color: ${tokens.background} !important;
+}
+
 #${safeId} section,
 #${safeId} foreignObject > section {
-  background-color: ${tokens.background} !important;
   color: ${tokens.text} !important;
   font-family: var(--font-sans), Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif !important;
   padding: 50px 60px !important;
@@ -636,6 +641,43 @@ div#${safeId} svg foreignObject section table tr:hover td,
   padding-top: 6px !important;
 }
 
+/* Multi-column Grid & Flex Layout Utilities */
+#${safeId} section .columns,
+#${safeId} section .grid-2 {
+  display: grid !important;
+  grid-template-columns: 1fr 1fr !important;
+  gap: 28px !important;
+  width: 100% !important;
+  margin: 16px 0 !important;
+  align-items: start !important;
+}
+
+#${safeId} section .columns > div,
+#${safeId} section .grid-2 > div {
+  min-width: 0 !important;
+}
+
+#${safeId} section .card {
+  background: ${tokens.quoteBg} !important;
+  border: 1px solid ${tokens.cardBorder} !important;
+  border-radius: 10px !important;
+  padding: 18px 22px !important;
+  margin: 12px 0 !important;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15) !important;
+}
+
+#${safeId} section .card.highlight {
+  border-left: 4px solid ${tokens.link} !important;
+}
+
+#${safeId} section .card.warning {
+  border-left: 4px solid #f59e0b !important;
+}
+
+#${safeId} section .card.success {
+  border-left: 4px solid #10b981 !important;
+}
+
 /* Marp Split Layout Container */
 #${safeId} section[data-marpit-advanced-background="background"] {
   display: flex !important;
@@ -1161,6 +1203,847 @@ ${prefix}[data-click-group].visible {
 
 `;
 }
+function isLayoutComment(comment) {
+  const trimmed = comment.trim();
+  return trimmed.startsWith("layout:") || trimmed.startsWith("layout :");
+}
+function parseLayoutFromComment(comment) {
+  try {
+    const trimmed = comment.trim();
+    if (!isLayoutComment(trimmed)) return null;
+    const parsed = yaml.load(trimmed);
+    if (!parsed || typeof parsed !== "object") return null;
+    const boxes = parsed.boxes ?? parsed.layout?.boxes;
+    if (Array.isArray(boxes)) {
+      return { boxes };
+    }
+    return null;
+  } catch (err) {
+    console.warn("[presentation-kit] Failed to parse layout comment YAML:", err);
+    return null;
+  }
+}
+function filterPresenterNotes(comments) {
+  return comments.map((c) => c.trim()).filter((c) => {
+    if (!c) return false;
+    if (isLayoutComment(c)) return false;
+    if (/^_?[a-zA-Z0-9_-]+\s*:/i.test(c) && !c.toLowerCase().startsWith("note:")) {
+      return false;
+    }
+    return true;
+  }).map((c) => {
+    return c.replace(/^_?note:\s*/i, "").trim();
+  });
+}
+function extractLayoutsAndNotes(rawComments) {
+  const layouts = [];
+  const notes = [];
+  for (const slideComments of rawComments) {
+    if (!slideComments || slideComments.length === 0) {
+      layouts.push(null);
+      notes.push([]);
+      continue;
+    }
+    let slideLayout = null;
+    for (const comment of slideComments) {
+      if (isLayoutComment(comment)) {
+        const parsed = parseLayoutFromComment(comment);
+        if (parsed) {
+          slideLayout = parsed;
+        }
+      }
+    }
+    layouts.push(slideLayout);
+    notes.push(filterPresenterNotes(slideComments));
+  }
+  return { layouts, notes };
+}
+function serializeLayoutToComment(layout) {
+  if (!layout.boxes || layout.boxes.length === 0) return "";
+  const cleanData = {
+    boxes: layout.boxes.map((box) => {
+      const b = {
+        id: box.id,
+        target: box.target || `h1`,
+        pos: [
+          Math.round(box.pos[0]),
+          Math.round(box.pos[1]),
+          Math.round(box.pos[2]),
+          Math.round(box.pos[3])
+        ]
+      };
+      if (box.fontSize) b.fontSize = box.fontSize;
+      if (box.color) b.color = box.color;
+      if (box.textAlign) b.textAlign = box.textAlign;
+      if (box.style) b.style = box.style;
+      return b;
+    })
+  };
+  const yamlStr = yaml.dump(cleanData, {
+    indent: 2,
+    lineWidth: -1,
+    noRefs: true
+  }).trim();
+  return `<!-- layout:
+  ${yamlStr.split("\n").join("\n  ")}
+-->`;
+}
+function splitMarkdownSlides(markdown) {
+  const lines = markdown.split("\n");
+  let frontmatter = null;
+  const slideBuffers = [];
+  let currentBuffer = [];
+  let inCodeFence = false;
+  let lineIdx = 0;
+  if (lines.length > 0 && lines[0].trim() === "---") {
+    const fmBuffer = [lines[0]];
+    lineIdx = 1;
+    while (lineIdx < lines.length) {
+      const line = lines[lineIdx];
+      fmBuffer.push(line);
+      if (line.trim() === "---") {
+        frontmatter = fmBuffer.join("\n");
+        lineIdx++;
+        break;
+      }
+      lineIdx++;
+    }
+  }
+  for (let i = lineIdx; i < lines.length; i++) {
+    const line = lines[i];
+    if (/^```/.test(line.trim())) {
+      inCodeFence = !inCodeFence;
+      currentBuffer.push(line);
+      continue;
+    }
+    if (!inCodeFence && line.trim() === "---") {
+      slideBuffers.push(currentBuffer);
+      currentBuffer = [];
+      continue;
+    }
+    currentBuffer.push(line);
+  }
+  slideBuffers.push(currentBuffer);
+  const slides = slideBuffers.map((b) => b.join("\n"));
+  return { frontmatter, slides };
+}
+function updateSlideLayoutInMarkdown(markdown, slideIndex, layout) {
+  const { frontmatter, slides } = splitMarkdownSlides(markdown);
+  if (slideIndex < 0 || slideIndex >= slides.length) {
+    return markdown;
+  }
+  let slideContent = slides[slideIndex];
+  const layoutCommentRegex = /<!--\s*layout:\s*[\s\S]*?-->/i;
+  const newComment = layout && layout.boxes && layout.boxes.length > 0 ? serializeLayoutToComment(layout) : "";
+  if (layoutCommentRegex.test(slideContent)) {
+    if (newComment) {
+      slideContent = slideContent.replace(layoutCommentRegex, newComment);
+    } else {
+      slideContent = slideContent.replace(layoutCommentRegex, "").trim();
+    }
+  } else if (newComment) {
+    const trimmed = slideContent.trimStart();
+    slideContent = `${newComment}
+
+${trimmed}`;
+  }
+  slides[slideIndex] = slideContent;
+  const joinedSlides = slides.join("\n---\n");
+  if (frontmatter) {
+    return `${frontmatter}
+
+${joinedSlides}`;
+  }
+  return joinedSlides;
+}
+
+// src/core/layout/css-generator.ts
+function generateLayoutCss(layouts, containerId = "marp-container") {
+  const cssRules = [];
+  layouts.forEach((layout, index) => {
+    if (!layout || !layout.boxes || layout.boxes.length === 0) return;
+    const slideNum = index + 1;
+    const slideSectionSelector = `#${containerId} svg[data-marpit-svg]:nth-of-type(${slideNum}) section, #${containerId} .marpit > svg:nth-of-type(${slideNum}) section`;
+    cssRules.push(`
+/* Slide ${slideNum} Layout Container */
+${slideSectionSelector} {
+  position: relative !important;
+  display: block !important;
+}`);
+    for (const box of layout.boxes) {
+      if (!box || !Array.isArray(box.pos) || box.pos.length < 4) continue;
+      const [x, y, w, h] = box.pos;
+      const targetSelector = box.target || `[data-box-id="${box.id}"]`;
+      const ruleSelector = `${slideSectionSelector} ${targetSelector}`;
+      const styles = [
+        `position: absolute !important`,
+        `left: ${Math.round(x)}px !important`,
+        `top: ${Math.round(y)}px !important`,
+        `width: ${Math.round(w)}px !important`,
+        `min-height: ${Math.round(h)}px !important`,
+        `box-sizing: border-box !important`,
+        `margin: 0 !important`
+      ];
+      if (box.fontSize) {
+        styles.push(`font-size: ${box.fontSize} !important`);
+      }
+      if (box.color) {
+        styles.push(`color: ${box.color} !important`);
+      }
+      if (box.textAlign) {
+        styles.push(`text-align: ${box.textAlign} !important`);
+      }
+      if (box.style) {
+        styles.push(box.style);
+      }
+      cssRules.push(`
+${ruleSelector} {
+  ${styles.join(";\n  ")};
+}`);
+    }
+  });
+  return cssRules.join("\n");
+}
+
+// src/core/layout/presets.ts
+var SLIDE_LAYOUT_PRESETS = [
+  {
+    id: "title-hero",
+    name: "B\xECa & Gi\u1EDBi thi\u1EC7u (Title Cover)",
+    category: "cover",
+    description: "Slide b\xECa m\u1EDF \u0111\u1EA7u \u1EA5n t\u01B0\u1EE3ng v\u1EDBi ti\xEAu \u0111\u1EC1 l\u1EDBn, ph\u1EE5 \u0111\u1EC1 v\xE0 th\xF4ng tin gi\u1EA3ng vi\xEAn.",
+    layout: {
+      boxes: [
+        {
+          id: "title",
+          target: "h1",
+          pos: [100, 180, 1080, 140],
+          fontSize: "3rem",
+          textAlign: "center"
+        },
+        {
+          id: "subtitle",
+          target: "h3",
+          pos: [100, 350, 1080, 70],
+          fontSize: "1.5rem",
+          textAlign: "center"
+        },
+        {
+          id: "speaker-meta",
+          target: "p",
+          pos: [100, 460, 1080, 80],
+          fontSize: "1.1rem",
+          textAlign: "center"
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: title
+      target: h1
+      pos: [100, 180, 1080, 140]
+      fontSize: 3rem
+      textAlign: center
+    - id: subtitle
+      target: h3
+      pos: [100, 350, 1080, 70]
+      fontSize: 1.5rem
+      textAlign: center
+    - id: speaker-meta
+      target: p
+      pos: [100, 460, 1080, 80]
+      fontSize: 1.1rem
+      textAlign: center
+-->
+
+# \u{1F680} Ti\xEAu \u0110\u1EC1 B\xE0i Gi\u1EA3ng Ch\xEDnh
+### Ph\u1EE5 \u0111\u1EC1 ng\u1EAFn g\u1ECDn, truy\u1EC1n c\u1EA3m h\u1EE9ng v\xE0 \u0111\u1ECBnh v\u1ECB m\u1EE5c ti\xEAu
+
+**Gi\u1EA3ng vi\xEAn:** Th\u1EA7y Nguy\u1EC5n V\u0103n A | **Th\u1EDDi l\u01B0\u1EE3ng:** 45 ph\xFAt | **C\u1EA5p \u0111\u1ED9:** Trung c\u1EA5p
+
+<!--
+Presenter Notes:
+- Ch\xE0o m\u1EEBng h\u1ECDc vi\xEAn, gi\u1EDBi thi\u1EC7u m\u1EE5c ti\xEAu b\xE0i h\u1ECDc h\xF4m nay.
+- Kh\u01A1i g\u1EE3i s\u1EF1 t\xF2 m\xF2 b\u1EB1ng c\xE2u h\u1ECFi m\u1EDF \u0111\u1EA7u v\u1EC1 b\xE0i to\xE1n th\u1EF1c t\u1EBF.
+-->`
+  },
+  {
+    id: "two-column-split",
+    name: "So S\xE1nh 2 C\u1ED9t (2-Column Comparison)",
+    category: "split",
+    description: "B\u1ED1 c\u1EE5c chia \u0111\xF4i m\xE0n h\xECnh \u0111\u1EC3 so s\xE1nh ph\u01B0\u01A1ng ph\xE1p c\u0169 vs m\u1EDBi, l\xFD thuy\u1EBFt vs th\u1EF1c t\u1EBF.",
+    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]
+        }
+      ]
+    },
+    markdownSnippet: `<!-- 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]
+-->
+
+## \u2696\uFE0F So S\xE1nh Kh\xE1i Ni\u1EC7m & Gi\u1EA3i Ph\xE1p
+
+<div class="columns-2">
+<div>
+
+### \u{1F534} C\xE1ch Ti\u1EBFp C\u1EADn C\u0169
+- X\u1EED l\xFD th\u1EE7 c\xF4ng, t\u1ED1n nhi\u1EC1u nh\xE2n l\u1EF1c
+- D\u1EC5 ph\xE1t sinh sai s\u1ED1 do thao t\xE1c l\u1EB7p l\u1EA1i
+- Kh\xF3 m\u1EDF r\u1ED9ng khi t\u1EA3i t\u0103ng \u0111\u1ED9t bi\u1EBFn
+
+</div>
+<div>
+
+### \u{1F7E2} Gi\u1EA3i Ph\xE1p T\u1ED1i \u01AFu M\u1EDBi
+- T\u1EF1 \u0111\u1ED9ng h\xF3a ho\xE0n to\xE0n lu\u1ED3ng x\u1EED l\xFD
+- Gi\xE1m s\xE1t tr\u1EA1ng th\xE1i th\u1EDDi gian th\u1EF1c
+- Kh\u1EA3 n\u0103ng co gi\xE3n linh ho\u1EA1t theo nhu c\u1EA7u
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- Nh\u1EA5n m\u1EA1nh \u0111i\u1EC3m ngh\u1EBDn l\u1EDBn nh\u1EA5t \u1EDF c\u1ED9t b\xEAn tr\xE1i.
+- D\u1EABn ch\u1EE9ng s\u1ED1 li\u1EC7u th\u1EF1c t\u1EBF ch\u1EE9ng minh t\xEDnh hi\u1EC7u qu\u1EA3 c\u1EE7a c\u1ED9t ph\u1EA3i.
+-->`
+  },
+  {
+    id: "code-explainer",
+    name: "Gi\u1EA3i Th\xEDch Code (Code Walkthrough)",
+    category: "code",
+    description: "C\u1ED9t tr\xE1i hi\u1EC3n th\u1ECB code snippet c\xF3 \u0111\xE1nh s\u1ED1, c\u1ED9t ph\u1EA3i gi\u1EA3i th\xEDch t\u1EEBng b\u01B0\u1EDBc ho\u1EA1t \u0111\u1ED9ng.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [80, 45, 1120, 65],
+          fontSize: "1.9rem"
+        },
+        {
+          id: "code-box",
+          target: ".columns-2 > div:first-child",
+          pos: [80, 135, 630, 535]
+        },
+        {
+          id: "notes-box",
+          target: ".columns-2 > div:last-child",
+          pos: [740, 135, 460, 535]
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 45, 1120, 65]
+      fontSize: 1.9rem
+    - id: code-box
+      target: '.columns-2 > div:first-child'
+      pos: [80, 135, 630, 535]
+    - id: notes-box
+      target: '.columns-2 > div:last-child'
+      pos: [740, 135, 460, 535]
+-->
+
+## \u{1F4BB} Ph\xE2n T\xEDch C\u1EA5u Tr\xFAc M\xE3 Ngu\u1ED3n
+
+<div class="columns-2">
+<div>
+
+\`\`\`ts
+// Kh\u1EDFi t\u1EA1o quy tr\xECnh ki\u1EC3m tra d\u1EEF li\u1EC7u
+export async function processPayment(order: Order) {
+  const isValid = await validateOrder(order);
+  if (!isValid) throw new Error("Invalid");
+
+  const receipt = await chargeCard(order);
+  return sendConfirmation(receipt);
+}
+\`\`\`
+
+</div>
+<div>
+
+### \u{1F50D} 3 \u0110i\u1EC3m C\u1EA7n Ch\xFA \xDD:
+1. **Ki\u1EC3m tra s\u1EDBm (Guard Clause):** Ki\u1EC3m tra t\xEDnh h\u1EE3p l\u1EC7 ngay d\xF2ng 3 \u0111\u1EC3 tr\xE1nh g\u1ECDi h\xE0m t\u1ED1n chi ph\xED.
+2. **B\u1EA5t \u0111\u1ED3ng b\u1ED9 (Async/Await):** \u0110\u1EA3m b\u1EA3o th\u1EE9 t\u1EF1 g\u1ECDi API t\xE0i ch\xEDnh chu\u1EA9n x\xE1c.
+3. **Ph\u1EA3n h\u1ED3i ng\u01B0\u1EDDi d\xF9ng:** Tr\u1EA3 v\u1EC1 bi\xEAn lai ho\xE0n ch\u1EC9nh sau khi giao d\u1ECBch th\xE0nh c\xF4ng.
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- Y\xEAu c\u1EA7u h\u1ECDc vi\xEAn x\xE1c \u0111\u1ECBnh d\xF2ng code n\xE0o l\xE0 r\u1EE7i ro nh\u1EA5t n\u1EBFu k\u1EBFt n\u1ED1i m\u1EA1ng b\u1ECB r\u1EDBt.
+- Nh\u1EAFc l\u1EA1i nguy\xEAn t\u1EAFc Fail-Fast trong l\u1EADp tr\xECnh ph\xF2ng th\u1EE7.
+-->`
+  },
+  {
+    id: "metrics-3-card",
+    name: "L\u01B0\u1EDBi 3 Ch\u1EC9 S\u1ED1 (3-Metric Dashboard)",
+    category: "metrics",
+    description: "Hi\u1EC3n th\u1ECB 3 ch\u1EC9 s\u1ED1 quan tr\u1ECDng (KPIs, Benchmarks, Impact) d\u1EA1ng card n\u1ED5i b\u1EADt.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [80, 50, 1120, 70],
+          fontSize: "2rem",
+          textAlign: "center"
+        },
+        {
+          id: "metric-1",
+          target: ".columns-3 > div:nth-child(1)",
+          pos: [80, 165, 340, 485]
+        },
+        {
+          id: "metric-2",
+          target: ".columns-3 > div:nth-child(2)",
+          pos: [470, 165, 340, 485]
+        },
+        {
+          id: "metric-3",
+          target: ".columns-3 > div:nth-child(3)",
+          pos: [860, 165, 340, 485]
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 50, 1120, 70]
+      fontSize: 2rem
+      textAlign: center
+    - id: metric-1
+      target: '.columns-3 > div:nth-child(1)'
+      pos: [80, 165, 340, 485]
+    - id: metric-2
+      target: '.columns-3 > div:nth-child(2)'
+      pos: [470, 165, 340, 485]
+    - id: metric-3
+      target: '.columns-3 > div:nth-child(3)'
+      pos: [860, 165, 340, 485]
+-->
+
+## \u{1F4CA} 3 Ch\u1EC9 S\u1ED1 Th\xE0nh C\xF4ng C\u1EE7a D\u1EF1 \xC1n
+
+<div class="columns-3">
+<div>
+
+# \u26A1 99.9%
+### \u0110\u1ED9 S\u1EB5n S\xE0ng (Uptime)
+H\u1EC7 th\u1ED1ng v\u1EADn h\xE0nh li\xEAn t\u1EE5c 24/7 v\u1EDBi kh\u1EA3 n\u0103ng t\u1EF1 ph\u1EE5c h\u1ED3i l\u1ED7i t\u1EE9c th\xEC.
+
+</div>
+<div>
+
+# \u{1F680} 10x
+### T\u1ED1c \u0110\u1ED9 X\u1EED L\xFD
+R\xFAt ng\u1EAFn th\u1EDDi gian bi\xEAn d\u1ECBch v\xE0 ph\u1EA3n h\u1ED3i ng\u01B0\u1EDDi d\xF9ng t\u1EEB gi\xE2y xu\u1ED1ng mili-gi\xE2y.
+
+</div>
+<div>
+
+# \u{1F6E1}\uFE0F 0
+### L\u1ED7 H\u1ED5ng B\u1EA3o M\u1EADt
+\u0110\u1EA1t chu\u1EA9n \u0111\xE1nh gi\xE1 an to\xE0n OWASP v\xE0 m\xE3 h\xF3a d\u1EEF li\u1EC7u \u0111\u1EA7u cu\u1ED1i.
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- Tr\xECnh b\xE0y l\u1EA7n l\u01B0\u1EE3t 3 m\u1EE5c ti\xEAu \u0111o l\u01B0\u1EDDng \u0111\u01B0\u1EE3c c\u1EE7a h\u1EC7 th\u1ED1ng.
+- Nh\u1EA5n m\u1EA1nh ch\u1EC9 s\u1ED1 th\u1EE9 2 l\xE0 tr\u1ECDng t\xE2m k\u1EF9 thu\u1EADt c\u1EE7a b\xE0i h\u1ECDc h\xF4m nay.
+-->`
+  },
+  {
+    id: "process-flow",
+    name: "S\u01A1 \u0110\u1ED3 Quy Tr\xECnh (Process / Flowchart)",
+    category: "diagram",
+    description: "Quy tr\xECnh nhi\u1EC1u b\u01B0\u1EDBc v\u1EDBi s\u01A1 \u0111\u1ED3 Mermaid tr\u1EF1c quan k\xE8m ghi ch\xFA t\xF3m t\u1EAFt.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [80, 45, 1120, 65],
+          fontSize: "1.9rem"
+        },
+        {
+          id: "diagram-box",
+          target: "pre.mermaid, .mermaid",
+          pos: [80, 130, 1120, 310]
+        },
+        {
+          id: "summary-box",
+          target: "ul, p",
+          pos: [80, 465, 1120, 205]
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 45, 1120, 65]
+      fontSize: 1.9rem
+    - id: diagram-box
+      target: 'pre.mermaid, .mermaid'
+      pos: [80, 130, 1120, 310]
+    - id: summary-box
+      target: 'ul, p'
+      pos: [80, 465, 1120, 205]
+-->
+
+## \u{1F504} Ki\u1EBFn Tr\xFAc Lu\u1ED3ng D\u1EEF Li\u1EC7u 4 B\u01B0\u1EDBc
+
+\`\`\`mermaid
+graph LR
+    A[1. Client Request] --> B[2. API Gateway]
+    B --> C[3. Auth Service]
+    C --> D[4. Database Cluster]
+    style A fill:#0284c7,stroke:#38bdf8,stroke-width:2px,color:#fff
+    style B fill:#1e293b,stroke:#64748b,stroke-width:2px,color:#fff
+    style C fill:#059669,stroke:#34d399,stroke-width:2px,color:#fff
+    style D fill:#7c3aed,stroke:#a78bfa,stroke-width:2px,color:#fff
+\`\`\`
+
+- **Giai \u0111o\u1EA1n 1 & 2:** Ti\u1EBFp nh\u1EADn y\xEAu c\u1EA7u t\u1EEB client, \u0111i\u1EC1u h\u01B0\u1EDBng t\u1EA3i v\xE0 gi\u1EDBi h\u1EA1n t\u1EA7n su\u1EA5t (Rate Limiting).
+- **Giai \u0111o\u1EA1n 3 & 4:** X\xE1c th\u1EF1c token JWT ph\xE2n quy\u1EC1n tr\u01B0\u1EDBc khi truy v\u1EA5n d\u1EEF li\u1EC7u t\u1EEB DB Cluster.
+
+<!--
+Presenter Notes:
+- Tr\u1ECF tr\u1EF1c ti\u1EBFp v\xE0o t\u1EEBng node c\u1EE7a s\u01A1 \u0111\u1ED3 Mermaid khi thuy\u1EBFt tr\xECnh.
+- \u0110\u1EB7t c\xE2u h\u1ECFi: "N\u1EBFu b\u01B0\u1EDBc 3 th\u1EA5t b\u1EA1i th\xEC b\u01B0\u1EDBc 4 c\xF3 \u0111\u01B0\u1EE3c g\u1ECDi kh\xF4ng?"
+-->`
+  },
+  {
+    id: "quote-highlight",
+    name: "Th\xF4ng \u0110i\u1EC7p Then Ch\u1ED1t (Quote / Highlight)",
+    category: "quote",
+    description: "Tr\xEDch d\u1EABn danh ng\xF4n ho\u1EB7c nguy\xEAn t\u1EAFc v\xE0ng c\u1EA7n ghi nh\u1EDB s\xE2u s\u1EAFc.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [100, 100, 1080, 80],
+          fontSize: "2.2rem",
+          textAlign: "center"
+        },
+        {
+          id: "quote-box",
+          target: "blockquote",
+          pos: [140, 230, 1e3, 360],
+          fontSize: "1.4rem"
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [100, 100, 1080, 80]
+      fontSize: 2.2rem
+      textAlign: center
+    - id: quote-box
+      target: blockquote
+      pos: [140, 230, 1000, 360]
+      fontSize: 1.4rem
+-->
+
+## \u{1F4A1} Nguy\xEAn T\u1EAFc Thi\u1EBFt K\u1EBF C\u1ED1t L\xF5i
+
+> "S\u1EF1 \u0111\u01A1n gi\u1EA3n l\xE0 \u0111i\u1EC1u ki\u1EC7n ti\xEAn quy\u1EBFt cho \u0111\u1ED9 tin c\u1EADy. M\u1ED9t ki\u1EBFn tr\xFAc t\u1ED1t l\xE0 khi b\u1EA5t k\u1EF3 l\u1EADp tr\xECnh vi\xEAn m\u1EDBi n\xE0o c\u0169ng c\xF3 th\u1EC3 \u0111\u1ECDc hi\u1EC3u lu\u1ED3ng ho\u1EA1t \u0111\u1ED9ng ch\u1EC9 sau 15 ph\xFAt."
+> 
+> \u2014 **Edsger W. Dijkstra**
+
+<!--
+Presenter Notes:
+- D\u1EEBng l\u1EA1i 5 gi\xE2y im l\u1EB7ng \u0111\u1EC3 c\u1EA3 l\u1EDBp c\xF9ng suy ng\u1EABm v\u1EC1 th\xF4ng \u0111i\u1EC7p.
+- Y\xEAu c\u1EA7u m\u1ED9t h\u1ECDc vi\xEAn chia s\u1EBB suy ngh\u0129 v\u1EC1 c\xE1ch \xE1p d\u1EE5ng nguy\xEAn t\u1EAFc n\xE0y v\xE0o b\xE0i t\u1EADp l\u1EDBn.
+-->`
+  },
+  {
+    id: "quiz-checkpoint",
+    name: "Tr\u1EAFc Nghi\u1EC7m T\u01B0\u01A1ng T\xE1c (Quiz Checkpoint)",
+    category: "assessment",
+    description: "C\xE2u h\u1ECFi t\u01B0\u01A1ng t\xE1c Formative Checkpoint k\xE8m c\xE1c l\u1EF1a ch\u1ECDn A/B/C/D \u0111\u1EC3 l\u1EDBp b\xECnh ch\u1ECDn.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [80, 45, 1120, 65],
+          fontSize: "1.9rem"
+        },
+        {
+          id: "question-callout",
+          target: "blockquote",
+          pos: [80, 130, 1120, 110],
+          fontSize: "1.2rem"
+        },
+        {
+          id: "options-list",
+          target: "ul",
+          pos: [80, 260, 1120, 390],
+          fontSize: "1.15rem"
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 45, 1120, 65]
+      fontSize: 1.9rem
+    - id: question-callout
+      target: blockquote
+      pos: [80, 130, 1120, 110]
+      fontSize: 1.2rem
+    - id: options-list
+      target: ul
+      pos: [80, 260, 1120, 390]
+      fontSize: 1.15rem
+-->
+
+## \u{1F3AF} Ki\u1EC3m Tra Nhanh: B\u1EA1n \u0110\xE3 Hi\u1EC3u \u0110\xFAng?
+
+> **C\xE2u h\u1ECFi:** Trong ki\u1EBFn tr\xFAc Microservices, c\u01A1 ch\u1EBF n\xE0o gi\xFAp \u0111\u1EA3m b\u1EA3o tin nh\u1EAFn kh\xF4ng b\u1ECB th\u1EA5t l\u1EA1c khi d\u1ECBch v\u1EE5 nh\u1EADn g\u1EB7p s\u1EF1 c\u1ED1 t\u1EA1m th\u1EDDi?
+
+- **A.** G\u1ECDi API HTTP tr\u1EF1c ti\u1EBFp v\u1EDBi timeout ng\u1EAFn
+- **B.** S\u1EED d\u1EE5ng Message Queue (H\xE0ng \u0111\u1EE3i tin nh\u1EAFn) c\xF3 c\u01A1 ch\u1EBF Retry & DLQ
+- **C.** L\u01B0u t\u1EA1m v\xE0o b\u1ED9 nh\u1EDB RAM c\u1EE7a m\xE1y kh\xE1ch (Client In-Memory Storage)
+- **D.** B\u1ECF qua tin nh\u1EAFn b\u1ECB l\u1ED7i v\xE0 th\xF4ng b\xE1o ng\u01B0\u1EDDi d\xF9ng g\u1EEDi l\u1EA1i t\u1EEB \u0111\u1EA7u
+
+<!--
+Presenter Notes:
+- D\xE0nh 30 gi\xE2y cho h\u1ECDc vi\xEAn gi\u01A1 tay ho\u1EB7c b\xECnh ch\u1ECDn \u0111\xE1p \xE1n.
+- \u0110\xE1p \xE1n ch\xEDnh x\xE1c: B.
+- Gi\u1EA3i th\xEDch v\xEC sao \u0111\xE1p \xE1n A v\xE0 C ti\u1EC1m \u1EA9n nguy c\u01A1 m\u1EA5t m\xE1t d\u1EEF li\u1EC7u nghi\xEAm tr\u1ECDng.
+-->`
+  },
+  {
+    id: "tiered-practice-3cards",
+    name: "Th\u1EF1c H\xE0nh Ph\xE2n H\xF3a (Tiered Practice)",
+    category: "content",
+    description: "3 c\u1EA5p b\u1EADc nhi\u1EC7m v\u1EE5 \u0110\u1ED3ng - B\u1EA1c - V\xE0ng \u0111\u1EC3 h\u1ECDc sinh t\u1EF1 ch\u1ECDn m\u1EE9c th\u1EED th\xE1ch ph\xF9 h\u1EE3p.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [80, 45, 1120, 65],
+          fontSize: "1.9rem"
+        },
+        {
+          id: "tier-bronze",
+          target: ".columns-3 > div:nth-child(1)",
+          pos: [80, 140, 350, 520]
+        },
+        {
+          id: "tier-silver",
+          target: ".columns-3 > div:nth-child(2)",
+          pos: [465, 140, 350, 520]
+        },
+        {
+          id: "tier-gold",
+          target: ".columns-3 > div:nth-child(3)",
+          pos: [850, 140, 350, 520]
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 45, 1120, 65]
+      fontSize: 1.9rem
+    - id: tier-bronze
+      target: '.columns-3 > div:nth-child(1)'
+      pos: [80, 140, 350, 520]
+    - id: tier-silver
+      target: '.columns-3 > div:nth-child(2)'
+      pos: [465, 140, 350, 520]
+    - id: tier-gold
+      target: '.columns-3 > div:nth-child(3)'
+      pos: [850, 140, 350, 520]
+-->
+
+## \u{1F6E0}\uFE0F Th\u1EED Th\xE1ch Ph\xE2n H\xF3a 3 C\u1EA5p \u0110\u1ED9 (Tiered Lab)
+
+<div class="columns-3">
+<div>
+
+### \u{1F949} H\u1EA1ng \u0110\u1ED3ng (Bronze)
+- Vi\u1EBFt h\xE0m x\u1EED l\xFD c\u01A1 b\u1EA3n
+- V\u01B0\u1EE3t qua 3 test case m\u1EABu
+- *M\u1EE5c ti\xEAu: \u0110\u1EA1t chu\u1EA9n ki\u1EBFn th\u1EE9c c\u01A1 b\u1EA3n*
+
+</div>
+<div>
+
+### \u{1F948} H\u1EA1ng B\u1EA1c (Silver)
+- Th\xEAm ki\u1EC3m tra \u0111i\u1EC1u ki\u1EC7n bi\xEAn
+- T\u1ED1i \u01B0u \u0111\u1ED9 ph\u1EE9c t\u1EA1p thu\u1EADt to\xE1n O(N)
+- *M\u1EE5c ti\xEAu: V\u1EEFng v\xE0ng k\u1EF9 n\u0103ng th\u1EF1c chi\u1EBFn*
+
+</div>
+<div>
+
+### \u{1F947} H\u1EA1ng V\xE0ng (Gold)
+- Thi\u1EBFt k\u1EBF t\xEDnh n\u0103ng m\u1EDF r\u1ED9ng
+- Vi\u1EBFt Unit Test t\u1EF1 \u0111\u1ED9ng bao ph\u1EE7 90%
+- *M\u1EE5c ti\xEAu: S\xE1ng t\u1EA1o & b\u1EE9t ph\xE1*
+
+</div>
+</div>
+
+<!--
+Presenter Notes:
+- To\xE0n b\u1ED9 l\u1EDBp \u0111\u1EC1u b\u1EAFt \u0111\u1EA7u t\u1EEB H\u1EA1ng \u0110\u1ED3ng \u0111\u1EC3 \u0111\u1EA3m b\u1EA3o hi\u1EC3u b\xE0i.
+- Khuy\u1EBFn kh\xEDch h\u1ECDc vi\xEAn \u0111\xE3 xong Bronze ch\u1EE7 \u0111\u1ED9ng th\u1EED s\u1EE9c v\u1EDBi Silver v\xE0 Gold.
+-->`
+  },
+  {
+    id: "agenda-timeline",
+    name: "L\u1ED9 Tr\xECnh Bu\u1ED5i H\u1ECDc (Agenda Table)",
+    category: "content",
+    description: "B\u1EA3ng l\u1ED9 tr\xECnh th\u1EDDi gian chi ti\u1EBFt theo t\u1EEBng giai \u0111o\u1EA1n v\xE0 s\u1EA3n ph\u1EA9m \u0111\u1EA7u ra.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [80, 45, 1120, 65],
+          fontSize: "1.9rem"
+        },
+        {
+          id: "table-box",
+          target: "table",
+          pos: [80, 140, 1120, 520]
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 45, 1120, 65]
+      fontSize: 1.9rem
+    - id: table-box
+      target: table
+      pos: [80, 140, 1120, 520]
+-->
+
+## \u{1F5FA}\uFE0F L\u1ED9 Tr\xECnh Ho\u1EA1t \u0110\u1ED9ng & M\u1EE5c Ti\xEAu
+
+| Th\u1EDDi l\u01B0\u1EE3ng | Giai \u0111o\u1EA1n | Tr\u1ECDng t\xE2m ho\u1EA1t \u0111\u1ED9ng | K\u1EBFt qu\u1EA3 \u0111\u1EA1t \u0111\u01B0\u1EE3c |
+|:---:|---|---|---|
+| **05'** | Kh\u1EDFi \u0111\u1ED9ng | T\xECnh hu\u1ED1ng th\u1EF1c t\u1EBF & Th\u1EED th\xE1ch | Nh\u1EADn di\u1EC7n b\xE0i to\xE1n c\u1EA7n gi\u1EA3i |
+| **15'** | Kh\xE1m ph\xE1 | Ph\xE2n t\xEDch 2 kh\xE1i ni\u1EC7m c\u1ED1t l\xF5i | Hi\u1EC3u b\u1EA3n ch\u1EA5t thu\u1EADt to\xE1n |
+| **20'** | Th\u1EF1c h\xE0nh | Code Lab t\u1EA1i m\xE1y theo 3 b\u1EADc | Ho\xE0n th\xE0nh t\u1ED1i thi\u1EC3u H\u1EA1ng \u0110\u1ED3ng |
+| **05'** | T\u1ED5ng k\u1EBFt | Tr\u1EAFc nghi\u1EC7m ph\u1EA3n x\u1EA1 & \u0110\xE1nh gi\xE1 | H\u1EC7 th\u1ED1ng h\xF3a to\xE0n b\u1ED9 ki\u1EBFn th\u1EE9c |
+
+<!--
+Presenter Notes:
+- Gi\u1EDBi thi\u1EC7u t\u1ED5ng quan \u0111\u1EC3 h\u1ECDc vi\xEAn bi\u1EBFt r\xF5 c\u1EA5u tr\xFAc bu\u1ED5i h\u1ECDc v\xE0 ch\u1EE7 \u0111\u1ED9ng ph\xE2n b\u1ED5 th\u1EDDi gian.
+-->`
+  },
+  {
+    id: "takeaways-summary",
+    name: "T\u1ED5ng K\u1EBFt C\u1ED1t L\xF5i (Key Takeaways)",
+    category: "content",
+    description: "Slide k\u1EBFt lu\u1EADn v\u1EDBi 3 b\xE0i h\u1ECDc \u0111\u1EAFt gi\xE1 nh\u1EA5t v\xE0 h\xE0nh \u0111\u1ED9ng ti\u1EBFp theo.",
+    layout: {
+      boxes: [
+        {
+          id: "heading",
+          target: "h2",
+          pos: [80, 50, 1120, 70],
+          fontSize: "2rem"
+        },
+        {
+          id: "list-box",
+          target: "ol",
+          pos: [80, 150, 1120, 340],
+          fontSize: "1.25rem"
+        },
+        {
+          id: "callout-next",
+          target: "blockquote",
+          pos: [80, 520, 1120, 140],
+          fontSize: "1.1rem"
+        }
+      ]
+    },
+    markdownSnippet: `<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 50, 1120, 70]
+      fontSize: 2rem
+    - id: list-box
+      target: ol
+      pos: [80, 150, 1120, 340]
+      fontSize: 1.25rem
+    - id: callout-next
+      target: blockquote
+      pos: [80, 520, 1120, 140]
+      fontSize: 1.1rem
+-->
+
+## \u{1F3C1} 3 \u0110i\u1EC1u C\u1EA7n Nh\u1EDB Sau Bu\u1ED5i H\u1ECDc
+
+1. **Hi\u1EC3u b\u1EA3n ch\u1EA5t tr\u01B0\u1EDBc khi vi\u1EBFt m\xE3:** Thu\u1EADt to\xE1n \u0111\xFAng lu\xF4n quan tr\u1ECDng h\u01A1n c\xFA ph\xE1p b\xF3ng b\u1EA9y.
+2. **Ki\u1EC3m so\xE1t \u0111i\u1EC1u ki\u1EC7n bi\xEAn:** 80% l\u1ED7i h\u1EC7 th\u1ED1ng ph\xE1t sinh t\u1EEB c\xE1c d\u1EEF li\u1EC7u \u0111\u1EA7u v\xE0o kh\xF4ng l\u01B0\u1EDDng tr\u01B0\u1EDBc.
+3. **Thi\u1EBFt k\u1EBF h\u01B0\u1EDBng m\xF4-\u0111un:** Chia nh\u1ECF v\u1EA5n \u0111\u1EC1 l\u1EDBn th\xE0nh c\xE1c h\xE0m \u0111\u1ED9c l\u1EADp d\u1EC5 ki\u1EC3m th\u1EED.
+
+> \u{1F4DD} **Nhi\u1EC7m v\u1EE5 v\u1EC1 nh\xE0:** Ho\xE0n thi\u1EC7n b\xE0i th\u1EF1c h\xE0nh H\u1EA1ng B\u1EA1c v\xE0 chu\u1EA9n b\u1ECB c\xE2u h\u1ECFi cho bu\u1ED5i Review tu\u1EA7n t\u1EDBi.
+
+<!--
+Presenter Notes:
+- T\xF3m t\u1EAFt s\xFAc t\xEDch trong 2 ph\xFAt cu\u1ED1i bu\u1ED5i.
+- Tuy\xEAn d\u01B0\u01A1ng c\xE1c b\u1EA1n c\xF3 gi\u1EA3i ph\xE1p xu\u1EA5t s\u1EAFc trong ph\u1EA7n th\u1EF1c h\xE0nh.
+-->`
+  }
+];
+function getSlideLayoutPresetById(id) {
+  return SLIDE_LAYOUT_PRESETS.find((p) => p.id === id);
+}
+function getSlideLayoutPresetsByCategory(category) {
+  return SLIDE_LAYOUT_PRESETS.filter((p) => p.category === category);
+}
 function renderMarp(markdown, containerId = "marp-container", enableClicks = false) {
   const cleanSource = extractMarpSource(markdown);
   const { markdown: clickProcessed, totalClicks } = enableClicks ? preprocessClicks(cleanSource) : { markdown: cleanSource, totalClicks: 0 };
@@ -1170,12 +2053,12 @@ function renderMarp(markdown, containerId = "marp-container", enableClicks = fal
     html: true,
     emoji: { unicode: true }
   });
-  const { html, css } = marp.render(arrowsConverted);
+  const { html, css, comments } = marp.render(arrowsConverted);
   if (enableClicks && totalClicks > 0) {
     const { html: processedHtml, totalClicks: finalClicks } = postprocessClicks(html);
-    return { html: processedHtml, css, maxClicks: finalClicks };
+    return { html: processedHtml, css, comments: comments ?? [], maxClicks: finalClicks };
   }
-  return { html, css, maxClicks: 0 };
+  return { html, css, comments: comments ?? [], maxClicks: 0 };
 }
 function countSlides(html) {
   const matches = html.match(/<svg[^>]*data-marpit-svg/g);
@@ -1185,47 +2068,54 @@ function renderSlide(markdown, options) {
   const containerId = options?.containerId ?? "marp-container";
   const theme = resolveTheme(options?.theme ?? "dark");
   const enableClicks = options?.enableClicks ?? false;
-  const { html, css, maxClicks } = renderMarp(markdown, containerId, enableClicks);
+  const { html, css, comments, maxClicks } = renderMarp(markdown, containerId, enableClicks);
   const themeCss = generateScopedCss2(theme, containerId);
   const slideCount = countSlides(html);
   const mermaidBlocks = options?.enableMermaid !== false ? detectMermaidBlocks(html) : [];
   const clickCss = enableClicks ? generateClickCss({ containerId }) : "";
+  const { layouts, notes } = extractLayoutsAndNotes(comments);
+  const layoutCss = generateLayoutCss(layouts, containerId);
   return {
     html,
     css,
     themeCss,
+    layoutCss,
     slideCount,
     mermaidBlocks,
     clickCss,
-    maxClicks
+    maxClicks,
+    notes,
+    layouts
   };
 }
 async function renderSlideAsync(markdown, options) {
   const containerId = options?.containerId ?? "marp-container";
   const theme = resolveTheme(options?.theme ?? "dark");
   const enableClicks = options?.enableClicks ?? false;
-  const { html, css, maxClicks } = renderMarp(markdown, containerId, enableClicks);
+  const { html, css, comments, maxClicks } = renderMarp(markdown, containerId, enableClicks);
   const themeCss = generateScopedCss2(theme, containerId);
   const slideCount = countSlides(html);
   const mermaidBlocks = options?.enableMermaid !== false ? detectMermaidBlocks(html) : [];
   const clickCss = enableClicks ? generateClickCss({ containerId }) : "";
-  let processedHtml = html;
-  if (options?.enableShiki !== false) {
-    const shikiThemeName = theme.name === "light" ? "light" : "dark";
-    processedHtml = await highlightCodeBlocks(html, shikiThemeName);
-  }
+  const { layouts, notes } = extractLayoutsAndNotes(comments);
+  const layoutCss = generateLayoutCss(layouts, containerId);
+  const enableShiki = options?.enableShiki ?? true;
+  const processedHtml = enableShiki ? await highlightCodeBlocks(html, theme.name) : html;
   return {
     html,
     css,
     themeCss,
+    layoutCss,
+    processedHtml,
     slideCount,
     mermaidBlocks,
     clickCss,
     maxClicks,
-    processedHtml
+    notes,
+    layouts
   };
 }
 
-export { convertTextArrows, countSlides, darkThemeTokens, defineTheme, detectMermaidBlocks, extractMarpSource, extractMaxClicks, generateClickCss, generateScopedCss, generateScopedCss2, getHighlighter, getThemeTokens, highlightCodeBlocks, lightThemeTokens, navyThemeTokens, postprocessClicks, preprocessClicks, renderMarp, renderMermaidDiagrams, renderSlide, renderSlideAsync, resolveTheme, sanitizeMermaidCode };
-//# sourceMappingURL=chunk-RCHOTRWI.js.map
-//# sourceMappingURL=chunk-RCHOTRWI.js.map
+export { SLIDE_LAYOUT_PRESETS, convertTextArrows, countSlides, darkThemeTokens, defineTheme, detectMermaidBlocks, extractLayoutsAndNotes, extractMarpSource, extractMaxClicks, filterPresenterNotes, generateClickCss, generateLayoutCss, generateScopedCss, generateScopedCss2, getHighlighter, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getThemeTokens, highlightCodeBlocks, isLayoutComment, lightThemeTokens, navyThemeTokens, parseLayoutFromComment, postprocessClicks, preprocessClicks, renderMarp, renderMermaidDiagrams, renderSlide, renderSlideAsync, resolveTheme, sanitizeMermaidCode, serializeLayoutToComment, splitMarkdownSlides, updateSlideLayoutInMarkdown };
+//# sourceMappingURL=chunk-PAHIW5IX.js.map
+//# sourceMappingURL=chunk-PAHIW5IX.js.map