Merge branch 'version2-beta'

Author: fatbobman

.githooks/README.md

@@ -0,0 +1,111 @@
+# Git Hooks
+
+此目录包含项目的 Git Hooks 脚本，用于自动化代码质量检查。
+
+## 安装
+
+在首次克隆仓库或更新 hooks 后，需要运行安装脚本：
+
+```bash
+bash .githooks/install.sh
+```
+
+或者使用 Git 配置自动使用此目录（Git 2.9+）：
+
+```bash
+git config core.hooksPath .githooks
+```
+
+## 可用的 Hooks
+
+### pre-commit
+
+在 `git commit` 之前自动执行：
+
+- **功能**：自动格式化待提交的 Swift 代码
+- **工具**：使用 Apple 官方的 `swift-format` 进行格式化
+- **行为**：
+  - 检测所有待提交的 `.swift` 文件
+  - 使用 `swift-format` 格式化这些文件
+  - 自动将格式化后的文件重新暂存
+  - 如果未安装 `swift-format`，会给出警告但不会阻止提交
+
+## 安装 swift-format
+
+### 使用 Homebrew（推荐）
+
+```bash
+brew install swift-format
+```
+
+### 使用 Mint
+
+```bash
+mint install apple/swift-format
+```
+
+### 从源码构建
+
+```bash
+git clone https://github.com/apple/swift-format.git
+cd swift-format
+swift build -c release
+```
+
+## 配置
+
+`swift-format` 使用 Apple 官方的默认规则，也可以在项目根目录创建 `.swift-format` 配置文件进行自定义。
+
+## 跳过 Hook 检查
+
+如果需要暂时跳过 hook 检查（不推荐）：
+
+```bash
+git commit --no-verify
+```
+
+或使用简写：
+
+```bash
+git commit -n
+```
+
+## 卸载
+
+删除已安装的 hooks：
+
+```bash
+rm -rf .git/hooks/pre-commit
+```
+
+## 故障排查
+
+### Hook 没有执行
+
+1. 检查 hook 是否有执行权限：
+   ```bash
+   ls -l .git/hooks/pre-commit
+   ```
+
+2. 重新安装：
+   ```bash
+   bash .githooks/install.sh
+   ```
+
+### swift-format 找不到
+
+确保 `swift-format` 在 PATH 中：
+
+```bash
+which swift-format
+```
+
+如果没有，请重新安装或将其添加到 PATH。
+
+## 维护
+
+更新 hooks 后，团队成员需要重新运行安装脚本：
+
+```bash
+bash .githooks/install.sh
+```

.githooks/install.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+# Git Hooks 安装脚本
+# 将 .githooks 目录中的钩子复制到 .git/hooks
+
+echo "📦 安装 Git Hooks..."
+
+# 获取脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# 创建 .git/hooks 目录（如果不存在）
+mkdir -p "$PROJECT_ROOT/.git/hooks"
+
+# 复制所有 hook 文件
+for hook in "$SCRIPT_DIR"/*; do
+    # 跳过安装脚本本身和 README
+    if [[ "$(basename "$hook")" == "install.sh" ]] || [[ "$(basename "$hook")" == "README.md" ]]; then
+        continue
+    fi
+
+    hook_name=$(basename "$hook")
+    echo "  ✓ 安装 $hook_name"
+
+    # 复制并设置执行权限
+    cp "$hook" "$PROJECT_ROOT/.git/hooks/$hook_name"
+    chmod +x "$PROJECT_ROOT/.git/hooks/$hook_name"
+done
+
+echo ""
+echo "✅ Git Hooks 安装完成!"
+echo ""
+echo "提示:"
+echo "  • 如需跳过 hook 检查: git commit --no-verify"
+echo "  • 安装 swift-format: brew install swift-format"
+echo ""

.githooks/pre-commit

@@ -0,0 +1,41 @@
+#!/bin/bash
+
+set -euo pipefail
+
+# Pre-commit hook for Swift code formatting
+# 在提交前自动格式化 Swift 代码
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+CONFIG_FILE="$REPO_ROOT/.swift-format"
+
+if ! command -v swift-format >/dev/null 2>&1; then
+    echo "⚠️  未找到 swift-format，跳过格式化"
+    echo "   安装方法: brew install swift-format"
+    echo ""
+    echo "   或者跳过此检查: git commit --no-verify"
+    exit 0
+fi
+
+SWIFT_FILES=()
+while IFS= read -r -d '' file; do
+    SWIFT_FILES+=("$file")
+done < <(git diff --cached --name-only --diff-filter=ACM -z -- '*.swift')
+
+if [ "${#SWIFT_FILES[@]}" -eq 0 ]; then
+    exit 0
+fi
+
+echo "🔍 检测到 Swift 文件变更，开始格式化..."
+
+FORMATTED_COUNT=0
+for file in "${SWIFT_FILES[@]}"; do
+    if [ -f "$file" ]; then
+        echo "  📝 格式化: $file"
+        swift-format format --configuration "$CONFIG_FILE" --in-place "$file"
+        git add "$file"
+        FORMATTED_COUNT=$((FORMATTED_COUNT + 1))
+    fi
+done
+
+echo "✅ 格式化完成 ($FORMATTED_COUNT 个文件)"
+echo ""

.github/FUNDING.yml

@@ -1,7 +1,7 @@
 # These are supported funding model platforms
 
 github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: fatbobman
+patreon: #
 open_collective: # Replace with a single Open Collective username
 ko_fi: # Replace with a single Ko-fi username
 tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel

.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - version2-beta
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build-and-test:
+    name: Build and Test
+    runs-on: macos-15
+    env:
+      DEVELOPER_DIR: /Applications/Xcode_26.3.0.app/Contents/Developer
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Show Xcode Version
+        run: xcodebuild -version
+
+      - name: Show Swift Version
+        run: swift --version
+
+      - name: Build
+        run: swift build --enable-experimental-prebuilts
+
+      - name: Test (Parallel)
+        run: bash test.sh --enable-experimental-prebuilts

.gitignore

@@ -1,7 +1,11 @@
 .DS_Store
 /.build
 /Packages
+/.swiftpm
+Package.resolved
 /*.xcodeproj
 xcuserdata/
 DerivedData/
 .swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+/.vscode
+/.claude

.swift-format

@@ -0,0 +1,23 @@
+{
+  "version" : 1,
+  "indentation" : {
+    "spaces" : 2
+  },
+  "lineLength" : 100,
+  "maximumBlankLines" : 1,
+  "multiElementCollectionTrailingCommas" : true,
+  "respectsExistingLineBreaks" : true,
+  "indentConditionalCompilationBlocks" : true,
+  "lineBreakBeforeControlFlowKeywords" : false,
+  "lineBreakBeforeEachArgument" : false,
+  "spacesAroundRangeFormationOperators" : false,
+  "rules" : {
+    "DoNotUseSemicolons" : true,
+    "NoEmptyTrailingClosureParentheses" : true,
+    "NoParensAroundConditions" : true,
+    "OrderedImports" : true,
+    "ReturnVoidInsteadOfEmptyTuple" : true,
+    "UseShorthandTypeNames" : true,
+    "UseTripleSlashForDocumentationComments" : true
+  }
+}