@open-press/cli 1.0.0 → 1.1.0

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

@@ -1,91 +0,0 @@
-import { useContext } from "react";
-import { cn } from "./cn";
-import { FrameContext, type FrameContextValue } from "./FrameContext";
-import { PressContext } from "./Press";
-import type { FrameProps } from "./types";
-import { createFrameObjectEntityId, createPageObjectEntityId, createScopedObjectEntityId } from "../document-model/objectEntityModel";
-
-// Substring reserved for the overflow extension pipeline.
-const RESERVED_EXTENDED = ":extended:";
-
-export const FRAME_MARKER: unique symbol = Symbol.for("@open-press/core:Frame");
-
-export function Frame({
-  frameKey,
-  role,
-  chrome = true,
-  className,
-  children,
-  ...rest
-}: FrameProps) {
-  if (!frameKey || !String(frameKey).trim()) {
-    throw new Error("Frame requires a non-empty frameKey.");
-  }
-  if (frameKey && frameKey.includes(RESERVED_EXTENDED)) {
-    throw new Error(
-      `Frame frameKey="${frameKey}" contains reserved substring ":extended:". ` +
-        `This pattern is reserved for the overflow-extension pipeline.`,
-    );
-  }
-
-  const parentFrame = useContext(FrameContext);
-  const press = useContext(PressContext);
-  const allocation = press?.allocation ?? null;
-  const frameAllocation = frameKey && allocation ? allocation[frameKey] : undefined;
-  const pageId = parentFrame?.pageId ?? createPageObjectEntityId(frameKey);
-  const objectId = parentFrame
-    ? createScopedObjectEntityId("frame", parentFrame.objectId, frameKey)
-    : createFrameObjectEntityId(frameKey);
-
-  // Mutable per-render counter. SSR renders a Frame exactly once, so a plain
-  // object is fine — no useRef needed.
-  const areaCounts: Record<string, number> = {};
-  const frameContextValue: FrameContextValue = {
-    frameKey: frameKey ?? "",
-    objectId,
-    pageId,
-    consumeArea(chainId: string) {
-      const index = areaCounts[chainId] ?? 0;
-      areaCounts[chainId] = index + 1;
-      if (!frameAllocation) return { indexInFrame: index, blocks: null };
-      const chainSlots = frameAllocation[chainId];
-      if (!chainSlots) return { indexInFrame: index, blocks: null };
-      return { indexInFrame: index, blocks: chainSlots[index] ?? null };
-    },
-  };
-
-  const pageKind = derivePageKind(role);
-  const isNestedFrame = Boolean(parentFrame);
-
-  return (
-    <FrameContext.Provider value={frameContextValue}>
-      <section
-        {...(rest as Record<string, unknown>)}
-        className={cn(isNestedFrame ? undefined : "reader-page", className)}
-        data-openpress-frame-key={isNestedFrame ? undefined : frameKey}
-        data-openpress-region-frame-key={isNestedFrame ? frameKey : undefined}
-        data-openpress-object-id={objectId}
-        data-openpress-object-kind="frame"
-        data-openpress-object-label={role ?? frameKey}
-        data-openpress-object-parent-id={parentFrame?.objectId ?? (isNestedFrame ? undefined : pageId)}
-        data-openpress-object-page-id={pageId}
-        data-frame-role={role}
-        data-page-kind={isNestedFrame ? undefined : pageKind}
-        data-frame-chrome={isNestedFrame ? undefined : chrome ? "true" : "false"}
-        data-page-footer={isNestedFrame ? undefined : chrome ? "true" : "false"}
-      >
-        {children}
-      </section>
-    </FrameContext.Provider>
-  );
-}
-
-(Frame as unknown as { openpressMarker: typeof FRAME_MARKER }).openpressMarker = FRAME_MARKER;
-
-function derivePageKind(role: string | undefined): string | undefined {
-  if (!role) return undefined;
-  const trimmed = role.trim();
-  if (!trimmed) return undefined;
-  const lastDot = trimmed.lastIndexOf(".");
-  return lastDot === -1 ? trimmed : trimmed.slice(lastDot + 1);
-}

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

@@ -1,26 +0,0 @@
-import { createContext, type ReactNode } from "react";
-
-// FrameContext is the runtime channel between Frame and its descendant
-// MdxArea instances. Frame creates one of these on each render; MdxArea
-// reads it to claim its slot of allocated content.
-//
-// "Claiming" is order-sensitive: the first <MdxArea chainId="X"> rendered
-// inside a Frame takes areaIndex 0 for chain X, the next takes index 1,
-// and so on. Empty Frames (no allocation) return null, which renders the
-// MdxArea as a measurement placeholder.
-
-export interface ConsumedMdxArea {
-  indexInFrame: number;
-  // Null when the frame has no allocation (measurement pass) or no blocks
-  // for this chain at the claimed index.
-  blocks: ReactNode | null;
-}
-
-export interface FrameContextValue {
-  frameKey: string;
-  objectId: string;
-  pageId: string;
-  consumeArea(chainId: string): ConsumedMdxArea;
-}
-
-export const FrameContext = createContext<FrameContextValue | null>(null);

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

@@ -1,34 +0,0 @@
-import { useContext, type ReactNode } from "react";
-import { cn } from "./cn";
-import { FrameContext } from "./FrameContext";
-import type { MdxAreaProps } from "./types";
-import { createMdxAreaObjectEntityId } from "../document-model/objectEntityModel";
-
-export function MdxArea({
-  chainId,
-  overflow = "extend",
-  className,
-  ...rest
-}: MdxAreaProps) {
-  const frame = useContext(FrameContext);
-  const consumed = frame?.consumeArea(chainId) ?? null;
-  const blocks: ReactNode | null = consumed?.blocks ?? null;
-  const objectId = frame && consumed
-    ? createMdxAreaObjectEntityId(frame.frameKey, chainId, consumed.indexInFrame)
-    : undefined;
-
-  return (
-    <div
-      {...(rest as Record<string, unknown>)}
-      className={cn("openpress-mdx-area", className)}
-      data-openpress-mdx-area="true"
-      data-openpress-mdx-area-chain={chainId}
-      data-openpress-mdx-area-index={consumed?.indexInFrame}
-      data-openpress-object-id={objectId}
-      data-openpress-mdx-area-overflow={overflow}
-      data-openpress-mdx-area-empty={blocks == null ? "true" : "false"}
-    >
-      {blocks}
-    </div>
-  );
-}

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

@@ -1,55 +0,0 @@
-import { createContext, Fragment } from "react";
-import type { FrameAllocation, PressProps, ResolvedSource, TocEntry } from "./types";
-
-// Marker the engine uses to distinguish a Press default export from any other
-// React component. Workspaces register a default export whose `type` is this
-// `Press` component; the engine identity-checks against it.
-export const PRESS_MARKER: unique symbol = Symbol.for("@open-press/core:Press");
-
-// Allocation hints feed Layer 4 results back to Layer 2 so helpers like
-// <Sections> can emit the correct number of pages per chain. Null during
-// the first pass; populated after the allocator has decided how many
-// frames each chain needs.
-export interface AllocationHints {
-  totalPagesPerChain: Record<string, number>;
-}
-
-// Metadata read from <Press> props by the engine pipeline. The 1.0 contract
-// declares these on the component; v0.x reads them from openpress.config.mjs
-// instead and leaves these as undefined. The engine merges both sources
-// (props override config) until v1.0 removes config support.
-export interface PressMetadata {
-  title?: string;
-  page?: PressProps["page"];
-  slug?: string;
-  theme?: string;
-  componentsDir?: string;
-}
-
-export interface PressContextValue {
-  sources: Record<string, ResolvedSource>;
-  // Allocation map keyed by frameKey -> chainId -> areaIndex -> blocks.
-  // null during measurement passes; populated during final render.
-  allocation: FrameAllocation | null;
-  // Allocation hints fed back from Layer 4 to Layer 2 helpers. null on
-  // the first measurement pass.
-  hints: AllocationHints | null;
-  toc: Record<string, TocEntry[]> | null;
-  // Metadata declared on <Press> props in v1.0. Engine providers may
-  // omit this on v0.x; consumers should treat undefined as "no metadata
-  // declared on Press — fall back to openpress.config.mjs values".
-  metadata?: PressMetadata;
-}
-
-export const PressContext = createContext<PressContextValue | null>(null);
-
-export function Press(props: PressProps) {
-  // Press is intentionally inert at render time — the engine reads its
-  // props and children through React.Children inspection during the
-  // export pipeline, then injects context above any nested helpers.
-  // For the v0.x shape (children-only usage), this still passes children
-  // through unchanged.
-  return <Fragment>{props.children}</Fragment>;
-}
-
-(Press as unknown as { openpressMarker: typeof PRESS_MARKER }).openpressMarker = PRESS_MARKER;

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

@@ -1,36 +0,0 @@
-import { createContext, Fragment } from "react";
-import type { WorkspaceProps } from "./types";
-
-// Marker the engine uses to identify a Workspace default export, in the
-// same way PRESS_MARKER identifies Press. Multi-doc projects nest one
-// or more <Press> children inside <Workspace>; single-doc projects use
-// a Workspace with one Press child (uniform shape — no exceptions).
-export const WORKSPACE_MARKER: unique symbol = Symbol.for("@open-press/core:Workspace");
-
-export interface WorkspaceContextValue {
-  // Project-level label surfaced in the gallery header / tab bar / PDF
-  // metadata. Undefined if the Workspace did not declare a name.
-  name?: string;
-  // Workspace-level shared theme directory. Press children that don't
-  // set their own `theme` prop inherit from this.
-  theme?: string;
-  // Workspace-level shared media directory.
-  media?: string;
-  // Number of Press children registered in this Workspace. Set by the
-  // engine during expansion; useful to detect "gallery vs single-doc"
-  // routing without re-walking the tree.
-  pressCount: number;
-}
-
-export const WorkspaceContext = createContext<WorkspaceContextValue | null>(null);
-
-// Workspace is intentionally inert at render time. The engine inspects
-// its props (name / theme / media) and iterates Press children during
-// the export pipeline; rendering just passes children through so the
-// Press → Frame → MdxArea tree underneath behaves identically to v0.x
-// when there's only one Press child.
-export function Workspace(props: WorkspaceProps) {
-  return <Fragment>{props.children}</Fragment>;
-}
-
-(Workspace as unknown as { openpressMarker: typeof WORKSPACE_MARKER }).openpressMarker = WORKSPACE_MARKER;

package/template/core/src/openpress/core/cn.ts

@@ -1,4 +0,0 @@
-export function cn(...values: Array<string | false | null | undefined>) {
-  const joined = values.filter(Boolean).join(" ");
-  return joined.length > 0 ? joined : undefined;
-}

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

@@ -1,47 +0,0 @@
-// @open-press/core — Press tree primitives.
-//
-// Layout: this entry exports only the kernel. Source descriptors live in
-// `@open-press/core/mdx`; manuscript helpers live in
-// `@open-press/core/manuscript`. Keeping the surface small is intentional —
-// the engine is not allowed to know about higher-level conventions.
-
-export { Press, PressContext, PRESS_MARKER } from "./Press";
-export { Workspace, WorkspaceContext, WORKSPACE_MARKER } from "./Workspace";
-export { Frame, FRAME_MARKER } from "./Frame";
-export { FrameContext } from "./FrameContext";
-export { MdxArea } from "./MdxArea";
-export { useSource } from "./useSource";
-export { ObjectEntity, Text, BaseFigure, BaseCallout, MediaFigure, ImageFigure } from "./primitives";
-
-export type {
-  FrameProps,
-  FrameRole,
-  MdxAreaProps,
-  MdxAreaOverflow,
-  PressProps,
-  PageGeometry,
-  PressSource,
-  WorkspaceProps,
-  BaseFigureProps,
-  MediaFigureProps,
-  BaseCalloutKind,
-  BaseCalloutProps,
-  ObjectEntityElement,
-  ObjectEntityProps,
-  TextProps,
-  // Source-side types are re-exported here for convenience so authors can
-  // import `ResolvedSource` from the same place they import primitives.
-  ResolvedSource,
-  SourceNode,
-  OutlineItem,
-  SourceFileRecord,
-  SourceBlock,
-  TocEntry,
-  MdxSourceDescriptor,
-  SourceDescriptor,
-  FrameAllocation,
-} from "./types";
-
-export type { PressContextValue, AllocationHints, PressMetadata } from "./Press";
-export type { WorkspaceContextValue } from "./Workspace";
-export type { FrameContextValue } from "./FrameContext";

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

@@ -1,91 +0,0 @@
-import { cn } from "./cn";
-import { useContext } from "react";
-import { FrameContext } from "./FrameContext";
-import type { BaseCalloutProps, BaseFigureProps, MediaFigureProps, ObjectEntityProps, TextProps } from "./types";
-import { createScopedObjectEntityId } from "../document-model/objectEntityModel";
-
-export function ObjectEntity({
-  as: Element = "span",
-  objectId,
-  kind,
-  label,
-  parentId,
-  pageId,
-  blockId,
-  frameKey,
-  chainId,
-  source,
-  metadata,
-  children,
-  ...entityProps
-}: ObjectEntityProps) {
-  const frame = useContext(FrameContext);
-  const resolvedParentId = parentId ?? frame?.objectId;
-  const resolvedPageId = pageId ?? frame?.pageId;
-  const resolvedFrameKey = frameKey ?? frame?.frameKey;
-  const resolvedObjectId = createScopedObjectEntityId(kind, resolvedParentId, objectId);
-
-  return (
-    <Element
-      {...entityProps}
-      data-openpress-object-id={resolvedObjectId}
-      data-openpress-object-kind={kind}
-      data-openpress-object-label={label}
-      data-openpress-object-parent-id={resolvedParentId}
-      data-openpress-object-page-id={resolvedPageId}
-      data-openpress-block-id={blockId}
-      data-openpress-object-frame-key={resolvedFrameKey}
-      data-openpress-object-chain-id={chainId}
-      data-openpress-object-source={source ? JSON.stringify(source) : undefined}
-      data-openpress-object-metadata={metadata ? JSON.stringify(metadata) : undefined}
-    >
-      {children}
-    </Element>
-  );
-}
-
-export function Text(props: TextProps) {
-  return <ObjectEntity {...props} kind="text" />;
-}
-
-export function BaseFigure({ caption, className, children, ...figureProps }: BaseFigureProps) {
-  return (
-    <figure {...figureProps} className={cn("openpress-figure", className)}>
-      <div data-figure-body>{children}</div>
-      {caption === undefined ? null : <figcaption>{caption}</figcaption>}
-    </figure>
-  );
-}
-
-export function BaseCallout({ kind = "info", className, children, ...calloutProps }: BaseCalloutProps) {
-  return (
-    <aside {...calloutProps} className={cn("openpress-callout", className)} data-callout-kind={kind}>
-      {children}
-    </aside>
-  );
-}
-
-export function MediaFigure({
-  src,
-  alt,
-  caption,
-  className,
-  imgClassName,
-  loading = "eager",
-  ...figureProps
-}: MediaFigureProps) {
-  return (
-    <BaseFigure {...figureProps} className={cn("openpress-media-figure", className)} caption={caption}>
-      <img src={resolveMediaSrc(src)} alt={alt} loading={loading} className={imgClassName} />
-    </BaseFigure>
-  );
-}
-
-export const ImageFigure = MediaFigure;
-
-function resolveMediaSrc(src: string) {
-  const trimmed = String(src ?? "").trim();
-  if (!trimmed) return "";
-  if (/^(?:[a-z][a-z0-9+.-]*:|\/)/i.test(trimmed)) return trimmed;
-  return `/openpress/media/${trimmed.replace(/^\.?\/*/, "")}`;
-}

package/template/core/src/openpress/core/types.ts

@@ -1,236 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-import type { EditableSourceRef, ObjectEntityKind } from "../document-model/documentTypes";
-
-// ---------------------------------------------------------------------------
-// Frame / MdxArea / Press primitives
-// ---------------------------------------------------------------------------
-
-// `role` is opaque to core. Helpers and themes interpret it; the engine
-// never branches on its value. Format convention is dotted, e.g.
-// "manuscript.cover", "manuscript.content", "folio.page".
-export type FrameRole = string;
-
-export type FrameProps = Omit<HTMLAttributes<HTMLElement>, "role" | "children"> & {
-  frameKey: string;
-  role?: FrameRole;
-  chrome?: boolean;
-  className?: string;
-  children?: ReactNode;
-};
-
-export type MdxAreaOverflow = "extend" | "truncate" | "error";
-
-export type MdxAreaProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
-  chainId: string;
-  overflow?: MdxAreaOverflow;
-  className?: string;
-};
-
-// PageGeometry — a custom fixed-size geometry passed to <Press page>.
-// Same shape as the engine's normalized geometry (CSS lengths,
-// matching units between width / height).
-export interface PageGeometry {
-  id?: string;
-  label?: string;
-  preset?: string;
-  width: string;
-  height: string;
-}
-
-// Source descriptor passed inside <Press sources>. The actual type is
-// the return value of mdxSource() from @open-press/core/mdx; we accept
-// "unknown" at the core boundary to avoid a circular type dependency.
-// The engine validates the shape at render time.
-export type PressSource = unknown;
-
-export interface PressProps {
-  // Document tree — Frames, manuscript helpers, etc.
-  children: ReactNode;
-  // -------------------------------------------------------------------------
-  // 1.0 metadata props — optional during v0.x deprecation, required in v1.0.
-  // -------------------------------------------------------------------------
-  // Document title. Required in 1.0. Used for PDF metadata, HTML <title>,
-  // OG tags, and the Workspace gallery / tab-bar label.
-  title?: string;
-  // Page geometry preset name or a custom geometry object. Optional;
-  // workspace default applies if not set.
-  page?: "a4" | "social-square" | "slide-16-9" | PageGeometry;
-  // Array of source registrations from mdxSource(). Replaces the v0.x
-  // `export const sources` named export.
-  sources?: ReadonlyArray<PressSource>;
-  // URL / output slug for this Press inside a Workspace. Defaults to
-  // "/" when only one Press exists in the Workspace; required when the
-  // Workspace has multiple Press children.
-  slug?: string;
-  // Optional per-Press theme directory. Defaults to "./theme" relative
-  // to the document file; inherits from <Workspace theme> if not set.
-  theme?: string;
-  // Optional per-Press components directory. Default "./components".
-  componentsDir?: string;
-  // Optional caption numbering overrides. Engine defaults to
-  // { figure: "Figure", table: "Table", separator: " " }.
-  captionNumbering?: {
-    figure?: string;
-    table?: string;
-    separator?: string;
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Workspace — root component holding one or more Press children
-// ---------------------------------------------------------------------------
-
-export interface WorkspaceProps {
-  // One or more <Press> children. 1 child = single-doc workspace; N
-  // children = multi-doc workspace (proposal + pitch + social, etc).
-  children: ReactNode;
-  // Project label surfaced in the gallery header, tab bar, and PDF
-  // metadata. Optional.
-  name?: string;
-  // Workspace-level shared theme directory. Press children that don't
-  // set their own `theme` prop inherit from this. Default "./theme".
-  theme?: string;
-  // Workspace-level shared media directory. Default "./media".
-  media?: string;
-}
-
-// ---------------------------------------------------------------------------
-// Content primitives (figure, callout)
-// ---------------------------------------------------------------------------
-
-export type BaseFigureProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
-  caption?: ReactNode;
-  children: ReactNode;
-};
-
-export type MediaFigureProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
-  src: string;
-  alt: string;
-  caption: ReactNode;
-  imgClassName?: string;
-  loading?: "eager" | "lazy";
-};
-
-export type BaseCalloutKind = "info" | "warn" | "success" | "error" | (string & {});
-
-export type BaseCalloutProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
-  kind?: BaseCalloutKind;
-  children: ReactNode;
-};
-
-export type ObjectEntityElement = "span" | "div" | "section" | "article" | "figure" | "p";
-
-export type ObjectEntityProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
-  as?: ObjectEntityElement;
-  objectId: string;
-  kind: ObjectEntityKind;
-  label: string;
-  parentId?: string;
-  pageId?: string;
-  blockId?: string;
-  frameKey?: string;
-  chainId?: string;
-  source?: EditableSourceRef;
-  metadata?: Record<string, string | number | boolean | null>;
-  children?: ReactNode;
-};
-
-export type TextProps = Omit<ObjectEntityProps, "kind"> & {
-  as?: "span" | "div" | "p";
-};
-
-// ---------------------------------------------------------------------------
-// Source descriptors and resolved sources
-// ---------------------------------------------------------------------------
-
-export interface MdxSourceDescriptorSectionFolders {
-  type: "mdx";
-  preset: "section-folders";
-  root?: string;
-}
-
-export interface MdxSourceDescriptorSectionFiles {
-  type: "mdx";
-  preset: "section-files";
-  root?: string;
-}
-
-export interface MdxSourceDescriptorFileList {
-  type: "mdx";
-  preset: "file-list";
-  files: string[];
-}
-
-export type MdxSourceDescriptor =
-  | MdxSourceDescriptorSectionFolders
-  | MdxSourceDescriptorSectionFiles
-  | MdxSourceDescriptorFileList;
-
-export type SourceDescriptor = MdxSourceDescriptor;
-
-export interface SourceNode {
-  id: string;
-  slug: string;
-  title: string;
-  meta?: Record<string, unknown>;
-  children?: SourceNode[];
-}
-
-export interface OutlineItem {
-  id: string;
-  depth: number;
-  title: string;
-  sectionSlug: string;
-  pageNumber?: number;
-}
-
-export interface TocEntry {
-  id: string;
-  blockId: string;
-  sourceId: string;
-  sectionSlug: string;
-  title: string;
-  href: string;
-  level: 2 | 3;
-  label: string;
-  pageNumber?: number;
-}
-
-export interface SourceFileRecord {
-  path: string;
-  absolutePath: string;
-  sectionSlug: string;
-}
-
-export interface SourceBlock {
-  id: string;
-  kind: string;
-  name?: string;
-  chainId: string;
-  sectionSlug: string;
-  path: string;
-  source: {
-    file: string;
-    line?: number;
-    column?: number;
-    offset?: number;
-  };
-}
-
-export interface ResolvedSource {
-  id: string;
-  type: "mdx";
-  tree: SourceNode[];
-  outline: OutlineItem[];
-  chains: Record<string, SourceBlock[]>;
-  files: SourceFileRecord[];
-}
-
-// ---------------------------------------------------------------------------
-// Allocation context shape (engine -> Frame -> MdxArea)
-// ---------------------------------------------------------------------------
-
-// Per-frame, per-chain, ordered list of React nodes assigned to each
-// MdxArea by area index.
-export type FrameAllocation = Record<string, Record<string, ReactNode[]>>;
-

package/template/core/src/openpress/core/useSource.ts

@@ -1,28 +0,0 @@
-import { useContext } from "react";
-import { PressContext } from "./Press";
-import type { ResolvedSource } from "./types";
-
-// Read a resolved source by its registered key. The engine populates the
-// PressContext before rendering, so this is synchronous and safe to call
-// from any component inside <Press>.
-//
-// Throws if the source is missing, with a hint listing known sources.
-export function useSource<T extends ResolvedSource = ResolvedSource>(id: string): T {
-  const ctx = useContext(PressContext);
-  if (!ctx) {
-    throw new Error(
-      `useSource("${id}") called outside <Press> tree. ` +
-        `Source hooks only work inside the default-exported <Press> component.`,
-    );
-  }
-  const source = ctx.sources[id];
-  if (!source) {
-    const known = Object.keys(ctx.sources).sort();
-    const knownText = known.length > 0 ? known.join(", ") : "(none)";
-    throw new Error(
-      `Unknown source "${id}". Available sources: ${knownText}. ` +
-        `Register it as a <Press sources={[mdxSource({ id: "${id}", ... })]}> entry in press/index.tsx.`,
-    );
-  }
-  return source as T;
-}

package/template/core/src/openpress/document-model/anchorMapModel.ts

@@ -1,27 +0,0 @@
-// Anchor → page-index resolution shared between the public viewer and
-// the workbench. Lives in its own module so React Fast Refresh can keep
-// `PublicPage` / `HtmlWorkbench` HMR-clean (Fast Refresh expects component
-// files to export only components).
-
-import type { DisplayPage } from "../reader";
-
-export function createAnchorPageMap(pages: DisplayPage[]) {
-  const map = new Map<string, number>();
-  pages.forEach((page, index) => {
-    page.anchors?.forEach((anchor) => {
-      if (anchor && !map.has(anchor)) map.set(anchor, index);
-    });
-  });
-  return map;
-}
-
-export function resolveAnchorPageIndex(
-  anchorPageMap: Map<string, number>,
-  pageCount: number,
-  anchorId: string,
-  pageIndex?: number,
-): number | null {
-  if (typeof pageIndex === "number" && Number.isInteger(pageIndex) && pageIndex >= 0 && pageIndex < pageCount) return pageIndex;
-  const mapped = anchorPageMap.get(anchorId);
-  return mapped === undefined ? null : mapped;
-}