gutterpress 0.11.6-alpha.2 → 0.11.6-alpha.4

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

@@ -7,7 +7,6 @@ import {
   BUILT_IN_STYLE_SET_IDS,
   BUILT_IN_TEMPLATE_IDS,
   BUNDLED_EXTENSIONS,
-  DEFAULT_NPM_REGISTRY,
   EXTENSIONS_DIR,
   EXTENSION_KINDS,
   EXTENSION_MANIFEST_FILENAME,
@@ -19,7 +18,6 @@ import {
   GoogleAuthProvider,
   MANIFEST_FILENAMES,
   MAX_SEARCH_BYTES,
-  PLUGINS_DIR,
   PRESETS,
   PRESET_IDS,
   PublishSelectionsStore,
@@ -47,6 +45,7 @@ import {
   describeExtension,
   diagnoseProjectRemote,
   disconnectPublishCredential,
+  ensureGitignoreHasDist,
   escapeYamlScalar,
   executeAndReport,
   executeValidation,
@@ -86,7 +85,6 @@ import {
   loadManifestWithPath,
   loadPluginsWithCss,
   log,
-  npmRegistryUrl,
   openPath,
   parseExtensionSpecifier,
   parseRemoteOrigin,
@@ -143,27 +141,31 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "./index-nmykzwb4.js";
+} from "./index-ash0pvb9.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,
+  DEFAULT_NPM_REGISTRY,
   HISTORY_PAGE_LIMIT,
+  PLUGINS_DIR,
   RESTORE_BACKUP_MESSAGE,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
+  countUnversionedChanges,
   isNoChangesError,
   listLocalBranches,
+  npmRegistryUrl,
   providerFor,
   resolveLogger,
   restoreVersionWithBackup,
   switchBranch
-} from "./index-c5ev4r1y.js";
+} from "./index-7mqst9tg.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -354,12 +356,14 @@ export {
   executeValidation,
   executeAndReport,
   escapeYamlScalar,
+  ensureGitignoreHasDist,
   disconnectPublishCredential,
   diagnoseProjectRemote,
   detectProjectSource,
   describeExtension,
   deleteSnippet,
   defaultConfigDir,
+  countUnversionedChanges,
   connectPublishProvider,
   connectGoogleDrive,
   connectGenericHost,

package/dist/lib/project-scaffold.d.ts

@@ -151,3 +151,23 @@ export interface AdoptFolderOptions {
  * `styles/book.css`, `.gitignore`, or any markdown file.
  */
 export declare function adoptFolder(options: AdoptFolderOptions): Promise<CreateProjectResult>;
+/**
+ * Ensure `<projectDir>/.gitignore` excludes the build output directory
+ * (`dist/` — lib/output-paths.ts's `DIST_DIRNAME`).
+ *
+ * Confirmed bug this closes: no scaffolded project ever got a `.gitignore`,
+ * and gutterpress's auto-snapshot feature is ON BY DEFAULT and auto-pushes.
+ * Every `gutterpress build` writes a fresh, incompressible PDF (plus any copied
+ * assets) into `dist/<title-slug>/`; without an ignore rule, the very next
+ * snapshot commits and pushes it. That grows `.git` by a full PDF on every
+ * build and, once a single artifact crosses GitHub's 100MB per-file limit,
+ * the push is rejected outright — for a non-technical author with no way to
+ * `git filter-repo` their way out.
+ *
+ * NEVER overwrites an existing `.gitignore` (global never-delete-user-data
+ * rule): if the file already excludes `dist/` in some common spelling
+ * (`dist`, `dist/`, `/dist/`, …) it is left untouched; otherwise the line is
+ * APPENDED, not prepended or reformatted, so any content the author already
+ * has stays exactly as they wrote it.
+ */
+export declare function ensureGitignoreHasDist(projectDir: string): Promise<void>;

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/lib/source-provider.d.ts

@@ -190,6 +190,30 @@ export declare function snapshotWorkingTreeUnlocked(options: SnapshotOptions): P
  * swallow the expected clean-tree rejection without string-matching itself.
  */
 export declare function isNoChangesError(e: unknown): boolean;
+/** What "Save a version" would capture in the open book right now. */
+export interface UnversionedChanges {
+    /**
+     * Files of THIS book (its folder inside the repo) that changed since the
+     * last version — writer work only: app-written files (the vendored plugin
+     * folder and its install receipt) are not counted.
+     */
+    changedFiles: number;
+    /**
+     * A previous version attempt died after staging (its crash marker is still
+     * present), so the index may hold work HEAD doesn't have even when the
+     * working tree looks clean. The count can't be trusted to be 0 then.
+     */
+    stale: boolean;
+}
+/**
+ * How many files of the open book changed since the last version (snapshot).
+ * `null` when the project has no version history (a plain folder). Uses the
+ * same workdir-vs-index walk a snapshot uses to decide "nothing new to save".
+ * A book inside a larger repo (`subPath`) is counted on its own folder only.
+ * Queued behind the repo lock so it never reads the index mid-snapshot;
+ * otherwise a lock-free walk that reads no history.
+ */
+export declare function countUnversionedChanges(projectDir: string): Promise<UnversionedChanges | null>;
 /**
  * Select the {@link SourceProvider} implementation for a classified source.
  * `managed-github` (#15/#16) is not implemented yet — it throws if reached.

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

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

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

@@ -7,23 +7,23 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-7k2v2sya.js";
+} from "./cli-q4e99n20.js";
 import {
   resolveGhostscript
-} from "./cli-wmvvkwcc.js";
+} from "./cli-qt466d4e.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-a569p7v6.js";
+import"./cli-5vdgncmm.js";
 import {
   isToolAvailable
 } from "./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-4tx0szk7.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-fydrrjpz.js}

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

package/dist/{preview-j59b5hg3.js → preview-655bdb9g.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-7k2v2sya.js";
+} from "./cli-q4e99n20.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-qt466d4e.js";
 import {
   UsageError,
   parseFormat,
@@ -17,13 +17,13 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-a569p7v6.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-4tx0szk7.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-gz6re318.js}

@@ -11,22 +11,22 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-7k2v2sya.js";
+} from "./cli-q4e99n20.js";
 import {
   FileTokenStore,
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-qt466d4e.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-a569p7v6.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-4tx0szk7.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-gy3cn7kw.js}

@@ -4,6 +4,7 @@ import {
   RESTORE_BACKUP_MESSAGE,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
   __repoLockQueueSizeForTests,
+  countUnversionedChanges,
   gitDirFor,
   gitScopeFor,
   hasPendingChanges,
@@ -19,7 +20,7 @@ import {
   stageChanges,
   switchBranch,
   withRepoLock
-} from "./cli-c9h2bk2k.js";
+} from "./cli-4tx0szk7.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 export {
@@ -38,6 +39,7 @@ export {
   hasPendingChanges,
   gitScopeFor,
   gitDirFor,
+  countUnversionedChanges,
   __repoLockQueueSizeForTests,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
   RESTORE_BACKUP_MESSAGE,

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

@@ -4,6 +4,7 @@ import {
   RESTORE_BACKUP_MESSAGE,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
   __repoLockQueueSizeForTests,
+  countUnversionedChanges,
   gitDirFor,
   gitScopeFor,
   hasPendingChanges,
@@ -19,7 +20,7 @@ import {
   stageChanges,
   switchBranch,
   withRepoLock
-} from "./index-c5ev4r1y.js";
+} from "./index-7mqst9tg.js";
 import"./index-v5mp7a6q.js";
 import"./index-37x76zdn.js";
 export {
@@ -38,6 +39,7 @@ export {
   hasPendingChanges,
   gitScopeFor,
   gitDirFor,
+  countUnversionedChanges,
   __repoLockQueueSizeForTests,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
   RESTORE_BACKUP_MESSAGE,

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

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-7k2v2sya.js";
+} from "./cli-q4e99n20.js";
 import {
   log
-} from "./cli-wmvvkwcc.js";
+} from "./cli-qt466d4e.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ersw5g7j.js";
-import"./cli-sekhwex4.js";
+} from "./cli-a569p7v6.js";
+import"./cli-5vdgncmm.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-c9h2bk2k.js";
+import"./cli-4tx0szk7.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.4",
   "description": "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",