eslint.config.mjs

// @ts-check

import eslint from '@eslint/js'
import pluginQuery from '@tanstack/eslint-plugin-query'
import neslint from 'eslint-plugin-n'
import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended'
import reacteslint from 'eslint-plugin-react'
import hookseslint from 'eslint-plugin-react-hooks'
import reactRefreshEslint from 'eslint-plugin-react-refresh'
import tseslint from 'typescript-eslint'

export default [
	// setup the parser first
	{
		languageOptions: {
			parser: tseslint.parser,
			parserOptions: {
				projectService: true,
				tsconfigRootDir: import.meta.dirname,
			},
		},
	},

	{
		...neslint.configs['flat/recommended-script'],
		ignores: [...(neslint.configs['flat/recommended-script'].ignores ?? []), 'webui/**/*', 'launcher-ui/**/*'],
	},
	{
		// extends: commonExtends,
		plugins: {
			'@typescript-eslint': tseslint.plugin,
		},
		rules: {
			// Default rules to be applied everywhere
			'prettier/prettier': 'error',

			...eslint.configs.recommended.rules,

			'no-console': 'off',

			'@typescript-eslint/no-unused-vars': [
				'error',
				{ argsIgnorePattern: '^_', caughtErrorsIgnorePattern: '^_', varsIgnorePattern: '^_(.+)' },
			],
			'no-extra-semi': 'off',
			'no-useless-assignment': 'off',
			'preserve-caught-error': 'off', // Future: Maybe this should be enabled?
			// 'n/no-unsupported-features/es-syntax': ['error', { ignores: ['modules'] }],
			'no-use-before-define': 'off',
			'no-warning-comments': ['error', { terms: ['nocommit', '@nocommit', '@no-commit'] }],
			// 'jest/no-mocks-import': 'off',
		},
		files: ['**/*.ts', '**/*.cts', '**/*.mts', '**/*.tsx'],
	},
	...tseslint.configs.recommendedTypeChecked,
	{
		// disable type-aware linting on JS files
		files: ['**/*.js', '**/*.cjs', '**/*.mjs'],
		...tseslint.configs.disableTypeChecked,
		rules: {
			...tseslint.configs.disableTypeChecked.rules,
			'@typescript-eslint/no-unused-vars': [
				'error',
				{ argsIgnorePattern: '^_', caughtErrorsIgnorePattern: '^_', varsIgnorePattern: '^_(.+)' },
			],
		},
	},
	{
		files: ['*.mjs'],
		languageOptions: {
			sourceType: 'module',
		},
	},
	{
		files: ['**/*.tsx', '**/*.ts', '**/*.cts', '**/*.mts'],
		rules: {
			'@typescript-eslint/no-explicit-any': 'off',
			'@typescript-eslint/interface-name-prefix': 'off',
			'@typescript-eslint/no-floating-promises': 'error',
			'@typescript-eslint/promise-function-async': 'error',
			'@typescript-eslint/require-await': 'off', // conflicts with 'promise-function-async'
			'@typescript-eslint/consistent-type-imports': 'error',
			'no-duplicate-imports': 'error',

			/** Disable some annoyingly strict rules from the 'recommended-requiring-type-checking' pack */
			'@typescript-eslint/no-unsafe-assignment': 0,
			'@typescript-eslint/no-unsafe-member-access': 0,
			'@typescript-eslint/no-unsafe-argument': 0,
			'@typescript-eslint/no-unsafe-return': 0,
			'@typescript-eslint/no-unsafe-call': 0,
			'@typescript-eslint/restrict-template-expressions': 0,
			'@typescript-eslint/restrict-plus-operands': 0,
			'@typescript-eslint/no-redundant-type-constituents': 0,
			'@typescript-eslint/no-this-alias': 0, // Needed for some TRPC routers
			/** End 'recommended-requiring-type-checking' overrides */

			'@typescript-eslint/explicit-module-boundary-types': [
				'error',
				{
					allowedNames: [
						'createTrpcRouter', // The router wants to be inferred
						'createTrpcRouterBase', // The router wants to be inferred
					],
				},
			],
		},
	},
	{
		files: ['**/__tests__/**/*', 'companion/test/**/*', 'webui/test/**/*', 'config-tool/test/**/*'],
		rules: {
			'@typescript-eslint/ban-ts-ignore': 'off',
			'@typescript-eslint/ban-ts-comment': 'off',
			'@typescript-eslint/unbound-method': 'off',
			'@typescript-eslint/explicit-module-boundary-types': 'off',
		},
	},
	{
		files: ['companion/test/integration/modules/src/**/*'],
		rules: {
			// These sources are bundler inputs: the base library is resolved from a per-version
			// scratch install by build-module-fixtures.mts, not from the repo's dependencies
			'n/no-extraneous-import': 'off',
			'n/no-extraneous-require': 'off',
			// The v1 module contract is commonjs
			'@typescript-eslint/no-require-imports': 'off',
		},
	},
	{
		files: ['e2e/**/*'],
		rules: {
			// @playwright/test is a root devDependency, which this rule doesn't recognise from here
			'n/no-unpublished-import': 'off',
			// playwright resolves fixture dependencies from the destructuring pattern, so an empty
			// pattern is meaningful for fixtures with no dependencies
			'no-empty-pattern': 'off',
			// the app launcher is an entrypoint script, same as companion/lib/main.ts
			'n/no-process-exit': 'off',
		},
	},
	{
		files: ['companion/**/*.ts', 'companion/**/*.js'],
		rules: {
			'n/no-missing-import': [
				'error',
				{
					// stream-json's `exports` map only exposes `./*` -> `./src/*.js`; the resolver rewrites
					// the `.js` subpath imports to `.ts` and fails to find a source, so allow the package.
					allowModules: ['@companion-app/shared', '@companion-module/base', 'type-fest', 'stream-json'],
				},
			],
			'n/prefer-node-protocol': 'error',
			'n/no-unsupported-features/node-builtins': [
				'error',
				{
					version: 'current',
					ignores: ['sqlite'],
				},
			],
		},
	},
	{
		files: ['launcher/**/*.ts', 'launcher/**/*.js', 'shared-lib/**/*.ts', 'shared-lib/**/*.js'],
		rules: {
			'n/prefer-node-protocol': 'error',
			'n/no-missing-import': [
				'error',
				{
					// @companion-app/shared resolves to its TS sources during dev/test
					allowModules: ['@companion-app/shared'],
				},
			],
		},
	},
	{
		files: ['config-tool/**/*.ts'],
		rules: {
			// Confusing import issues currently
			'n/no-missing-import': [
				'error',
				{
					allowModules: ['@companion-app/shared'],
				},
			],
		},
	},

	// Add prettier at the end to give it final say on formatting
	eslintPluginPrettierRecommended,
	{
		// But lastly, ensure that we ignore certain paths
		ignores: [
			'**/dist/*',
			'**/build/*',
			'/dist',
			'**/pkg/*',
			'**/docs/*',
			'**/generated/*',
			'**/node_modules/*',
			'**/electron-output/*',
			'*/vite.config.ts',
			'webui/vitest.config.ts',
			'vitest.config.ts',
			'vitest.workspace.ts',
			'html/**/*',
			'bundled-modules/**/*',
			// Generated module fixtures (bundles of @companion-module/base at pinned versions)
			'companion/test/integration/modules/fixtures/**/*',
			'companion/test/integration/modules/fixtures-invalid/**/*',
			'tools/**/*',
			'module-local-dev/**/*',
			'launcher/dev.cjs',
			'webui/public/_deps/**/*',
			'webui/post-install.ts',
			'.yarnrc.yml',
			'.cache/*',
			'companion/lib/Cloud/**/*', // Code is due to be removed soon, not worth fixing lint issues in it
		],
	},
	{
		files: ['eslint.config.*'],
		rules: {
			'n/no-unpublished-import': 'off',
		},
	},

	// The above is mostly copied from https://github.com/bitfocus/companion-module-tools/blob/main/eslint/config.mjs with very little modifications. The below is extra rules that have been added
	{
		files: [
			'webui/**/*.tsx',
			'webui/**/*.jsx',
			'webui/**/*.ts',
			'webui/**/*.js',
			'launcher-ui/**/*.tsx',
			'launcher-ui/**/*.jsx',
			'launcher-ui/**/*.ts',
			'launcher-ui/**/*.js',
		],
		plugins: {
			'react-hooks': hookseslint,
			'react-refresh': reactRefreshEslint,
			react: reacteslint,
		},
		rules: {
			'import/no-unresolved': 'off',
			...hookseslint.configs.recommended.rules,
			'react-refresh/only-export-components': [
				'warn',
				{
					extraHOCs: [
						// tanstack router
						'createFileRoute',
						'createRootRoute',
						// mobx
						'observer',
					],
				},
			],
			'@typescript-eslint/only-throw-error': [
				'error',
				{
					allow: [
						{
							from: 'package',
							package: '@tanstack/router-core',
							name: 'Redirect',
						},
					],
				},
			],

			// HACK: temporary rules to suppress errors until we can fix them properly
			'react-hooks/refs': 'off',
			'react-hooks/set-state-in-effect': 'off',
			'react-hooks/preserve-manual-memoization': 'off',
		},
	},
	{
		rules: {
			'@typescript-eslint/no-namespace': 'off',
			'@typescript-eslint/no-redundant-type-constituents': 'off',
			'@typescript-eslint/no-duplicate-type-constituents': 'off',
		},
	},

	...pluginQuery.configs['flat/recommended'].map((config) => ({
		...config,
		files: ['webui/**/*.tsx', 'webui/**/*.jsx', 'webui/**/*.ts', 'webui/**/*.js'],
	})),
]