@matrixai/lint 0.0.2-0

package/dist/configs/js.js

@@ -0,0 +1,244 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import globals from 'globals';
+import _import from 'eslint-plugin-import';
+import js from '@eslint/js';
+import tsParser from '@typescript-eslint/parser';
+import { FlatCompat } from '@eslint/eslintrc';
+import { fixupPluginRules } from '@eslint/compat';
+import matrixaiPlugin from '../plugins/eslint-plugin-matrixai.js';
+import { resolveMatrixConfig } from '../utils.js';
+const filename = fileURLToPath(import.meta.url);
+const dirname = path.dirname(filename);
+const compat = new FlatCompat({
+    baseDirectory: dirname,
+    recommendedConfig: js.configs.recommended,
+    allConfig: js.configs.all,
+});
+const config = [
+    ...compat.extends('eslint:recommended', 'plugin:@typescript-eslint/recommended', 'plugin:prettier/recommended', 'plugin:react/recommended', 'plugin:react-hooks/recommended', 'plugin:tailwindcss/recommended', 'plugin:jsx-a11y/recommended'),
+    {
+        plugins: {
+            import: fixupPluginRules(_import),
+            '@matrixai': matrixaiPlugin,
+        },
+        settings: {
+            react: {
+                version: 'detect',
+            },
+        },
+        languageOptions: {
+            globals: {
+                ...globals.browser,
+                ...globals.commonjs,
+                ...globals.node,
+                ...globals.jest,
+            },
+            parser: tsParser,
+            ecmaVersion: 5,
+            sourceType: 'module',
+            parserOptions: {
+                project: resolveMatrixConfig().tsconfigPaths,
+            },
+        },
+        rules: {
+            // MatrixAI rules
+            '@matrixai/no-aliased-imports': [
+                'error',
+                {
+                    aliases: [{ prefix: '#', target: 'src' }],
+                    includeFolders: ['src'],
+                    autoFix: true,
+                },
+            ],
+            // React rules
+            'react/react-in-jsx-scope': 0,
+            'react/no-unknown-property': 'off',
+            'react/button-has-type': 'error',
+            'react/no-unused-prop-types': 'error',
+            'react/jsx-pascal-case': 'error',
+            'react/jsx-no-script-url': 'error',
+            'react/no-children-prop': 'error',
+            'react/no-danger': 'error',
+            'react/no-danger-with-children': 'error',
+            'react/no-unstable-nested-components': ['error', { allowAsProps: true }],
+            'react/jsx-fragments': 'error',
+            'react/destructuring-assignment': [
+                'error',
+                'always',
+                { destructureInSignature: 'always' },
+            ],
+            'react/jsx-no-leaked-render': ['error', { validStrategies: ['ternary'] }],
+            'react/function-component-definition': [
+                'warn',
+                { namedComponents: 'arrow-function' },
+            ],
+            'react/jsx-key': [
+                'error',
+                {
+                    checkFragmentShorthand: true,
+                    checkKeyMustBeforeSpread: true,
+                    warnOnDuplicates: true,
+                },
+            ],
+            'react/jsx-no-useless-fragment': 'warn',
+            'react/jsx-curly-brace-presence': 'warn',
+            'react/no-typos': 'warn',
+            'react/display-name': 'warn',
+            'react/jsx-sort-props': 'warn',
+            'react/jsx-one-expression-per-line': 'off',
+            'react/prop-types': 'off',
+            '@typescript-eslint/no-floating-promises': [
+                'error',
+                {
+                    ignoreVoid: true,
+                    ignoreIIFE: true,
+                },
+            ],
+            '@typescript-eslint/no-misused-promises': [
+                'error',
+                {
+                    checksVoidReturn: false,
+                },
+            ],
+            '@typescript-eslint/await-thenable': ['error'],
+            'linebreak-style': ['error', 'unix'],
+            'no-empty': 1,
+            'no-useless-catch': 1,
+            'no-prototype-builtins': 1,
+            'no-constant-condition': 0,
+            'no-useless-escape': 0,
+            'no-console': 'error',
+            'no-restricted-globals': [
+                'error',
+                {
+                    name: 'global',
+                    message: 'Use `globalThis` instead',
+                },
+                {
+                    name: 'window',
+                    message: 'Use `globalThis` instead',
+                },
+            ],
+            'prefer-rest-params': 0,
+            'require-yield': 0,
+            eqeqeq: ['error', 'smart'],
+            'spaced-comment': [
+                'warn',
+                'always',
+                {
+                    line: {
+                        exceptions: ['-'],
+                    },
+                    block: {
+                        exceptions: ['*'],
+                    },
+                    markers: ['/'],
+                },
+            ],
+            'capitalized-comments': [
+                'warn',
+                'always',
+                {
+                    ignoreInlineComments: true,
+                    ignoreConsecutiveComments: true,
+                },
+            ],
+            curly: ['error', 'multi-line', 'consistent'],
+            'import/order': [
+                'error',
+                {
+                    groups: [
+                        'type',
+                        'builtin',
+                        'external',
+                        'internal',
+                        'index',
+                        'sibling',
+                        'parent',
+                        'object',
+                    ],
+                    pathGroups: [
+                        {
+                            pattern: '@',
+                            group: 'internal',
+                        },
+                        {
+                            pattern: '@/**',
+                            group: 'internal',
+                        },
+                    ],
+                    pathGroupsExcludedImportTypes: ['type'],
+                    'newlines-between': 'never',
+                },
+            ],
+            '@typescript-eslint/no-require-imports': 0,
+            '@typescript-eslint/no-namespace': 0,
+            '@typescript-eslint/no-explicit-any': 0,
+            '@typescript-eslint/explicit-module-boundary-types': 0,
+            '@typescript-eslint/no-unused-vars': [
+                'warn',
+                {
+                    varsIgnorePattern: '^_',
+                    argsIgnorePattern: '^_',
+                },
+            ],
+            '@typescript-eslint/no-inferrable-types': 0,
+            '@typescript-eslint/no-non-null-assertion': 0,
+            '@typescript-eslint/no-this-alias': 0,
+            '@typescript-eslint/no-var-requires': 0,
+            '@typescript-eslint/no-empty-function': 0,
+            '@typescript-eslint/no-empty-interface': 0,
+            '@typescript-eslint/consistent-type-imports': ['error'],
+            '@typescript-eslint/consistent-type-exports': ['error'],
+            'no-throw-literal': 'off',
+            '@typescript-eslint/no-throw-literal': 'off',
+            '@typescript-eslint/naming-convention': [
+                'error',
+                {
+                    selector: 'function',
+                    format: ['camelCase', 'PascalCase'],
+                    leadingUnderscore: 'allow',
+                    trailingUnderscore: 'allowSingleOrDouble',
+                },
+                {
+                    selector: 'variable',
+                    format: ['camelCase', 'UPPER_CASE', 'PascalCase'],
+                    leadingUnderscore: 'allow',
+                    trailingUnderscore: 'allowSingleOrDouble',
+                },
+                {
+                    selector: 'parameter',
+                    format: ['camelCase'],
+                    leadingUnderscore: 'allow',
+                    trailingUnderscore: 'allowSingleOrDouble',
+                },
+                {
+                    selector: 'typeLike',
+                    format: ['PascalCase'],
+                    trailingUnderscore: 'allowSingleOrDouble',
+                },
+                {
+                    selector: 'enumMember',
+                    format: ['PascalCase', 'UPPER_CASE'],
+                },
+                {
+                    selector: 'objectLiteralProperty',
+                    format: null,
+                },
+                {
+                    selector: 'typeProperty',
+                    format: null,
+                },
+            ],
+            '@typescript-eslint/ban-ts-comment': [
+                'error',
+                {
+                    'ts-ignore': 'allow-with-description',
+                },
+            ],
+        },
+    },
+];
+export default config;
+//# sourceMappingURL=js.js.map

package/dist/configs/js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js.js","sourceRoot":"","sources":["../../src/configs/js.ts"],"names":[],"mappings":"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"}

package/dist/plugins/eslint-plugin-matrixai.d.ts

@@ -0,0 +1,18 @@
+declare const matrixaiPlugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: {
+        'no-aliased-imports': import("@typescript-eslint/utils/ts-eslint").RuleModule<"noAlias" | "noAliasNoAutofix", [{
+            aliases: {
+                prefix: string;
+                target: string;
+            }[];
+            includeFolders: string[];
+            autoFix: boolean;
+        }], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+    };
+    configs: {};
+};
+export default matrixaiPlugin;

package/dist/plugins/eslint-plugin-matrixai.js

@@ -0,0 +1,13 @@
+import noAliasedImportsRule from '../rules/no-aliased-imports.js';
+const matrixaiPlugin = {
+    meta: {
+        name: 'eslint-plugin-matrixai',
+        version: '0.0.1',
+    },
+    rules: {
+        'no-aliased-imports': noAliasedImportsRule,
+    },
+    configs: {},
+};
+export default matrixaiPlugin;
+//# sourceMappingURL=eslint-plugin-matrixai.js.map

package/dist/plugins/eslint-plugin-matrixai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint-plugin-matrixai.js","sourceRoot":"","sources":["../../src/plugins/eslint-plugin-matrixai.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,MAAM,gCAAgC,CAAC;AAElE,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE;QACJ,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,OAAO;KACjB;IACD,KAAK,EAAE;QACL,oBAAoB,EAAE,oBAAoB;KAC3C;IACD,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/rules/no-aliased-imports.d.ts

@@ -0,0 +1,12 @@
+import type { RuleModule } from '@typescript-eslint/utils/ts-eslint';
+export declare const noAliasedImportsRule: RuleModule<'noAlias' | 'noAliasNoAutofix', [
+    {
+        aliases: {
+            prefix: string;
+            target: string;
+        }[];
+        includeFolders: string[];
+        autoFix: boolean;
+    }
+]>;
+export default noAliasedImportsRule;

package/dist/rules/no-aliased-imports.js

@@ -0,0 +1,108 @@
+import path from 'node:path';
+export const noAliasedImportsRule = {
+    meta: {
+        type: 'suggestion',
+        fixable: 'code',
+        hasSuggestions: true,
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    // We'll allow multiple alias mappings
+                    aliases: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                prefix: { type: 'string' },
+                                target: { type: 'string' },
+                            },
+                            required: ['prefix', 'target'],
+                        },
+                        default: [{ prefix: '#', target: 'src' }],
+                    },
+                    // Folders or partial strings that the filename must include
+                    // in order for us to apply the rule
+                    includeFolders: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        default: ['src'],
+                    },
+                    autoFix: {
+                        type: 'boolean',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            noAlias: 'Use relative import instead of alias import in src files "{{ aliasImport }}".',
+            noAliasNoAutofix: 'Use relative import instead of alias import in src files "{{ aliasImport }}" (auto-fix is disabled)',
+        },
+    },
+    // Provide defaults if none are given
+    defaultOptions: [
+        {
+            aliases: [{ prefix: '#', target: 'src' }],
+            includeFolders: ['src'],
+            autoFix: false,
+        },
+    ],
+    create(context) {
+        const options = context.options[0] || {};
+        const { aliases = [{ prefix: '#', target: 'src' }], includeFolders = ['src'], autoFix = false, } = options;
+        return {
+            ImportDeclaration(node) {
+                const importPath = node.source.value;
+                // The absolute path of the current file being linted
+                const filename = context.filename;
+                // 1) Check if the file is in one of the "includeFolders"
+                const isInIncludedFolder = includeFolders.some((folder) => {
+                    return (filename.includes(`${path.sep}${folder}${path.sep}`) ||
+                        filename.endsWith(`${path.sep}${folder}`));
+                    // ^ endsWith check so that if 'src' is the last part of the path, it still matches
+                });
+                // File is not in any of the included folders, so skip
+                if (!isInIncludedFolder) {
+                    return;
+                }
+                // 2) Check if the import path starts with any of the alias prefixes
+                const matchedAlias = aliases.find((aliasObj) => importPath.startsWith(aliasObj.prefix));
+                // Doesn't match any alias prefix, so skip
+                if (matchedAlias == null) {
+                    return;
+                }
+                // For example: prefix = '#' => target = 'src'
+                const { prefix, target } = matchedAlias;
+                // LocalPart is the substring after the alias prefix
+                // e.g. `#db/utils.js` => `db/utils.js`
+                const localPart = importPath.slice(prefix.length);
+                // 3) Build the absolute path to the *real* file
+                // e.g. => <PROJECT_ROOT>/src/db/utils.js
+                // or if alias is { prefix: '@', target: 'lib' } => <PROJECT_ROOT>/lib/db/utils.js
+                const projectRoot = context.cwd;
+                const absoluteImportPath = path.join(projectRoot, target, localPart);
+                // 4) Compute the relative path from the current file
+                const currentFileDir = path.dirname(filename);
+                let relativePath = path.relative(currentFileDir, absoluteImportPath);
+                if (!relativePath.startsWith('.')) {
+                    relativePath = `.${path.sep}${relativePath}`;
+                }
+                // If autoFix is false, don't give a fix - forces manual fix.
+                const fix = autoFix
+                    ? (fixer) => {
+                        return fixer.replaceTextRange([node.source.range[0], node.source.range[1]], `'${relativePath}'`);
+                    }
+                    : null;
+                context.report({
+                    node: node.source,
+                    messageId: autoFix ? 'noAlias' : 'noAliasNoAutofix',
+                    data: { aliasImport: importPath },
+                    fix,
+                });
+            },
+        };
+    },
+};
+export default noAliasedImportsRule;
+//# sourceMappingURL=no-aliased-imports.js.map

package/dist/rules/no-aliased-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-aliased-imports.js","sourceRoot":"","sources":["../../src/rules/no-aliased-imports.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,oBAAoB,GAS7B;IACF,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,sCAAsC;oBACtC,OAAO,EAAE;wBACP,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BAC3B;4BACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;yBAC/B;wBACD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;qBAC1C;oBACD,4DAA4D;oBAC5D,oCAAoC;oBACpC,cAAc,EAAE;wBACd,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,OAAO,EAAE,CAAC,KAAK,CAAC;qBACjB;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;qBAChB;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,QAAQ,EAAE;YACR,OAAO,EACL,+EAA+E;YACjF,gBAAgB,EACd,qGAAqG;SACxG;KACF;IACD,qCAAqC;IACrC,cAAc,EAAE;QACd;YACE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACzC,cAAc,EAAE,CAAC,KAAK,CAAC;YACvB,OAAO,EAAE,KAAK;SACf;KACF;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,EACJ,OAAO,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAC1C,cAAc,GAAG,CAAC,KAAK,CAAC,EACxB,OAAO,GAAG,KAAK,GAChB,GAAG,OAAO,CAAC;QACZ,OAAO;YACL,iBAAiB,CAAC,IAAI;gBACpB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBAErC,qDAAqD;gBACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;gBAElC,yDAAyD;gBACzD,MAAM,kBAAkB,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;oBACxD,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBACpD,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,MAAM,EAAE,CAAC,CAC1C,CAAC;oBACF,mFAAmF;gBACrF,CAAC,CAAC,CAAC;gBAEH,sDAAsD;gBACtD,IAAI,CAAC,kBAAkB,EAAE;oBACvB,OAAO;iBACR;gBAED,oEAAoE;gBACpE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC7C,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CACvC,CAAC;gBAEF,0CAA0C;gBAC1C,IAAI,YAAY,IAAI,IAAI,EAAE;oBACxB,OAAO;iBACR;gBAED,8CAA8C;gBAC9C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC;gBAExC,oDAAoD;gBACpD,uCAAuC;gBACvC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAElD,gDAAgD;gBAChD,yCAAyC;gBACzC,kFAAkF;gBAClF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;gBAChC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;gBAErE,qDAAqD;gBACrD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAE9C,IAAI,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;gBACrE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;oBACjC,YAAY,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,YAAY,EAAE,CAAC;iBAC9C;gBACD,6DAA6D;gBAC7D,MAAM,GAAG,GAAG,OAAO;oBACjB,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE;wBACR,OAAO,KAAK,CAAC,gBAAgB,CAC3B,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC5C,IAAI,YAAY,GAAG,CACpB,CAAC;oBACJ,CAAC;oBACH,CAAC,CAAC,IAAI,CAAC;gBAET,OAAO,CAAC,MAAM,CAAC;oBACb,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB;oBACnD,IAAI,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE;oBACjC,GAAG;iBACJ,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,9 @@
+type MatrixAILintCfg = {
+    tsconfigPaths: string[];
+    forceInclude: string[];
+};
+type RawMatrixCfg = Partial<{
+    tsconfigPaths: unknown;
+    forceInclude: unknown;
+}>;
+export type { MatrixAILintCfg, RawMatrixCfg };

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,65 @@
+import type { MatrixAILintCfg } from './types.js';
+declare function runESLint({ fix, configPath, }: {
+    fix: boolean;
+    configPath?: string;
+}): Promise<void>;
+/**
+ * Find the user's ESLint config file in the current working directory.
+ * It looks for the following files:
+ * - eslint.config.js
+ * - eslint.config.mjs
+ * - eslint.config.cjs
+ * - eslint.config.ts
+ *
+ * @param repoRoot The root directory of the repository (default: process.cwd())
+ * @returns The path to the ESLint config file, or null if not found.
+ */
+declare function findUserESLintConfig(repoRoot?: string): string | undefined;
+/**
+ * Collect all Markdown files in a directory and its subdirectories.
+ *
+ * @param dir The directory to search in.
+ * @returns An array of paths to Markdown files.
+ */
+declare function collectMarkdown(dir: string): string[];
+/**
+ * Check if a command exists in the system PATH.
+ *
+ * @param cmd The command to check.
+ * @returns True if the command exists, false otherwise.
+ */
+declare function commandExists(cmd: string): boolean;
+/**
+ * Loads and sanitises MatrixAI‑linter config for a repo.
+ *
+ * - Reads `matrixai-lint-config.json` in `repoRoot` (if present).
+ *   - Throws if the JSON is invalid.
+ * - Extracts `tsconfigPaths` & `forceInclude`, coercing each to `string[]`.
+ * - Resolves `tsconfigPaths` to absolute paths and keeps only files that exist.
+ *   - If none remain, falls back to `repoRoot/tsconfig.json` when available.
+ * - Strips leading “./” from every `forceInclude` glob.
+ *
+ * Returns a normalised `{ tsconfigPaths, forceInclude }`.
+ */
+declare function resolveMatrixConfig(repoRoot?: string): MatrixAILintCfg;
+/**
+ * Builds file and ignore patterns based on a given TypeScript configuration file path,
+ * with optional forced inclusion of specific paths.
+ *
+ * @param tsconfigPath - The path to the TypeScript configuration file (tsconfig.json).
+ * @param forceInclude - An optional array of paths or patterns to forcefully include,
+ *                       even if they overlap with excluded patterns.
+ * @returns An object containing:
+ *          - `files`: An array of glob patterns for files to include.
+ *          - `ignore`: An array of glob patterns for files or directories to ignore.
+ *
+ * The function reads the `include` and `exclude` properties from the TypeScript
+ * configuration file, processes them into glob patterns, and applies overrides
+ * based on the `forceInclude` parameter. If no `exclude` patterns are specified,
+ * default ignore patterns for common directories like `node_modules` are added.
+ */
+declare function buildPatterns(tsconfigPath: string, forceInclude?: string[]): {
+    files: string[];
+    ignore: string[];
+};
+export { runESLint, findUserESLintConfig, collectMarkdown, commandExists, resolveMatrixConfig, buildPatterns, };