@liustack/pagepress 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# PagePress
+
+A web content rendering toolkit (CLI) designed for **AI Agents**, converting HTML, Markdown, and URLs into high-quality **PDF** or **PNG** images.
+
+## ✨ Features
+
+- **Unified CLI**: One tool (`pagepress`) for both PDF and image generation
+- **AI Agent friendly**: Includes a detailed SKILL.md guide with scenario routing
+- **Multiple inputs**: Local HTML, Markdown files, or remote URLs
+- **Rich templates**:
+  - **PDF**: Apple style, GitHub style, magazine layout (Magazine)
+  - **Image**: OG cards, infographics, posters, banners
+- **Consistency guarantees**: Deterministic rendering, font waiting, network idle detection, syntax highlighting
+
+## 📦 Installation
+
+```bash
+# Global install
+npm install -g @liustack/pagepress
+
+# Install browsers (Playwright)
+npx playwright install chromium
+```
+
+Or use `npx` directly:
+
+```bash
+npx @liustack/pagepress <command> [options]
+```
+
+## 🚀 Usage
+
+### 1. Generate PDF
+
+Convert HTML/Markdown into PDF documents. Supports syntax highlighting.
+
+```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
+
+# Render a web page (as-is)
+pagepress pdf -i https://example.com -o webpage.pdf
+```
+
+**Supported templates**:
+- `default` - Apple style, clean and elegant
+- `github` - GitHub style
+- `magazine` - VOGUE/WIRED magazine layout
+
+### 2. Generate Images
+
+Render HTML/URLs into PNG images, suitable for social share cards, posters, and long screenshots.
+
+```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
+
+# Webpage screenshot
+pagepress shot -i https://example.com -o screenshot.png
+```
+
+**Supported presets**:
+- `og` (1200x630) - Social card
+- `infographic` (1080x1350) - Infographic
+- `poster` (1200x1500) - Poster
+- `banner` (1600x900) - Banner
+
+## 🤖 AI Agent Integration
+
+This project includes a detailed [SKILL.md](skills/pagepress/SKILL.md) to help AI Agents (such as Claude, ChatGPT) understand how to use this tool.
+
+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").
+
+## 📄 License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,82 @@
+# PagePress
+
+一套专为 **AI Agent** 设计的 Web 内容渲染工具集（CLI），可将 HTML、Markdown、URL 转换为高质量的 **PDF** 或 **PNG** 图像。
+
+## ✨ 特性
+
+- **统一 CLI**：一个工具 (`pagepress`) 搞定 PDF 和 Image 生成
+- **AI Agent 友好**：包含详细的 SKILL.md 指南，支持场景路由
+- **多种输入**：支持本地 HTML、Markdown 文件或远程 URL
+- **丰富模板**：
+  - **PDF**: Apple 风格、GitHub 风格、杂志排版 (Magazine)
+  - **Image**: OG 卡片、信息图、海报、横幅
+- **一致性保障**：确定性渲染、字体等待、网络空闲检测、代码高亮
+
+## 📦 安装
+
+```bash
+# 全局安装
+npm install -g @liustack/pagepress
+
+# 安装浏览器（Playwright）
+npx playwright install chromium
+```
+
+或者直接使用 `npx`:
+
+```bash
+npx @liustack/pagepress <command> [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
+
+# 网页打印（原样渲染）
+pagepress pdf -i https://example.com -o webpage.pdf
+```
+
+**支持的模板**：
+- `default` - Apple 风格，简洁优雅
+- `github` - GitHub 风格
+- `magazine` - VOGUE/WIRED 杂志排版
+
+### 2. 生成图像
+
+将 HTML/URL 渲染为 PNG 图像，适合社交分享卡片、海报、长图截屏。
+
+```bash
+# 生成 OG 卡片（1200×630）
+pagepress shot -i card.html -o og.png --preset og
+
+# 生成信息长图
+pagepress shot -i stats.html -o infographic.png --preset infographic
+
+# 网页截图
+pagepress shot -i https://example.com -o screenshot.png
+```
+
+**支持的预设**：
+- `og` (1200×630) - 社交卡片
+- `infographic` (1080×1350) - 信息图
+- `poster` (1200×1500) - 海报
+- `banner` (1600×900) - 横幅
+
+## 🤖 AI Agent 集成
+
+本项目包含详细的 [SKILL.md](skills/pagepress/SKILL.md)，旨在帮助 AI Agent（如 Claude, ChatGPT）理解如何使用此工具。
+
+Agent 可以根据用户的自然语言指令（如“生成一张海报”、“把这个文档转成 PDF”）自动选择合适的命令和参数。
+
+## 📄 License
+
+MIT