@isentinel/eslint-config 6.0.0-beta.42 → 6.0.0-beta.44

package/README.md

@@ -890,6 +890,53 @@ otherwise, you can install them manually:
 pnpm i -D eslint-plugin-eslint-plugin
 ```
 
+#### Co-located Tests
+
+`projectStructure` requires every source file to sit next to its test file,
+through
+[eslint-plugin-project-structure](https://github.com/Igorkowalski94/eslint-plugin-project-structure).
+`src/place-service.ts` then has to be joined by `src/place-service.spec.ts`.
+Only `enforceExistence` is driven here, so the rule never enforces naming:
+
+```ts
+// eslint.config.ts
+import isentinel from "@isentinel/eslint-config";
+
+export default isentinel({
+	projectStructure: {
+		// The plugin's name placeholders, plus `{ext}` for the extension of the
+		// file that matched. Default: ["{node-name}.spec.{ext}"]
+		enforceExistence: "__tests__/{node-name}.test.{ext}",
+		// Default: every source file the preset lints
+		files: ["src/**/*.{ts,tsx}"],
+		// Default: tests, `.d.ts` files and build configs
+		ignores: ["**/index.ts"],
+		// Default: `process.cwd()`
+		projectRoot: import.meta.dirname,
+		// Restricts the check to one subtree. Default: all of `projectRoot`
+		structureRoot: "src",
+	},
+});
+```
+
+```bash
+pnpm i -D eslint-plugin-project-structure
+```
+
+`{node-name}` matches the kebab-case filenames the preset enforces; the others
+are `{nodeName}`, `{NodeName}`, `{node_name}` and `{NODE_NAME}`. A file already
+matching a template is exempt from it. A source file with no test disables the
+rule at the source.
+
+The rule needs no type information, so oxlint runs it too: the same option is
+accepted by the oxlint factory, and hybrid mode (`oxlint: true`) hands the check
+to oxlint.
+
+Two caveats. Deleting `foo.spec.ts` does not change `foo.ts`, so a cached run
+replays the old clean result — the check is only sound uncached. And the plugin
+writes `projectStructure.cache.json` into `projectRoot` while it has something
+to report, so gitignore it.
+
 ### Git hooks
 
 If you want to apply lint and auto-fix before every commit, use

package/dist/cli.mjs

@@ -9,7 +9,7 @@ import path from "node:path";
 import { existsSync, readFileSync } from "fs";
 import { execSync } from "node:child_process";
 //#region package.json
-var version = "6.0.0-beta.42";
+var version = "6.0.0-beta.44";
 var package_default = {
 	name: "@isentinel/eslint-config",
 	version,
@@ -155,6 +155,7 @@ var package_default = {
 		"eslint-plugin-jest": "catalog:peer",
 		"eslint-plugin-jest-extended": "catalog:peer",
 		"eslint-plugin-n": "catalog:peer",
+		"eslint-plugin-project-structure": "catalog:peer",
 		"eslint-plugin-react-jsx": "catalog:peer",
 		"eslint-plugin-react-naming-convention": "catalog:peer",
 		"eslint-plugin-react-x": "catalog:peer",
@@ -179,6 +180,7 @@ var package_default = {
 		"eslint-plugin-jest": "^29.15.0",
 		"eslint-plugin-jest-extended": "^3.0.0",
 		"eslint-plugin-n": "^17.0.0 || ^18.0.0",
+		"eslint-plugin-project-structure": "^3.14.0",
 		"eslint-plugin-react-jsx": "^5.10.0",
 		"eslint-plugin-react-naming-convention": "^5.10.0",
 		"eslint-plugin-react-x": "^5.10.0",
@@ -192,6 +194,7 @@ var package_default = {
 		"eslint-plugin-jest": { "optional": true },
 		"eslint-plugin-jest-extended": { "optional": true },
 		"eslint-plugin-n": { "optional": true },
+		"eslint-plugin-project-structure": { "optional": true },
 		"eslint-plugin-react-jsx": { "optional": true },
 		"eslint-plugin-react-naming-convention": { "optional": true },
 		"eslint-plugin-react-x": { "optional": true },
@@ -531,7 +534,7 @@ async function updateEslintFiles(result) {
 //#endregion
 //#region src/cli/constants-generated.ts
 const versionsMap = {
-	"eslint": "10.7.0",
+	"eslint": "10.8.1",
 	"eslint-plugin-jest": "29.16.0",
 	"eslint-plugin-react-jsx": "5.17.3",
 	"eslint-plugin-react-naming-convention": "5.17.3",

package/dist/index.d.mts

@@ -6488,6 +6488,7 @@ interface OverrideSiteChains {
   jsonc: [JsoncRuleDefaults];
   markdown: [MarkdownRuleDefaults];
   naming: FeatureChain;
+  projectStructure: FeatureChain;
   react: ReactChain;
   roblox: MainChain;
   toml: [TomlRuleDefaults];
@@ -6497,7 +6498,7 @@ interface OverrideSiteChains {
 type TestChain = [TestRuleDefaults, SourceFeatureRuleDefaults, MainRuleDefaults];
 type ValidateOptionsWith<O, VK extends VariantKey> = ValidateSite<O, "rules", MainChain, VK> & ValidateSubOptionsFromTable<O, OverrideSiteChains, VK> & ValidateTestOption<O, TestChain, VK>;
 //#endregion
-//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-config-flat-gitignore/2.3.0/1320bd07004d149fd5c550ffda02aec5ecff7717d8f1602b7e9e51dffe8368d5/node_modules/eslint-config-flat-gitignore/dist/index.d.mts
+//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-config-flat-gitignore/2.3.0/0a594adbd94ca75e2950b1104992894d49bc93f4f2bc935ad192d7104e4c271e/node_modules/eslint-config-flat-gitignore/dist/index.d.mts
 interface FlatGitignoreOptions {
   /**
    * Name of the configuration.
@@ -10470,6 +10471,21 @@ interface RuleOptions {
    * @see https://eslint.org/docs/latest/rules/preserve-caught-error
    */
   'preserve-caught-error'?: Linter.RuleEntry<PreserveCaughtError>;
+  /**
+   * Enforce advanced naming rules and prohibit the use of given selectors in a given file. Have full control over what your file can contain and the naming conventions it must follow.
+   * @see https://github.com/Igorkowalski94/eslint-plugin-project-structure/wiki/project%E2%80%91structure-%E2%80%8Bfile%E2%80%91composition#root
+   */
+  'project-structure/file-composition'?: Linter.RuleEntry<ProjectStructureFileComposition>;
+  /**
+   * Enforce rules on folder structure to keep your repository consistent, orderly and well thought out.
+   * @see https://github.com/Igorkowalski94/eslint-plugin-project-structure/wiki/project%E2%80%91structure-%E2%80%8Bfolder%E2%80%91structure#root
+   */
+  'project-structure/folder-structure'?: Linter.RuleEntry<ProjectStructureFolderStructure>;
+  /**
+   * A key principle of a healthy project is to prevent the creation of a massive dependency tree, where removing or editing one feature triggers a chain reaction that impacts the entire project. Create independent modules to keep your project scalable and easy to maintain. Get rid of dependencies between modules and create truly independent functionalities.
+   * @see https://github.com/Igorkowalski94/eslint-plugin-project-structure/wiki/project%E2%80%91structure-%E2%80%8Bindependent%E2%80%91modules#root
+   */
+  'project-structure/independent-modules'?: Linter.RuleEntry<ProjectStructureIndependentModules>;
   /**
    * Require returning inside each `then()` to create readable and reusable Promise chains.
    * @see https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/always-return.md
@@ -23278,6 +23294,18 @@ type PreserveCaughtError = [] | [{
     argumentPosition: number;
   })[];
 }];
+// ----- project-structure/file-composition -----
+type ProjectStructureFileComposition = [] | [{
+  [k: string]: unknown | undefined;
+}];
+// ----- project-structure/folder-structure -----
+type ProjectStructureFolderStructure = [] | [{
+  [k: string]: unknown | undefined;
+}];
+// ----- project-structure/independent-modules -----
+type ProjectStructureIndependentModules = [] | [{
+  [k: string]: unknown | undefined;
+}];
 // ----- promise/always-return -----
 type PromiseAlwaysReturn = [] | [{
   ignoreLastCallback?: boolean;
@@ -27158,7 +27186,7 @@ type Yoda = [] | [("always" | "never")] | [("always" | "never"), {
   onlyEquality?: boolean;
 }];
 // Names of all the configs
-type ConfigNames = 'isentinel/eslint/comments' | 'isentinel/eslint/comments/src' | 'isentinel/e18e/rules' | 'isentinel/eslint-plugin/setup' | 'isentinel/eslint-plugin/rules' | 'isentinel/flawless/setup' | 'isentinel/flawless/rules' | 'isentinel/flawless/markdown-code' | 'isentinel/flawless/rules-type-aware' | 'isentinel/gitignore' | 'isentinel/ignores' | 'isentinel/imports/rules' | 'isentinel/imports/game' | 'isentinel/javascript/setup' | 'isentinel/javascript/rules' | 'isentinel/jsdoc/setup' | 'isentinel/jsdoc' | 'isentinel/jsonc/setup' | 'isentinel/jsonc/rules' | 'isentinel/jsonc/tsconfig' | 'isentinel/markdown/setup' | 'isentinel/markdown/processor' | 'isentinel/markdown/parser' | 'isentinel/markdown/disables' | 'isentinel/naming/setup' | 'isentinel/naming/ts/rules-type-aware' | 'isentinel/naming/tsx/rules-type-aware' | 'isentinel/node/rules' | 'isentinel/oxfmt/setup' | 'isentinel/oxfmt/javascript' | 'isentinel/oxfmt/typescript' | 'isentinel/oxfmt/css' | 'isentinel/oxfmt/scss' | 'isentinel/oxfmt/less' | 'isentinel/oxfmt/html' | 'isentinel/oxfmt/markdown' | 'isentinel/oxfmt/graphql' | 'isentinel/oxfmt/json' | 'isentinel/oxfmt/yaml' | 'isentinel/package-json/setup' | 'isentinel/package-json' | 'isentinel/package-json/root' | 'isentinel/perfectionist/setup' | 'isentinel/perfectionist' | 'isentinel/perfectionist/jsx' | 'isentinel/pnpm/setup' | 'isentinel/pnpm/package-json' | 'isentinel/pnpm/pnpm-workspace-yaml' | 'isentinel/promise' | 'isentinel/react/setup' | 'isentinel/react/setup/naming' | 'isentinel/react/setup/testing-library' | 'isentinel/react/rules' | 'isentinel/react/type-aware-rules' | 'isentinel/roblox/setup' | 'isentinel/roblox/parser' | 'isentinel/roblox/type-aware-parser' | 'isentinel/roblox' | 'isentinel/roblox/rules-type-aware' | 'isentinel/roblox/format-lua/setup' | 'isentinel/roblox/format-lua' | 'isentinel/small-rules/setup' | 'isentinel/small-rules' | 'isentinel/sonarjs' | 'isentinel/spelling/setup' | 'isentinel/spelling' | 'isentinel/stylistic/setup' | 'isentinel/stylistic' | 'isentinel/test/jest/setup' | 'isentinel/test/jest/rules' | 'isentinel/test/jest/type-tests' | 'isentinel/test/vitest/setup' | 'isentinel/test/vitest/rules' | 'isentinel/test/vitest/type-tests' | 'isentinel/toml/setup' | 'isentinel/toml/rules' | 'isentinel/typescript/setup' | 'isentinel/typescript/parser' | 'isentinel/typescript/type-aware-parser' | 'isentinel/typescript/rules' | 'isentinel/typescript/rules-type-aware' | 'isentinel/typescript/erasable-syntax-only' | 'isentinel/unicorn/setup' | 'isentinel/unicorn/rules' | 'isentinel/unicorn/root' | 'isentinel/yaml/setup' | 'isentinel/yaml/rules';
+type ConfigNames = 'isentinel/eslint/comments' | 'isentinel/eslint/comments/src' | 'isentinel/e18e/rules' | 'isentinel/eslint-plugin/setup' | 'isentinel/eslint-plugin/rules' | 'isentinel/flawless/setup' | 'isentinel/flawless/rules' | 'isentinel/flawless/markdown-code' | 'isentinel/flawless/rules-type-aware' | 'isentinel/gitignore' | 'isentinel/ignores' | 'isentinel/imports/rules' | 'isentinel/imports/game' | 'isentinel/javascript/setup' | 'isentinel/javascript/rules' | 'isentinel/jsdoc/setup' | 'isentinel/jsdoc' | 'isentinel/jsonc/setup' | 'isentinel/jsonc/rules' | 'isentinel/jsonc/tsconfig' | 'isentinel/markdown/setup' | 'isentinel/markdown/processor' | 'isentinel/markdown/parser' | 'isentinel/markdown/disables' | 'isentinel/naming/setup' | 'isentinel/naming/ts/rules-type-aware' | 'isentinel/naming/tsx/rules-type-aware' | 'isentinel/node/rules' | 'isentinel/oxfmt/setup' | 'isentinel/oxfmt/javascript' | 'isentinel/oxfmt/typescript' | 'isentinel/oxfmt/css' | 'isentinel/oxfmt/scss' | 'isentinel/oxfmt/less' | 'isentinel/oxfmt/html' | 'isentinel/oxfmt/markdown' | 'isentinel/oxfmt/graphql' | 'isentinel/oxfmt/json' | 'isentinel/oxfmt/yaml' | 'isentinel/package-json/setup' | 'isentinel/package-json' | 'isentinel/package-json/root' | 'isentinel/perfectionist/setup' | 'isentinel/perfectionist' | 'isentinel/perfectionist/jsx' | 'isentinel/pnpm/setup' | 'isentinel/pnpm/package-json' | 'isentinel/pnpm/pnpm-workspace-yaml' | 'isentinel/project-structure/setup' | 'isentinel/project-structure/rules' | 'isentinel/promise' | 'isentinel/react/setup' | 'isentinel/react/setup/naming' | 'isentinel/react/setup/testing-library' | 'isentinel/react/rules' | 'isentinel/react/type-aware-rules' | 'isentinel/roblox/setup' | 'isentinel/roblox/parser' | 'isentinel/roblox/type-aware-parser' | 'isentinel/roblox' | 'isentinel/roblox/rules-type-aware' | 'isentinel/roblox/format-lua/setup' | 'isentinel/roblox/format-lua' | 'isentinel/small-rules/setup' | 'isentinel/small-rules' | 'isentinel/sonarjs' | 'isentinel/spelling/setup' | 'isentinel/spelling' | 'isentinel/stylistic/setup' | 'isentinel/stylistic' | 'isentinel/test/jest/setup' | 'isentinel/test/jest/rules' | 'isentinel/test/jest/type-tests' | 'isentinel/test/vitest/setup' | 'isentinel/test/vitest/rules' | 'isentinel/test/vitest/type-tests' | 'isentinel/toml/setup' | 'isentinel/toml/rules' | 'isentinel/typescript/setup' | 'isentinel/typescript/parser' | 'isentinel/typescript/type-aware-parser' | 'isentinel/typescript/rules' | 'isentinel/typescript/rules-type-aware' | 'isentinel/typescript/erasable-syntax-only' | 'isentinel/unicorn/setup' | 'isentinel/unicorn/rules' | 'isentinel/unicorn/root' | 'isentinel/yaml/setup' | 'isentinel/yaml/rules';
 //#endregion
 //#region src/utils.d.ts
 type ExtractRuleOptions<T> = T extends Linter.RuleEntry<infer U> ? U : never;
@@ -27496,6 +27524,37 @@ interface NamingConfig extends OptionsOverridesTypeAware {
    */
   selectorsTsx?: Array<NamingSelector>;
 }
+interface ProjectStructureConfig extends OptionsOverrides {
+  /**
+   * The files each linted source file has to sit next to, as
+   * `enforceExistence` templates. Takes the plugin's name placeholders
+   * (`{nodeName}`, `{NodeName}`, `{node-name}`, `{node_name}`,
+   * `{NODE_NAME}`) plus `{ext}` for the extension of the file that matched.
+   * A file already matching a template is exempt from it.
+   *
+   * @default ["{node-name}.spec.{ext}"]
+   */
+  enforceExistence?: Array<string> | string;
+  /**
+   * Files exempt from the check.
+   *
+   * @default [...GLOB_TESTS, GLOB_DTS, ...GLOB_BUILD_CONFIGS]
+   */
+  ignores?: Array<string>;
+  /**
+   * The folder the enforced paths resolve against, and where the plugin
+   * writes `projectStructure.cache.json` when it reports.
+   *
+   * @default process.cwd()
+   */
+  projectRoot?: string;
+  /**
+   * Restricts the check to one subtree of `projectRoot`, as a relative path.
+   *
+   * @default undefined - the whole of `projectRoot`
+   */
+  structureRoot?: string;
+}
 interface OptionsTypeScriptParserOptions {
   /**
    * Glob patterns for files that should be type aware.
@@ -27844,6 +27903,14 @@ interface OptionsConfig extends OptionsComponentExtensions, OptionsProjectType {
    * @see https://github.com/antfu/pnpm-workspace-utils
    */
   pnpm?: boolean | OptionsPnpm;
+  /**
+   * Require every source file to have a co-located test file, via
+   * [eslint-plugin-project-structure](https://github.com/Igorkowalski94/eslint-plugin-project-structure).
+   *
+   * @default false
+   * @requires eslint-plugin-project-structure
+   */
+  projectStructure?: boolean | ProjectStructureConfig;
   /**
    * Enable react rules.
    *
@@ -28282,6 +28349,9 @@ declare function perfectionist(config?: OptionsProjectType & PerfectionistConfig
 //#region src/eslint/configs/pnpm.d.ts
 declare function pnpm(options: OptionsPnpm & Required<OptionsIsInEditor>): Promise<Array<TypedFlatConfigItem>>;
 //#endregion
+//#region src/eslint/configs/project-structure.d.ts
+declare function projectStructure({ enforceExistence, files, ignores, overrides, projectRoot, structureRoot }?: ProjectStructureConfig): Promise<Array<TypedFlatConfigItem>>;
+//#endregion
 //#region src/eslint/configs/promise.d.ts
 declare function promise(): Array<TypedFlatConfigItem>;
 //#endregion
@@ -28388,4 +28458,4 @@ declare function unicorn({ complementIgnores, nameReplacements, roblox, root: cu
 //#region src/eslint/configs/yaml.d.ts
 declare function yaml({ files, overrides, stylistic }?: OptionsFiles & OptionsOverrides & OptionsStylistic): Promise<Array<TypedFlatConfigItem>>;
 //#endregion
-export { type Awaitable, type ConfigNames, type ConfigSettings, type FlatConfigComposer, GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BIN, GLOB_BUILD_CONFIGS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, GitignoreOptions, type JsdocOptions, MARKDOWN_PROCESSOR_NAME, type NamedFlatConfigItem, type NamedOptionsConfig, type NamingConfig, type NamingSelector, type OptionsComponentExtensions, type OptionsConfig, type OptionsE18e, type OptionsFiles, type OptionsFilesTypeAware, type OptionsFormatters, type OptionsHasRoblox, type OptionsHasTypeScript, type OptionsIsInEditor, type OptionsJest, type OptionsOverrides, type OptionsOverridesTypeAware, type OptionsPnpm, type OptionsProjectType, type OptionsStylistic, type OptionsTestFramework, type OptionsTypeScriptErasableOnly, type OptionsTypeScriptParserOptions, type OptionsTypeScriptWithTypes, type OptionsTypescript, type OptionsUnicorn, type OptionsVitest, type OxfmtOptions, type PerfectionistConfig, type PrettierOptions, ROBLOX_ALLOWED_WORDS, type ReactConfig, type ReactSettings, type Rules, type SpellCheckConfig, type StylisticConfig, StylisticConfigDefaults, type TypedFlatConfigItem, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores$1 as ignores, imports, isAgentAutofixDisabled, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox$1 as roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic$1 as stylistic, test, toml, typescript, unicorn, yaml };
+export { type Awaitable, type ConfigNames, type ConfigSettings, type FlatConfigComposer, GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BIN, GLOB_BUILD_CONFIGS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, GitignoreOptions, type JsdocOptions, MARKDOWN_PROCESSOR_NAME, type NamedFlatConfigItem, type NamedOptionsConfig, type NamingConfig, type NamingSelector, type OptionsComponentExtensions, type OptionsConfig, type OptionsE18e, type OptionsFiles, type OptionsFilesTypeAware, type OptionsFormatters, type OptionsHasRoblox, type OptionsHasTypeScript, type OptionsIsInEditor, type OptionsJest, type OptionsOverrides, type OptionsOverridesTypeAware, type OptionsPnpm, type OptionsProjectType, type OptionsStylistic, type OptionsTestFramework, type OptionsTypeScriptErasableOnly, type OptionsTypeScriptParserOptions, type OptionsTypeScriptWithTypes, type OptionsTypescript, type OptionsUnicorn, type OptionsVitest, type OxfmtOptions, type PerfectionistConfig, type PrettierOptions, type ProjectStructureConfig, ROBLOX_ALLOWED_WORDS, type ReactConfig, type ReactSettings, type Rules, type SpellCheckConfig, type StylisticConfig, StylisticConfigDefaults, type TypedFlatConfigItem, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores$1 as ignores, imports, isAgentAutofixDisabled, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, projectStructure, promise, react, roblox$1 as roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic$1 as stylistic, test, toml, typescript, unicorn, yaml };

package/dist/index.mjs

@@ -1576,8 +1576,10 @@ function disables({ root, workspaceRoot }) {
 			rules: {
 				"antfu/no-top-level-await": "off",
 				"no-console": "off",
+				"roblox/no-null": "off",
 				"small-rules/require-async-suffix": "off",
-				"ts/explicit-function-return-type": "off"
+				"ts/explicit-function-return-type": "off",
+				"unicorn/no-null": "off"
 			}
 		},
 		{
@@ -1640,7 +1642,8 @@ function disables({ root, workspaceRoot }) {
 				"import/no-default-export": "off",
 				"small-rules/require-async-suffix": "off",
 				"sonar/file-name-differ-from-class": "off",
-				"unicorn/filename-case": "off"
+				"unicorn/filename-case": "off",
+				"unicorn/no-null": "off"
 			}
 		},
 		{
@@ -1886,7 +1889,7 @@ async function flawless(options = {}, prettierOptions = {}) {
 	];
 }
 //#endregion
-//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@eslint/compat/2.1.0/b781043dbe4db6d501df442031a61cb3b4cc6aca6bc33271bed3c8c8e1ad757d/node_modules/@eslint/compat/dist/esm/index.js
+//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@eslint/compat/2.1.0/90f1da88f603538864cab10657b202d55290237a3b641df9ac72b842a3be07f2/node_modules/@eslint/compat/dist/esm/index.js
 /**
 * @fileoverview Ignore file utilities for the compat package.
 * @author Nicholas C. Zakas
@@ -1915,7 +1918,7 @@ function convertIgnorePatternToMinimatch(pattern) {
 }
 var init_esm$1 = __esmMin((() => {}));
 //#endregion
-//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-config-flat-gitignore/2.3.0/1320bd07004d149fd5c550ffda02aec5ecff7717d8f1602b7e9e51dffe8368d5/node_modules/eslint-config-flat-gitignore/dist/index.mjs
+//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-config-flat-gitignore/2.3.0/0a594adbd94ca75e2950b1104992894d49bc93f4f2bc935ad192d7104e4c271e/node_modules/eslint-config-flat-gitignore/dist/index.mjs
 var dist_exports = /* @__PURE__ */ __exportAll$2({ default: () => ignore });
 function toArray(array) {
 	array = array ?? [];
@@ -3947,6 +3950,92 @@ async function detectCatalogUsage() {
 	return yaml.includes("catalog:") || yaml.includes("catalogs:");
 }
 //#endregion
+//#region src/rules/project-structure.ts
+init_globs();
+/** Stands for the extension of the file a rule matched. */
+const EXTENSION_TOKEN = "{ext}";
+const DEFAULT_ENFORCE_EXISTENCE = [`{node-name}.spec.${EXTENSION_TOKEN}`];
+/** Reusable-rule id for "a folder of any name". */
+const ANY_FOLDER = "isentinelAnyFolder";
+/** The files the co-location check runs on, before `ignores`. */
+const PROJECT_STRUCTURE_FILES = [GLOB_SRC];
+/** The files the co-location check skips. */
+const PROJECT_STRUCTURE_IGNORES = [
+	...GLOB_TESTS,
+	GLOB_DTS,
+	...GLOB_BUILD_CONFIGS
+];
+/**
+* Co-location rules shared between the ESLint and oxlint factories.
+*
+* `folder-structure` is not type-aware and runs unchanged as an oxlint
+* jsPlugin, so both engines have to hand it the same options or they disagree
+* about which files are co-located.
+*
+* @param options - The templates to enforce, and the roots they resolve
+*   against.
+* @returns The rule map.
+*/
+function folderStructureRules({ enforceExistence = DEFAULT_ENFORCE_EXISTENCE, projectRoot = process.cwd(), structureRoot } = {}) {
+	const children = buildChildren(typeof enforceExistence === "string" ? [enforceExistence] : enforceExistence);
+	return { "project-structure/folder-structure": ["error", {
+		longPathsInfo: false,
+		projectRoot,
+		rules: { [ANY_FOLDER]: {
+			name: "*",
+			children
+		} },
+		structure: children,
+		...structureRoot === void 0 ? {} : { structureRoot }
+	}] };
+}
+/**
+* The rules matching the files inside one folder, in the order
+* `folder-structure` tries them - first match wins.
+*
+* Every entry is permissive: `structure` is required by the rule and an
+* unmatched node is an error, so anything less would turn the co-location
+* check into whole-tree naming enforcement.
+*
+* @param templates - The `enforceExistence` templates, before substitution.
+* @returns The child rules, ending in the recursive folder rule.
+*/
+function buildChildren(templates) {
+	const children = templates.map((template) => {
+		return { name: (template.split("/").pop() ?? template).replaceAll(/\{[^{}]*\}/g, "*") };
+	});
+	for (const extension of GLOB_SRC_EXTENSIONS) children.push({
+		name: `*.${extension}`,
+		enforceExistence: templates.map((template) => {
+			return template.replaceAll(EXTENSION_TOKEN, () => extension);
+		})
+	});
+	children.push({ ruleId: ANY_FOLDER });
+	return children;
+}
+//#endregion
+//#region src/eslint/configs/project-structure.ts
+async function projectStructure({ enforceExistence, files = PROJECT_STRUCTURE_FILES, ignores = PROJECT_STRUCTURE_IGNORES, overrides = {}, projectRoot, structureRoot } = {}) {
+	await ensurePackages(["eslint-plugin-project-structure"]);
+	const { projectStructurePlugin } = await import("eslint-plugin-project-structure");
+	return [{
+		name: "isentinel/project-structure/setup",
+		plugins: { "project-structure": projectStructurePlugin }
+	}, {
+		name: "isentinel/project-structure/rules",
+		files,
+		ignores,
+		rules: {
+			...folderStructureRules({
+				enforceExistence,
+				projectRoot,
+				structureRoot
+			}),
+			...overrides
+		}
+	}];
+}
+//#endregion
 //#region src/rules/promise.ts
 /**
 * Promise rules shared between the ESLint and oxlint factories.
@@ -6154,7 +6243,7 @@ async function unicorn({ complementIgnores, nameReplacements, roblox = true, roo
 	];
 }
 //#endregion
-//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-plugin-yml/3.5.0/286798c5ceb234dddb418d7e51fa7c87c58efb51bf8e94fcfd0ad11404fe81c8/node_modules/eslint-plugin-yml/lib/chunk-CfYAbeIz.mjs
+//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-plugin-yml/3.5.0/a00fc88a04d0f2081267792f61f05ad4ceff0f52e1ff41acbbc866518b4fd9c1/node_modules/eslint-plugin-yml/lib/chunk-CfYAbeIz.mjs
 var __defProp$1, __exportAll$1;
 var init_chunk_CfYAbeIz = __esmMin((() => {
 	__defProp$1 = Object.defineProperty;
@@ -9337,7 +9426,7 @@ var init_lib$1 = __esmMin((() => {
 	({ ...meta_exports$1 });
 }));
 //#endregion
-//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-plugin-yml/3.5.0/286798c5ceb234dddb418d7e51fa7c87c58efb51bf8e94fcfd0ad11404fe81c8/node_modules/eslint-plugin-yml/lib/index.mjs
+//#region ../../../setup-pnpm/node_modules/.bin/store/v11/links/@/eslint-plugin-yml/3.5.0/a00fc88a04d0f2081267792f61f05ad4ceff0f52e1ff41acbbc866518b4fd9c1/node_modules/eslint-plugin-yml/lib/index.mjs
 var lib_exports = /* @__PURE__ */ __exportAll$2({
 	configs: () => configs,
 	default: () => src_default,
@@ -15344,6 +15433,7 @@ const typeAwarePrefixes = /* @__PURE__ */ new Set([
 	"package-json",
 	"perfectionist",
 	"pnpm",
+	"project-structure",
 	"promise",
 	"react",
 	"react-jsx",
@@ -15594,6 +15684,7 @@ var init_adapters = __esmMin((() => {
 		"oxfmt": "eslint-plugin-oxfmt",
 		"oxlint-comments": "oxlint-plugin-oxlint-comments",
 		"perfectionist": "eslint-plugin-perfectionist",
+		"project-structure": "eslint-plugin-project-structure",
 		"promise-js": "eslint-plugin-promise",
 		"react-jsx": "eslint-plugin-react-jsx",
 		"react-naming-convention": "eslint-plugin-react-naming-convention",
@@ -16483,6 +16574,9 @@ var init_oxlint_capabilities = __esmMin((() => {
 		"prefer-spread",
 		"prefer-template",
 		"preserve-caught-error",
+		"project-structure/file-composition",
+		"project-structure/folder-structure",
+		"project-structure/independent-modules",
 		"promise/always-return",
 		"promise/avoid-new",
 		"promise/catch-or-return",
@@ -19919,7 +20013,7 @@ const flatConfigProps = [
 	"settings"
 ];
 async function isentinel(options, ...userConfigs) {
-	const { autoRenamePlugins = true, componentExts: componentExtensions = [], e18e: enableE18e = true, eslintPlugin: enableEslintPlugin = false, formatters, gitignore: enableGitignore = true, jsdoc: enableJsdoc = true, jsonc: enableJsonc = true, jsx: enableJsx = true, markdown: enableMarkdown = true, oxlint: enableOxlint = false, pnpm: enableCatalogs = findUpSync("pnpm-workspace.yaml") !== void 0, react: enableReact = false, root: customRootGlobs, spellCheck: enableSpellCheck, toml: enableToml = true, yaml: enableYaml = true } = options;
+	const { autoRenamePlugins = true, componentExts: componentExtensions = [], e18e: enableE18e = true, eslintPlugin: enableEslintPlugin = false, formatters, gitignore: enableGitignore = true, jsdoc: enableJsdoc = true, jsonc: enableJsonc = true, jsx: enableJsx = true, markdown: enableMarkdown = true, oxlint: enableOxlint = false, pnpm: enableCatalogs = findUpSync("pnpm-workspace.yaml") !== void 0, projectStructure: enableProjectStructure = false, react: enableReact = false, root: customRootGlobs, spellCheck: enableSpellCheck, toml: enableToml = true, yaml: enableYaml = true } = options;
 	const rootGlobs = mergeGlobs(GLOB_ROOT, customRootGlobs);
 	const enableRoblox = options.roblox !== false;
 	const reactOptions = resolveSubOptions(options, "react");
@@ -20042,6 +20136,7 @@ async function isentinel(options, ...userConfigs) {
 			...testOptions
 		}));
 	}
+	if (enableProjectStructure !== false) configs.push(projectStructure(resolveSubOptions(options, "projectStructure")));
 	if (enableReact !== false) configs.push(react({
 		...resolveSubOptions(options, "react"),
 		...getOverrides(options, "react"),
@@ -20169,4 +20264,4 @@ async function isentinel(options, ...userConfigs) {
 	return composer;
 }
 //#endregion
-export { GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BIN, GLOB_BUILD_CONFIGS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, MARKDOWN_PROCESSOR_NAME, ROBLOX_ALLOWED_WORDS, StylisticConfigDefaults, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores, imports, isAgentAutofixDisabled, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic, test, toml, typescript, unicorn, yaml };
+export { GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BIN, GLOB_BUILD_CONFIGS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, MARKDOWN_PROCESSOR_NAME, ROBLOX_ALLOWED_WORDS, StylisticConfigDefaults, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores, imports, isAgentAutofixDisabled, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, projectStructure, promise, react, roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic, test, toml, typescript, unicorn, yaml };

package/dist/lint-cli.mjs

@@ -38,7 +38,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 //#region package.json
-var version = "6.0.0-beta.42";
+var version = "6.0.0-beta.44";
 //#endregion
 //#region src/lint-cli/lib/cli/types.ts
 /**
@@ -1104,17 +1104,22 @@ const PACKAGE_RESOLUTION = {
 */
 function applyHashBust(run, bust, hash) {
 	if (hash === void 0) return {
-		busted: false,
+		cleared: [],
 		firstRun: false
 	};
 	const swap = swapState(statePath(run.cwd, bust.name, run.key), hash);
 	if (swap !== "changed") return {
-		busted: false,
+		cleared: [],
 		firstRun: swap === "first"
 	};
-	for (const base of bust.caches) fs.rmSync(path.resolve(run.cwd, cacheFileFor(base, run.key)), { force: true });
+	const cleared = [];
+	for (const base of bust.caches) {
+		const cacheFilePath = path.resolve(run.cwd, cacheFileFor(base, run.key));
+		fs.rmSync(cacheFilePath, { force: true });
+		cleared.push(cacheFilePath);
+	}
 	return {
-		busted: true,
+		cleared,
 		firstRun: false
 	};
 }
@@ -4854,6 +4859,17 @@ function buildGateValue(resolution, options) {
 //#region src/lint-cli/lib/typescript/affected.ts
 const warned = /* @__PURE__ */ new Set();
 /**
+* State-file base name for the builder's incremental state, shared by the
+* per-project path and the prefix {@link hasBuilderState} scans for.
+*/
+const BUILD_INFO_STATE = "tsbuildinfo";
+/**
+* State-file base name for the gate paired with each buildinfo. Deliberately
+* not a `tsbuildinfo-` suffix, so anything enumerating a variant's buildinfo
+* files does not pick a gate up as one (see {@link gateStatePath}).
+*/
+const GATE_STATE = "tsgate";
+/**
 * Compute the set of files whose type-aware lint results may have changed since
 * the previous run, using TypeScript's builder API. The builder does a native
 * shape-hash BFS: it recomputes each dependent's emitted-`.d.ts` shape hash and
@@ -4911,6 +4927,44 @@ function computeAffectedFiles({ key, cwd }, mode) {
 	}
 }
 /**
+* Whether a previous run left builder state for this mode and config variant.
+*
+* The one thing a builder pass does that nothing else can is establish this
+* state. Its affected set is disposable — a caller with an empty cache re-lints
+* regardless — but a run that skips the builder while no state exists only
+* defers the cost onto the next run, which then reports `firstRun` and throws
+* its affected set away. A file edited in between would be re-linted on its own
+* mtime while its importers kept stale type-aware cache entries, which no later
+* run revisits. Callers that skip the builder as an optimisation ask this
+* first.
+*
+* Any one project's state is enough: {@link computeAffectedFiles} reports
+* `firstRun` only when no project at all had state, and a newly added project
+* contributes its whole file set rather than an empty one.
+*
+* @param run - The run context.
+* @param mode - The active ESLint type-aware mode (never `"off"` here).
+* @returns True when at least one buildinfo for this mode and variant exists.
+*/
+function hasBuilderState({ key, cwd }, mode) {
+	const prefix = `${path.basename(statePath(cwd, BUILD_INFO_STATE, modeSuffix(mode), key))}-`;
+	try {
+		return fs.readdirSync(stateDirectory(cwd)).some((name) => name.startsWith(prefix) && !name.endsWith(".tmp"));
+	} catch {
+		return false;
+	}
+}
+/**
+* The state-file segment discriminating the type-aware mode a builder ran
+* under. Two modes resolve different programs, so their state cannot be shared.
+*
+* @param mode - The active ESLint type-aware mode (never `"off"` here).
+* @returns The file-name segment for that mode.
+*/
+function modeSuffix(mode) {
+	return mode === "only" ? "typeaware" : "full";
+}
+/**
 * Resolve the builder incremental-state (`.tsbuildinfo`) file for a mode and
 * config variant.
 *
@@ -4934,7 +4988,7 @@ function computeAffectedFiles({ key, cwd }, mode) {
 * @returns The absolute path to the mode's buildinfo file.
 */
 function builderStatePath(cwd, mode, key, projectId) {
-	return statePath(cwd, "tsbuildinfo", mode === "only" ? "typeaware" : "full", key, projectId);
+	return statePath(cwd, BUILD_INFO_STATE, modeSuffix(mode), key, projectId);
 }
 /**
 * Resolve the gate state paired with one {@link builderStatePath} buildinfo:
@@ -4959,7 +5013,7 @@ function builderStatePath(cwd, mode, key, projectId) {
 * @returns The absolute path to the gate state file.
 */
 function gateStatePath(cwd, mode, key, projectId) {
-	return statePath(cwd, "tsgate", mode === "only" ? "typeaware" : "full", key, projectId);
+	return statePath(cwd, GATE_STATE, modeSuffix(mode), key, projectId);
 }
 /**
 * Emit a warning at most once per distinct message. Keyed by message rather
@@ -5291,15 +5345,17 @@ function sizePasses(descriptors, run, inputs) {
 * @returns The number of dirty files.
 */
 function mutatingDirtyCount(descriptor, cacheLocation, targetFiles, { clearedCaches, run }) {
-	if (clearedCaches.has(cacheLocation)) return targetFiles.length;
+	const buildsProgram = descriptor.invalidation !== "none";
+	const mode = descriptor.invalidation === "only" ? "only" : void 0;
+	if (clearedCaches.has(cacheLocation) && (!buildsProgram || hasBuilderState(run, mode))) return targetFiles.length;
 	const cache = openCache(cacheLocation, run.ci);
 	const dirty = new Set((cache?.getUpdatedFiles(targetFiles) ?? targetFiles).map((file) => normalizePath(file)));
-	if (descriptor.invalidation !== "none") {
+	if (buildsProgram) {
 		const outcome = applyTypeAwareInvalidation(run, {
 			alreadyDirty: dirty,
 			cache,
 			cacheLocation,
-			mode: descriptor.invalidation === "only" ? "only" : void 0,
+			mode,
 			targetFiles
 		});
 		if (outcome.busted) return targetFiles.length;
@@ -5423,9 +5479,13 @@ function plan(options, run) {
 	const canMutateCaches = mutate && options.cache;
 	const hasTypeAwarePass = descriptors.some((descriptor) => descriptor.invalidation !== "none");
 	const configHash = options.cache ? computeConfigHash(cwd, files.configFiles) : void 0;
-	if (canMutateCaches) applyHashBust(run, CONFIG_DRIFT, configHash);
-	if (canMutateCaches && hasTypeAwarePass) applyHashBust(run, PACKAGE_RESOLUTION, computePackageJsonHash(cwd));
-	const clearedCaches = new Set(canMutateCaches ? sweepStaleCaches(cwd, newestBustMtime) : []);
+	const cleared = [];
+	if (canMutateCaches) {
+		cleared.push(...applyHashBust(run, CONFIG_DRIFT, configHash).cleared);
+		if (hasTypeAwarePass) cleared.push(...applyHashBust(run, PACKAGE_RESOLUTION, computePackageJsonHash(cwd)).cleared);
+		cleared.push(...sweepStaleCaches(cwd, newestBustMtime));
+	}
+	const clearedCaches = new Set(cleared);
 	const sizingFiles = withoutIgnored(files, resolveIgnoredFiles(run, configHash, files.lintable));
 	const inputs = {
 		clearedCaches,

package/dist/oxlint.d.mts

@@ -3860,6 +3860,7 @@ interface OverrideSiteChains {
   e18e: MainChain;
   eslintPlugin: FeatureChain;
   javascript: MainChain;
+  projectStructure: FeatureChain;
   react: ReactChain;
   roblox: MainChain;
   typescript: MainChain;
@@ -7787,6 +7788,21 @@ interface RuleOptions {
    * @see https://eslint.org/docs/latest/rules/preserve-caught-error
    */
   'preserve-caught-error'?: Linter.RuleEntry<PreserveCaughtError>;
+  /**
+   * Enforce advanced naming rules and prohibit the use of given selectors in a given file. Have full control over what your file can contain and the naming conventions it must follow.
+   * @see https://github.com/Igorkowalski94/eslint-plugin-project-structure/wiki/project%E2%80%91structure-%E2%80%8Bfile%E2%80%91composition#root
+   */
+  'project-structure/file-composition'?: Linter.RuleEntry<ProjectStructureFileComposition>;
+  /**
+   * Enforce rules on folder structure to keep your repository consistent, orderly and well thought out.
+   * @see https://github.com/Igorkowalski94/eslint-plugin-project-structure/wiki/project%E2%80%91structure-%E2%80%8Bfolder%E2%80%91structure#root
+   */
+  'project-structure/folder-structure'?: Linter.RuleEntry<ProjectStructureFolderStructure>;
+  /**
+   * A key principle of a healthy project is to prevent the creation of a massive dependency tree, where removing or editing one feature triggers a chain reaction that impacts the entire project. Create independent modules to keep your project scalable and easy to maintain. Get rid of dependencies between modules and create truly independent functionalities.
+   * @see https://github.com/Igorkowalski94/eslint-plugin-project-structure/wiki/project%E2%80%91structure-%E2%80%8Bindependent%E2%80%91modules#root
+   */
+  'project-structure/independent-modules'?: Linter.RuleEntry<ProjectStructureIndependentModules>;
   /**
    * Require returning inside each `then()` to create readable and reusable Promise chains.
    * @see https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/always-return.md
@@ -20595,6 +20611,18 @@ type PreserveCaughtError = [] | [{
     argumentPosition: number;
   })[];
 }];
+// ----- project-structure/file-composition -----
+type ProjectStructureFileComposition = [] | [{
+  [k: string]: unknown | undefined;
+}];
+// ----- project-structure/folder-structure -----
+type ProjectStructureFolderStructure = [] | [{
+  [k: string]: unknown | undefined;
+}];
+// ----- project-structure/independent-modules -----
+type ProjectStructureIndependentModules = [] | [{
+  [k: string]: unknown | undefined;
+}];
 // ----- promise/always-return -----
 type PromiseAlwaysReturn = [] | [{
   ignoreLastCallback?: boolean;
@@ -24764,6 +24792,37 @@ interface NamingConfig extends OptionsOverridesTypeAware {
    */
   selectorsTsx?: Array<NamingSelector>;
 }
+interface ProjectStructureConfig extends OptionsOverrides {
+  /**
+   * The files each linted source file has to sit next to, as
+   * `enforceExistence` templates. Takes the plugin's name placeholders
+   * (`{nodeName}`, `{NodeName}`, `{node-name}`, `{node_name}`,
+   * `{NODE_NAME}`) plus `{ext}` for the extension of the file that matched.
+   * A file already matching a template is exempt from it.
+   *
+   * @default ["{node-name}.spec.{ext}"]
+   */
+  enforceExistence?: Array<string> | string;
+  /**
+   * Files exempt from the check.
+   *
+   * @default [...GLOB_TESTS, GLOB_DTS, ...GLOB_BUILD_CONFIGS]
+   */
+  ignores?: Array<string>;
+  /**
+   * The folder the enforced paths resolve against, and where the plugin
+   * writes `projectStructure.cache.json` when it reports.
+   *
+   * @default process.cwd()
+   */
+  projectRoot?: string;
+  /**
+   * Restricts the check to one subtree of `projectRoot`, as a relative path.
+   *
+   * @default undefined - the whole of `projectRoot`
+   */
+  structureRoot?: string;
+}
 interface OptionsTypeScriptParserOptions {
   /**
    * Glob patterns for files that should be type aware.
@@ -25112,6 +25171,14 @@ interface OptionsConfig extends OptionsComponentExtensions, OptionsProjectType {
    * @see https://github.com/antfu/pnpm-workspace-utils
    */
   pnpm?: boolean | OptionsPnpm;
+  /**
+   * Require every source file to have a co-located test file, via
+   * [eslint-plugin-project-structure](https://github.com/Igorkowalski94/eslint-plugin-project-structure).
+   *
+   * @default false
+   * @requires eslint-plugin-project-structure
+   */
+  projectStructure?: boolean | ProjectStructureConfig;
   /**
    * Enable react rules.
    *
@@ -33193,7 +33260,7 @@ type OxlintCommentsRequireDescription = [] | [{
   ignore?: ("oxlint-disable" | "oxlint-disable-line" | "oxlint-disable-next-line" | "oxlint-enable")[];
 }];
 /** JsPlugin prefixes whose rules keep their ESLint-side names in oxlint configs. */
-type OxlintKeptJsPluginPrefix = '@cspell' | 'antfu' | 'better-max-params' | 'comment-length' | 'de-morgan' | 'e18e' | 'erasable-syntax-only' | 'eslint-plugin' | 'flawless' | 'jest-extended' | 'oxfmt' | 'perfectionist' | 'react-jsx' | 'react-naming-convention' | 'roblox' | 'sentinel' | 'small-rules' | 'sonar' | 'style' | 'testing-library' | 'ts' | 'unused-imports';
+type OxlintKeptJsPluginPrefix = '@cspell' | 'antfu' | 'better-max-params' | 'comment-length' | 'de-morgan' | 'e18e' | 'erasable-syntax-only' | 'eslint-plugin' | 'flawless' | 'jest-extended' | 'oxfmt' | 'perfectionist' | 'project-structure' | 'react-jsx' | 'react-naming-convention' | 'roblox' | 'sentinel' | 'small-rules' | 'sonar' | 'style' | 'testing-library' | 'ts' | 'unused-imports';
 /** JsPlugin rules whose oxlint names match the ESLint-side names. */
 type OxlintKeptJsPluginRuleOptions = { [K in keyof RuleOptions as K extends `${OxlintKeptJsPluginPrefix}/${string}` ? K : never]: RuleOptions[K]; };
 /** All rules known to the oxlint factory, keyed by canonical oxlint rule name. */

package/dist/oxlint.mjs

@@ -616,6 +616,9 @@ const jsPluginRuleNames = /* @__PURE__ */ new Set([
 	"prefer-spread",
 	"prefer-template",
 	"preserve-caught-error",
+	"project-structure/file-composition",
+	"project-structure/folder-structure",
+	"project-structure/independent-modules",
 	"promise/always-return",
 	"promise/avoid-new",
 	"promise/catch-or-return",
@@ -3237,6 +3240,7 @@ const enabledPresetRuleNames = /* @__PURE__ */ new Set([
 	"prefer-rest-params",
 	"prefer-spread",
 	"prefer-template",
+	"project-structure/folder-structure",
 	"promise/always-return",
 	"promise/catch-or-return",
 	"promise/no-multiple-resolved",
@@ -4746,6 +4750,7 @@ const oxlintJsPlugins = {
 	"oxfmt": "eslint-plugin-oxfmt",
 	"oxlint-comments": "oxlint-plugin-oxlint-comments",
 	"perfectionist": "eslint-plugin-perfectionist",
+	"project-structure": "eslint-plugin-project-structure",
 	"promise-js": "eslint-plugin-promise",
 	"react-jsx": "eslint-plugin-react-jsx",
 	"react-naming-convention": "eslint-plugin-react-naming-convention",
@@ -5164,6 +5169,23 @@ const GLOB_ROOT = [
 ];
 const GLOB_SRC_EXT = "{,c,m}[jt]s{,x}";
 const GLOB_SRC = "**/*.{,c,m}[jt]s{,x}";
+/**
+* The real TS/JS-family file extensions {@link GLOB_SRC_EXT} encodes (the glob
+* additionally matches non-existent combinations such as `cjsx`). Kept next to
+* the glob so the two are maintained together; consumed by the lint CLI to size
+* its type-aware pass.
+*/
+const GLOB_SRC_EXTENSIONS = [
+	"ts",
+	"tsx",
+	"mts",
+	"cts",
+	"js",
+	"jsx",
+	"mjs",
+	"cjs"
+];
+[...GLOB_SRC_EXTENSIONS];
 const GLOB_JSX = "**/*.{,c,m}jsx";
 const GLOB_TSX = "**/*.{,c,m}tsx";
 const GLOB_DTS = "**/*.d.{,c,m}ts";
@@ -6742,8 +6764,10 @@ function oxlintDisables({ configDirectory, root, workspaceRoot }) {
 			rules: {
 				"antfu/no-top-level-await": "off",
 				"no-console": "off",
+				"roblox/no-null": "off",
 				"small-rules/require-async-suffix": "off",
-				"ts/explicit-function-return-type": "off"
+				"ts/explicit-function-return-type": "off",
+				"unicorn/no-null": "off"
 			}
 		}),
 		...createOxlintConfigs({
@@ -6811,7 +6835,8 @@ function oxlintDisables({ configDirectory, root, workspaceRoot }) {
 				"import/no-default-export": "off",
 				"small-rules/require-async-suffix": "off",
 				"sonar/file-name-differ-from-class": "off",
-				"unicorn/filename-case": "off"
+				"unicorn/filename-case": "off",
+				"unicorn/no-null": "off"
 			}
 		}),
 		...createOxlintConfigs({
@@ -8009,6 +8034,94 @@ function oxlintPerfectionist(config) {
 	})];
 }
 //#endregion
+//#region src/rules/project-structure.ts
+/** Stands for the extension of the file a rule matched. */
+const EXTENSION_TOKEN = "{ext}";
+const DEFAULT_ENFORCE_EXISTENCE = [`{node-name}.spec.${EXTENSION_TOKEN}`];
+/** Reusable-rule id for "a folder of any name". */
+const ANY_FOLDER = "isentinelAnyFolder";
+/** The files the co-location check runs on, before `ignores`. */
+const PROJECT_STRUCTURE_FILES = [GLOB_SRC];
+/** The files the co-location check skips. */
+const PROJECT_STRUCTURE_IGNORES = [
+	...GLOB_TESTS,
+	GLOB_DTS,
+	...GLOB_BUILD_CONFIGS
+];
+/**
+* Co-location rules shared between the ESLint and oxlint factories.
+*
+* `folder-structure` is not type-aware and runs unchanged as an oxlint
+* jsPlugin, so both engines have to hand it the same options or they disagree
+* about which files are co-located.
+*
+* @param options - The templates to enforce, and the roots they resolve
+*   against.
+* @returns The rule map.
+*/
+function folderStructureRules({ enforceExistence = DEFAULT_ENFORCE_EXISTENCE, projectRoot = process.cwd(), structureRoot } = {}) {
+	const children = buildChildren(typeof enforceExistence === "string" ? [enforceExistence] : enforceExistence);
+	return { "project-structure/folder-structure": ["error", {
+		longPathsInfo: false,
+		projectRoot,
+		rules: { [ANY_FOLDER]: {
+			name: "*",
+			children
+		} },
+		structure: children,
+		...structureRoot === void 0 ? {} : { structureRoot }
+	}] };
+}
+/**
+* The rules matching the files inside one folder, in the order
+* `folder-structure` tries them - first match wins.
+*
+* Every entry is permissive: `structure` is required by the rule and an
+* unmatched node is an error, so anything less would turn the co-location
+* check into whole-tree naming enforcement.
+*
+* @param templates - The `enforceExistence` templates, before substitution.
+* @returns The child rules, ending in the recursive folder rule.
+*/
+function buildChildren(templates) {
+	const children = templates.map((template) => {
+		return { name: (template.split("/").pop() ?? template).replaceAll(/\{[^{}]*\}/g, "*") };
+	});
+	for (const extension of GLOB_SRC_EXTENSIONS) children.push({
+		name: `*.${extension}`,
+		enforceExistence: templates.map((template) => {
+			return template.replaceAll(EXTENSION_TOKEN, () => extension);
+		})
+	});
+	children.push({ ruleId: ANY_FOLDER });
+	return children;
+}
+//#endregion
+//#region src/oxlint/configs/project-structure.ts
+/**
+* Co-location rules for standalone oxlint.
+*
+* `folder-structure` runs as a jsPlugin: it visits `Program` once per file and
+* answers from the filesystem, so oxlint needs no type information to run it.
+*
+* @param options - The templates to enforce, and the roots they resolve
+*   against.
+* @returns The generated config fragments.
+*/
+function oxlintProjectStructure({ enforceExistence, files = PROJECT_STRUCTURE_FILES, ignores = PROJECT_STRUCTURE_IGNORES, overrides = {}, projectRoot, structureRoot } = {}) {
+	return createOxlintConfigs({
+		name: "isentinel/project-structure",
+		excludeFiles: ignores,
+		files: files.flat(),
+		overrides,
+		rules: folderStructureRules({
+			enforceExistence,
+			projectRoot,
+			structureRoot
+		})
+	});
+}
+//#endregion
 //#region src/rules/promise.ts
 /**
 * Promise rules shared between the ESLint and oxlint factories.
@@ -9226,7 +9339,7 @@ const NATIVE_ONLY_JS_PLUGINS = /* @__PURE__ */ new Set(["oxlint-comments"]);
 */
 function isentinel(factoryOptions, ...userConfigs) {
 	const options = factoryOptions ?? { name: "isentinel" };
-	const { categories, componentExts: componentExtensions = [], e18e: enableE18e = true, env, eslintPlugin: enableEslintPlugin = false, formatters, gitignore: enableGitignore = true, globals, ignores, jsdoc: enableJsdoc = true, jsPlugins: userJsPlugins, jsx: enableJsx = true, options: linterOptions, oxc: enableOxc = true, react: enableReact = false, root: customRootGlobs, rules = {}, spellCheck: enableSpellCheck, test: enableTest = false, warnDroppedOverrides: enableDroppedOverrideWarning = true } = options;
+	const { categories, componentExts: componentExtensions = [], e18e: enableE18e = true, env, eslintPlugin: enableEslintPlugin = false, formatters, gitignore: enableGitignore = true, globals, ignores, jsdoc: enableJsdoc = true, jsPlugins: userJsPlugins, jsx: enableJsx = true, options: linterOptions, oxc: enableOxc = true, projectStructure: enableProjectStructure = false, react: enableReact = false, root: customRootGlobs, rules = {}, spellCheck: enableSpellCheck, test: enableTest = false, warnDroppedOverrides: enableDroppedOverrideWarning = true } = options;
 	const rootGlobs = mergeGlobs(GLOB_ROOT, customRootGlobs);
 	const enableRoblox = options.roblox !== false;
 	const reactOptions = resolveSubOptions(options, "react");
@@ -9355,6 +9468,7 @@ function isentinel(factoryOptions, ...userConfigs) {
 		isInEditor
 	}));
 	if (enableEslintPlugin !== false) configs.push(oxlintEslintPlugin({ ...getOverrides(options, "eslintPlugin") }));
+	if (enableProjectStructure !== false) configs.push(oxlintProjectStructure(resolveSubOptions(options, "projectStructure")));
 	if (enableOxc) {
 		configs.push(oxlintOxc({ roblox: enableRoblox }));
 		if (needsComplementOverlay) configs.push(oxlintOxc({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isentinel/eslint-config",
-  "version": "6.0.0-beta.42",
+  "version": "6.0.0-beta.44",
   "description": "iSentinel's ESLint config",
   "keywords": [
     "eslint-config",
@@ -109,7 +109,7 @@
     "yargs": "18.0.0"
   },
   "devDependencies": {
-    "@antfu/ni": "30.2.0",
+    "@antfu/ni": "30.5.0",
     "@eslint-react/shared": "5.17.3",
     "@eslint/config-inspector": "3.1.0",
     "@isentinel/tsconfig": "1.2.0",
@@ -122,12 +122,13 @@
     "@types/yargs": "17.0.35",
     "@vitest/eslint-plugin": "1.6.26",
     "bumpp": "12.0.0",
-    "eslint": "10.7.0",
+    "eslint": "10.8.1",
     "eslint-plugin-erasable-syntax-only": "0.4.2",
     "eslint-plugin-eslint-plugin": "7.5.0",
     "eslint-plugin-jest": "29.16.0",
     "eslint-plugin-jest-extended": "3.0.1",
     "eslint-plugin-n": "18.2.2",
+    "eslint-plugin-project-structure": "3.14.3",
     "eslint-plugin-react-jsx": "5.17.3",
     "eslint-plugin-react-naming-convention": "5.17.3",
     "eslint-plugin-react-x": "5.17.3",
@@ -144,7 +145,7 @@
     "typescript": "6.0.3",
     "unplugin-unused": "0.5.7",
     "vitest": "4.1.10",
-    "@isentinel/eslint-config": "6.0.0-beta.42"
+    "@isentinel/eslint-config": "6.0.0-beta.44"
   },
   "peerDependencies": {
     "@vitest/eslint-plugin": "^1.6.4",
@@ -153,6 +154,7 @@
     "eslint-plugin-jest": "^29.15.0",
     "eslint-plugin-jest-extended": "^3.0.0",
     "eslint-plugin-n": "^17.0.0 || ^18.0.0",
+    "eslint-plugin-project-structure": "^3.14.0",
     "eslint-plugin-react-jsx": "^5.10.0",
     "eslint-plugin-react-naming-convention": "^5.10.0",
     "eslint-plugin-react-x": "^5.10.0",
@@ -176,6 +178,9 @@
     "eslint-plugin-n": {
       "optional": true
     },
+    "eslint-plugin-project-structure": {
+      "optional": true
+    },
     "eslint-plugin-react-jsx": {
       "optional": true
     },