gutterpress 0.11.6-alpha.2 → 0.11.6-alpha.3

package/dist/api/index.js

@@ -124,12 +124,12 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-nmykzwb4.js";
+} from "../index-0h00ve4y.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-6n15e1ze.js";
+} from "../index-gf1shk3y.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -141,7 +141,7 @@ import {
   resolveLogger,
   restoreVersionWithBackup,
   switchBranch
-} from "../index-c5ev4r1y.js";
+} from "../index-8xkw284t.js";
 import {
   capabilitiesFor,
   detectProjectSource,

package/dist/{audit-fdba6axw.js → audit-t4r954ff.js}

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{build-2gjr2rj6.js → build-8gx90w22.js}

@@ -1,23 +1,23 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{cli-ersw5g7j.js → cli-5c2xfsmz.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.6-alpha.2",
+  version: "0.11.6-alpha.3",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",

package/dist/{cli-sekhwex4.js → cli-5vdgncmm.js}

@@ -1445,7 +1445,7 @@ var preview_shell_default = "./preview-shell-gqnc5xxe.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-k0xrt5hw.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-swz6bwfa.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
@@ -2542,7 +2542,7 @@ ${mapCss}`;
       if (layerTraps.length)
         log(`audit: ${layerTraps.length} trapped layer warning(s)`);
       for (const hit of pageBackgrounds)
-        diagnose("engine.page-background.unreferenced", `"${hit.url}" is only referenced from "${hit.where}", and Chromium will not print an image referenced nowhere else — the page prints with its background colour alone, with no error. Gutterpress stages and preloads every image your project stylesheets reference, so this one is outside that: it is remote (a url(https://...), which is never staged), or it comes from CSS that does not pass through your stylesheets, or an element in the document uses the same URL as its src, which drops it on its own. Use a local image, referenced from one of your project stylesheets, and not also used as an <img>.`);
+        diagnose("engine.page-background.unreferenced", `"${hit.url}" is only referenced from "${hit.where}", and Chromium will not print an image referenced nowhere else — the page prints with its background color alone, with no error. Gutterpress stages and preloads every image your book's stylesheets reference, so this one is outside that: it is remote (a url(https://...), which is never staged), or it comes from CSS that does not pass through your stylesheets, or an element in the document uses the same URL as its src, which drops it on its own. Use a local image, referenced from one of your book's stylesheets, and not also used as an <img>.`);
       if (pageBackgrounds.length)
         log(`audit: ${pageBackgrounds.length} unreferenced @page background image(s)`);
       for (const d of multicol)

package/dist/{cli-c9h2bk2k.js → cli-c5360prx.js}

@@ -298,7 +298,7 @@ class LocalFolderSourceProvider {
   async initVersionHistory(options) {
     const dir = options.projectDir;
     if (await findEnclosingRepoDir(dir) !== undefined) {
-      throw new Error("This folder is already inside a versioned project, so gutterpress " + "won't create a separate history here.");
+      throw new Error("This folder is already inside a versioned book, so gutterpress " + "won't create a separate history here.");
     }
     return withRepoLock(dir, async () => {
       const cache = {};
@@ -322,7 +322,7 @@ class LocalFolderSourceProvider {
     });
   }
   snapshot() {
-    return Promise.reject(new Error("This project has no version history yet. Enable version history first."));
+    return Promise.reject(new Error("This book has no version history yet. Enable version history first."));
   }
   listHistory() {
     return Promise.resolve([]);
@@ -331,7 +331,7 @@ class LocalFolderSourceProvider {
     return Promise.resolve({ entries: [], hasMore: false });
   }
   restore() {
-    return Promise.reject(new Error("This project has no version history yet. Enable version history first."));
+    return Promise.reject(new Error("This book has no version history yet. Enable version history first."));
   }
 }
 
@@ -477,7 +477,7 @@ function providerFor(source) {
     case "local-git-folder":
       return new LocalGitSourceProvider(source);
     case "managed-github":
-      throw new Error("Managed GitHub projects are not supported yet (#15/#16).");
+      throw new Error("Managed GitHub books are not supported yet (#15/#16).");
   }
 }
 function gitDirFor(projectDir) {
@@ -492,7 +492,7 @@ async function restoreVersionWithBackup(options) {
   const { projectDir, id, authorName, authorEmail } = options;
   const source = await detectProjectSource(projectDir);
   if (source.type !== "local-git-folder") {
-    throw new Error("This project has no version history yet. Enable version history first.");
+    throw new Error("This book has no version history yet. Enable version history first.");
   }
   const provider = new LocalGitSourceProvider(source);
   const repoDir = gitScopeFor(source);
@@ -510,7 +510,7 @@ async function restoreVersionWithBackup(options) {
     try {
       await provider.restoreUnlocked({ projectDir, id });
     } catch (cause) {
-      throw new Error(backupId ? "The restore could not be completed, but your work is safe — it was " + `automatically saved as a backup snapshot (${backupId.slice(0, 7)}) ` + "and appears in your version history." : "The restore could not be completed. Your project files were not changed.", { cause });
+      throw new Error(backupId ? "The restore could not be completed, but your work is safe — it was " + `automatically saved as a backup snapshot (${backupId.slice(0, 7)}) ` + "and appears in your version history." : "The restore could not be completed. Your book files were not changed.", { cause });
     }
     return { restoredId: id, backupId };
   });
@@ -597,7 +597,7 @@ async function switchBranch(options) {
   const { projectDir, branch, authorName, authorEmail } = options;
   const source = await detectProjectSource(projectDir);
   if (source.type !== "local-git-folder") {
-    throw new Error("This project has no version history yet. Enable version history first.");
+    throw new Error("This book has no version history yet. Enable version history first.");
   }
   const repoDir = gitScopeFor(source);
   return withRepoLock(repoDir, async () => {

package/dist/{cli-7k2v2sya.js → cli-g6vshy3f.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-ersw5g7j.js";
+} from "./cli-5c2xfsmz.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
@@ -28,7 +28,7 @@ import {
   getAssetsDir,
   getBrowser,
   prewarmBrowser
-} from "./cli-sekhwex4.js";
+} from "./cli-5vdgncmm.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -43,7 +43,7 @@ import {
 import {
   hasUncommittedChanges,
   listWorkdirChanges
-} from "./cli-c9h2bk2k.js";
+} from "./cli-c5360prx.js";
 import {
   detectProjectSource,
   repoSubPath
@@ -432,7 +432,7 @@ async function resolveVendoredPluginInstallRoot(projectDir, expectedName, expect
     realpath(requestedInstallRoot)
   ]);
   if (!isContained(realProjectRoot, installRoot)) {
-    throw new Error("Vendor install root resolves outside the project.");
+    throw new Error("Vendor install root resolves outside the book folder.");
   }
   return installRoot;
 }
@@ -3120,12 +3120,12 @@ function escapesProjectRoot(projectDir, absPath) {
 function proseImageRefError(ref, projectDir) {
   const cleaned = stripUrlSuffix(decodeRef(ref));
   if (/^file:/i.test(cleaned) || path3.isAbsolute(cleaned)) {
-    return `Image reference must be relative to the project: ${ref}
-` + `  Copy the file into your project folder and reference it from there.`;
+    return `Image reference must be relative to the book folder: ${ref}
+` + `  Copy the file into your book folder and reference it from there.`;
   }
   if (escapesProjectRoot(projectDir, path3.resolve(projectDir, cleaned))) {
-    return `Image reference points outside the project: ${ref}
-` + `  Copy the file into your project folder and reference it from there.`;
+    return `Image reference points outside the book folder: ${ref}
+` + `  Copy the file into your book folder and reference it from there.`;
   }
   return null;
 }
@@ -3197,7 +3197,7 @@ async function inlineOne(cssPath, copies, warnings, seen) {
   if (seen.has(abs))
     return "";
   seen.add(abs);
-  const source = await readOrThrow(abs, "stylesheet", "the project manifest");
+  const source = await readOrThrow(abs, "stylesheet", "the book manifest");
   const cssDir = path3.dirname(abs);
   let root;
   try {
@@ -6768,7 +6768,7 @@ var check25 = {
         results.push(finding(check25.id, {
           severity: "warning",
           code: "kept-both-versions",
-          message: `Two versions of ${withoutOnlineTag(rel)} are in your project — keep the one you want, then delete the other.`,
+          message: `Two versions of ${withoutOnlineTag(rel)} are in your book — keep the one you want, then delete the other.`,
           file: sibling
         }));
       }
@@ -7770,7 +7770,7 @@ async function uncommittedAmong(inputDir, files) {
 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.");
+    log.warn("--fix: source.markdownlint is disabled for this book — no files were fixed.");
     return [];
   }
   const files = ctx.markdownFiles;
@@ -8541,7 +8541,7 @@ async function resolveBuildContext(opts) {
   const inputDir = path9.resolve(opts.inputDir);
   const { manifest, manifestDir, manifestPath } = await loadManifestWithPath(opts.manifestPath ?? inputDir, { explicit: opts.manifestPath !== undefined });
   if (manifestPath === null) {
-    throw new UsageError(`No project manifest found in ${inputDir}. Looked for ${MANIFEST_FILENAMES.join(" or ")}. ` + "Run from your project folder or pass that folder with `gutterpress build <project-dir>`. " + "For a custom manifest filename, pass `--manifest <path>`.");
+    throw new UsageError(`No book manifest found in ${inputDir}. Looked for ${MANIFEST_FILENAMES.join(" or ")}. ` + "Run from your book folder or pass that folder with `gutterpress build <book-dir>`. " + "For a custom manifest filename, pass `--manifest <path>`.");
   }
   const pdfxConfigOverride = format === "pdfx" ? {
     flavor: opts.pdfxFlavor,
@@ -8768,7 +8768,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path9.join(stage, "raw.pdf") : path9.resolve(pdfFile);
       await fsp2.mkdir(path9.dirname(path9.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-cbc17ne4.js");
+      const { buildNativePdf } = await import("./engine-amxqsfka.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10324,7 +10324,7 @@ function resolveScaffoldTargets(requested, preset) {
 async function scaffoldProject(options) {
   const name = (options.name ?? "").trim();
   if (!name) {
-    throw new CreateProjectErrorImpl("invalid-name", "A project name is required.");
+    throw new CreateProjectErrorImpl("invalid-name", "A book name is required.");
   }
   const slug = slugifyProjectName(name);
   const folderName = (options.folderName ?? slug).trim();
@@ -10374,7 +10374,7 @@ async function scaffoldProject(options) {
       await writeFile6(path15.join(projectDir, "styles", "book.css"), starterOverridesCss(), "utf8");
     }
   } catch (e) {
-    throw new CreateProjectErrorImpl("scaffold-io", `Could not create the project files: ${e instanceof Error ? e.message : String(e)}`);
+    throw new CreateProjectErrorImpl("scaffold-io", `Could not create the book files: ${e instanceof Error ? e.message : String(e)}`);
   }
   try {
     await ensureGitignoreHasDist(projectDir);
@@ -10411,14 +10411,14 @@ async function scaffoldProject(options) {
       openFile = path15.join(projectDir, firstSource);
     await fillTemplateFile(openFile, { "{{TITLE}}": name }).catch(() => {});
   } catch (e) {
-    throw new CreateProjectErrorImpl("scaffold-io", `Could not finalise the project files: ${e instanceof Error ? e.message : String(e)}`);
+    throw new CreateProjectErrorImpl("scaffold-io", `Could not finalize the book files: ${e instanceof Error ? e.message : String(e)}`);
   }
   const requested = options.versionHistory ?? "local-git";
   let versionHistory = "none";
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-54a52bpd.js");
+      const { providerFor } = await import("./source-provider-exy1wakv.js");
       const provider = providerFor({ type: "local-folder", path: projectDir });
       await provider.initVersionHistory({
         projectDir,
@@ -11244,7 +11244,7 @@ async function prepareVendorParent(projectDir, name) {
     realpath2(packageParent)
   ]);
   if (!isContained2(projectDir, realNpm) || !isContained2(projectDir, realPackageParent)) {
-    throw new Error("Plugin install path resolves outside the project.");
+    throw new Error("Plugin install path resolves outside the book folder.");
   }
   return realNpm;
 }
@@ -11326,7 +11326,7 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
     finalRoot = vendoredNpmPluginRoot(projectDir, rootRecord.name, rootRecord.version);
     const realFinalParent = await realpath2(path17.dirname(finalRoot));
     if (!isContained2(projectDir, realFinalParent)) {
-      throw new Error("Plugin install destination resolves outside the project.");
+      throw new Error("Plugin install destination resolves outside the book folder.");
     }
     try {
       await lstat2(finalRoot);
@@ -11466,7 +11466,7 @@ function indexOfUse(seq, use) {
 function manifestPathFor(projectDir, abs) {
   const rel = path18.relative(path18.resolve(projectDir), abs).split(path18.sep).join("/");
   if (rel === "") {
-    throw new Error("An extension cannot be the project folder itself.");
+    throw new Error("An extension cannot be the book folder itself.");
   }
   if (isPathSpecifier(rel))
     return rel;

package/dist/{cli-wmvvkwcc.js → cli-rra50cp6.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-ersw5g7j.js";
+} from "./cli-5c2xfsmz.js";
 import {
   execCapture,
   findTool,

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
+} from "./cli-5c2xfsmz.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,16 +18,16 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-nxxx2mv2.js").then((m) => m.default),
-  preview: () => import("./preview-j59b5hg3.js").then((m) => m.default),
-  build: () => import("./build-2gjr2rj6.js").then((m) => m.default),
-  publish: () => import("./publish-mzct8ggw.js").then((m) => m.default),
-  lint: () => import("./lint-0pfqbs5r.js").then((m) => m.default),
-  validate: () => import("./validate-z2drbha6.js").then((m) => m.default),
-  audit: () => import("./audit-fdba6axw.js").then((m) => m.default),
-  preflight: () => import("./preflight-g7xjme17.js").then((m) => m.default),
-  doctor: () => import("./doctor-vgarhrsg.js").then((m) => m.default),
-  ext: () => import("./ext-hb5k5gga.js").then((m) => m.default)
+  new: () => import("./new-r3s74yfv.js").then((m) => m.default),
+  preview: () => import("./preview-aprv0c49.js").then((m) => m.default),
+  build: () => import("./build-8gx90w22.js").then((m) => m.default),
+  publish: () => import("./publish-4y1kztbd.js").then((m) => m.default),
+  lint: () => import("./lint-vyxf5zmw.js").then((m) => m.default),
+  validate: () => import("./validate-sf6hga9e.js").then((m) => m.default),
+  audit: () => import("./audit-t4r954ff.js").then((m) => m.default),
+  preflight: () => import("./preflight-j9e9m4ea.js").then((m) => m.default),
+  doctor: () => import("./doctor-b1awtn7m.js").then((m) => m.default),
+  ext: () => import("./ext-mxxz3p8t.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -52,7 +52,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-nxxx2mv2.js");
+      const { newArgs } = await import("./new-r3s74yfv.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -64,7 +64,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-g7xjme17.js");
+      const { preflightArgs } = await import("./preflight-j9e9m4ea.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -84,7 +84,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-hb5k5gga.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-mxxz3p8t.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-vgarhrsg.js → doctor-b1awtn7m.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
+} from "./cli-5c2xfsmz.js";
 import"./cli-c41yr7he.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";

package/dist/{engine-w5ed5hmb.js → engine-15dfcy85.js}

@@ -1,13 +1,13 @@
 import {
   build
-} from "./index-12pvhbyz.js";
+} from "./index-yeej2vhs.js";
 import {
   BuildError,
   RENDER_TIMEOUT_MS,
   assertMilestone,
   connectChromium,
   getBrowser
-} from "./index-6n15e1ze.js";
+} from "./index-gf1shk3y.js";
 import"./index-37x76zdn.js";
 
 // src/lib/engine.ts

package/dist/{engine-cbc17ne4.js → engine-amxqsfka.js}

@@ -4,7 +4,7 @@ import {
   build,
   connectChromium,
   getBrowser
-} from "./cli-sekhwex4.js";
+} from "./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError

package/dist/{ext-hb5k5gga.js → ext-mxxz3p8t.js}

@@ -10,21 +10,21 @@ import {
   removeExtension,
   searchNpmExtensions,
   setExtensionEnabled
-} from "./cli-7k2v2sya.js";
-import"./cli-wmvvkwcc.js";
+} from "./cli-g6vshy3f.js";
+import"./cli-rra50cp6.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 
@@ -92,12 +92,12 @@ async function requireProjectDir(dir, verb) {
     info = await stat(projectDir);
   } catch (error) {
     if (error.code === "ENOENT") {
-      throw new UsageError(`Project directory does not exist: ${projectDir}`);
+      throw new UsageError(`Book folder does not exist: ${projectDir}`);
     }
     throw error;
   }
   if (!info.isDirectory()) {
-    throw new UsageError(`Project path is not a directory: ${projectDir}`);
+    throw new UsageError(`Book path is not a folder: ${projectDir}`);
   }
   return projectDir;
 }

package/dist/{gutterpress-viewer-k0xrt5hw.js → gutterpress-viewer-swz6bwfa.js}

@@ -65,7 +65,26 @@
   overflow: auto;
   /* Standalone pages use \`--gutterpress-fit-zoom\`; embedded previews use the
      host-owned \`--gutterpress-zoom\`. fitZoom() guarantees only one is active. */
-  zoom: calc(var(--gutterpress-zoom, 1) * var(--gutterpress-fit-zoom, 1));
+  --gp-zoom: calc(var(--gutterpress-zoom, 1) * var(--gutterpress-fit-zoom, 1));
+  /* Zoom is a pure paint transform, NEVER CSS \`zoom\`. \`zoom\` changes layout
+     inputs (font sizes and lengths are scaled before text shaping and
+     LayoutUnit snapping), so Chromium's column fragmentation broke lines at
+     different points per zoom level: in the user guide a paragraph sat on
+     page 6 at 50% and page 7 at 25%, and the same book paginated differently
+     at 25/50/75/100/150% (#318). \`transform\` leaves layout untouched, so the
+     pages are the ones print produces at every zoom.
+     Layout width is the visible width / zoom, which is what \`zoom\` gave.
+     A transform does not shrink the parent's layout box, so a scaled-down
+     stage would leave dead scroll space below it. Taking the stage out of
+     flow makes the viewport's scrollable overflow exactly its transformed
+     extent, as \`zoom\` had it. */
+  position: absolute;
+  top: 0;
+  left: 0;
+  box-sizing: border-box;
+  width: calc(100% / var(--gp-zoom));
+  transform: scale(var(--gp-zoom));
+  transform-origin: 0 0;
 }
 
 /* One flow strip per named-page run. Chromium fragments its content into
@@ -281,7 +300,9 @@
     background: none;
     padding: 0;
     overflow: visible;
-    zoom: 1;
+    position: static;
+    width: auto;
+    transform: none;
   }
   .gp-layer,
   .gp-warning,
@@ -1565,7 +1586,8 @@
     return stripMetrics(strip).stride;
   }
   function cssZoomOf(el) {
-    return el.currentCSSZoom ?? 1;
+    const stage = el.closest(".gp-stage") ?? document.body;
+    return new DOMMatrixReadOnly(getComputedStyle(stage).transform).a || 1;
   }
   function stripMetrics(strip) {
     const cs = getComputedStyle(strip);

package/dist/{index-nmykzwb4.js → index-0h00ve4y.js}

@@ -18,7 +18,7 @@ import {
   resolveChromiumExecutable,
   run,
   spawnCapture
-} from "./index-6n15e1ze.js";
+} from "./index-gf1shk3y.js";
 import {
   errorLogData,
   gitFs,
@@ -31,7 +31,7 @@ import {
   snapshotStagingMarkerPath,
   snapshotWorkingTreeUnlocked,
   withRepoLock
-} from "./index-c5ev4r1y.js";
+} from "./index-8xkw284t.js";
 import {
   detectProjectSource,
   repoSubPath,
@@ -434,7 +434,7 @@ async function resolveVendoredPluginInstallRoot(projectDir, expectedName, expect
     realpath(requestedInstallRoot)
   ]);
   if (!isContained(realProjectRoot, installRoot)) {
-    throw new Error("Vendor install root resolves outside the project.");
+    throw new Error("Vendor install root resolves outside the book folder.");
   }
   return installRoot;
 }
@@ -1224,13 +1224,13 @@ var MSG_SYNCED = "Your changes are online.";
 var MSG_SYNCED_MERGED = "Your changes are online, combined with changes from the online copy.";
 var MSG_OFFLINE = "Your changes are saved on this computer. gutterpress couldn't reach the online repository — try syncing again when you're back online.";
 var MSG_AUTH = "The online repository didn't accept the saved connection. Reconnect and try again.";
-var MSG_INSECURE_TRANSPORT = "This project's online address isn't secure, so the saved connection wasn't sent — connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to sync.";
+var MSG_INSECURE_TRANSPORT = "This book's online address isn't secure, so the saved connection wasn't sent — connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to sync.";
 var MSG_BUSY = "The online copy is changing very quickly right now. Your work is saved on this computer — try Sync again in a moment.";
-var MSG_HISTORY_UNREADABLE = "This project's version history can't be read, so syncing can't continue. Your writing is safe — every file is still here on this computer. To get history and syncing working again, download a fresh copy of the project from online, then move any recent changes into it.";
-var MSG_UNRELATED = "This project and the online copy have no history in common, so they can't be combined. Either the online address points at a different project, or this project's own history was lost and started over. Your writing is safe — every file is still here on this computer. Check the online address; if it is correct, download a fresh copy from online and move any recent changes into it.";
-var MSG_NO_REMOTE = "This project isn't connected to an online repository yet.";
-var MSG_SSH_REMOTE = "This project's online address uses SSH (git@…), which gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
-var MSG_NO_BRANCH = "This project's version history isn't on a named branch, so it can't be synced right now.";
+var MSG_HISTORY_UNREADABLE = "This book's version history can't be read, so syncing can't continue. Your writing is safe — every file is still here on this computer. To get history and syncing working again, download a fresh copy of the book from online, then move any recent changes into it.";
+var MSG_UNRELATED = "This book and the online copy have no history in common, so they can't be combined. Either the online address points at a different book, or this book's own history was lost and started over. Your writing is safe — every file is still here on this computer. Check the online address; if it is correct, download a fresh copy from online and move any recent changes into it.";
+var MSG_NO_REMOTE = "This book isn't connected to an online repository yet.";
+var MSG_SSH_REMOTE = "This book's online address uses SSH (git@…), which gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
+var MSG_NO_BRANCH = "This book's version history isn't on a named branch, so it can't be synced right now.";
 var SYNC_SNAPSHOT_MESSAGE = "Automatic backup of your work";
 var SYNC_LATE_EDIT_MESSAGE = "Saved the edit you made while syncing";
 function onlineSiblingPath(filepath) {
@@ -3368,12 +3368,12 @@ function escapesProjectRoot(projectDir, absPath) {
 function proseImageRefError(ref, projectDir) {
   const cleaned = stripUrlSuffix(decodeRef(ref));
   if (/^file:/i.test(cleaned) || path3.isAbsolute(cleaned)) {
-    return `Image reference must be relative to the project: ${ref}
-` + `  Copy the file into your project folder and reference it from there.`;
+    return `Image reference must be relative to the book folder: ${ref}
+` + `  Copy the file into your book folder and reference it from there.`;
   }
   if (escapesProjectRoot(projectDir, path3.resolve(projectDir, cleaned))) {
-    return `Image reference points outside the project: ${ref}
-` + `  Copy the file into your project folder and reference it from there.`;
+    return `Image reference points outside the book folder: ${ref}
+` + `  Copy the file into your book folder and reference it from there.`;
   }
   return null;
 }
@@ -3445,7 +3445,7 @@ async function inlineOne(cssPath, copies, warnings, seen) {
   if (seen.has(abs))
     return "";
   seen.add(abs);
-  const source = await readOrThrow(abs, "stylesheet", "the project manifest");
+  const source = await readOrThrow(abs, "stylesheet", "the book manifest");
   const cssDir = path3.dirname(abs);
   let root;
   try {
@@ -4875,7 +4875,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.6-alpha.2",
+  version: "0.11.6-alpha.3",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -5329,7 +5329,7 @@ async function uncommittedAmong(inputDir, files) {
 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.");
+    log.warn("--fix: source.markdownlint is disabled for this book — no files were fixed.");
     return [];
   }
   const files = ctx.markdownFiles;
@@ -7760,7 +7760,7 @@ var check25 = {
         results.push(finding(check25.id, {
           severity: "warning",
           code: "kept-both-versions",
-          message: `Two versions of ${withoutOnlineTag(rel)} are in your project — keep the one you want, then delete the other.`,
+          message: `Two versions of ${withoutOnlineTag(rel)} are in your book — keep the one you want, then delete the other.`,
           file: sibling
         }));
       }
@@ -9031,7 +9031,7 @@ async function resolveBuildContext(opts) {
   const inputDir = path9.resolve(opts.inputDir);
   const { manifest, manifestDir, manifestPath } = await loadManifestWithPath(opts.manifestPath ?? inputDir, { explicit: opts.manifestPath !== undefined });
   if (manifestPath === null) {
-    throw new UsageError(`No project manifest found in ${inputDir}. Looked for ${MANIFEST_FILENAMES.join(" or ")}. ` + "Run from your project folder or pass that folder with `gutterpress build <project-dir>`. " + "For a custom manifest filename, pass `--manifest <path>`.");
+    throw new UsageError(`No book manifest found in ${inputDir}. Looked for ${MANIFEST_FILENAMES.join(" or ")}. ` + "Run from your book folder or pass that folder with `gutterpress build <book-dir>`. " + "For a custom manifest filename, pass `--manifest <path>`.");
   }
   const pdfxConfigOverride = format === "pdfx" ? {
     flavor: opts.pdfxFlavor,
@@ -9258,7 +9258,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path9.join(stage, "raw.pdf") : path9.resolve(pdfFile);
       await fsp2.mkdir(path9.dirname(path9.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-w5ed5hmb.js");
+      const { buildNativePdf } = await import("./engine-15dfcy85.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -11066,7 +11066,7 @@ function resolveScaffoldTargets(requested, preset) {
 async function scaffoldProject(options) {
   const name = (options.name ?? "").trim();
   if (!name) {
-    throw new CreateProjectErrorImpl("invalid-name", "A project name is required.");
+    throw new CreateProjectErrorImpl("invalid-name", "A book name is required.");
   }
   const slug = slugifyProjectName(name);
   const folderName = (options.folderName ?? slug).trim();
@@ -11116,7 +11116,7 @@ async function scaffoldProject(options) {
       await writeFile8(path16.join(projectDir, "styles", "book.css"), starterOverridesCss(), "utf8");
     }
   } catch (e) {
-    throw new CreateProjectErrorImpl("scaffold-io", `Could not create the project files: ${e instanceof Error ? e.message : String(e)}`);
+    throw new CreateProjectErrorImpl("scaffold-io", `Could not create the book files: ${e instanceof Error ? e.message : String(e)}`);
   }
   try {
     await ensureGitignoreHasDist(projectDir);
@@ -11153,14 +11153,14 @@ async function scaffoldProject(options) {
       openFile = path16.join(projectDir, firstSource);
     await fillTemplateFile(openFile, { "{{TITLE}}": name }).catch(() => {});
   } catch (e) {
-    throw new CreateProjectErrorImpl("scaffold-io", `Could not finalise the project files: ${e instanceof Error ? e.message : String(e)}`);
+    throw new CreateProjectErrorImpl("scaffold-io", `Could not finalize the book files: ${e instanceof Error ? e.message : String(e)}`);
   }
   const requested = options.versionHistory ?? "local-git";
   let versionHistory = "none";
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-a458mmec.js");
+      const { providerFor } = await import("./source-provider-y9ktprbx.js");
       const provider = providerFor({ type: "local-folder", path: projectDir });
       await provider.initVersionHistory({
         projectDir,
@@ -11205,7 +11205,7 @@ async function adoptFolder(options) {
     throw new CreateProjectErrorImpl("scaffold-io", `Not a folder: ${dir}`);
   }
   if (MANIFEST_FILENAMES.some((name) => existsSync12(path16.join(dir, name)))) {
-    throw new CreateProjectErrorImpl("target-exists", "This folder is already a Gutterpress project.");
+    throw new CreateProjectErrorImpl("target-exists", "This folder is already a Gutterpress book.");
   }
   const template = options.template ?? "book";
   const title = (options.title ?? "").trim() || prettifyFolderName(path16.basename(dir));
@@ -11252,7 +11252,7 @@ styles:
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-a458mmec.js");
+      const { providerFor } = await import("./source-provider-y9ktprbx.js");
       const provider = providerFor({ type: "local-folder", path: dir });
       await provider.initVersionHistory({
         projectDir: dir,
@@ -12301,7 +12301,7 @@ async function prepareVendorParent(projectDir, name) {
     realpath2(packageParent)
   ]);
   if (!isContained2(projectDir, realNpm) || !isContained2(projectDir, realPackageParent)) {
-    throw new Error("Plugin install path resolves outside the project.");
+    throw new Error("Plugin install path resolves outside the book folder.");
   }
   return realNpm;
 }
@@ -12383,7 +12383,7 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
     finalRoot = vendoredNpmPluginRoot(projectDir, rootRecord.name, rootRecord.version);
     const realFinalParent = await realpath2(path19.dirname(finalRoot));
     if (!isContained2(projectDir, realFinalParent)) {
-      throw new Error("Plugin install destination resolves outside the project.");
+      throw new Error("Plugin install destination resolves outside the book folder.");
     }
     try {
       await lstat2(finalRoot);
@@ -12523,7 +12523,7 @@ function indexOfUse(seq, use) {
 function manifestPathFor(projectDir, abs) {
   const rel = path20.relative(path20.resolve(projectDir), abs).split(path20.sep).join("/");
   if (rel === "") {
-    throw new Error("An extension cannot be the project folder itself.");
+    throw new Error("An extension cannot be the book folder itself.");
   }
   if (isPathSpecifier(rel))
     return rel;
@@ -14449,7 +14449,7 @@ async function assertCloneTarget(dir) {
   try {
     const entries = await readdir9(dir);
     if (entries.length > 0) {
-      throw new Error("That folder already has files in it. Choose an empty folder for the project.");
+      throw new Error("That folder already has files in it. Choose an empty folder for the book.");
     }
   } catch (e) {
     if (e.code === "ENOENT")
@@ -14474,7 +14474,7 @@ function friendlyCloneError(e) {
   if (e instanceof Error && /already has files/i.test(e.message)) {
     return e;
   }
-  return new Error("The project couldn't be downloaded from GitHub. Please try again.", { cause: e });
+  return new Error("The book couldn't be downloaded from GitHub. Please try again.", { cause: e });
 }
 async function cloneRepository(options) {
   const { dir, onProgress, tokenStore } = options;
@@ -14550,7 +14550,7 @@ var FAILURE_MESSAGES = {
   auth: "The Git server didn't accept the saved connection. Reconnect to this server with a current access token and try again.",
   "not-found": "The server answered, but no repository was found at that address. It may have been moved, renamed, or you may no longer have access.",
   unreachable: "Couldn't reach the Git server. Check your internet connection (and VPN, if this is a private server), then try again.",
-  "ssh-unsupported": "This project's online address uses SSH (git@…), which gutterpress can't check or sync with. Everything on this computer still works — sync with your usual Git tool.",
+  "ssh-unsupported": "This book's online address uses SSH (git@…), which gutterpress can't check or sync with. Everything on this computer still works — sync with your usual Git tool.",
   "insecure-transport": "This address isn't secure, so the saved connection wasn't sent — connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to use a saved connection.",
   tls: "The server's security certificate couldn't be verified. If this is a private server with its own certificate, ask its administrator about trusting it (NODE_EXTRA_CA_CERTS).",
   unknown: "The connection test failed unexpectedly. The server may not be a Git server, or it may be temporarily unavailable."
@@ -15237,7 +15237,7 @@ async function syncProject(options) {
         if (setupMsg)
           return { status: "error", message: setupMsg, ...base() };
         if (await historyUnreadable(dir)) {
-          logger.error("sync", "the project's history could not be read");
+          logger.error("sync", "the book's history could not be read");
           return { status: "error", message: MSG_HISTORY_UNREADABLE, ...base() };
         }
         return { ...failureOutcome(e, snapshotId), ...filesChanged ? { filesChanged: true } : {} };

package/dist/{index-c5ev4r1y.js → index-8xkw284t.js}

@@ -349,7 +349,7 @@ class LocalFolderSourceProvider {
   async initVersionHistory(options) {
     const dir = options.projectDir;
     if (await findEnclosingRepoDir(dir) !== undefined) {
-      throw new Error("This folder is already inside a versioned project, so gutterpress " + "won't create a separate history here.");
+      throw new Error("This folder is already inside a versioned book, so gutterpress " + "won't create a separate history here.");
     }
     return withRepoLock(dir, async () => {
       const cache = {};
@@ -373,7 +373,7 @@ class LocalFolderSourceProvider {
     });
   }
   snapshot() {
-    return Promise.reject(new Error("This project has no version history yet. Enable version history first."));
+    return Promise.reject(new Error("This book has no version history yet. Enable version history first."));
   }
   listHistory() {
     return Promise.resolve([]);
@@ -382,7 +382,7 @@ class LocalFolderSourceProvider {
     return Promise.resolve({ entries: [], hasMore: false });
   }
   restore() {
-    return Promise.reject(new Error("This project has no version history yet. Enable version history first."));
+    return Promise.reject(new Error("This book has no version history yet. Enable version history first."));
   }
 }
 
@@ -528,7 +528,7 @@ function providerFor(source) {
     case "local-git-folder":
       return new LocalGitSourceProvider(source);
     case "managed-github":
-      throw new Error("Managed GitHub projects are not supported yet (#15/#16).");
+      throw new Error("Managed GitHub books are not supported yet (#15/#16).");
   }
 }
 function gitDirFor(projectDir) {
@@ -543,7 +543,7 @@ async function restoreVersionWithBackup(options) {
   const { projectDir, id, authorName, authorEmail } = options;
   const source = await detectProjectSource(projectDir);
   if (source.type !== "local-git-folder") {
-    throw new Error("This project has no version history yet. Enable version history first.");
+    throw new Error("This book has no version history yet. Enable version history first.");
   }
   const provider = new LocalGitSourceProvider(source);
   const repoDir = gitScopeFor(source);
@@ -561,7 +561,7 @@ async function restoreVersionWithBackup(options) {
     try {
       await provider.restoreUnlocked({ projectDir, id });
     } catch (cause) {
-      throw new Error(backupId ? "The restore could not be completed, but your work is safe — it was " + `automatically saved as a backup snapshot (${backupId.slice(0, 7)}) ` + "and appears in your version history." : "The restore could not be completed. Your project files were not changed.", { cause });
+      throw new Error(backupId ? "The restore could not be completed, but your work is safe — it was " + `automatically saved as a backup snapshot (${backupId.slice(0, 7)}) ` + "and appears in your version history." : "The restore could not be completed. Your book files were not changed.", { cause });
     }
     return { restoredId: id, backupId };
   });
@@ -648,7 +648,7 @@ async function switchBranch(options) {
   const { projectDir, branch, authorName, authorEmail } = options;
   const source = await detectProjectSource(projectDir);
   if (source.type !== "local-git-folder") {
-    throw new Error("This project has no version history yet. Enable version history first.");
+    throw new Error("This book has no version history yet. Enable version history first.");
   }
   const repoDir = gitScopeFor(source);
   return withRepoLock(repoDir, async () => {

package/dist/{index-6n15e1ze.js → index-gf1shk3y.js}

@@ -608,7 +608,7 @@ var preview_shell_default = "./preview-shell-gqnc5xxe.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-k0xrt5hw.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-swz6bwfa.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

package/dist/{index-12pvhbyz.js → index-yeej2vhs.js}

@@ -4,7 +4,7 @@ import {
   launchChromium,
   marginBoxAlign,
   marginBoxRectPt
-} from "./index-6n15e1ze.js";
+} from "./index-gf1shk3y.js";
 
 // src/engine/compiler/build.ts
 import { readFile } from "node:fs/promises";
@@ -1985,7 +1985,7 @@ ${mapCss}`;
       if (layerTraps.length)
         log(`audit: ${layerTraps.length} trapped layer warning(s)`);
       for (const hit of pageBackgrounds)
-        diagnose("engine.page-background.unreferenced", `"${hit.url}" is only referenced from "${hit.where}", and Chromium will not print an image referenced nowhere else — the page prints with its background colour alone, with no error. Gutterpress stages and preloads every image your project stylesheets reference, so this one is outside that: it is remote (a url(https://...), which is never staged), or it comes from CSS that does not pass through your stylesheets, or an element in the document uses the same URL as its src, which drops it on its own. Use a local image, referenced from one of your project stylesheets, and not also used as an <img>.`);
+        diagnose("engine.page-background.unreferenced", `"${hit.url}" is only referenced from "${hit.where}", and Chromium will not print an image referenced nowhere else — the page prints with its background color alone, with no error. Gutterpress stages and preloads every image your book's stylesheets reference, so this one is outside that: it is remote (a url(https://...), which is never staged), or it comes from CSS that does not pass through your stylesheets, or an element in the document uses the same URL as its src, which drops it on its own. Use a local image, referenced from one of your book's stylesheets, and not also used as an <img>.`);
       if (pageBackgrounds.length)
         log(`audit: ${pageBackgrounds.length} unreferenced @page background image(s)`);
       for (const d of multicol)

package/dist/index.js

@@ -143,15 +143,15 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "./index-nmykzwb4.js";
+} from "./index-0h00ve4y.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-12pvhbyz.js";
+} from "./index-yeej2vhs.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "./index-6n15e1ze.js";
+} from "./index-gf1shk3y.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -163,7 +163,7 @@ import {
   resolveLogger,
   restoreVersionWithBackup,
   switchBranch
-} from "./index-c5ev4r1y.js";
+} from "./index-8xkw284t.js";
 import {
   capabilitiesFor,
   detectProjectSource,

package/dist/lib/remote-auth/sync-messages.d.ts

@@ -10,19 +10,19 @@ export declare const MSG_SYNCED = "Your changes are online.";
 export declare const MSG_SYNCED_MERGED = "Your changes are online, combined with changes from the online copy.";
 export declare const MSG_OFFLINE = "Your changes are saved on this computer. gutterpress couldn't reach the online repository \u2014 try syncing again when you're back online.";
 export declare const MSG_AUTH = "The online repository didn't accept the saved connection. Reconnect and try again.";
-export declare const MSG_INSECURE_TRANSPORT = "This project's online address isn't secure, so the saved connection wasn't sent \u2014 connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to sync.";
+export declare const MSG_INSECURE_TRANSPORT = "This book's online address isn't secure, so the saved connection wasn't sent \u2014 connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to sync.";
 export declare const MSG_BUSY = "The online copy is changing very quickly right now. Your work is saved on this computer \u2014 try Sync again in a moment.";
 /**
- * The project's own version history is unreadable — a damaged or missing
+ * The book's own version history is unreadable — a damaged or missing
  * `.git`. Says the three things that are actually true and useful: the writing
  * is safe, the HISTORY is what broke, and (sync always has a remote, so this
  * always applies here) a fresh copy from online is the way back.
  */
-export declare const MSG_HISTORY_UNREADABLE = "This project's version history can't be read, so syncing can't continue. Your writing is safe \u2014 every file is still here on this computer. To get history and syncing working again, download a fresh copy of the project from online, then move any recent changes into it.";
-export declare const MSG_UNRELATED = "This project and the online copy have no history in common, so they can't be combined. Either the online address points at a different project, or this project's own history was lost and started over. Your writing is safe \u2014 every file is still here on this computer. Check the online address; if it is correct, download a fresh copy from online and move any recent changes into it.";
-export declare const MSG_NO_REMOTE = "This project isn't connected to an online repository yet.";
-export declare const MSG_SSH_REMOTE = "This project's online address uses SSH (git@\u2026), which gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
-export declare const MSG_NO_BRANCH = "This project's version history isn't on a named branch, so it can't be synced right now.";
+export declare const MSG_HISTORY_UNREADABLE = "This book's version history can't be read, so syncing can't continue. Your writing is safe \u2014 every file is still here on this computer. To get history and syncing working again, download a fresh copy of the book from online, then move any recent changes into it.";
+export declare const MSG_UNRELATED = "This book and the online copy have no history in common, so they can't be combined. Either the online address points at a different book, or this book's own history was lost and started over. Your writing is safe \u2014 every file is still here on this computer. Check the online address; if it is correct, download a fresh copy from online and move any recent changes into it.";
+export declare const MSG_NO_REMOTE = "This book isn't connected to an online repository yet.";
+export declare const MSG_SSH_REMOTE = "This book's online address uses SSH (git@\u2026), which gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
+export declare const MSG_NO_BRANCH = "This book's version history isn't on a named branch, so it can't be synced right now.";
 /** Message recorded on the automatic pre-sync snapshot (D5 invariant).
  *  Pre-0.10.1 history carries the old spelling "Snapshot before syncing". */
 export declare const SYNC_SNAPSHOT_MESSAGE = "Automatic backup of your work";

package/dist/{lint-0pfqbs5r.js → lint-vyxf5zmw.js}

@@ -1,21 +1,21 @@
 import {
   MANIFEST_FILENAMES,
   runLint
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{new-nxxx2mv2.js → new-r3s74yfv.js}

@@ -7,23 +7,23 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   resolveGhostscript
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import {
   isToolAvailable
 } from "./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 
@@ -252,7 +252,7 @@ var new_default = defineCommand({
         versionHistory: args.git === false ? "none" : "local-git"
       });
       const effectiveTargets = targets ?? [...PRESETS[preset].defaultTargets];
-      console.log(`Created project: ${result.projectDir}`);
+      console.log(`Created book: ${result.projectDir}`);
       console.log(`  manifest: ${result.manifestPath}`);
       console.log(`  publish targets: ${effectiveTargets.length > 0 ? effectiveTargets.join(", ") : "none"}`);
       console.log(`  start writing in: ${result.openFile}`);
@@ -282,7 +282,7 @@ var new_default = defineCommand({
     } catch (e) {
       const err = e;
       const code = err && typeof err.code === "string" ? err.code : "scaffold-io";
-      console.error(`Could not create project: ${err?.message ?? String(e)}`);
+      console.error(`Could not create book: ${err?.message ?? String(e)}`);
       process.exit(code === "scaffold-io" ? EXIT_CODES.PIPELINE : EXIT_CODES.USAGE);
     }
   }

package/dist/{preflight-g7xjme17.js → preflight-j9e9m4ea.js}

@@ -2,21 +2,21 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{preview-j59b5hg3.js → preview-aprv0c49.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   parseFormat,
@@ -17,13 +17,13 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 
@@ -49,7 +49,7 @@ var preview_default = defineCommand({
       const openFlag = args.open;
       if (format === "html") {
         if (typeof args.manifest === "string") {
-          throw new UsageError("--manifest is only supported by preview --format pdf or pdfx; live HTML preview discovers the project manifest from its input directory.");
+          throw new UsageError("--manifest is only supported by preview --format pdf or pdfx; live HTML preview discovers the book manifest from its input directory.");
         }
         await startPreviewServer({
           input: inputPath,

package/dist/{publish-mzct8ggw.js → publish-4y1kztbd.js}

@@ -11,22 +11,22 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   FileTokenStore,
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 
@@ -251,7 +251,7 @@ Create one at: ${provider.info.credential.tokenUrl}` : ""));
         log.error(e instanceof Error ? e.message : String(e));
         process.exit(e instanceof UsageError ? e.exitCode : EXIT_CODES.FINDINGS);
       }
-      log.success(`Connected ${provider.info.label}${account ? ` (${account})` : ""}. The key is stored in your user config, not the project.`);
+      log.success(`Connected ${provider.info.label}${account ? ` (${account})` : ""}. The key is stored in your user config, not the book.`);
       return;
     }
     let result;

package/dist/{source-provider-54a52bpd.js → source-provider-exy1wakv.js}

@@ -19,7 +19,7 @@ import {
   stageChanges,
   switchBranch,
   withRepoLock
-} from "./cli-c9h2bk2k.js";
+} from "./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 export {

package/dist/{source-provider-a458mmec.js → source-provider-y9ktprbx.js}

@@ -19,7 +19,7 @@ import {
   stageChanges,
   switchBranch,
   withRepoLock
-} from "./index-c5ev4r1y.js";
+} from "./index-8xkw284t.js";
 import"./index-v5mp7a6q.js";
 import"./index-37x76zdn.js";
 export {

package/dist/{validate-z2drbha6.js → validate-sf6hga9e.js}

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-7k2v2sya.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-5c2xfsmz.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-c5360prx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.6-alpha.2",
+  "version": "0.11.6-alpha.3",
   "description": "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",