czon 0.1.0 → 0.1.1

package/.github/workflows/bump-version.yml

@@ -0,0 +1,112 @@
+name: Bump Version
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version bump type'
+        required: true
+        type: choice
+        options:
+          - major
+          - minor
+          - patch
+        default: 'patch'
+
+jobs:
+  bump-version:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+          persist-credentials: true
+
+      - name: Setup Git
+        run: |
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+
+      - name: Sync with remote
+        run: |
+          git fetch origin
+          git checkout -b bump-version-${{ github.run_id }}
+          git reset --hard origin/main
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+
+      - name: Get current version
+        id: get_version
+        run: |
+          CURRENT_VERSION=$(jq -r '.version' package.json)
+          echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          echo "Current version: $CURRENT_VERSION"
+
+      - name: Bump version
+        id: bump_version
+        run: |
+          # 解析当前版本号 (支持 semver 格式)
+          CURRENT_VERSION="${{ steps.get_version.outputs.current_version }}"
+          echo "Current version: $CURRENT_VERSION"
+
+          # 使用 npm version 命令来安全地更新版本
+          # 这会自动处理 semver 规则
+          npm version "${{ github.event.inputs.version }}" --no-git-tag-version
+
+          # 获取新版本
+          NEW_VERSION=$(jq -r '.version' package.json)
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "New version: $NEW_VERSION"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: |
+          npm run test:types
+          npm run test:build
+          npm run test:cli
+
+      - name: Show changed files
+        run: |
+          echo "Changed files:"
+          git status --porcelain
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: "chore: bump version from ${{ steps.get_version.outputs.current_version }} to ${{ steps.bump_version.outputs.new_version }}"
+          title: "chore: bump version from ${{ steps.get_version.outputs.current_version }} to ${{ steps.bump_version.outputs.new_version }}"
+          body: |
+            This PR was automatically created by the Bump Version workflow.
+
+            ## Changes
+            - Bumped version from **${{ steps.get_version.outputs.current_version }}** to **${{ steps.bump_version.outputs.new_version }}**
+            - Version bump type: **${{ github.event.inputs.version }}**
+
+            ## Test Results
+            - Type checking: ✅ Passed
+            - Build test: ✅ Passed
+            - CLI test: ✅ Passed
+
+            🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+            Co-Authored-By: Claude <noreply@anthropic.com>
+          branch: bump-version-${{ github.run_id }}
+          base: main
+          labels: |
+            automated-pr
+            version-bump
+            enhancement
+          token: ${{ secrets.GITHUB_TOKEN }}
+          add-paths: |
+            package.json
+            package-lock.json

package/.github/workflows/ci.yml

@@ -0,0 +1,64 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [22.x, 24.x]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linting (if configured)
+        run: |
+          if [ -f .eslintrc.js ] || [ -f .eslintrc.json ] || [ -f .eslintrc ]; then
+            npx eslint src/ --ext .ts,.tsx
+          else
+            echo "No ESLint config found, skipping linting"
+          fi
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build package
+        run: npm run build
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run npm audit
+        run: npm audit --audit-level=moderate
+
+      - name: Check for outdated dependencies
+        run: npm outdated || true

package/.github/workflows/pages.yml

@@ -0,0 +1,61 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch: # 允许手动触发
+
+# 设置 GITHUB_TOKEN 的权限以允许部署到 GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# 只允许一个并发部署，跳过正在运行的队列
+concurrency:
+  group: 'pages'
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          # 从远程分支开始时，需要先同步分支保证代码正确
+          fetch-depth: 0
+          ref: ${{ github.head_ref || github.ref }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Create documentation site
+        run: |
+          npm run build:doc
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './.zen/dist'
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/publish.yml

@@ -0,0 +1,81 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:  # 允许手动触发
+
+permissions:
+  contents: read
+  id-token: write  # 必需：用于 OIDC 认证
+
+jobs:
+  publish-npm:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Fetch all branches and tags
+        run: |
+          git fetch --all
+          git fetch --tags
+
+      - name: Setup Node.js for npm publish
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+
+      - name: Update npm to latest version
+        run: npm install -g npm@latest
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build package
+        run: npm run build
+
+      - name: Verify build
+        run: |
+          ls -la dist/
+          test -f dist/index.js && test -f dist/cli.js
+          echo "Build verification successful"
+
+      - name: Check if version already published
+        id: check_version
+        run: |
+          # 获取当前 package.json 中的版本和包名
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          echo "Package name: $PACKAGE_NAME"
+          echo "Current version in package.json: $CURRENT_VERSION"
+
+          # 尝试从 npm 获取已发布的版本信息
+          if npm view $PACKAGE_NAME@$CURRENT_VERSION version > /dev/null 2>&1; then
+            echo "Version $CURRENT_VERSION is already published on npm"
+            echo "skip_publish=true" >> $GITHUB_OUTPUT
+          else
+            echo "Version $CURRENT_VERSION is not published yet"
+            echo "skip_publish=false" >> $GITHUB_OUTPUT
+          fi
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Check npm version
+        run: npm --version
+
+      - name: Publish to npm
+        if: steps.check_version.outputs.skip_publish == 'false'
+        run: |
+          echo "Attempting to publish to npm..."
+          npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/.prettierignore

@@ -0,0 +1,14 @@
+# Ignore artifacts
+dist/
+node_modules/
+coverage/
+
+# Ignore demo files
+demo/
+
+# Ignore package lock
+package-lock.json
+
+# Ignore Prettier config itself
+.prettierrc.json
+.prettierignore

package/.prettierrc.json

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}

package/.zen/meta.json

@@ -0,0 +1,106 @@
+{
+  "version": "1.0.0",
+  "options": {
+    "verbose": true,
+    "langs": [
+      "zh-Hans",
+      "en-US",
+      "ja-JP",
+      "ko-KR",
+      "es-ES",
+      "fr-FR",
+      "de-DE",
+      "ru-RU",
+      "pt-PT",
+      "it-IT",
+      "nl-NL",
+      "pl-PL",
+      "sv-SE",
+      "fi-FI",
+      "da-DK",
+      "no-NO",
+      "zh-Hant",
+      "hi-IN",
+      "ar-SA",
+      "th-TH",
+      "vi-VN",
+      "id-ID",
+      "pt-BR",
+      "es-MX",
+      "tr-TR",
+      "uk-UA"
+    ]
+  },
+  "files": [
+    {
+      "hash": "6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed",
+      "path": "README.md",
+      "links": [
+        "https://zen.zccz14.com/",
+        "https://nodejs.org/",
+        "https://platform.openai.com/account/api-keys"
+      ],
+      "metadata": {
+        "title": "ZEN - 极简主义 Markdown + AI 静态站点构建器",
+        "summary": "ZEN 是一个结合 AI 的静态站点生成器，专注于简化文档写作和构建过程。它允许用户使用 Markdown 在 git 管理的文件夹中创建静态 HTML 站点，无需复杂配置，所有设置隐藏在 .zen 目录下。核心功能包括智能分类导航（通过 AI 分析内容生成站点地图）、自动增量翻译（支持多语言版本，用户可用母语写作，AI 处理翻译），以及最小化打扰的写作体验。工具依赖 Node.js、OpenAI API Key 和 Git，通过命令行快速构建，支持指定语言参数如 zh-Hans 和 en-US。",
+        "tags": ["静态站点生成器", "Markdown", "AI", "多语言翻译", "极简主义", "文档工具", "ZEN"],
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 1011,
+          "completion": 212,
+          "total": 1223
+        }
+      }
+    },
+    {
+      "hash": "579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503",
+      "path": "docs/test-katex.md",
+      "links": [],
+      "metadata": {
+        "title": "KaTeX 公式显示效果测试",
+        "summary": "该文档是一个用于测试KaTeX公式显示效果的示例，包含多个行内和块级数学公式，如E=mc^2、积分、导数、级数、分段函数、表格、矩阵等，旨在验证公式的正确渲染。",
+        "tags": ["KaTeX", "公式测试", "数学公式", "LaTeX", "显示效果", "文档示例"],
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 552,
+          "completion": 118,
+          "total": 670
+        }
+      }
+    },
+    {
+      "hash": "50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c",
+      "path": "docs/test-mermaid.md",
+      "links": [],
+      "metadata": {
+        "title": "Mermaid 图表测试文档",
+        "summary": "该文档是一个测试文件，用于验证 ZEN 中的 Mermaid 图表渲染功能。它包含了多种 Mermaid 图表类型的示例，如流程图、序列图、甘特图、类图、状态图和饼图，并包括一个错误语法测试以检查错误信息显示。文档旨在展示 Mermaid 集成在 ZEN 中的正常工作状态。",
+        "tags": ["Mermaid", "图表测试", "ZEN", "流程图", "序列图", "甘特图", "类图", "状态图"],
+        "inferred_date": "2024-01-01",
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 899,
+          "completion": 156,
+          "total": 1055
+        }
+      }
+    },
+    {
+      "hash": "9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc",
+      "path": "docs/tricks.md",
+      "links": [],
+      "metadata": {
+        "title": "ZEN文档日期声明使用技巧",
+        "summary": "本文档介绍了ZEN工具中在正文中直接声明日期的使用技巧，与传统Markdown通过YAML Frontmatter声明日期的方式对比，强调了ZEN的自动识别和智能处理功能，提升了用户体验，并适用于日记、博客等需要时间线的内容类型。",
+        "tags": ["ZEN", "日期声明", "Markdown", "AI处理", "时间线", "用户体验", "文档管理"],
+        "inferred_date": "2026-01-08",
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 417,
+          "completion": 135,
+          "total": 552
+        }
+      }
+    }
+  ]
+}

package/.zen/src/ar-SA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'وثيقة اختبار مخططات Mermaid'
+'summary': 'هذه الوثيقة هي ملف اختبار للتحقق من وظيفة عرض مخططات Mermaid في ZEN. تحتوي على أمثلة لأنواع متعددة من مخططات Mermaid، مثل المخططات الانسيابية، ومخططات التسلسل، ومخططات جانت، ومخططات الفئات، ومخططات الحالة، والمخططات الدائرية، وتتضمن اختبارًا لبناء جملة خاطئ للتحقق من عرض رسائل الخطأ. تهدف الوثيقة إلى عرض حالة عمل تكامل Mermaid في ZEN بشكل صحيح.'
+'tags':
+  - 'Mermaid'
+  - 'اختبار المخططات'
+  - 'ZEN'
+  - 'المخطط الانسيابي'
+  - 'مخطط التسلسل'
+  - 'مخطط جانت'
+  - 'مخطط الفئات'
+  - 'مخطط الحالة'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'ar-SA'
+---
+
+# اختبار مخططات Mermaid
+
+هذا ملف اختبار للتحقق من وظيفة عرض مخططات Mermaid في ZEN.
+
+## مثال على المخطط الانسيابي
+
+```mermaid
+graph TD
+    A[بداية] --> B{هل تستمر؟}
+    B -->|نعم| C[تنفيذ العملية]
+    B -->|لا| D[نهاية]
+    C --> E[فحص النتيجة]
+    E --> F{هل نجحت؟}
+    F -->|نعم| G[اكتمال]
+    F -->|لا| H[إعادة المحاولة]
+    H --> C
+    G --> D
+```
+
+## مثال على مخطط التسلسل
+
+```mermaid
+sequenceDiagram
+    participant المستخدم
+    participant النظام
+    participant قاعدة_البيانات
+
+    المستخدم->>النظام: تقديم الطلب
+    النظام->>قاعدة_البيانات: استعلام البيانات
+    قاعدة_البيانات-->>النظام: إرجاع النتيجة
+    النظام-->>المستخدم: عرض النتيجة
+```
+
+## مثال على مخطط جانت
+
+```mermaid
+gantt
+    title الجدول الزمني للمشروع
+    dateFormat  YYYY-MM-DD
+    section التصميم
+    تحليل المتطلبات     :مكتمل,    des1, 2024-01-01, 7d
+    تصميم النموذج الأولي     :نشط,  des2, 2024-01-08, 5d
+    التصميم التفصيلي     :         des3, after des2, 5d
+    section التطوير
+    تطوير الواجهة الأمامية     :         dev1, after des3, 10d
+    تطوير الواجهة الخلفية     :         dev2, after des3, 15d
+    section الاختبار
+    الاختبار الوحدوي     :         test1, after dev1, 5d
+    اختبار التكامل     :         test2, after dev2, 5d
+```
+
+## مثال على مخطط الفئات
+
+```mermaid
+classDiagram
+    class الحيوان {
+        +String الاسم
+        +int العمر
+        +void أكل()
+        +void نوم()
+    }
+    class الكلب {
+        +void نباح()
+    }
+    class القط {
+        +void مواء()
+    }
+
+    الحيوان <|-- الكلب
+    الحيوان <|-- القط
+```
+
+## مثال على مخطط الحالة
+
+```mermaid
+stateDiagram-v2
+    [*] --> خامل
+    خامل --> معالجة : بدء المعالجة
+    معالجة --> نجاح : نجاح المعالجة
+    معالجة --> خطأ : فشل المعالجة
+    نجاح --> [*]
+    خطأ --> [*]
+```
+
+## مثال على المخطط الدائري
+
+```mermaid
+pie title معدل استخدام المتصفحات
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "أخرى" : 1.8
+```
+
+## اختبار بناء جملة خاطئ (يجب أن يعرض رسالة خطأ)
+
+```mermaid
+graph TD
+    A --> B
+    // هنا تعريف السهم مفقود
+    C --> D
+```
+
+يحتوي ملف الاختبار هذا على أنواع متعددة من مخططات Mermaid، للتحقق من عمل تكامل Mermaid في ZEN بشكل صحيح.

package/.zen/src/ar-SA/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -0,0 +1,79 @@
+---
+'title': 'اختبار عرض صيغ KaTeX'
+'summary': 'هذا المستند هو مثال لاختبار عرض صيغ KaTeX، يحتوي على عدة صيغ رياضية داخل السطر وعلى مستوى الكتلة، مثل E=mc^2، التكامل، المشتقة، المتسلسلة، الدالة المتعددة التعريف، الجداول، المصفوفات، إلخ، ويهدف إلى التحقق من التصيير الصحيح للصيغ.'
+'tags':
+  - 'KaTeX'
+  - 'اختبار الصيغ'
+  - 'الصيغ الرياضية'
+  - 'LaTeX'
+  - 'تأثير العرض'
+  - 'مثال المستند'
+'inferred_lang': 'ar-SA'
+---
+
+# اختبار عرض صيغ KaTeX
+
+هذا اختبار للصيغة داخل السطر: $ E = mc^2 $.
+
+هذا اختبار للصيغة على مستوى الكتلة:
+
+$$
+\int_a^b f(x) \, dx = F(b) - F(a)
+$$
+
+هذا اختبار آخر للصيغة على مستوى الكتلة:
+
+$$
+\frac{d}{dx}e^x = e^x
+$$
+
+هذا اختبار لصيغة معقدة:
+
+$$
+\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
+$$
+
+اختبار صيغة تحتوي على حالات:
+
+$$
+f(x) =
+\begin{cases}
+x^2 & \text{if } x \geq 0 \\
+-x & \text{if } x < 0
+\end{cases}
+$$
+
+صيغة الجدول:
+
+$$
+\begin{array}{c|c|c}
+a & b & c \\
+\hline
+1 & 2 & 3 \\
+4 & 5 & 6 \\
+\end{array}
+$$
+
+صيغة المصفوفة:
+
+$$
+\begin{pmatrix}
+1 & 2 \\
+3 & 4
+\end{pmatrix}
+$$
+
+اختبار صيغة تحتوي على نص:
+
+$$
+E = mc^2 \quad \text{where } m \text{ is mass and
+    } c \text{ is the speed of light}
+$$
+
+صيغة كيلي المعممة:
+
+$$
+f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
+$$
+
+يرجى التأكد من أن جميع الصيغ أعلاه تعرض بشكل صحيح.