Merge branch 'main' into plugins/knip-fix-1

# Conflicts:
#	package-lock.json
#	package.json

Author: BioPhoton

.eslintignore

@@ -40,3 +40,8 @@ testem.log
 Thumbs.db
 
 .nx
+
+vite.config.*.timestamp*
+vitest.config.*.timestamp*
+.cursor/rules/nx-rules.mdc
+.github/instructions/nx.instructions.md

.eslintrc.json

@@ -0,0 +1 @@
+24.1.0

.gitignore

@@ -1,3 +1,4 @@
 {
-  "eslint.validate": ["json"]
+  "eslint.validate": ["json"],
+  "kiroAgent.configureMCP": "Disabled"
 }

.node-version

@@ -0,0 +1 @@
+# Changelog

.vscode/settings.json

@@ -0,0 +1,39 @@
+# Contributing to Code-Pushup Community Plugins
+
+Welcome to the Code-Pushup Community Plugins repository! This space is designed for the community to create, share, and publish their own plugins. We're excited to see your contributions.
+
+## Minimum Requirements for Plugin Submissions
+
+To maintain high quality and usability standards, please ensure your plugin meets the following criteria before submission:
+
+### 1. Documentation
+
+- Your code must be well-documented
+- Include clear descriptions of functionality and usage
+- Provide API documentation where applicable
+- Provide a readme file in the root of your plugin, determining the plugin name, description, and usage instructions
+
+### 2. Testing Coverage
+
+- Implement comprehensive unit tests
+- Include integration tests
+- Maintain good test coverage metrics
+
+### 3. Code Quality
+
+- Code must be properly linted
+- It must be formatted too
+
+### 4. Examples
+
+- Include an `examples` directory in your plugin
+- Provide at least one `basic-setup` example
+- Ensure examples are:
+  - Easy to reproduce
+  - Quick to execute
+  - Demonstrate core functionality
+  - Well-documented with setup instructions
+
+For reference, you can find plugins examples in our [CLI repository](https://github.com/code-pushup/cli/tree/main/packages), including plugins for ESLint, TypeScript, JSDoc, Lighthouse, and more. These can serve as templates for your own plugin implementation.
+
+We look forward to your contributions! If you have any questions, feel free to open an issue for discussion.

CHANGELOG.md

@@ -2,4 +2,41 @@
 
 <a alt="code-pushup logo" href="https://code-pushup.dev" target="_blank" rel="noreferrer"><img src="https://raw.githubusercontent.com/code-pushup/cli/master/packages/cli/docs/images/logo.png" width="45"></a>
 
-✨ **This is the repository for all our plugin examples.** ✨
+✨ **Welcome to the Code-Pushup Community Plugins Repository!** ✨
+
+This repository serves as a central hub for community-created plugins for Code-Pushup. Here you'll find a collection of plugins developed by the community to extend Code-Pushup's functionality.
+
+## What is Code-Pushup?
+
+Code-Pushup is a tool that helps you measure and track your code quality metrics. For more information, visit our [official website](https://code-pushup.dev).
+
+## Available Plugins
+
+This section will list community plugins as they are added. Each plugin will include:
+
+- Brief description
+- Installation instructions
+- Basic usage example
+- Link to detailed documentation
+
+## Creating Your Own Plugin
+
+Want to contribute? Great! You can create your own plugin and share it with the community. Check out our [CONTRIBUTING.md](./CONTRIBUTING.md) guide for:
+
+- Minimum requirements
+- Development guidelines
+- Submission process
+
+For reference implementations, see our [official plugins](https://github.com/code-pushup/cli/tree/main/packages) in the CLI repository.
+
+## Getting Started
+
+1. Browse the available plugins
+2. Follow each plugin's installation and setup instructions
+3. Configure the plugin in your Code-Pushup configuration
+4. Run Code-Pushup to start measuring your code quality
+
+## Need Help?
+
+- 🤔 Open an [issue](https://github.com/code-pushup/community-plugins/issues) for questions
+- 🐛 Report bugs in the respective plugin's issue section

CONTRIBUTING.MD

@@ -0,0 +1,158 @@
+import nxEslintPlugin from '@nx/eslint-plugin';
+import jestExtendedPlugin from 'eslint-plugin-jest-extended';
+import jsoncParser from 'jsonc-eslint-parser';
+import fs from 'node:fs';
+import tseslint from 'typescript-eslint';
+import node from '@code-pushup/eslint-config/node.js';
+import typescript from '@code-pushup/eslint-config/typescript.js';
+import vitest from '@code-pushup/eslint-config/vitest.js';
+
+export default tseslint.config(
+  ...typescript,
+  ...node,
+  ...vitest,
+  {
+    settings: {
+      'import/resolver': {
+        typescript: {
+          project: 'tsconfig.base.json',
+          alwaysTryTypes: true,
+          extensions: ['.ts', '.tsx', '.d.ts', '.js', '.jsx'],
+        },
+        node: {
+          extensions: ['.ts', '.tsx', '.d.ts', '.js', '.jsx'],
+        },
+      },
+    },
+  },
+  { plugins: { '@nx': nxEslintPlugin } },
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    rules: {
+      '@nx/enforce-module-boundaries': [
+        'error',
+        {
+          enforceBuildableLibDependency: true,
+          allow: [
+            String.raw`^.*/eslint(\.base)?\.config\.[cm]?js$`,
+            String.raw`^.*/code-pushup\.(config|preset)(\.m?[jt]s)?$`,
+            '^[./]+/tools/.*$',
+            String.raw`^[./]+/(testing/)?test-setup-config/src/index\.js$`,
+          ],
+          depConstraints: [
+            {
+              sourceTag: 'scope:shared',
+              onlyDependOnLibsWithTags: ['scope:shared'],
+            },
+            {
+              sourceTag: 'scope:core',
+              onlyDependOnLibsWithTags: ['scope:core', 'scope:shared'],
+            },
+            {
+              sourceTag: 'scope:plugin',
+              onlyDependOnLibsWithTags: ['scope:shared'],
+            },
+            {
+              sourceTag: 'scope:tooling',
+              onlyDependOnLibsWithTags: ['scope:tooling', 'scope:shared'],
+            },
+            {
+              sourceTag: 'type:e2e',
+              onlyDependOnLibsWithTags: [
+                'type:app',
+                'type:feature',
+                'type:util',
+                'type:testing',
+              ],
+            },
+            {
+              sourceTag: 'type:app',
+              onlyDependOnLibsWithTags: [
+                'type:feature',
+                'type:util',
+                'type:testing',
+              ],
+            },
+            {
+              sourceTag: 'type:feature',
+              onlyDependOnLibsWithTags: [
+                'type:feature',
+                'type:util',
+                'type:testing',
+              ],
+            },
+            {
+              sourceTag: 'type:util',
+              onlyDependOnLibsWithTags: ['type:util', 'type:testing'],
+            },
+            {
+              sourceTag: 'type:testing',
+              onlyDependOnLibsWithTags: ['type:util', 'type:testing'],
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ['**/*.test.ts', '**/*.spec.ts'],
+    plugins: { 'jest-extended': jestExtendedPlugin },
+    rules: {
+      'vitest/consistent-test-filename': [
+        'warn',
+        {
+          pattern: String.raw`.*\.(bench|type|unit|int|e2e)\.test\.[tj]sx?$`,
+        },
+      ],
+      'jest-extended/prefer-to-be-array': 'warn',
+      'jest-extended/prefer-to-be-false': 'warn',
+      'jest-extended/prefer-to-be-object': 'warn',
+      'jest-extended/prefer-to-be-true': 'warn',
+      'jest-extended/prefer-to-have-been-called-once': 'warn',
+    },
+  },
+  {
+    files: ['**/*.type.test.ts'],
+    rules: {
+      'vitest/expect-expect': 'off',
+    },
+  },
+  {
+    files: ['**/*.json'],
+    languageOptions: { parser: jsoncParser },
+  },
+  {
+    files: ['**/*.ts', '**/*.js'],
+    rules: {
+      'n/file-extension-in-import': ['error', 'always'],
+      'unicorn/number-literal-case': 'off',
+    },
+  },
+  {
+    files: ['**/perf/**/*.ts'],
+    rules: {
+      '@typescript-eslint/no-magic-numbers': 'off',
+      'sonarjs/no-duplicate-string': 'off',
+    },
+  },
+  {
+    // tests need only be compatible with local Node version
+    // publishable packages should pick up version range from "engines" in their package.json
+    files: ['e2e/**/*.ts', 'testing/**/*.ts', '**/*.test.ts'],
+    settings: {
+      node: {
+        version: fs.readFileSync('.node-version', 'utf8'),
+      },
+    },
+  },
+  {
+    ignores: [
+      '**/*.mock.*',
+      '**/code-pushup.config.ts',
+      '**/mocks/fixtures/**',
+      '**/__snapshots__/**',
+      '**/dist',
+      '**/*.md',
+    ],
+  },
+);