gutterpress 0.9.0-alpha.2 → 0.10.0-alpha.3

package/dist/cli-c41yr7he.js

@@ -0,0 +1,241 @@
+// src/lib/tool-probe.ts
+import { platform } from "node:os";
+
+// src/lib/exec.ts
+import { spawn } from "node:child_process";
+import { join, resolve as resolvePath, delimiter } from "node:path";
+function buildEnhancedPath(dir, existingPath, sep = delimiter) {
+  return `${dir}${sep}${existingPath}`;
+}
+var localBin = resolvePath(join(import.meta.dirname, "..", "..", "node_modules", ".bin"));
+var enhancedPath = buildEnhancedPath(localBin, process.env.PATH ?? "");
+function enhancedEnv() {
+  return { ...process.env, PATH: enhancedPath };
+}
+function run(cmd, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const p = spawn(cmd, args, { stdio: "inherit", cwd: opts.cwd, env: enhancedEnv() });
+    p.on("error", reject);
+    p.on("exit", (code) => {
+      if (code === 0)
+        return resolve();
+      const cwd = opts.cwd ?? process.cwd();
+      reject(new Error(`${cmd} ${args.join(" ")} (cwd=${cwd}) exited ${code}`));
+    });
+  });
+}
+var EXIT_FLUSH_GRACE_MS = 2000;
+function keepTail(buffer, chunk, limit) {
+  const joined = buffer + chunk;
+  return limit !== undefined && joined.length > limit ? joined.slice(-limit) : joined;
+}
+function spawnCapture(cmd, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const p = spawn(cmd, args, {
+      stdio: ["ignore", "pipe", "pipe"],
+      cwd: opts.cwd,
+      env: opts.env
+    });
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    let exited = false;
+    let exitCode = null;
+    let exitSignal = null;
+    let killTimer;
+    let graceTimer;
+    const settle = (fn) => {
+      if (settled)
+        return;
+      settled = true;
+      if (killTimer)
+        clearTimeout(killTimer);
+      if (graceTimer)
+        clearTimeout(graceTimer);
+      fn();
+    };
+    const armKill = () => {
+      if (!opts.timeoutMs)
+        return;
+      if (killTimer)
+        clearTimeout(killTimer);
+      killTimer = setTimeout(() => {
+        settle(() => {
+          p.kill("SIGKILL");
+          reject(new Error(opts.timeoutMode === "idle" ? `${cmd} produced no output for ${opts.timeoutMs}ms and was stopped` : `${cmd} ${args.join(" ")} timed out after ${opts.timeoutMs}ms`));
+        });
+      }, opts.timeoutMs);
+      killTimer.unref();
+    };
+    armKill();
+    const finish = () => settle(() => resolve({ code: exitCode, signal: exitSignal, stdout, stderr }));
+    const armGrace = () => {
+      if (graceTimer)
+        clearTimeout(graceTimer);
+      graceTimer = setTimeout(finish, opts.exitGraceMs ?? EXIT_FLUSH_GRACE_MS);
+      graceTimer.unref();
+    };
+    const onData = (stream) => (d) => {
+      const text = d.toString();
+      if (stream === "stdout")
+        stdout = keepTail(stdout, text, opts.captureLimit);
+      else
+        stderr = keepTail(stderr, text, opts.captureLimit);
+      opts.onChunk?.(stream, text);
+      if (exited)
+        armGrace();
+      else if (opts.timeoutMode === "idle")
+        armKill();
+    };
+    p.stdout.on("data", onData("stdout"));
+    p.stderr.on("data", onData("stderr"));
+    p.on("error", (err) => settle(() => reject(err)));
+    p.on("exit", (code, signal) => {
+      exited = true;
+      exitCode = code;
+      exitSignal = signal;
+      if (killTimer) {
+        clearTimeout(killTimer);
+        killTimer = undefined;
+      }
+      armGrace();
+    });
+    p.on("close", finish);
+  });
+}
+async function execCapture(cmd, args, opts = {}) {
+  const { code, signal, stdout, stderr } = await spawnCapture(cmd, args, {
+    cwd: opts.cwd,
+    env: enhancedEnv(),
+    timeoutMs: opts.timeoutMs
+  });
+  if (code === 0)
+    return { stdout, stderr };
+  throw new Error(code === null ? `${cmd} was killed by signal ${signal}
+${stderr}` : `${cmd} exited ${code}
+${stderr}`);
+}
+
+// src/lib/tool-probe.ts
+var IS_WINDOWS = platform() === "win32";
+var PROBE_CMD = IS_WINDOWS ? "where.exe" : "which";
+async function isToolAvailable(tool) {
+  try {
+    await execCapture(PROBE_CMD, [tool]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function findTool(tool) {
+  try {
+    const { stdout } = await execCapture(PROBE_CMD, [tool]);
+    const firstLine = stdout.split(/\r?\n/).find((line) => line.trim().length > 0);
+    return firstLine?.trim() || undefined;
+  } catch {
+    return;
+  }
+}
+
+// src/lib/install-hints.ts
+var INSTALL_HINTS = {
+  chromium: {
+    label: "Google Chrome, Chromium, or Microsoft Edge",
+    body: `  macOS:   brew install --cask google-chrome
+` + `  Ubuntu:  sudo apt install -y chromium-browser
+` + "  Windows: https://www.google.com/chrome/  (Edge is auto-detected if pre-installed)"
+  },
+  gs: {
+    label: "Ghostscript",
+    body: `  macOS:   brew install ghostscript
+` + `  Ubuntu:  sudo apt install -y ghostscript
+` + "  Windows: https://www.ghostscript.com/releases/gsdnld.html  (standard installs are auto-detected; or: choco install ghostscript)"
+  },
+  qpdf: {
+    label: "qpdf",
+    body: `  macOS:   brew install qpdf
+` + `  Ubuntu:  sudo apt install -y qpdf
+` + "  Windows: choco install qpdf  (or: https://github.com/qpdf/qpdf/releases)"
+  }
+};
+function fullInstallHint(tool) {
+  const hint = INSTALL_HINTS[tool];
+  return `Install ${hint.label}:
+${hint.body}`;
+}
+
+// src/lib/chromium.ts
+import { existsSync } from "node:fs";
+var SYSTEM_PATHS = [
+  process.env.CHROMIUM_PATH,
+  process.env.PUPPETEER_EXECUTABLE_PATH,
+  "/usr/bin/google-chrome",
+  "/usr/bin/google-chrome-stable",
+  "/usr/bin/chromium",
+  "/usr/bin/chromium-browser",
+  "/snap/bin/chromium",
+  "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+  "/Applications/Chromium.app/Contents/MacOS/Chromium",
+  "/opt/homebrew/bin/chromium",
+  "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+  "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+  "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+  "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+  process.env.LOCALAPPDATA ? `${process.env.LOCALAPPDATA}\\Google\\Chrome\\Application\\chrome.exe` : undefined,
+  "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
+  "C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe",
+  process.env.LOCALAPPDATA ? `${process.env.LOCALAPPDATA}\\Microsoft\\Edge\\Application\\msedge.exe` : undefined,
+  process.env.LOCALAPPDATA ? `${process.env.LOCALAPPDATA}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe` : undefined
+].filter(Boolean);
+var PATH_CANDIDATES = [
+  "google-chrome",
+  "google-chrome-stable",
+  "chromium",
+  "chromium-browser",
+  "chrome",
+  "chrome.exe",
+  "msedge",
+  "msedge.exe",
+  "brave",
+  "brave-browser",
+  "brave.exe",
+  "vivaldi",
+  "vivaldi-stable",
+  "vivaldi.exe",
+  "opera",
+  "opera-stable",
+  "opera.exe"
+];
+async function resolveChromiumExecutable() {
+  for (const candidate of SYSTEM_PATHS) {
+    if (existsSync(candidate))
+      return candidate;
+  }
+  for (const candidate of PATH_CANDIDATES) {
+    const found = await findTool(candidate);
+    if (found)
+      return found;
+  }
+  return;
+}
+async function requireChromiumExecutable() {
+  const found = await resolveChromiumExecutable();
+  if (found)
+    return found;
+  throw new Error([
+    "No Chrome / Chromium / Edge binary found. Gutterpress needs a Chromium-based browser to render PDFs.",
+    "",
+    "Install one of:",
+    INSTALL_HINTS.chromium.body,
+    "",
+    "Or point to an existing install:",
+    "  CHROMIUM_PATH=/path/to/chrome gutterpress build ...",
+    "",
+    "The Gutterpress desktop app uses its own bundled browser for BOTH",
+    "PDF export and needs no separate install.",
+    "This message is about the CLI, which does need one."
+  ].join(`
+`));
+}
+
+export { run, spawnCapture, execCapture, isToolAvailable, findTool, INSTALL_HINTS, fullInstallHint, resolveChromiumExecutable, requireChromiumExecutable };

package/dist/{cli-e5zhb0xs.js → cli-f4rcbt2t.js}

@@ -1,15 +1,17 @@
+import {
+  EXIT_CODES
+} from "./cli-46ycxe6r.js";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.9.0-alpha.2",
-  description: "Markdown-to-PDF converter for professional print layout using Paged.js and Ghostscript.",
+  version: "0.10.0-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",
   keywords: [
     "markdown",
     "pdf",
     "print",
-    "pagedjs",
     "ghostscript",
     "book",
     "publishing",
@@ -49,11 +51,13 @@ var package_default = {
     "LICENSE"
   ],
   scripts: {
-    "build:library": "rimraf dist && bun build src/index.ts src/api/index.ts --target=node --packages=external --splitting --outdir=dist && bun build src/render.ts --target=node --packages=external --outdir=dist && node scripts/check-render-pure.mjs && tsc -p tsconfig.build.json",
+    "build:library": "bun scripts/build-engine-bundles.mjs && rimraf dist && bun build src/index.ts src/api/index.ts --target=node --packages=external --splitting --outdir=dist && bun build src/render.ts --target=node --packages=external --outdir=dist && node scripts/check-render-pure.mjs && tsc -p tsconfig.build.json",
     build: "bun run build:library && bun build src/cli.ts --target=node --packages=external --splitting --outdir=dist",
     prepublishOnly: "bun run build",
     test: "bun test",
-    typecheck: "tsc --noEmit"
+    typecheck: "tsc --noEmit",
+    "typecheck:engine-browser": "tsc --noEmit -p src/engine/browser.tsconfig.json",
+    "parity:gate": "bun scripts/native-parity-gate.ts"
   },
   engines: {
     bun: ">=1.0.0",
@@ -95,30 +99,12 @@ var package_default = {
     "@types/node": "^22.0.0",
     "@types/semver": "^7.7.1",
     "@types/ws": "^8.5.13",
-    pagedjs: "^0.4.3",
     playwright: "^1.60.0",
     rimraf: "^6.0.0",
     typescript: "^5"
   }
 };
 
-// src/lib/build-error.ts
-var EXIT_CODES = {
-  OK: 0,
-  FINDINGS: 1,
-  USAGE: 2,
-  PIPELINE: 3
-};
-
-class BuildError extends Error {
-  exitCode;
-  constructor(message, exitCode = EXIT_CODES.PIPELINE, options) {
-    super(message, options);
-    this.name = "BuildError";
-    this.exitCode = exitCode;
-  }
-}
-
 // src/constants.ts
 var NETWORK = {
   DEFAULT_PORT: 3579
@@ -268,6 +254,13 @@ function parsePdfxFlavor(raw, format) {
     return raw;
   throw new UsageError(`Invalid --pdfx-flavor value: "${raw}". Expected "x1a" or "x3".`);
 }
+function parseEngine(raw) {
+  if (raw === undefined)
+    return;
+  if (raw === "paged" || raw === "native")
+    return raw;
+  throw new UsageError(`Unknown --engine "${String(raw)}". Expected: paged | native`);
+}
 function resolvePort(raw) {
   if (raw === undefined)
     return NETWORK.DEFAULT_PORT;
@@ -281,4 +274,4 @@ function resolvePort(raw) {
   return n;
 }
 
-export { package_default, DEBOUNCE, EXIT_CODES, BuildError, UsageError, rejectUnknownFlags, rejectExtraPositionals, parseFormat, parsePdfxFlavor, resolvePort };
+export { package_default, DEBOUNCE, UsageError, rejectUnknownFlags, rejectExtraPositionals, parseFormat, parsePdfxFlavor, parseEngine, resolvePort };