@grainulation/mill 1.0.0 → 1.0.1

package/lib/exporters/markdown.js

@@ -1,7 +1,7 @@
-'use strict';
+"use strict";
 
-const fs = require('node:fs');
-const path = require('node:path');
+const fs = require("node:fs");
+const path = require("node:path");
 
 /**
  * Convert HTML artifacts to clean Markdown.
@@ -13,80 +13,113 @@ function htmlToMarkdown(html) {
   let md = html;
 
   // Remove doctype, head, scripts, styles
-  md = md.replace(/<!DOCTYPE[^>]*>/gi, '');
-  md = md.replace(/<head[\s\S]*?<\/head>/gi, '');
-  md = md.replace(/<script[\s\S]*?<\/script>/gi, '');
-  md = md.replace(/<style[\s\S]*?<\/style>/gi, '');
+  md = md.replace(/<!DOCTYPE[^>]*>/gi, "");
+  md = md.replace(/<head[\s\S]*?<\/head>/gi, "");
+  md = md.replace(/<script[\s\S]*?<\/script>/gi, "");
+  md = md.replace(/<style[\s\S]*?<\/style>/gi, "");
 
   // Headings
   md = md.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, (_, c) => `# ${strip(c)}\n\n`);
-  md = md.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, (_, c) => `## ${strip(c)}\n\n`);
-  md = md.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, (_, c) => `### ${strip(c)}\n\n`);
-  md = md.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, (_, c) => `#### ${strip(c)}\n\n`);
-  md = md.replace(/<h5[^>]*>([\s\S]*?)<\/h5>/gi, (_, c) => `##### ${strip(c)}\n\n`);
-  md = md.replace(/<h6[^>]*>([\s\S]*?)<\/h6>/gi, (_, c) => `###### ${strip(c)}\n\n`);
+  md = md.replace(
+    /<h2[^>]*>([\s\S]*?)<\/h2>/gi,
+    (_, c) => `## ${strip(c)}\n\n`,
+  );
+  md = md.replace(
+    /<h3[^>]*>([\s\S]*?)<\/h3>/gi,
+    (_, c) => `### ${strip(c)}\n\n`,
+  );
+  md = md.replace(
+    /<h4[^>]*>([\s\S]*?)<\/h4>/gi,
+    (_, c) => `#### ${strip(c)}\n\n`,
+  );
+  md = md.replace(
+    /<h5[^>]*>([\s\S]*?)<\/h5>/gi,
+    (_, c) => `##### ${strip(c)}\n\n`,
+  );
+  md = md.replace(
+    /<h6[^>]*>([\s\S]*?)<\/h6>/gi,
+    (_, c) => `###### ${strip(c)}\n\n`,
+  );
 
   // Bold, italic, code
-  md = md.replace(/<strong[^>]*>([\s\S]*?)<\/strong>/gi, '**$1**');
-  md = md.replace(/<b[^>]*>([\s\S]*?)<\/b>/gi, '**$1**');
-  md = md.replace(/<em[^>]*>([\s\S]*?)<\/em>/gi, '*$1*');
-  md = md.replace(/<i[^>]*>([\s\S]*?)<\/i>/gi, '*$1*');
-  md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, '`$1`');
+  md = md.replace(/<strong[^>]*>([\s\S]*?)<\/strong>/gi, "**$1**");
+  md = md.replace(/<b[^>]*>([\s\S]*?)<\/b>/gi, "**$1**");
+  md = md.replace(/<em[^>]*>([\s\S]*?)<\/em>/gi, "*$1*");
+  md = md.replace(/<i[^>]*>([\s\S]*?)<\/i>/gi, "*$1*");
+  md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, "`$1`");
 
   // Pre/code blocks
-  md = md.replace(/<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/gi, (_, c) => {
-    return '\n```\n' + decodeEntities(c) + '\n```\n\n';
-  });
+  md = md.replace(
+    /<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/gi,
+    (_, c) => {
+      return "\n```\n" + decodeEntities(c) + "\n```\n\n";
+    },
+  );
   md = md.replace(/<pre[^>]*>([\s\S]*?)<\/pre>/gi, (_, c) => {
-    return '\n```\n' + decodeEntities(c) + '\n```\n\n';
+    return "\n```\n" + decodeEntities(c) + "\n```\n\n";
   });
 
   // Links
-  md = md.replace(/<a[^>]+href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)');
+  md = md.replace(/<a[^>]+href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, "[$2]($1)");
 
   // Images
-  md = md.replace(/<img[^>]+src="([^"]*)"[^>]*alt="([^"]*)"[^>]*\/?>/gi, '![$2]($1)');
-  md = md.replace(/<img[^>]+src="([^"]*)"[^>]*\/?>/gi, '![]($1)');
+  md = md.replace(
+    /<img[^>]+src="([^"]*)"[^>]*alt="([^"]*)"[^>]*\/?>/gi,
+    "![$2]($1)",
+  );
+  md = md.replace(/<img[^>]+src="([^"]*)"[^>]*\/?>/gi, "![]($1)");
 
   // Lists
-  md = md.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, (_, c) => `- ${strip(c).trim()}\n`);
-  md = md.replace(/<\/?[ou]l[^>]*>/gi, '\n');
+  md = md.replace(
+    /<li[^>]*>([\s\S]*?)<\/li>/gi,
+    (_, c) => `- ${strip(c).trim()}\n`,
+  );
+  md = md.replace(/<\/?[ou]l[^>]*>/gi, "\n");
 
   // Paragraphs and breaks
-  md = md.replace(/<p[^>]*>([\s\S]*?)<\/p>/gi, (_, c) => `${strip(c).trim()}\n\n`);
-  md = md.replace(/<br\s*\/?>/gi, '\n');
-  md = md.replace(/<hr\s*\/?>/gi, '\n---\n\n');
+  md = md.replace(
+    /<p[^>]*>([\s\S]*?)<\/p>/gi,
+    (_, c) => `${strip(c).trim()}\n\n`,
+  );
+  md = md.replace(/<br\s*\/?>/gi, "\n");
+  md = md.replace(/<hr\s*\/?>/gi, "\n---\n\n");
 
   // Blockquotes
   md = md.replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, (_, c) => {
-    return strip(c).trim().split('\n').map((l) => `> ${l}`).join('\n') + '\n\n';
+    return (
+      strip(c)
+        .trim()
+        .split("\n")
+        .map((l) => `> ${l}`)
+        .join("\n") + "\n\n"
+    );
   });
 
   // Strip remaining tags
-  md = md.replace(/<[^>]+>/g, '');
+  md = md.replace(/<[^>]+>/g, "");
 
   // Decode common entities
   md = decodeEntities(md);
 
   // Normalize whitespace
-  md = md.replace(/\n{3,}/g, '\n\n');
-  md = md.trim() + '\n';
+  md = md.replace(/\n{3,}/g, "\n\n");
+  md = md.trim() + "\n";
 
   return md;
 }
 
 function strip(html) {
-  return html.replace(/<[^>]+>/g, '');
+  return html.replace(/<[^>]+>/g, "");
 }
 
 function decodeEntities(str) {
   return str
-    .replace(/&amp;/g, '&')
-    .replace(/&lt;/g, '<')
-    .replace(/&gt;/g, '>')
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
     .replace(/&quot;/g, '"')
     .replace(/&#39;/g, "'")
-    .replace(/&nbsp;/g, ' ');
+    .replace(/&nbsp;/g, " ");
 }
 
 function deriveOutputPath(inputPath, explicit) {
@@ -97,20 +130,26 @@ function deriveOutputPath(inputPath, explicit) {
 }
 
 async function exportMarkdown(inputPath, outputPath) {
-  const html = fs.readFileSync(inputPath, 'utf-8');
+  const html = fs.readFileSync(inputPath, "utf-8");
   const trimmed = html.trimStart();
-  if (!trimmed.startsWith('<') && !trimmed.startsWith('<!DOCTYPE') && !trimmed.startsWith('<html')) {
-    process.stderr.write('Warning: Input does not appear to be HTML. Markdown conversion may produce unexpected results.\n');
+  if (
+    !trimmed.startsWith("<") &&
+    !trimmed.startsWith("<!DOCTYPE") &&
+    !trimmed.startsWith("<html")
+  ) {
+    process.stderr.write(
+      "Warning: Input does not appear to be HTML. Markdown conversion may produce unexpected results.\n",
+    );
   }
   const md = htmlToMarkdown(html);
   const out = deriveOutputPath(inputPath, outputPath);
-  fs.writeFileSync(out, md, 'utf-8');
+  fs.writeFileSync(out, md, "utf-8");
   return { outputPath: out, message: `Markdown written to ${out}` };
 }
 
 module.exports = {
-  name: 'markdown',
-  description: 'Convert HTML artifacts to clean Markdown',
+  name: "markdown",
+  description: "Convert HTML artifacts to clean Markdown",
   export: exportMarkdown,
   htmlToMarkdown,
 };

package/lib/exporters/pdf.js

@@ -1,11 +1,11 @@
-'use strict';
+"use strict";
 
 // NOTE: PDF is the one export format that requires external tools (md-to-pdf
 // for Markdown, puppeteer for HTML). These are fetched via npx on first run,
 // which needs network access. All other mill export formats are zero-dep.
 
-const path = require('node:path');
-const { execFile } = require('node:child_process');
+const path = require("node:path");
+const { execFile } = require("node:child_process");
 
 /**
  * Export HTML or Markdown files to PDF.
@@ -34,7 +34,8 @@ function exec(cmd, args) {
 
 function npxToolError(toolName, originalError) {
   const msg = originalError.message || String(originalError);
-  const isNotFound = /not found|ENOENT|ERR_MODULE_NOT_FOUND|Cannot find module/i.test(msg);
+  const isNotFound =
+    /not found|ENOENT|ERR_MODULE_NOT_FOUND|Cannot find module/i.test(msg);
   const isNetwork = /ENETUNREACH|ENOTFOUND|fetch failed|EAI_AGAIN/i.test(msg);
   const isTimeout = /timed out|ETIMEDOUT/i.test(msg);
 
@@ -51,19 +52,18 @@ function npxToolError(toolName, originalError) {
       `  Or fall back to: mill export --format markdown`;
   }
 
-  return new Error(`PDF export failed -- ${toolName} unavailable or broken.\n\n${hint}\n\nOriginal error: ${msg}`);
+  return new Error(
+    `PDF export failed -- ${toolName} unavailable or broken.\n\n${hint}\n\nOriginal error: ${msg}`,
+  );
 }
 
 async function exportFromMarkdown(inputPath, outputPath) {
   const out = deriveOutputPath(inputPath, outputPath);
   // md-to-pdf reads from file, writes pdf alongside or to --dest
   try {
-    await exec('npx', [
-      '--yes', 'md-to-pdf', inputPath,
-      '--dest', out,
-    ]);
+    await exec("npx", ["--yes", "md-to-pdf", inputPath, "--dest", out]);
   } catch (err) {
-    throw npxToolError('md-to-pdf', err);
+    throw npxToolError("md-to-pdf", err);
   }
   return { outputPath: out, message: `PDF written to ${out}` };
 }
@@ -82,23 +82,23 @@ async function exportFromHtml(inputPath, outputPath) {
     })();
   `;
   try {
-    await exec('node', ['-e', script]);
+    await exec("node", ["-e", script]);
   } catch (err) {
-    throw npxToolError('puppeteer', err);
+    throw npxToolError("puppeteer", err);
   }
   return { outputPath: out, message: `PDF written to ${out}` };
 }
 
 async function exportPdf(inputPath, outputPath) {
   const ext = path.extname(inputPath).toLowerCase();
-  if (ext === '.md' || ext === '.markdown') {
+  if (ext === ".md" || ext === ".markdown") {
     return exportFromMarkdown(inputPath, outputPath);
   }
   return exportFromHtml(inputPath, outputPath);
 }
 
 module.exports = {
-  name: 'pdf',
-  description: 'Export HTML or Markdown to PDF',
+  name: "pdf",
+  description: "Export HTML or Markdown to PDF",
   export: exportPdf,
 };

package/lib/formats/bibtex.js

@@ -6,10 +6,11 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'bibtex';
-export const extension = '.bib';
-export const mimeType = 'application/x-bibtex; charset=utf-8';
-export const description = 'Claims as BibTeX bibliography entries (@misc per claim)';
+export const name = "bibtex";
+export const extension = ".bib";
+export const mimeType = "application/x-bibtex; charset=utf-8";
+export const description =
+  "Claims as BibTeX bibliography entries (@misc per claim)";
 
 /**
  * Convert a compilation object to BibTeX.
@@ -20,36 +21,42 @@ export function convert(compilation) {
   const claims = compilation.claims || [];
   const meta = compilation.meta || {};
   const year = new Date().getFullYear().toString();
-  const author = meta.sprint ? `wheat sprint: ${meta.sprint}` : 'wheat sprint';
+  const author = meta.sprint ? `wheat sprint: ${meta.sprint}` : "wheat sprint";
 
   if (claims.length === 0) {
     return `% No claims in compilation\n`;
   }
 
-  const entries = claims.map(claim => claimToEntry(claim, author, year));
-  return entries.join('\n\n') + '\n';
+  const entries = claims.map((claim) => claimToEntry(claim, author, year));
+  return entries.join("\n\n") + "\n";
 }
 
 function claimToEntry(claim, author, year) {
-  const id = String(claim.id || 'unknown').replace(/[^a-zA-Z0-9_-]/g, '_');
-  const title = escapeBibtex(claim.content || claim.text || '');
-  const type = claim.type || '';
-  const evidence = typeof claim.evidence === 'string'
-    ? claim.evidence
-    : (claim.evidence?.tier ?? claim.evidence_tier ?? '');
-  const status = claim.status || '';
+  const id = String(claim.id || "unknown").replace(/[^a-zA-Z0-9_-]/g, "_");
+  const title = escapeBibtex(claim.content || claim.text || "");
+  const type = claim.type || "";
+  const evidence =
+    typeof claim.evidence === "string"
+      ? claim.evidence
+      : (claim.evidence?.tier ?? claim.evidence_tier ?? "");
+  const status = claim.status || "";
   const tags = Array.isArray(claim.tags) ? claim.tags : [];
-  const confidence = claim.confidence != null ? `, confidence: ${claim.confidence}` : '';
+  const confidence =
+    claim.confidence != null ? `, confidence: ${claim.confidence}` : "";
 
-  const noteParts = [
-    type ? `type: ${type}` : '',
-    evidence ? `evidence: ${evidence}` : '',
-    status ? `status: ${status}` : '',
-  ].filter(Boolean).join(', ') + confidence;
+  const noteParts =
+    [
+      type ? `type: ${type}` : "",
+      evidence ? `evidence: ${evidence}` : "",
+      status ? `status: ${status}` : "",
+    ]
+      .filter(Boolean)
+      .join(", ") + confidence;
 
-  const keywordsLine = tags.length > 0
-    ? `\n  keywords = {${tags.map(escapeBibtex).join(', ')}},`
-    : '';
+  const keywordsLine =
+    tags.length > 0
+      ? `\n  keywords = {${tags.map(escapeBibtex).join(", ")}},`
+      : "";
 
   return [
     `@misc{claim_${id},`,
@@ -58,19 +65,19 @@ function claimToEntry(claim, author, year) {
     `  year = {${year}},`,
     `  note = {${escapeBibtex(noteParts)}},` + keywordsLine,
     `}`,
-  ].join('\n');
+  ].join("\n");
 }
 
 function escapeBibtex(value) {
-  if (value == null) return '';
+  if (value == null) return "";
   return String(value)
-    .replace(/\\/g, '\\textbackslash{}')
-    .replace(/&/g, '\\&')
-    .replace(/%/g, '\\%')
-    .replace(/#/g, '\\#')
-    .replace(/_/g, '\\_')
-    .replace(/\{/g, '\\{')
-    .replace(/\}/g, '\\}')
-    .replace(/~/g, '\\textasciitilde{}')
-    .replace(/\^/g, '\\textasciicircum{}');
+    .replace(/\\/g, "\\textbackslash{}")
+    .replace(/&/g, "\\&")
+    .replace(/%/g, "\\%")
+    .replace(/#/g, "\\#")
+    .replace(/_/g, "\\_")
+    .replace(/\{/g, "\\{")
+    .replace(/\}/g, "\\}")
+    .replace(/~/g, "\\textasciitilde{}")
+    .replace(/\^/g, "\\textasciicircum{}");
 }

package/lib/formats/changelog.js

@@ -6,10 +6,11 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'changelog';
-export const extension = '.md';
-export const mimeType = 'text/markdown; charset=utf-8';
-export const description = 'Claims changelog grouped by status (active, resolved, conflicts)';
+export const name = "changelog";
+export const extension = ".md";
+export const mimeType = "text/markdown; charset=utf-8";
+export const description =
+  "Claims changelog grouped by status (active, resolved, conflicts)";
 
 /**
  * Convert a compilation object to changelog markdown.
@@ -20,83 +21,83 @@ export function convert(compilation) {
   const claims = compilation.claims || [];
   const conflicts = compilation.conflicts || [];
   const meta = compilation.meta || {};
-  const sprintName = meta.sprint || 'unnamed';
+  const sprintName = meta.sprint || "unnamed";
 
   const groups = {};
   for (const claim of claims) {
-    const status = claim.status || 'unknown';
+    const status = claim.status || "unknown";
     if (!groups[status]) groups[status] = [];
     groups[status].push(claim);
   }
 
   const lines = [];
   lines.push(`# Changelog — ${sprintName}`);
-  lines.push('');
+  lines.push("");
 
   // Active claims first
   if (groups.active) {
     lines.push(`## Active (${groups.active.length} claims)`);
-    lines.push('');
+    lines.push("");
     for (const claim of groups.active) {
       lines.push(`- ${claim.id}: ${claimText(claim)}`);
     }
-    lines.push('');
+    lines.push("");
   }
 
   // Resolved claims
   if (groups.resolved) {
     lines.push(`## Resolved (${groups.resolved.length} claims)`);
-    lines.push('');
+    lines.push("");
     for (const claim of groups.resolved) {
       lines.push(`- ${claim.id}: ${claimText(claim)}`);
     }
-    lines.push('');
+    lines.push("");
   }
 
   // All other statuses
-  const shown = new Set(['active', 'resolved']);
+  const shown = new Set(["active", "resolved"]);
   const otherStatuses = Object.keys(groups)
-    .filter(s => !shown.has(s))
+    .filter((s) => !shown.has(s))
     .sort();
 
   for (const status of otherStatuses) {
     const group = groups[status];
     const label = status.charAt(0).toUpperCase() + status.slice(1);
     lines.push(`## ${label} (${group.length} claims)`);
-    lines.push('');
+    lines.push("");
     for (const claim of group) {
       lines.push(`- ${claim.id}: ${claimText(claim)}`);
     }
-    lines.push('');
+    lines.push("");
   }
 
   // Conflicts section
   if (conflicts.length > 0) {
     lines.push(`## Conflicts (${conflicts.length})`);
-    lines.push('');
+    lines.push("");
     for (const conflict of conflicts) {
       const ids = Array.isArray(conflict.claim_ids)
-        ? conflict.claim_ids.join(' vs ')
-        : (conflict.between || 'unknown');
-      const desc = conflict.description || conflict.reason || '';
+        ? conflict.claim_ids.join(" vs ")
+        : conflict.between || "unknown";
+      const desc = conflict.description || conflict.reason || "";
       lines.push(`- ${ids}: ${desc}`);
     }
-    lines.push('');
+    lines.push("");
   } else {
     lines.push(`## Conflicts (0)`);
-    lines.push('');
-    lines.push('No conflicts.');
-    lines.push('');
+    lines.push("");
+    lines.push("No conflicts.");
+    lines.push("");
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function claimText(claim) {
-  const text = claim.content || claim.text || '';
+  const text = claim.content || claim.text || "";
   // Truncate long claims for readability
   if (text.length > 120) {
-    return text.slice(0, 117) + '...';
+    return text.slice(0, 117) + "...";
   }
   return text;
 }