ghost-paper 0.3.1 → 0.3.3

package/dist/{-7SCHCOLC.js → -EDFCYK7D.js}

@@ -2,7 +2,7 @@ import {
   build,
   buildPdf,
   buildPrintHtml
-} from "./chunk-QUOENJTZ.js";
+} from "./chunk-BYWWJNGV.js";
 export {
   build,
   buildPdf,

package/dist/{chunk-QUOENJTZ.js → chunk-BYWWJNGV.js}

@@ -42,10 +42,11 @@ function columnIsNumeric(rows, colIndex) {
   const numericCount = values.filter(isNumericValue).length;
   return numericCount / values.length >= 0.7;
 }
+var SUMMARY_TERM = /^(total|full\s*year|average|median|overall|summary|net|grand)\b/i;
 function columnIsTime(rows, colIndex) {
   const values = rows.map((r) => r[colIndex]).filter(Boolean);
   if (values.length === 0) return false;
-  const timeCount = values.filter(isTimeValue).length;
+  const timeCount = values.filter((v) => !SUMMARY_TERM.test(v.trim()) && isTimeValue(v)).length;
   return timeCount / values.length >= 0.6;
 }
 function countNumericColumns(table) {
@@ -68,11 +69,8 @@ function classifyTable(table) {
       else textCols.push(i);
     }
     if (textCols.length >= 1 && numericCols.length >= 1) {
-      const headerStr = headers.join(" ").toLowerCase();
-      const hasMetricHeader = /metric|name|label|kpi|measure|indicator/i.test(headerStr);
-      const hasValueHeader = /value|amount|number|result|total|figure/i.test(headerStr);
-      const hasChangeHeader = /change|delta|trend|vs|growth|yoy|qoq|mom|diff/i.test(headerStr);
-      if (hasMetricHeader || hasValueHeader && colCount <= 3 || hasChangeHeader && hasValueHeader) {
+      const firstHeaderIsMetric = /metric|name|label|kpi|measure|indicator/i.test(headers[0]);
+      if (firstHeaderIsMetric) {
         return "kpi";
       }
     }
@@ -88,7 +86,7 @@ function classifyTable(table) {
       }
     }
     const sparseRatio = emptyCells / totalDataCells;
-    if (numericAfterFirst >= 1 && sparseRatio < 0.25) return "line";
+    if (numericAfterFirst >= 1 && sparseRatio < 0.25 && rowCount > 3 && numericAfterFirst <= rowCount) return "line";
   }
   if (colCount >= 2 && rowCount >= 3) {
     const firstIsText = !columnIsNumeric(rows, 0) && !columnIsTime(rows, 0);
@@ -266,12 +264,23 @@ function parse(markdown) {
           }
         }
       }
+      let hintType = null;
+      let hintWide = false;
+      const prevNode = i > 0 ? nodes[i - 1] : null;
+      if (prevNode && prevNode.type === "html") {
+        const hintMatch = prevNode.value?.match(/<!--\s*paper:\s*(table|line|bar|pie|kpi)(\s+wide)?\s*-->/i);
+        if (hintMatch) {
+          hintType = hintMatch[1].toLowerCase();
+          hintWide = !!hintMatch[2];
+        }
+      }
       const tableData = extractTable(node);
-      const chartType = classifyTable(tableData);
+      const chartType = hintType ?? classifyTable(tableData);
+      const wide = hintWide || void 0;
       if (chartType === "kpi") {
         currentTab.elements.push({ kind: "kpi", table: tableData });
       } else if (chartType === "table") {
-        currentTab.elements.push({ kind: "table", table: tableData });
+        currentTab.elements.push({ kind: "table", table: tableData, wide });
       } else {
         const chartId = `chart-${chartCounter++}`;
         currentTab.elements.push({
@@ -279,7 +288,8 @@ function parse(markdown) {
           chartType,
           table: tableData,
           chartId,
-          caption
+          caption,
+          wide
         });
       }
       continue;
@@ -1138,31 +1148,26 @@ var PRINT_CSS = `
   .sidebar, .mobile-header, .mobile-dropdown, .mobile-overlay { display: none !important; }
   .main { margin-left: 0; min-height: auto; }
 
-  /* \u2500\u2500 Cover page \u2014 full bleed dark background \u2500\u2500 */
+  /* \u2500\u2500 Cover page \u2014 full bleed dark background, content at bottom \u2500\u2500 */
   .print-header {
     min-height: 100vh;
     display: flex;
     flex-direction: column;
-    justify-content: flex-start;
+    justify-content: flex-end;
     background: var(--charcoal);
     margin: -0.7in -0.65in 0;
-    padding: calc(0.7in + 48px) calc(0.65in + 48px) 56px;
+    padding: 56px calc(0.65in + 48px) calc(0.7in + 56px);
     page-break-after: always;
     break-after: page;
   }
   .print-title {
-    font-size: 96px;
+    font-size: 72px;
     font-weight: 700;
-    letter-spacing: -4px;
+    letter-spacing: -3px;
     color: #fff;
-    padding-bottom: 28px;
+    padding-bottom: 24px;
     border-bottom: 5px solid var(--accent);
-    line-height: 0.95;
-    word-spacing: 100vw;
-  }
-  .print-title .title-minor {
-    color: rgba(255,255,255,0.4);
-    font-weight: 400;
+    line-height: 1.05;
   }
   .print-subtitle {
     font-size: 15px;
@@ -1235,19 +1240,32 @@ var PRINT_CSS = `
   }
 
   /* Tables: in-column with light grey box */
-  .tab-content table {
-    font-size: 10px;
+  .table-wrap {
+    overflow: hidden;
     margin: 12px 0;
     break-inside: avoid;
-    width: 100%;
     background: #F6F6F4;
+    border-radius: 4px;
+  }
+  .table-wrap.table-wide { column-span: all; }
+  .table-wrap.table-wide table { font-size: 12px; }
+  .table-wrap.table-wide thead th { font-size: 9px; }
+  .table-wrap.table-wide tbody td { padding: 8px 12px; }
+  .chart-wide { column-span: all; }
+  .tab-content table {
+    font-size: 10px;
+    margin: 0;
+    width: 100%;
+    table-layout: fixed;
     border-collapse: separate;
     border-spacing: 0;
-    padding: 16px;
-    border-radius: 4px;
+    padding: 0;
+    background: transparent;
+    border-radius: 0;
   }
-  .tab-content thead th { font-size: 8px; letter-spacing: 0.8px; padding: 5px 8px 5px 0; border-bottom: 2px solid #D0D0CB; }
-  .tab-content tbody td { padding: 6px 8px 6px 0; font-weight: 400; border-bottom: 1px solid #E8E8E4; }
+  .tab-content tbody td { word-wrap: break-word; overflow-wrap: break-word; }
+  .tab-content thead th { font-size: 8px; letter-spacing: 0.8px; padding: 8px 10px; border-bottom: 2px solid #D0D0CB; }
+  .tab-content tbody td { padding: 8px 10px; font-weight: 400; border-bottom: 1px solid #E8E8E4; }
   .tab-content tbody tr:last-child td { border-bottom: none; }
 
   /* KPIs: compact grid for column width */
@@ -1270,10 +1288,9 @@ var PRINT_CSS = `
     overflow: hidden;
   }
   figcaption { font-size: 10px; margin-top: 4px; }
-  .chart-container { height: 190px; overflow: hidden; }
+  .chart-container { height: 200px; overflow: hidden; }
 
   .kpi-strip { break-inside: avoid; page-break-inside: avoid; }
-  table { break-inside: auto; }
   thead { display: table-header-group; }
   tr { break-inside: avoid; }
 
@@ -1345,7 +1362,7 @@ function renderKpi(table) {
 ${kpis}
     </div>`;
 }
-function renderTable(table) {
+function renderTable(table, wide) {
   const thead = table.headers.map((h) => `<th>${escapeHtml3(h)}</th>`).join("");
   const tbody = table.rows.map((row) => {
     const cells = row.map((cell) => {
@@ -1353,23 +1370,33 @@ function renderTable(table) {
     }).join("");
     return `<tr>${cells}</tr>`;
   }).join("\n        ");
-  return `    <table>
+  const wideClass = wide || table.headers.length >= 5 ? " table-wide" : "";
+  return `    <div class="table-wrap${wideClass}"><table>
       <thead><tr>${thead}</tr></thead>
       <tbody>
         ${tbody}
       </tbody>
-    </table>`;
+    </table></div>`;
 }
-function renderChart(chartId, caption, chartType, rowCount) {
+function renderChart(chartId, caption, chartType, rowCount, seriesCount, wide) {
   let styleAttr = "";
   if (chartType === "bar" && rowCount) {
     const height = Math.max(120, rowCount * 44 + 40);
     styleAttr = ` style="height:${height}px"`;
+  } else if (seriesCount && seriesCount > 0) {
+    const height = Math.min(300, 200 + Math.max(0, seriesCount - 1) * 25);
+    styleAttr = ` style="height:${height}px"`;
   }
-  return `    <figure>
+  const figureHtml = `    <figure>
       <div class="chart-container" id="${chartId}"${styleAttr}></div>
       ${caption ? `<figcaption>${escapeHtml3(caption)}</figcaption>` : ""}
     </figure>`;
+  if (wide) {
+    return `    <div class="chart-wide">
+${figureHtml}
+    </div>`;
+  }
+  return figureHtml;
 }
 function renderElement(el) {
   switch (el.kind) {
@@ -1380,9 +1407,9 @@ function renderElement(el) {
     case "kpi":
       return renderKpi(el.table);
     case "chart":
-      return renderChart(el.chartId, el.caption, el.chartType, el.table.rows.length);
+      return renderChart(el.chartId, el.caption, el.chartType, el.table.rows.length, el.table.headers.length - 1, el.wide);
     case "table":
-      return renderTable(el.table);
+      return renderTable(el.table, el.wide);
     case "aside":
       return `    <aside>${el.html}</aside>`;
     case "pagebreak":
@@ -1469,32 +1496,11 @@ function buildChartScript(doc, printMode = false) {
   if (printMode) return script + "\nwindow.__ghostPaperChartsReady = true;";
   return script;
 }
-function stylizePrintTitle(raw) {
-  const MINOR = /* @__PURE__ */ new Set(["the", "a", "an", "for", "of", "in", "and", "or", "to", "with", "by", "on", "at", "is"]);
-  const words = escapeHtml3(raw).split(/\s+/);
-  const result = [];
-  let i = 0;
-  while (i < words.length) {
-    const lower = words[i].toLowerCase();
-    if (i + 1 < words.length && MINOR.has(lower) && MINOR.has(words[i + 1].toLowerCase())) {
-      result.push(`<span class="title-minor" style="white-space:nowrap;word-spacing:normal">${words[i]} ${words[i + 1]}</span>`);
-      i += 2;
-    } else if (MINOR.has(lower)) {
-      result.push(`<span class="title-minor">${words[i]}</span>`);
-      i++;
-    } else {
-      result.push(words[i]);
-      i++;
-    }
-  }
-  return result.join(" ");
-}
 function buildPrintContent(doc) {
   const subtitle = doc.frontmatter.subtitle ? `
     <div class="print-subtitle">${escapeHtml3(doc.frontmatter.subtitle)}</div>` : "";
-  const styledTitle = stylizePrintTitle(doc.frontmatter.title);
   const header = `  <div class="print-header">
-    <div class="print-title">${styledTitle}</div>${subtitle}
+    <div class="print-title">${escapeHtml3(doc.frontmatter.title)}</div>${subtitle}
   </div>`;
   const tabs = doc.tabs.map((tab, i) => {
     const elements = tab.elements.map(renderElement).join("\n\n");
@@ -1539,7 +1545,7 @@ function buildPrintHtml(markdown) {
 async function buildPdf(markdown, outputPath, options) {
   const doc = parse(markdown);
   const html = render(doc, { printMode: true });
-  const { generatePdf } = await import("./pdf-PXNSBFN6.js");
+  const { generatePdf } = await import("./pdf-CVTVSJBX.js");
   await generatePdf({
     html,
     outputPath,

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   build
-} from "./chunk-QUOENJTZ.js";
+} from "./chunk-BYWWJNGV.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -25,24 +25,28 @@ program.command("prompt").description("Print agent instructions for writing Ghos
 - Use # H1 headings to separate major sections (each becomes a tab in the sidebar)
 - Put a blockquote immediately after an H1 to set that tab's subtitle
 - Use ## H2 headings for sections within a tab
+- Use --- (horizontal rule) to force a page break in PDF output
 - Use blockquotes for key insight callouts
 
 ## Tables \u2192 Charts
 
 Write standard markdown tables. Ghost Paper auto-classifies them:
 
-**KPI strip** \u2014 2\u20136 rows, 2\u20134 columns with headers like Metric/Value/Change:
+**KPI strip** \u2014 2\u20136 rows, 2\u20134 columns where the first column header matches a metric/label pattern (e.g. Metric, Name, Label, KPI, Indicator):
 | Metric | Value | Change |
 |--------|-------|--------|
 | Revenue | $4.2M | +23% YoY |
 | Users | 214K | +18% vs Q3 |
 
-**Line chart** \u2014 first column is time (months, quarters, years), other columns numeric:
-| Month | Revenue ($K) | Users (K) |
-|-------|-------------|-----------|
-| Jan | 280 | 142 |
-| Feb | 295 | 148 |
-| Mar | 310 | 155 |
+**Line chart** \u2014 first column is time-based (months, quarters, years, FY), 4+ data rows, numeric series count \u2264 row count, and no sparse data:
+| Quarter | Revenue ($M) | Users (K) |
+|---------|-------------|-----------|
+| Q1 FY25 | 3.2 | 142 |
+| Q2 FY25 | 3.5 | 148 |
+| Q3 FY25 | 3.8 | 155 |
+| Q4 FY25 | 4.2 | 163 |
+
+Note: summary rows like "Total" or "Full Year" in the first column are ignored when detecting time-based columns.
 
 **Bar chart** \u2014 first column is categories, one numeric column, 3+ rows:
 | Channel | CPA ($) |
@@ -57,7 +61,21 @@ Write standard markdown tables. Ghost Paper auto-classifies them:
 | Enterprise | 60 |
 | SMB | 40 |
 
-Any table that doesn't match these patterns renders as a styled HTML table.`);
+Any table that doesn't match these patterns renders as a styled HTML table.
+
+## Manual Override Hints
+
+Place an HTML comment immediately before a table to force a specific rendering:
+
+<!-- paper: table -->      \u2014 force table (skip chart classification)
+<!-- paper: bar -->        \u2014 force bar chart
+<!-- paper: line -->       \u2014 force line chart
+<!-- paper: pie -->        \u2014 force pie chart
+<!-- paper: kpi -->        \u2014 force KPI strip
+<!-- paper: bar wide -->   \u2014 force bar chart, full-width in PDF (spans both columns)
+<!-- paper: table wide --> \u2014 force table, full-width in PDF
+
+The "wide" flag makes the element span both columns in the two-column PDF layout.`);
 });
 var buildCmd = program.command("build").description("Convert a markdown file to HTML or PDF");
 buildCmd.command("html").description("Convert a markdown file to an HTML report").argument("<input>", "Markdown file path").option("-o, --output <path>", "Output HTML file path").action((input, opts) => {
@@ -72,7 +90,7 @@ buildCmd.command("pdf").description("Convert a markdown file to a PDF report").a
   const inputPath = resolve(input);
   const markdown = readFileSync(inputPath, "utf-8");
   const outputPath = opts.output ? resolve(opts.output) : inputPath.replace(/\.md$/, ".pdf");
-  const { buildPdf } = await import("./-7SCHCOLC.js");
+  const { buildPdf } = await import("./-EDFCYK7D.js");
   await buildPdf(markdown, outputPath, {
     pageSize: opts.pageSize ?? "A4",
     landscape: opts.landscape ?? false

package/dist/{pdf-PXNSBFN6.js → pdf-CVTVSJBX.js}

@@ -52,8 +52,9 @@ async function generatePdf(opts) {
     });
     await new Promise((r) => setTimeout(r, 300));
     const title = escapeHtml(opts.title ?? "");
-    const headerTemplate = `<div style="font-size: 8px; font-family: -apple-system, system-ui, sans-serif; color: #999; width: 100%; padding: 0 0.65in; letter-spacing: 0.5px; text-transform: uppercase;">${title}</div>`;
-    const footerTemplate = `<div style="font-size: 8px; font-family: -apple-system, system-ui, sans-serif; color: #999; width: 100%; text-align: right; padding: 0 0.65in;"><span class="pageNumber"></span> / <span class="totalPages"></span></div>`;
+    const hideOnPage1 = `<script>if(document.querySelector('.pageNumber').textContent==='1')document.querySelector('#c').style.display='none';</script>`;
+    const headerTemplate = `<div style="font-size: 8px; font-family: -apple-system, system-ui, sans-serif; color: #999; width: 100%; padding: 0 0.65in; letter-spacing: 0.5px; text-transform: uppercase;"><span id="c">${title}</span>${hideOnPage1}</div>`;
+    const footerTemplate = `<div style="font-size: 8px; font-family: -apple-system, system-ui, sans-serif; color: #999; width: 100%; text-align: right; padding: 0 0.65in;"><span id="c"><span class="pageNumber"></span> / <span class="totalPages"></span></span>${hideOnPage1}</div>`;
     const pdfBuffer = await page.pdf({
       format: opts.pageSize ?? "A4",
       landscape: opts.landscape ?? false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghost-paper",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Turn markdown into beautiful HTML reports",
   "type": "module",
   "license": "UNLICENSED",