@open-press/cli 0.7.1 → 1.0.0

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

@@ -1,4 +0,0 @@
-import type { IndexedHtmlPage } from "./indexes";
-import type { HtmlPageBlock } from "./types";
-
-export type DisplayPage = IndexedHtmlPage & Pick<HtmlPageBlock, "source">;

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.

package/template/packs/academic-paper/document/components/ChapterOpenerVisual/index.tsx

@@ -1,76 +0,0 @@
-const TONES = new Set(["sage", "lavender", "mint", "amber"]);
-
-const VISUALS = {
-  "linked-list": `<svg viewBox="0 0 520 330" focusable="false" aria-hidden="true">
-      <rect class="chapter-opener-illustration__paper" x="42" y="96" width="116" height="82" rx="4" />
-      <rect class="chapter-opener-illustration__paper" x="204" y="96" width="116" height="82" rx="4" />
-      <rect class="chapter-opener-illustration__paper" x="366" y="96" width="116" height="82" rx="4" />
-      <path class="chapter-opener-illustration__stroke" d="M158 137 H204" />
-      <path class="chapter-opener-illustration__stroke" d="M320 137 H366" />
-      <path class="chapter-opener-illustration__arrow" d="M190 122 206 137 190 152" />
-      <path class="chapter-opener-illustration__arrow" d="M352 122 368 137 352 152" />
-      <path class="chapter-opener-illustration__thin" d="M72 128 H118 M72 150 H128 M234 128 H280 M234 150 H286 M396 128 H442 M396 150 H452" />
-      <circle class="chapter-opener-illustration__node" cx="144" cy="137" r="13" />
-      <circle class="chapter-opener-illustration__node" cx="306" cy="137" r="13" />
-      <circle class="chapter-opener-illustration__node" cx="468" cy="137" r="13" />
-      <path class="chapter-opener-illustration__stroke" d="M262 178 C262 222 220 244 158 244 C98 244 68 222 68 190" />
-      <path class="chapter-opener-illustration__arrow" d="M52 204 68 188 84 204" />
-    </svg>`,
-  tree: `<svg viewBox="0 0 520 330" focusable="false" aria-hidden="true">
-      <path class="chapter-opener-illustration__paper" d="M232 40 316 40 352 86 330 132 218 132 194 86Z" />
-      <path class="chapter-opener-illustration__paper" d="M88 198 170 178 228 218 204 288 100 288 58 240Z" />
-      <path class="chapter-opener-illustration__paper" d="M314 198 400 176 466 224 450 292 328 292 282 238Z" />
-      <path class="chapter-opener-illustration__stroke" d="M262 118 160 214 M270 118 374 214" />
-      <path class="chapter-opener-illustration__stroke" d="M160 214 122 258 M160 214 204 258 M374 214 330 258 M374 214 420 258" />
-      <circle class="chapter-opener-illustration__node" cx="266" cy="100" r="24" />
-      <circle class="chapter-opener-illustration__node" cx="160" cy="214" r="22" />
-      <circle class="chapter-opener-illustration__node" cx="374" cy="214" r="22" />
-      <circle class="chapter-opener-illustration__dot" cx="122" cy="258" r="13" />
-      <circle class="chapter-opener-illustration__dot" cx="204" cy="258" r="13" />
-      <circle class="chapter-opener-illustration__dot" cx="330" cy="258" r="13" />
-      <circle class="chapter-opener-illustration__dot" cx="420" cy="258" r="13" />
-    </svg>`,
-  code: `<svg viewBox="0 0 520 330" focusable="false" aria-hidden="true">
-      <path class="chapter-opener-illustration__paper" d="M92 52 338 52 386 104 386 286 92 286Z" />
-      <path class="chapter-opener-illustration__paper" d="M348 82 438 82 476 122 452 226 356 226 326 154Z" />
-      <path class="chapter-opener-illustration__thin" d="M132 112 H250 M132 146 H292 M132 180 H238 M132 214 H276" />
-      <path class="chapter-opener-illustration__stroke" d="M308 114 C340 122 356 148 356 180 C356 220 332 244 292 250" />
-      <path class="chapter-opener-illustration__arrow" d="M304 226 288 250 316 260" />
-      <path class="chapter-opener-illustration__stroke" d="M406 124 V202" />
-      <circle class="chapter-opener-illustration__node" cx="406" cy="124" r="17" />
-      <circle class="chapter-opener-illustration__node" cx="406" cy="202" r="17" />
-    </svg>`,
-  answers: `<svg viewBox="0 0 520 330" focusable="false" aria-hidden="true">
-      <path class="chapter-opener-illustration__paper" d="M128 44 396 44 440 90 418 292 104 292 82 86Z" />
-      <path class="chapter-opener-illustration__thin" d="M178 116 H350 M178 168 H350 M178 220 H322" />
-      <path class="chapter-opener-illustration__stroke" d="M128 112 148 134 190 88" />
-      <path class="chapter-opener-illustration__stroke" d="M128 164 148 186 190 140" />
-      <path class="chapter-opener-illustration__stroke" d="M128 216 148 238 190 192" />
-      <circle class="chapter-opener-illustration__node" cx="386" cy="92" r="18" />
-      <path class="chapter-opener-illustration__stroke" d="M386 92 C420 126 424 172 394 208" />
-      <path class="chapter-opener-illustration__arrow" d="M380 186 394 210 420 200" />
-    </svg>`,
-};
-
-export type ChapterOpenerVisualVariant = keyof typeof VISUALS;
-
-export interface ChapterOpenerVisualProps {
-  variant?: ChapterOpenerVisualVariant;
-  tone?: string;
-}
-
-export default function ChapterOpenerVisual({
-  variant = "linked-list",
-  tone = "sage",
-}: ChapterOpenerVisualProps) {
-  const visual = VISUALS[variant] ?? VISUALS["linked-list"];
-  const safeTone = TONES.has(tone) ? tone : "sage";
-
-  return (
-    <figure
-      className={`chapter-opener-illustration chapter-opener-illustration--${variant} chapter-opener-tone--${safeTone}`}
-      aria-hidden="true"
-      dangerouslySetInnerHTML={{ __html: visual }}
-    />
-  );
-}

package/template/packs/academic-paper/document/components/Page.tsx

@@ -1,60 +0,0 @@
-import { Frame, MdxArea } from "@open-press/core";
-import type { SectionsPageProps } from "@open-press/core/manuscript";
-import { useEffect, useRef } from "react";
-
-export default function Page({
-  frameKey,
-  chainId,
-  pageIndex,
-  totalPages,
-  sectionSlug,
-  sectionTitle,
-  sectionTone,
-}: SectionsPageProps) {
-  const pageBodyRef = useRef<HTMLElement | null>(null);
-
-  const runningHeader =
-    "This is a non-peer reviewed Express letter submitted to J SEDI";
-  const runningRight = "Your short title goes here";
-
-  useEffect(() => {
-    const area = pageBodyRef.current?.querySelector(".openpress-mdx-area");
-    if (!area) return;
-
-    area.querySelectorAll<HTMLElement>("h2[data-chapter]").forEach((heading) => {
-      const chapterValue = heading.getAttribute("data-chapter");
-      if (!chapterValue) return;
-      if (!/^\d+$/.test(chapterValue)) return;
-      const normalized = String(Number.parseInt(chapterValue, 10));
-      heading.setAttribute("data-chapter", normalized);
-    });
-  }, [chainId]);
-
-  return (
-    <Frame
-      frameKey={frameKey}
-      role="manuscript.content"
-      className="reader-page--content"
-      data-page-index={pageIndex}
-      data-total-pages={totalPages}
-      data-section-id={sectionSlug}
-      data-chapter-tone={sectionTone}
-    >
-      <div className="page-frame">
-        <header className="page-header" aria-hidden="true">
-          <span className="running-head-left">{runningHeader}</span>
-          <span className="running-head-right">{runningRight}</span>
-        </header>
-        <main className="page-body" ref={pageBodyRef}>
-          <MdxArea chainId={chainId} overflow="extend" />
-        </main>
-        <footer className="page-footer" aria-hidden="true">
-          <span className="footer-left">{sectionTitle}</span>
-          <span className="footer-right">
-            {totalPages > 1 ? `${pageIndex + 1}/${totalPages}` : pageIndex + 1}
-          </span>
-        </footer>
-      </div>
-    </Frame>
-  );
-}

package/template/packs/academic-paper/document/components/TokenSwatchGrid/index.tsx

@@ -1,46 +0,0 @@
-import type { CSSProperties } from "react";
-
-export interface TokenSwatch {
-  name: string;
-  hex: string;
-  summary: string;
-  swatchVar: string;
-  swatchBorderVar?: string;
-  dark?: boolean;
-}
-
-export interface TokenSwatchGridProps {
-  ariaLabel?: string;
-  swatches: TokenSwatch[];
-}
-
-export default function TokenSwatchGrid({
-  ariaLabel = "Color specimen",
-  swatches,
-}: TokenSwatchGridProps) {
-  return (
-    <section className="token-swatch-grid" data-openpress-component="TokenSwatchGrid" aria-label={ariaLabel}>
-      {swatches.map((swatch) => (
-        <article
-          key={swatch.name}
-          className={swatch.dark ? "token-swatch token-swatch--dark" : "token-swatch"}
-          style={swatchStyle(swatch)}
-        >
-          <div className="token-swatch__sample" />
-          <div className="token-swatch__body">
-            <h4>{swatch.name}</h4>
-            <code>{swatch.hex}</code>
-            <p>{swatch.summary}</p>
-          </div>
-        </article>
-      ))}
-    </section>
-  );
-}
-
-function swatchStyle(swatch: TokenSwatch): CSSProperties {
-  return {
-    "--swatch": swatch.swatchVar,
-    ...(swatch.swatchBorderVar ? { "--swatch-border": swatch.swatchBorderVar } : {}),
-  } as CSSProperties;
-}

package/template/packs/academic-paper/document/components/TokenSwatchGrid/style.css

@@ -1,63 +0,0 @@
-/* token-swatch-grid
- * Color specimen grid referenced by design.md to display each color token with
- * its sample, hex, and usage note.
- */
-
-.token-swatch-grid {
-  display: grid;
-  grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 3mm;
-  margin: var(--openpress-space-3) 0 var(--openpress-space-4);
-  break-inside: avoid;
-}
-
-.token-swatch {
-  min-height: 42mm;
-  overflow: hidden;
-  border: 1px solid var(--openpress-color-line);
-  border-radius: 6px;
-  background: var(--openpress-color-document);
-  box-sizing: border-box;
-  break-inside: avoid;
-}
-
-.token-swatch__sample {
-  height: 17mm;
-  background: var(--swatch);
-  border-bottom: 1px solid var(--swatch-border, var(--openpress-color-line));
-}
-
-.token-swatch__body {
-  padding: 3mm;
-}
-
-.token-swatch h4 {
-  margin: 0;
-  color: var(--openpress-color-ink);
-  font-family: var(--openpress-font-body);
-  font-size: 9pt;
-  font-weight: 600;
-  line-height: 1.25;
-  letter-spacing: 0;
-}
-
-.token-swatch code {
-  display: block;
-  margin-top: 1mm;
-  color: var(--openpress-color-muted);
-  font-size: 8pt;
-  line-height: 1.35;
-}
-
-.token-swatch p {
-  margin: 2mm 0 0;
-  color: #333333;
-  font-size: 8.4pt;
-  line-height: 1.45;
-}
-
-@media (max-width: 899px) {
-  .token-swatch-grid {
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-  }
-}

package/template/packs/academic-paper/document/components/TypeSpecimen/index.tsx

@@ -1,38 +0,0 @@
-export type TypeSpecimenVariant =
-  | "metric"
-  | "cover-title"
-  | "chapter-title"
-  | "section-title"
-  | "body"
-  | "caption";
-
-export interface TypeSpecimenRow {
-  name: string;
-  spec: string;
-  sample: string;
-  sampleVariant: TypeSpecimenVariant;
-}
-
-export interface TypeSpecimenProps {
-  ariaLabel?: string;
-  rows: TypeSpecimenRow[];
-}
-
-export default function TypeSpecimen({
-  ariaLabel = "Typography specimen",
-  rows,
-}: TypeSpecimenProps) {
-  return (
-    <section className="type-specimen" data-openpress-component="TypeSpecimen" aria-label={ariaLabel}>
-      {rows.map((row) => (
-        <div className="type-specimen__row" key={row.name}>
-          <div className="type-specimen__meta">
-            <strong>{row.name}</strong>
-            <span>{row.spec}</span>
-          </div>
-          <p className={`type-specimen__sample type-specimen__sample--${row.sampleVariant}`}>{row.sample}</p>
-        </div>
-      ))}
-    </section>
-  );
-}

package/template/packs/academic-paper/document/components/TypeSpecimen/style.css

@@ -1,111 +0,0 @@
-/* type-specimen
- * Typography specimen block referenced by design.md to display each typography
- * token alongside a sample in document context.
- */
-
-.type-specimen {
-  margin: var(--openpress-space-3) 0 var(--openpress-space-4);
-  border-top: 1px solid var(--openpress-color-line);
-  break-inside: avoid;
-}
-
-.type-specimen__row {
-  display: grid;
-  grid-template-columns: minmax(30mm, 38mm) minmax(0, 1fr);
-  gap: var(--openpress-space-3);
-  align-items: center;
-  min-height: 20mm;
-  padding: 3mm 0;
-  border-bottom: 1px solid var(--openpress-color-line);
-}
-
-.type-specimen__meta strong {
-  display: block;
-  font-size: 8.8pt;
-  font-weight: 600;
-  line-height: 1.35;
-  letter-spacing: 0;
-  color: var(--openpress-color-ink);
-}
-
-.type-specimen__meta span {
-  display: block;
-  margin-top: 1mm;
-  color: var(--openpress-color-muted);
-  font-size: 8pt;
-  line-height: 1.45;
-  font-variant-numeric: tabular-nums;
-  letter-spacing: 0;
-}
-
-.type-specimen__sample {
-  margin: 0 !important;
-  color: var(--openpress-color-ink);
-  text-align: center;
-  overflow-wrap: anywhere;
-}
-
-.type-specimen__sample--metric {
-  font-family: var(--openpress-font-body);
-  font-size: 34pt;
-  font-weight: 700;
-  line-height: 1;
-  font-variant-numeric: tabular-nums;
-  letter-spacing: 0;
-}
-
-.type-specimen__sample--cover-title {
-  font-family: var(--openpress-font-serif);
-  font-size: 30pt;
-  font-weight: 300;
-  line-height: 1.05;
-  letter-spacing: 0.01em;
-}
-
-.type-specimen__sample--chapter-title {
-  font-family: var(--openpress-font-serif);
-  font-size: 17pt;
-  font-weight: 300;
-  line-height: 1.35;
-  letter-spacing: 0.04em;
-}
-
-.type-specimen__sample--section-title {
-  font-family: var(--openpress-font-serif);
-  font-size: 13pt;
-  font-weight: 400;
-  line-height: 1.45;
-  letter-spacing: 0.03em;
-}
-
-.type-specimen__sample--body {
-  max-width: 112mm;
-  margin-right: auto !important;
-  margin-left: auto !important;
-  font-family: var(--openpress-font-body);
-  font-size: 10pt;
-  font-weight: 400;
-  line-height: 1.75;
-  letter-spacing: 0;
-}
-
-.type-specimen__sample--caption {
-  font-family: var(--openpress-font-body);
-  font-size: 8pt;
-  font-weight: 400;
-  line-height: 1.5;
-  color: var(--openpress-color-muted);
-  letter-spacing: 0.02em;
-}
-
-@media (max-width: 899px) {
-  .type-specimen__row {
-    grid-template-columns: 1fr;
-    gap: 2mm;
-    align-items: start;
-  }
-
-  .type-specimen__sample {
-    text-align: left;
-  }
-}