@howells/lint 0.2.0 → 0.2.2

package/README.md

@@ -103,11 +103,15 @@ Next.js app:
 
 Use this lane when a project wants Oxlint and Oxfmt instead of Biome. React and Next presets stack the relevant Ultracite Ox rules with [React Doctor](https://react.doctor) rules in one config.
 
+React Doctor severities are passed through as published by React Doctor. Native Oxlint Next.js severities come from Oxlint's official `nextjs` plugin via Ultracite's Next preset. `@howells/lint` adds canonical Howells policy on top for file naming, barrel files, env access, and tests.
+
 Choose the closest preset:
 
 - `@howells/lint/oxlint/core` for Node or non-React TypeScript
 - `@howells/lint/oxlint/react` for React (Ultracite React + React Doctor recommended rules)
 - `@howells/lint/oxlint/next` for Next.js (react preset + Next.js rules)
+- `@howells/lint/oxlint/boundaries` for monorepo import boundaries (`packages/**` cannot import from `apps/**`, and apps cannot import from other apps)
+- `@howells/lint/oxlint/react-doctor-rules` for composing or disabling React Doctor rules in mixed workspaces
 
 Node or non-React TypeScript:
 
@@ -142,6 +146,43 @@ export default defineConfig({
 });
 ```
 
+Monorepo root or package boundary config:
+
+```ts
+import { defineConfig } from "oxlint";
+import {
+  boundaryJsPlugins,
+  boundaryRules,
+  boundarySettings,
+} from "@howells/lint/oxlint/boundaries";
+
+export default defineConfig({
+  jsPlugins: boundaryJsPlugins,
+  settings: boundarySettings,
+  rules: boundaryRules,
+});
+```
+
+Run boundary configs from the monorepo root so element patterns such as `apps/*/**` and `packages/*/**` match the project tree.
+
+Mixed monorepo with a Next.js app and Node-only packages:
+
+```ts
+import { defineConfig } from "oxlint";
+import next from "@howells/lint/oxlint/next";
+import { disabledReactDoctorRules } from "@howells/lint/oxlint/react-doctor-rules";
+
+export default defineConfig({
+  extends: [next],
+  overrides: [
+    {
+      files: ["packages/**/*.ts"],
+      rules: disabledReactDoctorRules,
+    },
+  ],
+});
+```
+
 Create an `oxfmt.config.ts`:
 
 ```ts

package/oxlint/boundaries.d.mts

@@ -0,0 +1,12 @@
+import type { OxlintConfig } from "oxlint";
+
+type OxlintRules = NonNullable<OxlintConfig["rules"]>;
+type OxlintSettings = NonNullable<OxlintConfig["settings"]>;
+type OxlintJsPlugins = NonNullable<OxlintConfig["jsPlugins"]>;
+
+export const boundaryJsPlugins: OxlintJsPlugins;
+export const boundarySettings: OxlintSettings;
+export const boundaryRules: OxlintRules;
+
+declare const config: OxlintConfig;
+export default config;

package/oxlint/boundaries.mjs

@@ -0,0 +1,49 @@
+import { defineConfig } from "oxlint";
+
+export const boundaryJsPlugins = [
+	{ name: "boundaries", specifier: "eslint-plugin-boundaries" },
+];
+
+export const boundarySettings = {
+	"import/resolver": {
+		node: {
+			extensions: [".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx"],
+		},
+		typescript: {
+			alwaysTryTypes: true,
+			project: ["tsconfig.json", "apps/*/tsconfig.json", "packages/*/tsconfig.json"],
+		},
+	},
+	"boundaries/elements": [
+		{ type: "app", pattern: "apps/*/**", mode: "full" },
+		{ type: "package", pattern: "packages/*/**", mode: "full" },
+	],
+};
+
+export const boundaryRules = {
+	"boundaries/dependencies": [
+		"error",
+		{
+			default: "allow",
+			checkUnknownLocals: true,
+			rules: [
+				{
+					from: { type: "package" },
+					disallow: [{ to: { type: "app" } }],
+					message: "Packages must not import from apps.",
+				},
+				{
+					from: { type: "app" },
+					disallow: [{ to: { type: "app" } }],
+					message: "Apps must not import from other apps.",
+				},
+			],
+		},
+	],
+};
+
+export default defineConfig({
+	jsPlugins: boundaryJsPlugins,
+	settings: boundarySettings,
+	rules: boundaryRules,
+});

package/oxlint/core.mjs

@@ -1 +1,44 @@
-export { default } from "ultracite/oxlint/core";
+import { defineConfig } from "oxlint";
+import ultraciteCore from "ultracite/oxlint/core";
+
+export default defineConfig({
+	extends: [ultraciteCore],
+	plugins: [...new Set([...(ultraciteCore.plugins ?? []), "vitest"])],
+	rules: {
+		"no-restricted-properties": [
+			"error",
+			{
+				message:
+					"Use the project env schema instead of reading process.env directly. Env schema files may override this rule locally.",
+				object: "process",
+				property: "env",
+			},
+		],
+		"oxc/no-barrel-file": [
+			"error",
+			{
+				threshold: 0,
+			},
+		],
+		"unicorn/filename-case": [
+			"error",
+			{
+				cases: {
+					kebabCase: true,
+				},
+			},
+		],
+		"vitest/hoisted-apis-on-top": "error",
+		"vitest/no-commented-out-tests": "error",
+		"vitest/no-conditional-tests": "error",
+		"vitest/no-disabled-tests": "error",
+		"vitest/no-focused-tests": "error",
+		"vitest/no-identical-title": "error",
+		"vitest/no-import-node-test": "error",
+		"vitest/no-mocks-import": "error",
+		"vitest/no-standalone-expect": "error",
+		"vitest/valid-describe-callback": "error",
+		"vitest/valid-expect": "error",
+		"vitest/valid-expect-in-promise": "error",
+	},
+});

package/oxlint/react-doctor-rules.d.mts

@@ -0,0 +1,8 @@
+import type { OxlintConfig } from "oxlint";
+
+type OxlintRules = NonNullable<OxlintConfig["rules"]>;
+
+export const reactDoctorRecommendedRules: OxlintRules;
+export const reactDoctorNextRules: OxlintRules;
+export const reactDoctorRules: OxlintRules;
+export const disabledReactDoctorRules: OxlintRules;

package/oxlint/react-doctor-rules.mjs

@@ -0,0 +1,14 @@
+import {
+	NEXTJS_RULES,
+	RECOMMENDED_RULES,
+} from "oxlint-plugin-react-doctor";
+
+export const reactDoctorRecommendedRules = RECOMMENDED_RULES;
+export const reactDoctorNextRules = NEXTJS_RULES;
+export const reactDoctorRules = {
+	...RECOMMENDED_RULES,
+	...NEXTJS_RULES,
+};
+export const disabledReactDoctorRules = Object.fromEntries(
+	Object.keys(reactDoctorRules).map((ruleName) => [ruleName, "allow"])
+);

package/oxlint/react.mjs

@@ -1,7 +1,7 @@
 import { defineConfig } from "oxlint";
 import { RECOMMENDED_RULES } from "oxlint-plugin-react-doctor";
-import core from "ultracite/oxlint/core";
 import ultraciteReact from "ultracite/oxlint/react";
+import core from "./core.mjs";
 
 export default defineConfig({
 	extends: [core, ultraciteReact],

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@howells/lint",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"description": "Pinned Biome, Oxlint/Oxfmt, Ultracite, and React Doctor presets for Howells projects.",
 	"license": "MIT",
 	"packageManager": "pnpm@10.23.0",
@@ -35,12 +35,14 @@
 	"dependencies": {
 		"@biomejs/biome": "2.4.15",
 		"@manypkg/cli": "^0.25.1",
+		"eslint-import-resolver-typescript": "4.4.4",
+		"eslint-plugin-boundaries": "6.0.2",
 		"oxc-parser": "0.133.0",
 		"oxfmt": "0.51.0",
 		"oxlint": "1.66.0",
-		"oxlint-plugin-react-doctor": "0.2.14",
+		"oxlint-plugin-react-doctor": "0.4.0",
 		"oxlint-tsgolint": "0.23.0",
-		"ultracite": "7.7.0"
+		"ultracite": "7.8.1"
 	},
 	"exports": {
 		"./package.json": "./package.json",
@@ -62,6 +64,14 @@
 		"./oxlint/next": {
 			"types": "./oxlint/next.d.mts",
 			"default": "./oxlint/next.mjs"
+		},
+		"./oxlint/boundaries": {
+			"types": "./oxlint/boundaries.d.mts",
+			"default": "./oxlint/boundaries.mjs"
+		},
+		"./oxlint/react-doctor-rules": {
+			"types": "./oxlint/react-doctor-rules.d.mts",
+			"default": "./oxlint/react-doctor-rules.mjs"
 		}
 	},
 	"main": "index.js",