@alexgorbatchev/typescript-ai-policy 0.1.0

package/README.md

@@ -0,0 +1,223 @@
+# @alexgorbatchev/typescript-ai-policy
+
+This package exists to codify TypeScript coding standards through lint rules as aggressively as practical.
+
+The goal is to replace as much prose-based LLM guidance as possible with strict, machine-enforced checks. The custom
+`@alexgorbatchev/*` rules turn repository conventions into deterministic policies, and their error messages are written
+as direct repair instructions so an agent can make the required change instead of interpreting vague prose.
+
+**The benefit is twofold: guaranteed enforcement and reduced number of context instructions.**
+
+The shared Oxlint policy is implemented in TypeScript-authored custom rule modules under `src/oxlint/`.
+
+Upstream rules stay enabled as baseline correctness guardrails around that stricter policy layer.
+
+These rules are designed to work as a **full policy set**, not as a grab bag of independent preferences. Disabling one
+rule can weaken contracts enforced by other rules, because many of the rules deliberately compose into a larger workflow
+for React structure, test layout, fixture ownership, and import discipline. Treat rule removal as a policy change, not
+as a local lint tweak.
+
+The fixture rules in particular form a **coupled contract** across:
+
+- location
+- allowed contents
+- export shape
+- naming
+- typing
+- import path
+- single entrypoint
+
+If one of those fixture rules is disabled, the rest of the fixture contract becomes less reliable as agent guidance.
+
+## Stated policy goals
+
+The policy pack exists to enforce consistency in generated and modified code by making the expected repository shape
+machine-checkable.
+
+At a high level, the enforced goals are:
+
+- one runtime React component per ownership file
+- one runtime hook per ownership file
+- every component ownership file must have a matching Storybook file under a sibling `stories/` directory
+- every exported story must be typed and include a `play` function
+- every hook ownership file must have a matching test file under a sibling `__tests__/` directory
+- non-story React components must expose deterministic test ids: the root id equals the component name, and child ids use `ComponentName--thing`
+- tests and test fixtures must stay under `__tests__/`, story files must stay under `stories/`, and fixture exports must stay inside those role directories
+- test-only code and fixture-only code must stay isolated from runtime modules
+
+## Folder and filename contract
+
+The shared policy now enforces **role directories**, not a single canonical feature tree.
+
+That means component and hook ownership files may live in whatever parent folders a consumer repository chooses, but
+some file roles still have hard placement requirements:
+
+- Story files must live somewhere under a sibling `stories/` directory.
+- Test files must live somewhere under a sibling `__tests__/` directory.
+- Fixture entrypoints and fixture directories must live under `stories/` or `__tests__/`.
+- Component filenames must still match their exported PascalCase component name in either PascalCase or kebab-case
+  form:
+  - `export function AccountPanel()` → `AccountPanel.tsx` or `account-panel.tsx`
+- Hook filenames must still match their exported hook name in either camelCase or kebab-case `use*` form:
+  - `export function useAccountSettings()` → `useAccountSettings.ts` / `useAccountSettings.tsx` or
+    `use-account-settings.ts` / `use-account-settings.tsx`
+- Every component ownership file must still have a matching `basename.stories.tsx` file under a sibling `stories/`
+  tree.
+- Every hook ownership file must still have a matching `basename.test.ts[x]` file under a sibling `__tests__/` tree.
+- Story files must still map back to a sibling component basename, default-export a typed `meta` binding, and export
+  typed stories whose objects include a `play` function.
+- `index.ts` is reserved for pure barrel re-exports only. `index.tsx` is invalid.
+- `constants.ts` is reserved for runtime values only.
+- `types.ts` is reserved for type-only exports only.
+
+A valid consumer layout can therefore look like any of these:
+
+```text
+feature/
+├── AccountPanel.tsx
+├── stories/
+│   ├── AccountPanel.stories.tsx
+│   └── catalog/
+│       └── AccountPanelAlt.stories.tsx
+├── useAccount.ts
+└── __tests__/
+    ├── useAccount.test.ts
+    └── integration/
+        └── AccountPanel.test.tsx
+```
+
+```text
+feature/
+├── ui/
+│   ├── account-panel.tsx
+│   └── stories/
+│       └── catalog/
+│           └── account-panel.stories.tsx
+└── data/
+    ├── use-account.ts
+    └── __tests__/
+        └── hooks/
+            └── use-account.test.ts
+```
+
+For the rule-by-rule rationale and examples behind this contract, see [`src/oxlint/README.md`](./src/oxlint/README.md).
+
+## Install
+
+```bash
+bun add -d @alexgorbatchev/typescript-ai-policy oxfmt oxlint
+```
+
+If you want the semantic-fix CLI, install its tsgo backend too:
+
+```bash
+bun add -d @typescript/native-preview
+```
+
+## Use
+
+`oxfmt.config.ts`
+
+```ts
+import createOxfmtConfig from "@alexgorbatchev/typescript-ai-policy/oxfmt-config";
+
+export default createOxfmtConfig(() => ({
+  ignorePatterns: ["vendor/**"],
+}));
+```
+
+`oxlint.config.ts`
+
+```ts
+import createOxlintConfig from "@alexgorbatchev/typescript-ai-policy/oxlint-config";
+
+export default createOxlintConfig(() => ({
+  ignorePatterns: ["coverage"],
+  rules: {
+    "no-var": "error",
+  },
+}));
+```
+
+Both config entrypoints now export factory functions. The callback is optional, it must return a valid Oxfmt/Oxlint
+config object, and that object is deep-merged **before** the shared defaults so the shared policy still wins on any
+conflicting keys.
+
+For Oxlint specifically, consumer configs are extension-only: if the callback tries to redefine any shared rule name,
+the factory throws with guidance to change the shared package instead of overriding that rule downstream.
+
+## Local package setup
+
+This package also uses its own shared configs at the repository root:
+
+- `oxfmt.config.ts`
+- `oxlint.config.ts`
+
+## Local semantic-fix tooling
+
+The repository now includes a local semantic-fix command under `src/semantic-fixes/` that uses `tsgo --lsp --stdio` as its first real backend.
+
+Useful commands:
+
+- `bun run fix:semantic -- <target-directory>` — run Oxlint with this repository's policy config, collect supported diagnostics, and apply semantic fixes to the target directory.
+- `bun run fix:semantic -- <target-directory> --dry-run` — print the planned semantic-fix scope without mutating files.
+- `typescript-ai-policy-fix-semantic <target-directory>` — run the same semantic fixer through the package-installed bin after installing this package and `@typescript/native-preview`.
+
+Today the framework applies two conservative semantic fixes:
+
+- `@alexgorbatchev/interface-naming-convention` — rename repository-owned interfaces to their required `I*` form when the existing name can be normalized safely.
+- `@alexgorbatchev/test-file-location-convention` — move misplaced `.test.ts` / `.test.tsx` files into a sibling `__tests__/` directory as `__tests__/basename.test.ts[x]` and rewrite the moved file's relative imports.
+
+The command and backend shape remain intentionally generic so more rule-backed semantic operations can be added later.
+
+## Enabled Oxlint error rules
+
+### Built-in guardrails
+
+| Rule                         | Policy encoded                                                            |
+| ---------------------------- | ------------------------------------------------------------------------- |
+| `eqeqeq`                     | Require `===` and `!==` so agents do not rely on coercion-based equality. |
+| `typescript/no-explicit-any` | Ban explicit `any` so type contracts stay checkable and reviewable.       |
+| `jest/no-disabled-tests`     | Block skipped or disabled tests in committed `*.test.ts(x)` files.        |
+| `jest/no-focused-tests`      | Block focused tests so CI and local runs exercise the full suite.         |
+
+### Custom agentic workflow rules
+
+For rule-by-rule rationale plus good/bad examples, see [`src/oxlint/README.md`](./src/oxlint/README.md).
+
+| Rule                                                            | Policy encoded                                                                                                                                                                                                                                                            |
+| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@alexgorbatchev/testid-naming-convention`                      | Non-story React test ids must be scoped to the owning component as `ComponentName` or `ComponentName--thing`.                                                                                                                                                             |
+| `@alexgorbatchev/no-react-create-element`                       | Regular application code must use JSX instead of `createElement`.                                                                                                                                                                                                         |
+| `@alexgorbatchev/require-component-root-testid`                 | Non-story exported React components must render a DOM root with `data-testid`/`testId` exactly equal to the component name, and child ids must use `ComponentName--thing`.                                                                                                |
+| `@alexgorbatchev/component-file-contract`                       | Component ownership files may export exactly one main runtime component plus unrestricted type-only API.                                                                                                                                                                  |
+| `@alexgorbatchev/component-file-naming-convention`              | Component filenames must match their exported PascalCase component name in either PascalCase or kebab-case form.                                                                                                                                                          |
+| `@alexgorbatchev/component-story-file-convention`               | Every component ownership file must have a matching `basename.stories.tsx` file somewhere under a sibling `stories/` directory.                                                                                                                                           |
+| `@alexgorbatchev/story-file-location-convention`                | Storybook files must live under sibling `stories/` directories and must still match a sibling component basename.                                                                                                                                                         |
+| `@alexgorbatchev/story-meta-type-annotation`                    | The default Storybook meta must use a typed `const meta: Meta<typeof ComponentName>` binding instead of object assertions.                                                                                                                                                |
+| `@alexgorbatchev/story-export-contract`                         | Story exports must use typed `Story` bindings, every story must define `play`, and single-story vs multi-story export shapes are enforced.                                                                                                                                |
+| `@alexgorbatchev/hook-file-contract`                            | Hook ownership files may export exactly one main runtime hook and it must use `export function useThing() {}` form.                                                                                                                                                       |
+| `@alexgorbatchev/hook-file-naming-convention`                   | Hook filenames must match their exported hook name as either `useFoo.ts[x]` or `use-foo.ts[x]`.                                                                                                                                                                           |
+| `@alexgorbatchev/hook-test-file-convention`                     | Every hook ownership file must have a matching `__tests__/basename.test.ts[x]` file somewhere under a sibling `__tests__/` directory, with the same source extension family.                                                                                              |
+| `@alexgorbatchev/no-non-running-tests`                          | Ban skip/todo/gated test modifiers that still leave non-running test code after the Jest rules run.                                                                                                                                                                       |
+| `@alexgorbatchev/no-conditional-logic-in-tests`                 | Ban `if`, `switch`, and ternary control flow in committed `*.test.ts(x)` files so assertions execute deterministically and test paths stay explicit.                                                                                                                      |
+| `@alexgorbatchev/no-throw-in-tests`                             | Ban `throw new Error(...)` in committed `*.test.ts(x)` files so failures use explicit `assert(...)` / `assert.fail(...)` calls instead of ad-hoc exception paths.                                                                                                         |
+| `@alexgorbatchev/no-module-mocking`                             | Ban whole-module mocking APIs and push tests toward dependency injection plus explicit stubs.                                                                                                                                                                             |
+| `@alexgorbatchev/no-test-file-exports`                          | Treat `*.test.ts(x)` files as execution units, not shared modules.                                                                                                                                                                                                        |
+| `@alexgorbatchev/no-imports-from-tests-directory`               | Files outside `__tests__/` must not import, require, or re-export modules from any `__tests__/` directory.                                                                                                                                                                |
+| `@alexgorbatchev/interface-naming-convention`                   | Repository-owned interfaces must use `I` followed by PascalCase; ambient external contract interfaces such as `Window` stay exempt.                                                                                                                                       |
+| `@alexgorbatchev/no-inline-type-expressions`                    | Explicit type usage must rely on named declarations or inference; do not define object, tuple, function, broad union, intersection, mapped, or conditional types inline at use sites. Narrow `T \| null \| undefined` wrappers stay allowed.                              |
+| `@alexgorbatchev/require-template-indent`                       | Multiline template literals that begin on their own line must keep their content indented with the surrounding code so embedded text stays reviewable and intentional.                                                                                                    |
+| `@alexgorbatchev/index-file-contract`                           | `index.ts` must stay a pure barrel: no local definitions, no side effects, only re-exports, and never `index.tsx`.                                                                                                                                                        |
+| `@alexgorbatchev/no-type-imports-from-constants`                | Types must not be imported from `constants` modules, including inline `import("./constants")` type queries.                                                                                                                                                               |
+| `@alexgorbatchev/no-type-exports-from-constants`                | `constants.ts` files may export runtime values only; exported types must move to `types.ts`.                                                                                                                                                                              |
+| `@alexgorbatchev/no-value-exports-from-types`                   | `types.ts` files may export type-only API only; runtime values and value re-exports must move elsewhere.                                                                                                                                                                  |
+| `@alexgorbatchev/test-file-location-convention`                 | Repository-owned `.test.ts` / `.test.tsx` files must live under `__tests__/` directories. `.spec.ts[x]` files are ignored by this rule. The semantic fixer moves misplaced `.test.ts[x]` files into a sibling `__tests__/` directory and rewrites their relative imports. |
+| `@alexgorbatchev/fixture-file-contract`                         | `__tests__/fixtures.ts(x)` and `stories/fixtures.ts(x)` may export only direct named `const` fixtures and named factory functions.                                                                                                                                        |
+| `@alexgorbatchev/fixture-export-naming-convention`              | Fixture entrypoint exports must use `fixture_<lowerCamelCase>` and `factory_<lowerCamelCase>`.                                                                                                                                                                            |
+| `@alexgorbatchev/fixture-export-type-contract`                  | Fixture entrypoint exports must declare explicit imported concrete types and must not use `any` or `unknown`.                                                                                                                                                             |
+| `@alexgorbatchev/no-fixture-exports-outside-fixture-entrypoint` | `fixture_*` and `factory_*` exports may exist only in nested `fixtures.ts(x)` entrypoints under `__tests__/` or `stories/`.                                                                                                                                               |
+| `@alexgorbatchev/no-inline-fixture-bindings-in-tests`           | Test and story files must import `fixture_*` and `factory_*` bindings from a relative `fixtures` module inside the same `__tests__/` or `stories/` tree instead of declaring them inline.                                                                                 |
+| `@alexgorbatchev/fixture-import-path-convention`                | Fixture-like imports inside test and story files must be named imports from a relative `fixtures` module inside the same `__tests__/` or `stories/` tree, with no aliasing.                                                                                               |
+| `@alexgorbatchev/no-local-type-declarations-in-fixture-files`   | Fixture files and `fixtures/` contents under `__tests__/` or `stories/` must import shared types instead of declaring local types, interfaces, or enums.                                                                                                                  |
+| `@alexgorbatchev/single-fixture-entrypoint`                     | Each fixture-support directory under `__tests__/` or `stories/` must choose exactly one fixture entrypoint shape: `fixtures.ts`, `fixtures.tsx`, or `fixtures/`.                                                                                                          |

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@alexgorbatchev/typescript-ai-policy",
+  "version": "0.1.0",
+  "description": "Shared TypeScript AI policy configs and Oxlint rules",
+  "homepage": "https://github.com/alexgorbatchev/typescript-ai-policy#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alexgorbatchev/typescript-ai-policy.git"
+  },
+  "bugs": {
+    "url": "https://github.com/alexgorbatchev/typescript-ai-policy/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "files": [
+    "src/oxfmt/createOxfmtConfig.ts",
+    "src/oxlint/assertNoRuleCollisions.ts",
+    "src/oxlint/createOxlintConfig.ts",
+    "src/oxlint/oxlint.config.ts",
+    "src/oxlint/plugin.ts",
+    "src/oxlint/rules/*.ts",
+    "src/semantic-fixes/*.ts",
+    "src/semantic-fixes/backends/tsgo-lsp/*.ts",
+    "src/semantic-fixes/providers/*.ts",
+    "src/shared/mergeConfig.ts"
+  ],
+  "bin": {
+    "typescript-ai-policy-fix-semantic": "./src/semantic-fixes/runApplySemanticFixes.ts"
+  },
+  "exports": {
+    "./oxfmt-config": "./src/oxfmt/createOxfmtConfig.ts",
+    "./oxlint-config": "./src/oxlint/createOxlintConfig.ts",
+    "./oxlint-plugin": "./src/oxlint/plugin.ts"
+  },
+  "peerDependencies": {
+    "@typescript/native-preview": "^7.0.0-dev.20260330.1",
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.57.0"
+  },
+  "peerDependenciesMeta": {
+    "@typescript/native-preview": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "check": "./scripts/check.sh",
+    "fix:semantic": "bun src/semantic-fixes/runApplySemanticFixes.ts",
+    "lint:target": "./scripts/lint-target.sh"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@typescript-eslint/rule-tester": "^8.58.0",
+    "@typescript/native-preview": "^7.0.0-dev.20260330.1",
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.57.0",
+    "typescript": "^6"
+  }
+}

package/src/oxfmt/createOxfmtConfig.ts

@@ -0,0 +1,26 @@
+import { defineConfig, type OxfmtConfig } from "oxfmt";
+import { mergeConfig } from "../shared/mergeConfig.ts";
+
+export type OxfmtConfigCallback = () => OxfmtConfig;
+
+const DEFAULT_OXFMT_CONFIG = defineConfig({
+  printWidth: 120,
+  tabWidth: 2,
+  useTabs: false,
+  semi: true,
+  singleQuote: false,
+  quoteProps: "as-needed",
+  jsxSingleQuote: false,
+  trailingComma: "all",
+  bracketSpacing: true,
+  bracketSameLine: false,
+  arrowParens: "always",
+  endOfLine: "lf",
+  sortPackageJson: false,
+});
+
+export default function createOxfmtConfig(callback?: OxfmtConfigCallback): OxfmtConfig {
+  const userConfig = callback?.() ?? defineConfig({});
+
+  return defineConfig(mergeConfig(userConfig, DEFAULT_OXFMT_CONFIG));
+}

package/src/oxlint/assertNoRuleCollisions.ts

@@ -0,0 +1,40 @@
+import type { OxlintConfig } from "oxlint";
+
+function readRuleNames(config: OxlintConfig): Set<string> {
+  const ruleNames = new Set<string>();
+
+  if (config.rules) {
+    for (const ruleName of Object.keys(config.rules)) {
+      ruleNames.add(ruleName);
+    }
+  }
+
+  if (config.overrides) {
+    for (const overrideConfig of config.overrides) {
+      if (!overrideConfig.rules) {
+        continue;
+      }
+
+      for (const ruleName of Object.keys(overrideConfig.rules)) {
+        ruleNames.add(ruleName);
+      }
+    }
+  }
+
+  return ruleNames;
+}
+
+export function assertNoRuleCollisions(userConfig: OxlintConfig, defaultConfig: OxlintConfig): void {
+  const defaultRuleNames = readRuleNames(defaultConfig);
+  const conflictingRuleNames = [...readRuleNames(userConfig)].filter((ruleName) => defaultRuleNames.has(ruleName));
+
+  if (conflictingRuleNames.length === 0) {
+    return;
+  }
+
+  conflictingRuleNames.sort();
+
+  throw new Error(
+    `User oxlint config must extend the shared policy instead of redefining existing rules. Remove these rule entries: ${conflictingRuleNames.join(", ")}. If you need to change a shared rule, update @alexgorbatchev/typescript-ai-policy itself instead of overriding it in a consumer config.`,
+  );
+}

package/src/oxlint/createOxlintConfig.ts

@@ -0,0 +1,161 @@
+import { defineConfig, type OxlintConfig } from "oxlint";
+import { mergeConfig } from "../shared/mergeConfig.ts";
+import { assertNoRuleCollisions } from "./assertNoRuleCollisions.ts";
+
+export type OxlintConfigCallback = () => OxlintConfig;
+
+//
+// The rules must be optimized for performance:
+// - global rules are reserved for true ingress/leak policies that must inspect
+//   arbitrary files
+// - filename-addressable roles such as tests, stories, hooks, index barrels,
+//   constants files, and types files belong in narrow overrides when the path
+//   shape can identify them deterministically
+//
+const DEFAULT_OXLINT_CONFIG = defineConfig({
+  ignorePatterns: [
+    ".cache",
+    ".venv",
+    "**/.astro",
+    "**/.react-email",
+    "**/dist",
+    "**/node_modules",
+    "**/*.generated.ts",
+    "**/*.gen.ts",
+    "**/routeTree.gen.ts",
+    "**/.vitepress/cache",
+    "**/.vitepress/dist",
+  ],
+  plugins: ["unicorn", "typescript", "oxc", "react", "jsx-a11y", "jest"],
+  jsPlugins: [
+    {
+      name: "@alexgorbatchev",
+      specifier: "@alexgorbatchev/typescript-ai-policy/oxlint-plugin",
+    },
+  ],
+  rules: {
+    eqeqeq: "error",
+    "@alexgorbatchev/no-react-create-element": "error",
+    "@alexgorbatchev/no-imports-from-tests-directory": "error",
+    "@alexgorbatchev/no-type-imports-from-constants": "error",
+    "@alexgorbatchev/test-file-location-convention": "error",
+    "@alexgorbatchev/no-fixture-exports-outside-fixture-entrypoint": "error",
+    "typescript/no-explicit-any": "error",
+  },
+  overrides: [
+    {
+      files: ["**/*.{ts,tsx,mts,cts}"],
+      rules: {
+        "@alexgorbatchev/interface-naming-convention": "error",
+        "@alexgorbatchev/no-inline-type-expressions": "error",
+        "@alexgorbatchev/require-template-indent": "error",
+      },
+    },
+    {
+      files: ["**/*.tsx"],
+      rules: {
+        "@alexgorbatchev/testid-naming-convention": "error",
+        "@alexgorbatchev/require-component-root-testid": "error",
+        "@alexgorbatchev/component-file-contract": "error",
+        "@alexgorbatchev/component-file-naming-convention": "error",
+        "@alexgorbatchev/component-story-file-convention": "error",
+      },
+    },
+    {
+      files: ["**/*.stories.tsx"],
+      rules: {
+        "@alexgorbatchev/testid-naming-convention": "off",
+        "@alexgorbatchev/require-component-root-testid": "off",
+        "@alexgorbatchev/story-file-location-convention": "error",
+        "@alexgorbatchev/story-meta-type-annotation": "error",
+        "@alexgorbatchev/story-export-contract": "error",
+        "@alexgorbatchev/no-inline-fixture-bindings-in-tests": "error",
+        "@alexgorbatchev/fixture-import-path-convention": "error",
+      },
+    },
+    {
+      files: ["**/use[A-Z]*.ts", "**/use[A-Z]*.tsx", "**/use-*.ts", "**/use-*.tsx"],
+      rules: {
+        "@alexgorbatchev/hook-file-contract": "error",
+        "@alexgorbatchev/hook-file-naming-convention": "error",
+        "@alexgorbatchev/hook-test-file-convention": "error",
+      },
+    },
+    {
+      files: ["**/index.{ts,tsx}"],
+      rules: {
+        "@alexgorbatchev/index-file-contract": "error",
+      },
+    },
+    {
+      files: ["**/constants.{ts,tsx,mts,cts}", "**/constants.d.{ts,tsx,mts,cts}"],
+      rules: {
+        "@alexgorbatchev/no-type-exports-from-constants": "error",
+      },
+    },
+    {
+      files: ["**/types.{ts,tsx,mts,cts}", "**/types.d.{ts,tsx,mts,cts}"],
+      rules: {
+        "@alexgorbatchev/no-value-exports-from-types": "error",
+      },
+    },
+    {
+      files: ["**/__tests__/**"],
+      rules: {
+        "@alexgorbatchev/no-module-mocking": "error",
+      },
+    },
+    {
+      files: ["**/__tests__/*.test.{ts,tsx}", "**/__tests__/**/*.test.{ts,tsx}"],
+      rules: {
+        "@alexgorbatchev/testid-naming-convention": "off",
+        "@alexgorbatchev/require-component-root-testid": "off",
+        "@alexgorbatchev/no-non-running-tests": "error",
+        "@alexgorbatchev/no-conditional-logic-in-tests": "error",
+        "@alexgorbatchev/no-throw-in-tests": "error",
+        "@alexgorbatchev/no-test-file-exports": "error",
+        "@alexgorbatchev/no-inline-fixture-bindings-in-tests": "error",
+        "@alexgorbatchev/fixture-import-path-convention": "error",
+        "jest/no-disabled-tests": "error",
+        "jest/no-focused-tests": "error",
+      },
+    },
+    {
+      files: [
+        "**/__tests__/fixtures.{ts,tsx}",
+        "**/__tests__/**/fixtures.{ts,tsx}",
+        "**/stories/fixtures.{ts,tsx}",
+        "**/stories/**/fixtures.{ts,tsx}",
+      ],
+      rules: {
+        "@alexgorbatchev/fixture-file-contract": "error",
+        "@alexgorbatchev/fixture-export-naming-convention": "error",
+        "@alexgorbatchev/fixture-export-type-contract": "error",
+      },
+    },
+    {
+      files: [
+        "**/__tests__/fixtures.{ts,tsx}",
+        "**/__tests__/fixtures/**/*.{ts,tsx}",
+        "**/__tests__/**/fixtures.{ts,tsx}",
+        "**/__tests__/**/fixtures/**/*.{ts,tsx}",
+        "**/stories/fixtures.{ts,tsx}",
+        "**/stories/fixtures/**/*.{ts,tsx}",
+        "**/stories/**/fixtures.{ts,tsx}",
+        "**/stories/**/fixtures/**/*.{ts,tsx}",
+      ],
+      rules: {
+        "@alexgorbatchev/no-local-type-declarations-in-fixture-files": "error",
+        "@alexgorbatchev/single-fixture-entrypoint": "error",
+      },
+    },
+  ],
+});
+
+export default function createOxlintConfig(callback?: OxlintConfigCallback): OxlintConfig {
+  const userConfig = callback?.() ?? defineConfig({});
+
+  assertNoRuleCollisions(userConfig, DEFAULT_OXLINT_CONFIG);
+
+  return defineConfig(mergeConfig(userConfig, DEFAULT_OXLINT_CONFIG));
+}

package/src/oxlint/oxlint.config.ts

@@ -0,0 +1,3 @@
+import createOxlintConfig from "./createOxlintConfig.ts";
+
+export default createOxlintConfig();

package/src/oxlint/plugin.ts

@@ -0,0 +1,90 @@
+import testIdNamingConventionRule from "./rules/testid-naming-convention.ts";
+import noReactCreateElementRule from "./rules/no-react-create-element.ts";
+import requireComponentRootTestIdRule from "./rules/require-component-root-testid.ts";
+import noNonRunningTestsRule from "./rules/no-non-running-tests.ts";
+import noConditionalLogicInTestsRule from "./rules/no-conditional-logic-in-tests.ts";
+import noThrowInTestsRule from "./rules/no-throw-in-tests.ts";
+import requireTemplateIndentRule from "./rules/require-template-indent.ts";
+import noModuleMockingRule from "./rules/no-module-mocking.ts";
+import noTestFileExportsRule from "./rules/no-test-file-exports.ts";
+import noImportsFromTestsDirectoryRule from "./rules/no-imports-from-tests-directory.ts";
+import indexFileContractRule from "./rules/index-file-contract.ts";
+import noTypeImportsFromConstantsRule from "./rules/no-type-imports-from-constants.ts";
+import noTypeExportsFromConstantsRule from "./rules/no-type-exports-from-constants.ts";
+import noValueExportsFromTypesRule from "./rules/no-value-exports-from-types.ts";
+import interfaceNamingConventionRule from "./rules/interface-naming-convention.ts";
+import noInlineTypeExpressionsRule from "./rules/no-inline-type-expressions.ts";
+import componentFileLocationConventionRule from "./rules/component-file-location-convention.ts";
+import componentDirectoryFileConventionRule from "./rules/component-directory-file-convention.ts";
+import componentFileContractRule from "./rules/component-file-contract.ts";
+import componentFileNamingConventionRule from "./rules/component-file-naming-convention.ts";
+import componentStoryFileConventionRule from "./rules/component-story-file-convention.ts";
+import storiesDirectoryFileConventionRule from "./rules/stories-directory-file-convention.ts";
+import storyFileLocationConventionRule from "./rules/story-file-location-convention.ts";
+import storyMetaTypeAnnotationRule from "./rules/story-meta-type-annotation.ts";
+import storyExportContractRule from "./rules/story-export-contract.ts";
+import hookExportLocationConventionRule from "./rules/hook-export-location-convention.ts";
+import hooksDirectoryFileConventionRule from "./rules/hooks-directory-file-convention.ts";
+import hookFileContractRule from "./rules/hook-file-contract.ts";
+import hookFileNamingConventionRule from "./rules/hook-file-naming-convention.ts";
+import hookTestFileConventionRule from "./rules/hook-test-file-convention.ts";
+import testFileLocationConventionRule from "./rules/test-file-location-convention.ts";
+import testsDirectoryFileConventionRule from "./rules/tests-directory-file-convention.ts";
+import fixtureFileContractRule from "./rules/fixture-file-contract.ts";
+import fixtureExportNamingConventionRule from "./rules/fixture-export-naming-convention.ts";
+import fixtureExportTypeContractRule from "./rules/fixture-export-type-contract.ts";
+import noFixtureExportsOutsideFixtureEntrypointRule from "./rules/no-fixture-exports-outside-fixture-entrypoint.ts";
+import noInlineFixtureBindingsInTestsRule from "./rules/no-inline-fixture-bindings-in-tests.ts";
+import fixtureImportPathConventionRule from "./rules/fixture-import-path-convention.ts";
+import noLocalTypeDeclarationsInFixtureFilesRule from "./rules/no-local-type-declarations-in-fixture-files.ts";
+import singleFixtureEntrypointRule from "./rules/single-fixture-entrypoint.ts";
+
+const plugin = {
+  meta: {
+    name: "@alexgorbatchev",
+  },
+  rules: {
+    "testid-naming-convention": testIdNamingConventionRule,
+    "no-react-create-element": noReactCreateElementRule,
+    "require-component-root-testid": requireComponentRootTestIdRule,
+    "no-non-running-tests": noNonRunningTestsRule,
+    "no-conditional-logic-in-tests": noConditionalLogicInTestsRule,
+    "no-throw-in-tests": noThrowInTestsRule,
+    "require-template-indent": requireTemplateIndentRule,
+    "no-module-mocking": noModuleMockingRule,
+    "no-test-file-exports": noTestFileExportsRule,
+    "no-imports-from-tests-directory": noImportsFromTestsDirectoryRule,
+    "index-file-contract": indexFileContractRule,
+    "no-type-imports-from-constants": noTypeImportsFromConstantsRule,
+    "no-type-exports-from-constants": noTypeExportsFromConstantsRule,
+    "no-value-exports-from-types": noValueExportsFromTypesRule,
+    "interface-naming-convention": interfaceNamingConventionRule,
+    "no-inline-type-expressions": noInlineTypeExpressionsRule,
+    "component-file-location-convention": componentFileLocationConventionRule,
+    "component-directory-file-convention": componentDirectoryFileConventionRule,
+    "component-file-contract": componentFileContractRule,
+    "component-file-naming-convention": componentFileNamingConventionRule,
+    "component-story-file-convention": componentStoryFileConventionRule,
+    "stories-directory-file-convention": storiesDirectoryFileConventionRule,
+    "story-file-location-convention": storyFileLocationConventionRule,
+    "story-meta-type-annotation": storyMetaTypeAnnotationRule,
+    "story-export-contract": storyExportContractRule,
+    "hook-export-location-convention": hookExportLocationConventionRule,
+    "hooks-directory-file-convention": hooksDirectoryFileConventionRule,
+    "hook-file-contract": hookFileContractRule,
+    "hook-file-naming-convention": hookFileNamingConventionRule,
+    "hook-test-file-convention": hookTestFileConventionRule,
+    "test-file-location-convention": testFileLocationConventionRule,
+    "tests-directory-file-convention": testsDirectoryFileConventionRule,
+    "fixture-file-contract": fixtureFileContractRule,
+    "fixture-export-naming-convention": fixtureExportNamingConventionRule,
+    "fixture-export-type-contract": fixtureExportTypeContractRule,
+    "no-fixture-exports-outside-fixture-entrypoint": noFixtureExportsOutsideFixtureEntrypointRule,
+    "no-inline-fixture-bindings-in-tests": noInlineFixtureBindingsInTestsRule,
+    "fixture-import-path-convention": fixtureImportPathConventionRule,
+    "no-local-type-declarations-in-fixture-files": noLocalTypeDeclarationsInFixtureFilesRule,
+    "single-fixture-entrypoint": singleFixtureEntrypointRule,
+  },
+};
+
+export default plugin;