@liustack/pagepress 0.6.1 → 0.8.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Leon
+Copyright (c) 2026 Leon Liu (liustack)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,123 +1,59 @@
 # PagePress
 
-A web content rendering toolkit (CLI) designed for **AI Agents**, converting local HTML and Markdown files into high-quality **PDF** or **PNG** images.
+A CLI toolkit for AI agents to render local Markdown and HTML files into high-quality PDF documents.
 
 中文说明请见：[README.zh-CN.md](README.zh-CN.md)
 
-## ✨ Features
+## Features
 
-- **Unified CLI**: One tool (`pagepress`) for both PDF and image generation
-- **AI Agent friendly**: Includes a detailed SKILL.md guide with scenario routing
-- **Local files only**: Accepts local HTML and Markdown files (remote URLs are not supported for security)
-- **Rich templates**:
-  - **PDF**: Apple style, GitHub style, magazine layout (Magazine)
-  - **Image**: 8 presets — OG cards, infographics, posters, banners, Twitter/X cards, YouTube thumbnails, Xiaohongshu covers, WeChat covers
-- **Brand-aware visuals**: OG / poster / banner outputs are generated based on workspace visual & brand assets (commonly in `assets/`, `public/`, `src/assets/`)
-- **Consistency guarantees**: Deterministic rendering, font waiting, network idle detection, syntax highlighting
+- PDF-only command surface (`pagepress`)
+- Local file input only (`.md` / `.html`)
+- Built-in Markdown templates: `default`, `github`, `magazine`
+- Built-in Mermaid rendering for Markdown code blocks
+- Deterministic output via Playwright + Chromium print engine
 
-## 📦 Installation
+## Installation
 
 ```bash
-# Global install
 npm install -g @liustack/pagepress
-
-# Install browsers (Playwright)
 npx playwright install chromium
 ```
 
-Or use `npx` directly:
+Or run with `npx`:
 
 ```bash
-npx @liustack/pagepress <command> [options]
+npx @liustack/pagepress [options]
 ```
 
-## 🚀 Usage
-
-### 1. Generate PDF
-
-Convert HTML/Markdown into PDF documents. Supports syntax highlighting.
+## Usage
 
 ```bash
-# Markdown to PDF (Apple style template)
-pagepress pdf -i document.md -o output.pdf --template default
-
-# Local HTML file to PDF
-pagepress pdf -i page.html -o output.pdf
+# Markdown to PDF
+pagepress -i document.md -o output.pdf --template default
 
+# Local HTML to PDF
+pagepress -i page.html -o output.pdf
 ```
 
-**Supported templates**:
-- `default` - Apple style, clean and elegant
-- `github` - GitHub style
-- `magazine` - VOGUE/WIRED magazine layout
-
-### 2. Generate Images
+## Templates
 
-Render local HTML into PNG images, suitable for social share cards, posters, and infographics.
-
-For OG cards, posters, and banners, the visuals should be generated based on workspace brand assets (logo, colors, fonts, imagery), commonly located in `assets/`, `public/`, or `src/assets/`.
-
-**Recommended brand assets layout**:
-
-```text
-assets/
-  brand/
-    logo.svg
-    palette.json
-    fonts/
-      YourBrand-Regular.woff2
-    imagery/
-      hero.jpg
-```
-
-```bash
-# Generate an OG card (1200x630)
-pagepress shot -i card.html -o og.png --preset og
-
-# Generate a long infographic
-pagepress shot -i stats.html -o infographic.png --preset infographic
-
-```
-
-**Supported presets**:
-- `og` (1200x630) - Social card
-- `infographic` (1080x1350) - Infographic
-- `poster` (1200x1500) - Poster
-- `banner` (1600x900) - Banner
-- `twitter` (1200x675) - Twitter/X card
-- `youtube` (1280x720) - YouTube thumbnail
-- `xiaohongshu` (1080x1440) - Xiaohongshu / RedNote cover
-- `wechat` (900x383) - WeChat Official Account cover
-
-## 🖼️ Examples
-
-### Image Presets
-
-| OG Card (1200×630) | Infographic (1080×1350) |
-|:---:|:---:|
-| ![OG Card](examples/shot-og.png) | ![Infographic](examples/shot-infographic.png) |
-
-| Poster (1200×1500) | Banner (1600×900) |
-|:---:|:---:|
-| ![Poster](examples/shot-poster.png) | ![Banner](examples/shot-banner.png) |
-
-| Twitter/X Card (1200×675) | YouTube Thumbnail (1280×720) |
-|:---:|:---:|
-| ![Twitter Card](examples/shot-twitter.png) | ![YouTube Thumbnail](examples/shot-youtube.png) |
-
-| Xiaohongshu Cover (1080×1440) | WeChat Cover (900×383) |
-|:---:|:---:|
-| ![Xiaohongshu Cover](examples/shot-xiaohongshu.png) | ![WeChat Cover](examples/shot-wechat.png) |
+- `default` - Clean minimalist style
+- `github` - GitHub style
+- `magazine` - magazine layout
 
-## 🤖 AI Agent Integration
+## Options
 
-This project includes two skill guides for AI Agents (such as Claude, ChatGPT):
+- `-i, --input <path>` input Markdown or HTML file path
+- `-o, --output <path>` output PDF file path
+- `-t, --template <name>` template for Markdown input (default: `default`)
+- `--wait-until <state>` `load | domcontentloaded | networkidle`
+- `--timeout <ms>` timeout in milliseconds
+- `--safe` disable external network requests and JavaScript execution
 
-- [web-to-pdf/SKILL.md](skills/web-to-pdf/SKILL.md) — PDF generation (Markdown beautification, templates, HTML printing)
-- [web-to-png/SKILL.md](skills/web-to-png/SKILL.md) — PNG generation (OG cards, infographics, posters, banners, social cards)
+## AI Agent Skill
 
-Agents can automatically choose the appropriate commands and parameters based on natural language instructions (for example, "generate a poster" or "convert this document to PDF").
+- [pagepress/SKILL.md](skills/pagepress/SKILL.md)
 
-## 📄 License
+## License
 
 MIT

package/README.zh-CN.md

@@ -1,121 +1,57 @@
 # PagePress
 
-一套专为 **AI Agent** 设计的 Web 内容渲染工具集（CLI），可将本地 HTML、Markdown 文件转换为高质量的 **PDF** 或 **PNG** 图像。
+面向 AI Agent 的 PDF 渲染 CLI，可将本地 Markdown 和 HTML 文件输出为高质量 PDF。
 
-## ✨ 特性
+## 特性
 
-- **统一 CLI**：一个工具 (`pagepress`) 搞定 PDF 和 Image 生成
-- **AI Agent 友好**：包含详细的 SKILL.md 指南，支持场景路由
-- **仅本地文件**：支持本地 HTML、Markdown 文件（出于安全考虑不支持远程 URL）
-- **丰富模板**：
-  - **PDF**: Apple 风格、GitHub 风格、杂志排版 (Magazine)
-  - **Image**: 8 种预设 — OG 卡片、信息图、海报、横幅、Twitter/X 卡片、YouTube 缩略图、小红书封面、微信公众号封面
-- **品牌一致性**：OG/海报/横幅会基于工作区的视觉与品牌资源生成（常见于 `assets/`、`public/`、`src/assets/`）
-- **一致性保障**：确定性渲染、字体等待、网络空闲检测、代码高亮
+- 专注 PDF 输出（仅 `pagepress`）
+- 仅支持本地文件输入（`.md` / `.html`）
+- 内置 Markdown 模板：`default`、`github`、`magazine`
+- 支持 Mermaid 代码块渲染
+- 基于 Playwright + Chromium 的稳定打印引擎
 
-## 📦 安装
+## 安装
 
 ```bash
-# 全局安装
 npm install -g @liustack/pagepress
-
-# 安装浏览器（Playwright）
 npx playwright install chromium
 ```
 
-或者直接使用 `npx`:
+或使用 `npx`：
 
 ```bash
-npx @liustack/pagepress <command> [options]
+npx @liustack/pagepress [options]
 ```
 
-## 🚀 使用指南
-
-### 1. 生成 PDF
-
-将 HTML/Markdown 转换为 PDF 文档。支持代码高亮。
+## 用法
 
 ```bash
-# Markdown 转 PDF（使用 Apple 风格模板）
-pagepress pdf -i document.md -o output.pdf --template default
-
-# 本地 HTML 文件转 PDF
-pagepress pdf -i page.html -o output.pdf
+# Markdown 转 PDF
+pagepress -i document.md -o output.pdf --template default
 
+# 本地 HTML 转 PDF
+pagepress -i page.html -o output.pdf
 ```
 
-**支持的模板**：
-- `default` - Apple 风格，简洁优雅
-- `github` - GitHub 风格
-- `magazine` - VOGUE/WIRED 杂志排版
-
-### 2. 生成图像
+## 模板
 
-将本地 HTML 渲染为 PNG 图像，适合社交分享卡片、海报、信息图。
-
-对于 OG 卡片、海报、横幅，视觉应基于工作区的品牌资源（logo、颜色、字体、素材）生成，常见目录包括 `assets/`、`public/`、`src/assets/`。
-
-**品牌资源目录建议**：
-
-```text
-assets/
-  brand/
-    logo.svg
-    palette.json
-    fonts/
-      YourBrand-Regular.woff2
-    imagery/
-      hero.jpg
-```
-
-```bash
-# 生成 OG 卡片（1200×630）
-pagepress shot -i card.html -o og.png --preset og
-
-# 生成信息长图
-pagepress shot -i stats.html -o infographic.png --preset infographic
-
-```
-
-**支持的预设**：
-- `og` (1200×630) - 社交卡片
-- `infographic` (1080×1350) - 信息图
-- `poster` (1200×1500) - 海报
-- `banner` (1600×900) - 横幅
-- `twitter` (1200×675) - Twitter/X 卡片
-- `youtube` (1280×720) - YouTube 缩略图
-- `xiaohongshu` (1080×1440) - 小红书封面
-- `wechat` (900×383) - 微信公众号封面
-
-## 🖼️ 示例
-
-### 图像预设
-
-| OG 卡片 (1200×630) | 信息图 (1080×1350) |
-|:---:|:---:|
-| ![OG 卡片](examples/shot-og.png) | ![信息图](examples/shot-infographic.png) |
-
-| 海报 (1200×1500) | 横幅 (1600×900) |
-|:---:|:---:|
-| ![海报](examples/shot-poster.png) | ![横幅](examples/shot-banner.png) |
-
-| Twitter/X 卡片 (1200×675) | YouTube 缩略图 (1280×720) |
-|:---:|:---:|
-| ![Twitter 卡片](examples/shot-twitter.png) | ![YouTube 缩略图](examples/shot-youtube.png) |
-
-| 小红书封面 (1080×1440) | 微信公众号封面 (900×383) |
-|:---:|:---:|
-| ![小红书封面](examples/shot-xiaohongshu.png) | ![微信公众号封面](examples/shot-wechat.png) |
+- `default` - 简洁风格
+- `github` - GitHub 风格
+- `magazine` - 杂志排版
 
-## 🤖 AI Agent 集成
+## 参数
 
-本项目包含两份 AI Agent 技能指南（适用于 Claude、ChatGPT 等）：
+- `-i, --input <path>` 输入 Markdown 或 HTML 路径
+- `-o, --output <path>` 输出 PDF 路径
+- `-t, --template <name>` Markdown 模板（默认 `default`）
+- `--wait-until <state>` `load | domcontentloaded | networkidle`
+- `--timeout <ms>` 超时时间（毫秒）
+- `--safe` 禁用外部网络请求和 JavaScript 执行
 
-- [web-to-pdf/SKILL.md](skills/web-to-pdf/SKILL.md) — PDF 生成（Markdown 美化、模板、HTML 打印）
-- [web-to-png/SKILL.md](skills/web-to-png/SKILL.md) — PNG 生成（OG 卡片、信息图、海报、横幅、社交卡片）
+## AI Agent Skill
 
-Agent 可以根据用户的自然语言指令（如"生成一张海报"、"把这个文档转成 PDF"）自动选择合适的命令和参数。
+- [pagepress/SKILL.md](skills/pagepress/SKILL.md)
 
-## 📄 License
+## License
 
 MIT

package/dist/main.js

@@ -11,7 +11,7 @@ import hljs from "highlight.js";
 const pdfTemplates = {
   default: {
     name: "default",
-    description: "Apple-inspired clean design",
+    description: "Clean minimalist design",
     file: "default.html"
   },
   github: {
@@ -73,15 +73,15 @@ function getFontCSS(template) {
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);
 const require$1 = createRequire(import.meta.url);
-const WAIT_UNTIL_STATES$1 = /* @__PURE__ */ new Set(["load", "domcontentloaded", "networkidle"]);
-function normalizeWaitUntil$1(value) {
+const WAIT_UNTIL_STATES = /* @__PURE__ */ new Set(["load", "domcontentloaded", "networkidle"]);
+function normalizeWaitUntil(value) {
   if (!value) return "networkidle";
-  if (WAIT_UNTIL_STATES$1.has(value)) {
+  if (WAIT_UNTIL_STATES.has(value)) {
     return value;
   }
   throw new Error(`Invalid waitUntil: ${value}. Allowed: load, domcontentloaded, networkidle.`);
 }
-function normalizeTimeout$1(value) {
+function normalizeTimeout(value) {
   if (value === void 0) return 3e4;
   if (!Number.isFinite(value) || value < 0) {
     throw new Error("Invalid timeout. Use a non-negative number of milliseconds.");
@@ -91,9 +91,9 @@ function normalizeTimeout$1(value) {
 function findTemplatesDir() {
   const candidates = [
     // When running from project root (dev/installed)
-    path.resolve(process.cwd(), "src/pdf/templates"),
+    path.resolve(process.cwd(), "src/templates"),
     // Relative to dist/main.js
-    path.resolve(__dirname$1, "..", "src", "pdf", "templates"),
+    path.resolve(__dirname$1, "..", "src", "templates"),
     // Relative to source file location
     path.resolve(__dirname$1, "templates")
   ];
@@ -102,11 +102,11 @@ function findTemplatesDir() {
   }
   throw new Error(`Templates directory not found. Searched: ${candidates.join(", ")}`);
 }
-async function render$1(options) {
+async function render(options) {
   const template = getTemplate(options.template ?? "default");
   const safeMode = options.safe ?? false;
-  const waitUntil = normalizeWaitUntil$1(options.waitUntil);
-  const timeout = normalizeTimeout$1(options.timeout);
+  const waitUntil = normalizeWaitUntil(options.waitUntil);
+  const timeout = normalizeTimeout(options.timeout);
   const templatesDir = findTemplatesDir();
   const templatePath = path.join(templatesDir, template.file);
   if (!fs.existsSync(templatePath)) {
@@ -316,191 +316,8 @@ async function render$1(options) {
     }
   }
 }
-const command$1 = new Command("pdf").description("Render Markdown or HTML to PDF").requiredOption("-i, --input <path>", "Input Markdown or HTML file path").requiredOption("-o, --output <path>", "Output PDF file path").option("-t, --template <name>", "PDF template (default, github, magazine)", "default").option("--wait-until <state>", "Navigation waitUntil (load, domcontentloaded, networkidle)", "networkidle").option("--timeout <ms>", "Navigation timeout in milliseconds", "30000").option("--safe", "Disable external network requests and JavaScript execution").action(async (options) => {
-  try {
-    const timeout = Number.parseInt(options.timeout, 10);
-    if (!Number.isFinite(timeout) || timeout < 0) {
-      throw new Error("Invalid --timeout value. Use a non-negative integer in milliseconds.");
-    }
-    const result = await render$1({
-      input: options.input,
-      output: options.output,
-      template: options.template,
-      waitUntil: options.waitUntil,
-      timeout,
-      safe: options.safe
-    });
-    console.log(JSON.stringify(result, null, 2));
-  } catch (error) {
-    console.error("Error:", error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-});
-const imagePresets = {
-  og: {
-    name: "og",
-    width: 1200,
-    height: 630,
-    description: "Open Graph / Social Card (1200×630)"
-  },
-  infographic: {
-    name: "infographic",
-    width: 1080,
-    height: 1350,
-    description: "Infographic (1080×1350)"
-  },
-  poster: {
-    name: "poster",
-    width: 1200,
-    height: 1500,
-    description: "Poster (1200×1500)"
-  },
-  banner: {
-    name: "banner",
-    width: 1600,
-    height: 900,
-    description: "Banner (1600×900)"
-  },
-  twitter: {
-    name: "twitter",
-    width: 1200,
-    height: 675,
-    description: "Twitter Card (1200×675)"
-  },
-  youtube: {
-    name: "youtube",
-    width: 1280,
-    height: 720,
-    description: "YouTube Thumbnail (1280×720)"
-  },
-  xiaohongshu: {
-    name: "xiaohongshu",
-    width: 1080,
-    height: 1440,
-    description: "Xiaohongshu / RedNote Cover (1080×1440)"
-  },
-  wechat: {
-    name: "wechat",
-    width: 900,
-    height: 383,
-    description: "WeChat Official Account Cover (900×383)"
-  }
-};
-function getPreset(name) {
-  const preset = imagePresets[name];
-  if (!preset) {
-    throw new Error(`Unknown image preset: ${name}. Available: ${Object.keys(imagePresets).join(", ")}`);
-  }
-  return preset;
-}
-const WAIT_UNTIL_STATES = /* @__PURE__ */ new Set(["load", "domcontentloaded", "networkidle"]);
-const MIN_DIMENSION = 100;
-const MAX_DIMENSION = 5e3;
-const MIN_SCALE = 1;
-const MAX_SCALE = 4;
-function normalizeWaitUntil(value) {
-  if (!value) return "networkidle";
-  if (WAIT_UNTIL_STATES.has(value)) {
-    return value;
-  }
-  throw new Error(`Invalid waitUntil: ${value}. Allowed: load, domcontentloaded, networkidle.`);
-}
-function normalizeTimeout(value) {
-  if (value === void 0) return 3e4;
-  if (!Number.isFinite(value) || value < 0) {
-    throw new Error("Invalid timeout. Use a non-negative number of milliseconds.");
-  }
-  return value;
-}
-function validateRange(name, value, min, max) {
-  if (!Number.isFinite(value)) {
-    throw new Error(`${name} must be a finite number.`);
-  }
-  if (value < min || value > max) {
-    throw new Error(`${name} must be between ${min} and ${max}. Received: ${value}.`);
-  }
-}
-async function render(options) {
-  const preset = options.preset ? getPreset(options.preset) : getPreset("og");
-  const width = options.width ?? preset.width;
-  const height = options.height ?? preset.height;
-  const scale = options.scale ?? 2;
-  const safeMode = options.safe ?? false;
-  const waitUntil = normalizeWaitUntil(options.waitUntil);
-  const timeout = normalizeTimeout(options.timeout);
-  validateRange("Width", width, MIN_DIMENSION, MAX_DIMENSION);
-  validateRange("Height", height, MIN_DIMENSION, MAX_DIMENSION);
-  validateRange("Scale", scale, MIN_SCALE, MAX_SCALE);
-  let browser = null;
-  try {
-    browser = await chromium.launch({ headless: true });
-    const context = await browser.newContext({
-      viewport: { width, height },
-      deviceScaleFactor: scale,
-      javaScriptEnabled: !safeMode
-    });
-    if (safeMode) {
-      await context.route("**/*", (route) => {
-        const url = route.request().url();
-        if (url.startsWith("http://") || url.startsWith("https://")) {
-          return route.abort();
-        }
-        return route.continue();
-      });
-    }
-    const page = await context.newPage();
-    const inputPath = path.resolve(options.input);
-    if (options.input.startsWith("http://") || options.input.startsWith("https://")) {
-      throw new Error("Remote URL inputs are not supported. Please provide a local HTML file path.");
-    } else if (fs.existsSync(inputPath)) {
-      const content = fs.readFileSync(inputPath, "utf-8");
-      await page.setContent(content, { waitUntil, timeout });
-    } else {
-      throw new Error(`Input not found: ${options.input}`);
-    }
-    await page.addStyleTag({
-      content: `
-                html, body {
-                    width: ${width}px;
-                    height: ${height}px;
-                    margin: 0;
-                    padding: 0;
-                    overflow: hidden;
-                }
-            `
-    });
-    await page.waitForTimeout(500);
-    const cardContainer = await page.$("#container");
-    if (!cardContainer) {
-      throw new Error("Missing #container element. PNG output requires a #container.");
-    }
-    const box = await cardContainer.boundingBox();
-    if (!box || box.width <= 0 || box.height <= 0) {
-      throw new Error("Invalid #container size. Ensure it has a positive width and height.");
-    }
-    const outputPath = path.resolve(options.output);
-    await page.screenshot({
-      path: outputPath,
-      type: "png",
-      clip: { x: box.x, y: box.y, width: box.width, height: box.height }
-    });
-    return {
-      pngPath: outputPath,
-      meta: {
-        preset: preset.name,
-        width,
-        height,
-        deviceScaleFactor: scale,
-        generatedAt: (/* @__PURE__ */ new Date()).toISOString()
-      }
-    };
-  } finally {
-    if (browser) {
-      await browser.close();
-    }
-  }
-}
-const command = new Command("shot").description("Capture HTML to PNG image").requiredOption("-i, --input <path>", "Input HTML file path").requiredOption("-o, --output <path>", "Output PNG file path").option("-p, --preset <name>", "Image preset (og, infographic, poster, banner, twitter, youtube, xiaohongshu, wechat)", "og").option("--width <number>", "Custom width in pixels").option("--height <number>", "Custom height in pixels").option("--scale <number>", "Device scale factor", "2").option("--wait-until <state>", "Navigation waitUntil (load, domcontentloaded, networkidle)", "networkidle").option("--timeout <ms>", "Navigation timeout in milliseconds", "30000").option("--safe", "Disable external network requests and JavaScript execution").action(async (options) => {
+const program = new Command();
+program.name("pagepress").description("Render local Markdown and HTML files to PDF").version("0.8.0").requiredOption("-i, --input <path>", "Input Markdown or HTML file path").requiredOption("-o, --output <path>", "Output PDF file path").option("-t, --template <name>", "PDF template (default, github, magazine)", "default").option("--wait-until <state>", "Navigation waitUntil (load, domcontentloaded, networkidle)", "networkidle").option("--timeout <ms>", "Navigation timeout in milliseconds", "30000").option("--safe", "Disable external network requests and JavaScript execution").action(async (options) => {
   try {
     const timeout = Number.parseInt(options.timeout, 10);
     if (!Number.isFinite(timeout) || timeout < 0) {
@@ -509,10 +326,7 @@ const command = new Command("shot").description("Capture HTML to PNG image").req
     const result = await render({
       input: options.input,
       output: options.output,
-      preset: options.preset,
-      width: options.width ? parseInt(options.width) : void 0,
-      height: options.height ? parseInt(options.height) : void 0,
-      scale: parseFloat(options.scale),
+      template: options.template,
       waitUntil: options.waitUntil,
       timeout,
       safe: options.safe
@@ -523,8 +337,4 @@ const command = new Command("shot").description("Capture HTML to PNG image").req
     process.exit(1);
   }
 });
-const program = new Command();
-program.name("pagepress").description("Convert web pages and Markdown to PDF and images").version("0.6.1");
-program.addCommand(command$1);
-program.addCommand(command);
 program.parse();

package/package.json

@@ -1,28 +1,19 @@
 {
   "name": "@liustack/pagepress",
-  "version": "0.6.1",
-  "description": "CLI tool to convert web pages and Markdown to PDF and images",
+  "version": "0.8.0",
+  "description": "CLI tool to render local Markdown and HTML files into PDF",
   "type": "module",
   "bin": {
     "pagepress": "./dist/main.js"
   },
   "files": [
     "dist",
-    "src/pdf/templates"
+    "src/templates"
   ],
   "keywords": [
     "pdf",
-    "png",
-    "screenshot",
-    "og-image",
-    "social-card",
-    "banner",
-    "poster",
-    "infographic",
     "markdown-to-pdf",
     "html-to-pdf",
-    "html-to-image",
-    "web-to-png",
     "pdf-report",
     "cli",
     "playwright",
@@ -55,13 +46,19 @@
   },
   "devDependencies": {
     "@types/node": "^22.19.7",
+    "@vitest/coverage-v8": "^4.0.18",
     "typescript": "^5.9.3",
     "vite": "^6.4.1",
-    "vite-plugin-node": "^5.0.1"
+    "vite-plugin-node": "^5.0.1",
+    "vitest": "^4.0.18"
   },
   "scripts": {
     "dev": "vite build --watch",
     "build": "vite build",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "docs:list": "node scripts/docs-list.js"
   }
 }