sync the code

Author: zmofei

.cz.json

@@ -0,0 +1,10 @@
+{
+  "commitizen": {
+    "name": "cz_conventional_commits",
+    "tag_format": "v$version",
+    "version_scheme": "semver",
+    "version_provider": "npm",
+    "update_changelog_on_bump": true,
+    "major_version_zero": true
+  }
+}

.dockerignore

@@ -0,0 +1,8 @@
+node_modules
+npm-debug.log
+dist
+coverage
+.git
+.github
+.husky
+.vscode

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/general.yaml

@@ -0,0 +1,57 @@
+name: General Issue
+description: Report a bug, request a feature, or propose a task
+title: "[Issue] <brief summary>"
+labels: [needs-triage]
+body:
+  - type: dropdown
+    id: type
+    attributes:
+      label: Type of Issue
+      description: What kind of issue is being reported?
+      options:
+        - Bug Report
+        - Feature Request
+        - Refactor / Cleanup
+        - Documentation
+        - Question
+    validations:
+      required: true
+
+  - type: input
+    id: context
+    attributes:
+      label: Context or Problem
+      description: What was observed or what problem is this issue addressing?
+      placeholder: e.g., "The tool crashes when..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce or Task Description
+      description: Provide a clear sequence of actions to replicate the issue or complete the task.
+      placeholder: |
+        1. Open the app
+        2. Click "Run"
+        3. Observe error message
+    validations:
+      required: false
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Outcome
+      description: What was expected to happen?
+      placeholder: "The tool should complete without errors..."
+    validations:
+      required: false
+
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional Notes or References
+      description: Include logs, screenshots, or links that support this issue.
+      placeholder: "Logs, screenshots, related issues, design notes..."
+    validations:
+      required: false

.github/pull_request_template.md

@@ -0,0 +1,25 @@
+## Description
+
+<!-- Provide a clear explanation of what has been implemented or fixed. Mention any related context, requirements, or issues. -->
+
+- Closes #[issue-number] (if applicable)
+
+---
+
+## Testing
+
+<!-- Include logs, screenshots, terminal output, or any relevant proof of successful testing. -->
+
+---
+
+## Checklist
+
+- [ ] Code has been tested locally
+- [ ] Unit tests have been added or updated
+- [ ] Documentation has been updated if needed
+
+---
+
+## Additional Notes
+
+<!-- Include any further details, follow-up items, or decisions relevant to the reviewer. -->

.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: Run Tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Check formatting
+        run: npm run format
+
+      - name: Compile typescript
+        run: npm run build
+
+      - name: Run tests
+        run: npm test

.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+*.log
+.DS_Store
+.env
+.env.local
+.env.*.local

.husky/pre-commit

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx lint-staged

.husky/setup-hooks.js

@@ -0,0 +1,39 @@
+/*global console*/
+import { writeFileSync, mkdirSync, chmodSync, constants } from 'fs';
+import { execSync } from 'child_process';
+import { platform } from 'os';
+
+mkdirSync('.husky', { recursive: true });
+
+execSync('git config core.hooksPath .husky');
+
+writeFileSync(
+  '.husky/pre-commit',
+  `#!/usr/bin/env sh
+npx lint-staged`
+);
+
+// Cross-platform way to make the file executable
+if (platform() === 'win32') {
+  // On Windows, executable permissions don't matter as much
+  console.log('pre-commit script created.');
+} else {
+  // On Unix systems, use chmod
+  try {
+    execSync('chmod +x .husky/pre-commit');
+    console.log('pre-commit script created.');
+  } catch {
+    // Fallback to Node.js fs.chmodSync if available
+    try {
+      chmodSync(
+        '.husky/pre-commit',
+        constants.S_IRWXU | constants.S_IRGRP | constants.S_IXGRP
+      ); // 0o750
+      console.log('pre-commit script created.');
+    } catch {
+      console.warn(
+        'Warning: Could not set executable permissions on the hook file'
+      );
+    }
+  }
+}

.nvmrc

@@ -0,0 +1 @@
+v22