gutterpress 0.10.10-alpha.3 → 0.10.11-alpha.1

package/README.md

@@ -12,11 +12,11 @@ Download for your platform from the [latest release](https://github.com/dimm-cit
 
 | Platform | Binary |
 |---|---|
-| Linux x64 | `gutterpress-linux-x64` |
-| Linux ARM64 | `gutterpress-linux-arm64` |
-| macOS Apple Silicon | `gutterpress-macos-arm64` |
-| macOS Intel | `gutterpress-macos-x64` |
-| Windows x64 | `gutterpress-windows-x64.exe` |
+| Linux x64 | `gutterpress-cli-linux-x64` |
+| Linux ARM64 | `gutterpress-cli-linux-arm64` |
+| macOS Apple Silicon | `gutterpress-cli-macos-arm64` |
+| macOS Intel | `gutterpress-cli-macos-x64` |
+| Windows x64 | `gutterpress-cli-windows-x64.exe` |
 
 Move the binary somewhere on your `PATH`, mark it executable (`chmod +x`), and you're done.
 
@@ -308,8 +308,22 @@ gutterpress validate [dir] [options]
   --format <fmt>       text (default) | json
   --phase <p>          pre | post | all | pre-build | post-build   (default: all)
   --target <t>         Publish targets to validate against (comma-separated, e.g. dtrpg,itch), overriding the manifest's `targets:`
+  --fix                Rewrite the source markdown in place with markdownlint's auto-fixes (source.markdownlint only)
 ```
 
+`--fix` is the only thing validation ever writes, and only when you ask for
+it: it applies markdownlint's own auto-fixes to the markdown, prints every
+file it rewrote, and still reports whatever cannot be fixed mechanically. It
+uses the same `.markdownlint.*` config the `source.markdownlint` check uses,
+and does nothing when no config is found. A file with uncommitted changes is
+rewritten too — you get a notice, not a refusal.
+
+It writes only when `source.markdownlint` is actually part of the run, so
+`--skip source.markdownlint`, an `--only` that names other checks, or a
+`--phase`/`--category` that filters the source checks out all leave your
+markdown untouched — `--fix` can never rewrite a file for a check the report
+does not mention.
+
 ### `gutterpress audit`
 
 Run asset-only validation checks (image DPI/format/color-space, print-readiness) without the rest of the validation pipeline.
@@ -546,7 +560,7 @@ The standalone binary is the easiest way — drop it in a GitHub Actions step an
 - name: Build PDF
   run: |
     curl -L -o gutterpress \
-      https://github.com/dimm-city/gutterpress/releases/latest/download/gutterpress-linux-x64
+      https://github.com/dimm-city/gutterpress/releases/latest/download/gutterpress-cli-linux-x64
     chmod +x gutterpress
     sudo apt-get install -y google-chrome-stable ghostscript
     ./gutterpress build ./my-book --out dist/my-book.pdf

package/dist/api/index.js

@@ -124,7 +124,7 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-ryjmpyq6.js";
+} from "../index-fcfae175.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,

package/dist/{audit-sb0abmqy.js → audit-4qngz16q.js}

@@ -1,14 +1,14 @@
 import {
   executeAndReport
-} from "./cli-x4krgssg.js";
+} from "./cli-s6m6d0hx.js";
 import {
   log
-} from "./cli-d7k5ykyx.js";
+} from "./cli-8x25pp3t.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1prnz7c8.js";
+} from "./cli-wthscqa9.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{build-e54deg18.js → build-4b6a3r3c.js}

@@ -1,17 +1,17 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-x4krgssg.js";
+} from "./cli-s6m6d0hx.js";
 import {
   log
-} from "./cli-d7k5ykyx.js";
+} from "./cli-8x25pp3t.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1prnz7c8.js";
+} from "./cli-wthscqa9.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/checks/source/markdownlint.d.ts

@@ -1,3 +1,19 @@
 import type { Check } from "../types";
+/** Exported so `validate --fix` (lib/markdownlint-fix.ts) discovers config
+ * through THIS list, never a second copy of it. */
+export declare const CONFIG_NAMES: string[];
+/**
+ * Load a markdownlint config object from a discovered config file. The parser
+ * is selected by extension (.json → JSON, .jsonc → JSON minus comments, else
+ * YAML — which also accepts plain JSON). markdownlint-cli2-style files nest the
+ * rules under a `config:` key; plain markdownlint files are the rules object
+ * directly, so `parsed.config ?? parsed` handles both shapes.
+ *
+ * Exported for `validate --fix` (lib/markdownlint-fix.ts), so the fixer and
+ * this check can never disagree about which rules apply.
+ */
+export declare function loadConfig(configPath: string): Promise<Record<string, unknown>>;
+/** The registered id, shared with `validate --fix`'s selector gate (#275). */
+export declare const MARKDOWNLINT_CHECK_ID = "source.markdownlint";
 declare const check: Check;
 export default check;

package/dist/{cli-d7k5ykyx.js → cli-8x25pp3t.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-1prnz7c8.js";
+} from "./cli-wthscqa9.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-x4krgssg.js → cli-s6m6d0hx.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-d7k5ykyx.js";
+} from "./cli-8x25pp3t.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-1prnz7c8.js";
+} from "./cli-wthscqa9.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
@@ -41,10 +41,12 @@ import {
   BuildError
 } from "./cli-46ycxe6r.js";
 import {
-  hasUncommittedChanges
+  hasUncommittedChanges,
+  listWorkdirChanges
 } from "./cli-4mtf9ajw.js";
 import {
-  detectProjectSource
+  detectProjectSource,
+  repoSubPath
 } from "./cli-v5mp7a6q.js";
 import {
   __require
@@ -2419,8 +2421,9 @@ async function loadConfig(configPath) {
   }
   return {};
 }
+var MARKDOWNLINT_CHECK_ID = "source.markdownlint";
 var check16 = {
-  id: "source.markdownlint",
+  id: MARKDOWNLINT_CHECK_ID,
   name: "Markdownlint",
   description: "Runs markdownlint with project config to validate Markdown files",
   category: "source",
@@ -3587,7 +3590,7 @@ function attachDataAttrs(token, kind, name, attrs) {
       continue;
     if (k === "class" || k === "id" || k === "template" || k === "region")
       continue;
-    token.attrSet(`data-${k}`, v);
+    token.attrSet(k.startsWith("data-") ? k : `data-${k}`, v);
   }
 }
 var DECLARED_NAME_RE = /^[a-z][a-z0-9-]*$/;
@@ -7713,6 +7716,69 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
   return outFile;
 }
 
+// src/lib/markdownlint-fix.ts
+import { readFile as readFile20, writeFile as writeFile3 } from "node:fs/promises";
+import { applyFixes } from "markdownlint";
+import { lint as lint2 } from "markdownlint/sync";
+async function uncommittedAmong(inputDir, files) {
+  const source = await detectProjectSource(inputDir);
+  if (source.type !== "local-git-folder")
+    return [];
+  const repoRoot = source.repoRoot;
+  let changed;
+  try {
+    const { adds } = await listWorkdirChanges(repoRoot);
+    changed = new Set(adds);
+  } catch {
+    return [];
+  }
+  return files.filter((file) => changed.has(repoSubPath(repoRoot, file)));
+}
+async function applyMarkdownlintFixes(ctx) {
+  const sourceConfig = ctx.config.validate.source;
+  if (sourceConfig.markdownlint === false) {
+    log.warn("--fix: source.markdownlint is disabled for this project — no files were fixed.");
+    return [];
+  }
+  const files = ctx.markdownFiles;
+  if (!files || files.length === 0) {
+    log.warn("--fix: no markdown files to fix.");
+    return [];
+  }
+  const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
+  const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
+  if (!resolvedConfig && !configPath) {
+    log.warn(`--fix: no markdownlint config found in ${ctx.inputDir} (looked for ${CONFIG_NAMES.join(", ")}) — no files were fixed.`);
+    return [];
+  }
+  const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
+  const results = lint2({ files, config });
+  const pending = [];
+  for (const [file, violations] of Object.entries(results)) {
+    if (!Array.isArray(violations) || violations.length === 0)
+      continue;
+    const before = await readFile20(file, "utf8");
+    const after = applyFixes(before, violations);
+    if (after !== before)
+      pending.push({ file, content: after });
+  }
+  if (pending.length === 0) {
+    log.warn("--fix: no mechanically fixable markdownlint violations found.");
+    return [];
+  }
+  const dirty = await uncommittedAmong(ctx.inputDir, pending.map((p) => p.file));
+  for (const { file, content } of pending) {
+    await writeFile3(file, content, "utf8");
+  }
+  log.warn(`--fix: rewrote ${pending.length} file(s):`);
+  for (const { file } of pending)
+    log.warn(`  ${file}`);
+  if (dirty.length > 0) {
+    log.warn(`--fix: ${dirty.length} of those already had uncommitted changes and were rewritten anyway: ${dirty.join(", ")}`);
+  }
+  return pending.map((p) => p.file);
+}
+
 // src/checks/formatter.ts
 function formatReport(report, format = "text") {
   if (format === "json") {
@@ -8106,6 +8172,14 @@ async function executeValidation(args) {
     only,
     skip
   };
+  if (args.fix) {
+    const selected = selectChecks(runnerOptions, config).checks;
+    if (selected.some((check37) => check37.id === MARKDOWNLINT_CHECK_ID)) {
+      await applyMarkdownlintFixes(context);
+    } else {
+      log.warn(`--fix: ${MARKDOWNLINT_CHECK_ID} is not part of this run — no files were fixed.`);
+    }
+  }
   const runs = planRuns({ manifest, baseConfig: config, targetIds, pdfPath, categories, only });
   const reports = [];
   const toolResults = [];
@@ -8187,7 +8261,7 @@ import { randomBytes } from "node:crypto";
 
 // src/lib/build-fingerprint.ts
 import * as fs from "node:fs";
-import { mkdir as mkdir3, readFile as readFile20, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir3, readFile as readFile21, writeFile as writeFile4 } from "node:fs/promises";
 import { createHash as createHash5 } from "node:crypto";
 import path8 from "node:path";
 import git from "isomorphic-git";
@@ -8274,8 +8348,8 @@ async function getEngineBundleHash() {
       getAssetPath("engine/gutterpress-agent.js")
     ]);
     const [viewerBytes, agentBytes] = await Promise.all([
-      readFile20(viewerPath),
-      readFile20(agentPath)
+      readFile21(viewerPath),
+      readFile21(agentPath)
     ]);
     const hash = createHash5("sha256");
     hash.update(viewerBytes);
@@ -8346,7 +8420,7 @@ async function writeBuildFingerprint(input) {
     tools
   };
   await mkdir3(outputDir, { recursive: true });
-  await writeFile3(outPath, stableJsonStringify(payload), "utf8");
+  await writeFile4(outPath, stableJsonStringify(payload), "utf8");
   return outPath;
 }
 
@@ -8785,7 +8859,7 @@ function openPath(filePath) {
 import path11 from "path";
 import { tmpdir as tmpdir2 } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir4, readFile as readFile21, writeFile as writeFile4 } from "node:fs/promises";
+import { readdir as readdir4, readFile as readFile22, writeFile as writeFile5 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -9295,7 +9369,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path11.join(TEMP_DIR_BASE, entry);
     const pidFile = path11.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile21(pidFile, "utf8");
+      const raw = await readFile22(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -9310,7 +9384,7 @@ async function initializePreviewDirectories() {
   const tempDir = path11.join(TEMP_DIR_BASE, tempDirSuffix);
   await mkdir4(tempDir);
   debug(`Created temporary directory: ${tempDir}`);
-  await writeFile4(path11.join(tempDir, PID_FILE_NAME), `${process.pid}
+  await writeFile5(path11.join(tempDir, PID_FILE_NAME), `${process.pid}
 `, "utf8");
   return tempDir;
 }
@@ -9401,7 +9475,7 @@ function createServerState(inputPath, tempDir, config, options) {
 import http from "node:http";
 import net from "node:net";
 import { createHash as createHash6, randomUUID } from "node:crypto";
-import { readFile as readFile22, stat as stat4 } from "node:fs/promises";
+import { readFile as readFile23, stat as stat4 } from "node:fs/promises";
 import path13 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 
@@ -9691,7 +9765,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile22(filePath);
+    data = await readFile23(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -9741,7 +9815,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile22(absPath);
+      data = await readFile23(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -10080,7 +10154,7 @@ async function startPreviewServer(options) {
 }
 
 // src/lib/extension-manager.ts
-import { cp as cp2, mkdir as mkdir7, readFile as readFile25, rm as rm4, stat as stat5 } from "node:fs/promises";
+import { cp as cp2, mkdir as mkdir7, readFile as readFile26, rm as rm4, stat as stat5 } from "node:fs/promises";
 import { existsSync as existsSync11 } from "node:fs";
 import path16 from "node:path";
 import { isSeq as isSeq2, isMap, isScalar, YAMLMap, Scalar } from "yaml";
@@ -10088,7 +10162,7 @@ import { isSeq as isSeq2, isMap, isScalar, YAMLMap, Scalar } from "yaml";
 // src/lib/manifest-doc.ts
 import { existsSync as existsSync10 } from "node:fs";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir5, open, readFile as readFile23, rename, rm as rm2 } from "node:fs/promises";
+import { mkdir as mkdir5, open, readFile as readFile24, rename, rm as rm2 } from "node:fs/promises";
 import path14 from "node:path";
 import { parseDocument, isSeq, YAMLSeq } from "yaml";
 function resolveManifestPath(projectDir) {
@@ -10099,7 +10173,7 @@ async function loadManifestDoc(projectDir) {
   const file = resolveManifestPath(projectDir);
   let text = "";
   try {
-    text = await readFile23(file, "utf8");
+    text = await readFile24(file, "utf8");
   } catch (error2) {
     if (error2.code !== "ENOENT")
       throw error2;
@@ -10146,7 +10220,7 @@ import {
   mkdir as mkdir6,
   mkdtemp as mkdtemp2,
   open as open2,
-  readFile as readFile24,
+  readFile as readFile25,
   realpath as realpath2,
   rename as rename2,
   rm as rm3
@@ -10544,7 +10618,7 @@ async function readInstalledManifest(packageDir, selected) {
     const info2 = await lstat2(packageJsonPath);
     if (!info2.isFile() || info2.isSymbolicLink())
       throw new Error("not a regular file");
-    manifest = object3(JSON.parse(await readFile24(packageJsonPath, "utf8")));
+    manifest = object3(JSON.parse(await readFile25(packageJsonPath, "utf8")));
   } catch (error2) {
     throw new SecurityInstallError(`Downloaded ${selected.name}@${selected.version} has no valid package.json (${error2 instanceof Error ? error2.message : String(error2)}).`);
   }
@@ -11248,7 +11322,7 @@ async function addBuiltInStyleSet(projectDir, id) {
 }
 
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp3, mkdir as mkdir8, readdir as readdir5, readFile as readFile26, stat as stat6, writeFile as writeFile5 } from "node:fs/promises";
+import { access, copyFile, cp as cp3, mkdir as mkdir8, readdir as readdir5, readFile as readFile27, stat as stat6, writeFile as writeFile6 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync12 } from "node:fs";
 import path17 from "node:path";
 var STARTER_THEME_FOR_TEMPLATE = {
@@ -11371,7 +11445,7 @@ async function scaffoldProject(options) {
       await copyFile(tplManifest, path17.join(projectDir, MANIFEST_FILENAMES[0]));
       await copyFile(tplChapter, path17.join(projectDir, "chapter-01.md"));
       await mkdir8(path17.join(projectDir, "styles"), { recursive: true });
-      await writeFile5(path17.join(projectDir, "styles", "book.css"), starterOverridesCss(starterThemeId), "utf8");
+      await writeFile6(path17.join(projectDir, "styles", "book.css"), starterOverridesCss(starterThemeId), "utf8");
     }
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not create the project files: ${e instanceof Error ? e.message : String(e)}`);
@@ -11451,10 +11525,10 @@ async function ensureGitignoreHasDist(projectDir) {
   const gitignorePath = path17.join(projectDir, ".gitignore");
   let existing = null;
   try {
-    existing = await readFile26(gitignorePath, "utf8");
+    existing = await readFile27(gitignorePath, "utf8");
   } catch {}
   if (existing === null) {
-    await writeFile5(gitignorePath, `dist/
+    await writeFile6(gitignorePath, `dist/
 `, "utf8");
     return;
   }
@@ -11464,14 +11538,14 @@ async function ensureGitignoreHasDist(projectDir) {
     return;
   const needsLeadingNewline = existing.length > 0 && !existing.endsWith(`
 `);
-  await writeFile5(gitignorePath, existing + (needsLeadingNewline ? `
+  await writeFile6(gitignorePath, existing + (needsLeadingNewline ? `
 ` : "") + `dist/
 `, "utf8");
 }
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile26(manifestPath, "utf8");
+    text = await readFile27(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -11483,15 +11557,15 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile26(filePath, "utf8");
+  let text = await readFile27(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
-  await writeFile5(filePath, text, "utf8");
+  await writeFile6(filePath, text, "utf8");
 }
 
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir9, readFile as readFile27, writeFile as writeFile6 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir9, readFile as readFile28, writeFile as writeFile7 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path18 from "node:path";
 var EXTENSION_KINDS = ["plugin", "theme"];
@@ -11608,9 +11682,9 @@ async function scaffoldExtension(options) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path18.join(extensionDir, relDest);
       await mkdir9(path18.dirname(dest), { recursive: true });
-      const text = await readFile27(src, "utf8");
+      const text = await readFile28(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
-      await writeFile6(dest, substitute(text, table), "utf8");
+      await writeFile7(dest, substitute(text, table), "utf8");
       written.push(relDest);
     }
   } catch (e) {
@@ -11653,7 +11727,7 @@ var SKIP_ENTRIES = new Set([
 
 // src/lib/extension-import.ts
 import { existsSync as existsSync13 } from "node:fs";
-import { cp as cp4, mkdir as mkdir10, mkdtemp as mkdtemp3, readFile as readFile28, rm as rm5, writeFile as writeFile7 } from "node:fs/promises";
+import { cp as cp4, mkdir as mkdir10, mkdtemp as mkdtemp3, readFile as readFile29, rm as rm5, writeFile as writeFile8 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path19 from "node:path";
 import { unzipSync } from "fflate";
@@ -11726,7 +11800,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   if (!existsSync13(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile28(cssPath, "utf8");
+  const css = await readFile29(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -11754,7 +11828,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   for (let i = 0;i < extraSheets.length; i++) {
     const rel = extraSheets[i];
     const sheetPath = extraSheetPaths[i];
-    const sheetCss = await readFile28(sheetPath, "utf8");
+    const sheetCss = await readFile29(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -11787,14 +11861,14 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
   let pkg = {};
   if (metaExists) {
     try {
-      const parsed = JSON.parse(await readFile28(file, "utf8"));
+      const parsed = JSON.parse(await readFile29(file, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         pkg = parsed;
       }
     } catch {}
   }
   const gutterpress = pkg.gutterpress && typeof pkg.gutterpress === "object" && !Array.isArray(pkg.gutterpress) ? pkg.gutterpress : {};
-  await writeFile7(file, JSON.stringify({
+  await writeFile8(file, JSON.stringify({
     ...pkg,
     name: typeof pkg.name === "string" && pkg.name.trim() ? pkg.name : id,
     gutterpress: { ...gutterpress, styles: ["theme.css"] }
@@ -11859,7 +11933,7 @@ async function importExtensionFromZip(projectDir, archive) {
       }
       relPaths.push(rel);
       await mkdir10(path19.dirname(dest), { recursive: true });
-      await writeFile7(dest, data);
+      await writeFile8(dest, data);
     }
     return await finalizeExtensionImport(projectDir, tmp, relPaths, root || "imported-look");
   } finally {
@@ -11874,8 +11948,8 @@ async function importExtensionFromCssText(projectDir, css, name) {
   const displayName = name.trim() || "Imported theme";
   const tmp = await mkdtemp3(path19.join(tmpdir3(), "gutterpress-theme-"));
   try {
-    await writeFile7(path19.join(tmp, "theme.css"), css, "utf8");
-    await writeFile7(path19.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify({ name: slugify(displayName, "look"), gutterpress: { styles: ["theme.css"] } }, null, 2), "utf8");
+    await writeFile8(path19.join(tmp, "theme.css"), css, "utf8");
+    await writeFile8(path19.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify({ name: slugify(displayName, "look"), gutterpress: { styles: ["theme.css"] } }, null, 2), "utf8");
     const result = await finalizeExtensionImport(projectDir, tmp, ["theme.css", EXTENSION_MANIFEST_FILENAME], displayName);
     result.warnings.unshift({
       code: "no-theme-json",
@@ -11889,11 +11963,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path19.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile28(filePath);
+    const buf = await readFile29(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile28(filePath, "utf8");
+    const css = await readFile29(filePath, "utf8");
     return importExtensionFromCssText(projectDir, css, prettify(path19.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip extension package or a .css stylesheet.");
@@ -11958,7 +12032,7 @@ async function importExtensionFromUrl(projectDir, url) {
   assertLooksLikeCss(css, trimmed);
   const tmp = await mkdtemp3(path19.join(tmpdir3(), "gutterpress-ext-"));
   try {
-    await writeFile7(path19.join(tmp, "theme.css"), css, "utf8");
+    await writeFile8(path19.join(tmp, "theme.css"), css, "utf8");
     const gp = meta.gutterpress && typeof meta.gutterpress === "object" && !Array.isArray(meta.gutterpress) ? meta.gutterpress : {};
     const finalMeta = {
       name: typeof meta.name === "string" && meta.name || slugify(baseName, "look"),
@@ -11970,7 +12044,7 @@ async function importExtensionFromUrl(projectDir, url) {
         preview: typeof gp.preview === "string" ? gp.preview : null
       }
     };
-    await writeFile7(path19.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify(finalMeta, null, 2), "utf8");
+    await writeFile8(path19.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify(finalMeta, null, 2), "utf8");
     return await finalizeExtensionImport(projectDir, tmp, ["theme.css", EXTENSION_MANIFEST_FILENAME], baseName);
   } finally {
     await rm5(tmp, { recursive: true, force: true });
@@ -12596,7 +12670,7 @@ ${tail}` : ""}`);
 };
 
 // src/lib/publish/providers/guided.ts
-import { copyFile as copyFile2, mkdir as mkdir11, writeFile as writeFile8 } from "node:fs/promises";
+import { copyFile as copyFile2, mkdir as mkdir11, writeFile as writeFile9 } from "node:fs/promises";
 import path20 from "node:path";
 async function stageGuidedPackage(req, providerId, listingLines) {
   const packageDir = path20.join(path20.dirname(req.artifact.path), "publish", providerId);
@@ -12614,7 +12688,7 @@ async function stageGuidedPackage(req, providerId, listingLines) {
     ""
   ].join(`
 `);
-  await writeFile8(path20.join(packageDir, "LISTING.md"), sheet, "utf8");
+  await writeFile9(path20.join(packageDir, "LISTING.md"), sheet, "utf8");
   return packageDir;
 }
 
@@ -12677,7 +12751,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp4, readFile as readFile29, readdir as readdir6, rm as rm6, stat as stat7, writeFile as writeFile9 } from "node:fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile30, readdir as readdir6, rm as rm6, stat as stat7, writeFile as writeFile10 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
 import path21 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -13069,12 +13143,12 @@ async function collectZipEntries(root, dir, out, onWarn) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
       const rel = path21.relative(root, full).split(path21.sep).join("/");
-      out[rel] = await readFile29(full);
+      out[rel] = await readFile30(full);
     } else if (entry.isSymbolicLink()) {
       const resolved = await stat7(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path21.relative(root, full).split(path21.sep).join("/");
-        out[rel] = await readFile29(full);
+        out[rel] = await readFile30(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -13085,7 +13159,7 @@ async function collectZipEntries(root, dir, out, onWarn) {
     }
   }
 }
-async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile9) {
+async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile10) {
   const entries = {};
   await collectZipEntries(exportDir, exportDir, entries, onWarn);
   const fileName = `${bookSlug(title)}-website.zip`;
@@ -13189,7 +13263,7 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod, mkdir as mkdir12, stat as stat8, writeFile as writeFile10 } from "node:fs/promises";
+import { chmod, mkdir as mkdir12, stat as stat8, writeFile as writeFile11 } from "node:fs/promises";
 import path22 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
@@ -13256,7 +13330,7 @@ async function ensureButler(deps) {
     if (name.endsWith("/"))
       continue;
     const target = path22.join(cacheDir, path22.basename(name));
-    await writeFile10(target, data);
+    await writeFile11(target, data);
     if (path22.basename(name) === butlerBinaryName()) {
       await chmod(target, 493).catch(() => {});
       foundBinary = true;
@@ -14005,7 +14079,7 @@ import git6 from "isomorphic-git";
 import git5 from "isomorphic-git";
 import diff3Merge from "diff3";
 // src/lib/publish/selections.ts
-import { chmod as chmod2, mkdir as mkdir13, readFile as readFile30, writeFile as writeFile11 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir13, readFile as readFile31, writeFile as writeFile12 } from "node:fs/promises";
 import path24 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -14015,7 +14089,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile30(this.filePath, "utf8");
+      const raw = await readFile31(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {
@@ -14029,7 +14103,7 @@ class PublishSelectionsStore {
   }
   async write(data) {
     await mkdir13(path24.dirname(this.filePath), { recursive: true });
-    await writeFile11(this.filePath, JSON.stringify(data, null, 2), {
+    await writeFile12(this.filePath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384
     });
@@ -14096,7 +14170,7 @@ function normalizeProjectKey(projectDir) {
 import { isMap as isMap4 } from "yaml";
 // src/lib/lint-runner.ts
 import { resolve as resolve8 } from "node:path";
-import { readFile as readFile31 } from "node:fs/promises";
+import { readFile as readFile32 } from "node:fs/promises";
 async function runLint(opts = {}) {
   const { glob } = await import("glob");
   const { manifest, manifestDir } = await loadManifestWithPath(opts.manifest, {
@@ -14127,7 +14201,7 @@ async function runLint(opts = {}) {
   for (const file of files) {
     let css;
     try {
-      css = await readFile31(file, "utf8");
+      css = await readFile32(file, "utf8");
     } catch (err) {
       log.error(`  ${file}`);
       log.error(`    cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`);