@apdesign/code-style-react 1.0.0

package/.eslintrc.build.js

@@ -0,0 +1,91 @@
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    node: true,
+    es2021: true,
+  },
+  parser: '@typescript-eslint/parser',
+  extends: [
+    'airbnb',
+    'airbnb/hooks',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:import/errors',
+    'plugin:import/warnings',
+    'prettier',
+  ],
+  plugins: ['@typescript-eslint', 'import', 'jsx-a11y', 'react', 'react-hooks'],
+  rules: {
+    'arrow-body-style': 'off',
+
+    camelcase: 'off',
+    'class-methods-use-this': 'off',
+
+    'import/first': 'off',
+    'import/extensions': 'off',
+    'import/prefer-default-export': 'off',
+
+    'jsx-a11y/click-events-have-key-events': 'off',
+    'jsx-a11y/no-static-element-interactions': 'off',
+    'jsx-a11y/no-noninteractive-element-interactions': 'off',
+
+    'linebreak-style': 'off',
+
+    'max-classes-per-file': 'off',
+
+    'no-undef': 'off',
+    'no-plusplus': 'off',
+
+    'react/function-component-definition': 'off',
+    'react-hooks/exhaustive-deps': 'off',
+    'react/prop-types': 'off',
+    'react/react-in-jsx-scope': 'off',
+    'react/require-default-props': 'off',
+    'react/jsx-boolean-value': 'off',
+    'react/jsx-filename-extension': 'off',
+    'react/jsx-props-no-spreading': 'off',
+    'react/self-closing-comp': 'off',
+    'react/jsx-no-useless-fragment': 'off',
+
+    'no-unused-vars': 'off',
+    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+
+    'no-useless-constructor': 'off',
+    '@typescript-eslint/no-useless-constructor': 'warn',
+
+    'no-shadow': 'off',
+    '@typescript-eslint/no-shadow': 'warn',
+
+    'no-empty-function': ['warn', { allow: ['constructors'] }],
+    'no-param-reassign': ['warn', { props: true, ignorePropertyModificationsFor: ['draft'] }],
+    'no-restricted-syntax': [
+      'warn',
+      {
+        selector: "CallExpression[callee.name='useMemo']",
+        message: 'Avoid using useMemo unless caching a computed value improves performance.',
+      },
+      {
+        selector: "CallExpression[callee.name='useCallback']",
+        message:
+          'Avoid using useCallback unless you need to cache a function to prevent unnecessary re-renders.',
+      },
+    ],
+  },
+  parserOptions: {
+    sourceType: 'module',
+  },
+  ignorePatterns: ['dist/', 'node_modules/', '*.d.ts', 'mock', '.eslintrc.cjs'],
+  settings: {
+    react: {
+      version: 'detect',
+    },
+    'import/resolver': {
+      alias: {
+        map: [
+          ['@', './src'], // 将 '@' 映射到 'src' 目录
+        ],
+        extensions: ['.ts', '.tsx', '.js', '.jsx', '.d.ts'],
+      },
+    },
+  },
+};

package/.eslintrc.js

@@ -0,0 +1,91 @@
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    node: true,
+    es2021: true,
+  },
+  parser: '@typescript-eslint/parser',
+  extends: [
+    'airbnb',
+    'airbnb/hooks',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:import/errors',
+    'plugin:import/warnings',
+    'prettier',
+  ],
+  plugins: ['@typescript-eslint', 'import', 'jsx-a11y', 'react', 'react-hooks'],
+  rules: {
+    'arrow-body-style': 'off',
+
+    camelcase: 'off',
+    'class-methods-use-this': 'off',
+
+    'import/first': 'off',
+    'import/extensions': 'off',
+    'import/prefer-default-export': 'off',
+
+    'jsx-a11y/click-events-have-key-events': 'off',
+    'jsx-a11y/no-static-element-interactions': 'off',
+    'jsx-a11y/no-noninteractive-element-interactions': 'off',
+
+    'linebreak-style': 'off',
+
+    'max-classes-per-file': 'off',
+
+    'no-undef': 'off',
+    'no-plusplus': 'off',
+
+    'react/function-component-definition': 'off',
+    'react-hooks/exhaustive-deps': 'off',
+    'react/prop-types': 'off',
+    'react/react-in-jsx-scope': 'off',
+    'react/require-default-props': 'off',
+    'react/jsx-boolean-value': 'off',
+    'react/jsx-filename-extension': 'off',
+    'react/jsx-props-no-spreading': 'off',
+    'react/self-closing-comp': 'off',
+    'react/jsx-no-useless-fragment': 'off',
+
+    'no-unused-vars': 'off',
+    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+
+    'no-useless-constructor': 'off',
+    '@typescript-eslint/no-useless-constructor': 'error',
+
+    'no-shadow': 'off',
+    '@typescript-eslint/no-shadow': 'error',
+
+    'no-empty-function': ['error', { allow: ['constructors'] }],
+    'no-param-reassign': ['error', { props: true, ignorePropertyModificationsFor: ['draft'] }],
+    'no-restricted-syntax': [
+      'warn',
+      {
+        selector: "CallExpression[callee.name='useMemo']",
+        message: 'Avoid using useMemo unless caching a computed value improves performance.',
+      },
+      {
+        selector: "CallExpression[callee.name='useCallback']",
+        message:
+          'Avoid using useCallback unless you need to cache a function to prevent unnecessary re-renders.',
+      },
+    ],
+  },
+  parserOptions: {
+    sourceType: 'module',
+  },
+  ignorePatterns: ['dist/', 'node_modules/', '*.d.ts', 'mock', '.eslintrc.cjs'],
+  settings: {
+    react: {
+      version: 'detect',
+    },
+    'import/resolver': {
+      alias: {
+        map: [
+          ['@', './src'], // 将 '@' 映射到 'src' 目录
+        ],
+        extensions: ['.ts', '.tsx', '.js', '.jsx', '.d.ts'],
+      },
+    },
+  },
+};

package/.prettierrc.js

@@ -0,0 +1,11 @@
+module.exports = {
+  useTabs: false,
+  tabWidth: 2,
+  printWidth: 100,
+  singleQuote: true,
+  trailingComma: 'all',
+  bracketSpacing: true,
+  semi: true,
+  embeddedLanguageFormatting: 'auto',
+  jsxSingleQuote: true,
+};

package/.stylelintrc.js

@@ -0,0 +1,23 @@
+module.exports = {
+  extends: ['stylelint-config-standard'],
+  plugins: ['stylelint-less', 'stylelint-scss'],
+  overrides: [
+    {
+      files: ['**/*.less'],
+      customSyntax: 'postcss-less',
+    },
+    {
+      files: ['**/*.scss', '**/*.sass'],
+      customSyntax: 'postcss-less',
+    },
+  ],
+  rules: {
+    'selector-class-pattern': '^[a-z][a-zA-Z0-9-]*$',
+    'selector-pseudo-class-no-unknown': [
+      true,
+      {
+        ignorePseudoClasses: ['global'],
+      },
+    ],
+  },
+};

package/husky/_/h

@@ -0,0 +1,27 @@
+#!/usr/bin/env sh
+[ "$HUSKY" = "2" ] && set -x
+n=$(basename "$0")
+s=$(dirname "$(dirname "$0")")/$n
+
+if [[ "$(uname)" == "Darwin" ]]; then
+elif [[ "$(uname -o)" == "Msys" || "$(uname)" == "CYGWIN" || "$(uname)" == "MINGW"* ]]; then
+  sed -i 's/\r//' "$0"
+fi
+
+[ ! -f "$s" ] && exit 0
+
+if [ -f "$HOME/.huskyrc" ]; then
+	echo "husky - '~/.huskyrc' is DEPRECATED, please move your code to ~/.config/husky/init.sh"
+fi
+i="${XDG_CONFIG_HOME:-$HOME/.config}/husky/init.sh"
+[ -f "$i" ] && . "$i"
+
+[ "${HUSKY-}" = "0" ] && exit 0
+
+export PATH="node_modules/.bin:$PATH"
+sh -e "$s" "$@"
+c=$?
+
+[ $c != 0 ] && echo "husky - $n script failed (code $c)"
+[ $c = 127 ] && echo "husky - command not found in PATH=$PATH"
+exit $c

package/husky/_/pre-commit

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+. "$(dirname "$0")/h"

package/husky/_/pre-push

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+. "$(dirname "$0")/h"

package/husky/pre-commit

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

package/husky/pre-push

@@ -0,0 +1,25 @@
+#!/usr/bin/env sh
+branch_name=$(git symbolic-ref --short HEAD)
+
+branch_regex_master="^master$"
+branch_regex_env="^(master|uat|dev)-[a-z]+$"
+branch_regex_feature="^(feature|test|hotfix)-[a-z]+-[a-zA-Z0-9]+(-[A-Z]+[0-9]+)?$"
+branch_regex_release="^release-[a-z]+-[0-9]{8}$"
+
+if echo "$branch_name" | grep -Eq "$branch_regex_master"; then
+  exit 0
+elif echo "$branch_name" | grep -Eq "$branch_regex_env"; then
+  exit 0
+elif echo "$branch_name" | grep -Eq "$branch_regex_feature"; then
+  exit 0
+elif echo "$branch_name" | grep -Eq "$branch_regex_release"; then
+  exit 0
+else
+  echo -e "❌ \033[31m[ERROR] 当前分支名 '$branch_name' 不符合规范！\033[0m"
+  echo "分支命名规范要求如下："
+  echo "✅ master"
+  echo "✅ master|uat|dev-[小写字母]"
+  echo "✅ feature|test|hotfix-[小写字母]+-[字母或数字]+（可选 -大写字母+数字）"
+  echo "✅ release-[小写字母]+-8位日期"
+  exit 1
+fi

package/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+const initHusky = require('./scripts/initHusky');
+const initScripts = require('./scripts/initScripts');
+const initConfigs = require('./scripts/initConfigs');
+
+function main() {
+  initHusky();
+  initScripts();
+  initConfigs();
+}
+
+main();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@apdesign/code-style-react",
+  "version": "1.0.0",
+  "scripts": {},
+  "files": [
+    "index.js",
+    ".prettierrc.js",
+    ".eslintrc.js",
+    ".eslintrc.build.js",
+    ".stylelintrc.js",
+    "husky",
+    "scripts"
+  ],
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "eslint": "^8.57.1",
+    "eslint-config-airbnb": "^19.0.4",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-import-resolver-alias": "^1.1.2",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-react": "^7.37.2",
+    "eslint-plugin-react-hooks": "^4.6.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.3.0",
+    "postcss-less": "^6.0.0",
+    "prettier": "^3.3.3",
+    "stylelint": "^16.19.1",
+    "stylelint-config-standard": "^38.0.0",
+    "stylelint-less": "^3.0.1",
+    "stylelint-scss": "^6.12.0"
+  }
+}

package/scripts/buildEslint.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env sh
+echo "🔍 Starting ESLint check (Git diff files only)..."
+
+DIFF_FILES=$(git diff --name-only origin/master...HEAD -- '*.ts' '*.tsx' '*.js' '*.jsx')
+
+if [ -z "$DIFF_FILES" ]; then
+  echo "✅ No matching file changes detected, skipping ESLint check"
+  exit 0
+fi
+
+echo "📂 Changed files:"
+echo "$DIFF_FILES"
+
+npx eslint --config .eslintrc.build.cjs $DIFF_FILES \
+  --no-error-on-unmatched-pattern \
+  --report-unused-disable-directives
+
+if [ $? -ne 0 ]; then
+  echo "❌ ESLint check failed. Aborting build process"
+  exit 1
+fi
+
+echo "✅ ESLint check passed"

package/scripts/buildStylelint.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env sh
+echo "🔍 Starting Stylelint check (Git diff files only)..."
+
+DIFF_FILES=$(git diff --name-only origin/master...HEAD -- '*.css' '*.scss' '*.sass' '*.less')
+
+if [ -z "$DIFF_FILES" ]; then
+  echo "✅ No style file changes detected, skipping Stylelint check"
+  exit 0
+fi
+
+echo "📂 Changed files:"
+echo "$DIFF_FILES"
+
+npx stylelint $DIFF_FILES \
+  --allow-empty-input \
+  --report-needless-disables \
+  --report-invalid-scope-disables
+
+if [ $? -ne 0 ]; then
+  echo "❌ Stylelint check failed. Aborting build process"
+  exit 1
+fi
+
+echo "✅ Stylelint check passed"

package/scripts/initConfigs.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+function fileExists(filepath) {
+  try {
+    return fs.existsSync(filepath);
+  } catch (err) {
+    console.error(`❌ Check whether there are any errors in the file: ${filepath}`, err);
+    return false;
+  }
+}
+
+function createIfNotExists(filename, content) {
+  const filepath = path.resolve(process.cwd(), filename);
+  try {
+    if (!fs.existsSync(filepath)) {
+      fs.writeFileSync(filepath, content, { encoding: 'utf-8' });
+      console.log(`✅ The ${filename} has been created`);
+    }
+  } catch (err) {
+    console.error(`❌ Failed to create the file: ${filename}`, err);
+  }
+}
+
+function hasAnyFileExist(files) {
+  const cwd = process.cwd();
+  return files.some((file) => fileExists(path.join(cwd, file)));
+}
+
+function initConfigs() {
+  const eslintConfigFiles = [
+    '.eslintrc.js',
+    '.eslintrc.cjs',
+    '.eslintrc.json',
+    '.eslintrc.yaml',
+    '.eslintrc.yml',
+    '.eslintrc',
+    'eslint.config.js',
+  ];
+
+  const stylelintConfigFiles = [
+    '.stylelintrc.js',
+    '.stylelintrc.cjs',
+    '.stylelintrc.json',
+    '.stylelintrc.yaml',
+    '.stylelintrc.yml',
+    '.stylelintrc',
+    'stylelint.config.js',
+  ];
+
+  const prettierConfigFiles = [
+    '.prettierrc',
+    '.prettierrc.js',
+    '.prettierrc.cjs',
+    '.prettierrc.json',
+    '.prettierrc.yaml',
+    '.prettierrc.yml',
+    'prettier.config.js',
+  ];
+
+  try {
+    if (!hasAnyFileExist(eslintConfigFiles)) {
+      const eslintContent = `const baseConfig = require('@apdesign/rule-react/.eslintrc.js');
+module.exports = {
+  ...baseConfig,
+  rules: {
+    ...baseConfig.rules,
+  },
+};`;
+      createIfNotExists('.eslintrc.cjs', eslintContent);
+    }
+
+    if (!hasAnyFileExist(stylelintConfigFiles)) {
+      const stylelintContent = `const baseConfig = require('@apdesign/rule-react/.stylelintrc.js');
+module.exports = {
+  ...baseConfig,
+  rules: {
+    ...baseConfig.rules,
+  },
+};`;
+      createIfNotExists('.stylelintrc.cjs', stylelintContent);
+    }
+
+    if (!hasAnyFileExist(prettierConfigFiles)) {
+      const prettierContent = `const baseConfig = require('@apdesign/rule-react/.prettierrc.js');
+module.exports = {
+  ...baseConfig
+};`;
+      createIfNotExists('.prettierrc.cjs', prettierContent);
+    }
+  } catch (err) {
+    console.error('❌ Failed to initialize configuration:', err);
+  }
+}
+
+module.exports = initConfigs;

package/scripts/initHusky.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+function initHusky() {
+  const projectRoot = process.cwd();
+  const huskyTarget = path.join(projectRoot, '.husky');
+  const huskySource = path.join(__dirname, '../husky');
+
+  try {
+    if (fs.existsSync(huskyTarget)) {
+      fs.rmSync(huskyTarget, { recursive: true, force: true });
+    }
+    fs.cpSync(huskySource, huskyTarget, { recursive: true });
+
+    fs.readdirSync(huskyTarget).forEach((file) => {
+      const filePath = path.join(huskyTarget, file);
+      if (fs.statSync(filePath).isFile()) {
+        fs.chmodSync(filePath, 0o755);
+      }
+    });
+
+    execSync('git config core.hooksPath .husky');
+
+    console.log('✅ Husky hooks installed from @apdesign/rule-react');
+  } catch (err) {
+    console.error('❌ Failed to initialize husky:', err);
+  }
+}
+
+module.exports = initHusky;

package/scripts/initScripts.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+function initScripts() {
+  const projectRoot = process.cwd();
+  const projectScriptsDir = path.join(projectRoot, 'scripts');
+  const packageScriptsDir = path.join(__dirname, '../scripts');
+
+  try {
+    if (!fs.existsSync(projectScriptsDir)) {
+      fs.mkdirSync(projectScriptsDir, { recursive: true });
+      console.log('📁 Created scripts directory in project');
+    }
+
+    fs.readdirSync(packageScriptsDir)
+      .filter((file) => file.endsWith('.sh'))
+      .forEach((file) => {
+        const srcFile = path.join(packageScriptsDir, file);
+        const destFile = path.join(projectScriptsDir, file);
+
+        if (fs.existsSync(destFile)) {
+          return;
+        }
+
+        fs.copyFileSync(srcFile, destFile);
+        fs.chmodSync(destFile, 0o755);
+        console.log(`📄 Copied ${file} to scripts/`);
+      });
+  } catch (err) {
+    console.error('❌ Failed to initialize scripts:', err);
+  }
+}
+
+module.exports = initScripts;