arcane-cli 1.8.1 → 1.9.0

package/dist/index.js

@@ -7735,6 +7735,33 @@ function renderShowReport(model, templateHtml) {
   });
 }
 
+// src/modules/show-report/theme.ts
+var REPORT_THEMES = ["auto", "light", "dark"];
+function radioTagPattern(id) {
+  return new RegExp(`<input\\b[^>]*\\bid="arcane-report-theme-${id}"[^>]*?/?>`);
+}
+function withoutChecked(tag) {
+  return tag.replace(/\s+checked(?:="[^"]*")?/, "");
+}
+function withChecked(tag) {
+  return /\bchecked\b/.test(tag) ? tag : tag.replace(/(\/?>)$/, " checked$1");
+}
+function applyReportTheme(html, theme) {
+  if (theme === "auto") return { html, applied: true };
+  if (!radioTagPattern(theme).test(html)) return { html, applied: false };
+  let result = html;
+  for (const id of REPORT_THEMES) {
+    const match = radioTagPattern(id).exec(result);
+    if (!match) continue;
+    const original = match[0];
+    const replaced = id === theme ? withChecked(original) : withoutChecked(original);
+    if (replaced !== original) {
+      result = result.slice(0, match.index) + replaced + result.slice(match.index + original.length);
+    }
+  }
+  return { html: result, applied: true };
+}
+
 // src/modules/show-report/generate.ts
 var TEMPLATE_VERSION = "v0-interim";
 var NO_EPICS_REASON = "no parseable `- [x] **ID \u2014 Title.**` epic bullets";
@@ -7801,7 +7828,7 @@ async function readOptionalFile(path4) {
     throw error;
   }
 }
-async function generateReport(rootDir, program2, templateHtml) {
+async function generateReport(rootDir, program2, templateHtml, theme = "auto") {
   const planContent = await readFile15(join18(rootDir, program2.planRelPath), "utf8");
   const frontmatter = parseFrontmatter(planContent);
   const model = await buildShowReportModel({
@@ -7813,19 +7840,24 @@ async function generateReport(rootDir, program2, templateHtml) {
     compiledAt: deterministicCompiledAt(frontmatter),
     templateVersion: TEMPLATE_VERSION
   });
+  const themed = applyReportTheme(renderShowReport(model, templateHtml), theme);
   return {
     json: `${JSON.stringify(model, null, 2)}
 `,
-    html: renderShowReport(model, templateHtml)
+    html: themed.html,
+    themeApplied: themed.applied
   };
 }
 async function runReportGeneration(options) {
   const templateHtml = await readFile15(options.templatePath, "utf8");
+  const theme = options.theme ?? "auto";
   const drifted = [];
   const repaired = [];
   const unwritten = [];
+  const themeSkipped = [];
   for (const program2 of options.programs) {
-    const generated = await generateReport(options.rootDir, program2, templateHtml);
+    const generated = await generateReport(options.rootDir, program2, templateHtml, theme);
+    if (!generated.themeApplied) themeSkipped.push(program2.slug);
     const missing = JSON.parse(generated.json).sections.flatMap((section) => section.rows).filter((row) => row.descriptionState === "unwritten").map((row) => row.id);
     if (missing.length > 0) unwritten.push({ slug: program2.slug, ids: missing });
     const outAbs = options.outDir ? isAbsolute(options.outDir) ? options.outDir : resolve4(options.rootDir, options.outDir) : resolve4(options.rootDir, dirname10(program2.planRelPath));
@@ -7846,7 +7878,7 @@ async function runReportGeneration(options) {
       }
     }
   }
-  return { drifted, repaired, unwritten };
+  return { drifted, repaired, unwritten, themeSkipped };
 }
 
 // src/commands/report.ts
@@ -7866,6 +7898,14 @@ async function runReport(targetDir, options = {}, assetsDir) {
       "--refresh: external-data snapshotting (gh PR titles/merge dates) is not implemented yet; regenerating from local sources."
     );
   }
+  const theme = options.theme ?? "auto";
+  if (!REPORT_THEMES.includes(theme)) {
+    console.error(
+      `\u2716 arcane: --theme must be one of ${REPORT_THEMES.join(" | ")}, got "${options.theme}".`
+    );
+    process.exitCode = 1;
+    return;
+  }
   if (await isShallowRepository(targetDir)) {
     console.warn(
       "\u26A0 arcane: shallow clone -- the report's version span and cast are derived from git history and will be omitted. Run `git fetch --unshallow` for a complete report."
@@ -7895,13 +7935,19 @@ async function runReport(targetDir, options = {}, assetsDir) {
     templatePath,
     mode: "write",
     programs,
-    outDir: options.out
+    outDir: options.out,
+    theme
   });
   for (const u of result.unwritten) {
     console.warn(
       `\u26A0 arcane: ${u.slug} has ${u.ids.length} epic(s) with no \`**Report:**\` line in PLAN.md -- they render as "unwritten": ${u.ids.join(", ")}.`
     );
   }
+  for (const slug of result.themeSkipped) {
+    console.warn(
+      `\u26A0 arcane: ${slug} -- --theme ${theme} requested, but this template has no theme toggle to set (older vendored template?); left unchanged.`
+    );
+  }
   if (result.repaired.length === 0) {
     console.log(`Show report: ${programs.length} program(s) already up to date.`);
     return;
@@ -8054,6 +8100,9 @@ program.command("report").description(
 ).option("--plan <path>", "Report on one PLAN.md instead of auto-discovering docs/plans/*/PLAN.md").option("--out <dir>", "Write show-report.{json,html} into this directory instead of next to the plan").option(
   "--refresh",
   "Accepted for forward compatibility; external-data snapshotting is not implemented yet, so this regenerates from local sources"
+).option(
+  "--theme <mode>",
+  "Force the in-page toggle's initial state: auto | light | dark (default auto, byte-for-byte unchanged). Pair with --out for a one-off themed copy so it doesn't overwrite the tracked show-report.html"
 ).action(async (opts) => {
   await runReport(process.cwd(), opts, ASSETS_DIR);
 });