@ovh-ux/manager-static-analysis-kit 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [0.2.0](https://github.com/ovh/manager/compare/@ovh-ux/manager-static-analysis-kit@0.1.0...@ovh-ux/manager-static-analysis-kit@0.2.0) (2025-07-17)
+
+
+### Features
+
+* make static analysis kit public ([a998745](https://github.com/ovh/manager/commit/a998745cfb3101df0cab7a4530bca7cd87fc7025)), closes [#MANAGER-17954](https://github.com/ovh/manager/issues/MANAGER-17954)
+
+
+
+
+
+# [0.1.0](https://github.com/ovh/manager/compare/@ovh-ux/manager-static-analysis-kit@0.0.1...@ovh-ux/manager-static-analysis-kit@0.1.0) (2025-07-17)
+
+
+### Features
+
+* static analysis kit v1 - socle, architecture, eslint, tsconfig and deps ([5771071](https://github.com/ovh/manager/commit/577107168272904bf8a7a53a14a40b9ae52916ab)), closes [#MANAGER-17954](https://github.com/ovh/manager/issues/MANAGER-17954)

package/README.md

@@ -0,0 +1,108 @@
+# 🧪static-analysis-kit
+
+A modular, extensible, and future-ready toolkit for defining, adapting, and sharing static analysis rules across projects in the `manager` monorepo.
+
+---
+
+## 🚀 What Is It?
+
+`static-analysis-kit` provides a unified platform for code quality, complexity, duplication, and architectural analysis. It separates semantic rule definitions from tool-specific integrations using a clean adapter-based architecture.
+
+It currently supports:
+- ESLint (flat config)
+- Madge (dependency graph & circular analysis)
+- JSCPD (code duplication detection)
+- Code Health Meter (complexity, Halstead, maintainability, SLOC, architecture)
+
+---
+
+## 🎯 Why We Built This
+
+- Reuse rules across projects and tools
+- Avoid duplication of `.eslintrc`, `.prettierrc`, `.madgerc`, etc.
+- Standardize how we measure code health and enforce architectural boundaries
+- Enable safe and gradual migration to new tooling
+
+---
+
+## 🧱 Structure Overview
+
+```
+static-analysis-kit/
+├── src/
+│   ├── code-analysis.ts               # Central entry point (exports adapters)
+│   ├── configs/                       # Tool-agnostic semantic rule definitions
+│   │   ├── complexity.ts
+│   │   ├── madge-options.ts
+│   │   └── jscpd-options.ts
+│   └── adapters/
+│       ├── eslint/                    # ESLint flat config + rules
+│       │   ├── config/
+│       │   │   └── eslint.config.ts
+│       │   └── rules/
+│       ├── madge/                     # Madge analysis adapter
+│       ├── jscpd/                     # JSCPD (duplication) adapter
+│       ├── prettier/                  # Optional: shared formatting config
+│       └── code-health-meter/         # Halstead, MI, Cyclomatic, SLOC
+```
+
+---
+
+## 🛠️ Usage in an App
+
+```ts
+// apps/zimbra/eslint.config.ts
+import { eslintConfig } from '@ovh-ux/manager-static-analysis-kit';
+
+export default [...eslintConfig];
+```
+
+This will apply all enabled ESLint rule groups from the toolkit, using flat config format (ESLint v8+).
+
+```ts
+// apps/zimbra/prettier.config.ts
+import { prettierConfig } from '@ovh-ux/manager-static-analysis-kit';
+
+export default [...prettierConfig];
+```
+
+---
+
+## 🧠 Design Principles
+
+- **Composable**: Adapters are modular, rules are grouped by category
+- **Decoupled**: Semantic configs live separately from tool logic
+- **Pluggable**: Easy to add new tools (e.g. Biome, Oxlint)
+- **Testable**: Configs are plain TS, easy to mock and verify
+
+---
+
+## 🔮 Future Flexibility
+
+This architecture is designed to easily accommodate:
+
+- `biome/` adapter (Rust-based formatter/linter)
+- `oxlint/` adapter (high-performance Rust linter)
+- `depcruise/`, `pmd/`, `stylelint/` or internal tools
+
+Each would follow the same adapter pattern and pull from shared `configs/` where applicable.
+
+---
+
+## 🧑‍💻 Contributing
+
+If you’re adding a new rule or adapter:
+
+1. Put semantic/shared config in `configs/` if reusable.
+2. Create a new adapter directory in `adapters/` (e.g., `eslint`, `madge`).
+3. Add a domain-specific config, transformer, or wrapper.
+4. Wire into `code-analysis.ts` as needed.
+5. Document your addition.
+
+---
+
+## 📬 Feedback Welcome
+
+The goal is to create a robust, composable, and organization-wide standard for static analysis.
+
+Feel free to suggest improvements or new integrations!

package/bin/lint-cli.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { dirname, resolve, join } from 'path';
+import { cwd } from 'process';
+import { existsSync } from 'fs';
+
+// eslint-disable-next-line no-underscore-dangle
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const userCwd = cwd();
+const eslintBin = resolve(__dirname, '../node_modules/.bin/eslint');
+
+const args = process.argv.slice(2);
+const hasExplicitConfigArg = args.includes('--config');
+const localConfigPath = join(userCwd, 'eslint.config.ts');
+const sharedDefaultPath = resolve(__dirname, '../dist/adapters/eslint/config/eslint.config.js');
+const hasLocalConfig = existsSync(localConfigPath);
+
+// Determine effective config path
+// eslint-disable-next-line no-nested-ternary
+const configPath = hasExplicitConfigArg
+  ? args[args.indexOf('--config') + 1]
+  : hasLocalConfig
+    ? localConfigPath
+    : sharedDefaultPath;
+
+// Helper: wrap spawn in a promise
+function runLint(command, args, cwd) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: 'inherit',
+      cwd,
+      shell: true,
+    });
+
+    child.on('error', (err) => {
+      console.error('[manager-lint] Failed to run ESLint');
+      console.error(err);
+      reject(1);
+    });
+
+    child.on('close', (code) => {
+      resolve(code ?? 1);
+    });
+  });
+}
+
+(async () => {
+  // Handle --print-config
+  if (args.includes('--print-config')) {
+    const url = pathToFileURL(configPath).href;
+    try {
+      const mod = await import(url);
+      const configContent = mod.default ?? mod;
+      console.log('[manager-lint] Loaded ESLint config from:', configPath);
+      console.dir(configContent, { depth: null });
+    } catch (err) {
+      console.error(`[manager-lint] Failed to load config at ${configPath}`);
+      console.error(err);
+      process.exit(1);
+    }
+    process.exit(0);
+  }
+
+  // Construct full args
+  const fullArgs = hasExplicitConfigArg || hasLocalConfig
+    ? args
+    : ['--config', sharedDefaultPath, ...args];
+
+  // Run ESLint using tsx and wait for completion
+  const exitCode = await runLint('tsx', [eslintBin, ...fullArgs], userCwd);
+  process.exit(exitCode);
+})();

package/eslint.config.mjs

@@ -0,0 +1,53 @@
+import { javascriptEslintConfig } from './src/adapters/eslint/rules/eslint-javascript'
+import { typescriptEslintConfig } from './src/adapters/eslint/rules/eslint-typescript';
+import { reactEslintConfig } from './src/adapters/eslint/rules/eslint-react';
+import { tanStackQueryEslintConfig } from './src/adapters/eslint/rules/eslint-tanstack';
+import { importEslintConfig } from './src/adapters/eslint/rules/eslint-imports';
+import { checkFileEslintConfig } from './src/adapters/eslint/rules/eslint-naming-conventions';
+import { vitestEslintConfig } from './src/adapters/eslint/rules/eslint-tests';
+import { prettierEslintConfig } from './src/adapters/eslint/rules/eslint-prettier';
+import { complexityJsxTsxConfig, complexityTsJsConfig } from './src/adapters/eslint/rules/eslint-complexity';
+
+export default [
+  javascriptEslintConfig,
+  typescriptEslintConfig,
+  reactEslintConfig,
+  tanStackQueryEslintConfig,
+  ...importEslintConfig,
+  ...checkFileEslintConfig,
+  vitestEslintConfig,
+  prettierEslintConfig,
+  complexityJsxTsxConfig,
+  complexityTsJsConfig,
+  {
+    ignores: [
+      '**/*.md',
+      '**/coverage/**',
+      '**/dist/**',
+      '**/*.d.ts',
+    ],
+  },
+  {
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+    },
+  },
+  {
+    files: ['**/prettier-config.ts', '**/*.config.{ts,js,mjs}'],
+    rules: {
+      'import/no-nodejs-modules': 'off',
+    },
+  },
+  {
+    files: [
+      '**/ts-config/config/standard/tsconfig.test.ts',
+      '**/ts-config/config/strict/tsconfig.test.ts',
+    ],
+    rules: {
+      'check-file/folder-match-with-fex': 'off',
+      'check-file/filename-naming-convention': 'off',
+    },
+  }
+];

package/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "@ovh-ux/manager-static-analysis-kit",
+  "version": "0.2.0",
+  "description": "A modular, extensible, and future-ready toolkit for defining, adapting, and sharing static analysis rules across projects in the `manager` monorepo.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ovh/manager.git",
+    "directory": "packages/manager/tools/static-analysis-kit"
+  },
+  "license": "BSD-3-Clause",
+  "author": "OVH SAS",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/code-analysis.js"
+    },
+    "./eslint/config": {
+      "import": "./dist/adapters/eslint/config/eslint-shared-config.js"
+    },
+    "./eslint/storybook": {
+      "import": "./dist/adapters/eslint/rules/eslint-storybook.js"
+    },
+    "./eslint/a11y": {
+      "import": "./dist/adapters/eslint/rules/eslint-a11y.js"
+    },
+    "./eslint/complexity": {
+      "import": "./dist/adapters/eslint/rules/eslint-complexity.js"
+    },
+    "./eslint/css": {
+      "import": "./dist/adapters/eslint/rules/eslint-css.js"
+    },
+    "./eslint/html": {
+      "import": "./dist/adapters/eslint/rules/eslint-html.js"
+    },
+    "./eslint/imports": {
+      "import": "./dist/adapters/eslint/rules/eslint-imports.js"
+    },
+    "./eslint/javascript": {
+      "import": "./dist/adapters/eslint/rules/eslint-javascript.js"
+    },
+    "./eslint/naming-conventions": {
+      "import": "./dist/adapters/eslint/rules/eslint-naming-conventions.js"
+    },
+    "./eslint/prettier": {
+      "import": "./dist/adapters/eslint/rules/eslint-prettier.js"
+    },
+    "./eslint/react": {
+      "import": "./dist/adapters/eslint/rules/eslint-react.js"
+    },
+    "./eslint/tailwind-jsx": {
+      "import": "./dist/adapters/eslint/rules/eslint-tailwind-jsx.js"
+    },
+    "./eslint/tanstack": {
+      "import": "./dist/adapters/eslint/rules/eslint-tanstack.js"
+    },
+    "./eslint/tests": {
+      "import": "./dist/adapters/eslint/rules/eslint-tests.js"
+    },
+    "./eslint/typescript": {
+      "import": "./dist/adapters/eslint/rules/eslint-typescript.js"
+    },
+    "./tsconfig/react": {
+      "default": "./dist/tsconfig/react.json"
+    },
+    "./tsconfig/node": {
+      "default": "./dist/tsconfig/node.json"
+    },
+    "./tsconfig/test": {
+      "default": "./dist/tsconfig/test.json"
+    },
+    "./tsconfig/react-strict": {
+      "default": "./dist/tsconfig/react-strict.json"
+    },
+    "./tsconfig/node-strict": {
+      "default": "./dist/tsconfig/node-strict.json"
+    },
+    "./tsconfig/test-strict": {
+      "default": "./dist/tsconfig/test-strict.json"
+    }
+  },
+  "main": "./dist/code-analysis.js",
+  "types": "./dist/code-analysis.d.ts",
+  "bin": {
+    "manager-lint": "./bin/lint-cli.js"
+  },
+  "scripts": {
+    "build": "tsx scripts/build.ts",
+    "lint:modern": "manager-lint --config eslint.config.mjs ./src",
+    "lint:modern:fix": "manager-lint --fix --config eslint.config.mjs ./src",
+    "test": "echo \"No tests yet.\" && exit 0"
+  },
+  "devDependencies": {
+    "@eslint/css": "^0.9.0",
+    "@eslint/js": "^9.29.0",
+    "@html-eslint/eslint-plugin": "^0.42.0",
+    "@html-eslint/parser": "^0.42.0",
+    "@tanstack/eslint-plugin-query": "^5.81.2",
+    "@trivago/prettier-plugin-sort-imports": "^5.2.2",
+    "@types/eslint": "^8.56.12",
+    "@types/eslint-plugin-tailwindcss": "^3.17.0",
+    "@types/node": "^24.0.4",
+    "@typescript-eslint/eslint-plugin": "^7.18.1-alpha.3",
+    "@typescript-eslint/parser": "^7.18.1-alpha.3",
+    "@vitest/eslint-plugin": "^1.3.3",
+    "eslint": "^9.29.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-check-file": "^3.3.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-prettier": "^5.0.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-storybook": "^9.0.13",
+    "eslint-plugin-tailwindcss": "^3.18.0",
+    "globals": "^16.2.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-tailwindcss": "^0.6.13",
+    "tailwind-csstree": "^0.1.1",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.35.0"
+  },
+  "peerDependencies": {
+    "eslint": "^9.29.0"
+  }
+}

package/scripts/build.ts

@@ -0,0 +1,44 @@
+import { execSync } from 'node:child_process';
+import { writeFileSync, rmSync, mkdirSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+(async () => {
+  // @ts-ignore
+  const root = resolve(import.meta.dirname, '..');
+  const dist = resolve(root, 'dist');
+
+  console.log('🧹 Cleaning dist...');
+  rmSync(dist, { recursive: true, force: true });
+
+  console.log('🛠️  Building TypeScript...');
+  execSync('tsc --project tsconfig.json', { stdio: 'inherit' });
+
+  console.log('📦 Flattening TypeScript config files...');
+
+  const configs: [string, string][] = [
+    ['src/adapters/ts-config/config/standard/tsconfig.react.ts', 'tsconfig/react.json'],
+    ['src/adapters/ts-config/config/standard/tsconfig.node.ts', 'tsconfig/node.json'],
+    ['src/adapters/ts-config/config/standard/tsconfig.test.ts', 'tsconfig/test.json'],
+    ['src/adapters/ts-config/config/strict/tsconfig.react.ts', 'tsconfig/react-strict.json'],
+    ['src/adapters/ts-config/config/strict/tsconfig.node.ts', 'tsconfig/node-strict.json'],
+    ['src/adapters/ts-config/config/strict/tsconfig.test.ts', 'tsconfig/test-strict.json'],
+  ];
+
+  for (const [sourcePath, destPath] of configs) {
+    const srcFullPath = resolve(root, sourcePath);
+    const destFullPath = resolve(dist, destPath);
+    const destDir = resolve(dist, destPath.split('/').slice(0, -1).join('/'));
+
+    if (!existsSync(destDir)) {
+      mkdirSync(destDir, { recursive: true });
+    }
+
+    const configModule = await import(pathToFileURL(srcFullPath).href);
+    const config = configModule.default;
+
+    writeFileSync(destFullPath, JSON.stringify(config, null, 2), 'utf8');
+  }
+
+  console.log('✅ Build completed with flattened tsconfigs.');
+})();

package/src/adapters/code-health-meter/README.md

@@ -0,0 +1 @@
+# code-health-meter