chore: integrate prettier and enhance code quality checks

adds prettier configuration and integrates it into the linting workflow to enforce consistent code style across the project. also updates eslint configuration to include prettier rules and adds format commands to package.json.

adds prettier 配置并将其集成到 linting 工作流程中，以在整个项目中强制执行一致的代码样式。还更新了 eslint 配置以包含 prettier 规则，并在 package.json 中添加了格式化命令。

Change-Id: I077c5695ff26d06b27fd983fbfaa212370180329
Signed-off-by: OhYee <oyohyee@oyohyee.com>

Author: OhYee

.eslintrc.json

@@ -1,11 +1,8 @@
 {
   "root": true,
   "parser": "@typescript-eslint/parser",
-  "plugins": ["@typescript-eslint"],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended"
-  ],
+  "plugins": ["@typescript-eslint", "prettier"],
+  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended", "plugin:prettier/recommended"],
   "env": {
     "node": true,
     "es2022": true
@@ -18,8 +15,8 @@
     "@typescript-eslint/no-explicit-any": "warn",
     "@typescript-eslint/explicit-function-return-type": "off",
     "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
-    "no-constant-condition": ["error", { "checkLoops": false }]
+    "no-constant-condition": ["error", { "checkLoops": false }],
+    "prettier/prettier": "error"
   },
   "ignorePatterns": ["dist", "node_modules", "*.js"]
 }
-

.github/ISSUE_TEMPLATE/bug_report.md

@@ -4,14 +4,14 @@ about: Create a report to help us improve
 title: ''
 labels: ''
 assignees: ''
-
 ---
 
 **Describe the bug**
 A clear and concise description of what the bug is.
 
 **To Reproduce**
 Steps to reproduce the behavior:
+
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
@@ -24,15 +24,17 @@ A clear and concise description of what you expected to happen.
 If applicable, add screenshots to help explain your problem.
 
 **Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
+
+- OS: [e.g. iOS]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
 
 **Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
+
+- Device: [e.g. iPhone6]
+- OS: [e.g. iOS8.1]
+- Browser [e.g. stock browser, safari]
+- Version [e.g. 22]
 
 **Additional context**
 Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -4,7 +4,6 @@ about: Suggest an idea for this project
 title: ''
 labels: ''
 assignees: ''
-
 ---
 
 **Is your feature request related to a problem? Please describe.**

.github/workflows/ci.yml

@@ -44,7 +44,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          fetch-depth: 0  # 获取完整历史用于增量覆盖率检查
+          fetch-depth: 0 # 获取完整历史用于增量覆盖率检查
 
       - name: Use Node.js 18.x
         uses: actions/setup-node@v4

.github/workflows/publish.yaml

@@ -6,7 +6,7 @@ on:
     branches:
       - '**'
     tags-ignore:
-      - '**'  # 忽略 tag push，避免与 release 事件重复触发
+      - '**' # 忽略 tag push，避免与 release 事件重复触发
 
   # GitHub Release 触发正式发布
   release:
@@ -21,8 +21,8 @@ on:
         default: 'test'
         type: choice
         options:
-          - official  # 正式发布
-          - test      # 测试发布
+          - official # 正式发布
+          - test # 测试发布
       version:
         description: '版本号（留空则自动递增）/ Version (leave empty for auto-increment)'
         required: false
@@ -33,9 +33,9 @@ on:
         default: 'patch'
         type: choice
         options:
-          - patch   # 0.0.1 -> 0.0.2
-          - minor   # 0.0.1 -> 0.1.0
-          - major   # 0.0.1 -> 1.0.0
+          - patch # 0.0.1 -> 0.0.2
+          - minor # 0.0.1 -> 0.1.0
+          - major # 0.0.1 -> 1.0.0
 
 jobs:
   # 等待 CI 测试通过（仅 push 触发时）
@@ -104,20 +104,20 @@ jobs:
           # 获取包名
           PACKAGE_NAME=$(node -p "require('./package.json').name")
           echo "PACKAGE_NAME=${PACKAGE_NAME}" >> $GITHUB_OUTPUT
-          
+
           # 获取基础版本号
           BASE_VERSION=$(node -p "require('./package.json').version")
-          
+
           # 生成唯一标识符：优先使用 run_id，否则使用时间戳
           if [ -n "${{ github.run_id }}" ]; then
             UNIQUE_ID="${{ github.run_id }}"
           else
             UNIQUE_ID=$(date +%Y%m%d%H%M%S)
           fi
-          
+
           # 生成 prerelease 版本号
           VERSION="${BASE_VERSION}-test.${UNIQUE_ID}"
-          
+
           echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
           echo "Test version: ${VERSION}"
 
@@ -148,12 +148,12 @@ jobs:
           PACKAGE_NAME="${{ steps.version.outputs.PACKAGE_NAME }}"
           VERSION="${{ steps.version.outputs.VERSION }}"
           echo "Publishing ${PACKAGE_NAME}@${VERSION} with tag=test"
-          
+
           # Remove any .npmrc that might interfere with OIDC
           rm -f ~/.npmrc
           rm -f .npmrc
           rm -f /home/runner/work/_temp/.npmrc
-          
+
           # Publish using Trusted Publishers (OIDC)
           npm publish --tag test --access public --provenance
         env:
@@ -211,7 +211,7 @@ jobs:
         run: |
           PACKAGE_NAME=$(node -p "require('./package.json').name")
           echo "PACKAGE_NAME=${PACKAGE_NAME}" >> $GITHUB_OUTPUT
-          
+
           # 确定版本号
           if [ "${{ github.event_name }}" = "release" ]; then
             VERSION="${{ github.event.release.tag_name }}"
@@ -254,7 +254,7 @@ jobs:
               VERSION="${MAJOR}.${MINOR}.${PATCH}"
             fi
           fi
-          
+
           echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
           echo "Official version: ${VERSION}"
 
@@ -297,12 +297,12 @@ jobs:
           PACKAGE_NAME="${{ steps.config.outputs.PACKAGE_NAME }}"
           VERSION="${{ steps.config.outputs.VERSION }}"
           echo "Publishing ${PACKAGE_NAME}@${VERSION} with tag=latest"
-          
+
           # Remove any .npmrc that might interfere with OIDC
           rm -f ~/.npmrc
           rm -f .npmrc
           rm -f /home/runner/work/_temp/.npmrc
-          
+
           # Publish using Trusted Publishers (OIDC)
           npm publish --tag latest --access public --provenance
         env:
@@ -357,7 +357,7 @@ jobs:
         run: |
           PACKAGE_NAME=$(node -p "require('./package.json').name")
           echo "PACKAGE_NAME=${PACKAGE_NAME}" >> $GITHUB_OUTPUT
-          
+
           VERSION="${{ inputs.version }}"
           if [ -z "$VERSION" ]; then
             # 自动生成测试版本号
@@ -372,7 +372,7 @@ jobs:
             
             VERSION="${BASE_VERSION}-test.${UNIQUE_ID}"
           fi
-          
+
           echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
           echo "Test version: ${VERSION}"
 
@@ -401,12 +401,12 @@ jobs:
           PACKAGE_NAME="${{ steps.version.outputs.PACKAGE_NAME }}"
           VERSION="${{ steps.version.outputs.VERSION }}"
           echo "Publishing ${PACKAGE_NAME}@${VERSION} with tag=test"
-          
+
           # Remove any .npmrc that might interfere with OIDC
           rm -f ~/.npmrc
           rm -f .npmrc
           rm -f /home/runner/work/_temp/.npmrc
-          
+
           # Publish using Trusted Publishers (OIDC)
           npm publish --tag test --access public --provenance
         env:

.prettierignore

@@ -0,0 +1,131 @@
+# Dependencies
+node_modules/
+bun.lock
+
+# Build outputs
+dist/
+coverage/
+*.tsbuildinfo
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+public
+
+# Storybook build outputs
+.out
+.storybook-out
+
+# Temporary folders
+tmp/
+temp/
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# OS generated files
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Jest coverage
+coverage/
+
+# TypeScript
+*.tsbuildinfo
+
+# Optional stylelint cache
+.stylelintcache
+
+# VS Code
+.vscode/settings.json
+.vscode/launch.json
+
+# Local development
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+.pytest_cache/
+__pycache__/
+*.pyc
+
+# Build artifacts
+build/
+out/
+
+# Lock files (keep package-lock.json)
+yarn.lock
+pnpm-lock.yaml
+
+# Generated files
+codegen/
+scripts/inject-version-check.mjs

.prettierrc

@@ -0,0 +1,29 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": true,
+  "overrides": [
+    {
+      "files": "*.json",
+      "options": {
+        "printWidth": 200
+      }
+    },
+    {
+      "files": "*.md",
+      "options": {
+        "printWidth": 80,
+        "proseWrap": "preserve"
+      }
+    }
+  ]
+}