@open-press/cli 1.0.0 → 1.1.0

package/template/core/engine/react/measurement-css.mjs

@@ -1,157 +0,0 @@
-import fs from "node:fs/promises";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { buildComponentsCss, buildContentCss } from "../runtime/file-utils.mjs";
-import { pageGeometryToTheme } from "../runtime/page-geometry.mjs";
-import { buildSectionScopedCss } from "./section-css.mjs";
-
-const require = createRequire(import.meta.url);
-
-export async function buildReactMeasurementCss(root, config, workspace) {
-  const parts = [];
-  await appendOptionalFile(parts, path.join(config.paths.themeDir, "fonts.css"), "theme/fonts.css");
-  await appendOptionalFile(parts, path.join(config.paths.themeDir, "tokens.css"), "theme/tokens.css");
-  appendPageGeometryCss(parts, config.page);
-  parts.push("/* === public/openpress/content.css === */\n");
-  parts.push(await buildContentCss(root, config));
-  parts.push("\n/* === public/openpress/components.css === */\n");
-  parts.push(await buildComponentsCss(root, config));
-  const chapterCss = await buildSectionScopedCss(workspace);
-  if (chapterCss.trim()) {
-    parts.push("\n/* === public/openpress/chapter-scoped.css === */\n");
-    parts.push(chapterCss);
-  }
-  return rewriteAssetUrls(stripViewportMediaQueries(parts.join("\n")), config);
-}
-
-function appendPageGeometryCss(parts, page) {
-  const theme = pageGeometryToTheme(page);
-  if (!theme) return;
-
-  const declarations = [
-    ["--openpress-page-width", theme.pageWidth],
-    ["--openpress-page-height", theme.pageHeight],
-    ["--openpress-page-aspect-ratio", theme.pageAspectRatio],
-    ["--openpress-page-height-ratio", theme.pageHeightRatio],
-  ].filter(([, value]) => value);
-
-  parts.push("/* === openpress page geometry === */\n");
-  parts.push(":root {\n");
-  for (const [name, value] of declarations) {
-    parts.push(`  ${name}: ${value};\n`);
-  }
-  parts.push("}\n\n");
-}
-
-async function appendOptionalFile(parts, filePath, label) {
-  try {
-    const css = await fs.readFile(filePath, "utf8");
-    parts.push(`/* === ${label} === */\n`);
-    parts.push(css.trimEnd());
-    parts.push("\n");
-  } catch (error) {
-    if (error?.code !== "ENOENT") throw error;
-  }
-}
-
-function rewriteAssetUrls(css, config) {
-  const themeFontsDir = pathToFileURL(path.join(config.paths.themeDir, "fonts") + path.sep).href;
-  const katexFont = require.resolve("katex/dist/fonts/KaTeX_Main-Regular.woff2");
-  const katexFontsDir = pathToFileURL(path.dirname(katexFont) + path.sep).href;
-  return css
-    .replace(/url\((["'])?\/openpress\/fonts\//g, `url($1${themeFontsDir}`)
-    .replace(/url\((["'])?\/openpress\/katex-fonts\//g, `url($1${katexFontsDir}`);
-}
-
-function stripViewportMediaQueries(css) {
-  let output = "";
-  let cursor = 0;
-
-  while (cursor < css.length) {
-    const mediaIndex = css.indexOf("@media", cursor);
-    if (mediaIndex < 0) {
-      output += css.slice(cursor);
-      break;
-    }
-
-    output += css.slice(cursor, mediaIndex);
-    const blockStart = css.indexOf("{", mediaIndex);
-    if (blockStart < 0) {
-      output += css.slice(mediaIndex);
-      break;
-    }
-
-    const prelude = css.slice(mediaIndex + "@media".length, blockStart);
-    const blockEnd = findCssBlockEnd(css, blockStart);
-    if (blockEnd < 0) {
-      output += css.slice(mediaIndex);
-      break;
-    }
-
-    if (!isViewportMediaPrelude(prelude)) {
-      output += css.slice(mediaIndex, blockEnd + 1);
-    }
-    cursor = blockEnd + 1;
-  }
-
-  return output;
-}
-
-function isViewportMediaPrelude(prelude) {
-  if (/\bprint\b/i.test(prelude)) return false;
-  return /\(\s*(?:min-|max-)?(?:device-)?(?:width|height)\s*:/i.test(prelude)
-    || /\(\s*orientation\s*:/i.test(prelude)
-    || /\(\s*(?:min-|max-)?aspect-ratio\s*:/i.test(prelude);
-}
-
-function findCssBlockEnd(css, blockStart) {
-  let depth = 0;
-  let quote = "";
-  let inComment = false;
-
-  for (let index = blockStart; index < css.length; index += 1) {
-    const current = css[index];
-    const next = css[index + 1];
-
-    if (inComment) {
-      if (current === "*" && next === "/") {
-        inComment = false;
-        index += 1;
-      }
-      continue;
-    }
-
-    if (quote) {
-      if (current === "\\") {
-        index += 1;
-        continue;
-      }
-      if (current === quote) quote = "";
-      continue;
-    }
-
-    if (current === "/" && next === "*") {
-      inComment = true;
-      index += 1;
-      continue;
-    }
-
-    if (current === "\"" || current === "'") {
-      quote = current;
-      continue;
-    }
-
-    if (current === "{") {
-      depth += 1;
-      continue;
-    }
-
-    if (current === "}") {
-      depth -= 1;
-      if (depth === 0) return index;
-    }
-  }
-
-  return -1;
-}

package/template/core/engine/react/object-entities.mjs

@@ -1,204 +0,0 @@
-export function createObjectEntityId(kind, ...parts) {
-  return [kind, ...parts.map((part) => encodeURIComponent(String(part)))].join(":");
-}
-
-export function createBlockObjectEntityId(blockId) {
-  return createObjectEntityId("mdx-block", blockId);
-}
-
-export function createPageObjectEntityId(frameKey) {
-  return createObjectEntityId("page", frameKey);
-}
-
-export function createFrameObjectEntityId(frameKey) {
-  return createObjectEntityId("frame", frameKey);
-}
-
-export function createScopedObjectEntityId(kind, parentId, objectId) {
-  return parentId ? createObjectEntityId(kind, parentId, objectId) : createObjectEntityId(kind, objectId);
-}
-
-export function createMdxAreaObjectEntityId(frameKey, chainId, indexInFrame) {
-  return createObjectEntityId("mdx-area", frameKey, chainId, indexInFrame);
-}
-
-export function buildObjectEntities({ frames, blocks, blockMap }) {
-  const entities = {};
-  const blockParentIdByBlockId = new Map();
-
-  for (const block of blocks) {
-    const frameKey = block.frameKey ?? block.id;
-    const sourcePath = block.source?.path;
-    const pageId = createPageObjectEntityId(frameKey);
-    const base = {
-      frameKey,
-      pageId,
-      source: sourcePath
-        ? {
-            path: sourcePath,
-            file: block.source?.file,
-            line: 1,
-            column: 1,
-          }
-        : undefined,
-    };
-
-    entities[pageId] = {
-      id: pageId,
-      kind: "page",
-      label: block.title || `Page ${block.pageNumber}`,
-      ...base,
-    };
-
-    const frameId = createFrameObjectEntityId(frameKey);
-    entities[frameId] = {
-      id: frameId,
-      kind: "frame",
-      label: block.role || block.title || frameKey,
-      ...base,
-      parentId: pageId,
-      metadata: { role: block.role ?? null, chrome: block.chrome ?? null },
-    };
-  }
-
-  for (const frame of frames) {
-    const pageId = createPageObjectEntityId(frame.frameKey);
-    const frameId = createFrameObjectEntityId(frame.frameKey);
-    for (const area of frame.mdxAreas ?? []) {
-      const id = createMdxAreaObjectEntityId(frame.frameKey, area.chainId, area.indexInFrame);
-      const firstEditableBlock = (area.blockIds ?? [])
-        .map((blockId) => blockMap[blockId])
-        .find((block) => block?.path);
-      for (const blockId of area.blockIds ?? []) blockParentIdByBlockId.set(blockId, id);
-      entities[id] = {
-        id,
-        kind: "mdx-area",
-        label: `${area.chainId} area ${area.indexInFrame + 1}`,
-        parentId: frameId,
-        pageId,
-        frameKey: frame.frameKey,
-        chainId: area.chainId,
-        source: firstEditableBlock
-          ? {
-              path: firstEditableBlock.path,
-              source: firstEditableBlock.source,
-              line: firstEditableBlock.source?.line,
-              column: firstEditableBlock.source?.column,
-            }
-          : undefined,
-        metadata: { blockCount: area.blockIds?.length ?? 0 },
-      };
-    }
-  }
-
-  for (const block of Object.values(blockMap)) {
-    if (!block?.id) continue;
-    const id = createBlockObjectEntityId(block.id);
-    const pageId = block.frameKey ? createPageObjectEntityId(block.frameKey) : undefined;
-    entities[id] = {
-      id,
-      kind: "mdx-block",
-      label: block.name ? `${block.name} ${block.id}` : block.id,
-      parentId: blockParentIdByBlockId.get(block.id),
-      pageId,
-      blockId: block.id,
-      frameKey: block.frameKey,
-      chainId: block.chainId,
-      source: block.path
-        ? {
-            path: block.path,
-            source: block.source,
-            line: block.source?.line,
-            column: block.source?.column,
-          }
-        : undefined,
-      metadata: {
-        blockKind: block.kind ?? null,
-        componentName: block.kind === "component" ? block.name ?? null : null,
-      },
-    };
-  }
-
-  for (const entity of collectRenderedObjectEntities(frames)) {
-    if (!entity.id || entities[entity.id]) continue;
-    const pageId = entity.pageId || createPageObjectEntityId(entity.frameKey);
-    const frameId = createFrameObjectEntityId(entity.frameKey);
-    entities[entity.id] = {
-      id: entity.id,
-      kind: entity.kind,
-      label: entity.label || entity.id,
-      parentId: entity.parentId || (entity.id === frameId ? pageId : frameId),
-      pageId,
-      blockId: entity.blockId,
-      frameKey: entity.frameKey,
-      chainId: entity.chainId,
-      source: entity.source,
-      metadata: entity.metadata,
-    };
-  }
-
-  return entities;
-}
-
-const OBJECT_OPEN_RE = /<([a-z][a-z0-9-]*)\b([^>]*)\bdata-openpress-object-id="([^"]+)"([^>]*)>/gi;
-const ATTR_RE = (name) => new RegExp(`\\b${name}="([^"]*)"`);
-
-function collectRenderedObjectEntities(frames) {
-  const entities = [];
-  for (const frame of frames) {
-    const pageId = createPageObjectEntityId(frame.frameKey);
-    const frameId = createFrameObjectEntityId(frame.frameKey);
-    const html = String(frame.html ?? "");
-    let match;
-    OBJECT_OPEN_RE.lastIndex = 0;
-    while ((match = OBJECT_OPEN_RE.exec(html)) !== null) {
-      const attrs = `${match[2] ?? ""} data-openpress-object-id="${match[3] ?? ""}" ${match[4] ?? ""}`;
-      const id = htmlDecode(match[3] ?? "");
-      const kind = htmlDecode(pickAttr(attrs, "data-openpress-object-kind")) || objectKindFromId(id);
-      if (!id || !kind) continue;
-      entities.push({
-        id,
-        kind,
-        label: htmlDecode(pickAttr(attrs, "data-openpress-object-label")) || id,
-        parentId: htmlDecode(pickAttr(attrs, "data-openpress-object-parent-id")) || (id === frameId ? pageId : frameId),
-        pageId: htmlDecode(pickAttr(attrs, "data-openpress-object-page-id")) || pageId,
-        blockId: htmlDecode(pickAttr(attrs, "data-openpress-block-id")) || undefined,
-        frameKey: htmlDecode(pickAttr(attrs, "data-openpress-object-frame-key")) || frame.frameKey,
-        chainId: htmlDecode(pickAttr(attrs, "data-openpress-object-chain-id")) || undefined,
-        source: parseJsonAttribute(pickAttr(attrs, "data-openpress-object-source")),
-        metadata: parseJsonAttribute(pickAttr(attrs, "data-openpress-object-metadata")),
-      });
-    }
-  }
-  return entities;
-}
-
-function pickAttr(attrs, name) {
-  const match = ATTR_RE(name).exec(attrs);
-  return match ? match[1] : "";
-}
-
-function objectKindFromId(id) {
-  const separator = id.indexOf(":");
-  return separator === -1 ? "" : id.slice(0, separator);
-}
-
-function parseJsonAttribute(value) {
-  const decoded = htmlDecode(value);
-  if (!decoded) return undefined;
-  try {
-    return JSON.parse(decoded);
-  } catch {
-    return undefined;
-  }
-}
-
-function htmlDecode(value) {
-  return String(value ?? "")
-    .replaceAll("&quot;", '"')
-    .replaceAll("&#x27;", "'")
-    .replaceAll("&#39;", "'")
-    .replaceAll("&lt;", "<")
-    .replaceAll("&gt;", ">")
-    .replaceAll("&amp;", "&");
-}

package/template/core/engine/react/pagination/allocator.mjs

@@ -1,167 +0,0 @@
-import { DEFAULT_PAGE_SAFE_HEIGHT_PX } from "../pagination-constants.mjs";
-import { singleColumnRegionStream } from "./regions.mjs";
-
-// Pure region-based block allocator.
-//
-// Greedy bin-packing: walk measured blocks in order, append to the current
-// region until adding the next block would exceed capacity, then advance to
-// the next region. Pages are a derived view (grouping by pageIndex), so the
-// same code paginates single-column, multi-column, and heterogeneous layouts.
-export function allocateBlocksToRegions(measuredBlocks, regionStream, options = {}) {
-  const keepWithNext = typeof options.keepWithNext === "function" ? options.keepWithNext : null;
-  const filled = [];
-  const warnings = [];
-  let current = regionStream.next();
-  if (!current) {
-    return { regions: filled, warnings: [{ code: "out-of-regions" }] };
-  }
-  let currentBlockIds = [];
-  let currentHeight = 0;
-  let consumedCount = 0;
-
-  const flush = () => {
-    if (currentBlockIds.length === 0) return;
-    filled.push({
-      regionId: current.id,
-      pageIndex: current.pageIndex,
-      columnIndex: current.columnIndex,
-      blockIds: currentBlockIds,
-    });
-    currentBlockIds = [];
-    currentHeight = 0;
-  };
-
-  const blocks = measuredBlocks ?? [];
-  for (let blockIndex = 0; blockIndex < blocks.length; blockIndex += 1) {
-    const block = blocks[blockIndex];
-    const id = String(block?.id ?? "");
-    if (!id) continue;
-    const height = Math.max(0, Number(block.height) || 0);
-
-    if (height > current.capacity) {
-      warnings.push({
-        code: "block-overflows-region",
-        blockId: id,
-        height,
-        regionCapacity: current.capacity,
-        regionId: current.id,
-        pageIndex: current.pageIndex,
-      });
-    }
-
-    const nextBlock = blocks[blockIndex + 1];
-    const nextHeight = Math.max(0, Number(nextBlock?.height) || 0);
-    const keepWithNextHeight = keepWithNext?.(block, nextBlock) ? height + nextHeight : 0;
-
-    if (
-      currentBlockIds.length > 0 &&
-      keepWithNextHeight > 0 &&
-      currentHeight + keepWithNextHeight > current.capacity
-    ) {
-      flush();
-      const next = regionStream.next();
-      if (!next) {
-        warnings.push({ code: "out-of-regions", blockId: id });
-        break;
-      }
-      current = next;
-    }
-
-    if (currentBlockIds.length > 0 && currentHeight + height > current.capacity) {
-      flush();
-      const next = regionStream.next();
-      if (!next) {
-        warnings.push({ code: "out-of-regions", blockId: id });
-        break;
-      }
-      current = next;
-    }
-
-    currentBlockIds.push(id);
-    currentHeight += height;
-    consumedCount += 1;
-  }
-
-  flush();
-  return { regions: filled, warnings, consumedCount };
-}
-
-export function estimateRegionsNeeded(measuredBlocks, regionCapacity, options = {}) {
-  const capacity = positiveNumber(regionCapacity, DEFAULT_PAGE_SAFE_HEIGHT_PX);
-  const result = allocateBlocksToRegions(measuredBlocks, infiniteFixedCapacityRegionStream(capacity), options);
-  return result.regions.length;
-}
-
-// Derive a flat pages[] view from filled regions. Blocks within a page are
-// emitted in column order (col 0, col 1, ...) — matching how readers consume
-// a multi-column page (left-to-right, top-to-bottom).
-export function pagesFromRegions(filledRegions) {
-  const byPage = new Map();
-  for (const region of filledRegions) {
-    if (!byPage.has(region.pageIndex)) byPage.set(region.pageIndex, []);
-    byPage.get(region.pageIndex).push(region);
-  }
-  const pages = [];
-  for (const [pageIndex, regionsOnPage] of [...byPage.entries()].sort((a, b) => a[0] - b[0])) {
-    const sorted = regionsOnPage.slice().sort((a, b) => a.columnIndex - b.columnIndex);
-    const blockIds = sorted.flatMap((r) => r.blockIds);
-    pages.push({
-      pageIndex,
-      blockIds,
-      breakAfter: blockIds.at(-1),
-    });
-  }
-  return pages;
-}
-
-// Public wrapper preserving the legacy (blocks, { pageSafeHeightPx }) signature.
-// New code can pass a `regions` stream directly to opt into multi-column or
-// heterogeneous layouts.
-export function paginateMeasuredBlocks(measuredBlocks, options = {}) {
-  const { pageSafeHeightPx = DEFAULT_PAGE_SAFE_HEIGHT_PX, regions } = options;
-  const safeHeight = positiveNumber(pageSafeHeightPx, DEFAULT_PAGE_SAFE_HEIGHT_PX);
-  const stream = regions ?? singleColumnRegionStream({ pageSafeHeightPx: safeHeight });
-  const { regions: filledRegions, warnings } = allocateBlocksToRegions(measuredBlocks, stream);
-  const pages = pagesFromRegions(filledRegions);
-  return {
-    pages,
-    regions: filledRegions,
-    warnings: warnings.map((w) => mapWarning(w, safeHeight)),
-  };
-}
-
-function infiniteFixedCapacityRegionStream(capacity) {
-  let index = 0;
-  return {
-    next() {
-      const region = {
-        id: `estimate-region-${index}`,
-        capacity,
-        pageIndex: index,
-        columnIndex: 0,
-      };
-      index += 1;
-      return region;
-    },
-  };
-}
-
-// Translate the new region-shaped warnings back to the legacy
-// `block-overflows-page` schema that document-export.mjs and downstream
-// consumers expect. Once consumers migrate, this can drop.
-function mapWarning(warning, pageSafeHeightPx) {
-  if (warning.code === "block-overflows-region") {
-    return {
-      code: "block-overflows-page",
-      blockId: warning.blockId,
-      height: warning.height,
-      pageSafeHeightPx,
-    };
-  }
-  return warning;
-}
-
-function positiveNumber(value, fallback) {
-  const number = Number(value);
-  return Number.isFinite(number) && number > 0 ? number : fallback;
-}

package/template/core/engine/react/pagination/regions.mjs

@@ -1,81 +0,0 @@
-// A Region is a fillable area on a page — the engine treats pagination as a
-// stream of regions consumed in order. One single-column page is "one region";
-// a two-column page is two regions on the same pageIndex; a newspaper page
-// could be three (main-left, main-right, sidebar).
-//
-// A RegionStream is a lazy iterator that yields regions on demand. The
-// allocator pulls the next region when the current one is full. This makes
-// "multi-column" and "newspaper-style mixed layout" the same code path as
-// single-column — only the stream differs.
-//
-// Shape:
-//   Region = { id: string, capacity: number, pageIndex: number, columnIndex: number }
-//   RegionStream = { next(): Region } | Iterable<Region>
-
-/**
- * Default region stream: an infinite sequence of single-column pages.
- * Equivalent to today's "one safe-height page after another" behavior.
- */
-export function singleColumnRegionStream({ pageSafeHeightPx }) {
-  return iteratorFromGenerator(function* () {
-    let pageIndex = 0;
-    while (true) {
-      yield {
-        id: `page-${pageIndex}-col-0`,
-        capacity: pageSafeHeightPx,
-        pageIndex,
-        columnIndex: 0,
-      };
-      pageIndex++;
-    }
-  });
-}
-
-/**
- * Multi-column region stream: each page yields `columnCount` regions in order,
- * all sharing the same pageIndex but with increasing columnIndex.
- *
- * Blocks fill column 0 first, then column 1, then advance to the next page's
- * column 0 — same greedy semantics as single-column, just more regions per page.
- */
-export function multiColumnRegionStream({ pageSafeHeightPx, columnCount }) {
-  const cols = Math.max(1, Math.floor(columnCount) || 1);
-  return iteratorFromGenerator(function* () {
-    let pageIndex = 0;
-    while (true) {
-      for (let col = 0; col < cols; col++) {
-        yield {
-          id: `page-${pageIndex}-col-${col}`,
-          capacity: pageSafeHeightPx,
-          pageIndex,
-          columnIndex: col,
-        };
-      }
-      pageIndex++;
-    }
-  });
-}
-
-/**
- * Build a region stream from an explicit list of regions. Useful for
- * heterogeneous layouts (e.g. a research-article first page with a wide
- * abstract region on top + two narrow columns below). Stream ends when
- * the list is exhausted — the caller is responsible for providing enough
- * regions; the allocator emits an `out-of-regions` warning otherwise.
- */
-export function fixedRegionStream(regions) {
-  const list = Array.isArray(regions) ? regions : [];
-  return iteratorFromGenerator(function* () {
-    for (const region of list) yield region;
-  });
-}
-
-function iteratorFromGenerator(genFn) {
-  const iter = genFn();
-  return {
-    next() {
-      const { value, done } = iter.next();
-      return done ? null : value;
-    },
-  };
-}

package/template/core/engine/react/pagination-constants.mjs

@@ -1,3 +0,0 @@
-export const DEFAULT_PAGE_SAFE_HEIGHT_PX = 930;
-export const PAGE_BODY_FIT_SAFETY_RATIO = 0.08;
-export const PAGE_BODY_FIT_SAFETY_MAX_PX = 96;

package/template/core/engine/react/pagination.mjs

@@ -1,9 +0,0 @@
-// Public surface for the build-time region allocator.
-//
-// The Press Tree pipeline measures MdxArea capacities and block heights in
-// `engine/react/pipeline/frame-measurement.mjs` and runs allocation through
-// these helpers. The region kernel is also usable on its own for custom
-// pipelines or unit tests.
-
-export { paginateMeasuredBlocks, allocateBlocksToRegions, estimateRegionsNeeded, pagesFromRegions } from "./pagination/allocator.mjs";
-export { singleColumnRegionStream, multiColumnRegionStream, fixedRegionStream } from "./pagination/regions.mjs";