@open-press/cli 0.8.0 → 1.1.0

package/template/core/engine/output/chrome-pdf.mjs

@@ -1,358 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import fs from "node:fs/promises";
-import path from "node:path";
-
-const CHROME_CANDIDATE_PATHS = {
-  darwin: [
-    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-    "/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta",
-    "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
-    "/Applications/Chromium.app/Contents/MacOS/Chromium",
-    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
-  ],
-  linux: [
-    "/usr/bin/google-chrome",
-    "/usr/bin/google-chrome-stable",
-    "/usr/bin/chromium",
-    "/usr/bin/chromium-browser",
-    "/snap/bin/chromium",
-    "/opt/google/chrome/chrome",
-  ],
-  win32: [
-    "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
-    "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
-  ],
-};
-
-const CHROME_BIN_NAMES = {
-  darwin: [],
-  linux: ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser"],
-  win32: ["chrome.exe"],
-};
-
-let cachedChromePath = null;
-
-function resolveChromePath() {
-  if (cachedChromePath) return cachedChromePath;
-  if (process.env.CHROME) {
-    cachedChromePath = process.env.CHROME;
-    return cachedChromePath;
-  }
-
-  const platform = process.platform;
-  const candidates = [...(CHROME_CANDIDATE_PATHS[platform] ?? [])];
-
-  if (platform === "win32") {
-    const roots = [process.env.PROGRAMFILES, process.env["PROGRAMFILES(X86)"], process.env.LOCALAPPDATA].filter(Boolean);
-    for (const root of roots) {
-      candidates.push(`${root}\\Google\\Chrome\\Application\\chrome.exe`);
-    }
-  }
-
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) {
-      cachedChromePath = candidate;
-      return cachedChromePath;
-    }
-  }
-
-  const whichCommand = platform === "win32" ? "where" : "which";
-  for (const name of CHROME_BIN_NAMES[platform] ?? []) {
-    try {
-      const result = spawnSync(whichCommand, [name], { encoding: "utf8" });
-      const output = result.stdout?.trim().split(/\r?\n/)[0];
-      if (result.status === 0 && output && existsSync(output)) {
-        cachedChromePath = output;
-        return cachedChromePath;
-      }
-    } catch {
-      // continue
-    }
-  }
-
-  const lines = [
-    `Cannot locate a Chrome / Chromium executable on ${platform}.`,
-    `Set the CHROME environment variable to your Chrome binary path, or install Chrome at one of:`,
-    ...candidates.map((p) => `  - ${p}`),
-  ];
-  throw new Error(lines.join("\n"));
-}
-
-const DEFAULT_PRINT_OPTIONS = {
-  printBackground: true,
-  displayHeaderFooter: false,
-  preferCSSPageSize: true,
-  paperWidth: 8.2677,
-  paperHeight: 11.6929,
-  marginTop: 0,
-  marginRight: 0,
-  marginBottom: 0,
-  marginLeft: 0,
-};
-
-export const DEFAULT_PRINT_VIEWPORT = Object.freeze({
-  width: 1200,
-  height: 1698,
-  deviceScaleFactor: 1,
-  mobile: false,
-});
-
-export async function printUrlToPdf({
-  root,
-  url,
-  outPath,
-  chrome,
-  waitForReady = waitForPrintReady,
-  printOptions = {},
-  viewport = DEFAULT_PRINT_VIEWPORT,
-  debuggingPortBase = 9600,
-  debuggingPortRange = 300,
-  profilePrefix = "chrome-pdf",
-}) {
-  chrome ??= resolveChromePath();
-  await fs.mkdir(path.dirname(outPath), { recursive: true });
-
-  const debuggingPort = String(debuggingPortBase + Math.floor(Math.random() * debuggingPortRange));
-  const profileDir = path.join(root, ".openpress", "tmp", `${profilePrefix}-${process.pid}-${Date.now()}`);
-  await fs.mkdir(profileDir, { recursive: true });
-
-  const child = spawn(
-    chrome,
-    [
-      "--headless=new",
-      "--disable-gpu",
-      "--no-sandbox",
-      `--remote-debugging-port=${debuggingPort}`,
-      `--user-data-dir=${profileDir}`,
-      "about:blank",
-    ],
-    { cwd: root, stdio: ["ignore", "pipe", "pipe"] },
-  );
-
-  try {
-    const tab = await waitForChromeTab(debuggingPort);
-    const client = await connectChromeDevTools(tab.webSocketDebuggerUrl);
-    try {
-      await preparePdfPage(client, { viewport });
-      await client.send("Page.navigate", { url });
-      const readyResult = await waitForReady(client);
-      const result = await client.send("Page.printToPDF", {
-        ...DEFAULT_PRINT_OPTIONS,
-        ...printOptions,
-      });
-      await fs.writeFile(outPath, Buffer.from(String(result.data ?? ""), "base64"));
-      return readyResult;
-    } finally {
-      client.close();
-    }
-  } finally {
-    await stopChildProcess(child);
-    await cleanupChromeProfile(profileDir);
-  }
-}
-
-export async function preparePdfPage(client, { viewport = DEFAULT_PRINT_VIEWPORT } = {}) {
-  await client.send("Page.enable");
-  await client.send("Runtime.enable");
-  if (viewport) {
-    await client.send("Emulation.setDeviceMetricsOverride", viewport);
-  }
-  await client.send("Emulation.setEmulatedMedia", { media: "print" });
-}
-
-export async function evaluateUrlWithChrome({
-  root,
-  url,
-  chrome,
-  evaluate,
-  emulatedMedia,
-  debuggingPortBase = 9900,
-  debuggingPortRange = 300,
-  profilePrefix = "chrome-eval",
-}) {
-  chrome ??= resolveChromePath();
-
-  const debuggingPort = String(debuggingPortBase + Math.floor(Math.random() * debuggingPortRange));
-  const profileDir = path.join(root, ".openpress", "tmp", `${profilePrefix}-${process.pid}-${Date.now()}`);
-  await fs.mkdir(profileDir, { recursive: true });
-
-  const child = spawn(
-    chrome,
-    [
-      "--headless=new",
-      "--disable-gpu",
-      "--no-sandbox",
-      `--remote-debugging-port=${debuggingPort}`,
-      `--user-data-dir=${profileDir}`,
-      "about:blank",
-    ],
-    { cwd: root, stdio: ["ignore", "pipe", "pipe"] },
-  );
-
-  try {
-    const tab = await waitForChromeTab(debuggingPort);
-    const client = await connectChromeDevTools(tab.webSocketDebuggerUrl);
-    try {
-      await client.send("Page.enable");
-      await client.send("Runtime.enable");
-      if (emulatedMedia) {
-        await client.send("Emulation.setEmulatedMedia", { media: emulatedMedia });
-      }
-      await client.send("Page.navigate", { url });
-      return await evaluate(client);
-    } finally {
-      client.close();
-    }
-  } finally {
-    await stopChildProcess(child);
-    await cleanupChromeProfile(profileDir);
-  }
-}
-
-export async function waitForPrintReady(client) {
-  const deadline = Date.now() + 30000;
-  while (Date.now() < deadline) {
-    const result = await client.send("Runtime.evaluate", {
-      returnByValue: true,
-      awaitPromise: true,
-      expression: `Promise.resolve().then(async () => {
-        const root = document.querySelector('[data-openpress-print-document="true"]');
-        if (!root || root.querySelectorAll('.openpress-html-page').length === 0) return 0;
-
-        await document.fonts?.ready;
-        await Promise.all(Array.from(document.images).map(async (img) => {
-          if (!img.complete) {
-            await new Promise((resolve) => {
-              const settle = () => {
-                img.removeEventListener('load', settle);
-                img.removeEventListener('error', settle);
-                resolve();
-              };
-
-              img.addEventListener('load', settle, { once: true });
-              img.addEventListener('error', settle, { once: true });
-            });
-          }
-
-          await img.decode?.().catch(() => undefined);
-        }));
-
-        await new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(resolve)));
-
-        const pages = Array.from(document.querySelectorAll('.openpress-public-page > .openpress-html-page'));
-        const contentFitsPageBody = (body) => {
-          const bodyBottom = body.getBoundingClientRect().bottom;
-          const contentBottom = Array.from(body.children).reduce((bottom, child) => {
-            if (getComputedStyle(child).display === 'none') return bottom;
-            const marginBottom = Number.parseFloat(getComputedStyle(child).marginBottom) || 0;
-            return Math.max(bottom, child.getBoundingClientRect().bottom + marginBottom);
-          }, body.getBoundingClientRect().top);
-          return contentBottom <= bodyBottom + 1;
-        };
-        const bodyOverflowSafe = pages.every((page) => {
-          const body = page.querySelector('.page-body');
-          return !body || contentFitsPageBody(body);
-        });
-
-        return pages.length > 0 && bodyOverflowSafe ? pages.length : 0;
-      })`,
-    });
-    const count = Number(result.result?.value ?? 0);
-    if (count > 0) return count;
-    await delay(100);
-  }
-  throw new Error("Timed out waiting for OpenPress pagination before PDF export.");
-}
-
-export async function stopChildProcess(child) {
-  if (child.exitCode !== null || child.signalCode !== null) return;
-  child.kill();
-  const closed = await waitForChildClose(child, 2500);
-  if (closed || child.exitCode !== null || child.signalCode !== null) return;
-  child.kill("SIGKILL");
-  await waitForChildClose(child, 2500);
-}
-
-async function waitForChromeTab(debuggingPort) {
-  const deadline = Date.now() + 10000;
-  let lastError;
-  while (Date.now() < deadline) {
-    try {
-      const response = await fetch(`http://127.0.0.1:${debuggingPort}/json/list`);
-      const tabs = await response.json();
-      const tab = tabs.find((item) => item.type === "page" && item.webSocketDebuggerUrl);
-      if (tab) return tab;
-    } catch (error) {
-      lastError = error;
-    }
-    await delay(100);
-  }
-  throw new Error(`Timed out waiting for Chrome DevTools${lastError ? `: ${lastError.message}` : ""}`);
-}
-
-async function connectChromeDevTools(webSocketDebuggerUrl) {
-  const socket = new WebSocket(webSocketDebuggerUrl);
-  const pending = new Map();
-  let nextId = 0;
-
-  await new Promise((resolve, reject) => {
-    socket.addEventListener("open", resolve, { once: true });
-    socket.addEventListener("error", reject, { once: true });
-  });
-
-  socket.addEventListener("message", (event) => {
-    const message = JSON.parse(String(event.data));
-    if (!message.id || !pending.has(message.id)) return;
-    const callbacks = pending.get(message.id);
-    pending.delete(message.id);
-    if (message.error) callbacks?.reject(new Error(message.error.message ?? "Chrome DevTools command failed."));
-    else callbacks?.resolve(message.result ?? {});
-  });
-
-  return {
-    send(method, params = {}) {
-      return new Promise((resolve, reject) => {
-        const id = ++nextId;
-        pending.set(id, { resolve, reject });
-        socket.send(JSON.stringify({ id, method, params }));
-      });
-    },
-    close() {
-      socket.close();
-    },
-  };
-}
-
-function waitForChildClose(child, timeoutMs) {
-  if (child.exitCode !== null || child.signalCode !== null) return Promise.resolve(true);
-  return new Promise((resolve) => {
-    let settled = false;
-    const finish = (closed) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      child.off("close", onClose);
-      child.off("error", onError);
-      resolve(closed);
-    };
-    const onClose = () => finish(true);
-    const onError = () => finish(true);
-    const timer = setTimeout(() => finish(false), timeoutMs);
-    child.once("close", onClose);
-    child.once("error", onError);
-  });
-}
-
-async function cleanupChromeProfile(profileDir) {
-  try {
-    await fs.rm(profileDir, { recursive: true, force: true, maxRetries: 8, retryDelay: 150 });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.warn(`Could not remove temporary Chrome profile ${profileDir}: ${message}`);
-  }
-}
-
-function delay(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/template/core/engine/output/deploy-sync.mjs

@@ -1,15 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { loadConfig } from "../runtime/config.mjs";
-import { copyDirectory } from "../runtime/file-utils.mjs";
-
-export async function deploySync(root, sourceDir, deployDir) {
-  const config = await loadConfig(root);
-  sourceDir ??= config.outputDir;
-  deployDir ??= config.deploy.source;
-  const dist = path.join(root, sourceDir);
-  const deploy = path.join(root, deployDir);
-  await fs.rm(deploy, { recursive: true, force: true });
-  await fs.mkdir(deploy, { recursive: true });
-  await copyDirectory(dist, deploy);
-}

package/template/core/engine/output/fonts.mjs

@@ -1,62 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { copyDirectory } from "../runtime/file-utils.mjs";
-
-export async function copyThemeFonts(root, publicOutputDir, config) {
-  const themeDir = config?.paths?.themeDir ?? path.join(path.resolve(root), "theme");
-  const target = path.join(publicOutputDir, "fonts.css");
-  const themeFonts = path.join(themeDir, "fonts.css");
-  if (await isFile(themeFonts)) {
-    await fs.copyFile(themeFonts, target);
-  } else {
-    await fs.writeFile(target, defaultFontsCss(), "utf8");
-  }
-
-  const themeFontFiles = path.join(themeDir, "fonts");
-  if (await isDirectory(themeFontFiles)) {
-    await copyDirectory(themeFontFiles, path.join(publicOutputDir, "fonts"));
-  } else {
-    await fs.rm(path.join(publicOutputDir, "fonts"), { recursive: true, force: true });
-  }
-}
-
-async function isFile(filePath) {
-  try {
-    return (await fs.stat(filePath)).isFile();
-  } catch {
-    return false;
-  }
-}
-
-async function isDirectory(filePath) {
-  try {
-    return (await fs.stat(filePath)).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-function defaultFontsCss() {
-  return `@font-face {
-  font-family: "OpenPress Body";
-  src: local("PingFang TC"), local("Noto Sans TC"), local("Hiragino Sans"), local("Microsoft JhengHei");
-  font-weight: 300 700;
-  font-style: normal;
-  font-display: swap;
-}
-
-@font-face {
-  font-family: "OpenPress Serif";
-  src: local("Noto Serif TC"), local("Songti TC"), local("Source Han Serif TC"), local("PMingLiU");
-  font-weight: 300 700;
-  font-style: normal;
-  font-display: swap;
-}
-
-:root {
-  --openpress-font-body: "OpenPress Body", "PingFang TC", "Noto Sans TC", "Hiragino Sans", "Microsoft JhengHei", sans-serif;
-  --openpress-font-serif: "OpenPress Serif", "Noto Serif TC", "Songti TC", "Source Han Serif TC", "PMingLiU", serif;
-  --openpress-font-mono: "SFMono-Regular", "Menlo", "Consolas", monospace;
-}
-`;
-}

package/template/core/engine/output/katex-assets.mjs

@@ -1,45 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { createRequire } from "node:module";
-
-const require = createRequire(import.meta.url);
-
-const KATEX_OVERRIDES = `
-
-/* OpenPress math sizing keeps inline equations aligned with document typography. */
-.reader-page--content .katex {
-  font-size: 1em;
-}
-
-.reader-page--content .katex-display {
-  display: block;
-  width: fit-content;
-  max-width: 100%;
-  margin: var(--openpress-space-2) auto var(--openpress-space-3);
-  border-block: 1px solid color-mix(in srgb, var(--openpress-color-line) 76%, transparent);
-  padding: 0.55em 1.15em;
-  background: color-mix(in srgb, var(--openpress-color-panel) 78%, var(--openpress-color-document));
-  color: var(--openpress-color-ink);
-  overflow-x: auto;
-  overflow-y: hidden;
-  text-align: center;
-}
-
-.reader-page--content .katex-display > .katex {
-  font-size: 1.05em;
-}
-`;
-
-export async function readKatexCss() {
-  const cssPath = require.resolve("katex/dist/katex.min.css");
-  const css = await fs.readFile(cssPath, "utf8");
-  return `${css.replace(/url\(fonts\/([^)]+)\)/g, 'url("/openpress/katex-fonts/$1")')}${KATEX_OVERRIDES}`;
-}
-
-export async function copyKatexFonts(publicOutputDir) {
-  const sampleFont = require.resolve("katex/dist/fonts/KaTeX_Main-Regular.woff2");
-  const sourceDir = path.dirname(sampleFont);
-  const targetDir = path.join(publicOutputDir, "katex-fonts");
-  await fs.rm(targetDir, { recursive: true, force: true });
-  await fs.cp(sourceDir, targetDir, { recursive: true });
-}

package/template/core/engine/output/page-block.mjs

@@ -1,30 +0,0 @@
-import path from "node:path";
-
-export function documentRelativePath(config, ...parts) {
-  return path.posix.join(
-    ...(config.documentDir === "." ? [] : [config.documentDir]),
-    ...parts,
-  );
-}
-
-function rewriteAssetPaths(pageHtml, config) {
-  const mediaDir = config.mediaDir.replace(/^\/+|\/+$/g, "");
-  return pageHtml
-    .replaceAll(`src="${mediaDir}/`, 'src="/openpress/media/')
-    .replaceAll(`src='${mediaDir}/`, "src='/openpress/media/");
-}
-
-export function pageToBlock(index, pageHtml, source, config, { idPrefix = "openpress-page", anchorPrefix = "page", titleFallback = "Page" } = {}) {
-  const paddedIndex = String(index + 1).padStart(2, "0");
-  const title = pageHtml.match(/data-page-title="([^"]*)"/)?.[1] ?? `${titleFallback} ${index + 1}`;
-  const anchor = pageHtml.match(/\bid="([^"]+)"/)?.[1] ?? `${anchorPrefix}-${paddedIndex}`;
-  return {
-    id: `${idPrefix}-${paddedIndex}`,
-    kind: "htmlPage",
-    title,
-    pageNumber: index + 1,
-    source,
-    html: rewriteAssetPaths(pageHtml, config),
-    anchors: [anchor],
-  };
-}

package/template/core/engine/output/pdf-media.mjs

@@ -1,45 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-
-export async function optimizePdfMediaForStaticRoot(staticRoot) {
-  await optimizePdfMedia(path.join(staticRoot, "openpress", "media"));
-}
-
-async function optimizePdfMedia(mediaDir) {
-  const files = await listImageFiles(mediaDir);
-  for (const file of files) {
-    const stat = await fs.stat(file);
-    if (stat.size < 320 * 1024) continue;
-
-    const ext = path.extname(file).toLowerCase();
-    const args =
-      ext === ".jpg" || ext === ".jpeg"
-        ? ["-Z", "1600", "--setProperty", "formatOptions", "78", file, "--out", file]
-        : ["-Z", "1600", file, "--out", file];
-    const result = spawnSync("sips", args, { stdio: "ignore" });
-    if (result.status !== 0) {
-      console.warn(`[pdf] skipped image optimization: ${path.basename(file)}`);
-    }
-  }
-}
-
-async function listImageFiles(dir) {
-  let entries;
-  try {
-    entries = await fs.readdir(dir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-
-  const files = [];
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...(await listImageFiles(fullPath)));
-    } else if (/\.(jpe?g|png)$/i.test(entry.name)) {
-      files.push(fullPath);
-    }
-  }
-  return files;
-}

package/template/core/engine/output/public-assets.mjs

@@ -1,19 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { loadConfig } from "../runtime/config.mjs";
-import { copyDirectory, writeComponentsCss, writeContentCss } from "../runtime/file-utils.mjs";
-import { copyThemeFonts } from "./fonts.mjs";
-import { copyKatexFonts } from "./katex-assets.mjs";
-
-export async function syncPublicAssets(root, publicOutputDir, config) {
-  config ??= await loadConfig(root);
-  await fs.rm(path.join(publicOutputDir, "report.css"), { force: true });
-  for (const name of ["tokens.css"]) {
-    await fs.copyFile(path.join(config.paths.themeDir, name), path.join(publicOutputDir, name));
-  }
-  await writeContentCss(root, publicOutputDir, config);
-  await copyThemeFonts(root, publicOutputDir, config);
-  await copyKatexFonts(publicOutputDir);
-  await writeComponentsCss(root, publicOutputDir, config);
-  await copyDirectory(config.paths.mediaDir, path.join(publicOutputDir, "media"));
-}