gutterpress 0.11.6-alpha.1 → 0.11.6-alpha.3

package/dist/api/index.js

@@ -124,12 +124,12 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-cwhgq7tq.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-bhxh0bbf.js → audit-t4r954ff.js}

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-q696mp75.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-jp97snns.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cghcd60p.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-sqdahz2j.js → build-8gx90w22.js}

@@ -1,23 +1,23 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-q696mp75.js";
+} from "./cli-g6vshy3f.js";
 import {
   log
-} from "./cli-jp97snns.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cghcd60p.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-cghcd60p.js → cli-5c2xfsmz.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.6-alpha.1",
+  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-q696mp75.js → cli-g6vshy3f.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-jp97snns.js";
+} from "./cli-rra50cp6.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-cghcd60p.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 {
@@ -5836,7 +5836,7 @@ async function loadNpmPackage(packageName, baseDir, version) {
   } catch {}
   const looksLikeJsFilename = /\.(m?js|cjs)$/i.test(packageName);
   const suggestedPath = looksLikeJsFilename ? `./${packageName}` : `./plugins/${packageName}.js`;
-  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${packageName}\` (or Project settings > Extensions),
+  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${packageName}\` (or Book settings > Features > Advanced in the desktop app),
 or reference a local file under \`extensions:\`:
   extensions:
     - ${suggestedPath}`);
@@ -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);
@@ -11376,27 +11376,27 @@ var RECOMMENDED_EXTENSIONS = [
   {
     use: "markdown-it-mark",
     label: "Highlight",
-    description: "Highlighted text with `==marked==` -> `<mark>`."
+    description: "Highlight text by wrapping it in `==double equals==`."
   },
   {
     use: "markdown-it-sub",
     label: "Subscript",
-    description: "Subscript text with `H~2~O`."
+    description: "Lower text below the line, like the 2 in `H~2~O`."
   },
   {
     use: "markdown-it-sup",
     label: "Superscript",
-    description: "Superscript text with `29^th^`."
+    description: "Raise text above the line, like the th in `29^th^`."
   },
   {
     use: "markdown-it-abbr",
     label: "Abbreviations",
-    description: "Define `*[HTML]: Hyper Text...` and get `<abbr>` tooltips."
+    description: "Explain an abbreviation when readers hover over it. Define it once, like `*[GPS]: Global Positioning System`."
   },
   {
     use: "gutterpress-gfm-alerts",
     label: "Callouts",
-    description: "GitHub-style `> [!NOTE]` alert boxes (Note/Tip/Important/Warning/Caution)."
+    description: "Turn a quote into a boxed note: start it with `> [!NOTE]` (or `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`)."
   }
 ];
 var BUILT_IN_STYLE_SET_IDS = ["clean-book", "zine", "technical-doc"];
@@ -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-jp97snns.js → cli-rra50cp6.js}

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

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-cghcd60p.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-s256mmkt.js").then((m) => m.default),
-  preview: () => import("./preview-j2rvdhg1.js").then((m) => m.default),
-  build: () => import("./build-sqdahz2j.js").then((m) => m.default),
-  publish: () => import("./publish-6px5snad.js").then((m) => m.default),
-  lint: () => import("./lint-t0tj3psc.js").then((m) => m.default),
-  validate: () => import("./validate-f0m0d2zs.js").then((m) => m.default),
-  audit: () => import("./audit-bhxh0bbf.js").then((m) => m.default),
-  preflight: () => import("./preflight-5y10233n.js").then((m) => m.default),
-  doctor: () => import("./doctor-gj8gtgec.js").then((m) => m.default),
-  ext: () => import("./ext-xhtta4bh.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-s256mmkt.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-5y10233n.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-xhtta4bh.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-gj8gtgec.js → doctor-b1awtn7m.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-jp97snns.js";
+} from "./cli-rra50cp6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cghcd60p.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-xhtta4bh.js → ext-mxxz3p8t.js}

@@ -10,21 +10,21 @@ import {
   removeExtension,
   searchNpmExtensions,
   setExtensionEnabled
-} from "./cli-q696mp75.js";
-import"./cli-jp97snns.js";
+} from "./cli-g6vshy3f.js";
+import"./cli-rra50cp6.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-cghcd60p.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);