@open-press/cli 0.6.0 → 0.7.0

package/template/core/src/openpress/workbench.tsx

@@ -33,18 +33,14 @@ import {
   ProjectEntryPanel,
   type ProjectMentionItem,
 } from "./projectWorkspace";
-import { paginateSourcePages, type PaginatedPage } from "./pagination";
+import { createAnchorPageMap, resolveAnchorPageIndex } from "./anchorMap";
 import { scheduleBrowserFrame } from "./frameScheduler";
 import {
-  createAnchorPageMap,
-  numberSourceHeadings,
   PUBLIC_DRAWER_BREAKPOINT,
   PublicPage,
-  resolveAnchorPageIndex,
   useViewMode,
 } from "./publicPage";
 import { getProjectIdentity } from "./projectIdentity";
-import { hasBuildTimePagination } from "./reactDocumentMetadata";
 import { buildPublicPreviewHref, isLocalWorkspaceHost } from "./runtimeMode";
 import { useReaderRuntime } from "./readerRuntime";
 import type { DeploymentInfo, ReaderDocument, HtmlPageBlock, SourceBlock } from "./types";
@@ -123,14 +119,9 @@ export function HtmlWorkbench({
   deploymentInfo: DeploymentInfo;
 }) {
   const sourceContainerRef = useRef<HTMLDivElement | null>(null);
-  const numberedPages = useMemo(() => numberSourceHeadings(pages), [pages]);
+  const displayPages = pages;
   const viewModeState = useViewMode();
   const { viewMode } = viewModeState;
-  const buildTimePaginated = hasBuildTimePagination(document);
-  const [paginatedPages, setPaginatedPages] = useState<PaginatedPage[] | null>(null);
-  const displayPages: DisplayPage[] = viewMode === "paged" && !buildTimePaginated
-    ? (paginatedPages ?? numberedPages)
-    : numberedPages;
   const mediaAssets = useMemo(() => collectMediaAssetIndex(displayPages), [displayPages]);
   const anchorPageMap = useMemo(() => createAnchorPageMap(displayPages), [displayPages]);
   const projectComponentUsages = useMemo(() => createProjectComponentUsages(displayPages), [displayPages]);
@@ -163,7 +154,6 @@ export function HtmlWorkbench({
   const pdfButtonText = workbenchPdfButtonText(localDeployEnabled, pdfActionStatus, staticPdfHref);
   const pdfStatusMessage = workbenchPdfStatusMessage(localDeployEnabled, pdfActionStatus);
   const pdfButtonDisabled = localDeployEnabled ? pdfActionStatus === "generating" || pdfActionStatus === "opening" : !staticPdfHref;
-  const activePaginatedReady = viewMode === "reading" || buildTimePaginated || Boolean(paginatedPages);
   const inspectorSelectionLabel = formatInspectorSelection(inspector.selectedBlock);
   const activeInlineSavedComment = getInlineSavedCommentForTarget(inlineSavedComment, inspector.selectedTarget);
   const inspectorCommentDisabled = !inspector.selectedBlock || !inspectorCommentText.trim() || inspectorCommentStatus === "submitting";
@@ -392,10 +382,6 @@ export function HtmlWorkbench({
     scheduleBrowserFrame(() => reader.setPage(reader.currentPageIndex, { behavior: "auto" }));
   };
 
-  useLayoutEffect(() => {
-    setPaginatedPages(null);
-  }, [numberedPages]);
-
   useEffect(() => {
     setInspectorCommentStatus("idle");
     setInspectorCommentError("");
@@ -407,24 +393,6 @@ export function HtmlWorkbench({
     void refreshPendingComments();
   }, [devMode, refreshPendingComments, workspaceView]);
 
-  useLayoutEffect(() => {
-    if (buildTimePaginated) return undefined;
-    if (viewMode !== "paged" || paginatedPages) return undefined;
-    const sourceContainer = sourceContainerRef.current;
-    if (!sourceContainer) return undefined;
-
-    let cancelled = false;
-    const cancelFrame = scheduleBrowserFrame(() => {
-      const nextPages = paginateSourcePages(sourceContainer, numberedPages);
-      if (!cancelled) setPaginatedPages(nextPages);
-    });
-
-    return () => {
-      cancelled = true;
-      cancelFrame();
-    };
-  }, [buildTimePaginated, numberedPages, paginatedPages, viewMode]);
-
   const actionSection = (
     <section className="openpress-public-action-section" aria-label="輸出">
       <span className="openpress-public-action-heading">輸出</span>
@@ -512,7 +480,6 @@ export function HtmlWorkbench({
         className={`reader-app openpress-reader-app openpress-public-viewer openpress-dev-public-viewer is-ready${reader.rightPanelOpen ? "" : " is-closed-right"}`}
         data-openpress-react-runtime="true"
         data-openpress-view-mode={viewMode}
-        data-openpress-pagination={activePaginatedReady ? "ready" : "pending"}
         data-openpress-inspector-mode={inspector.inspectorMode ? "on" : "off"}
         data-active-workspace={workspaceView}
       >
@@ -533,7 +500,6 @@ export function HtmlWorkbench({
               pages={displayPages}
               currentPageIndex={reader.currentPageIndex}
               devMode={devMode}
-              paginatedReady={activePaginatedReady}
               sourceContainerRef={sourceContainerRef}
               registerPage={reader.registerPage}
               exposeSourceData={devMode}

package/template/core/src/styles/openpress/responsive.css

@@ -269,12 +269,6 @@
     box-shadow: none;
   }
 
-  .openpress-public-viewer.openpress-reader-app[data-openpress-pagination="pending"] .openpress-public-navigation {
-    transform: translateX(-110%);
-    pointer-events: none;
-    box-shadow: none;
-  }
-
   .openpress-public-viewer.openpress-reader-app .openpress-public-scrim {
     position: fixed;
     inset: 0;
@@ -309,14 +303,6 @@
     display: block;
   }
 
-  .openpress-public-viewer.openpress-reader-app[data-openpress-pagination="pending"] .openpress-public-scrim {
-    display: none;
-  }
-
-  .openpress-public-viewer.openpress-reader-app[data-openpress-pagination="pending"] .openpress-public-fab {
-    display: flex;
-  }
-
   .openpress-public-viewer[data-openpress-view-mode="paged"] .reader-pages {
     --openpress-public-page-width: min(
       var(--openpress-page-width),

package/template/core/tsconfig.json

@@ -17,7 +17,10 @@
     "noEmit": true,
     "jsx": "react-jsx",
     "paths": {
-      "@openpress/core": ["./src/openpress/core/index.tsx"],
+      "@open-press/core": ["./src/openpress/core/index.tsx"],
+      "@open-press/core/mdx": ["./src/openpress/mdx/index.ts"],
+      "@open-press/core/manuscript": ["./src/openpress/manuscript/index.tsx"],
+      "@open-press/core/numbering": ["./src/openpress/numbering/index.ts"],
       "@/components": ["./document/components/index.ts", "./document/components/index.tsx"],
       "@/components/*": ["./document/components/*"],
       "@/*": ["./src/*"]

package/template/core/vite.config.ts

@@ -5,7 +5,7 @@ import path from "node:path";
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react";
-import { loadConfig, publicPdfHref } from "./engine/config.mjs";
+import { loadConfig, publicPdfHref } from "./engine/runtime/config.mjs";
 import { handleCommentRequest } from "./engine/react/comment-endpoint.mjs";
 import { handleProjectAssetRequest } from "./engine/react/project-asset-endpoint.mjs";
 
@@ -15,8 +15,11 @@ const workspaceRoot = process.env.OPENPRESS_WORKSPACE_ROOT
   : frameworkRoot;
 const sourceRoot = path.join(frameworkRoot, "src");
 const openpressCliPath = path.join(frameworkRoot, "engine", "cli.mjs");
-const staticServerPath = path.join(frameworkRoot, "engine", "static-server.mjs");
+const staticServerPath = path.join(frameworkRoot, "engine", "output", "static-server.mjs");
 const openpressCoreEntry = path.join(frameworkRoot, "src", "openpress", "core", "index.tsx");
+const openpressMdxEntry = path.join(frameworkRoot, "src", "openpress", "mdx", "index.ts");
+const openpressManuscriptEntry = path.join(frameworkRoot, "src", "openpress", "manuscript", "index.tsx");
+const openpressNumberingEntry = path.join(frameworkRoot, "src", "openpress", "numbering", "index.ts");
 const openpressConfig = await loadConfig(workspaceRoot);
 const outputDir = openpressConfig.paths.outputDir;
 const reactDocumentRoot = openpressConfig.paths.documentRoot;
@@ -55,7 +58,11 @@ export default defineConfig({
   resolve: {
     dedupe: ["react", "react-dom", "@mdx-js/react"],
     alias: {
-      "@openpress/core": openpressCoreEntry,
+      // Subpaths must come before the base path so resolution matches longest first.
+      "@open-press/core/mdx": openpressMdxEntry,
+      "@open-press/core/manuscript": openpressManuscriptEntry,
+      "@open-press/core/numbering": openpressNumberingEntry,
+      "@open-press/core": openpressCoreEntry,
       "@/components": reactDocumentComponentsRoot,
       "@": sourceRoot,
       ...workspaceAliases,

package/template/packs/academic-paper/document/components/Page.tsx

@@ -1,27 +1,37 @@
-import type { PageProps } from "@openpress/core";
+import { Frame, MdxArea } from "@open-press/core";
+import type { SectionsPageProps } from "@open-press/core/manuscript";
 
 export default function Page({
+  frameKey,
+  chainId,
   pageIndex,
   totalPages,
-  chapterSlug,
-  chapterTone,
-  children,
-}: PageProps) {
+  sectionSlug,
+  sectionTitle,
+  sectionTone,
+}: SectionsPageProps) {
   return (
-    <section
-      className="reader-page reader-page--content"
-      data-page-kind="content"
-      data-page-footer="true"
+    <Frame
+      frameKey={frameKey}
+      role="manuscript.content"
+      className="reader-page--content"
       data-page-index={pageIndex}
       data-total-pages={totalPages}
-      data-chapter-slug={chapterSlug}
-      data-chapter-tone={chapterTone}
+      data-section-id={sectionSlug}
+      data-chapter-tone={sectionTone}
     >
       <div className="page-frame">
         <header className="page-header" aria-hidden="true" />
-        <main className="page-body">{children}</main>
-        <footer className="page-footer" aria-hidden="true" />
+        <main className="page-body">
+          <MdxArea chainId={chainId} />
+        </main>
+        <footer className="page-footer" aria-hidden="true">
+          <span className="footer-left">{sectionTitle}</span>
+          <span className="footer-right">
+            {totalPages > 1 ? `${pageIndex + 1}/${totalPages}` : pageIndex + 1}
+          </span>
+        </footer>
       </div>
-    </section>
+    </Frame>
   );
 }

package/template/packs/academic-paper/document/design.md

@@ -112,7 +112,7 @@ Block-level 強調(callout / warning / note)目前不在 design system 範圍;
 
 ### Chapter & Section Numbering
 
-Engine 不在 h2/h3 內容前注入任何編號或前綴;pagination runtime 計數後寫入 `data-chapter` / `data-section` attribute(值是 `01`、`1.1` 這種兩位數阿拉伯格式)。實際顯示樣式由 theme 的 `::before content` 決定,這讓不同文件能挑不同 numbering vocabulary 而不動 engine。
+Engine 不在 h2/h3 內容前注入任何編號或前綴;export pipeline 會在 build-time 寫入 `data-chapter` / `data-section` attribute(值是 `01`、`1.1` 這種兩位數阿拉伯格式)。實際顯示樣式由 theme 的 `::before content` 決定,這讓不同文件能挑不同 numbering vocabulary 而不動 reader runtime。
 
 預設(editorial-monograph 起手樣式):
 
@@ -258,7 +258,7 @@ body 內容區的 page padding(content margin)由 `.reader-page` 內的 `--page-
 | 資料歸資料 | chart data 透過 React props 或鄰近的 typed data module 傳入,不寫死在 CSS |
 | 樣式歸樣式 | chart frame 等通用規則放在 `document/theme/patterns/`;變體 CSS 放在元件自己的 `style.css` |
 | 元件歸元件 | 一個視覺 = 一個 `document/components/ComponentName/` 包;MDX 只保留 `<ComponentName />` 呼叫 |
-| Caption 必填 | caption 只寫說明文字,不手寫圖號或表號;runtime 會替 content pages 的 figure/table 自動編號 |
+| Caption 必填 | caption 只寫說明文字,不手寫圖號或表號;export pipeline 會替 content pages 的 figure/table 自動編號 |
 | PDF-safe | 圖表需 `break-inside: avoid`,高度不可壓到 footer |
 
 如果使用者要求新的視覺元件,Agent 應先更新本檔說明,再改對應的 `document/components/<name>/style.css` 或 `document/theme/` CSS,最後用 reader 預覽檢查 PDF 輸出。

package/template/packs/academic-paper/document/index.tsx

@@ -1,5 +1,8 @@
-import type { Manifest } from "@openpress/core";
-import { BaseBackCoverPage, BaseCoverPage, BaseTocPage } from "@openpress/core";
+import { Frame, Press } from "@open-press/core";
+import type { Manifest } from "@open-press/core";
+import { mdxSource } from "@open-press/core/mdx";
+import { Sections, Toc } from "@open-press/core/manuscript";
+import Page from "./components/Page";
 
 export const config: Manifest = {
   title: "Paper Title",
@@ -24,84 +27,105 @@ export const config: Manifest = {
   },
 };
 
+export const sources = {
+  story: mdxSource({ preset: "section-folders", root: "chapters" }),
+};
+
 /**
  * The cover renders the academic title block: paper title, author grid,
  * abstract band, and index terms. Replace the placeholders with your own.
  */
-export const cover = (
-  <BaseCoverPage data-page-title="Title page" aria-labelledby="paper-title">
-    <div className="paper-cover">
-      <h1 id="paper-title" className="paper-title">
-        Conference Paper Title
-      </h1>
-      <p className="paper-subtitle">
-        Sub-title (optional). Not captured by indexing services like IEEE Xplore.
-      </p>
+function Cover() {
+  return (
+    <Frame
+      frameKey="cover"
+      role="manuscript.cover"
+      chrome={false}
+      className="reader-page--cover"
+      data-page-title="Title page"
+      aria-labelledby="paper-title"
+    >
+      <div className="paper-cover">
+        <h1 id="paper-title" className="paper-title">
+          Conference Paper Title
+        </h1>
+        <p className="paper-subtitle">
+          Sub-title (optional). Not captured by indexing services like IEEE Xplore.
+        </p>
 
-      <ol className="paper-authors" aria-label="Authors">
-        <li className="paper-author">
-          <p className="paper-author-name">First Author Surname</p>
-          <p className="paper-author-affiliation">dept. of organization</p>
-          <p className="paper-author-affiliation">name of organization</p>
-          <p className="paper-author-location">City, Country</p>
-          <p className="paper-author-contact">email or ORCID</p>
-        </li>
-        <li className="paper-author">
-          <p className="paper-author-name">Second Author Surname</p>
-          <p className="paper-author-affiliation">dept. of organization</p>
-          <p className="paper-author-affiliation">name of organization</p>
-          <p className="paper-author-location">City, Country</p>
-          <p className="paper-author-contact">email or ORCID</p>
-        </li>
-        <li className="paper-author">
-          <p className="paper-author-name">Third Author Surname</p>
-          <p className="paper-author-affiliation">dept. of organization</p>
-          <p className="paper-author-affiliation">name of organization</p>
-          <p className="paper-author-location">City, Country</p>
-          <p className="paper-author-contact">email or ORCID</p>
-        </li>
-      </ol>
+        <ol className="paper-authors" aria-label="Authors">
+          <li className="paper-author">
+            <p className="paper-author-name">First Author Surname</p>
+            <p className="paper-author-affiliation">dept. of organization</p>
+            <p className="paper-author-affiliation">name of organization</p>
+            <p className="paper-author-location">City, Country</p>
+            <p className="paper-author-contact">email or ORCID</p>
+          </li>
+          <li className="paper-author">
+            <p className="paper-author-name">Second Author Surname</p>
+            <p className="paper-author-affiliation">dept. of organization</p>
+            <p className="paper-author-affiliation">name of organization</p>
+            <p className="paper-author-location">City, Country</p>
+            <p className="paper-author-contact">email or ORCID</p>
+          </li>
+          <li className="paper-author">
+            <p className="paper-author-name">Third Author Surname</p>
+            <p className="paper-author-affiliation">dept. of organization</p>
+            <p className="paper-author-affiliation">name of organization</p>
+            <p className="paper-author-location">City, Country</p>
+            <p className="paper-author-contact">email or ORCID</p>
+          </li>
+        </ol>
 
-      <section className="paper-abstract" aria-label="Abstract">
-        <p>
-          <span className="paper-abstract-label">Abstract</span>—This document
-          is a model and starting point for an academic paper drafted in
-          open-press. Replace this abstract with your own — keep it under
-          250 words. Do not use abbreviations, symbols, footnotes, or math
-          in the abstract.
-        </p>
-      </section>
+        <section className="paper-abstract" aria-label="Abstract">
+          <p>
+            <span className="paper-abstract-label">Abstract</span>—This document
+            is a model and starting point for an academic paper drafted in
+            open-press. Replace this abstract with your own — keep it under
+            250 words. Do not use abbreviations, symbols, footnotes, or math
+            in the abstract.
+          </p>
+        </section>
 
-      <section className="paper-index-terms" aria-label="Index terms">
-        <p>
-          <span className="paper-abstract-label">Index Terms</span>—keyword
-          one, keyword two, keyword three, keyword four
-        </p>
-      </section>
-    </div>
-  </BaseCoverPage>
-);
+        <section className="paper-index-terms" aria-label="Index terms">
+          <p>
+            <span className="paper-abstract-label">Index Terms</span>—keyword
+            one, keyword two, keyword three, keyword four
+          </p>
+        </section>
+      </div>
+    </Frame>
+  );
+}
 
-export const toc = (
-  <BaseTocPage data-page-title="Contents" id="toc">
-    <div className="page-frame">
-      <header className="page-header" aria-hidden="true"></header>
-      <main className="page-body">
-        <h2 id="toc-title" className="toc-heading">Contents</h2>
-      </main>
-    </div>
-  </BaseTocPage>
-);
+function BackCover() {
+  return (
+    <Frame
+      frameKey="back-cover"
+      role="manuscript.back-cover"
+      chrome={false}
+      className="reader-page--back-cover"
+      data-page-title="Back cover"
+    >
+      <div className="paper-back-cover">
+        <p className="paper-back-kicker">open-press · academic-paper</p>
+        <p className="paper-back-statement">
+          Draft built with open-press. When the paper is ready for submission,
+          port the prose into the publisher's LaTeX class (IEEEtran, acmart,
+          etc.). open-press is the iteration loop, not the camera-ready output.
+        </p>
+      </div>
+    </Frame>
+  );
+}
 
-export const backCover = (
-  <BaseBackCoverPage data-page-title="Back cover">
-    <div className="paper-back-cover">
-      <p className="paper-back-kicker">open-press · academic-paper</p>
-      <p className="paper-back-statement">
-        Draft built with open-press. When the paper is ready for submission,
-        port the prose into the publisher's LaTeX class (IEEEtran, acmart,
-        etc.). open-press is the iteration loop, not the camera-ready output.
-      </p>
-    </div>
-  </BaseBackCoverPage>
-);
+export default function AcademicPaperPress() {
+  return (
+    <Press>
+      <Cover />
+      <Toc source="story" heading={<h2 id="toc-title" className="toc-heading">Contents</h2>} />
+      <Sections source="story" page={Page} />
+      <BackCover />
+    </Press>
+  );
+}

package/template/packs/academic-paper/document/theme/page-surfaces/toc.css

@@ -1,12 +1,26 @@
 /* page-surfaces / toc
- * Table-of-contents page surface routed by `kind: toc` and built by the
- * engine's renderToc(). Layout uses a 3-column grid (index / title / page).
+ * Table-of-contents page surface rendered by the manuscript <Toc> helper.
+ * Entries flow through the generated toc:<sourceId> chain and TocArea.
  */
 
 .reader-page--toc {
   padding: 0;
 }
 
+.reader-page--toc .page-frame {
+  grid-template-rows: auto minmax(0, 1fr);
+}
+
+.reader-page--toc .toc-header {
+  display: block;
+  overflow: visible;
+  opacity: 1;
+}
+
+.reader-page--toc .openpress-toc-area {
+  height: 100%;
+}
+
 .reader-page--toc h2 {
   margin-top: 0;
   font-family: var(--openpress-font-serif);
@@ -18,13 +32,7 @@
 }
 
 .reader-page--toc h2.toc-heading--continuation {
-  margin-bottom: 0;
-  color: var(--openpress-color-muted);
-  font-family: var(--openpress-font-mono);
-  font-size: calc(8.5pt - var(--openpress-type-step-down));
-  font-weight: 400;
-  letter-spacing: 0.08em;
-  text-align: right;
+  display: none;
 }
 
 .toc-list {
@@ -51,6 +59,7 @@
   align-items: baseline;
   color: var(--openpress-color-ink);
   text-decoration: none;
+  font-family: var(--openpress-font-serif);
   padding: 1.6mm 0;
   font-weight: 400;
   line-height: 1.38;
@@ -117,6 +126,7 @@
   gap: 3mm;
   align-items: baseline;
   color: var(--openpress-color-ink);
+  font-family: var(--openpress-font-serif);
 }
 
 .toc-title::after {

package/template/packs/claude-document/document/components/Page.tsx

@@ -1,27 +1,37 @@
-import type { PageProps } from "@openpress/core";
+import { Frame, MdxArea } from "@open-press/core";
+import type { SectionsPageProps } from "@open-press/core/manuscript";
 
 export default function Page({
+  frameKey,
+  chainId,
   pageIndex,
   totalPages,
-  chapterSlug,
-  chapterTone,
-  children,
-}: PageProps) {
+  sectionSlug,
+  sectionTitle,
+  sectionTone,
+}: SectionsPageProps) {
   return (
-    <section
-      className="reader-page reader-page--content"
-      data-page-kind="content"
-      data-page-footer="true"
+    <Frame
+      frameKey={frameKey}
+      role="manuscript.content"
+      className="reader-page--content"
       data-page-index={pageIndex}
       data-total-pages={totalPages}
-      data-chapter-slug={chapterSlug}
-      data-chapter-tone={chapterTone}
+      data-section-id={sectionSlug}
+      data-chapter-tone={sectionTone}
     >
       <div className="page-frame">
         <header className="page-header" aria-hidden="true" />
-        <main className="page-body">{children}</main>
-        <footer className="page-footer" aria-hidden="true" />
+        <main className="page-body">
+          <MdxArea chainId={chainId} />
+        </main>
+        <footer className="page-footer" aria-hidden="true">
+          <span className="footer-left">{sectionTitle}</span>
+          <span className="footer-right">
+            {totalPages > 1 ? `${pageIndex + 1}/${totalPages}` : pageIndex + 1}
+          </span>
+        </footer>
       </div>
-    </section>
+    </Frame>
   );
 }

package/template/packs/claude-document/document/design.md

@@ -102,7 +102,7 @@ Claude Document 以 sans 作為主要閱讀字體,讓正文、表格與長段落
 
 ### Tables
 
-Markdown table 前使用 `<TableCaption>...</TableCaption>`,內容只寫說明文字;runtime 會輸出 `表 N：...`。不要手寫表號,也不要使用舊 `表：...` marker。
+Markdown table 前使用 `<TableCaption>...</TableCaption>`,內容只寫說明文字;export pipeline 會輸出 `表 N：...`。不要手寫表號,也不要使用舊 `表：...` marker。
 
 <TableCaption>表格使用規則</TableCaption>
 
@@ -114,7 +114,7 @@ Markdown table 前使用 `<TableCaption>...</TableCaption>`,內容只寫說明
 
 ### Figures
 
-Figure component 應輸出標準 `<figure><figcaption>...</figcaption></figure>`。`figcaption` 只放 caption 文字,不放手寫圖號;runtime 會依 content pages 的 DOM 順序產生可見的 `圖 N：` / `表 N：` 前綴,並加上統一的 `data-openpress-caption="true"` 與 `data-openpress-caption-label`。
+Figure component 應輸出標準 `<figure><figcaption>...</figcaption></figure>`。`figcaption` 只放 caption 文字,不放手寫圖號;export pipeline 會依 content pages 的 DOM 順序產生可見的 `圖 N：` / `表 N：` 前綴,並加上統一的 `data-openpress-caption="true"` 與 `data-openpress-caption-label`。
 
 ### Diagram Rules