Merge branch: comprehensive UI refinement and code quality improvements

.eslintignore

@@ -0,0 +1,18 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+build/
+
+# Vendor files
+src/site/vendor/
+
+# Minified files
+*.min.js
+
+# Cache
+.cache/
+
+# Logs
+*.log

.prettierignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Build output
+dist/
+build/
+
+# Vendor files
+src/site/vendor/
+
+# Cache
+.cache/
+*.log
+
+# Environment
+.env
+.env.*
+
+# Large media files
+*.mp4
+*.webm
+*.mov
+*.mp3
+*.wav
+*.flac
+*.zip
+*.tar.gz
+*.rar

.prettierrc

@@ -0,0 +1,35 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "useTabs": false,
+  "printWidth": 100,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "quoteProps": "as-needed",
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "css",
+  "embeddedLanguageFormatting": "auto",
+  "overrides": [
+    {
+      "files": "*.json",
+      "options": {
+        "printWidth": 80
+      }
+    },
+    {
+      "files": "*.scss",
+      "options": {
+        "singleQuote": false
+      }
+    },
+    {
+      "files": "*.css",
+      "options": {
+        "singleQuote": false
+      }
+    }
+  ]
+}

.stylelintrc.json

@@ -0,0 +1,35 @@
+{
+  "extends": ["stylelint-config-standard-scss"],
+  "plugins": ["stylelint-scss"],
+  "rules": {
+    "color-function-notation": null,
+    "alpha-value-notation": null,
+    "color-named": null,
+    "font-weight-notation": null,
+    "media-feature-range-notation": null,
+    "declaration-block-no-duplicate-properties": null,
+    "declaration-block-no-redundant-longhand-properties": null,
+    "declaration-block-no-shorthand-property-overrides": null,
+    "declaration-empty-line-before": null,
+    "comment-empty-line-before": null,
+    "scss/selector-no-redundant-nesting-selector": null,
+    "function-url-quotes": "always",
+    "length-zero-no-unit": true,
+    "shorthand-property-no-redundant-values": true,
+    "property-no-vendor-prefix": null,
+    "selector-class-pattern": null,
+    "selector-id-pattern": null,
+    "keyframes-name-pattern": null,
+    "custom-property-empty-line-before": null,
+    "scss/double-slash-comment-empty-line-before": null,
+    "comment-whitespace-inside": null,
+    "property-no-deprecated": null,
+    "no-duplicate-selectors": null
+  },
+  "ignoreFiles": [
+    "dist/**/*",
+    "node_modules/**/*",
+    "src/site/vendor/**/*",
+    "**/*.min.css"
+  ]
+}

eslint.config.js

@@ -0,0 +1,99 @@
+const js = require('@eslint/js');
+const globals = require('globals');
+const prettier = require('eslint-config-prettier');
+
+module.exports = [
+  js.configs.recommended,
+  prettier,
+  {
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'commonjs',
+      globals: {
+        ...globals.node,
+        ...globals.browser,
+        ...globals.es2021,
+      },
+    },
+    rules: {
+      // 错误预防
+      'no-console': 'off',
+      'no-debugger': 'warn',
+      'no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+      'no-undef': 'error',
+      'no-unreachable': 'error',
+      'no-dupe-keys': 'error',
+      'no-dupe-args': 'error',
+      'no-extra-semi': 'warn',
+      'no-func-assign': 'error',
+      'no-obj-calls': 'error',
+      'no-sparse-arrays': 'warn',
+      'valid-typeof': 'error',
+
+      // 最佳实践
+      'eqeqeq': ['warn', 'smart'],
+      'curly': ['warn', 'multi-line'],
+      'no-eval': 'error',
+      'no-implied-eval': 'error',
+      'no-new-func': 'error',
+      'no-return-assign': 'warn',
+      'no-script-url': 'error',
+      'no-self-compare': 'error',
+      'no-sequences': 'warn',
+      'no-throw-literal': 'warn',
+      'no-unused-expressions': 'off',
+      'no-useless-call': 'warn',
+      'no-useless-concat': 'warn',
+      'no-void': 'warn',
+      'wrap-iife': ['warn', 'inside'],
+
+      // 变量声明
+      'no-use-before-define': ['error', { functions: false, classes: true }],
+      'no-var': 'warn',
+      'prefer-const': 'warn',
+
+      // 代码风格 (由 Prettier 处理大部分)
+      'semi': ['warn', 'always'],
+      'quotes': ['warn', 'single', { avoidEscape: true, allowTemplateLiterals: true }],
+      'indent': 'off', // 由 Prettier 处理
+      'linebreak-style': 'off',
+
+      // Node.js 特定
+      'no-process-exit': 'off',
+      'no-sync': 'off',
+    },
+  },
+  {
+    // 浏览器脚本特定配置
+    files: ['src/site/scripts/**/*.js'],
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        'mermaid': 'readonly',
+        'ForceGraph': 'readonly',
+        'lucide': 'readonly',
+        'Alpine': 'readonly',
+        'FlexSearch': 'readonly',
+      },
+    },
+    rules: {
+      'no-console': 'off',
+    },
+  },
+  {
+    // 测试文件和配置文件忽略某些规则
+    files: ['*.config.js', '*.config.mjs'],
+    rules: {
+      'no-console': 'off',
+    },
+  },
+  {
+    // 忽略的文件
+    ignores: [
+      'dist/**',
+      'node_modules/**',
+      'src/site/vendor/**',
+      '*.min.js',
+    ],
+  },
+];