@open-press/cli 0.3.0

package/template/core/.turbo/turbo-test.log

@@ -0,0 +1,341 @@
+
+> @open-press/core@0.2.0 test /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
+> pnpm run test:node && pnpm run test:react
+
+
+> @open-press/core@0.2.0 test:node /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
+> node --test tests/*.test.mjs
+
+TAP version 13
+# Subtest: cli pdf and deploy dry runs use workspace config
+ok 1 - cli pdf and deploy dry runs use workspace config
+  ---
+  duration_ms: 1898.54
+  ...
+# Subtest: static server serves workspace pdf and exposes deployment status
+ok 2 - static server serves workspace pdf and exposes deployment status
+  ---
+  duration_ms: 459.933375
+  ...
+# Subtest: deploy gate validates public adapters require confirmation
+ok 3 - deploy gate validates public adapters require confirmation
+  ---
+  duration_ms: 860.309125
+  ...
+# Subtest: validate supports machine-readable issue report JSON
+ok 4 - validate supports machine-readable issue report JSON
+  ---
+  duration_ms: 872.810334
+  ...
+# Subtest: validate warns when React source still contains pending openpress comments
+ok 5 - validate warns when React source still contains pending openpress comments
+  ---
+  duration_ms: 867.950458
+  ...
+# Subtest: validate reports React pagination overflow warnings from exported document metadata
+ok 6 - validate reports React pagination overflow warnings from exported document metadata
+  ---
+  duration_ms: 867.326666
+  ...
+# Subtest: inspect dry run describes render and browser inspection steps
+ok 7 - inspect dry run describes render and browser inspection steps
+  ---
+  duration_ms: 733.269791
+  ...
+# Subtest: export copies theme font stylesheet and font files for nested workspaces
+ok 8 - export copies theme font stylesheet and font files for nested workspaces
+  ---
+  duration_ms: 1151.318875
+  ...
+# Subtest: export supports chapter-opener pages as no-footer page surfaces
+ok 9 - export supports chapter-opener pages as no-footer page surfaces
+  ---
+  duration_ms: 1118.779584
+  ...
+# Subtest: export includes katex stylesheet and font assets for latex math
+ok 10 - export includes katex stylesheet and font assets for latex math
+  ---
+  duration_ms: 1114.688208
+  ...
+# Subtest: inspection source scan reads React MDX chapters when document/index.tsx is present
+ok 11 - inspection source scan reads React MDX chapters when document/index.tsx is present
+  ---
+  duration_ms: 94.999084
+  ...
+# Subtest: overflow measurements become page warnings with source metadata
+ok 12 - overflow measurements become page warnings with source metadata
+  ---
+  duration_ms: 0.838333
+  ...
+# Subtest: project asset endpoint renames media and updates document references
+ok 13 - project asset endpoint renames media and updates document references
+  ---
+  duration_ms: 176.032333
+  ...
+# Subtest: project asset endpoint refuses to delete referenced media
+ok 14 - project asset endpoint refuses to delete referenced media
+  ---
+  duration_ms: 81.165209
+  ...
+# Subtest: project asset endpoint renames component support directory and literal references
+ok 15 - project asset endpoint renames component support directory and literal references
+  ---
+  duration_ms: 62.403042
+  ...
+# Subtest: project asset endpoint creates a source comment from the asset dialog
+ok 16 - project asset endpoint creates a source comment from the asset dialog
+  ---
+  duration_ms: 48.93275
+  ...
+# Subtest: insertCommentMarker writes a JSX marker before the selected MDX block line
+ok 17 - insertCommentMarker writes a JSX marker before the selected MDX block line
+  ---
+  duration_ms: 37.651084
+  ...
+# Subtest: insertCommentMarker rejects paths outside editable React document sources
+ok 18 - insertCommentMarker rejects paths outside editable React document sources
+  ---
+  duration_ms: 5.009083
+  ...
+# Subtest: listCommentMarkers returns decoded pending comments from editable React sources
+ok 19 - listCommentMarkers returns decoded pending comments from editable React sources
+  ---
+  duration_ms: 222.229375
+  ...
+# Subtest: clearCommentMarkers removes one or all pending comments
+ok 20 - clearCommentMarkers removes one or all pending comments
+  ---
+  duration_ms: 135.881
+  ...
+# Subtest: updateCommentMarker updates an existing source marker without duplicating it
+ok 21 - updateCommentMarker updates an existing source marker without duplicating it
+  ---
+  duration_ms: 44.983834
+  ...
+# Subtest: handleCommentRequest accepts React inspector targets and writes source markers
+ok 22 - handleCommentRequest accepts React inspector targets and writes source markers
+  ---
+  duration_ms: 4.229959
+  ...
+# Subtest: handleCommentRequest updates pending comments through PATCH
+ok 23 - handleCommentRequest updates pending comments through PATCH
+  ---
+  duration_ms: 50.044709
+  ...
+# Subtest: handleCommentRequest lists and clears pending comments
+ok 24 - handleCommentRequest lists and clears pending comments
+  ---
+  duration_ms: 55.842959
+  ...
+# Subtest: handleCommentRequest rejects unsupported methods
+ok 25 - handleCommentRequest rejects unsupported methods
+  ---
+  duration_ms: 0.326792
+  ...
+# Subtest: scopeChapterCss prefixes ordinary selectors and nested media rules
+ok 26 - scopeChapterCss prefixes ordinary selectors and nested media rules
+  ---
+  duration_ms: 5.827334
+  ...
+# Subtest: buildChapterScopedCss reads chapter styles in discovery order
+ok 27 - buildChapterScopedCss reads chapter styles in discovery order
+  ---
+  duration_ms: 30.566
+  ...
+# Subtest: discovers React document chapters and component scopes from filesystem structure
+ok 28 - discovers React document chapters and component scopes from filesystem structure
+  ---
+  duration_ms: 63.16425
+  ...
+# Subtest: discovers React workspace using normalized config path overrides
+ok 29 - discovers React workspace using normalized config path overrides
+  ---
+  duration_ms: 7.797125
+  ...
+# Subtest: loadReactDocumentEntry loads document/index.tsx and normalizes config defaults
+ok 30 - loadReactDocumentEntry loads document/index.tsx and normalizes config defaults
+  ---
+  duration_ms: 190.757833
+  ...
+# Subtest: loadReactDocumentEntry maps manifest path overrides into normalized config
+ok 31 - loadReactDocumentEntry maps manifest path overrides into normalized config
+  ---
+  duration_ms: 43.071958
+  ...
+# Subtest: loadReactDocumentEntry rejects obvious top-level side effects before import
+ok 32 - loadReactDocumentEntry rejects obvious top-level side effects before import
+  ---
+  duration_ms: 18.955959
+  ...
+# Subtest: loadReactDocumentEntry rejects side-effect imports and top-level browser or file IO
+ok 33 - loadReactDocumentEntry rejects side-effect imports and top-level browser or file IO
+  ---
+  duration_ms: 20.809917
+  ...
+# Subtest: Vite and TypeScript expose React document import aliases
+ok 34 - Vite and TypeScript expose React document import aliases
+  ---
+  duration_ms: 9.857875
+  ...
+# Subtest: exportReactDocument writes a reader document from React shell pages and MDX chapters
+ok 35 - exportReactDocument writes a reader document from React shell pages and MDX chapters
+  ---
+  duration_ms: 208.410208
+  ...
+# Subtest: exportReactDocument paginates MDX by measured block groups and rerenders page subtrees
+ok 36 - exportReactDocument paginates MDX by measured block groups and rerenders page subtrees
+  ---
+  duration_ms: 58.566208
+  ...
+# Subtest: exportReactDocument injects static table-of-contents entries from rendered headings
+ok 37 - exportReactDocument injects static table-of-contents entries from rendered headings
+  ---
+  duration_ms: 65.722958
+  ...
+# Subtest: exportDocument delegates to React export when document/index.tsx is present
+ok 38 - exportDocument delegates to React export when document/index.tsx is present
+  ---
+  duration_ms: 77.547709
+  ...
+# Subtest: compileMdx renders MDX with stable block ids and component wrappers
+ok 39 - compileMdx renders MDX with stable block ids and component wrappers
+  ---
+  duration_ms: 18.214959
+  ...
+# Subtest: compileMdx rejects import declarations in chapter prose
+ok 40 - compileMdx rejects import declarations in chapter prose
+  ---
+  duration_ms: 0.331958
+  ...
+# Subtest: compileMdx can render only selected block ids for pagination subtrees
+ok 41 - compileMdx can render only selected block ids for pagination subtrees
+  ---
+  duration_ms: 7.782041
+  ...
+# Subtest: compileMdx rejects inline JSX components inside prose
+ok 42 - compileMdx rejects inline JSX components inside prose
+  ---
+  duration_ms: 0.939334
+  ...
+# Subtest: compileMdx renders GitHub-flavored markdown tables as table elements
+ok 43 - compileMdx renders GitHub-flavored markdown tables as table elements
+  ---
+  duration_ms: 5.05425
+  ...
+# Subtest: compileMdx converts TableCaption components into table captions
+ok 44 - compileMdx converts TableCaption components into table captions
+  ---
+  duration_ms: 7.21325
+  ...
+# Subtest: compileMdx renders inline LaTeX math without treating braces as MDX expressions
+ok 45 - compileMdx renders inline LaTeX math without treating braces as MDX expressions
+  ---
+  duration_ms: 13.443666
+  ...
+# Subtest: compileMdx renders display LaTeX math as a paginable block
+ok 46 - compileMdx renders display LaTeX math as a paginable block
+  ---
+  duration_ms: 38.801375
+  ...
+# Subtest: compileMdx treats a whole-line double-dollar formula as display math
+ok 47 - compileMdx treats a whole-line double-dollar formula as display math
+  ---
+  duration_ms: 12.7585
+  ...
+# Subtest: paginateMeasuredBlocks groups measured block ids without splitting atomic blocks
+ok 48 - paginateMeasuredBlocks groups measured block ids without splitting atomic blocks
+  ---
+  duration_ms: 0.982167
+  ...
+# Subtest: paginateMeasuredBlocks keeps an overlong block atomic and emits an overflow warning
+ok 49 - paginateMeasuredBlocks keeps an overlong block atomic and emits an overflow warning
+  ---
+  duration_ms: 0.219083
+  ...
+# Subtest: measureBlocksInChromium derives safe height from rendered page body when no fixed height is configured
+ok 50 - measureBlocksInChromium derives safe height from rendered page body when no fixed height is configured
+  ---
+  duration_ms: 229.745917
+  ...
+# Subtest: buildReactMeasurementCss includes real theme, component and chapter scoped CSS
+ok 51 - buildReactMeasurementCss includes real theme, component and chapter scoped CSS
+  ---
+  duration_ms: 35.629459
+  ...
+# Subtest: reader page registry reports same-index DOM replacements
+ok 52 - reader page registry reports same-index DOM replacements
+  ---
+  duration_ms: 55.891958
+  ...
+# Subtest: page route serializes and validates reader page hashes
+ok 53 - page route serializes and validates reader page hashes
+  ---
+  duration_ms: 20.061375
+  ...
+# Subtest: reader runtime leaves touch gestures to scrolling instead of page turns
+ok 54 - reader runtime leaves touch gestures to scrolling instead of page turns
+  ---
+  duration_ms: 3.51525
+  ...
+# Subtest: search emits source match JSON with file, line, column and preview
+ok 55 - search emits source match JSON with file, line, column and preview
+  ---
+  duration_ms: 1006.144209
+  ...
+# Subtest: replace preview reports changes without writing files
+ok 56 - replace preview reports changes without writing files
+  ---
+  duration_ms: 822.123458
+  ...
+# Subtest: replace apply writes prose matches and skips fenced code by default
+ok 57 - replace apply writes prose matches and skips fenced code by default
+  ---
+  duration_ms: 818.346291
+  ...
+# Subtest: search reads React MDX chapter content when document/index.tsx is present
+ok 58 - search reads React MDX chapter content when document/index.tsx is present
+  ---
+  duration_ms: 825.881375
+  ...
+# Subtest: replace applies to React MDX chapter content when document/index.tsx is present
+ok 59 - replace applies to React MDX chapter content when document/index.tsx is present
+  ---
+  duration_ms: 829.073666
+  ...
+# Subtest: search all includes React document entry and chapter implementation sources
+ok 60 - search all includes React document entry and chapter implementation sources
+  ---
+  duration_ms: 826.43775
+  ...
+1..60
+# tests 60
+# suites 0
+# pass 60
+# fail 0
+# cancelled 0
+# skipped 0
+# todo 0
+# duration_ms 10037.053417
+
+> @open-press/core@0.2.0 test:react /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
+> vitest run
+
+
+ RUN  v4.1.7 /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
+
+ ✓ tests/openpress-composer-mentions.test.ts (4 tests) 6ms
+ ✓ tests/openpress-react-document-metadata.test.ts (3 tests) 6ms
+ ✓ tests/openpress-frame-scheduler.test.ts (3 tests) 10ms
+ ✓ tests/openpress-project-mentions.test.ts (1 test) 261ms
+ ✓ tests/openpress-pagination.test.ts (11 tests) 179ms
+ ✓ tests/openpress-core-primitives.react.test.tsx (4 tests) 52ms
+ ✓ tests/openpress-bookmarks.react.test.tsx (4 tests) 145ms
+ ✓ tests/openpress-renderer.react.test.tsx (2 tests) 258ms
+ ✓ tests/openpress-inspector.react.test.tsx (13 tests) 105ms
+ ✓ tests/reader-runtime.react.test.tsx (7 tests) 367ms
+
+ Test Files  10 passed (10)
+      Tests  52 passed (52)
+   Start at  14:37:54
+   Duration  1.56s (transform 947ms, setup 0ms, import 1.82s, tests 1.39s, environment 7.26s)
+

package/template/core/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @open-press/core
+
+## 0.3.0
+
+### Minor Changes
+
+- Initial monorepo release of `@open-press/cli` and `@open-press/core` on npm.
+
+  **@open-press/cli** (new): scaffolder for open-press workspaces. Run `npx @open-press/cli init <target> --pack <pack>` to create a fixed-layout document workspace from a bundled template. Supports `editorial-monograph` and `claude-document` style packs, metadata flags, and AI-agent skill installation under `.claude/skills/` and `.agents/skills/`.
+
+  **@open-press/core** (new): framework runtime, CLI engine, render pipeline, and base page primitives (BasePage, BaseCoverPage, BaseTocPage, BaseBackCoverPage, BaseFigure, BaseCallout). Consumed transitively by workspaces scaffolded via `@open-press/cli`. Exposes the `open-press` bin (dev / build / preview / validate / pdf / deploy / export).

package/template/core/README.md

@@ -0,0 +1,36 @@
+# @open-press/core
+
+Framework runtime, CLI engine, and page primitives for [open-press](https://github.com/quan0715/open-press) — an AI-first fixed-layout document workspace.
+
+Most users do **not** install this package directly. Instead, scaffold a workspace with the CLI:
+
+```bash
+npx @open-press/cli init my-doc --pack editorial-monograph
+```
+
+The scaffolded workspace contains a snapshot of this package.
+
+## Direct use
+
+If you want the runtime primitives in an existing project:
+
+```bash
+npm install @open-press/core
+```
+
+```tsx
+import {
+  BasePage,
+  BaseCoverPage,
+  BaseTocPage,
+  BaseBackCoverPage,
+  BaseFigure,
+  BaseCallout,
+} from "@open-press/core";
+```
+
+The CLI bin (`open-press`) supports dev / build / preview / validate / pdf / deploy / export commands. It requires a workspace with `openpress.config.mjs` and the surrounding framework files (which the scaffolder installs).
+
+## License
+
+MIT — see [LICENSE](https://github.com/quan0715/open-press/blob/main/LICENSE).

package/template/core/engine/chrome-pdf.d.mts

@@ -0,0 +1,34 @@
+import type { ChildProcess } from "node:child_process";
+
+export interface ChromeDevToolsClient {
+  send(method: string, params?: Record<string, unknown>): Promise<any>;
+  close(): void;
+}
+
+export interface PrintUrlToPdfOptions {
+  root: string;
+  url: string;
+  outPath: string;
+  chrome?: string;
+  waitForReady?: (client: ChromeDevToolsClient) => Promise<unknown>;
+  printOptions?: Record<string, unknown>;
+  debuggingPortBase?: number;
+  debuggingPortRange?: number;
+  profilePrefix?: string;
+}
+
+export interface EvaluateUrlWithChromeOptions {
+  root: string;
+  url: string;
+  chrome?: string;
+  evaluate: (client: ChromeDevToolsClient) => Promise<unknown>;
+  emulatedMedia?: "screen" | "print" | "none";
+  debuggingPortBase?: number;
+  debuggingPortRange?: number;
+  profilePrefix?: string;
+}
+
+export function printUrlToPdf(options: PrintUrlToPdfOptions): Promise<unknown>;
+export function evaluateUrlWithChrome(options: EvaluateUrlWithChromeOptions): Promise<unknown>;
+export function waitForPrintReady(client: ChromeDevToolsClient): Promise<number>;
+export function stopChildProcess(child: ChildProcess): Promise<void>;