@cyber-dash-tech/revela 0.19.4 → 0.19.7

package/lib/page-templates/render.ts

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, writeFileSync } from "fs"
 import { isAbsolute, normalize, resolve } from "path"
+import katex from "katex"
 import { getPageTemplateVocabulary } from "./vocabulary"
 
 export type PageTemplateStatus = "metadata-only" | "renderable"
@@ -141,6 +142,9 @@ const templates: PageTemplateDefinition[] = [
     field("chartTitle", "string", "Chart title."),
     field("takeawaysTitle", "string", "Title for the interpretation text panel."),
     field("items", "items[]", "Takeaways.", true),
+    field("quote", "string", "Optional italic quote text member inside the text panel."),
+    field("formulaLatex", "string", "Optional LaTeX formula text member inside the text panel."),
+    field("formulaCaption", "string", "Optional formula caption."),
   ], ["Chart area must be explicit and bounded."], ["Chart panel and takeaways both exist."]),
   define("table", "Table", "Explain a structured table with a left reading card and right table region.", [
     field("title", "string", "Slide title.", true),
@@ -278,6 +282,8 @@ export function builtInPreviewFixtures(): BuiltInPreviewFixture[] {
     fixture("chart-takeaways", {
       title: "chart-takeaways",
       takeawaysTitle: "What to read",
+      formulaLatex: "\\mathrm{CAGR}=\\left(\\frac{\\mathrm{FY26\\ Plan}}{\\mathrm{FY25}}\\right)^{1/n}-1",
+      formulaCaption: "Formula text member",
       items: [
         { label: "Trend", description: "Call out the movement or comparison the chart is meant to prove, including the direction and the comparison baseline." },
         { label: "Driver", description: "Name the likely reason without overclaiming; separate observed movement from the interpretation or hypothesis." },
@@ -288,6 +294,7 @@ export function builtInPreviewFixtures(): BuiltInPreviewFixture[] {
       title: "table",
       textTitle: "Financial readout",
       textBody: "Read top-line growth first, then check margin, cash conversion, and retention to see whether the plan is financially durable.",
+      quote: "Durability shows up when growth, margin, and cash all point in the same direction.",
       columns: ["Line item", "FY2025", "FY2026 Plan", "YoY / note"],
       rows: [
         ["Revenue", "$84.2M", "$104.8M", "+24% planned growth"],
@@ -324,6 +331,7 @@ export function builtInPreviewFixtures(): BuiltInPreviewFixture[] {
       title: "timeline",
       insightTitle: "Reading the journey",
       insightBody: "The timeline should show sequence and decision rhythm, while the side panel explains why the milestones matter.",
+      quote: "Sequence is evidence when each step changes what the audience can believe.",
       milestones: [
         { date: "Mar 2019", label: "Launch", description: "Baseline mapping." },
         { date: "Nov 2019", label: "Audit", description: "Evidence sprint." },
@@ -552,12 +560,12 @@ ${lucentClosingBackgroundCss}
 .template-agenda-inner { width: 100%; display: grid; grid-template-columns: 37% minmax(0, 1fr); align-items: stretch; gap: 76px; }
 .template-agenda-header { display: flex; flex-direction: column; min-height: 0; padding: 10px 0 0; }
 .template-agenda-header .template-eyebrow { color: rgba(255,255,255,0.64); }
-.template-agenda-header .template-title { max-width: 440px; font-size: 54px; line-height: 1.16; letter-spacing: 0; text-transform: uppercase; color: white; padding-bottom: 8px; overflow: visible; }
-.template-agenda-footer { margin: auto 0 0; font-size: 13px; line-height: 1.4; letter-spacing: 0.12em; text-transform: uppercase; font-weight: 800; color: rgba(255,255,255,0.84); }
+.template-agenda-header .template-title { max-width: 440px; font-family: var(--font-display); font-size: 54px; line-height: 1.16; letter-spacing: 0; text-transform: uppercase; color: white; padding-bottom: 8px; overflow: visible; }
+.template-agenda-footer { margin: auto 0 0; font-family: var(--font-body); font-size: 13px; line-height: 1.4; letter-spacing: 0.12em; text-transform: uppercase; font-weight: 800; color: rgba(255,255,255,0.84); }
 .template-agenda-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; justify-content: center; gap: 40px; height: 100%; }
 .template-agenda-item { display: grid; grid-template-columns: 86px minmax(0, 1fr); gap: 44px; align-items: center; min-height: 58px; overflow: visible; }
 .template-agenda-item span { font-family: var(--font-display); font-size: 44px; line-height: 1; letter-spacing: 0.03em; color: var(--accent-cyan, #18a8d8); font-weight: 800; font-variant-numeric: tabular-nums; }
-.template-agenda-item strong { font-size: 18px; line-height: 1.45; letter-spacing: 0.1em; text-transform: uppercase; font-weight: 700; color: rgba(255,255,255,0.92); }
+.template-agenda-item strong { font-family: var(--font-body); font-size: 18px; line-height: 1.45; letter-spacing: 0.1em; text-transform: uppercase; font-weight: 700; color: rgba(255,255,255,0.92); }
 .template-metric-layout { height: 100%; min-height: 0; display: grid; gap: 26px; }
 .template-metric-layout--insight-top { grid-template-rows: auto minmax(0, 1fr); }
 .template-metric-layout--insight-bottom { grid-template-rows: minmax(0, 1fr) auto; }
@@ -573,6 +581,15 @@ ${lucentClosingBackgroundCss}
 .template-text-panel--color { background: linear-gradient(135deg, #5f82c8 0%, var(--accent-primary) 58%, #18a8d8 115%); color: white; box-shadow: 0 22px 56px rgba(49,94,234,0.24); }
 .template-text-panel--color .template-text-panel-title { color: white; }
 .template-text-panel--color .template-text-panel-body { color: rgba(255,255,255,0.78); }
+.template-text-panel-quote { margin: 2px 0 0; font-size: 22px; line-height: 1.44; font-style: italic; color: var(--text-secondary); }
+.template-text-panel--color .template-text-panel-quote { color: rgba(255,255,255,0.82); }
+.template-text-panel-formula { margin: 0; width: 100%; display: grid; gap: 8px; color: var(--text-primary); }
+.template-text-panel--color .template-text-panel-formula { color: white; }
+.template-text-panel-formula .katex-display { margin: 0; overflow: visible; }
+.template-text-panel-formula .katex { font-size: 1.08em; color: inherit; }
+.template-text-panel-formula-fallback { display: block; white-space: normal; overflow-wrap: anywhere; font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 0.82em; line-height: 1.35; color: inherit; }
+.template-text-panel-formula-caption { margin: 0; font-size: 14px; line-height: 1.35; letter-spacing: 0.08em; text-transform: uppercase; color: var(--text-muted); }
+.template-text-panel--color .template-text-panel-formula-caption { color: rgba(255,255,255,0.72); }
 .template-chart-takeaway-list { display: grid; gap: 22px; width: 100%; }
 .template-chart-takeaway-item { display: grid; gap: 7px; padding-top: 18px; border-top: 1px solid rgba(255,255,255,0.24); }
 .template-chart-takeaway-item:first-child { padding-top: 0; border-top: 0; }
@@ -1045,6 +1062,7 @@ function chartTakeawayPanel(content: Record<string, any>): string {
   return `<div class="template-text-panel template-text-panel--color template-chart-takeaway-panel" data-template-slot="takeaways">
                     <h2 class="template-text-panel-title">${escapeHtml(title)}</h2>
                     <div class="template-chart-takeaway-list">${takeawayItems.map((item) => `<section class="template-chart-takeaway-item"><h3>${escapeHtml(item.label)}</h3><p>${escapeHtml(item.description)}</p></section>`).join("")}</div>
+                    ${renderTextMembers(content)}
                 </div>`
 }
 
@@ -1080,6 +1098,7 @@ function tablePage(content: Record<string, any>): string {
   const panelContent = {
     insightTitle: stringValue(content.textTitle) || "What to read",
     insightBody: stringValue(content.textBody) || "Use this card to explain the comparison, caveat, or decision implication before the audience scans the table.",
+    quote: stringValue(content.quote),
   }
   return `<div class="template-table-layout">${renderTextPanel(panelContent, "text-card", "clear")}<div class="template-table-region" data-template-slot="table">${table({ ...content, insightTitle: "", insightBody: "" })}</div></div>`
 }
@@ -1137,7 +1156,38 @@ function renderTextPanel(content: Record<string, any>, slot = "insight", variant
   const body = stringValue(content.insightBody)
   if (!body) return ""
   const title = stringValue(content.insightTitle) || "Insight"
-  return `<div class="template-side-panel template-text-panel template-text-panel--${variant}" data-template-slot="${escapeAttribute(slot)}"><h2 class="template-side-panel-title template-text-panel-title">${escapeHtml(title)}</h2><p class="template-side-panel-body template-text-panel-body">${escapeHtml(body)}</p></div>`
+  return `<div class="template-side-panel template-text-panel template-text-panel--${variant}" data-template-slot="${escapeAttribute(slot)}"><h2 class="template-side-panel-title template-text-panel-title">${escapeHtml(title)}</h2><p class="template-side-panel-body template-text-panel-body">${escapeHtml(body)}</p>${renderTextMembers(content)}</div>`
+}
+
+function renderTextMembers(content: Record<string, any>): string {
+  const quote = stringValue(content.quote)
+  const formulaLatex = stringValue(content.formulaLatex)
+  const parts: string[] = []
+  if (quote) parts.push(`<blockquote class="template-text-panel-quote">${escapeHtml(quote)}</blockquote>`)
+  if (formulaLatex) parts.push(renderFormulaMember(formulaLatex, stringValue(content.formulaCaption)))
+  return parts.join("")
+}
+
+function renderFormulaMember(latex: string, caption = ""): string {
+  const escapedLatex = escapeAttribute(latex)
+  const rendered = renderLatex(latex)
+  const captionHtml = caption ? `<p class="template-text-panel-formula-caption">${escapeHtml(caption)}</p>` : ""
+  return `<figure class="template-text-panel-formula" data-latex="${escapedLatex}">${rendered}${captionHtml}</figure>`
+}
+
+function renderLatex(latex: string): string {
+  try {
+    return katex.renderToString(latex, {
+      displayMode: true,
+      output: "mathml",
+      strict: "warn",
+      throwOnError: true,
+      trust: false,
+    })
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    return `<code class="template-text-panel-formula-fallback" data-formula-error="${escapeAttribute(message)}">${escapeHtml(latex)}</code>`
+  }
 }
 
 function imageCard(input: any): string {
@@ -1189,11 +1239,11 @@ function scaffoldSeed(templateId: string, seed: Record<string, any>): Record<str
   if (templateId === "key-message-evidence") return { body: "Replace with the key message the audience should remember.", items: defaultItems(["Evidence 1", "Evidence 2", "Evidence 3"]), ...base }
   if (templateId === "claim-supporting-visual") return { claim: "Replace with one visual claim.", body: "Use this copy to guide how the visual should be read.", items: defaultItems(["Anchor", "Callout"]), ...base }
   if (templateId === "metric-highlight") return { metrics: [{ value: "67%", label: "Metric", description: "Replace with interpretation." }, { value: "3x", label: "Comparison", description: "Replace with reading note." }, { value: "14d", label: "Window", description: "Replace with time context." }], insightTitle: "Read the signal", insightBody: "Replace with the decision implication, caveat, or next reading step.", ...base }
-  if (templateId === "chart-takeaways") return { takeawaysTitle: "What to read", items: defaultItems(["Trend", "Driver", "Decision use"]), ...base }
-  if (templateId === "table") return { textTitle: "Financial readout", textBody: "Replace with the table reading note, caveat, or decision implication.", columns: ["Line item", "FY2025", "FY2026 Plan", "YoY / note"], rows: [["Revenue", "$84.2M", "$104.8M", "+24% planned growth"], ["Gross margin", "68.4%", "71.2%", "+280 bps mix shift"], ["Operating expense", "$42.7M", "$49.1M", "Scale hiring below revenue growth"], ["EBITDA", "$14.9M", "$23.6M", "+58% operating leverage"], ["Free cash flow", "$9.8M", "$16.4M", "Cash conversion improves"], ["Net retention", "116%", "121%", "Expansion supports plan quality"]], ...base }
+  if (templateId === "chart-takeaways") return { takeawaysTitle: "What to read", items: defaultItems(["Trend", "Driver", "Decision use"]), formulaLatex: "\\mathrm{CAGR}=\\left(\\frac{\\mathrm{FY26\\ Plan}}{\\mathrm{FY25}}\\right)^{1/n}-1", formulaCaption: "Formula text member", ...base }
+  if (templateId === "table") return { textTitle: "Financial readout", textBody: "Replace with the table reading note, caveat, or decision implication.", quote: "Durability shows up when growth, margin, and cash all point in the same direction.", columns: ["Line item", "FY2025", "FY2026 Plan", "YoY / note"], rows: [["Revenue", "$84.2M", "$104.8M", "+24% planned growth"], ["Gross margin", "68.4%", "71.2%", "+280 bps mix shift"], ["Operating expense", "$42.7M", "$49.1M", "Scale hiring below revenue growth"], ["EBITDA", "$14.9M", "$23.6M", "+58% operating leverage"], ["Free cash flow", "$9.8M", "$16.4M", "Cash conversion improves"], ["Net retention", "116%", "121%", "Expansion supports plan quality"]], ...base }
   if (templateId === "table-comparison") return { columns: ["Dimension", "Current", "Target"], rows: [["Replace", "Current state", "Target state"], ["Caveat", "Known limit", "Next proof"]], insightTitle: "Insight", insightBody: "Replace with the table reading note or caveat.", ...base }
   if (templateId === "milestone" || templateId === "timeline-roadmap") return { orientation: "horizontal", milestones: [{ date: "2022", label: "Signal", description: "Name the starting condition." }, { date: "2023", label: "Proof", description: "Show the evidence threshold." }, { date: "2024", label: "Inflection", description: "Use the pivotal moment to frame the shift." }, { date: "2025", label: "Scale", description: "Use a taller card for the highlighted milestone.", highlight: true }, { date: "2026", label: "Decision", description: "State what changes next." }], ...base }
-  if (templateId === "timeline") return { orientation: "vertical", insightTitle: "Reading the journey", insightBody: "Replace with the timeline interpretation or caveat.", milestones: [{ date: "Mar 2019", label: "Launch", description: "Name the starting event." }, { date: "Nov 2019", label: "Audit", description: "Show the evidence threshold." }, { date: "May 2020", label: "Scale", description: "Explain the operating cadence." }, { date: "Feb 2021", label: "Review", description: "State what changes next." }], ...base }
+  if (templateId === "timeline") return { orientation: "vertical", insightTitle: "Reading the journey", insightBody: "Replace with the timeline interpretation or caveat.", quote: "Sequence is evidence when each step changes what the audience can believe.", milestones: [{ date: "Mar 2019", label: "Launch", description: "Name the starting event." }, { date: "Nov 2019", label: "Audit", description: "Show the evidence threshold." }, { date: "May 2020", label: "Scale", description: "Explain the operating cadence." }, { date: "Feb 2021", label: "Review", description: "State what changes next." }], ...base }
   if (templateId === "process-steps") return { steps: defaultItems(["Step 1", "Step 2", "Step 3"]), ...base }
   if (templateId === "recommendation-decision") return { recommendation: "Replace with the recommended decision.", items: defaultItems(["Rationale"]), steps: defaultItems(["Pilot", "Validate", "Ship"]), ...base }
   if (templateId === "risks-tradeoffs") return { items: defaultItems(["Risk", "Tradeoff", "Mitigation"]), ...base }

package/lib/page-templates/vocabulary.ts

@@ -55,8 +55,8 @@ export const PAGE_TEMPLATE_VOCABULARY: PageTemplateVocabulary[] = [
   vocab("key-message-evidence", ["template-key-message-panel", "template-evidence-grid"], ["key-message", "evidence"], ["key-message", "evidence"], ["Key message and evidence regions must remain distinct."]),
   vocab("claim-supporting-visual", ["template-claim-text-panel", "template-visual-slot-panel"], ["claim", "visual"], ["claim", "visual"], ["Visual slot may be replaced by image, chart, table, or diagram container."]),
   vocab("metric-highlight", ["template-stat-grid"], ["metrics"], ["metrics", "insight"], ["Metric values should remain visible outside prose."]),
-  vocab("chart-takeaways", ["template-chart-panel", "template-chart-takeaway-panel", "template-text-panel--color"], ["visual", "takeaways"], ["visual", "takeaways"], ["Chart/image slot and color takeaway text panel must both remain present."]),
-  vocab("table", ["template-table-layout", "template-table-wrap", "template-table", "template-side-panel", "template-text-panel", "template-text-panel--clear"], ["text-card", "table"], ["text-card", "table"], ["Left clear text card explains how to read the structured table.", "Table headers and body should remain structured, not prose-only."]),
+  vocab("chart-takeaways", ["template-chart-panel", "template-chart-takeaway-panel", "template-text-panel--color"], ["visual", "takeaways"], ["visual", "takeaways"], ["Chart/image slot and color takeaway text panel must both remain present.", "Text panels may include quote and formula text members; do not model them as standalone components."]),
+  vocab("table", ["template-table-layout", "template-table-wrap", "template-table", "template-side-panel", "template-text-panel", "template-text-panel--clear"], ["text-card", "table"], ["text-card", "table"], ["Left clear text card explains how to read the structured table.", "Table headers and body should remain structured, not prose-only.", "Text panels may include quote text members; do not model quotes as standalone components."]),
   vocab("table-comparison", ["template-table-wrap", "template-table"], ["table"], ["table", "insight"], ["Table headers and body should remain structured, not prose-only."]),
   vocab("milestone", ["template-timeline", "template-timeline-item", "template-timeline-dot", "template-timeline-copy", "template-insight-icon"], ["timeline"], ["timeline"], ["Each milestone item must keep dot and copy as sibling anchors inside one item.", "Milestone cards reuse .template-card; highlight uses the item modifier."]),
   vocab("timeline", ["template-timeline", "template-timeline-item", "template-timeline-dot", "template-timeline-copy"], ["timeline"], ["timeline", "insight"], ["Each timeline item must keep dot and copy as sibling anchors inside one item.", "The optional color insight slot explains the sequence without replacing event copy."]),
@@ -107,6 +107,10 @@ const additionalClasses = [
   "template-text-panel--color",
   "template-text-panel-title",
   "template-text-panel-body",
+  "template-text-panel-quote",
+  "template-text-panel-formula",
+  "template-text-panel-formula-caption",
+  "template-text-panel-formula-fallback",
   "template-insight-panel",
   "template-insight-title",
   "template-insight-icon",

package/lib/pdf/export.ts

@@ -31,6 +31,7 @@ import { randomBytes } from "crypto"
 import { launchChrome } from "../browser/chrome"
 import { detectDeckHtml } from "../html-export/deck-detect"
 import { exportSinglePageHtmlPdf } from "../html-export"
+import { withExportBaseHref } from "../export/html"
 
 // ── Constants ────────────────────────────────────────────────────────────────
 
@@ -187,16 +188,6 @@ async function toDataUrlFromRef(ref: string, baseDir: string): Promise<string |
   }
 }
 
-function withExportBaseHref(html: string, htmlFilePath: string): string {
-  const baseHref = pathToFileURL(`${dirname(resolve(htmlFilePath))}/`).href
-  const baseTag = `<base href="${baseHref}">`
-  if (/<base\b/i.test(html)) return html
-  if (/<head[^>]*>/i.test(html)) {
-    return html.replace(/<head([^>]*)>/i, `<head$1>\n${baseTag}`)
-  }
-  return `${baseTag}\n${html}`
-}
-
 async function prepareSlidesForExport(page: any): Promise<void> {
   await page.evaluate((canvasWidth: number, canvasHeight: number) => {
     document.documentElement.style.scrollSnapType = "none"

package/lib/pptx/export.ts

@@ -22,6 +22,7 @@ import { basename, dirname, extname, join, posix as pathPosix, resolve } from "p
 import { randomBytes } from "crypto"
 import { pathToFileURL } from "url"
 import { findChromePath, launchChrome } from "../browser/chrome"
+import { withExportBaseHref } from "../export/html"
 
 const CANVAS_W = 1920
 const CANVAS_H = 1080
@@ -344,6 +345,7 @@ async function preparePage(
     document.documentElement.style.scrollSnapType = "none"
     document.documentElement.style.overflow = "visible"
     document.body.style.overflow = "visible"
+    document.body.style.margin = "0"
 
     const slides = Array.from(document.querySelectorAll(".slide")) as HTMLElement[]
     if (slides.length === 0) {
@@ -366,7 +368,24 @@ async function preparePage(
       exportStyle = document.createElement("style")
       exportStyle.id = "revela-pptx-export-style"
       exportStyle.textContent = `
+        html, body {
+          scroll-snap-type: none !important;
+          overflow: visible !important;
+        }
+        .slide {
+          width: 1920px !important;
+          min-width: 1920px !important;
+          height: 1080px !important;
+          min-height: 1080px !important;
+          display: flex !important;
+          align-items: center !important;
+          justify-content: center !important;
+          overflow: hidden !important;
+          scroll-snap-align: none !important;
+        }
         .slide-canvas {
+          width: 1920px !important;
+          height: 1080px !important;
           transform: none !important;
           transform-origin: top left !important;
           transition: none !important;
@@ -466,6 +485,48 @@ async function readSlideMeta(
   })
 }
 
+async function rasterizeFormulaNodes(page: Page, diagnostics: string[]): Promise<number> {
+  const handles = await page.$$(".template-text-panel-formula, .text-panel-formula")
+  let rasterized = 0
+
+  for (const handle of handles) {
+    try {
+      const box = await handle.boundingBox()
+      if (!box || box.width <= 0 || box.height <= 0) continue
+
+      const base64 = await (handle as any).screenshot({
+        encoding: "base64",
+        omitBackground: true,
+      })
+
+      await handle.evaluate((node, payload) => {
+        const element = node as HTMLElement
+        const img = document.createElement("img")
+        img.src = `data:image/png;base64,${payload.base64}`
+        img.alt = element.getAttribute("data-latex") || "Formula"
+        img.setAttribute("data-revela-pptx-formula-raster", "true")
+        img.style.width = `${payload.width}px`
+        img.style.height = `${payload.height}px`
+        img.style.maxWidth = "100%"
+        img.style.display = "block"
+        img.style.objectFit = "contain"
+        element.replaceChildren(img)
+      }, {
+        base64,
+        width: Math.ceil(box.width),
+        height: Math.ceil(box.height),
+      })
+
+      rasterized += 1
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error)
+      diagnostics.push(`formula rasterize failed: ${message}`)
+    }
+  }
+
+  return rasterized
+}
+
 async function exportSlidePptx(
   page: Page,
   diagnostics: string[],
@@ -499,15 +560,47 @@ async function exportSlidePptx(
         })
       }
 
-      target.scrollIntoView({ block: "center", inline: "center" })
       target.style.transform = "none"
       target.style.transformOrigin = "top left"
       target.style.transition = "none"
       target.style.animation = "none"
       await new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(resolve)))
 
+      const host = document.createElement("div")
+      host.id = "revela-pptx-export-root"
+      host.style.position = "fixed"
+      host.style.left = "0"
+      host.style.top = "0"
+      host.style.width = "1920px"
+      host.style.height = "1080px"
+      host.style.overflow = "hidden"
+      host.style.zIndex = "2147483647"
+      host.style.background = "transparent"
+
+      const exportTarget = target.cloneNode(true) as HTMLElement
+      exportTarget.style.width = "1920px"
+      exportTarget.style.height = "1080px"
+      exportTarget.style.position = "relative"
+      exportTarget.style.left = "0"
+      exportTarget.style.top = "0"
+      exportTarget.style.transform = "none"
+      exportTarget.style.transformOrigin = "top left"
+      exportTarget.style.transition = "none"
+      exportTarget.style.animation = "none"
+      host.appendChild(exportTarget)
+      document.body.appendChild(host)
+      await new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(resolve)))
+
+      const rect = exportTarget.getBoundingClientRect()
+      if (Math.abs(rect.width - 1920) > 2 || Math.abs(rect.height - 1080) > 2) {
+        host.remove()
+        throw new Error(
+          `Slide ${index + 1} export canvas is ${Math.round(rect.width)}x${Math.round(rect.height)}, expected 1920x1080.`
+        )
+      }
+
       await Promise.all(
-        Array.from(target.querySelectorAll("img")).map(async (img) => {
+        Array.from(exportTarget.querySelectorAll("img")).map(async (img) => {
           if (img.complete) return
           await new Promise((resolve) => {
             img.addEventListener("load", resolve, { once: true })
@@ -516,15 +609,19 @@ async function exportSlidePptx(
         })
       )
 
-      const blob: Blob = await domToPptx.exportToPptx(target, {
-        fileName: `slide-${index + 1}.pptx`,
-        skipDownload: true,
-        svgAsVector: false,
-        autoEmbedFonts,
-        width: 10,
-        height: 5.625,
-      })
-      return Array.from(new Uint8Array(await blob.arrayBuffer()))
+      try {
+        const blob: Blob = await domToPptx.exportToPptx(exportTarget, {
+          fileName: `slide-${index + 1}.pptx`,
+          skipDownload: true,
+          svgAsVector: false,
+          autoEmbedFonts,
+          width: 10,
+          height: 5.625,
+        })
+        return Array.from(new Uint8Array(await blob.arrayBuffer()))
+      } finally {
+        host.remove()
+      }
     }, { index: slide.index, autoEmbedFonts: options.autoEmbedFonts })
 
     return {
@@ -717,6 +814,55 @@ function setSpeakerNotes(files: ZipFiles, notesPath: string, notes: string | nul
   files[notesPath] = xmlToBytes(doc)
 }
 
+function stripSvgBlipFallbacks(pptxBytes: Uint8Array): Uint8Array {
+  const files = unzipSync(pptxBytes)
+  const orphanedSvgParts = new Set<string>()
+
+  for (const slidePath of Object.keys(files).filter((path) => /^ppt\/slides\/slide\d+\.xml$/.test(path))) {
+    const slideXml = getFileText(files, slidePath)
+    if (!slideXml.includes("asvg:svgBlip")) continue
+
+    const slideDoc = parseXml(slideXml)
+    const relsPath = relsPathForPart(slidePath)
+    const relsDoc = files[relsPath] ? parseXml(getFileText(files, relsPath)) : null
+    const svgRelIds = new Set<string>()
+
+    for (const svgBlip of Array.from(slideDoc.getElementsByTagName("asvg:svgBlip"))) {
+      const relId = svgBlip.getAttribute("r:embed")
+      if (relId) svgRelIds.add(relId)
+    }
+
+    for (const blip of Array.from(slideDoc.getElementsByTagName("a:blip"))) {
+      for (const extLst of Array.from(blip.getElementsByTagName("a:extLst"))) {
+        if (Array.from(extLst.getElementsByTagName("asvg:svgBlip")).length === 0) continue
+        blip.removeChild(extLst)
+      }
+    }
+
+    if (relsDoc && svgRelIds.size > 0) {
+      const relRoot = relsDoc.getElementsByTagName("Relationships")[0]
+      for (const rel of Array.from(relsDoc.getElementsByTagName("Relationship"))) {
+        const relId = rel.getAttribute("Id")
+        if (!relId || !svgRelIds.has(relId)) continue
+        const target = rel.getAttribute("Target")
+        if (target) orphanedSvgParts.add(resolveRelationshipTarget(slidePath, target))
+        relRoot?.removeChild(rel)
+      }
+      files[relsPath] = xmlToBytes(relsDoc)
+    }
+
+    files[slidePath] = xmlToBytes(slideDoc)
+  }
+
+  for (const partPath of orphanedSvgParts) {
+    if (/^ppt\/media\/.+\.svg$/i.test(partPath)) {
+      delete files[partPath]
+    }
+  }
+
+  return zipSync(files, { level: 0 })
+}
+
 export function applySpeakerNotesToPptx(pptxBytes: Uint8Array, notesBySlide: Array<string | null | undefined>): Uint8Array {
   const files = unzipSync(pptxBytes)
 
@@ -724,7 +870,7 @@ export function applySpeakerNotesToPptx(pptxBytes: Uint8Array, notesBySlide: Arr
     setSpeakerNotes(files, `ppt/notesSlides/notesSlide${index + 1}.xml`, notes ?? null)
   })
 
-  return zipSync(files)
+  return stripSvgBlipFallbacks(zipSync(files))
 }
 
 function updateAppProperties(files: ZipFiles, slideCount: number): void {
@@ -898,7 +1044,7 @@ function mergeSingleSlidePptx(slides: ExportedSlide[]): Uint8Array {
   mergedFiles["ppt/_rels/presentation.xml.rels"] = xmlToBytes(presentationRelsDoc)
   updateAppProperties(mergedFiles, slides.length)
 
-  return zipSync(mergedFiles, { level: 0 })
+  return stripSvgBlipFallbacks(zipSync(mergedFiles, { level: 0 }))
 }
 
 export async function exportToPptx(
@@ -937,7 +1083,7 @@ export async function exportToPptx(
     const prepareStart = Date.now()
     const originalHtml = readFileSync(abs, "utf-8")
     const localized = await localizeExternalImages(originalHtml, tmpDir)
-    const patchedHtml = await inlineImageAssets(localized.html, abs)
+    const patchedHtml = withExportBaseHref(await inlineImageAssets(localized.html, abs), abs)
     tmpHtmlPath = join(tmpDir, "index.html")
     writeFileSync(tmpHtmlPath, patchedHtml, "utf-8")
     timingsMs.prepareMs = Date.now() - prepareStart
@@ -961,6 +1107,7 @@ export async function exportToPptx(
   try {
     const pageSetupStart = Date.now()
     const { page, slideCount, diagnostics } = await preparePage(browser, tmpHtmlPath, domToPptxBundlePath)
+    const rasterizedFormulaCount = await rasterizeFormulaNodes(page, diagnostics)
     timingsMs.pageSetupMs = Date.now() - pageSetupStart
     const exported: ExportedSlide[] = []
     const failures: SlideFailure[] = []
@@ -969,7 +1116,9 @@ export async function exportToPptx(
       const slides = applySpeakerNotesOverride(await readSlideMeta(page, slideCount), options?.speakerNotes)
       await emitProgress(options, {
         kind: "stage",
-        message: `Deck ready. Exporting ${slides.length} slide(s) to editable PPTX parts...`,
+        message: rasterizedFormulaCount > 0
+          ? `Deck ready. Rasterized ${rasterizedFormulaCount} formula text member(s). Exporting ${slides.length} slide(s) to editable PPTX parts...`
+          : `Deck ready. Exporting ${slides.length} slide(s) to editable PPTX parts...`,
       })
 
       const slideExportStart = Date.now()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.19.4",
+  "version": "0.19.7",
   "description": "Codex-first CLI/MCP workspace for trusted narrative artifacts from local sources, research, and evidence",
   "type": "module",
   "main": "./index.ts",
@@ -68,6 +68,7 @@
     "dom-to-pptx": "^1.1.6",
     "fflate": "^0.8.2",
     "jimp": "^1.6.1",
+    "katex": "^0.17.0",
     "mammoth": "^1.12.0",
     "pdf-lib": "^1.17.1",
     "puppeteer-core": "^24.40.0",

package/plugins/revela/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "revela",
-  "version": "0.19.4",
+  "version": "0.19.7",
   "description": "Use Revela in Codex to specify, research, plan, make, and export trusted narrative decision artifacts.",
   "author": {
     "name": "cyber-dash-tech",