ccjk 14.2.2 → 15.0.0

package/dist/templates/hooks/pre-commit-prettier.md

@@ -1,212 +0,0 @@
----
-id: pre-commit-prettier
-type: PreToolUse
-name: Prettier Pre-commit Hook
-description: Automatically format code with Prettier before git commits
-priority: 9
-matcher: Bash(git commit *)
-command: npx prettier --write .
-timeout: 30000
-enabled: true
-applicableTo: [all]
----
-
-# Prettier Pre-commit Hook
-
-## Description
-
-This hook automatically runs Prettier to format code before every git commit, ensuring consistent code formatting across the entire project. It supports all file types that Prettier can handle.
-
-## 描述
-
-此钩子在每次 git 提交前自动运行 Prettier 格式化代码，确保整个项目的代码格式一致。它支持 Prettier 能够处理的所有文件类型。
-
-## When it runs
-
-- **Trigger**: Before any `git commit` command
-- **Condition**: When Prettier configuration is detected (`.prettierrc.*` or `prettier` in package.json)
-- **Scope**: Runs on all supported files in the project
-
-## 运行时机
-
-- **触发器**: 任何 `git commit` 命令之前
-- **条件**: 检测到 Prettier 配置时（`.prettierrc.*` 或 package.json 中的 `prettier`）
-- **范围**: 在项目中所有支持的文件上运行
-
-## Configuration
-
-### Prerequisites
-```bash
-# Install Prettier if not already installed
-npm install --save-dev prettier
-
-# Create basic configuration
-echo '{}' > .prettierrc.json
-```
-
-### Prettier Configuration
-```json
-// .prettierrc.json
-{
-  "semi": false,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "es5",
-  "printWidth": 100,
-  "endOfLine": "lf"
-}
-```
-
-### Ignore Files
-```gitignore
-# .prettierignore
-dist/
-build/
-coverage/
-node_modules/
-*.min.js
-*.min.css
-```
-
-### Hook Configuration
-```yaml
-# In your CCJK configuration
-hooks:
-  pre-commit-prettier:
-    enabled: true
-    command: "npx prettier --write ."
-    timeout: 30000
-    checkFormatted: true
-```
-
-## 配置
-
-### 前置条件
-```bash
-# 如果尚未安装 Prettier，请安装
-npm install --save-dev prettier
-
-# 创建基本配置
-echo '{}' > .prettierrc.json
-```
-
-### Prettier 配置
-```json
-// .prettierrc.json
-{
-  "semi": false,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "es5",
-  "printWidth": 100,
-  "endOfLine": "lf"
-}
-```
-
-## Customization
-
-### Format Specific File Types Only
-```yaml
-hooks:
-  pre-commit-prettier:
-    command: "npx prettier --write '**/*.{js,ts,json,md,yml,yaml}'"
-    include: ["src/**/*", "docs/**/*"]
-```
-
-### Check Format Without Writing
-```yaml
-hooks:
-  pre-commit-prettier:
-    command: "npx prettier --check ."
-    failOnUnformatted: true
-```
-
-### Integration with lint-staged
-```json
-// package.json
-{
-  "lint-staged": {
-    "*.{js,ts,json,md,yml,yaml}": ["prettier --write"]
-  }
-}
-```
-
-```yaml
-hooks:
-  pre-commit-prettier:
-    command: "npx lint-staged"
-```
-
-### Skip Specific Files
-```yaml
-hooks:
-  pre-commit-prettier:
-    command: "npx prettier --write . --ignore-path .prettierignore"
-    exclude: ["legacy/**/*", "vendor/**/*"]
-```
-
-## 自定义
-
-### 仅格式化特定文件类型
-```yaml
-hooks:
-  pre-commit-prettier:
-    command: "npx prettier --write '**/*.{js,ts,json,md,yml,yaml}'"
-    include: ["src/**/*", "docs/**/*"]
-```
-
-### 检查格式而不写入
-```yaml
-hooks:
-  pre-commit-prettier:
-    command: "npx prettier --check ."
-    failOnUnformatted: true
-```
-
-## Error Handling
-
-- **Formatting applied**: Files are automatically formatted and commit continues
-- **Parse errors**: Commit is blocked with syntax error details
-- **Timeout**: Hook fails after 30 seconds
-- **Missing Prettier**: Hook is skipped with warning
-- **Permission errors**: Hook fails with file access error details
-
-## 错误处理
-
-- **应用格式化**: 文件自动格式化并继续提交
-- **解析错误**: 阻止提交并显示语法错误详情
-- **超时**: 30 秒后钩子失败
-- **缺少 Prettier**: 跳过钩子并显示警告
-- **权限错误**: 钩子失败并显示文件访问错误详情
-
-## Performance Tips
-
-### Use .prettierignore for Large Projects
-```gitignore
-# .prettierignore
-node_modules/
-dist/
-build/
-coverage/
-*.min.*
-public/vendor/
-```
-
-### Optimize for Staged Files Only
-```bash
-# Use with lint-staged for better performance
-npx lint-staged
-```
-
-## 性能提示
-
-### 为大型项目使用 .prettierignore
-```gitignore
-# .prettierignore
-node_modules/
-dist/
-build/
-coverage/
-*.min.*
-public/vendor/
-```

package/dist/templates/hooks/pre-commit-type-check.md

@@ -1,377 +0,0 @@
----
-id: pre-commit-type-check
-type: PreToolUse
-name: TypeScript Type Check Pre-commit Hook
-description: Run TypeScript type checking before git commits to catch type errors
-priority: 10
-matcher: Bash(git commit *)
-command: npx tsc --noEmit
-timeout: 45000
-enabled: true
-applicableTo: [typescript, react, vue, angular, node]
----
-
-# TypeScript Type Check Pre-commit Hook
-
-## Description
-
-This hook runs TypeScript type checking before every git commit to catch type errors early. It uses `tsc --noEmit` to perform type checking without generating output files, ensuring type safety without affecting the build process.
-
-## 描述
-
-此钩子在每次 git 提交前运行 TypeScript 类型检查以尽早发现类型错误。它使用 `tsc --noEmit` 执行类型检查而不生成输出文件，确保类型安全而不影响构建过程。
-
-## When it runs
-
-- **Trigger**: Before any `git commit` command
-- **Condition**: When TypeScript configuration (`tsconfig.json`) is detected
-- **Scope**: Runs type checking on all TypeScript files in the project
-
-## 运行时机
-
-- **触发器**: 任何 `git commit` 命令之前
-- **条件**: 检测到 TypeScript 配置（`tsconfig.json`）时
-- **范围**: 对项目中所有 TypeScript 文件运行类型检查
-
-## Configuration
-
-### Prerequisites
-```bash
-# Install TypeScript if not already installed
-npm install --save-dev typescript
-
-# Initialize TypeScript configuration
-npx tsc --init
-```
-
-### Basic tsconfig.json
-```json
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "node",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}
-```
-
-### Hook Configuration
-```yaml
-# In your CCJK configuration
-hooks:
-  pre-commit-type-check:
-    enabled: true
-    command: "npx tsc --noEmit"
-    timeout: 45000
-    failOnError: true
-```
-
-## 配置
-
-### 前置条件
-```bash
-# 如果尚未安装 TypeScript，请安装
-npm install --save-dev typescript
-
-# 初始化 TypeScript 配置
-npx tsc --init
-```
-
-### 基本 tsconfig.json
-```json
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "node",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}
-```
-
-## Customization
-
-### Custom TypeScript Configuration
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit --project tsconfig.build.json"
-    description: "Use specific TypeScript configuration for type checking"
-```
-
-### Check Specific Directories Only
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit src/**/*.ts"
-    include: ["src/**/*.ts", "src/**/*.tsx"]
-```
-
-### Skip Type Checking for Tests
-```json
-// tsconfig.build.json
-{
-  "extends": "./tsconfig.json",
-  "exclude": ["**/*.test.ts", "**/*.spec.ts", "tests/**/*"]
-}
-```
-
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit --project tsconfig.build.json"
-```
-
-### Incremental Type Checking
-```json
-// tsconfig.json
-{
-  "compilerOptions": {
-    "incremental": true,
-    "tsBuildInfoFile": ".tsbuildinfo"
-  }
-}
-```
-
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit --incremental"
-    description: "Use incremental type checking for better performance"
-```
-
-### Integration with Multiple Projects
-```yaml
-hooks:
-  pre-commit-type-check-client:
-    command: "npx tsc --noEmit --project client/tsconfig.json"
-    priority: 10
-  pre-commit-type-check-server:
-    command: "npx tsc --noEmit --project server/tsconfig.json"
-    priority: 10
-```
-
-## 自定义
-
-### 自定义 TypeScript 配置
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit --project tsconfig.build.json"
-    description: "使用特定的 TypeScript 配置进行类型检查"
-```
-
-### 仅检查特定目录
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit src/**/*.ts"
-    include: ["src/**/*.ts", "src/**/*.tsx"]
-```
-
-### 跳过测试的类型检查
-```json
-// tsconfig.build.json
-{
-  "extends": "./tsconfig.json",
-  "exclude": ["**/*.test.ts", "**/*.spec.ts", "tests/**/*"]
-}
-```
-
-## Error Handling
-
-- **Type errors found**: Commit is blocked with detailed type error information
-- **Configuration errors**: Commit is blocked with tsconfig.json error details
-- **Timeout**: Hook fails after 45 seconds (longer timeout for large projects)
-- **Missing TypeScript**: Hook is skipped with installation instructions
-- **Missing tsconfig.json**: Hook is skipped with configuration instructions
-
-## 错误处理
-
-- **发现类型错误**: 阻止提交并显示详细的类型错误信息
-- **配置错误**: 阻止提交并显示 tsconfig.json 错误详情
-- **超时**: 45 秒后钩子失败（大型项目的更长超时）
-- **缺少 TypeScript**: 跳过钩子并显示安装说明
-- **缺少 tsconfig.json**: 跳过钩子并显示配置说明
-
-## Advanced Configuration
-
-### Strict Type Checking
-```json
-// tsconfig.strict.json
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "strict": true,
-    "noImplicitAny": true,
-    "noImplicitReturns": true,
-    "noImplicitThis": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "exactOptionalPropertyTypes": true
-  }
-}
-```
-
-### Project References for Monorepos
-```json
-// tsconfig.json (root)
-{
-  "files": [],
-  "references": [
-    { "path": "./packages/core" },
-    { "path": "./packages/utils" },
-    { "path": "./apps/web" }
-  ]
-}
-```
-
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --build --noEmit"
-    description: "Type check all project references"
-```
-
-### Custom Compiler Options
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit --strict --noUnusedLocals --noUnusedParameters"
-    description: "Type check with additional strict options"
-```
-
-## 高级配置
-
-### 严格类型检查
-```json
-// tsconfig.strict.json
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "strict": true,
-    "noImplicitAny": true,
-    "noImplicitReturns": true,
-    "noImplicitThis": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "exactOptionalPropertyTypes": true
-  }
-}
-```
-
-### Monorepo 的项目引用
-```json
-// tsconfig.json (root)
-{
-  "files": [],
-  "references": [
-    { "path": "./packages/core" },
-    { "path": "./packages/utils" },
-    { "path": "./apps/web" }
-  ]
-}
-```
-
-## Performance Tips
-
-### Use Project References
-For large monorepos, use TypeScript project references to improve type checking performance.
-
-### Enable Incremental Compilation
-```json
-{
-  "compilerOptions": {
-    "incremental": true,
-    "tsBuildInfoFile": ".tsbuildinfo"
-  }
-}
-```
-
-### Skip Library Type Checking
-```json
-{
-  "compilerOptions": {
-    "skipLibCheck": true
-  }
-}
-```
-
-## 性能提示
-
-### 使用项目引用
-对于大型 monorepo，使用 TypeScript 项目引用来提高类型检查性能。
-
-### 启用增量编译
-```json
-{
-  "compilerOptions": {
-    "incremental": true,
-    "tsBuildInfoFile": ".tsbuildinfo"
-  }
-}
-```
-
-### 跳过库类型检查
-```json
-{
-  "compilerOptions": {
-    "skipLibCheck": true
-  }
-}
-```
-
-## Integration with Other Tools
-
-### Combine with ESLint
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit"
-    priority: 11
-  pre-commit-eslint:
-    command: "npx eslint --fix ."
-    priority: 10
-```
-
-### Use with Vue.js
-```json
-// tsconfig.json for Vue
-{
-  "compilerOptions": {
-    "jsx": "preserve",
-    "moduleResolution": "node"
-  },
-  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"]
-}
-```
-
-## 与其他工具集成
-
-### 与 ESLint 结合
-```yaml
-hooks:
-  pre-commit-type-check:
-    command: "npx tsc --noEmit"
-    priority: 11
-  pre-commit-eslint:
-    command: "npx eslint --fix ."
-    priority: 10
-```