gutterpress 0.11.9-alpha.1 → 0.11.9-alpha.3

package/README.md

@@ -237,12 +237,12 @@ plus the PDF from the second — the pdf build never overwrites `book.html`.
 
 ### `gutterpress publish`
 
-Push a built PDF/HTML artifact to a publishing platform (itch.io, DriveThruRPG, Amazon KDP, Azure Static Web Apps, Shopify, Google Drive), headlessly and CI-safely. Credentials live in a 0600 user-config store (never in the project); provider env vars override it for CI. Most providers connect with a pasted API key; Google Drive connects through your browser instead (`--connect` opens the sign-in page — nothing to paste).
+Push a built PDF/HTML artifact to a publishing platform (itch.io, DriveThruRPG, Amazon KDP, Azure Static Web Apps, Shopify, Google Drive) or copy it to a local folder (`local`, the desktop's default first destination), headlessly and CI-safely. Credentials live in a 0600 user-config store (never in the project); provider env vars override it for CI. Most providers connect with a pasted API key; Google Drive connects through your browser instead (`--connect` opens the sign-in page — nothing to paste).
 
 ```sh
 gutterpress publish [project] [options]
 
-  --provider <id>     itch | drivethrurpg | kdp | azure-swa | shopify | gdrive
+  --provider <id>     local | itch | drivethrurpg | kdp | azure-swa | shopify | gdrive
   --list               List providers and connection status
   --connect            Store an API key for --provider (from --token, the provider's env var, or piped stdin) — or, for gdrive, open the browser to connect
   --disconnect         Forget the stored key for --provider

package/dist/api/index.js

@@ -124,12 +124,12 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-91k91awj.js";
+} from "../index-27xa2tfd.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-mks8j9av.js";
+} from "../index-t43k5rq1.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   DEFAULT_NPM_REGISTRY,

package/dist/{audit-ydxsev28.js → audit-z6hp3dep.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{build-xd4bjtbv.js → build-9ze0fcgq.js}

@@ -1,18 +1,18 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError

package/dist/{cli-h91e69hm.js → cli-d8rdk1y7.js}

@@ -1430,7 +1430,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-wkbm9cjn.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-hsn8rsgr.json";
+var manifest_schema_default = "./manifest.schema-61bsspsb.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-9rwz21yw.js";

package/dist/{cli-b4ramtgc.js → cli-edn2tver.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-cfymymkv.js";
+} from "./cli-ervhbr00.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
@@ -28,7 +28,7 @@ import {
   getAssetsDir,
   getBrowser,
   prewarmBrowser
-} from "./cli-h91e69hm.js";
+} from "./cli-d8rdk1y7.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -8193,7 +8193,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-w2m1jp4p.js");
+      const { buildNativePdf } = await import("./engine-qtfrfbpk.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -12989,6 +12989,54 @@ var kdpProvider = {
   }
 };
 
+// src/lib/publish/providers/local-folder.ts
+import { cp as cp5, mkdir as mkdir13, stat as stat9 } from "node:fs/promises";
+import path22 from "node:path";
+var LOCAL_PUBLISH_DEFAULT_DIR = "dist";
+var info7 = {
+  id: "local",
+  label: "A folder on this computer",
+  kind: "api",
+  format: "pdf",
+  formats: ["pdf", "html"],
+  description: "Save the finished file to a folder you choose.",
+  configFields: [
+    { key: "dir", label: "Folder", placeholder: LOCAL_PUBLISH_DEFAULT_DIR }
+  ],
+  credential: { required: false, host: "" }
+};
+function localPublishDir(req) {
+  const dir = typeof req.config.dir === "string" && req.config.dir.trim() ? req.config.dir.trim() : LOCAL_PUBLISH_DEFAULT_DIR;
+  return path22.resolve(req.project.projectDir, dir);
+}
+var localFolderProvider = {
+  info: info7,
+  async authenticate() {
+    return { ok: true };
+  },
+  async preflight(req) {
+    const dir = localPublishDir(req);
+    try {
+      const s = await stat9(dir);
+      if (!s.isDirectory()) {
+        return [
+          { severity: "error", id: "local/not-a-folder", message: `${dir} exists but is not a folder.` }
+        ];
+      }
+    } catch {}
+    return [];
+  },
+  async upload(req) {
+    const dir = localPublishDir(req);
+    await mkdir13(dir, { recursive: true });
+    const dest = req.artifact.format === "html" ? dir : path22.join(dir, path22.basename(req.artifact.path));
+    if (path22.resolve(dest) !== path22.resolve(req.artifact.path)) {
+      await cp5(req.artifact.path, dest, { recursive: true });
+    }
+    return { kind: "published", detail: `Saved to ${dest}` };
+  }
+};
+
 // src/lib/publish/providers/shopify.ts
 var SHOPIFY_HOST = "shopify";
 var DEFAULT_API_VERSION = "2026-04";
@@ -13003,7 +13051,7 @@ function requireValidShop(shop) {
   }
   return shop;
 }
-var info7 = {
+var info8 = {
   id: "shopify",
   label: "Shopify",
   kind: "api",
@@ -13037,7 +13085,7 @@ function readConfig3(req) {
 async function adminGraphQL(req, query, variables = {}) {
   const { shop: rawShop, apiVersion } = readConfig3(req);
   const shop = requireValidShop(rawShop);
-  const resolved = await resolvePublishCredential(info7, req.deps);
+  const resolved = await resolvePublishCredential(info8, req.deps);
   if (!resolved) {
     throw new Error("No Shopify access token found. Connect Shopify (or set SHOPIFY_ADMIN_TOKEN) first.");
   }
@@ -13088,9 +13136,9 @@ function userErrorsToMessage(result) {
   return errs?.length ? errs[0].message : null;
 }
 var shopifyProvider = {
-  info: info7,
+  info: info8,
   async authenticate(req) {
-    const resolved = await resolvePublishCredential(info7, req.deps);
+    const resolved = await resolvePublishCredential(info8, req.deps);
     if (!resolved) {
       return {
         ok: false,
@@ -13203,6 +13251,7 @@ var shopifyProvider = {
 
 // src/lib/publish/registry.ts
 var PROVIDERS = {
+  local: localFolderProvider,
   itch: itchProvider,
   drivethrurpg: drivethrurpgProvider,
   kdp: kdpProvider,
@@ -13223,16 +13272,16 @@ function publishProviderFor(id) {
 }
 
 // src/lib/publish/run-publish.ts
-import { readdir as readdir6, stat as stat9 } from "node:fs/promises";
-import path22 from "node:path";
-function resolvePublishFormat(info8, providerConfig) {
-  if (info8.formats && info8.formats.length > 0) {
+import { readdir as readdir6, stat as stat10 } from "node:fs/promises";
+import path23 from "node:path";
+function resolvePublishFormat(info9, providerConfig) {
+  if (info9.formats && info9.formats.length > 0) {
     const configured = typeof providerConfig.format === "string" ? providerConfig.format.trim() : "";
-    if (configured && info8.formats.includes(configured)) {
+    if (configured && info9.formats.includes(configured)) {
       return configured;
     }
   }
-  return info8.format;
+  return info9.format;
 }
 async function resolvePublishRequest(options, deps) {
   const provider = publishProviderFor(options.providerId);
@@ -13245,9 +13294,9 @@ async function resolvePublishRequest(options, deps) {
   const effectiveDeps = effectiveAccount ? { ...deps, credentialAccount: effectiveAccount } : deps;
   const outDir = resolveOutputDir(manifestDir, config.title);
   const effectiveFormat = resolvePublishFormat(provider.info, providerConfig);
-  const defaultArtifact = effectiveFormat === "pdf" ? path22.join(outDir, artifactName(config.title, "pdf")) : outDir;
+  const defaultArtifact = effectiveFormat === "pdf" ? path23.join(outDir, artifactName(config.title, "pdf")) : outDir;
   const artifact = {
-    path: options.artifactPath ? path22.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
+    path: options.artifactPath ? path23.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
     format: effectiveFormat
   };
   return {
@@ -13265,7 +13314,7 @@ var PDF_HINT = "Build the PDF first (gutterpress build, or export it from the ap
 var HTML_HINT = "Build the website export first (gutterpress build --format html).";
 async function artifactIssues(artifact) {
   try {
-    const s = await stat9(artifact.path);
+    const s = await stat10(artifact.path);
     if (artifact.format === "pdf" && !s.isFile()) {
       return [
         {
@@ -13311,7 +13360,7 @@ async function artifactIssues(artifact) {
 var BUILD_FINGERPRINT_FILENAME = "build-fingerprint.json";
 async function htmlDirIssues(dir) {
   const issues = [];
-  const isThere = async (rel) => stat9(path22.join(dir, rel)).then(() => true, () => false);
+  const isThere = async (rel) => stat10(path23.join(dir, rel)).then(() => true, () => false);
   if (!await isThere(BOOK_HTML)) {
     issues.push({
       severity: "error",
@@ -13382,17 +13431,17 @@ function overlayStore(inner, key, candidate) {
 }
 async function connectPublishProvider(options, deps) {
   const provider = publishProviderFor(options.providerId);
-  const info8 = provider.info;
-  if (!info8.credential.required) {
-    throw new Error(`${info8.label} needs no API key — just publish when you're ready.`);
+  const info9 = provider.info;
+  if (!info9.credential.required) {
+    throw new Error(`${info9.label} needs no API key — just publish when you're ready.`);
   }
-  if (info8.credential.connect === "oauth") {
-    throw new Error(`${info8.label} connects through your browser, not a pasted key — run ` + `"gutterpress publish --provider ${info8.id} --connect" or use the desktop app's Connect button.`);
+  if (info9.credential.connect === "oauth") {
+    throw new Error(`${info9.label} connects through your browser, not a pasted key — run ` + `"gutterpress publish --provider ${info9.id} --connect" or use the desktop app's Connect button.`);
   }
   const token = options.token.trim();
   if (!token)
     throw new Error("Paste an API key first.");
-  const host = info8.credential.host;
+  const host = info9.credential.host;
   const account = (options.account ?? "").trim();
   const key = publishCredentialKey(host, account);
   const candidate = {
@@ -13400,12 +13449,12 @@ async function connectPublishProvider(options, deps) {
     kind: "token",
     token,
     ...account ? { username: account } : {},
-    label: account || info8.label,
+    label: account || info9.label,
     createdAt: Date.now()
   };
   const req = await resolvePublishRequest({
     projectDir: options.projectDir,
-    providerId: info8.id,
+    providerId: info9.id,
     ...options.manifestPath ? { manifestPath: options.manifestPath } : {}
   }, deps);
   const trialDeps = {
@@ -13416,10 +13465,10 @@ async function connectPublishProvider(options, deps) {
   };
   const auth = await provider.authenticate({ ...req, deps: trialDeps });
   if (!auth.ok) {
-    throw new Error(auth.message ?? `${info8.label} didn't accept that key.`);
+    throw new Error(auth.message ?? `${info9.label} didn't accept that key.`);
   }
   await deps.tokenStore.set(key, candidate);
-  return { connected: true, providerId: info8.id };
+  return { connected: true, providerId: info9.id };
 }
 async function disconnectPublishCredential(key, deps, options = {}) {
   const existing = await deps.tokenStore.get(key);
@@ -13544,13 +13593,13 @@ import diff3Merge from "diff3";
 // src/lib/remote-auth/repair.ts
 import git7 from "isomorphic-git";
 // src/lib/publish/selections.ts
-import { chmod as chmod2, mkdir as mkdir13, readFile as readFile30, writeFile as writeFile12 } from "node:fs/promises";
-import path23 from "node:path";
+import { chmod as chmod2, mkdir as mkdir14, readFile as readFile30, writeFile as writeFile12 } from "node:fs/promises";
+import path24 from "node:path";
 class PublishSelectionsStore {
   filePath;
   queue = Promise.resolve();
   constructor(filePath) {
-    this.filePath = filePath ?? path23.join(defaultConfigDir(), "publish-selections.json");
+    this.filePath = filePath ?? path24.join(defaultConfigDir(), "publish-selections.json");
   }
   async read() {
     try {
@@ -13567,7 +13616,7 @@ class PublishSelectionsStore {
     return { version: 1, global: {}, projects: {} };
   }
   async write(data) {
-    await mkdir13(path23.dirname(this.filePath), { recursive: true });
+    await mkdir14(path24.dirname(this.filePath), { recursive: true });
     await writeFile12(this.filePath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384

package/dist/{cli-cfymymkv.js → cli-ervhbr00.js}

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

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

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
+} from "./cli-ervhbr00.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-6nz32v7c.js").then((m) => m.default),
-  preview: () => import("./preview-8dcs83k4.js").then((m) => m.default),
-  build: () => import("./build-xd4bjtbv.js").then((m) => m.default),
-  publish: () => import("./publish-2ks819pa.js").then((m) => m.default),
-  lint: () => import("./lint-exc3w24c.js").then((m) => m.default),
-  validate: () => import("./validate-e8qneem9.js").then((m) => m.default),
-  audit: () => import("./audit-ydxsev28.js").then((m) => m.default),
-  preflight: () => import("./preflight-5kq978aq.js").then((m) => m.default),
-  doctor: () => import("./doctor-b097943h.js").then((m) => m.default),
-  ext: () => import("./ext-ft6h0qn9.js").then((m) => m.default)
+  new: () => import("./new-3a5ng8yv.js").then((m) => m.default),
+  preview: () => import("./preview-aska26g4.js").then((m) => m.default),
+  build: () => import("./build-9ze0fcgq.js").then((m) => m.default),
+  publish: () => import("./publish-jam8mqes.js").then((m) => m.default),
+  lint: () => import("./lint-qxcpd3ry.js").then((m) => m.default),
+  validate: () => import("./validate-3cwwe0d5.js").then((m) => m.default),
+  audit: () => import("./audit-z6hp3dep.js").then((m) => m.default),
+  preflight: () => import("./preflight-qwbkp4pq.js").then((m) => m.default),
+  doctor: () => import("./doctor-yk3ah4yk.js").then((m) => m.default),
+  ext: () => import("./ext-8hrf9n6f.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-6nz32v7c.js");
+      const { newArgs } = await import("./new-3a5ng8yv.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-5kq978aq.js");
+      const { preflightArgs } = await import("./preflight-qwbkp4pq.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-ft6h0qn9.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-8hrf9n6f.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-b097943h.js → doctor-yk3ah4yk.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
+} from "./cli-ervhbr00.js";
 import"./cli-c41yr7he.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";

package/dist/{engine-w2m1jp4p.js → engine-qtfrfbpk.js}

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

package/dist/{engine-s6240qap.js → engine-trte2tg2.js}

@@ -1,13 +1,13 @@
 import {
   build
-} from "./index-71pn94g1.js";
+} from "./index-kqftehgy.js";
 import {
   BuildError,
   RENDER_TIMEOUT_MS,
   assertMilestone,
   connectChromium,
   getBrowser
-} from "./index-mks8j9av.js";
+} from "./index-t43k5rq1.js";
 import"./index-37x76zdn.js";
 
 // src/lib/engine.ts

package/dist/{ext-ft6h0qn9.js → ext-8hrf9n6f.js}

@@ -10,16 +10,16 @@ import {
   removeExtension,
   searchNpmExtensions,
   setExtensionEnabled
-} from "./cli-b4ramtgc.js";
-import"./cli-9a5eacxd.js";
+} from "./cli-edn2tver.js";
+import"./cli-nc752ryp.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{index-91k91awj.js → index-27xa2tfd.js}

@@ -18,7 +18,7 @@ import {
   resolveChromiumExecutable,
   run,
   spawnCapture
-} from "./index-mks8j9av.js";
+} from "./index-t43k5rq1.js";
 import {
   PLUGINS_DIR,
   VENDORED_NPM_DIR,
@@ -4301,7 +4301,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.9-alpha.1",
+  version: "0.11.9-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",
@@ -8684,7 +8684,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-s6240qap.js");
+      const { buildNativePdf } = await import("./engine-trte2tg2.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -14794,8 +14794,8 @@ async function repairOnlineBackup(options) {
   return { outcome, movedGitTo, restoredFiles };
 }
 // src/lib/publish/run-publish.ts
-import { readdir as readdir10, stat as stat11 } from "node:fs/promises";
-import path28 from "node:path";
+import { readdir as readdir10, stat as stat12 } from "node:fs/promises";
+import path29 from "node:path";
 
 // src/lib/publish/command-runner.ts
 var CAPTURE_LIMIT = 64 * 1024;
@@ -15800,6 +15800,54 @@ var kdpProvider = {
   }
 };
 
+// src/lib/publish/providers/local-folder.ts
+import { cp as cp7, mkdir as mkdir19, stat as stat11 } from "node:fs/promises";
+import path28 from "node:path";
+var LOCAL_PUBLISH_DEFAULT_DIR = "dist";
+var info7 = {
+  id: "local",
+  label: "A folder on this computer",
+  kind: "api",
+  format: "pdf",
+  formats: ["pdf", "html"],
+  description: "Save the finished file to a folder you choose.",
+  configFields: [
+    { key: "dir", label: "Folder", placeholder: LOCAL_PUBLISH_DEFAULT_DIR }
+  ],
+  credential: { required: false, host: "" }
+};
+function localPublishDir(req) {
+  const dir = typeof req.config.dir === "string" && req.config.dir.trim() ? req.config.dir.trim() : LOCAL_PUBLISH_DEFAULT_DIR;
+  return path28.resolve(req.project.projectDir, dir);
+}
+var localFolderProvider = {
+  info: info7,
+  async authenticate() {
+    return { ok: true };
+  },
+  async preflight(req) {
+    const dir = localPublishDir(req);
+    try {
+      const s = await stat11(dir);
+      if (!s.isDirectory()) {
+        return [
+          { severity: "error", id: "local/not-a-folder", message: `${dir} exists but is not a folder.` }
+        ];
+      }
+    } catch {}
+    return [];
+  },
+  async upload(req) {
+    const dir = localPublishDir(req);
+    await mkdir19(dir, { recursive: true });
+    const dest = req.artifact.format === "html" ? dir : path28.join(dir, path28.basename(req.artifact.path));
+    if (path28.resolve(dest) !== path28.resolve(req.artifact.path)) {
+      await cp7(req.artifact.path, dest, { recursive: true });
+    }
+    return { kind: "published", detail: `Saved to ${dest}` };
+  }
+};
+
 // src/lib/publish/providers/shopify.ts
 var SHOPIFY_HOST = "shopify";
 var DEFAULT_API_VERSION = "2026-04";
@@ -15814,7 +15862,7 @@ function requireValidShop(shop) {
   }
   return shop;
 }
-var info7 = {
+var info8 = {
   id: "shopify",
   label: "Shopify",
   kind: "api",
@@ -15848,7 +15896,7 @@ function readConfig3(req) {
 async function adminGraphQL(req, query, variables = {}) {
   const { shop: rawShop, apiVersion } = readConfig3(req);
   const shop = requireValidShop(rawShop);
-  const resolved = await resolvePublishCredential(info7, req.deps);
+  const resolved = await resolvePublishCredential(info8, req.deps);
   if (!resolved) {
     throw new Error("No Shopify access token found. Connect Shopify (or set SHOPIFY_ADMIN_TOKEN) first.");
   }
@@ -15899,9 +15947,9 @@ function userErrorsToMessage(result) {
   return errs?.length ? errs[0].message : null;
 }
 var shopifyProvider = {
-  info: info7,
+  info: info8,
   async authenticate(req) {
-    const resolved = await resolvePublishCredential(info7, req.deps);
+    const resolved = await resolvePublishCredential(info8, req.deps);
     if (!resolved) {
       return {
         ok: false,
@@ -16014,6 +16062,7 @@ var shopifyProvider = {
 
 // src/lib/publish/registry.ts
 var PROVIDERS = {
+  local: localFolderProvider,
   itch: itchProvider,
   drivethrurpg: drivethrurpgProvider,
   kdp: kdpProvider,
@@ -16034,14 +16083,14 @@ function publishProviderFor(id) {
 }
 
 // src/lib/publish/run-publish.ts
-function resolvePublishFormat(info8, providerConfig) {
-  if (info8.formats && info8.formats.length > 0) {
+function resolvePublishFormat(info9, providerConfig) {
+  if (info9.formats && info9.formats.length > 0) {
     const configured = typeof providerConfig.format === "string" ? providerConfig.format.trim() : "";
-    if (configured && info8.formats.includes(configured)) {
+    if (configured && info9.formats.includes(configured)) {
       return configured;
     }
   }
-  return info8.format;
+  return info9.format;
 }
 async function resolvePublishRequest(options, deps) {
   const provider = publishProviderFor(options.providerId);
@@ -16054,9 +16103,9 @@ async function resolvePublishRequest(options, deps) {
   const effectiveDeps = effectiveAccount ? { ...deps, credentialAccount: effectiveAccount } : deps;
   const outDir = resolveOutputDir(manifestDir, config.title);
   const effectiveFormat = resolvePublishFormat(provider.info, providerConfig);
-  const defaultArtifact = effectiveFormat === "pdf" ? path28.join(outDir, artifactName(config.title, "pdf")) : outDir;
+  const defaultArtifact = effectiveFormat === "pdf" ? path29.join(outDir, artifactName(config.title, "pdf")) : outDir;
   const artifact = {
-    path: options.artifactPath ? path28.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
+    path: options.artifactPath ? path29.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
     format: effectiveFormat
   };
   return {
@@ -16074,7 +16123,7 @@ var PDF_HINT = "Build the PDF first (gutterpress build, or export it from the ap
 var HTML_HINT = "Build the website export first (gutterpress build --format html).";
 async function artifactIssues(artifact) {
   try {
-    const s = await stat11(artifact.path);
+    const s = await stat12(artifact.path);
     if (artifact.format === "pdf" && !s.isFile()) {
       return [
         {
@@ -16120,7 +16169,7 @@ async function artifactIssues(artifact) {
 var BUILD_FINGERPRINT_FILENAME = "build-fingerprint.json";
 async function htmlDirIssues(dir) {
   const issues = [];
-  const isThere = async (rel) => stat11(path28.join(dir, rel)).then(() => true, () => false);
+  const isThere = async (rel) => stat12(path29.join(dir, rel)).then(() => true, () => false);
   if (!await isThere(BOOK_HTML)) {
     issues.push({
       severity: "error",
@@ -16190,17 +16239,17 @@ function overlayStore(inner, key, candidate) {
 }
 async function connectPublishProvider(options, deps) {
   const provider = publishProviderFor(options.providerId);
-  const info8 = provider.info;
-  if (!info8.credential.required) {
-    throw new Error(`${info8.label} needs no API key — just publish when you're ready.`);
+  const info9 = provider.info;
+  if (!info9.credential.required) {
+    throw new Error(`${info9.label} needs no API key — just publish when you're ready.`);
   }
-  if (info8.credential.connect === "oauth") {
-    throw new Error(`${info8.label} connects through your browser, not a pasted key — run ` + `"gutterpress publish --provider ${info8.id} --connect" or use the desktop app's Connect button.`);
+  if (info9.credential.connect === "oauth") {
+    throw new Error(`${info9.label} connects through your browser, not a pasted key — run ` + `"gutterpress publish --provider ${info9.id} --connect" or use the desktop app's Connect button.`);
   }
   const token = options.token.trim();
   if (!token)
     throw new Error("Paste an API key first.");
-  const host = info8.credential.host;
+  const host = info9.credential.host;
   const account = (options.account ?? "").trim();
   const key = publishCredentialKey(host, account);
   const candidate = {
@@ -16208,12 +16257,12 @@ async function connectPublishProvider(options, deps) {
     kind: "token",
     token,
     ...account ? { username: account } : {},
-    label: account || info8.label,
+    label: account || info9.label,
     createdAt: Date.now()
   };
   const req = await resolvePublishRequest({
     projectDir: options.projectDir,
-    providerId: info8.id,
+    providerId: info9.id,
     ...options.manifestPath ? { manifestPath: options.manifestPath } : {}
   }, deps);
   const trialDeps = {
@@ -16224,10 +16273,10 @@ async function connectPublishProvider(options, deps) {
   };
   const auth = await provider.authenticate({ ...req, deps: trialDeps });
   if (!auth.ok) {
-    throw new Error(auth.message ?? `${info8.label} didn't accept that key.`);
+    throw new Error(auth.message ?? `${info9.label} didn't accept that key.`);
   }
   await deps.tokenStore.set(key, candidate);
-  return { connected: true, providerId: info8.id };
+  return { connected: true, providerId: info9.id };
 }
 async function disconnectPublishCredential(key, deps, options = {}) {
   const existing = await deps.tokenStore.get(key);
@@ -16239,13 +16288,13 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/publish/selections.ts
-import { chmod as chmod3, mkdir as mkdir19, readFile as readFile34, writeFile as writeFile17 } from "node:fs/promises";
-import path29 from "node:path";
+import { chmod as chmod3, mkdir as mkdir20, readFile as readFile34, writeFile as writeFile17 } from "node:fs/promises";
+import path30 from "node:path";
 class PublishSelectionsStore {
   filePath;
   queue = Promise.resolve();
   constructor(filePath) {
-    this.filePath = filePath ?? path29.join(defaultConfigDir(), "publish-selections.json");
+    this.filePath = filePath ?? path30.join(defaultConfigDir(), "publish-selections.json");
   }
   async read() {
     try {
@@ -16262,7 +16311,7 @@ class PublishSelectionsStore {
     return { version: 1, global: {}, projects: {} };
   }
   async write(data) {
-    await mkdir19(path29.dirname(this.filePath), { recursive: true });
+    await mkdir20(path30.dirname(this.filePath), { recursive: true });
     await writeFile17(this.filePath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384

package/dist/{index-71pn94g1.js → index-kqftehgy.js}

@@ -4,7 +4,7 @@ import {
   launchChromium,
   marginBoxAlign,
   marginBoxRectPt
-} from "./index-mks8j9av.js";
+} from "./index-t43k5rq1.js";
 
 // src/engine/compiler/build.ts
 import { readFile } from "node:fs/promises";

package/dist/{index-mks8j9av.js → index-t43k5rq1.js}

@@ -593,7 +593,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-wkbm9cjn.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-hsn8rsgr.json";
+var manifest_schema_default = "./manifest.schema-61bsspsb.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-9rwz21yw.js";

package/dist/index.js

@@ -143,15 +143,15 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "./index-91k91awj.js";
+} from "./index-27xa2tfd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-71pn94g1.js";
+} from "./index-kqftehgy.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "./index-mks8j9av.js";
+} from "./index-t43k5rq1.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   DEFAULT_NPM_REGISTRY,

package/dist/lib/publish/providers/local-folder.d.ts

@@ -0,0 +1,6 @@
+import type { PublishProvider, PublishRequest } from "../types.ts";
+/** The folder used when `publish.local.dir` is unset — inside the book. */
+export declare const LOCAL_PUBLISH_DEFAULT_DIR = "dist";
+/** The absolute folder for a request: `publish.local.dir` (relative to the book) or the default. */
+export declare function localPublishDir(req: Pick<PublishRequest, "project" | "config">): string;
+export declare const localFolderProvider: PublishProvider;

package/dist/lib/publish/types.d.ts

@@ -33,7 +33,7 @@ export interface PublishConfigField {
 }
 /** Stable provider identifiers: the `--provider` values AND the manifest
  * `publish.<id>` keys — one spelling everywhere. */
-export type PublishProviderId = "itch" | "drivethrurpg" | "kdp" | "azure-swa" | "shopify" | "gdrive";
+export type PublishProviderId = "local" | "itch" | "drivethrurpg" | "kdp" | "azure-swa" | "shopify" | "gdrive";
 /**
  * How the provider integrates:
  *   - "api"    — real programmatic upload (itch.io, Azure SWA, Shopify)

package/dist/{lint-exc3w24c.js → lint-qxcpd3ry.js}

@@ -1,16 +1,16 @@
 import {
   MANIFEST_FILENAMES,
   runLint
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{manifest.schema-hsn8rsgr.json → manifest.schema-61bsspsb.json}

@@ -424,6 +424,15 @@
       "type": "object",
       "description": "Publish provider settings, keyed by the same provider id `gutterpress publish --provider <id>` takes. Non-secret configuration only — API keys and tokens are stored in the host credential store, never in this file.",
       "properties": {
+        "local": {
+          "type": "object",
+          "description": "A folder on this computer — where the desktop's Publish builds the book before sending it anywhere else (default: `dist` inside the book)",
+          "properties": {
+            "dir": { "type": "string", "description": "Output folder, relative to the book or absolute. Default: dist" },
+            "format": { "type": "string", "enum": ["pdf", "html"], "description": "Which build to save (default: pdf)" }
+          },
+          "additionalProperties": true
+        },
         "itch": {
           "type": "object",
           "description": "itch.io publishing (uploaded with butler)",

package/dist/{new-6nz32v7c.js → new-3a5ng8yv.js}

@@ -7,16 +7,16 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   resolveGhostscript
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import {
   isToolAvailable
 } from "./cli-c41yr7he.js";

package/dist/{preflight-5kq978aq.js → preflight-qwbkp4pq.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{preview-8dcs83k4.js → preview-aska26g4.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   parseFormat,
@@ -17,8 +17,8 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError

package/dist/{publish-2ks819pa.js → publish-jam8mqes.js}

@@ -11,17 +11,17 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   FileTokenStore,
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{validate-e8qneem9.js → validate-3cwwe0d5.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-b4ramtgc.js";
+} from "./cli-edn2tver.js";
 import {
   log
-} from "./cli-9a5eacxd.js";
+} from "./cli-nc752ryp.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cfymymkv.js";
-import"./cli-h91e69hm.js";
+} from "./cli-ervhbr00.js";
+import"./cli-d8rdk1y7.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.9-alpha.1",
+  "version": "0.11.9-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",