@open-press/core 1.0.0 → 1.1.1

package/README.md

@@ -1,6 +1,6 @@
 # @open-press/core
 
-Framework runtime, CLI engine, and Press Tree primitives for [open-press](https://github.com/quan0715/open-press) — an AI-first fixed-layout document workspace.
+Package-owned runtime, render engine, and Press Tree 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:
 
@@ -8,7 +8,7 @@ Most users do **not** install this package directly. Instead, scaffold a workspa
 npx @open-press/cli init my-doc
 ```
 
-The scaffolded workspace contains a snapshot of this package. Starter files are supplied by skills, not by `@open-press/core`.
+The scaffolded workspace depends on this package; it does not vendor a copy of the runtime. Starter files are supplied by skills or by project-specific `press/` source files.
 
 ## Direct use
 
@@ -36,7 +36,16 @@ import { Sections, Toc } from "@open-press/core/manuscript";
 For the maintenance contract around Press Tree, page geometry presets, and the
 allocation pipeline, see [`docs/press-tree.md`](https://github.com/quan0715/open-press/blob/main/docs/press-tree.md).
 
-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).
+The public CLI bin lives in `@open-press/cli` and delegates runtime commands to this package:
+
+```bash
+npm install @open-press/core @open-press/cli
+npx open-press dev .
+npx open-press render .
+npx open-press pdf .
+```
+
+`@open-press/core` owns the internal browser shell (`index.html`), Vite config, React app runtime, render pipeline, and static server. A workspace owns `press/`, `package.json`, media, components, and theme files.
 
 ## License
 

package/engine/cli.mjs

@@ -73,7 +73,7 @@ async function main(commandName, argv) {
 }
 
 async function printHelp() {
-  console.log(`Usage: node engine/cli.mjs <command> [path] [options]
+  console.log(`Usage: open-press <command> [path] [options]
 
 Commands:
   validate

package/engine/commands/_shared.mjs

@@ -1,4 +1,5 @@
 import { spawn, spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -8,8 +9,14 @@ import { exportDocument } from "../document-export.mjs";
 import { optimizePdfMediaForStaticRoot } from "../output/pdf-media.mjs";
 
 export const ENGINE_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+export const FRAMEWORK_ROOT = path.resolve(ENGINE_DIR, "..");
 export const CLI_ENTRY = path.join(ENGINE_DIR, "cli.mjs");
 export const STATIC_SERVER = path.join(ENGINE_DIR, "output", "static-server.mjs");
+export const VITE_CONFIG = path.join(FRAMEWORK_ROOT, "vite.config.ts");
+
+const require = createRequire(import.meta.url);
+const VITE_PACKAGE_JSON = require.resolve("vite/package.json");
+export const VITE_BIN = path.join(path.dirname(VITE_PACKAGE_JSON), "bin", "vite.js");
 
 export function parseOptions(argv) {
   const options = {};
@@ -47,8 +54,12 @@ export function formatDisplayPath(absolutePath) {
   return relative;
 }
 
-export function runCommand(commandName, commandArgs, cwd) {
-  const result = spawnSync(commandName, commandArgs, { cwd, stdio: "inherit" });
+export function runCommand(commandName, commandArgs, cwd, opts = {}) {
+  const result = spawnSync(commandName, commandArgs, {
+    cwd,
+    env: { ...process.env, ...(opts.env ?? {}) },
+    stdio: "inherit",
+  });
   return result.status ?? 1;
 }
 
@@ -58,6 +69,24 @@ export function formatNodeScriptCommand(root, scriptPath) {
   return `node ${displayPath}`;
 }
 
+export function formatOpenPressCommand(args = []) {
+  return `open-press ${args.join(" ")}`.trim();
+}
+
+export function workspaceRuntimeEnv(root) {
+  return { OPENPRESS_WORKSPACE_ROOT: path.resolve(root) };
+}
+
+export function viteCommandArgs(args = []) {
+  return [VITE_BIN, ...args];
+}
+
+export function formatViteCommand(root, args = []) {
+  const script = formatNodeScriptCommand(root, VITE_BIN);
+  const config = formatDisplayPath(VITE_CONFIG);
+  return `${script} ${args.join(" ")} --config ${config}`.replace(/\s+/g, " ").trim();
+}
+
 export async function buildReactStatic({ root, noBuild = false, recurse, silent = false }) {
   if (noBuild) return 0;
   if (!silent) {
@@ -65,9 +94,10 @@ export async function buildReactStatic({ root, noBuild = false, recurse, silent
   }
 
   await exportDocument(root);
-  const result = spawnSync("npx", ["vite", "build", "--config", "vite.config.ts"], {
+  const result = spawnSync("node", viteCommandArgs(["build", "--config", VITE_CONFIG]), {
     cwd: root,
     encoding: "utf8",
+    env: { ...process.env, ...workspaceRuntimeEnv(root) },
   });
   return result.status ?? 1;
 }

package/engine/commands/deploy.mjs

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { deploySync } from "../output/deploy-sync.mjs";
-import { CLI_ENTRY, buildReactPdf, formatNodeScriptCommand, runCommand, writePdfStageDeployConfig } from "./_shared.mjs";
+import { buildReactPdf, formatOpenPressCommand, runCommand, writePdfStageDeployConfig } from "./_shared.mjs";
 
 export async function run({ root, config, options, recurse }) {
   if (config.deploy.requiresConfirmation === true && !options.confirm) {
@@ -12,9 +12,9 @@ export async function run({ root, config, options, recurse }) {
   const commitDirty = config.deploy.commitDirty;
   if (options.dryRun) {
     console.log("OpenPress deploy dry run");
-    console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} render . --renderer react`);
+    console.log(`Command: ${formatOpenPressCommand(["render", ".", "--renderer", "react"])}`);
     console.log(`Step:    deploy-sync (copy ${config.outputDir} → ${source})`);
-    console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} pdf . --output ${source}/${config.pdf.filename}`);
+    console.log(`Command: ${formatOpenPressCommand(["pdf", ".", "--output", `${source}/${config.pdf.filename}`])}`);
     console.log(`Step:    write ${source}/openpress/deploy.json with deployment metadata`);
     console.log(`Command: npx wrangler pages deploy ${source}${projectName ? ` --project-name=${projectName}` : ""}${commitDirty ? " --commit-dirty=true" : ""}`);
     return 0;

package/engine/commands/dev.mjs

@@ -1,6 +1,13 @@
 import { exportDocument } from "../document-export.mjs";
 import { diagnose } from "./doctor.mjs";
-import { CLI_ENTRY, formatNodeScriptCommand, runCommand } from "./_shared.mjs";
+import {
+  VITE_CONFIG,
+  formatOpenPressCommand,
+  formatViteCommand,
+  runCommand,
+  viteCommandArgs,
+  workspaceRuntimeEnv,
+} from "./_shared.mjs";
 
 export async function run({ root, options }) {
   const renderer = options.renderer ?? "react";
@@ -14,9 +21,9 @@ export async function run({ root, options }) {
   if (options.dryRun) {
     console.log(`OpenPress dev URL: ${url}`);
     if (!options.noBuild) {
-      console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} export .`);
+      console.log(`Command: ${formatOpenPressCommand(["export", "."])}`);
     }
-    console.log(`Command: npx vite --force --config vite.config.ts --host ${host} --port ${port}`);
+    console.log(`Command: ${formatViteCommand(root, ["--force", "--host", host, "--port", port])}`);
     return 0;
   }
   if (!options.noBuild) {
@@ -27,7 +34,9 @@ export async function run({ root, options }) {
   await printDoctorNoticeIfStale(root);
 
   console.log(`OpenPress dev: ${url}`);
-  return runCommand("npx", ["vite", "--force", "--config", "vite.config.ts", "--host", host, "--port", port], root);
+  return runCommand("node", viteCommandArgs(["--force", "--config", VITE_CONFIG, "--host", host, "--port", port]), root, {
+    env: workspaceRuntimeEnv(root),
+  });
 }
 
 async function printDoctorNoticeIfStale(root) {

package/engine/commands/image.mjs

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { CLI_ENTRY, STATIC_SERVER, buildReactImages, formatNodeScriptCommand } from "./_shared.mjs";
+import { STATIC_SERVER, buildReactImages, formatNodeScriptCommand, formatOpenPressCommand } from "./_shared.mjs";
 
 export async function run({ root, config, options, recurse }) {
   const outputDir = options.output ? path.resolve(root, options.output) : path.join(config.paths.outputDir, "images");
@@ -7,7 +7,7 @@ export async function run({ root, config, options, recurse }) {
   const port = options.port ?? "5186";
 
   if (options.dryRun) {
-    console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} render . --renderer react`);
+    console.log(`Command: ${formatOpenPressCommand(["render", ".", "--renderer", "react"])}`);
     console.log(`Command: ${formatNodeScriptCommand(root, STATIC_SERVER)} ${config.outputDir} --host ${host} --port ${port} --workspace .`);
     console.log(`Chrome image export URL: http://${host}:${port}/?print=1`);
     console.log(`Output: ${path.relative(root, path.join(outputDir, "page-001.png"))}`);

package/engine/commands/inspect.mjs

@@ -1,5 +1,6 @@
 import { inspectWorkspace } from "../runtime/inspection.mjs";
 import { exitCodeForIssueReport } from "../runtime/issue-report.mjs";
+import { STATIC_SERVER, formatNodeScriptCommand, formatOpenPressCommand } from "./_shared.mjs";
 
 export async function run({ root, config, options, recurse }) {
   const host = options.host ?? "127.0.0.1";
@@ -8,9 +9,9 @@ export async function run({ root, config, options, recurse }) {
 
   if (options.dryRun) {
     if (!options.noBuild) {
-      console.log("Command: node engine/cli.mjs render . --renderer react");
+      console.log(`Command: ${formatOpenPressCommand(["render", ".", "--renderer", "react"])}`);
     }
-    console.log(`Command: node engine/output/static-server.mjs ${config.outputDir} --host ${host} --port ${port} --workspace .`);
+    console.log(`Command: ${formatNodeScriptCommand(root, STATIC_SERVER)} ${config.outputDir} --host ${host} --port ${port} --workspace .`);
     console.log(`Chrome inspection URL: ${url}`);
     return 0;
   }

package/engine/commands/pdf.mjs

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { CLI_ENTRY, STATIC_SERVER, buildReactPdf, formatNodeScriptCommand } from "./_shared.mjs";
+import { STATIC_SERVER, buildReactPdf, formatNodeScriptCommand, formatOpenPressCommand } from "./_shared.mjs";
 
 export async function run({ root, config, options, recurse }) {
   const outputPath = options.output ? path.resolve(root, options.output) : undefined;
@@ -7,7 +7,7 @@ export async function run({ root, config, options, recurse }) {
     const relOutput = path.relative(root, outputPath ?? config.paths.pdf);
     const host = options.host ?? "127.0.0.1";
     const port = options.port ?? "5185";
-    console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} render . --renderer react`);
+    console.log(`Command: ${formatOpenPressCommand(["render", ".", "--renderer", "react"])}`);
     console.log(`Command: ${formatNodeScriptCommand(root, STATIC_SERVER)} ${config.outputDir} --host ${host} --port ${port} --workspace .`);
     console.log(`Command: Chrome --print-to-pdf=${relOutput} http://${host}:${port}/?print=1`);
     return 0;

package/engine/commands/preview.mjs

@@ -1,4 +1,4 @@
-import { CLI_ENTRY, STATIC_SERVER, formatNodeScriptCommand, runCommand } from "./_shared.mjs";
+import { STATIC_SERVER, formatNodeScriptCommand, formatOpenPressCommand, runCommand } from "./_shared.mjs";
 
 export async function run({ root, config, options, recurse }) {
   const renderer = options.renderer ?? "react";
@@ -12,7 +12,7 @@ export async function run({ root, config, options, recurse }) {
   if (options.dryRun) {
     console.log(`OpenPress preview URL: ${url}`);
     if (!options.noBuild) {
-      console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} render . --renderer react`);
+      console.log(`Command: ${formatOpenPressCommand(["render", ".", "--renderer", "react"])}`);
     }
     console.log(`Command: ${formatNodeScriptCommand(root, STATIC_SERVER)} ${config.outputDir} --host ${host} --port ${port} --workspace .`);
     return 0;

package/engine/commands/render.mjs

@@ -1,5 +1,5 @@
 import { exportDocument } from "../document-export.mjs";
-import { runCommand } from "./_shared.mjs";
+import { VITE_CONFIG, formatOpenPressCommand, formatViteCommand, runCommand, viteCommandArgs, workspaceRuntimeEnv } from "./_shared.mjs";
 
 export async function run({ root, options }) {
   const renderer = options.renderer ?? "react";
@@ -8,10 +8,12 @@ export async function run({ root, options }) {
     return 2;
   }
   if (options.dryRun) {
-    console.log("Command: node engine/cli.mjs export .");
-    console.log("Command: npx vite build --config vite.config.ts");
+    console.log(`Command: ${formatOpenPressCommand(["export", "."])}`);
+    console.log(`Command: ${formatViteCommand(root, ["build"])}`);
     return 0;
   }
   await exportDocument(root);
-  return runCommand("npx", ["vite", "build", "--config", "vite.config.ts"], root);
+  return runCommand("node", viteCommandArgs(["build", "--config", VITE_CONFIG]), root, {
+    env: workspaceRuntimeEnv(root),
+  });
 }

package/engine/commands/replace.mjs

@@ -3,7 +3,7 @@ import { replaceSourceText } from "../runtime/source-text-tools.mjs";
 export async function run({ config, options }) {
   const args = replaceArgsFromOptions(options);
   if (!args) {
-    console.error("Usage: node engine/cli.mjs replace [path] <from> <to> [--json] [--apply] [--scope content|all] [--include-code] [--case-sensitive]");
+    console.error("Usage: open-press replace [path] <from> <to> [--json] [--apply] [--scope content|all] [--include-code] [--case-sensitive]");
     return 2;
   }
 

package/engine/commands/search.mjs

@@ -3,7 +3,7 @@ import { searchSourceText } from "../runtime/source-text-tools.mjs";
 export async function run({ config, options }) {
   const query = searchQueryFromOptions(options);
   if (!query) {
-    console.error("Usage: node engine/cli.mjs search [path] <query> [--json] [--scope content|all] [--case-sensitive]");
+    console.error("Usage: open-press search [path] <query> [--json] [--scope content|all] [--case-sensitive]");
     return 2;
   }
 

package/engine/commands/typecheck.mjs

@@ -1,7 +1,9 @@
 import fs from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { createRequire } from "node:module";
-import { runCommand } from "./_shared.mjs";
+import { FRAMEWORK_ROOT, runCommand } from "./_shared.mjs";
+import { loadConfig } from "../runtime/config.mjs";
 
 // Run typecheck via the locally installed typescript. The previous
 // implementation used `npx tsc`; npm 11 + Node 24 (our CI / release
@@ -17,14 +19,15 @@ import { runCommand } from "./_shared.mjs";
 //      even when bare require.resolve doesn't, which is what CI hits.
 export async function run({ root }) {
   const absoluteRoot = path.resolve(root);
+  const projectPath = await resolveTypecheckProject(absoluteRoot);
 
   const tscBin = resolveTscBin(absoluteRoot);
   if (tscBin) {
-    return runCommand("node", [tscBin, "--noEmit", "-p", "tsconfig.json"], absoluteRoot);
+    return runCommand("node", [tscBin, "--noEmit", "-p", projectPath], absoluteRoot);
   }
 
   if (hasCommand("pnpm")) {
-    return runCommand("pnpm", ["exec", "tsc", "--noEmit", "-p", "tsconfig.json"], absoluteRoot);
+    return runCommand("pnpm", ["exec", "tsc", "--noEmit", "-p", projectPath], absoluteRoot);
   }
 
   console.error("[openpress] typescript is not installed in this workspace.");
@@ -32,6 +35,88 @@ export async function run({ root }) {
   return 1;
 }
 
+async function resolveTypecheckProject(absoluteRoot) {
+  const workspaceProject = path.join(absoluteRoot, "tsconfig.json");
+  if (fs.existsSync(workspaceProject)) return workspaceProject;
+  return await writeGeneratedTypecheckProject(absoluteRoot);
+}
+
+async function writeGeneratedTypecheckProject(absoluteRoot) {
+  const config = await loadConfig(absoluteRoot);
+  const outDir = path.join(absoluteRoot, ".openpress");
+  await mkdir(outDir, { recursive: true });
+
+  const projectPath = path.join(outDir, "typecheck.tsconfig.json");
+  const fromProjectDir = (target) => normalizePath(path.relative(outDir, target)) || ".";
+  const fromWorkspace = (target) => normalizePath(path.relative(absoluteRoot, target)) || ".";
+  const includeRoot = (target) => {
+    const relative = fromProjectDir(target);
+    return relative === "." ? "." : relative;
+  };
+
+  const typeRoots = [
+    path.join(absoluteRoot, "node_modules", "@types"),
+    path.join(FRAMEWORK_ROOT, "node_modules", "@types"),
+  ]
+    .filter((dir) => fs.existsSync(dir))
+    .map((dir) => fromProjectDir(dir));
+
+  const typecheckConfig = {
+    compilerOptions: {
+      target: "ES2022",
+      useDefineForClassFields: true,
+      lib: ["DOM", "DOM.Iterable", "ES2022"],
+      allowJs: false,
+      skipLibCheck: true,
+      esModuleInterop: true,
+      allowSyntheticDefaultImports: true,
+      strict: true,
+      forceConsistentCasingInFileNames: true,
+      module: "ESNext",
+      moduleResolution: "Bundler",
+      types: ["node"],
+      ...(typeRoots.length > 0 ? { typeRoots } : {}),
+      resolveJsonModule: true,
+      isolatedModules: true,
+      noEmit: true,
+      jsx: "react-jsx",
+      ignoreDeprecations: "6.0",
+      baseUrl: "..",
+      paths: {
+        "@open-press/core": [fromWorkspace(path.join(FRAMEWORK_ROOT, "src", "openpress", "core", "index.tsx"))],
+        "@open-press/core/mdx": [fromWorkspace(path.join(FRAMEWORK_ROOT, "src", "openpress", "mdx", "index.ts"))],
+        "@open-press/core/manuscript": [fromWorkspace(path.join(FRAMEWORK_ROOT, "src", "openpress", "manuscript", "index.tsx"))],
+        "@open-press/core/numbering": [fromWorkspace(path.join(FRAMEWORK_ROOT, "src", "openpress", "numbering", "index.ts"))],
+        "@/components": [
+          `${fromWorkspace(config.paths.componentsDir)}/index.ts`,
+          `${fromWorkspace(config.paths.componentsDir)}/index.tsx`,
+        ],
+        "@/components/*": [`${fromWorkspace(config.paths.componentsDir)}/*`],
+        "@workspace/content": [fromWorkspace(config.paths.sourceDir)],
+        "@workspace/content/*": [`${fromWorkspace(config.paths.sourceDir)}/*`],
+        "@workspace/media": [fromWorkspace(config.paths.mediaDir)],
+        "@workspace/media/*": [`${fromWorkspace(config.paths.mediaDir)}/*`],
+        "@workspace/components": [fromWorkspace(config.paths.componentsDir)],
+        "@workspace/components/*": [`${fromWorkspace(config.paths.componentsDir)}/*`],
+        "@/*": [`${fromWorkspace(path.join(FRAMEWORK_ROOT, "src"))}/*`],
+      },
+    },
+    include: [
+      `${includeRoot(config.paths.documentRoot)}/**/*.ts`,
+      `${includeRoot(config.paths.documentRoot)}/**/*.tsx`,
+      "../tests/**/*.test.ts",
+      "../tests/**/*.test.tsx",
+    ],
+  };
+
+  await writeFile(projectPath, `${JSON.stringify(typecheckConfig, null, 2)}\n`, "utf8");
+  return projectPath;
+}
+
+function normalizePath(value) {
+  return value.replaceAll("\\", "/");
+}
+
 function resolveTscBin(absoluteRoot) {
   try {
     const require = createRequire(path.join(absoluteRoot, "package.json"));
@@ -41,6 +126,14 @@ function resolveTscBin(absoluteRoot) {
     // fall through to .bin probe
   }
 
+  try {
+    const require = createRequire(import.meta.url);
+    const pkgPath = require.resolve("typescript/package.json");
+    return path.join(path.dirname(pkgPath), "bin", "tsc");
+  } catch {
+    // fall through to .bin probe
+  }
+
   let dir = absoluteRoot;
   while (true) {
     const candidate = path.join(dir, "node_modules", ".bin", "tsc");

package/engine/output/static-server.mjs

@@ -2,6 +2,7 @@ import fs from "node:fs/promises";
 import http from "node:http";
 import path from "node:path";
 import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 import { loadConfig, publicPdfHref } from "../runtime/config.mjs";
 import { searchSourceText } from "../runtime/source-text-tools.mjs";
 import { handleProjectAssetRequest } from "../react/project-asset-endpoint.mjs";
@@ -13,6 +14,9 @@ const port = Number(valueAfter(rest, "--port") ?? "8765");
 const root = path.resolve(rootArg);
 const workspace = path.resolve(valueAfter(rest, "--workspace") ?? await inferWorkspaceRoot(root));
 const config = await loadConfig(workspace);
+const ENGINE_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const FRAMEWORK_ROOT = path.resolve(ENGINE_DIR, "..");
+const CLI_ENTRY = path.join(ENGINE_DIR, "cli.mjs");
 
 const mimeTypes = {
   ".html": "text/html; charset=utf-8",
@@ -210,7 +214,7 @@ async function handleLocalPdfExportRequest(req, res) {
     ok: result.code === 0 && exists,
     code: result.code,
     pdf: `/__openpress/local-pdf-file?ts=${Date.now()}`,
-    command: "node engine/cli.mjs pdf .",
+    command: "open-press pdf .",
     stdout: result.stdout,
     stderr: result.stderr,
   });
@@ -250,7 +254,7 @@ async function handleDeployRequest(req, res) {
       deploy_adapter: config.deploy.adapter,
       deploy_source: config.deploy.source,
       deploy_project_name: config.deploy.projectName,
-      command: "node engine/cli.mjs deploy . --confirm",
+      command: "open-press deploy . --confirm",
     });
     return;
   }
@@ -269,7 +273,7 @@ async function handleDeployRequest(req, res) {
     pdf: deployedUrl ? `${deployedUrl}/${config.pdf.filename}` : deploymentInfo.pdf,
     public_url: publicUrl,
     dirty: false,
-    command: "node engine/cli.mjs deploy . --confirm",
+    command: "open-press deploy . --confirm",
     stdout: result.stdout,
     stderr: result.stderr,
   });
@@ -354,7 +358,7 @@ async function handleMediaFileRequest(req, res, url) {
 
 function runLocalPdfExport() {
   return new Promise((resolve) => {
-    const child = spawn("node", ["engine/cli.mjs", "pdf", "."], {
+    const child = spawn("node", [CLI_ENTRY, "pdf", "."], {
       cwd: workspace,
       shell: false,
     });
@@ -377,7 +381,7 @@ function runLocalPdfExport() {
 
 function runDeploy() {
   return new Promise((resolve) => {
-    const child = spawn("node", ["engine/cli.mjs", "deploy", ".", "--confirm"], {
+    const child = spawn("node", [CLI_ENTRY, "deploy", ".", "--confirm"], {
       cwd: workspace,
       shell: false,
     });
@@ -471,10 +475,10 @@ function getDeploymentSourcePaths() {
     config.paths.themeDir,
     config.paths.designDoc,
     config.paths.componentsDir,
-    path.join(workspace, "src"),
-    path.join(workspace, "index.html"),
+    path.join(FRAMEWORK_ROOT, "src"),
+    path.join(FRAMEWORK_ROOT, "index.html"),
+    path.join(FRAMEWORK_ROOT, "vite.config.ts"),
     path.join(workspace, "package.json"),
-    path.join(workspace, "vite.config.ts"),
   ];
 }
 

package/index.html

@@ -4,6 +4,10 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
+    <link rel="stylesheet" href="/openpress/fonts.css" />
+    <link rel="stylesheet" href="/openpress/tokens.css" />
+    <link rel="stylesheet" href="/openpress/content.css" />
+    <link rel="stylesheet" href="/openpress/components.css" />
     <title>OpenPress Workspace</title>
   </head>
   <body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-press/core",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "type": "module",
   "description": "open-press core — runtime primitives, CLI, and render pipeline for AI-first fixed-layout documents.",
   "license": "MIT",
@@ -31,13 +31,12 @@
     "./manuscript": "./src/openpress/manuscript/index.tsx",
     "./numbering": "./src/openpress/numbering/index.ts"
   },
-  "bin": {
-    "open-press": "engine/cli.mjs"
-  },
   "files": [
     "engine",
+    "src/main.tsx",
     "src/openpress",
     "src/styles",
+    "src/vite-env.d.ts",
     "index.html",
     "vite.config.ts",
     "tsconfig.json"
@@ -52,13 +51,16 @@
     "js-yaml": "^4.1.1",
     "katex": "^0.16.47",
     "lucide-react": "^1.16.0",
+    "@vitejs/plugin-react": "^6.0.2",
     "playwright": "^1.60.0",
     "postcss": "^8.5.6",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "rehype-katex": "^7.0.1",
     "remark-gfm": "^4.0.1",
-    "remark-math": "^6.0.0"
+    "remark-math": "^6.0.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.13"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",
@@ -66,10 +68,7 @@
     "@types/node": "^25.8.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.2",
     "jsdom": "^26.1.0",
-    "typescript": "^6.0.3",
-    "vite": "^8.0.13",
     "vitest": "^4.1.6"
   },
   "scripts": {

package/src/main.tsx

@@ -0,0 +1,16 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { OpenPressApp } from "./openpress/app";
+import "./styles/openpress.css";
+
+const rootElement = document.getElementById("root");
+
+if (!rootElement) {
+  throw new Error("OpenPress renderer requires a #root element.");
+}
+
+createRoot(rootElement).render(
+  <StrictMode>
+    <OpenPressApp />
+  </StrictMode>,
+);

package/src/openpress/workbench/project/projectSourceModel.ts

@@ -1,5 +1,5 @@
-// Source directory paths come from vite.config.ts build-time defines, which
-// in turn read openpress.config.mjs. The React app does not hardcode `document/`.
+// Source directory paths come from package-owned Vite build-time defines,
+// which read the active workspace conventions and package.json config.
 
 export const PROJECT_SOURCES = {
   content: {

package/src/styles/openpress.css

@@ -1,8 +1,3 @@
-@import url("/openpress/fonts.css");
-@import url("/openpress/tokens.css");
-@import url("/openpress/content.css");
-@import url("/openpress/components.css");
-
 @import "./openpress/app-shell.css";
 @import "./openpress/workspace-gallery.css";
 @import "./openpress/workbench.css";

package/src/vite-env.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="vite/client" />
+
+// Workspace path constants injected by vite.config.ts at build time.
+// These come from package-owned workspace conventions and package.json config.
+declare const __OPENPRESS_CONTENT_PATH__: string;
+declare const __OPENPRESS_MEDIA_PATH__: string;
+declare const __OPENPRESS_COMPONENTS_PATH__: string;
+declare const __OPENPRESS_PDF_HREF__: string;

package/vite.config.ts

@@ -54,8 +54,10 @@ const workspaceDefines = {
 };
 
 export default defineConfig({
+  root: frameworkRoot,
   base: "./",
   cacheDir: path.join(workspaceRoot, ".openpress", "vite-client"),
+  publicDir: path.join(workspaceRoot, "public"),
   plugins: [openpressLocalDeployPlugin(), react()],
   define: workspaceDefines,
   resolve: {
@@ -409,7 +411,7 @@ function isLocalDeployConfigured() {
 function localDeploySetupMessage() {
   if (isLocalDeployConfigured()) return undefined;
   if (openpressConfig.deploy.adapter === "cloudflare-pages") {
-    return "Cloudflare Pages deployment requires `deploy.projectName` in openpress.config.mjs.";
+    return "Cloudflare Pages deployment requires `openpress.deploy.projectName` in package.json.";
   }
   return `Deployment adapter \`${openpressConfig.deploy.adapter}\` is not configured.`;
 }
@@ -472,18 +474,16 @@ function getLocalDeploymentSourcePaths() {
     openpressConfig.paths.designDoc,
     openpressConfig.paths.componentsDir,
     path.join(frameworkRoot, "src"),
-    path.join(workspaceRoot, "index.html"),
+    path.join(frameworkRoot, "index.html"),
+    path.join(frameworkRoot, "vite.config.ts"),
     path.join(workspaceRoot, "package.json"),
     path.join(workspaceRoot, "openpress.config.mjs"),
     openpressConfig.configPath,
-    path.join(workspaceRoot, "vite.config.ts"),
   ];
 }
 
 function openpressCliCommand(args: string[]) {
-  const relativeCliPath = path.relative(workspaceRoot, openpressCliPath).replaceAll("\\", "/");
-  const displayCliPath = relativeCliPath && !relativeCliPath.startsWith("../") ? relativeCliPath : openpressCliPath;
-  return `node ${displayCliPath} ${args.join(" ")}`;
+  return `open-press ${args.join(" ")}`;
 }
 
 async function findNewestLocalSourceMtime(paths: string[]) {