@open-press/cli 1.0.0 → 1.1.1

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

@@ -1,329 +0,0 @@
-import type { BlockSource } from "./documentTypes";
-
-export type MediaAssetKind = "image" | "svg";
-
-export interface IndexedHtmlPage {
-  id: string;
-  html: string;
-  title: string;
-  pageNumber: number;
-  anchors?: string[];
-}
-
-export interface MediaAssetItem {
-  id: string;
-  kind: MediaAssetKind;
-  fileName: string;
-  src: string;
-  pageIndex: number;
-  sourceTitle: string;
-  usageCount: number;
-  references: Array<{
-    pageIndex: number;
-    sourceTitle: string;
-  }>;
-}
-
-export interface ContentSourceItem {
-  id: string;
-  file: string;
-  path: string;
-  kind?: string;
-  chapter?: number;
-  slug?: string;
-  title: string;
-  pageIndexes: number[];
-  sectionCount: number;
-}
-
-export interface BookmarkItem {
-  id: string;
-  title: string;
-  label?: string;
-  pageIndex: number;
-  endPageIndex: number;
-  subs: BookmarkSubItem[];
-}
-
-export interface BookmarkSubItem {
-  id: string;
-  title: string;
-  label?: string;
-  pageIndex: number;
-  endPageIndex: number;
-  subs: BookmarkTopicItem[];
-}
-
-export interface BookmarkTopicItem {
-  id: string;
-  title: string;
-  label?: string;
-  pageIndex: number;
-  endPageIndex: number;
-}
-
-export function collectBookmarkIndex(pages: IndexedHtmlPage[]): BookmarkItem[] {
-  const totalPages = pages.length;
-  const chapters: BookmarkItem[] = [];
-  let currentChapter: BookmarkItem | undefined;
-  let currentSub: BookmarkSubItem | undefined;
-  let pendingChapterOpener: { pageIndex: number } | undefined;
-  let tocAdded = false;
-
-  pages.forEach((page) => {
-    const html = parseHtmlPage(page.html);
-    if (!html) return;
-    const readerPage = html.querySelector<HTMLElement>(".reader-page");
-    if (!readerPage) return;
-    const pageIndex = page.pageNumber - 1;
-
-    if (pageKindOf(readerPage) === "toc") {
-      if (!tocAdded && readerPage.dataset.tocContinuation !== "true") {
-        tocAdded = true;
-        chapters.push({
-          id: `toc-bookmark-${page.pageNumber}`,
-          title: readerPage.dataset.pageTitle || readerPage.querySelector<HTMLElement>(".toc-heading, h2")?.textContent?.trim() || "目錄",
-          label: "00",
-          pageIndex,
-          endPageIndex: totalPages - 1,
-          subs: [],
-        });
-      }
-      return;
-    }
-
-    if (pageKindOf(readerPage) === "chapter-opener") {
-      pendingChapterOpener = { pageIndex };
-      return;
-    }
-
-    if (!isContentPage(readerPage)) return;
-
-    let pageStartedChapter = false;
-    html.querySelectorAll("h2, h3, h4").forEach((heading, headingIndex) => {
-      const id = bookmarkItemId(page, heading, headingIndex);
-      if (heading.tagName === "H2") {
-        const opener = pendingChapterOpener;
-        pendingChapterOpener = undefined;
-        pageStartedChapter = true;
-        currentChapter = {
-          id,
-          title: normalizeChapterTitle(heading.textContent ?? ""),
-          label: heading instanceof HTMLElement ? heading.dataset.chapter : undefined,
-          pageIndex: opener?.pageIndex ?? pageIndex,
-          endPageIndex: totalPages - 1,
-          subs: [],
-        };
-        chapters.push(currentChapter);
-        currentSub = undefined;
-        return;
-      }
-
-      if (heading.tagName === "H3" && currentChapter) {
-        currentSub = {
-          id,
-          title: normalizeSectionTitle(heading.textContent ?? ""),
-          label: heading instanceof HTMLElement ? heading.dataset.section : undefined,
-          pageIndex,
-          endPageIndex: totalPages - 1,
-          subs: [],
-        };
-        currentChapter.subs.push(currentSub);
-        return;
-      }
-
-      if (heading.tagName === "H4" && currentSub) {
-        currentSub.subs.push({
-          id,
-          title: normalizeTopicTitle(heading.textContent ?? ""),
-          label: heading instanceof HTMLElement ? heading.dataset.topic : undefined,
-          pageIndex,
-          endPageIndex: totalPages - 1,
-        });
-      }
-    });
-    if (!pageStartedChapter) pendingChapterOpener = undefined;
-  });
-
-  // Back-fill endPageIndex: each item ends where the next sibling starts (exclusive)
-  for (let i = 0; i < chapters.length; i++) {
-    const nextChapterStart = chapters[i + 1]?.pageIndex ?? totalPages;
-    chapters[i].endPageIndex = nextChapterStart - 1;
-
-    const subs = chapters[i].subs;
-    for (let j = 0; j < subs.length; j++) {
-      const nextSubStart = subs[j + 1]?.pageIndex ?? nextChapterStart;
-      subs[j].endPageIndex = Math.max(subs[j].pageIndex, nextSubStart - 1);
-
-      const topics = subs[j].subs;
-      for (let k = 0; k < topics.length; k++) {
-        const nextTopicStart = topics[k + 1]?.pageIndex ?? nextSubStart;
-        topics[k].endPageIndex = Math.max(topics[k].pageIndex, nextTopicStart - 1);
-      }
-    }
-  }
-
-  return chapters;
-}
-
-function pageKindOf(page: HTMLElement) {
-  return page.dataset.pageKind || "";
-}
-
-function isContentPage(page: HTMLElement) {
-  return pageKindOf(page) === "content";
-}
-
-function bookmarkItemId(page: IndexedHtmlPage, heading: Element, headingIndex: number) {
-  const anchor = heading.id || page.anchors?.[0] || page.id;
-  return `${anchor}-bookmark-${page.pageNumber}-${headingIndex + 1}`;
-}
-
-export function collectContentSourceIndex(
-  pages: Array<IndexedHtmlPage & { source?: BlockSource }>,
-): ContentSourceItem[] {
-  const items = new Map<string, ContentSourceItem>();
-
-  pages.forEach((page) => {
-    const source = page.source;
-    if (!source?.path) return;
-    const existing = items.get(source.path);
-    if (existing) {
-      existing.pageIndexes.push(page.pageNumber - 1);
-      existing.sectionCount += 1;
-      return;
-    }
-
-    items.set(source.path, {
-      id: `content-${items.size + 1}`,
-      file: source.file,
-      path: source.path,
-      kind: source.kind,
-      chapter: source.chapter,
-      slug: source.slug,
-      title: page.title,
-      pageIndexes: [page.pageNumber - 1],
-      sectionCount: 1,
-    });
-  });
-
-  return Array.from(items.values()).sort((a, b) => a.path.localeCompare(b.path, "zh-Hant"));
-}
-
-export function collectMediaAssetIndex(pages: IndexedHtmlPage[]): MediaAssetItem[] {
-  const assets = createMediaInventory();
-  const imagePattern = /<(img|image)\b([^>]*)>/gi;
-
-  pages.forEach((page) => {
-    let match: RegExpExecArray | null;
-    imagePattern.lastIndex = 0;
-    while ((match = imagePattern.exec(page.html)) !== null) {
-      const src = normalizeMediaAssetSrc(readHtmlAttribute(match[2], "src") ?? readHtmlAttribute(match[2], "href"));
-      if (!src) continue;
-      const existing = assets.get(src);
-      if (existing) {
-        existing.usageCount += 1;
-        existing.pageIndex = existing.usageCount === 1 ? page.pageNumber - 1 : existing.pageIndex;
-        existing.sourceTitle = existing.usageCount === 1 ? page.title : existing.sourceTitle;
-        existing.references.push({
-          pageIndex: page.pageNumber - 1,
-          sourceTitle: page.title,
-        });
-        continue;
-      }
-      const fileName = safeDecodeURIComponent(src.split("/").pop() ?? src);
-      assets.set(src, {
-        id: `asset-${assets.size + 1}`,
-        kind: fileName.toLowerCase().endsWith(".svg") ? "svg" : "image",
-        fileName,
-        src,
-        pageIndex: page.pageNumber - 1,
-        sourceTitle: page.title,
-        usageCount: 1,
-        references: [{
-          pageIndex: page.pageNumber - 1,
-          sourceTitle: page.title,
-        }],
-      });
-    }
-  });
-
-  return Array.from(assets.values()).sort((a, b) => a.fileName.localeCompare(b.fileName, "zh-Hant"));
-}
-
-const workspaceMediaFiles = import.meta.glob<string>("@workspace/media/*", {
-  eager: true,
-  query: "?url",
-  import: "default",
-});
-
-function createMediaInventory() {
-  const assets = new Map<string, MediaAssetItem>();
-
-  Object.keys(workspaceMediaFiles).forEach((path) => {
-    const fileName = safeDecodeURIComponent(path.split("/").pop() ?? path);
-    if (!isMediaFileName(fileName)) return;
-    const src = `/openpress/media/${fileName}`;
-    assets.set(src, {
-      id: `asset-${assets.size + 1}`,
-      kind: fileName.toLowerCase().endsWith(".svg") ? "svg" : "image",
-      fileName,
-      src,
-      pageIndex: -1,
-      sourceTitle: "未引用",
-      usageCount: 0,
-      references: [],
-    });
-  });
-
-  return assets;
-}
-
-function isMediaFileName(fileName: string) {
-  return /\.(png|jpe?g|gif|svg|webp)$/i.test(fileName);
-}
-
-function parseHtmlPage(html: string) {
-  if (typeof DOMParser === "undefined") return undefined;
-  return new DOMParser().parseFromString(html, "text/html");
-}
-
-function normalizeChapterTitle(value: string) {
-  return value
-    .trim()
-    .replace(/^[一二三四五六七八九十]+、\s*/, "");
-}
-
-function normalizeSectionTitle(value: string) {
-  return value
-    .trim()
-    .replace(/^[（(][一二三四五六七八九十]+[)）]、?\s*/, "")
-    .replace(/^\d+\.\d+\s+/, "");
-}
-
-function normalizeTopicTitle(value: string) {
-  return value
-    .trim()
-    .replace(/^\d+\.\d+\.\d+\s+/, "");
-}
-
-function readHtmlAttribute(attributes: string, name: string) {
-  const pattern = new RegExp(`\\b${name}=["']([^"']+)["']`, "i");
-  return attributes.match(pattern)?.[1];
-}
-
-function normalizeMediaAssetSrc(value?: string) {
-  if (!value) return undefined;
-  if (value.startsWith("/openpress/media/")) return value;
-  if (value.startsWith("media/")) return `/openpress/${value}`;
-  if (value.startsWith("./media/")) return `/openpress/${value.slice(2)}`;
-  return undefined;
-}
-
-function safeDecodeURIComponent(value: string) {
-  try {
-    return decodeURIComponent(value);
-  } catch {
-    return value;
-  }
-}

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

@@ -1,147 +0,0 @@
-export interface DeploymentInfo {
-  online: boolean;
-  deployedAt?: string;
-  pdf?: string;
-  publicUrl?: string;
-  dirty?: boolean;
-  configured?: boolean;
-  adapter?: string;
-  source?: string;
-  projectName?: string;
-  setupMessage?: string;
-}
-
-export interface ReaderDocument {
-  meta: DocumentMeta;
-  source?: DocumentSource;
-  theme?: Theme;
-  blocks: HtmlPageBlock[];
-}
-
-export interface DocumentSource {
-  type: string;
-  contentDir?: string;
-  editable?: boolean;
-  editMode?: string;
-  styles?: DocumentStyle[];
-  blockMap?: Record<string, SourceBlock>;
-  objectEntities?: Record<string, ObjectEntity>;
-}
-
-export interface DocumentStyle {
-  kind: string;
-  href?: string;
-  path?: string;
-}
-
-export interface SourceLocation {
-  line: number;
-  column: number;
-  endLine?: number;
-  endColumn?: number;
-}
-
-export interface SourceBlock {
-  id: string;
-  kind?: string;
-  name?: string;
-  chapterSlug?: string;
-  path: string;
-  pageIndex?: number;
-  pageNumber?: number;
-  source?: SourceLocation;
-  frameKey?: string;
-  chainId?: string;
-  sectionSlug?: string;
-}
-
-export interface DocumentMeta {
-  title: string;
-  subtitle?: string;
-  organization?: string;
-  version?: string;
-  footer?: string;
-  workspaceLabel?: string;
-}
-
-export interface Theme {
-  pagePreset?: string;
-  pageLabel?: string;
-  pageWidth?: string;
-  pageHeight?: string;
-  pageAspectRatio?: string;
-  pageHeightRatio?: string;
-  pagePadding?: string;
-  fontFamily?: string;
-  accentColor?: string;
-  textColor?: string;
-}
-
-export interface BlockSource {
-  file: string;
-  path: string;
-  kind?: string;
-  chapter?: number;
-  slug?: string;
-  sectionIndex?: number;
-}
-
-// The engine currently emits one block kind only: a fully-rendered HTML page.
-// All historical structured-block variants (cover / section / paragraph /
-// list / figure / table / callout) were aspirational and never instantiated;
-// they were removed along with the unused client-side block model. If the
-// engine ever emits structured blocks again, reintroduce a discriminated
-// union here.
-export interface HtmlPageBlock {
-  id: string;
-  kind: "htmlPage";
-  title: string;
-  pageNumber: number;
-  html: string;
-  anchors?: string[];
-  className?: string;
-  source?: BlockSource;
-  frameKey?: string;
-  role?: string | null;
-  chrome?: boolean;
-  blockIds?: string[];
-}
-
-export type ObjectEntityKind =
-  | "page"
-  | "frame"
-  | "mdx-area"
-  | "mdx-block"
-  | "text"
-  | "component"
-  | "media";
-
-export interface EditableSourceRef {
-  path: string;
-  file?: string;
-  kind?: string;
-  objectId?: string;
-  scope?: string;
-  component?: string;
-  source?: SourceLocation;
-  line?: number;
-  column?: number;
-}
-
-export interface ObjectEntityRef {
-  id: string;
-  kind: ObjectEntityKind;
-}
-
-export interface ObjectEntity {
-  id: string;
-  kind: ObjectEntityKind;
-  label: string;
-  parentId?: string;
-  pageId?: string;
-  blockId?: string;
-  frameKey?: string;
-  chainId?: string;
-  source?: EditableSourceRef;
-  metadata?: Record<string, string | number | boolean | null>;
-}

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

@@ -1,7 +0,0 @@
-export * from "./anchorMapModel";
-export * from "./documentIndexes";
-export * from "./documentTypes";
-export * from "./objectEntityModel";
-export * from "./projectIdentityModel";
-export * from "./reactDocumentMetadataModel";
-export * from "./workspaceManifestModel";

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

@@ -1,55 +0,0 @@
-import type { ObjectEntity, ObjectEntityKind, ReaderDocument, SourceBlock } from "./documentTypes";
-
-export function createObjectEntityId(kind: ObjectEntityKind, ...parts: Array<string | number>) {
-  return [kind, ...parts.map((part) => encodeURIComponent(String(part)))].join(":");
-}
-
-export function createScopedObjectEntityId(kind: ObjectEntityKind, parentId: string | undefined, objectId: string) {
-  return parentId ? createObjectEntityId(kind, parentId, objectId) : createObjectEntityId(kind, objectId);
-}
-
-export function createBlockObjectEntityId(blockId: string) {
-  return createObjectEntityId("mdx-block", blockId);
-}
-
-export function createFrameObjectEntityId(frameKey: string) {
-  return createObjectEntityId("frame", frameKey);
-}
-
-export function createPageObjectEntityId(frameKey: string) {
-  return createObjectEntityId("page", frameKey);
-}
-
-export function createMdxAreaObjectEntityId(frameKey: string, chainId: string, indexInFrame: number) {
-  return createObjectEntityId("mdx-area", frameKey, chainId, indexInFrame);
-}
-
-export function getObjectEntityMap(document: Pick<ReaderDocument, "source"> | null | undefined): Record<string, ObjectEntity> {
-  return document?.source?.objectEntities ?? {};
-}
-
-export function getObjectEntity(document: Pick<ReaderDocument, "source"> | null | undefined, objectId: string): ObjectEntity | null {
-  return getObjectEntityMap(document)[objectId] ?? null;
-}
-
-export function sourceBlockToObjectEntity(block: SourceBlock): ObjectEntity {
-  return {
-    id: createBlockObjectEntityId(block.id),
-    kind: "mdx-block",
-    label: block.name ? `${block.name} ${block.id}` : block.id,
-    blockId: block.id,
-    frameKey: block.frameKey,
-    chainId: block.chainId,
-    pageId: block.frameKey ? createPageObjectEntityId(block.frameKey) : undefined,
-    source: {
-      path: block.path,
-      source: block.source,
-      line: block.source?.line,
-      column: block.source?.column,
-    },
-    metadata: {
-      blockKind: block.kind ?? null,
-      sectionSlug: block.sectionSlug ?? block.chapterSlug ?? null,
-    },
-  };
-}

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

@@ -1,15 +0,0 @@
-import type { DocumentMeta } from "./documentTypes";
-
-export interface ProjectIdentity {
-  name: string;
-  subtitle: string;
-  label: string;
-}
-
-export function getProjectIdentity(meta: DocumentMeta): ProjectIdentity {
-  return {
-    name: meta.organization ?? "",
-    subtitle: meta.subtitle ?? "",
-    label: meta.workspaceLabel ?? "",
-  };
-}

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

@@ -1,27 +0,0 @@
-import type {
-  ReaderDocument,
-  SourceBlock,
-} from "./documentTypes";
-
-export const PRESS_TREE_MDX_SOURCE_TYPE = "openpress-press-tree-mdx";
-
-export function isReactMdxDocument(document: Pick<ReaderDocument, "source"> | null | undefined) {
-  return document?.source?.type === PRESS_TREE_MDX_SOURCE_TYPE;
-}
-
-export function getSourceBlockMap(
-  document: Pick<ReaderDocument, "source"> | null | undefined,
-): Record<string, SourceBlock> {
-  if (!isReactMdxDocument(document)) return {};
-  const blockMap = document?.source?.blockMap;
-  if (!blockMap || typeof blockMap !== "object") return {};
-  return blockMap;
-}
-
-export function getSourceBlock(
-  document: Pick<ReaderDocument, "source"> | null | undefined,
-  blockId: string | null | undefined,
-): SourceBlock | null {
-  if (!blockId) return null;
-  return getSourceBlockMap(document)[blockId] ?? null;
-}

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

@@ -1,57 +0,0 @@
-// Shape of /openpress/workspace.json — the reader fetches this on
-// boot to decide between gallery routing (multi-Press) and direct
-// load (single Press). One entry per <Press> child of <Workspace>.
-//
-// Single-Press workspaces emit one entry with slug = "" and the
-// legacy /openpress/document.json path. Multi-Press emits one entry
-// per slug; each `documentUrl` resolves to /openpress/<slug>/document.json.
-
-export interface WorkspaceManifest {
-  version: 1;
-  // <Workspace name="..."> prop. Null when the user did not set one.
-  // Surfaced as the gallery header in the reader.
-  name: string | null;
-  presses: WorkspaceManifestPress[];
-}
-
-export interface WorkspaceManifestPress {
-  // Slug for this Press. Empty string for single-Press workspaces
-  // (legacy root); slug-shaped string for multi-Press.
-  slug: string;
-  // <Press title="..."> prop. Required in v1.0 contract.
-  title: string;
-  // Page geometry summary. Same shape as the reader's
-  // ReaderDocument.theme — readers can show a thumb in the gallery
-  // without loading the full document.json.
-  page: {
-    pagePreset?: string;
-    pageLabel?: string;
-    pageWidth?: string;
-    pageHeight?: string;
-    pageAspectRatio?: string;
-    pageHeightRatio?: string;
-  } | null;
-  // Number of pages produced for this Press.
-  pageCount: number;
-  // Absolute path the reader fetches for this Press's full document.json.
-  documentUrl: string;
-}
-
-// True when the reader should render the gallery first instead of
-// going straight into a single Press's document.
-export function manifestHasMultiplePresses(manifest: WorkspaceManifest): boolean {
-  return manifest.presses.length > 1;
-}
-
-// Find a Press entry by slug. Returns null when the slug is unknown.
-export function findManifestPress(
-  manifest: WorkspaceManifest,
-  slug: string,
-): WorkspaceManifestPress | null {
-  const normalized = slug.replace(/^\/+|\/+$/g, "");
-  for (const press of manifest.presses) {
-    const normalizedSlug = press.slug.replace(/^\/+|\/+$/g, "");
-    if (normalizedSlug === normalized) return press;
-  }
-  return null;
-}