@open-press/core 1.2.0 → 1.2.1

package/engine/cli.mjs

@@ -87,7 +87,7 @@ Commands:
   typecheck
   image [--output <outputDir>] [--press <slug>] [--pages <selector>] [--no-build] [--dry-run]
   pdf [--output <outputDir>/<pdf.filename>] [--press <slug>] [--no-build] [--dry-run]
-  deploy --confirm [--dry-run]
+  deploy --confirm [--press <slug>] [--dry-run]
   doctor [--json] [--no-cache]                          # version + skill staleness check
   upgrade [--dry-run] [--no-deps] [--no-skills] [--json] # apply updates; agent-driven
   migrate [--dry-run] [--no-deps] [--no-skills] [--json] # alias for upgrade; reads migration notes

package/engine/commands/_shared.mjs

@@ -4,7 +4,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { captureUrlPagesToPng, printUrlToPdf, stopChildProcess, waitForPrintReady } from "../output/chrome-pdf.mjs";
-import { loadConfig, publicPdfHref } from "../runtime/config.mjs";
+import { loadConfig } from "../runtime/config.mjs";
 import { exportDocument } from "../document-export.mjs";
 import { optimizePdfMediaForStaticRoot } from "../output/pdf-media.mjs";
 
@@ -142,7 +142,7 @@ function pressPrintUrl(host, port, slug) {
   return `http://${host}:${port}/${normalized}?print=1`;
 }
 
-function pressSuffixedFilename(baseFilename, slug) {
+export function pressSuffixedFilename(baseFilename, slug) {
   const normalized = (slug ?? "").replace(/^\/+|\/+$/g, "");
   if (!normalized) return baseFilename;
   const ext = path.extname(baseFilename);
@@ -150,6 +150,10 @@ function pressSuffixedFilename(baseFilename, slug) {
   return `${stem}-${normalized}${ext}`;
 }
 
+export function publicPdfHrefForFilename(filename) {
+  return `/${filename}`;
+}
+
 export async function buildReactPdf({
   root,
   config,
@@ -294,18 +298,19 @@ export function startStaticServer(root, config, host, port) {
   });
 }
 
-export async function writePdfStageDeployConfig(root, source, config) {
+export async function writePdfStageDeployConfig(root, source, config, { pdfFilename = config.pdf.filename } = {}) {
   const deployRoot = path.resolve(root, source);
   const openpressDir = path.join(deployRoot, "openpress");
+  const pdfHref = publicPdfHrefForFilename(pdfFilename);
   await fs.mkdir(openpressDir, { recursive: true });
   await fs.writeFile(
     path.join(openpressDir, "deploy.json"),
-    `${JSON.stringify({ pdf: publicPdfHref(config), deployed_at: new Date().toISOString() }, null, 2)}\n`,
+    `${JSON.stringify({ pdf: pdfHref, deployed_at: new Date().toISOString() }, null, 2)}\n`,
     "utf8",
   );
   await fs.writeFile(
     path.join(deployRoot, "_headers"),
-    `${publicPdfHref(config)}\n  Content-Type: application/pdf\n  Content-Disposition: inline; filename="${config.pdf.filename}"\n`,
+    `${pdfHref}\n  Content-Type: application/pdf\n  Content-Disposition: inline; filename="${pdfFilename}"\n`,
     "utf8",
   );
 }

package/engine/commands/deploy.mjs

@@ -1,6 +1,12 @@
 import path from "node:path";
 import { deploySync } from "../output/deploy-sync.mjs";
-import { buildReactPdf, formatOpenPressCommand, runCommand, writePdfStageDeployConfig } from "./_shared.mjs";
+import {
+  buildReactPdf,
+  formatOpenPressCommand,
+  pressSuffixedFilename,
+  runCommand,
+  writePdfStageDeployConfig,
+} from "./_shared.mjs";
 
 export async function run({ root, config, options, recurse }) {
   if (config.deploy.requiresConfirmation === true && !options.confirm) {
@@ -10,11 +16,15 @@ export async function run({ root, config, options, recurse }) {
   const source = config.deploy.source;
   const projectName = config.deploy.projectName;
   const commitDirty = config.deploy.commitDirty;
+  const pressSlug = normalizePressSlug(options.press);
+  const pdfFilename = pressSuffixedFilename(config.pdf.filename, pressSlug);
+  const pdfArgs = ["pdf", ".", "--output", `${source}/${pdfFilename}`];
+  if (pressSlug) pdfArgs.push("--press", pressSlug);
   if (options.dryRun) {
     console.log("OpenPress deploy dry run");
     console.log(`Command: ${formatOpenPressCommand(["render", ".", "--renderer", "react"])}`);
     console.log(`Step:    deploy-sync (copy ${config.outputDir} → ${source})`);
-    console.log(`Command: ${formatOpenPressCommand(["pdf", ".", "--output", `${source}/${config.pdf.filename}`])}`);
+    console.log(`Command: ${formatOpenPressCommand(pdfArgs)}`);
     console.log(`Step:    write ${source}/openpress/deploy.json with deployment metadata`);
     console.log(`Command: npx wrangler pages deploy ${source}${projectName ? ` --project-name=${projectName}` : ""}${commitDirty ? " --commit-dirty=true" : ""}`);
     return 0;
@@ -22,10 +32,15 @@ export async function run({ root, config, options, recurse }) {
   const renderCode = await recurse("render", [root, "--renderer", "react"]);
   if (renderCode !== 0) return renderCode;
   await deploySync(root, config.outputDir, source);
-  await buildReactPdf({ root, config, outPath: path.resolve(root, source, config.pdf.filename), noBuild: true, recurse });
-  await writePdfStageDeployConfig(root, source, config);
+  await buildReactPdf({ root, config, outPath: path.resolve(root, source, pdfFilename), noBuild: true, recurse, pressSlug });
+  await writePdfStageDeployConfig(root, source, config, { pdfFilename });
   const wranglerArgs = ["wrangler", "pages", "deploy", source];
   if (projectName) wranglerArgs.push(`--project-name=${projectName}`);
   if (commitDirty) wranglerArgs.push("--commit-dirty=true");
   return runCommand("npx", wranglerArgs, root);
 }
+
+function normalizePressSlug(value) {
+  if (typeof value !== "string") return "";
+  return value.trim().replace(/^\/+|\/+$/g, "");
+}

package/engine/output/static-server.mjs

@@ -283,6 +283,11 @@ async function handleDeployRequest(req, res) {
     return;
   }
 
+  const body = await readJsonBody(req);
+  const slug = normalizePressSlug(body?.press);
+  const command = slug ? `open-press deploy . --confirm --press ${slug}` : "open-press deploy . --confirm";
+  const pdfFilename = pressFilename(config.pdf.filename, slug);
+
   if (!isDeployConfigured()) {
     writeJson(res, 400, {
       ok: false,
@@ -292,15 +297,15 @@ async function handleDeployRequest(req, res) {
       deploy_adapter: config.deploy.adapter,
       deploy_source: config.deploy.source,
       deploy_project_name: config.deploy.projectName,
-      command: "open-press deploy . --confirm",
+      command,
     });
     return;
   }
 
-  const result = await runDeploy();
+  const result = await runDeploy(slug);
   const deployedUrl = extractDeployUrl(result.stdout);
   if (result.code === 0 && deployedUrl) {
-    await writeDeploymentPublicUrl(deployedUrl);
+    await writeDeploymentPublicUrl(deployedUrl, pdfFilename);
   }
   const deploymentInfo = await readDeploymentInfo();
   const publicUrl = deployedUrl ?? deploymentInfo.public_url;
@@ -308,10 +313,10 @@ async function handleDeployRequest(req, res) {
     ok: result.code === 0,
     code: result.code,
     deployed_at: deploymentInfo.deployed_at,
-    pdf: deployedUrl ? `${deployedUrl}/${config.pdf.filename}` : deploymentInfo.pdf,
+    pdf: deployedUrl ? `${deployedUrl}/${pdfFilename}` : deploymentInfo.pdf,
     public_url: publicUrl,
     dirty: false,
-    command: "open-press deploy . --confirm",
+    command,
     stdout: result.stdout,
     stderr: result.stderr,
   });
@@ -419,9 +424,11 @@ function runLocalPdfExport(slug = "") {
   });
 }
 
-function runDeploy() {
+function runDeploy(slug = "") {
+  const cliArgs = [CLI_ENTRY, "deploy", ".", "--confirm"];
+  if (slug) cliArgs.push("--press", slug);
   return new Promise((resolve) => {
-    const child = spawn("node", [CLI_ENTRY, "deploy", ".", "--confirm"], {
+    const child = spawn("node", cliArgs, {
       cwd: workspace,
       shell: false,
     });
@@ -485,7 +492,7 @@ async function readDeploymentInfo() {
   }
 }
 
-async function writeDeploymentPublicUrl(publicUrl) {
+async function writeDeploymentPublicUrl(publicUrl, pdfFilename = config.pdf.filename) {
   let deployConfig = {};
   try {
     deployConfig = JSON.parse(await fs.readFile(config.paths.deployMetadata, "utf8"));
@@ -495,7 +502,7 @@ async function writeDeploymentPublicUrl(publicUrl) {
   await fs.mkdir(path.dirname(config.paths.deployMetadata), { recursive: true });
   await fs.writeFile(
     config.paths.deployMetadata,
-    `${JSON.stringify({ ...deployConfig, pdf: `${publicUrl}/${config.pdf.filename}`, public_url: publicUrl }, null, 2)}\n`,
+    `${JSON.stringify({ ...deployConfig, pdf: `${publicUrl}/${pdfFilename}`, public_url: publicUrl }, null, 2)}\n`,
     "utf8",
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-press/core",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "open-press core — runtime primitives, CLI, and render pipeline for AI-first fixed-layout documents.",
   "license": "MIT",

package/src/openpress/app/OpenPressApp.tsx

@@ -230,7 +230,10 @@ export function OpenPressApp() {
   const presentationSlug = state.activeSlug || currentRouteFromLocation().slug;
   const openPresentation = state.document.meta.type === "slides" && presentationSlug
     ? (pageIndex: number) => {
-        openPressRoute(presentationSlug, "present", pageIndex, { fullscreen: true });
+        const slug = normalizeSlug(presentationSlug);
+        const pathname = slug ? `/${slug}` : "/";
+        const hash = `#page-${String(pageIndex + 1).padStart(2, "0")}`;
+        window.open(`${pathname}?fullscreen=1${hash}`, "_blank", "noopener,noreferrer");
       }
     : undefined;
 

package/src/openpress/app/OpenPressRuntime.tsx

@@ -1,5 +1,5 @@
 import { useEffect, useMemo, useState, type CSSProperties } from "react";
-import { PrintDocument, PublicViewer, SlidePresentationPage } from "../reader";
+import { PrintDocument, PublicViewer, SlidePublicViewer, SlidePresentationPage } from "../reader";
 import { isPresentationModeLocation, isPrintModeLocation, isWorkspaceModeLocation } from "../shared";
 import { HtmlWorkbench } from "../workbench";
 import type {
@@ -82,6 +82,20 @@ export function OpenPressRuntime({
       );
     }
 
+    if (!workspaceMode && document.meta.type === "slides") {
+      const slideDeploymentInfo = activeSlug
+        ? { ...deploymentInfo, pdf: resolvePressPdfUrl(deploymentInfo.pdf, activeSlug) }
+        : deploymentInfo;
+      return (
+        <SlidePublicViewer
+          document={document}
+          pages={htmlPages}
+          style={style}
+          deploymentInfo={slideDeploymentInfo}
+        />
+      );
+    }
+
     if (!workspaceMode) {
       return <PublicViewer document={document} pages={htmlPages} style={style} deploymentInfo={deploymentInfo} />;
     }
@@ -164,6 +178,17 @@ function useLocationVersion() {
   return version;
 }
 
+function resolvePressPdfUrl(basePdfUrl: string | undefined, slug: string): string | undefined {
+  if (!basePdfUrl) return undefined;
+  const lastSlash = basePdfUrl.lastIndexOf("/");
+  const dir = lastSlash >= 0 ? basePdfUrl.slice(0, lastSlash + 1) : "";
+  const filename = lastSlash >= 0 ? basePdfUrl.slice(lastSlash + 1) : basePdfUrl;
+  const dot = filename.lastIndexOf(".");
+  const stem = dot >= 0 ? filename.slice(0, dot) : filename;
+  const ext = dot >= 0 ? filename.slice(dot) : "";
+  return `${dir}${stem}-${slug}${ext}`;
+}
+
 function themeToCssVariables(theme?: Theme) {
   const style: CSSProperties & Record<`--${string}`, string> = {
     "--openpress-font-family": theme?.fontFamily ?? "'Noto Sans TC', 'PingFang TC', sans-serif",

package/src/openpress/reader/PageThumbnailsPanel.tsx

@@ -13,11 +13,15 @@ export function PageThumbnails({
   pages,
   currentPageIndex,
   onSelectPage,
+  selectedPageIndexes,
+  onTogglePage,
   theme,
 }: {
   pages: HtmlPageBlock[];
   currentPageIndex: number;
   onSelectPage: (pageIndex: number, options?: { behavior?: ScrollBehavior }) => void;
+  selectedPageIndexes?: ReadonlySet<number>;
+  onTogglePage?: (pageIndex: number) => void;
   theme?: Theme;
 }) {
   const pageWidthPx = parsePxLength(theme?.pageWidth) ?? FALLBACK_PAGE_WIDTH_PX;
@@ -40,7 +44,15 @@ export function PageThumbnails({
             page={page}
             index={index}
             active={index === currentPageIndex}
-            onClick={() => onSelectPage(index, { behavior: "smooth" })}
+            selected={selectedPageIndexes?.has(index) ?? false}
+            selectionMode={Boolean(selectedPageIndexes && onTogglePage)}
+            onClick={() => {
+              if (selectedPageIndexes && onTogglePage) {
+                onTogglePage(index);
+                return;
+              }
+              onSelectPage(index, { behavior: "smooth" });
+            }}
             pageWidthPx={pageWidthPx}
             pageHeightPx={pageHeightPx}
             aspectRatio={aspectRatio}
@@ -55,6 +67,8 @@ function ThumbnailCard({
   page,
   index,
   active,
+  selected,
+  selectionMode,
   onClick,
   pageWidthPx,
   pageHeightPx,
@@ -63,6 +77,8 @@ function ThumbnailCard({
   page: HtmlPageBlock;
   index: number;
   active: boolean;
+  selected: boolean;
+  selectionMode: boolean;
   onClick: () => void;
   pageWidthPx: number;
   pageHeightPx: number;
@@ -92,7 +108,7 @@ function ThumbnailCard({
     cardRef.current?.scrollIntoView({ block: "nearest" });
   }, [active]);
 
-  const className = `openpress-thumb-card${active ? " is-active" : ""}`;
+  const className = `openpress-thumb-card${active ? " is-active" : ""}${selected ? " is-selected" : ""}`;
   // Wrap the page HTML using the same class structure as the main
   // reader (`.openpress-html-page > .openpress-html-page__html`) so
   // section-scoped CSS that targets those classes still applies in
@@ -124,12 +140,14 @@ function ThumbnailCard({
   return (
     <div
       ref={cardRef}
-      role="button"
+      role={selectionMode ? "checkbox" : "button"}
       tabIndex={0}
       className={className}
       data-openpress-thumb-index={index}
-      aria-label={`前往第 ${index + 1} 頁：${pageTitle}`}
-      aria-current={active ? "page" : undefined}
+      data-openpress-thumb-selected={selectionMode ? (selected ? "true" : "false") : undefined}
+      aria-label={selectionMode ? `選取第 ${index + 1} 頁：${pageTitle}` : `前往第 ${index + 1} 頁：${pageTitle}`}
+      aria-checked={selectionMode ? selected : undefined}
+      aria-current={!selectionMode && active ? "page" : undefined}
       onClick={onClick}
       onKeyDown={(event) => {
         if (event.key === "Enter" || event.key === " ") {
@@ -138,6 +156,11 @@ function ThumbnailCard({
         }
       }}
     >
+      {selectionMode ? (
+        <span className="openpress-thumb-card__check" aria-hidden="true">
+          {selected ? "✓" : ""}
+        </span>
+      ) : null}
       <div className="openpress-thumb-card__surface" ref={surfaceRef} style={{ aspectRatio }}>
         <div className="openpress-thumb-card__frame" style={frameStyle}>
           <div className={pageClass} style={pageStyle} data-openpress-thumb-page="true">

package/src/openpress/reader/SlidePresentationPage.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useMemo, useRef, useState, type CSSProperties, type MouseEvent as ReactMouseEvent } from "react";
-import { Maximize2, X } from "lucide-react";
+import { Download, Maximize2, X } from "lucide-react";
 import { createPageObjectEntityId } from "../document-model";
-import type { HtmlPageBlock, ReaderDocument } from "../document-model";
+import type { DeploymentInfo, HtmlPageBlock, ReaderDocument } from "../document-model";
 import { pageIndexFromHash, replacePageRoute } from "./readerPageRoute";
 import { clampReaderPageIndex, formatReaderPageNumber, normalizeReaderPageCount } from "./readerStateModel";
 import { usePageViewportScale } from "./usePageViewportScale";
@@ -13,11 +13,13 @@ export function SlidePresentationPage({
   pages,
   style,
   onExitPresentation,
+  deploymentInfo,
 }: {
   document: ReaderDocument;
   pages: HtmlPageBlock[];
   style: CSSProperties;
   onExitPresentation?: (pageIndex: number) => void;
+  deploymentInfo?: DeploymentInfo;
 }) {
   const sourceContainerRef = useRef<HTMLDivElement | null>(null);
   const stageRef = useRef<HTMLElement | null>(null);
@@ -35,6 +37,8 @@ export function SlidePresentationPage({
     pageContainerRef: sourceContainerRef,
     pageCount: pages.length,
     layoutMode: "single",
+    initialScaleMode: "fit-page",
+    maxFitScale: Infinity,
   });
   const currentPage = pages[clampReaderPageIndex(currentPageIndex, normalizedPageCount)];
   const currentPageLabel = formatReaderPageNumber(currentPageIndex + 1);
@@ -66,13 +70,6 @@ export function SlidePresentationPage({
     const handleKeyDown = (event: KeyboardEvent) => {
       if (isEditableTarget(event.target)) return;
       if (event.key === "Escape") {
-        // Esc is reserved for exiting browser fullscreen. The chrome HUD
-        // already exposes explicit "re-enter fullscreen" and "close"
-        // buttons; navigating out of the presenter from a stray keystroke
-        // would yank the user back to the workspace shell unexpectedly
-        // (and racily, since the same Esc that triggered the browser's
-        // fullscreen exit is also delivered to this handler with
-        // fullscreenElement already null).
         const activeDocument = globalThis.document;
         if (activeDocument.fullscreenElement && activeDocument.exitFullscreen) {
           event.preventDefault();
@@ -183,6 +180,11 @@ export function SlidePresentationPage({
       </section>
 
       <div className="openpress-slide-presenter__hud" aria-label="放映控制">
+        {deploymentInfo && document.meta.title ? (
+          <span className="openpress-slide-presenter__title" aria-label="簡報標題">
+            {document.meta.title}
+          </span>
+        ) : null}
         <span
           className="openpress-slide-presenter__progress"
           data-openpress-present-progress
@@ -200,16 +202,31 @@ export function SlidePresentationPage({
         >
           <Maximize2 aria-hidden="true" />
         </button>
-        <button
-          type="button"
-          className="openpress-slide-presenter__button"
-          data-openpress-present-exit
-          onClick={() => onExitPresentation?.(currentPageIndex)}
-          aria-label="回到工作台"
-          title="回到工作台"
-        >
-          <X aria-hidden="true" />
-        </button>
+        {deploymentInfo?.pdf ? (
+          <a
+            href={deploymentInfo.pdf}
+            target="_blank"
+            rel="noopener noreferrer"
+            className="openpress-slide-presenter__button"
+            data-openpress-present-pdf
+            aria-label="下載 PDF"
+            title="下載 PDF"
+          >
+            <Download aria-hidden="true" />
+          </a>
+        ) : null}
+        {onExitPresentation ? (
+          <button
+            type="button"
+            className="openpress-slide-presenter__button"
+            data-openpress-present-exit
+            onClick={() => onExitPresentation(currentPageIndex)}
+            aria-label="回到工作台"
+            title="回到工作台"
+          >
+            <X aria-hidden="true" />
+          </button>
+        ) : null}
       </div>
     </main>
   );