@miao-vision/cli 0.1.9 → 0.1.10

package/dist/cli.cjs

@@ -41719,7 +41719,19 @@ var defaultTheme = {
     labelColor: "#475569"
   },
   css: `
-    :root { color-scheme: light; font-family: Inter, ui-sans-serif, system-ui, -apple-system, sans-serif; }
+    :root {
+      color-scheme: light;
+      font-family: Inter, ui-sans-serif, system-ui, -apple-system, sans-serif;
+      --mv-paper: #f8fafc;
+      --mv-surface: #ffffff;
+      --mv-border: #e2e8f0;
+      --mv-ink: #0f172a;
+      --mv-muted: #64748b;
+      --mv-soft: #475569;
+      --mv-brand: #2563eb;
+      --mv-serif: Georgia, "Times New Roman", serif;
+      --mv-mono: "SF Mono", "JetBrains Mono", Consolas, monospace;
+    }
     body { margin: 0; background: #f8fafc; color: #0f172a; }
     .miao-viz-report { max-width: 1120px; margin: 0 auto; padding: 40px 24px 56px; }
     header { margin-bottom: 28px; }
@@ -41760,6 +41772,7 @@ var editorialTheme = {
       --mv-ink: #141413;
       --mv-muted: #6b6a64;
       --mv-soft-text: #504e49;
+      --mv-soft: #504e49;
       --mv-brand: #1b365d;
       --mv-mono: "SF Mono", "JetBrains Mono", Consolas, monospace;
       --mv-serif: Charter, Georgia, "Times New Roman", serif;
@@ -41824,6 +41837,7 @@ var darkTheme = {
       --mv-ink: #e2e0d8;
       --mv-muted: #737069;
       --mv-soft-text: #a8a69f;
+      --mv-soft: #a8a69f;
       --mv-brand: #7eb8f7;
       --mv-mono: "SF Mono", "JetBrains Mono", Consolas, monospace;
       --mv-serif: Charter, Georgia, "Times New Roman", serif;
@@ -41881,7 +41895,19 @@ var minimalTheme = {
     labelColor: "#6b7280"
   },
   css: `
-    :root { color-scheme: light; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; }
+    :root {
+      color-scheme: light;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+      --mv-paper: #ffffff;
+      --mv-surface: #ffffff;
+      --mv-border: #e5e7eb;
+      --mv-ink: #111111;
+      --mv-muted: #6b7280;
+      --mv-soft: #374151;
+      --mv-brand: #1d4ed8;
+      --mv-serif: Georgia, "Times New Roman", serif;
+      --mv-mono: "SF Mono", "JetBrains Mono", Consolas, monospace;
+    }
     body { margin: 0; background: #fff; color: #111; }
     .miao-viz-report { max-width: 960px; margin: 0 auto; padding: 48px 24px 64px; }
     header { margin-bottom: 32px; }
@@ -58128,6 +58154,42 @@ function parseAnalyzeContext(value) {
 function withSize(chart, width, height) {
   return { ...chart, style: { ...chart.style, width, height } };
 }
+function formatMetricValue(num, fmt) {
+  const hasCurrency = fmt.includes("$");
+  const hasPercent = fmt.includes("%");
+  const hasThousands = fmt.includes(",");
+  const hasSiPrefix = fmt.includes("s");
+  const precisionMatch = fmt.match(/\.(\d+)/);
+  let precision = precisionMatch ? parseInt(precisionMatch[1], 10) : void 0;
+  let value = num;
+  let suffix = "";
+  if (hasPercent) {
+    value = num < 2 ? num * 100 : num;
+    suffix = "%";
+    if (precision === void 0) precision = 1;
+  }
+  if (hasSiPrefix) {
+    const abs = Math.abs(value);
+    if (abs >= 1e9) {
+      value /= 1e9;
+      suffix = "B" + suffix;
+    } else if (abs >= 1e6) {
+      value /= 1e6;
+      suffix = "M" + suffix;
+    } else if (abs >= 1e3) {
+      value /= 1e3;
+      suffix = "K" + suffix;
+    }
+    if (precision === void 0) precision = 0;
+  }
+  if (precision === void 0 && hasThousands) precision = 0;
+  const fixed = precision !== void 0 ? value.toFixed(precision) : Math.round(value).toString();
+  const [intPart, decPart] = fixed.split(".");
+  const formattedInt = hasThousands ? intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",") : intPart;
+  const formatted = decPart !== void 0 ? `${formattedInt}.${decPart}` : formattedInt;
+  const prefix = hasCurrency ? "$" : "";
+  return prefix + formatted + suffix;
+}
 function resolveMetricValue(metric, rows) {
   let raw = metric.value;
   if (raw === void 0 && metric.data?.transform?.length) {
@@ -58137,10 +58199,7 @@ function resolveMetricValue(metric, rows) {
   }
   const num = Number(raw);
   if (!Number.isFinite(num)) return String(raw ?? "\u2014");
-  const fmt = metric.format ?? "";
-  if (fmt.includes("$")) return "$" + Math.round(num).toLocaleString();
-  if (fmt.includes("%")) return (num < 2 ? (num * 100).toFixed(1) : num.toFixed(1)) + "%";
-  return Math.round(num).toLocaleString();
+  return formatMetricValue(num, metric.format ?? "");
 }
 function renderEyebrow(text) {
   return `<div class="slide-eyebrow">${escapeHtml(text)}</div>`;
@@ -58166,21 +58225,22 @@ function pageFooter(index, _total, mark) {
     <div class="slide-page-num">${String(index + 1).padStart(2, "0")}</div>`;
 }
 var COVER_DECO = `<svg viewBox="0 0 320 320" xmlns="http://www.w3.org/2000/svg" style="width:260px;opacity:0.9">
-  <circle cx="160" cy="160" r="140" fill="none" stroke="#e5e3d8" stroke-width="1"/>
-  <circle cx="160" cy="160" r="100" fill="none" stroke="#e5e3d8" stroke-width="1"/>
-  <circle cx="160" cy="160" r="60" fill="#eef2f7" stroke="#1b365d" stroke-width="1.2"/>
-  <path d="M160 20 A140 140 0 0 1 300 160" fill="none" stroke="#1b365d" stroke-width="2.2" stroke-linecap="round"/>
-  <path d="M300 160 A140 140 0 0 1 160 300" fill="none" stroke="#6b6a64" stroke-width="1" stroke-linecap="round"/>
-  <path d="M160 300 A140 140 0 0 1 20 160" fill="none" stroke="#6b6a64" stroke-width="1" stroke-linecap="round"/>
-  <path d="M20 160 A140 140 0 0 1 160 20" fill="none" stroke="#6b6a64" stroke-width="1" stroke-linecap="round"/>
+  <circle cx="160" cy="160" r="140" fill="none" stroke="var(--mv-border, #e5e3d8)" stroke-width="1"/>
+  <circle cx="160" cy="160" r="100" fill="none" stroke="var(--mv-border, #e5e3d8)" stroke-width="1"/>
+  <circle cx="160" cy="160" r="60" fill="var(--mv-surface, #eef2f7)" stroke="var(--mv-brand, #1b365d)" stroke-width="1.2"/>
+  <path d="M160 20 A140 140 0 0 1 300 160" fill="none" stroke="var(--mv-brand, #1b365d)" stroke-width="2.2" stroke-linecap="round"/>
+  <path d="M300 160 A140 140 0 0 1 160 300" fill="none" stroke="var(--mv-muted, #6b6a64)" stroke-width="1" stroke-linecap="round"/>
+  <path d="M160 300 A140 140 0 0 1 20 160" fill="none" stroke="var(--mv-muted, #6b6a64)" stroke-width="1" stroke-linecap="round"/>
+  <path d="M20 160 A140 140 0 0 1 160 20" fill="none" stroke="var(--mv-muted, #6b6a64)" stroke-width="1" stroke-linecap="round"/>
 </svg>`;
-function renderCoverSlide(slide, _rows, _svg, index, total) {
+function renderCoverSlide(slide, _rows, _svg, index, total, deckDescription) {
+  const subtitle = slide.claim ?? deckDescription;
   return `<div class="slide">
   <div class="slide-cover">
     <div class="slide-cover-left">
       <div class="slide-mark">miao-vision</div>
       <h1>${escapeHtml(slide.title ?? "Presentation")}</h1>
-      ${slide.claim ? `<div class="sub">${escapeHtml(slide.claim)}</div>` : ""}
+      ${subtitle ? `<div class="sub">${escapeHtml(subtitle)}</div>` : ""}
       <div class="line"></div>
       <div class="meta">${escapeHtml(slide.eyebrow ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10))}</div>
     </div>
@@ -58266,18 +58326,6 @@ function renderEndingSlide(slide, _rows, _svg, index, total) {
 
 // src/deck-renderer.ts
 var SLIDE_CSS = `
-  :root {
-    --mv-paper:   #f5f4ed;
-    --mv-surface: #faf9f5;
-    --mv-brand:   #1b365d;
-    --mv-ink:     #141413;
-    --mv-muted:   #6b6a64;
-    --mv-soft:    #504e49;
-    --mv-border:  #e5e3d8;
-    --mv-serif:   Charter, Georgia, "Times New Roman", serif;
-    --mv-mono:    "SF Mono", "JetBrains Mono", Consolas, monospace;
-    --slide-scale: 1;
-  }
   *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
   body { font-family: var(--mv-serif); -webkit-font-smoothing: antialiased; }
 
@@ -58369,7 +58417,7 @@ var SLIDE_CSS = `
     .slide:last-child { break-after: auto; page-break-after: auto; }
     .slide-nav { display: none !important; }
   }
-  @page { size: A4 landscape; margin: 0; background: #f5f4ed; }
+  @page { size: A4 landscape; margin: 0; background: var(--mv-paper, #f5f4ed); }
 `;
 var SLIDE_JS = `
 (function() {
@@ -58421,10 +58469,14 @@ var SLIDE_JS = `
   goTo(0);
 })();
 `;
-function renderSlide(slide, rows, svgTheme, index, total) {
+function extractRootVars(css) {
+  const match = css.match(/:root\s*\{([\s\S]*?)\}/);
+  return match ? `:root {${match[1]}}` : "";
+}
+function renderSlide(slide, rows, svgTheme, index, total, deckDescription) {
   switch (slide.layout) {
     case "cover":
-      return renderCoverSlide(slide, rows, svgTheme, index, total);
+      return renderCoverSlide(slide, rows, svgTheme, index, total, deckDescription);
     case "title-only":
       return renderTitleOnlySlide(slide, rows, svgTheme, index, total);
     case "text-points":
@@ -58443,16 +58495,19 @@ function renderSlide(slide, rows, svgTheme, index, total) {
 }
 function renderDeckHtml(spec, rows, themeOverride) {
   const theme = getTheme(themeOverride ?? spec.theme ?? "editorial");
+  const themeRootVars = extractRootVars(theme.css);
   const title = spec.title ?? "Presentation";
   const total = spec.slides.length;
-  const slidesHtml = spec.slides.map((slide, i) => renderSlide(slide, rows, theme.svg, i, total)).join("\n");
+  const slidesHtml = spec.slides.map((slide, i) => renderSlide(slide, rows, theme.svg, i, total, spec.description)).join("\n");
   return `<!doctype html>
 <html lang="en">
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
+  ${spec.description ? `<meta name="description" content="${escapeHtml(spec.description)}" />` : ""}
   <title>${escapeHtml(title)}</title>
   <style>${SLIDE_CSS}</style>
+  ${themeRootVars ? `<style id="miao-deck-theme">${themeRootVars}</style>` : ""}
 </head>
 <body class="present-mode">
   <div class="slide-viewport">
@@ -58574,6 +58629,14 @@ function validateDeckSpecSemantics(spec) {
         hint: hintForIssue(path, "at most 4 metrics")
       });
     }
+    if (slide.charts && slide.charts.length > 1) {
+      const path = `slides[${index}].charts`;
+      errors.push({
+        path,
+        message: `${path}: A slide can include at most 1 chart.`,
+        hint: hintForIssue(path, "at most 1 chart")
+      });
+    }
     if (slide.layout === "table-full" && slide.charts?.[0] && slide.charts[0].type !== "table") {
       const path = `slides[${index}].charts[0].type`;
       errors.push({
@@ -58686,6 +58749,7 @@ function hintForIssue(path, message) {
   if (message.includes("requires at least one chart")) return `Add a chart under ${path}.`;
   if (message.includes("requires at least one metric")) return `Add one to four metrics under ${path}.`;
   if (message.includes("at most 4 metrics")) return `Reduce ${path} to four metrics or split them across multiple slides.`;
+  if (message.includes("at most 1 chart")) return `Reduce ${path} to a single chart or spread multiple charts across separate slides.`;
   if (message.includes("only accepts a table chart")) return `Change ${path} to 'table' or use a chart-focused layout.`;
   return `Check ${path} in the DeckSpec.`;
 }

package/dist/examples/campaign-data.csv

@@ -0,0 +1,33 @@
+week,channel,impressions,clicks,conversions,spend
+2025-W01,Social,52000,2100,85,3400
+2025-W01,Search,38000,1850,72,2900
+2025-W01,Email,15000,980,45,1200
+2025-W01,Display,28000,620,18,2100
+2025-W02,Social,58000,2400,98,3600
+2025-W02,Search,42000,2100,84,3100
+2025-W02,Email,17000,1050,50,1250
+2025-W02,Display,31000,680,22,2200
+2025-W03,Social,65000,2750,112,3800
+2025-W03,Search,46000,2300,92,3200
+2025-W03,Email,19000,1120,55,1300
+2025-W03,Display,35000,750,26,2300
+2025-W04,Social,72000,3100,128,4000
+2025-W04,Search,51000,2500,101,3400
+2025-W04,Email,21000,1200,60,1400
+2025-W04,Display,38000,820,30,2400
+2025-W05,Social,68000,2900,118,3900
+2025-W05,Search,48000,2400,95,3300
+2025-W05,Email,20000,1150,57,1350
+2025-W05,Display,36000,790,28,2350
+2025-W06,Social,76000,3300,135,4200
+2025-W06,Search,54000,2650,108,3500
+2025-W06,Email,23000,1280,65,1450
+2025-W06,Display,40000,860,33,2500
+2025-W07,Social,81000,3550,148,4400
+2025-W07,Search,58000,2800,115,3600
+2025-W07,Email,25000,1350,70,1500
+2025-W07,Display,43000,910,36,2600
+2025-W08,Social,88000,3900,162,4600
+2025-W08,Search,62000,3000,125,3800
+2025-W08,Email,27000,1420,75,1550
+2025-W08,Display,46000,960,40,2700

package/dist/examples/campaign-report-deck.yaml

@@ -0,0 +1,115 @@
+title: Campaign Performance Report
+theme: dark
+slides:
+  - layout: cover
+    eyebrow: "2025 · Q1 Campaigns"
+    title: "Campaign Performance"
+    claim: "Social and Search channels drove 74% of conversions with improving efficiency."
+
+  - layout: metrics-chart
+    eyebrow: "01 · CAMPAIGN SNAPSHOT"
+    title: "Scale Improved While Efficiency Stayed Strong"
+    metrics:
+      - label: Total Impressions
+        format: ".0s"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: impressions
+                  op: sum
+                  as: v
+      - label: Total Clicks
+        format: ".0s"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: clicks
+                  op: sum
+                  as: v
+      - label: Total Spend
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: spend
+                  op: sum
+                  as: v
+    charts:
+      - type: line
+        title: Weekly Clicks
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [week]
+              measures:
+                - field: clicks
+                  op: sum
+                  as: total
+            - type: sort
+              field: week
+              order: asc
+        encoding:
+          x: { field: week }
+          y: { field: total }
+
+  - layout: text-chart
+    eyebrow: "02 · CHANNEL EFFICIENCY"
+    title: "Social Scales While Email Converts"
+    annotation: "Social drives the most volume; Email has the best conversion rate per impression."
+    bullets:
+      - "Social: 41% of conversions, CPA trending down over the campaign."
+      - "Search: consistent volume with stable CPA."
+      - "Display: lowest CTR at 2.2%, but useful for top-of-funnel reach."
+    charts:
+      - type: scatter
+        title: Spend vs Conversions
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [channel]
+              measures:
+                - field: spend
+                  op: sum
+                  as: total_spend
+                - field: conversions
+                  op: sum
+                  as: total_conversions
+        encoding:
+          x: { field: total_spend }
+          y: { field: total_conversions }
+
+  - layout: title-only
+    title: "03 · Channel Performance"
+
+  - layout: chart-full
+    eyebrow: "04 · DISTRIBUTION"
+    title: "Impression Distribution"
+    charts:
+      - type: histogram
+        title: Impression Distribution
+        encoding:
+          x: { field: impressions }
+
+  - layout: table-full
+    eyebrow: "05 · TOP CAMPAIGNS"
+    title: "Top Campaigns by Conversions"
+    charts:
+      - type: table
+        title: Top Campaigns
+        data:
+          transform:
+            - type: sort
+              field: conversions
+              order: desc
+            - type: limit
+              value: 10
+        encoding:
+          x: { field: channel }
+          y: { field: conversions }
+
+  - layout: ending
+    title: "Scale Social, protect Search, test Email retargeting"
+    claim: "Increase Social budget 15% and test Display retargeting in Q2."

package/dist/examples/executive-overview-deck.yaml

@@ -0,0 +1,137 @@
+title: Executive Overview
+description: Revenue grew 22% QoQ driven by Alpha product adoption in East and South regions.
+theme: editorial
+slides:
+  - layout: cover
+    eyebrow: "2025 · Q1 Review"
+    title: "Executive Overview"
+    claim: "Revenue grew 22% QoQ driven by strong Enterprise product adoption."
+
+  - layout: title-only
+    title: "01 · Performance Highlights"
+
+  - layout: metrics-chart
+    eyebrow: "01 · PERFORMANCE HIGHLIGHTS"
+    title: "Revenue Growth Accelerated While Margins Held"
+    metrics:
+      - label: Total Revenue
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: revenue
+                  op: sum
+                  as: v
+      - label: Total Units
+        format: ",.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: units
+                  op: sum
+                  as: v
+      - label: Total Profit
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: profit
+                  op: sum
+                  as: v
+      - label: Avg Revenue
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: revenue
+                  op: avg
+                  as: v
+    charts:
+      - type: area
+        title: Monthly Revenue
+        data:
+          transform:
+            - type: derive-month
+              field: date
+              as: month
+            - type: aggregate
+              groupBy: [month]
+              measures:
+                - field: revenue
+                  op: sum
+                  as: total
+            - type: sort
+              field: month
+              order: asc
+        encoding:
+          x: { field: month }
+          y: { field: total }
+
+  - layout: text-points
+    eyebrow: "02 · KEY INSIGHTS"
+    title: "Revenue Drivers"
+    claim: "Three trends shaped the quarter: Enterprise expansion, regional balance, and product mix."
+    bullets:
+      - "Enterprise segment (Alpha + Gamma) contributed 68% of total revenue across all regions."
+      - "East region grew 29% QoQ, the fastest among all four regions."
+      - "Product Alpha leads with 42% revenue share, up from 40% in January."
+    callout: "Recommendation: Expand Alpha capacity in North region to capture untapped demand."
+
+  - layout: title-only
+    title: "02 · Revenue Breakdown"
+
+  - layout: text-chart
+    eyebrow: "03 · PRODUCT MIX"
+    title: "Product Revenue Is Concentrated in Alpha"
+    annotation: "Alpha is the top revenue product across every region."
+    bullets:
+      - "Alpha: 42% share, driven by Enterprise accounts."
+      - "Beta: 31% share, strongest in East and South."
+      - "Gamma: 27% share, growth opportunity in West."
+    charts:
+      - type: pie
+        title: Revenue by Product
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [product]
+              measures:
+                - field: revenue
+                  op: sum
+                  as: total
+            - type: sort
+              field: total
+              order: desc
+        encoding:
+          label: { field: product }
+          value: { field: total }
+
+  - layout: chart-full
+    eyebrow: "04 · REGIONAL"
+    title: "Revenue by Region"
+    charts:
+      - type: bar
+        title: Revenue by Region
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [region]
+              measures:
+                - field: revenue
+                  op: sum
+                  as: total
+            - type: sort
+              field: total
+              order: desc
+        encoding:
+          x: { field: region }
+          y: { field: total }
+          color: { field: region }
+
+  - layout: ending
+    title: "Focus on North region growth"
+    claim: "Enterprise product expansion in North is the highest-ROI opportunity for Q2."

package/dist/examples/executive-overview.csv

@@ -0,0 +1,37 @@
+date,region,product,segment,revenue,units,cost,profit
+2025-01-01,East,Alpha,Enterprise,45000,120,28000,17000
+2025-01-01,East,Beta,SMB,32000,85,21000,11000
+2025-01-01,East,Gamma,Enterprise,28000,70,19000,9000
+2025-01-01,West,Alpha,Enterprise,38000,100,25000,13000
+2025-01-01,West,Beta,SMB,29000,78,20000,9000
+2025-01-01,West,Gamma,Enterprise,22000,55,16000,6000
+2025-01-01,North,Alpha,Enterprise,31000,82,21000,10000
+2025-01-01,North,Beta,SMB,24000,65,17000,7000
+2025-01-01,North,Gamma,Enterprise,18000,48,13000,5000
+2025-01-01,South,Alpha,Enterprise,35000,92,23000,12000
+2025-01-01,South,Beta,SMB,26000,70,18000,8000
+2025-01-01,South,Gamma,Enterprise,20000,52,14000,6000
+2025-02-01,East,Alpha,Enterprise,51000,135,31000,20000
+2025-02-01,East,Beta,SMB,36000,95,23000,13000
+2025-02-01,East,Gamma,Enterprise,32000,80,21000,11000
+2025-02-01,West,Alpha,Enterprise,42000,110,27000,15000
+2025-02-01,West,Beta,SMB,32000,86,22000,10000
+2025-02-01,West,Gamma,Enterprise,25000,62,18000,7000
+2025-02-01,North,Alpha,Enterprise,35000,92,23000,12000
+2025-02-01,North,Beta,SMB,27000,72,19000,8000
+2025-02-01,North,Gamma,Enterprise,21000,55,15000,6000
+2025-02-01,South,Alpha,Enterprise,39000,102,25000,14000
+2025-02-01,South,Beta,SMB,29000,78,20000,9000
+2025-02-01,South,Gamma,Enterprise,23000,60,16000,7000
+2025-03-01,East,Alpha,Enterprise,58000,150,34000,24000
+2025-03-01,East,Beta,SMB,40000,105,25000,15000
+2025-03-01,East,Gamma,Enterprise,36000,90,23000,13000
+2025-03-01,West,Alpha,Enterprise,48000,125,30000,18000
+2025-03-01,West,Beta,SMB,36000,95,24000,12000
+2025-03-01,West,Gamma,Enterprise,29000,72,20000,9000
+2025-03-01,North,Alpha,Enterprise,40000,105,26000,14000
+2025-03-01,North,Beta,SMB,31000,82,21000,10000
+2025-03-01,North,Gamma,Enterprise,24000,62,17000,7000
+2025-03-01,South,Alpha,Enterprise,44000,115,28000,16000
+2025-03-01,South,Beta,SMB,33000,88,22000,11000
+2025-03-01,South,Gamma,Enterprise,26000,68,18000,8000

package/examples/campaign-data.csv

@@ -0,0 +1,33 @@
+week,channel,impressions,clicks,conversions,spend
+2025-W01,Social,52000,2100,85,3400
+2025-W01,Search,38000,1850,72,2900
+2025-W01,Email,15000,980,45,1200
+2025-W01,Display,28000,620,18,2100
+2025-W02,Social,58000,2400,98,3600
+2025-W02,Search,42000,2100,84,3100
+2025-W02,Email,17000,1050,50,1250
+2025-W02,Display,31000,680,22,2200
+2025-W03,Social,65000,2750,112,3800
+2025-W03,Search,46000,2300,92,3200
+2025-W03,Email,19000,1120,55,1300
+2025-W03,Display,35000,750,26,2300
+2025-W04,Social,72000,3100,128,4000
+2025-W04,Search,51000,2500,101,3400
+2025-W04,Email,21000,1200,60,1400
+2025-W04,Display,38000,820,30,2400
+2025-W05,Social,68000,2900,118,3900
+2025-W05,Search,48000,2400,95,3300
+2025-W05,Email,20000,1150,57,1350
+2025-W05,Display,36000,790,28,2350
+2025-W06,Social,76000,3300,135,4200
+2025-W06,Search,54000,2650,108,3500
+2025-W06,Email,23000,1280,65,1450
+2025-W06,Display,40000,860,33,2500
+2025-W07,Social,81000,3550,148,4400
+2025-W07,Search,58000,2800,115,3600
+2025-W07,Email,25000,1350,70,1500
+2025-W07,Display,43000,910,36,2600
+2025-W08,Social,88000,3900,162,4600
+2025-W08,Search,62000,3000,125,3800
+2025-W08,Email,27000,1420,75,1550
+2025-W08,Display,46000,960,40,2700

package/examples/campaign-report-deck.yaml

@@ -0,0 +1,115 @@
+title: Campaign Performance Report
+theme: dark
+slides:
+  - layout: cover
+    eyebrow: "2025 · Q1 Campaigns"
+    title: "Campaign Performance"
+    claim: "Social and Search channels drove 74% of conversions with improving efficiency."
+
+  - layout: metrics-chart
+    eyebrow: "01 · CAMPAIGN SNAPSHOT"
+    title: "Scale Improved While Efficiency Stayed Strong"
+    metrics:
+      - label: Total Impressions
+        format: ".0s"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: impressions
+                  op: sum
+                  as: v
+      - label: Total Clicks
+        format: ".0s"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: clicks
+                  op: sum
+                  as: v
+      - label: Total Spend
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: spend
+                  op: sum
+                  as: v
+    charts:
+      - type: line
+        title: Weekly Clicks
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [week]
+              measures:
+                - field: clicks
+                  op: sum
+                  as: total
+            - type: sort
+              field: week
+              order: asc
+        encoding:
+          x: { field: week }
+          y: { field: total }
+
+  - layout: text-chart
+    eyebrow: "02 · CHANNEL EFFICIENCY"
+    title: "Social Scales While Email Converts"
+    annotation: "Social drives the most volume; Email has the best conversion rate per impression."
+    bullets:
+      - "Social: 41% of conversions, CPA trending down over the campaign."
+      - "Search: consistent volume with stable CPA."
+      - "Display: lowest CTR at 2.2%, but useful for top-of-funnel reach."
+    charts:
+      - type: scatter
+        title: Spend vs Conversions
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [channel]
+              measures:
+                - field: spend
+                  op: sum
+                  as: total_spend
+                - field: conversions
+                  op: sum
+                  as: total_conversions
+        encoding:
+          x: { field: total_spend }
+          y: { field: total_conversions }
+
+  - layout: title-only
+    title: "03 · Channel Performance"
+
+  - layout: chart-full
+    eyebrow: "04 · DISTRIBUTION"
+    title: "Impression Distribution"
+    charts:
+      - type: histogram
+        title: Impression Distribution
+        encoding:
+          x: { field: impressions }
+
+  - layout: table-full
+    eyebrow: "05 · TOP CAMPAIGNS"
+    title: "Top Campaigns by Conversions"
+    charts:
+      - type: table
+        title: Top Campaigns
+        data:
+          transform:
+            - type: sort
+              field: conversions
+              order: desc
+            - type: limit
+              value: 10
+        encoding:
+          x: { field: channel }
+          y: { field: conversions }
+
+  - layout: ending
+    title: "Scale Social, protect Search, test Email retargeting"
+    claim: "Increase Social budget 15% and test Display retargeting in Q2."

package/examples/executive-overview-deck.yaml

@@ -0,0 +1,137 @@
+title: Executive Overview
+description: Revenue grew 22% QoQ driven by Alpha product adoption in East and South regions.
+theme: editorial
+slides:
+  - layout: cover
+    eyebrow: "2025 · Q1 Review"
+    title: "Executive Overview"
+    claim: "Revenue grew 22% QoQ driven by strong Enterprise product adoption."
+
+  - layout: title-only
+    title: "01 · Performance Highlights"
+
+  - layout: metrics-chart
+    eyebrow: "01 · PERFORMANCE HIGHLIGHTS"
+    title: "Revenue Growth Accelerated While Margins Held"
+    metrics:
+      - label: Total Revenue
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: revenue
+                  op: sum
+                  as: v
+      - label: Total Units
+        format: ",.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: units
+                  op: sum
+                  as: v
+      - label: Total Profit
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: profit
+                  op: sum
+                  as: v
+      - label: Avg Revenue
+        format: "$,.0f"
+        data:
+          transform:
+            - type: aggregate
+              measures:
+                - field: revenue
+                  op: avg
+                  as: v
+    charts:
+      - type: area
+        title: Monthly Revenue
+        data:
+          transform:
+            - type: derive-month
+              field: date
+              as: month
+            - type: aggregate
+              groupBy: [month]
+              measures:
+                - field: revenue
+                  op: sum
+                  as: total
+            - type: sort
+              field: month
+              order: asc
+        encoding:
+          x: { field: month }
+          y: { field: total }
+
+  - layout: text-points
+    eyebrow: "02 · KEY INSIGHTS"
+    title: "Revenue Drivers"
+    claim: "Three trends shaped the quarter: Enterprise expansion, regional balance, and product mix."
+    bullets:
+      - "Enterprise segment (Alpha + Gamma) contributed 68% of total revenue across all regions."
+      - "East region grew 29% QoQ, the fastest among all four regions."
+      - "Product Alpha leads with 42% revenue share, up from 40% in January."
+    callout: "Recommendation: Expand Alpha capacity in North region to capture untapped demand."
+
+  - layout: title-only
+    title: "02 · Revenue Breakdown"
+
+  - layout: text-chart
+    eyebrow: "03 · PRODUCT MIX"
+    title: "Product Revenue Is Concentrated in Alpha"
+    annotation: "Alpha is the top revenue product across every region."
+    bullets:
+      - "Alpha: 42% share, driven by Enterprise accounts."
+      - "Beta: 31% share, strongest in East and South."
+      - "Gamma: 27% share, growth opportunity in West."
+    charts:
+      - type: pie
+        title: Revenue by Product
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [product]
+              measures:
+                - field: revenue
+                  op: sum
+                  as: total
+            - type: sort
+              field: total
+              order: desc
+        encoding:
+          label: { field: product }
+          value: { field: total }
+
+  - layout: chart-full
+    eyebrow: "04 · REGIONAL"
+    title: "Revenue by Region"
+    charts:
+      - type: bar
+        title: Revenue by Region
+        data:
+          transform:
+            - type: aggregate
+              groupBy: [region]
+              measures:
+                - field: revenue
+                  op: sum
+                  as: total
+            - type: sort
+              field: total
+              order: desc
+        encoding:
+          x: { field: region }
+          y: { field: total }
+          color: { field: region }
+
+  - layout: ending
+    title: "Focus on North region growth"
+    claim: "Enterprise product expansion in North is the highest-ROI opportunity for Q2."

package/examples/executive-overview.csv

@@ -0,0 +1,37 @@
+date,region,product,segment,revenue,units,cost,profit
+2025-01-01,East,Alpha,Enterprise,45000,120,28000,17000
+2025-01-01,East,Beta,SMB,32000,85,21000,11000
+2025-01-01,East,Gamma,Enterprise,28000,70,19000,9000
+2025-01-01,West,Alpha,Enterprise,38000,100,25000,13000
+2025-01-01,West,Beta,SMB,29000,78,20000,9000
+2025-01-01,West,Gamma,Enterprise,22000,55,16000,6000
+2025-01-01,North,Alpha,Enterprise,31000,82,21000,10000
+2025-01-01,North,Beta,SMB,24000,65,17000,7000
+2025-01-01,North,Gamma,Enterprise,18000,48,13000,5000
+2025-01-01,South,Alpha,Enterprise,35000,92,23000,12000
+2025-01-01,South,Beta,SMB,26000,70,18000,8000
+2025-01-01,South,Gamma,Enterprise,20000,52,14000,6000
+2025-02-01,East,Alpha,Enterprise,51000,135,31000,20000
+2025-02-01,East,Beta,SMB,36000,95,23000,13000
+2025-02-01,East,Gamma,Enterprise,32000,80,21000,11000
+2025-02-01,West,Alpha,Enterprise,42000,110,27000,15000
+2025-02-01,West,Beta,SMB,32000,86,22000,10000
+2025-02-01,West,Gamma,Enterprise,25000,62,18000,7000
+2025-02-01,North,Alpha,Enterprise,35000,92,23000,12000
+2025-02-01,North,Beta,SMB,27000,72,19000,8000
+2025-02-01,North,Gamma,Enterprise,21000,55,15000,6000
+2025-02-01,South,Alpha,Enterprise,39000,102,25000,14000
+2025-02-01,South,Beta,SMB,29000,78,20000,9000
+2025-02-01,South,Gamma,Enterprise,23000,60,16000,7000
+2025-03-01,East,Alpha,Enterprise,58000,150,34000,24000
+2025-03-01,East,Beta,SMB,40000,105,25000,15000
+2025-03-01,East,Gamma,Enterprise,36000,90,23000,13000
+2025-03-01,West,Alpha,Enterprise,48000,125,30000,18000
+2025-03-01,West,Beta,SMB,36000,95,24000,12000
+2025-03-01,West,Gamma,Enterprise,29000,72,20000,9000
+2025-03-01,North,Alpha,Enterprise,40000,105,26000,14000
+2025-03-01,North,Beta,SMB,31000,82,21000,10000
+2025-03-01,North,Gamma,Enterprise,24000,62,17000,7000
+2025-03-01,South,Alpha,Enterprise,44000,115,28000,16000
+2025-03-01,South,Beta,SMB,33000,88,22000,11000
+2025-03-01,South,Gamma,Enterprise,26000,68,18000,8000

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miao-vision/cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Miao Vision local data visualization CLI for agent workflows",
   "license": "MIT",
   "type": "module",

package/dist/examples/sales-dashboard.yaml

@@ -1,54 +0,0 @@
-title: Sales Dashboard
-description: Example Miao Vision report generated from sales.csv.
-charts:
-  - type: bigvalue
-    title: Total Sales
-    data:
-      transform:
-        - type: aggregate
-          measures:
-            - field: sales
-              op: sum
-              as: total_sales
-    encoding:
-      value:
-        field: total_sales
-  - type: line
-    title: Monthly Sales Trend
-    data:
-      transform:
-        - type: derive-month
-          field: order_date
-          as: order_month
-        - type: aggregate
-          groupBy: [order_month]
-          measures:
-            - field: sales
-              op: sum
-              as: total_sales
-        - type: sort
-          field: order_month
-          order: asc
-    encoding:
-      x:
-        field: order_month
-      y:
-        field: total_sales
-  - type: bar
-    title: Sales by Region
-    data:
-      transform:
-        - type: aggregate
-          groupBy: [region]
-          measures:
-            - field: sales
-              op: sum
-              as: total_sales
-        - type: sort
-          field: total_sales
-          order: desc
-    encoding:
-      x:
-        field: region
-      y:
-        field: total_sales

package/examples/sales-dashboard.yaml

@@ -1,54 +0,0 @@
-title: Sales Dashboard
-description: Example Miao Vision report generated from sales.csv.
-charts:
-  - type: bigvalue
-    title: Total Sales
-    data:
-      transform:
-        - type: aggregate
-          measures:
-            - field: sales
-              op: sum
-              as: total_sales
-    encoding:
-      value:
-        field: total_sales
-  - type: line
-    title: Monthly Sales Trend
-    data:
-      transform:
-        - type: derive-month
-          field: order_date
-          as: order_month
-        - type: aggregate
-          groupBy: [order_month]
-          measures:
-            - field: sales
-              op: sum
-              as: total_sales
-        - type: sort
-          field: order_month
-          order: asc
-    encoding:
-      x:
-        field: order_month
-      y:
-        field: total_sales
-  - type: bar
-    title: Sales by Region
-    data:
-      transform:
-        - type: aggregate
-          groupBy: [region]
-          measures:
-            - field: sales
-              op: sum
-              as: total_sales
-        - type: sort
-          field: total_sales
-          order: desc
-    encoding:
-      x:
-        field: region
-      y:
-        field: total_sales