@open-press/cli 0.8.0 → 1.0.0

package/template/core/src/styles/openpress/workspace-gallery.css

@@ -0,0 +1,300 @@
+/* Workspace gallery — the reader's landing page for multi-Press
+   workspaces. Shows a card per <Press> child; clicking enters that
+   document's reader. Single-Press workspaces skip the gallery and
+   load the document directly, so this CSS is dormant until users
+   add a second <Press> to their <Workspace>.
+
+   Layout intent: Figma-style file grid — uniform card width, fixed
+   thumbnail aspect ratio (4:3), filename + meta below. Each card
+   loads its first page asynchronously and renders it scaled-down
+   inside the thumbnail slot. */
+
+.openpress-workspace-gallery {
+  --workspace-bg: #10110f;
+  --workspace-bg-soft: #171813;
+  --workspace-ink: #f4f1e8;
+  --workspace-muted: rgba(244, 241, 232, 0.52);
+  --workspace-line: rgba(244, 241, 232, 0.12);
+  --workspace-card: #f7f5ee;
+  --workspace-card-ink: #141411;
+  --workspace-card-muted: #65635d;
+  --workspace-card-line: rgba(20, 20, 17, 0.1);
+  --workspace-card-stage: #e8e5dc;
+  display: grid;
+  gap: 2rem;
+  min-height: 100vh;
+  max-width: none;
+  margin: 0;
+  padding: 3.6rem clamp(2rem, 4vw, 4.5rem) 6rem;
+  font-family: var(--openpress-font-body, system-ui, sans-serif);
+  color: var(--workspace-ink);
+  background:
+    linear-gradient(180deg, var(--workspace-bg-soft), var(--workspace-bg) 42rem),
+    var(--workspace-bg);
+}
+
+.openpress-workspace-gallery__header {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  align-items: end;
+  justify-content: space-between;
+  gap: 2.5rem;
+  padding: 0 0 1.45rem;
+  border-bottom: 1px solid var(--workspace-line);
+}
+
+.openpress-workspace-gallery__headline {
+  display: grid;
+  gap: 0.75rem;
+}
+
+.openpress-workspace-gallery__eyebrow {
+  margin: 0;
+  color: var(--workspace-muted);
+  font-family: var(--openpress-font-mono, ui-monospace, monospace);
+  font-size: 0.68rem;
+  font-weight: 600;
+  letter-spacing: 0.16em;
+  text-transform: uppercase;
+}
+
+.openpress-workspace-gallery__header h1 {
+  margin: 0;
+  font-family: var(--openpress-font-display, var(--openpress-font-body, system-ui));
+  font-size: clamp(2.6rem, 5.4vw, 5.2rem);
+  font-weight: 720;
+  line-height: 0.94;
+  letter-spacing: -0.035em;
+  color: var(--workspace-ink);
+}
+
+.openpress-workspace-gallery__count {
+  margin: 0;
+  display: grid;
+  justify-items: end;
+  gap: 0.25rem;
+  min-width: 4.5rem;
+  color: var(--workspace-ink);
+  font-family: var(--openpress-font-mono, ui-monospace, monospace);
+  line-height: 1;
+}
+
+.openpress-workspace-gallery__count span {
+  color: var(--workspace-ink);
+  font-size: 2rem;
+  font-weight: 500;
+  letter-spacing: -0.04em;
+}
+
+.openpress-workspace-gallery__count small {
+  color: var(--workspace-muted);
+  font-size: 0.62rem;
+  font-weight: 600;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.openpress-workspace-gallery__grid {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: grid;
+  align-items: start;
+  /* Uniform card size — Figma-style. Outer thumb is fixed 4:3, the
+     inner page letterboxes to its own geometry. */
+  grid-template-columns: repeat(auto-fill, minmax(20rem, 1fr));
+  gap: 1.5rem;
+}
+
+.openpress-workspace-gallery__item {
+  display: flex;
+}
+
+.openpress-workspace-gallery__card {
+  appearance: none;
+  display: grid;
+  grid-template-rows: auto minmax(6.75rem, auto);
+  align-self: start;
+  width: 100%;
+  padding: 0;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 8px;
+  background: var(--workspace-card);
+  color: var(--workspace-card-ink);
+  text-align: left;
+  cursor: pointer;
+  overflow: hidden;
+  transition:
+    transform 160ms ease,
+    box-shadow 160ms ease,
+    border-color 160ms ease;
+}
+
+.openpress-workspace-gallery__card:hover,
+.openpress-workspace-gallery__card:focus-visible {
+  border-color: rgba(255, 255, 255, 0.28);
+  transform: translateY(-2px);
+  box-shadow: 0 18px 44px rgba(0, 0, 0, 0.34);
+  outline: none;
+}
+
+.openpress-workspace-gallery__thumb {
+  position: relative;
+  display: block;
+  width: 100%;
+  /* Uniform 4:3 outer slot across every card. The page itself
+     letterboxes inside via centered scale, so each Press shows at its
+     own true aspect against the gradient background. */
+  aspect-ratio: 4 / 3;
+  background:
+    linear-gradient(
+      135deg,
+      color-mix(in srgb, var(--workspace-card-ink) 5%, var(--workspace-card-stage)),
+      var(--workspace-card-stage)
+    );
+  border-bottom: 1px solid var(--workspace-card-line);
+  overflow: hidden;
+}
+
+.openpress-workspace-gallery__thumb::before {
+  content: "";
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+  background-image:
+    linear-gradient(rgba(20, 20, 17, 0.05) 1px, transparent 1px),
+    linear-gradient(90deg, rgba(20, 20, 17, 0.05) 1px, transparent 1px);
+  background-size: 24px 24px;
+  opacity: 0.5;
+}
+
+.openpress-workspace-gallery__thumb-stage {
+  position: absolute;
+  inset: clamp(0.85rem, 6%, 1.45rem);
+  display: grid;
+  place-items: center;
+}
+
+.openpress-workspace-gallery__thumb-frame {
+  position: relative;
+  box-shadow:
+    0 18px 36px rgba(20, 20, 17, 0.18),
+    0 0 0 1px rgba(20, 20, 17, 0.08);
+}
+
+.openpress-workspace-gallery__thumb-stage .openpress-public-page {
+  display: block;
+  pointer-events: none;
+  user-select: none;
+}
+
+.openpress-workspace-gallery__thumb-placeholder {
+  position: absolute;
+  inset: clamp(0.85rem, 6%, 1.45rem);
+  display: grid;
+  place-items: center;
+}
+
+.openpress-workspace-gallery__thumb-skel {
+  display: block;
+  width: 70%;
+  height: 70%;
+  background:
+    repeating-linear-gradient(
+      135deg,
+      rgba(20, 20, 17, 0.04) 0 6px,
+      transparent 6px 14px
+    ),
+    #fff;
+  border: 1px solid var(--workspace-card-line);
+  border-radius: 3px;
+  box-shadow: 0 14px 28px rgba(20, 20, 17, 0.14);
+}
+
+.openpress-workspace-gallery__thumb-placeholder[data-state="loading"] .openpress-workspace-gallery__thumb-skel {
+  animation: openpress-gallery-skel-pulse 1.4s ease-in-out infinite;
+}
+
+@keyframes openpress-gallery-skel-pulse {
+  0%, 100% { opacity: 1; }
+  50%      { opacity: 0.55; }
+}
+
+.openpress-workspace-gallery__body {
+  display: grid;
+  align-content: space-between;
+  gap: 1.2rem;
+  min-height: 6.75rem;
+  padding: 1.1rem 1.22rem 1.15rem;
+  background: var(--workspace-card);
+}
+
+.openpress-workspace-gallery__title {
+  display: block;
+  color: var(--workspace-card-ink);
+  font-size: 1rem;
+  font-weight: 700;
+  line-height: 1.2;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.openpress-workspace-gallery__meta {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.7rem;
+  flex-wrap: wrap;
+  color: var(--workspace-card-muted);
+  font-family: var(--openpress-font-mono, ui-monospace, monospace);
+  font-size: 0.66rem;
+  letter-spacing: 0.03em;
+}
+
+.openpress-workspace-gallery__slug {
+  max-width: 13rem;
+  color: color-mix(in srgb, var(--workspace-card-ink) 72%, transparent);
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  text-transform: uppercase;
+  white-space: nowrap;
+}
+
+.openpress-workspace-gallery__dot {
+  color: color-mix(in srgb, var(--workspace-card-muted) 55%, transparent);
+}
+
+.openpress-workspace-gallery__pages,
+.openpress-workspace-gallery__geom {
+  color: var(--workspace-card-muted);
+}
+
+.openpress-workspace-gallery__geom {
+  display: inline-flex;
+  align-items: center;
+  min-height: 1.35rem;
+  padding: 0 0.48rem;
+  border: 1px solid var(--workspace-card-line);
+  border-radius: 4px;
+  background: rgba(255, 255, 255, 0.36);
+  color: color-mix(in srgb, var(--workspace-card-ink) 76%, transparent);
+  font-size: 0.62rem;
+  white-space: nowrap;
+}
+
+@media (max-width: 720px) {
+  .openpress-workspace-gallery {
+    padding: 2.25rem 1rem 4rem;
+  }
+
+  .openpress-workspace-gallery__header {
+    display: grid;
+    align-items: start;
+  }
+
+  .openpress-workspace-gallery__grid {
+    grid-template-columns: 1fr;
+  }
+}

package/template/core/src/styles/openpress.css

@@ -4,6 +4,7 @@
 @import url("/openpress/components.css");
 
 @import "./openpress/app-shell.css";
+@import "./openpress/workspace-gallery.css";
 @import "./openpress/workbench.css";
 @import "./openpress/workbench-panels.css";
 @import "./openpress/project-preview-panel.css";

package/template/core/tsconfig.json

@@ -11,7 +11,7 @@
     "forceConsistentCasingInFileNames": true,
     "module": "ESNext",
     "moduleResolution": "Bundler",
-    "types": ["node", "vite/client"],
+    "types": ["node"],
     "resolveJsonModule": true,
     "isolatedModules": true,
     "noEmit": true,

package/template/core/engine/commands/init.mjs

@@ -1,24 +0,0 @@
-import { initWorkspace, listStylePackSkills } from "../init.mjs";
-import { formatDisplayPath, parseInitOptions } from "./_shared.mjs";
-
-export const needsWorkspace = false;
-
-export async function run({ argv }) {
-  const options = parseInitOptions(argv);
-  if (!options.target) {
-    console.error("openpress init: target path is required");
-    console.error("Usage: openpress init <target> [--skill <name>] [--force]");
-    const available = await listStylePackSkills();
-    if (available.length) console.error(`Style packs available: ${available.join(", ")}`);
-    return 1;
-  }
-  const result = await initWorkspace(options);
-  const displayPath = formatDisplayPath(result.targetPath);
-  console.log(`OpenPress init: created ${displayPath} from style pack "${result.skill}".`);
-  console.log("Next steps:");
-  console.log(`  cd ${displayPath}`);
-  console.log("  # 填入 openpress.config.mjs 的 title / subtitle / organization");
-  console.log("  # 改 document/index.tsx 與 document/chapters/**/*.mdx 為實際內容");
-  console.log("  node engine/cli.mjs validate");
-  return 0;
-}

package/template/core/engine/init.mjs

@@ -1,90 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const SELF_DIR = path.dirname(fileURLToPath(import.meta.url));
-const ENGINE_ROOT = path.resolve(SELF_DIR, "..");
-const SKILLS_DIR = path.join(ENGINE_ROOT, "skills");
-
-const DEFAULT_SKILL = "editorial-monograph";
-
-export async function initWorkspace({ target, skill = DEFAULT_SKILL, force = false }) {
-  if (!target) throw new Error("openpress init: target path is required");
-  const targetPath = path.resolve(target);
-
-  const starterPath = path.join(SKILLS_DIR, skill, "starter");
-  try {
-    const stat = await fs.stat(starterPath);
-    if (!stat.isDirectory()) {
-      throw new Error(`openpress init: skill "${skill}" has no starter/ directory at ${starterPath}`);
-    }
-  } catch (error) {
-    if (error?.code === "ENOENT") {
-      const available = await listStylePackSkills();
-      throw new Error(
-        `openpress init: skill "${skill}" not found or has no starter. ` +
-        `Available style packs: ${available.join(", ") || "(none)"}`,
-      );
-    }
-    throw error;
-  }
-
-  if (!force) {
-    try {
-      const stat = await fs.stat(targetPath);
-      if (stat.isDirectory()) {
-        const entries = await fs.readdir(targetPath);
-        if (entries.length > 0) {
-          throw new Error(`openpress init: target ${targetPath} exists and is not empty. Pass --force to overwrite.`);
-        }
-      } else {
-        throw new Error(`openpress init: target ${targetPath} exists and is not a directory.`);
-      }
-    } catch (error) {
-      if (error?.code !== "ENOENT") throw error;
-    }
-  }
-
-  await fs.mkdir(targetPath, { recursive: true });
-  await copyDirectory(starterPath, targetPath);
-
-  return { targetPath, skill };
-}
-
-export async function listStylePackSkills() {
-  try {
-    const entries = await fs.readdir(SKILLS_DIR, { withFileTypes: true });
-    const names = [];
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const starter = path.join(SKILLS_DIR, entry.name, "starter");
-      try {
-        const stat = await fs.stat(starter);
-        if (stat.isDirectory()) names.push(entry.name);
-      } catch {
-        // skill without starter/ is not a style pack — skip
-      }
-    }
-    return names.sort();
-  } catch (error) {
-    if (error?.code === "ENOENT") return [];
-    throw error;
-  }
-}
-
-async function copyDirectory(source, destination) {
-  await fs.mkdir(destination, { recursive: true });
-  for (const entry of await fs.readdir(source, { withFileTypes: true })) {
-    if (entry.name === ".DS_Store") continue;
-    const sourcePath = path.join(source, entry.name);
-    const destPath = path.join(destination, entry.name);
-    if (entry.isDirectory()) {
-      await copyDirectory(sourcePath, destPath);
-    } else if (entry.isFile()) {
-      await fs.copyFile(sourcePath, destPath);
-    } else if (entry.isSymbolicLink()) {
-      const link = await fs.readlink(sourcePath);
-      await fs.symlink(link, destPath);
-    }
-  }
-}

package/template/packs/academic-paper/document/chapters/01-introduction/content/01-introduction.mdx

@@ -1,35 +0,0 @@
-## Introduction
-
-The purpose of this paper template is to provide a compact, readable structure for a
-machine-learning research manuscript written in a formal journal style.
-
-### Background and Motivation
-
-Recent studies have shown that modern experiments produce larger datasets and richer
-artifact pipelines, but the writing process is often bottlenecked by repeated formatting
-adjustments. A lightweight drafting layer can decouple scientific reasoning from
-typesetting concerns and let the author focus on experimental validity first.
-
-### Problem Statement
-
-The key challenge addressed in this draft is to keep the manuscript internally
-consistent while moving from scratch notes to a submission-ready narrative. The
-workflow should preserve section hierarchy, citation order, and figure/table integrity
-without requiring manual renumbering.
-
-### Contribution
-
-This demo paper includes the following contributions:
-
-- A reproducible chapter flow (`Introduction → Methods → Results and Discussion →
-  Conclusion`),
-- Consistent heading levels for major and minor sections,
-- Placeholder media and tables that can be swapped with real results,
-- A reference block and placeholder metadata for a clean handoff to final publication
-  tooling.
-
-### Paper Organization
-
-The paper is organized as follows: Section 2 details the methodology,
-Section 3 reports results and discusses representative scenarios,
-Section 4 summarizes conclusions and practical recommendations.

package/template/packs/academic-paper/document/chapters/02-methods/content/01-methods.mdx

@@ -1,50 +0,0 @@
-## Methods
-
-This section describes a hypothetical experimental design suitable for an applied
-machine-learning paper.
-
-### Data and Problem Setup
-
-We assume a synthetic dataset with 3,200 anonymized samples collected under three
-operational conditions. Each sample includes paired feature vectors, timestamped
-metadata, and a binary outcome label. The baseline split is 70/15/15 for training,
-validation, and held-out test sets.
-
-### Core Pipeline
-
-The pipeline has three stages:
-
-1. **Preprocessing**: normalization, missing-value handling, and feature screening.
-2. **Modeling**: training a compact baseline model and a comparison ablation set.
-3. **Evaluation**: calibration-aware scoring and bootstrapped confidence intervals.
-
-For this draft, preprocessing includes clipping extreme values and aligning all
-continuous fields to SI-style unit notation.
-
-### Equations
-
-The main objective is written as:
-
-$$
-\mathcal{L}(\theta) = \sum_{i=1}^{N}\left(\hat{y}_{i}(\theta)-y_{i}\right)^2
-$$
-
-where $\theta$ are trainable parameters and the objective is minimized on the
-training subset.
-
-### Evaluation Protocol
-
-Model quality is measured by macro-averaged F1, AUROC, and an uncertainty-aware
-calibration score. Reproducibility is ensured by fixing the random seed and logging
-all preprocessing parameters.
-
-### Implementation Notes
-
-- All runs were executed on a dual-socket compute node with two GPUs.
-- Checkpoints were stored every 5 epochs.
-- Logging followed a single JSON schema shared across all experiments.
-
-### Validation and Quality Control
-
-Validation is automated through a script that checks missing captions, file path
-consistency, and reference formatting before final export.

package/template/packs/academic-paper/document/chapters/03-results-and-discussion/content/01-results.mdx

@@ -1,47 +0,0 @@
-## Results and Discussion
-
-### Benchmark Results
-
-The synthetic experiment yields a consistent improvement trend across three datasets.
-Performance gains are modest but stable after hyperparameter tuning.
-
-| Metric | Baseline | Proposed | Improvement |
-| --- | --- | --- | --- |
-| Macro-F1 | 0.61 | 0.67 | +9.8% |
-| AUROC | 0.74 | 0.81 | +9.5% |
-| Calibration Error | 0.082 | 0.043 | -47.6% |
-
-The proposed model retains a similar variance profile while improving score
-stability in low-sample conditions.
-
-### Representative Visualization
-
-<img
-  src="media/figure-placeholder.svg"
-  alt="Example of a figure placeholder"
-  style={{ maxWidth: "420px", width: "100%", height: "auto" }}
-/>
-
-Figure 1. Example of a result trend visualization (placeholder image).
-
-### Error Analysis
-
-Some error cases cluster around edge classes with incomplete metadata. These cases
-benefit from better augmentation and a revised class-balanced loss.
-
-### Sensitivity Study
-
-- Training set size below 40% causes a steeper drop in recall.
-- Early stopping thresholds above 3 epochs reduce overfitting in our setting.
-- Calibrated post-processing improves confidence robustness.
-
-### Discussion
-
-The most practical takeaway is that small engineering changes in preprocessing and
-evaluation discipline can produce measurable gains even when architecture changes are
-minimal.
-
-### Limitations
-
-This section reports synthetic results only; real-world deployment would require
-cross-domain validation, privacy checks, and a stronger external benchmark suite.

package/template/packs/academic-paper/document/chapters/04-acknowledgment/content/01-acknowledgment.mdx

@@ -1,26 +0,0 @@
-## Conclusions
-
-This template run shows that a simple methodology with consistent evaluation
-accounting can achieve reliable gains without dramatic architectural complexity.
-
-### Key Takeaways
-
-- Keep preprocessing and metric reporting deterministic.
-- Use a calibrated validation protocol before reporting final headline scores.
-- Reserve model complexity for problems that cannot be solved with better data
-  discipline.
-
-### Practical Recommendations
-
-Authors are encouraged to replace each placeholder paragraph with real study details,
-including hardware, code provenance, and full reproducibility statements.
-
-### Limitations and Future Work
-
-The current draft is synthetic; external generalization remains to be demonstrated.
-Future work should add domain transfer tests and a public benchmark release.
-
-### Acknowledgments
-
-We thank the hypothetical reviewers and platform contributors who would have reviewed
-this draft in a real submission round.

package/template/packs/academic-paper/document/chapters/05-references/content/01-references.mdx

@@ -1,32 +0,0 @@
-## References
-
-Please number references consecutively within brackets `[1]`.
-Sentence punctuation follows the bracketed number.
-
----
-
-[1] G. Eason, B. Noble, and I. N. Sneddon, “On certain integrals of
-Lipschitz-Hankel type involving products of Bessel functions,” *Phil. Trans. Roy.
-Soc. London*, vol. A247, pp. 529–551, April 1955.
-
-[2] J. Clerk Maxwell, *A Treatise on Electricity and Magnetism*, 3rd ed., vol. 2.
-Oxford: Clarendon, 1892, pp. 68–73.
-
-[3] I. S. Jacobs and C. P. Bean, “Fine particles, thin films and exchange anisotropy,”
-in *Magnetism*, vol. III, G. T. Rado and H. Suhl, Eds. New York: Academic,
-1963, pp. 271–350.
-
-[4] K. Elissa, “Title of paper if known,” unpublished.
-
-[5] R. Nicole, “Title of paper with only first word capitalized,” *J. Name Stand.
-Abbrev.*, in press.
-
-[6] Y. Yorozu, M. Hirano, K. Oka, and Y. Tagawa, “Electron spectroscopy studies
-on magneto-optical media and plastic substrate interface,” *IEEE Trans. J. Magn.
-Japan*, vol. 2, pp. 740–741, August 1987.
-
-[7] M. Young, *The Technical Writer's Handbook*. Mill Valley, CA: University
-Science, 1989.
-
-> Open-press is used for iteration. Remove all template placeholder text and replace
-> references before submission.