@bytechain.cn/colamd-themes 0.3.1 → 0.5.0

package/.trae/rules/colamd-themes.md

@@ -2,149 +2,4 @@
 
 When the user asks to create, validate, export, or manage ColaMD themes, use the following CLI tool:
 
-Generate, validate, export, and manage ColaMD v3.0 paradigm CSS themes. Extract formatting from URLs, DOCX, or PDF sources; export Markdown to standalone HTML/PDF with themes applied; batch export; manage theme configuration.
 
-## Prerequisites
-
-- Node.js ≥ 18
-- Project root: run `npm install && npm run build` before first use
-- Or run directly: `npx tsx src/cli.ts <command>`
-
-## Commands
-
-### Theme extraction
-
-```bash
-colamd-themes from-url <URL> [options]
-colamd-themes from-docx <file> [options]
-colamd-themes from-pdf <file> [options]
-colamd-themes extract <source> [options]
-```
-
-### Export to HTML / PDF
-
-```bash
-colamd-themes export-html <input.md> -t <theme> -o <output.html>
-colamd-themes export-pdf  <input.md> -t <theme> -o <output.pdf>
-colamd-themes export <inputs...> --format html|pdf -t <theme> -d <dir>
-```
-
-### Theme management
-
-```bash
-colamd-themes set-theme <name> --default
-colamd-themes set-theme <name> --css <file>
-colamd-themes set-theme <name> --css <file> --default
-colamd-themes set-theme <name> --remove
-```
-
-### Inspection
-
-```bash
-colamd-themes color-systems [-j]
-colamd-themes mermaid-presets [-j]
-colamd-themes list [-d <dir>]
-colamd-themes validate <file.css>
-```
-
-## Options
-
-### Extract options
-
-| Flag | Description |
-|------|-------------|
-| `-n, --name` | Theme name |
-| `-o, --output` | Output CSS file path |
-| `-d, --themes-dir` | Themes directory (default: `themes/`) |
-| `-c, --color-system` | Force a color system |
-| `-m, --mermaid-preset` | Force a Mermaid preset (light/dark/elegant) |
-| `-A, --auto-match` | Auto-match color system and Mermaid preset |
-
-### Export options
-
-| Flag | Description |
-|------|-------------|
-| `-t, --theme` | Theme: built-in name, custom name, or `.css` file path |
-| `-o, --output` | Output file path |
-| `-d, --output-dir` | Output directory for batch export |
-| `--format` | Batch: `html` or `pdf`; PDF: `A4`, `Letter`, `A3` |
-
-## Theme Resolution
-
-`-t, --theme` accepts:
-1. **Built-in**: `light`, `dark`, `elegant`, `newsprint`
-2. **Custom registered**: name set via `set-theme --css`
-3. **File path**: any `.css` file on disk
-
-Config: `~/.colamd-themes/config.json`
-
-## Color Systems (15 schemes)
-
-| Family | Schemes |
-|--------|---------|
-| 莫兰迪 (Morandi) | misty-rose, sage-green, dusky-blue |
-| 马卡龙 (Macaron) | strawberry, mint, lavender |
-| 北欧 (Nordic) | fjord-blue, pine-green, cloud-grey |
-| 复古 (Vintage) | amber, burgundy, forest |
-| 薄荷绿 (Mint) | matcha, spearmint, seafoam |
-
-## Mermaid Presets
-
-`light` — cool accent on light bg | `dark` — dark bg | `elegant` — warm accent on light bg
-
-## Workflow Examples
-
-### Create theme from source
-
-```bash
-colamd-themes extract <source> --name "my-theme" --auto-match
-```
-
-### Export with theme
-
-```bash
-colamd-themes export-html doc.md -t elegant -o output.html
-colamd-themes export-pdf doc.md -t my-brand -o output.pdf
-```
-
-### Batch export
-
-```bash
-colamd-themes export docs/ --format pdf -t dark -d output/
-```
-
-### Validate theme
-
-```bash
-colamd-themes validate themes/my-theme.css
-```
-
-## Rendering Pipeline
-
-Export uses Puppeteer (headless Chromium) with `@bytechain.cn/colamd/renderer`:
-
-1. Local HTTP server serves renderer ESM bundle (avoids CORS)
-2. Puppeteer navigates to server page (same-origin)
-3. `createColaMDEditor({ editable: false })` initializes Milkdown editor
-4. `applyTheme(name, customCSS?)` sets theme
-5. `setMarkdown(content)` loads document
-6. `ensureAllPluginsRendered()` waits for mermaid/KaTeX
-7. `buildExportHTML()` → standalone HTML with embedded CSS
-8. For PDF: `emulateMediaType('screen')` + `page.pdf()`
-
-## v3.0 Paradigm Constraints
-
-- No bare hex colors in selectors — use `var(--seed-*)`
-- No bare font sizes — use `var(--font-*)`
-- No Mermaid SVG selectors (handled by built-in `variables.css`)
-- `!important` only in `@media print`
-- Generated CSS ≤ 300 lines
-- Font stacks must include CJK fallback and end with generic family
-
-## Architecture
-
-```
-Source → Extractor → ThemeStyle → Color System + Mermaid Preset + Validators → CSS
-
-Markdown → Puppeteer + ColaMD Renderer → HTML / PDF
-```