@enke.dev/lint 0.12.0 → 0.13.0

package/README.md

@@ -21,7 +21,16 @@ npm i -D jiti typescript typescript-eslint
 
 ## Prepare Eslint config
 
-Create a `eslint.config.js` (or `eslint.config.ts`) file in the root of your project and add the following content:
+Create a `eslint.config.js` (or `eslint.config.ts`) file in the root of your project. There are three ways to consume the configuration, from least to most control: the legacy all-in-one config, a ready-made preset, or the individual single configs.
+
+> [!NOTE]
+> Using Typescript may require the root directory where to find the `tsconfig.json` to be specified.\
+> Therefore, a convenience function `setTsConfigRootDir` is provided to configure this option globally.
+
+### 1. Legacy config
+
+> [!WARNING]
+> The default export is **deprecated**. It bundles `node` + `lit` + `html` + `json` and additionally assumes gitignore-based ignores and this package's own tsconfig root — assumptions that do not hold for every project. Prefer a [preset](#2-presets) or [single configs](#3-single-configs).
 
 ```js
 import config from '@enke.dev/lint';
@@ -29,27 +38,90 @@ import config from '@enke.dev/lint';
 export default config;
 ```
 
-> [!NOTE]
-> Using Typescript may requires the root directory where to find the `tsconfig.json` to be specified.\
-> Therefore, a convenience function `setTsConfigRootDir` is provided to configure this option globally.
+### 2. Presets
+
+Ready-made combinations for common project types. Import the one that matches your project and export it directly:
+
+```ts
+import { frontend } from '@enke.dev/lint/eslint/presets/frontend';
+
+export default frontend;
+```
+
+Available presets:
+
+| Preset                                       | Import name   | Bundles                          |
+| -------------------------------------------- | ------------- | -------------------------------- |
+| `@enke.dev/lint/eslint/presets/frontend`     | `frontend`    | `node` + `lit` + `html` + `json` |
+| `@enke.dev/lint/eslint/presets/node-library` | `nodeLibrary` | `node` + `json`                  |
+| `@enke.dev/lint/eslint/presets/bun-library`  | `bunLibrary`  | `bun` + `json`                   |
+
+Presets are flat config arrays, so they can be extended — e.g. to point the TypeScript parser at your `tsconfig.json`:
+
+```ts
+import { defineConfig } from 'eslint/config';
+
+import { setTsConfigRootDir } from '@enke.dev/lint';
+import { frontend } from '@enke.dev/lint/eslint/presets/frontend';
 
-### Extending a config
+export default defineConfig([...frontend, setTsConfigRootDir(import.meta.dirname)]);
+```
+
+### 3. Single configs
 
-For example for setting up the Typescript parser, you can extend the base config like this:
+For full control, compose the individual chunks yourself. Each is a flat config array; spread the ones you need:
 
 ```ts
-import config, { setTsConfigRootDir } from '@enke.dev/lint';
+import { defineConfig } from 'eslint/config';
+
+import { bun } from '@enke.dev/lint/eslint/bun';
+import { html } from '@enke.dev/lint/eslint/html';
+import { json } from '@enke.dev/lint/eslint/json';
+import { lit } from '@enke.dev/lint/eslint/lit';
 
 export default defineConfig([
-  // extend the base config
-  ...config,
-  // configure typescript parser to your needs
-  setTsConfigRootDir(import.meta.dirname),
+  ...bun, // TypeScript + import rules, bun module resolver
+  ...lit, // web components, lit and inline-html linting
+  ...html, // standalone .html files
+  ...json, // .json files
 ]);
 ```
 
-> [!TIP]
-> Extending configurations works the same way with all other configs provided by this package.
+Available configs:
+
+| Import                       | Name   | Applies to        | Notes                                                           |
+| ---------------------------- | ------ | ----------------- | --------------------------------------------------------------- |
+| `@enke.dev/lint/eslint/node` | `node` | `**/*.js`, `*.ts` | Base TS/import rules, node resolver.                            |
+| `@enke.dev/lint/eslint/bun`  | `bun`  | `**/*.js`, `*.ts` | Same base, bun resolver (resolves `bun:test`, `bun:sqlite`, …). |
+| `@enke.dev/lint/eslint/lit`  | `lit`  | `**/*.js`, `*.ts` | Web components, lit, a11y and inline-html rules.                |
+| `@enke.dev/lint/eslint/html` | `html` | `**/*.html`       | Standalone HTML files.                                          |
+| `@enke.dev/lint/eslint/json` | `json` | `**/*.json`       | JSON files.                                                     |
+
+> [!NOTE]
+> `node` and `bun` differ only by the import resolver — pick one.
+
+### Type-aware linting
+
+By default the rules are syntactic only (typescript-eslint `strict` + `stylistic`), so no `tsconfig` is required. Every TypeScript base — the `node` / `bun` single configs and all three presets — additionally ships a **type-checked** variant that enables the type-aware rule sets (`strictTypeChecked` + `stylisticTypeChecked`, e.g. `no-floating-promises`, `no-misused-promises`, `await-thenable`).
+
+Each variant is an extra export from the same module — just add the `TypeChecked` suffix:
+
+| Base          | Type-checked variant     | Import from                                  |
+| ------------- | ------------------------ | -------------------------------------------- |
+| `node`        | `nodeTypeChecked`        | `@enke.dev/lint/eslint/node`                 |
+| `bun`         | `bunTypeChecked`         | `@enke.dev/lint/eslint/bun`                  |
+| `frontend`    | `frontendTypeChecked`    | `@enke.dev/lint/eslint/presets/frontend`     |
+| `nodeLibrary` | `nodeLibraryTypeChecked` | `@enke.dev/lint/eslint/presets/node-library` |
+| `bunLibrary`  | `bunLibraryTypeChecked`  | `@enke.dev/lint/eslint/presets/bun-library`  |
+
+```ts
+import { frontendTypeChecked } from '@enke.dev/lint/eslint/presets/frontend';
+
+export default frontendTypeChecked;
+```
+
+> [!WARNING]
+> Type-aware rules require a TypeScript program. The variants enable `projectService`, which auto-discovers the nearest `tsconfig.json` — but any file **not** covered by one (stray configs, generated JS) will error unless you configure [`parserOptions.projectService.allowDefaultProject`](https://typescript-eslint.io/packages/parser/#projectservice). Type-aware linting is also noticeably slower.
 
 ### Using Monorepos
 
@@ -96,11 +168,19 @@ For now, [no TypeScript support](https://github.com/stylelint/stylelint/issues/4
 
 ## Development
 
+Prerequisites:
+
+- **Node** — version pinned in [`.node-version`](.node-version) (use `nvm`/`fnm` to match it).
+- **[bun](https://bun.sh/)** — required for the `test:bun` suite; install it globally (`curl -fsSL https://bun.sh/install | bash`).
+
 This repo self-tests the configuration by linting itself: `npm run lint`.\
 Therefore, a `test.eslint.config.ts` is used.
 
-And additionally, a naive test is in place to check that the linter actually finds issues: `npm run test`.\
-It uses the native Node test runner against some obviously faulty code in the `test` directory.
+And additionally, naive tests are in place to check that the linter actually finds issues: `npm run test`.\
+This runs two suites:
+
+- `npm run test:node` — the native Node test runner against obviously faulty code in the `test` directory (default/legacy config, prettier, stylelint).
+- `npm run test:bun` — the bun test runner (`test.run.bun.ts`), which exercises the `bun` and type-checked configs against the source directly (bun resolves `.js`→`.ts`, so no build is needed). Requires [bun](https://bun.sh/).
 
 ### Updating dependencies
 

package/configs/eslint/bun.config.d.ts

@@ -0,0 +1,3 @@
+import type { FlatConfig } from './typescript.config.js';
+export declare const bun: FlatConfig;
+export declare const bunTypeChecked: FlatConfig;

package/configs/eslint/bun.config.js

@@ -0,0 +1,11 @@
+import { defineConfig } from 'eslint/config';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import { typescript } from './typescript.config.js';
+// Same base as `node`, but with the bun module resolver so builtins such as
+// `bun:test` and `bun:sqlite` resolve instead of being flagged as unresolved.
+export const bun = defineConfig([eslintPluginPrettierRecommended, typescript('bun')]);
+// Same as `bun`, plus type-aware rules (needs a tsconfig; see `TypescriptOptions`).
+export const bunTypeChecked = defineConfig([
+    eslintPluginPrettierRecommended,
+    typescript('bun', { typeChecked: true }),
+]);

package/configs/eslint/html.config.d.ts

@@ -0,0 +1,2 @@
+import type { FlatConfig } from './typescript.config.js';
+export declare const html: FlatConfig;

package/configs/eslint/html.config.js

@@ -0,0 +1,43 @@
+import eslintPluginHtml from '@html-eslint/eslint-plugin';
+import eslintParserHtml from '@html-eslint/parser';
+import { defineConfig } from 'eslint/config';
+import eslintPluginHtmlScripts from 'eslint-plugin-html';
+import { parserOptions } from './typescript.config.js';
+// Standalone HTML files.
+const htmlConfig = {
+    files: ['**/*.html'],
+    plugins: {
+        html: eslintPluginHtml,
+        htmlScripts: eslintPluginHtmlScripts,
+    },
+    extends: ['html/recommended'],
+    language: 'html/html',
+    languageOptions: {
+        parser: eslintParserHtml,
+        parserOptions,
+    },
+    settings: {
+        'html/indent': '+2',
+        'html/lowercase': 'error',
+        'html/no-accesskey-attrs': 'error',
+        'html/no-aria-hidden-body': 'error',
+        'html/no-aria-hidden-on-focusable': 'error',
+        'html/no-duplicate-class': 'error',
+        'html/no-duplicate-in-head': 'error',
+        'html/no-empty-headings': 'error',
+        'html/no-invalid-entities': 'error',
+        'html/no-heading-inside-button': 'error',
+        'html/no-invalid-entity': 'error',
+        'html/no-invalid-role': 'error',
+        'html/no-nested-interactive': 'error',
+        'html/no-multiple-empty-lines': 'error',
+        'html/no-target-blank': 'error',
+        'html/no-trailing-spaces': 'error',
+        'html/report-bad-indent': 'error',
+        'html/require-input-label': 'error',
+    },
+    rules: {
+        'html/indent': ['error', 2],
+    },
+};
+export const html = defineConfig([htmlConfig]);

package/configs/eslint/json.config.d.ts

@@ -0,0 +1,2 @@
+import type { FlatConfig } from './typescript.config.js';
+export declare const json: FlatConfig;

package/configs/eslint/json.config.js

@@ -0,0 +1,14 @@
+import eslintPluginJson from '@eslint/json';
+import { defineConfig } from 'eslint/config';
+// JSON files.
+const jsonConfig = {
+    files: ['**/*.json'],
+    language: 'json/json',
+    ignores: ['package-lock.json'],
+    plugins: { json: eslintPluginJson },
+    extends: [eslintPluginJson.configs.recommended],
+    rules: {
+        'json/top-level-interop': 'error',
+    },
+};
+export const json = defineConfig([jsonConfig]);

package/configs/eslint/lit.config.d.ts

@@ -0,0 +1,2 @@
+import type { FlatConfig } from './typescript.config.js';
+export declare const lit: FlatConfig;

package/configs/eslint/lit.config.js

@@ -0,0 +1,38 @@
+import eslintPluginHtml from '@html-eslint/eslint-plugin';
+import { defineConfig } from 'eslint/config';
+import eslintPluginHtmlScripts from 'eslint-plugin-html';
+import { configs as eslintPluginLitConfigs } from 'eslint-plugin-lit';
+import { configs as eslintPluginLitA11yConfigs } from 'eslint-plugin-lit-a11y';
+import { configs as eslintPluginWebComponentsConfigs } from 'eslint-plugin-wc';
+import { parserOptions } from './typescript.config.js';
+// Lit / web-components support: element rules, a11y, and inline html-in-tagged-template linting.
+const litConfig = {
+    files: ['**/*.js', '**/*.ts'],
+    extends: [
+        eslintPluginWebComponentsConfigs['flat/recommended'],
+        eslintPluginLitConfigs['flat/recommended'],
+        eslintPluginLitA11yConfigs.recommended,
+    ],
+    plugins: {
+        html: eslintPluginHtml,
+        htmlScripts: eslintPluginHtmlScripts,
+    },
+    languageOptions: { parserOptions },
+    settings: {
+        litHtmlSources: true,
+    },
+    rules: {
+        // inline html
+        'html/require-img-alt': 'error',
+        'html/no-multiple-h1': 'error',
+        'html/no-extra-spacing-attrs': 'error',
+        'html/no-duplicate-id': 'error',
+        'html/require-li-container': 'error',
+        'html/no-obsolete-tags': 'error',
+        'html/require-closing-tags': 'error',
+        'html/no-duplicate-attrs': 'error',
+        // web components / a11y
+        'wc/guard-super-call': 'off',
+    },
+};
+export const lit = defineConfig([litConfig]);

package/configs/eslint/node.config.d.ts

@@ -0,0 +1,3 @@
+import type { FlatConfig } from './typescript.config.js';
+export declare const node: FlatConfig;
+export declare const nodeTypeChecked: FlatConfig;

package/configs/eslint/node.config.js

@@ -0,0 +1,10 @@
+import { defineConfig } from 'eslint/config';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import { typescript } from './typescript.config.js';
+// TypeScript / JavaScript for projects that emit via tsc and run on node.
+export const node = defineConfig([eslintPluginPrettierRecommended, typescript('node')]);
+// Same as `node`, plus type-aware rules (needs a tsconfig; see `TypescriptOptions`).
+export const nodeTypeChecked = defineConfig([
+    eslintPluginPrettierRecommended,
+    typescript('node', { typeChecked: true }),
+]);

package/configs/eslint/typescript.config.d.ts

@@ -0,0 +1,12 @@
+import type { Linter } from 'eslint';
+import type { Config } from 'eslint/config';
+import { defineConfig } from 'eslint/config';
+export type FlatConfig = ReturnType<typeof defineConfig>;
+export type ConfigWithExtends = Exclude<Parameters<typeof defineConfig>[number], readonly unknown[]>;
+export declare const parserOptions: Linter.ParserOptions;
+export declare function setTsConfigRootDir(dir: string): Config;
+export declare const importSortGroups: string[][];
+export interface TypescriptOptions {
+    typeChecked?: boolean;
+}
+export declare function typescript(runtime: 'node' | 'bun', { typeChecked }?: TypescriptOptions): ConfigWithExtends;

package/configs/eslint/typescript.config.js

@@ -0,0 +1,100 @@
+import { fixupPluginRules } from '@eslint/compat';
+import eslintPluginJs from '@eslint/js';
+import eslintPluginImport from 'eslint-plugin-import';
+import eslintPluginImportExtension from 'eslint-plugin-import-extensions';
+import eslintPluginSimpleImportSort from 'eslint-plugin-simple-import-sort';
+import eslintPluginUnusedImports from 'eslint-plugin-unused-imports';
+import eslintTs from 'typescript-eslint';
+// shared parser options
+export const parserOptions = {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+};
+export function setTsConfigRootDir(dir) {
+    return { languageOptions: { parserOptions: { project: true, tsconfigRootDir: dir } } };
+}
+// shared import-sort groups
+export const importSortGroups = [
+    // Side effect imports.
+    ['^\\u0000'],
+    // Node.js builtins prefixed with `node:`.
+    ['^node:'],
+    // Packages.
+    // Things that start with a letter (or digit or underscore), or `@` followed by a letter.
+    ['^@?\\w'],
+    // Absolute imports and other imports such as Vue-style `@/foo`.
+    // Anything not matched in another group.
+    ['^'],
+    // Relative imports.
+    // Anything that starts with a dot.
+    ['^\\.'],
+    // Assetic imports, most likely inline loaded style files for lit components
+    // or raw loaded files like images, meta data or fonts.
+    ['\\?(inline|raw)$'],
+];
+// JavaScript / TypeScript base config, parametrised by runtime target.
+//
+// Relative imports always carry the emitted `.js` extension: tsc emits `.js`, and
+// runtimes that execute TypeScript directly (bun, ts-node, --experimental-strip-types)
+// resolve a `.js` specifier back to the neighbouring `.ts` source anyway. `runtime`
+// therefore only switches the resolver, so bun builtins (`bun:test`, `bun:sqlite`) are
+// recognised rather than flagged as unresolved.
+export function typescript(runtime, { typeChecked = false } = {}) {
+    return {
+        files: ['**/*.js', '**/*.ts'],
+        extends: [
+            eslintPluginJs.configs.recommended,
+            ...(typeChecked ? eslintTs.configs.strictTypeChecked : eslintTs.configs.strict),
+            ...(typeChecked ? eslintTs.configs.stylisticTypeChecked : eslintTs.configs.stylistic),
+            eslintPluginImport.flatConfigs.recommended,
+        ],
+        plugins: {
+            'simple-import-sort': eslintPluginSimpleImportSort,
+            'unused-imports': eslintPluginUnusedImports,
+            'import-extensions': fixupPluginRules(eslintPluginImportExtension),
+        },
+        // type-aware rules need a program; projectService (tseslint v8) auto-discovers tsconfig
+        languageOptions: {
+            parserOptions: typeChecked ? { ...parserOptions, projectService: true } : parserOptions,
+        },
+        settings: {
+            'import/resolver': {
+                typescript: runtime === 'bun' ? { bun: true, node: true } : { node: true },
+            },
+        },
+        rules: {
+            // formatting
+            '@typescript-eslint/no-unused-expressions': [
+                'error',
+                { allowShortCircuit: true, allowTernary: true },
+            ],
+            curly: 'error',
+            'linebreak-style': ['error', 'unix'],
+            quotes: ['error', 'single', { avoidEscape: true }],
+            semi: ['error', 'always'],
+            'no-console': 'error',
+            // import sorting
+            'simple-import-sort/imports': ['error', { groups: importSortGroups }],
+            'simple-import-sort/exports': 'error',
+            // import extensions
+            'import-extensions/require-extensions': ['error', { expectedExtensions: ['js'] }],
+            'import-extensions/require-index': ['error', { expectedExtensions: ['js'] }],
+            // import rules
+            'import/enforce-node-protocol-usage': ['error', 'always'], // enforce node: import prefix
+            'import/consistent-type-specifier-style': ['error', 'prefer-top-level'], // type imports
+            'import/first': 'error',
+            'import/newline-after-import': 'error',
+            'import/no-duplicates': 'error',
+            'import/no-unresolved': 'error',
+            'import/extensions': ['error', 'ignorePackages', { ts: 'never', js: 'always' }],
+            'prettier/prettier': ['error', {}, { usePrettierrc: true }],
+            // unused imports
+            '@typescript-eslint/no-unused-vars': 'off',
+            'unused-imports/no-unused-vars': [
+                'error',
+                { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrors: 'none' },
+            ],
+            'unused-imports/no-unused-imports': 'error',
+        },
+    };
+}

package/eslint.config.d.ts

@@ -1,5 +1,23 @@
-import type { Config } from 'eslint/config';
-import { defineConfig } from 'eslint/config';
-export declare function setTsConfigRootDir(dir: string): Config;
-declare const config: ReturnType<typeof defineConfig>;
+import { bun, bunTypeChecked } from './configs/eslint/bun.config.js';
+import { html } from './configs/eslint/html.config.js';
+import { json } from './configs/eslint/json.config.js';
+import { lit } from './configs/eslint/lit.config.js';
+import { node, nodeTypeChecked } from './configs/eslint/node.config.js';
+import type { FlatConfig } from './configs/eslint/typescript.config.js';
+import { setTsConfigRootDir } from './configs/eslint/typescript.config.js';
+export { bun, bunTypeChecked, html, json, lit, node, nodeTypeChecked, setTsConfigRootDir };
+/**
+ * Legacy all-in-one configuration, kept for backwards compatibility.
+ *
+ * Bundles the `node`, `lit`, `html` and `json` chunks and additionally wires up
+ * gitignore-based ignores plus this package's own tsconfig root — assumptions that do not
+ * hold for every consumer.
+ *
+ * Prefer a ready-made preset (`@enke.dev/lint/eslint/presets/*`) or compose the individual
+ * single configs (`@enke.dev/lint/eslint/*`) instead.
+ *
+ * @deprecated Use a preset (`frontend`, `nodeLibrary`, `bunLibrary`) or compose the single
+ * configs (`node`, `bun`, `lit`, `html`, `json`).
+ */
+declare const config: FlatConfig;
 export default config;

package/eslint.config.js

@@ -1,21 +1,14 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { cwd } from 'node:process';
-import { fixupPluginRules } from '@eslint/compat';
-import eslintPluginJs from '@eslint/js';
-import eslintPluginJson from '@eslint/json';
-import eslintPluginHtml from '@html-eslint/eslint-plugin';
-import eslintParserHtml from '@html-eslint/parser';
 import { defineConfig, globalIgnores } from 'eslint/config';
-import eslintPluginHtmlScripts from 'eslint-plugin-html';
-import eslintPluginImport from 'eslint-plugin-import';
-import eslintPluginImportExtension from 'eslint-plugin-import-extensions';
-import { configs as eslintPluginLitConfigs } from 'eslint-plugin-lit';
-import { configs as eslintPluginLitA11yConfigs } from 'eslint-plugin-lit-a11y';
-import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
-import eslintPluginSimpleImportSort from 'eslint-plugin-simple-import-sort';
-import eslintPluginUnusedImports from 'eslint-plugin-unused-imports';
-import { configs as eslintPluginWebComponentsConfigs } from 'eslint-plugin-wc';
-import eslintTs from 'typescript-eslint';
+import { bun, bunTypeChecked } from './configs/eslint/bun.config.js';
+import { html } from './configs/eslint/html.config.js';
+import { json } from './configs/eslint/json.config.js';
+import { lit } from './configs/eslint/lit.config.js';
+import { node, nodeTypeChecked } from './configs/eslint/node.config.js';
+import { setTsConfigRootDir } from './configs/eslint/typescript.config.js';
+// re-export the individual chunks so consumers can compose their own config
+export { bun, bunTypeChecked, html, json, lit, node, nodeTypeChecked, setTsConfigRootDir };
 // collect gitignore excludes
 let gitIgnoreLines = [];
 const pathToGitIgnore = `${cwd()}/.gitignore`;
@@ -26,162 +19,25 @@ if (existsSync(pathToGitIgnore)) {
         .map(line => line.trim().replace(/^\//, ''))
         .filter(line => Boolean(line) && !line.startsWith('#'));
 }
-// shared parser options
-const parserOptions = {
-    ecmaVersion: 'latest',
-    sourceType: 'module',
-};
-export function setTsConfigRootDir(dir) {
-    return { languageOptions: { parserOptions: { project: true, tsconfigRootDir: dir } } };
-}
+/**
+ * Legacy all-in-one configuration, kept for backwards compatibility.
+ *
+ * Bundles the `node`, `lit`, `html` and `json` chunks and additionally wires up
+ * gitignore-based ignores plus this package's own tsconfig root — assumptions that do not
+ * hold for every consumer.
+ *
+ * Prefer a ready-made preset (`@enke.dev/lint/eslint/presets/*`) or compose the individual
+ * single configs (`@enke.dev/lint/eslint/*`) instead.
+ *
+ * @deprecated Use a preset (`frontend`, `nodeLibrary`, `bunLibrary`) or compose the single
+ * configs (`node`, `bun`, `lit`, `html`, `json`).
+ */
 const config = defineConfig([
     globalIgnores([...gitIgnoreLines, 'dist/']),
-    eslintPluginPrettierRecommended,
     setTsConfigRootDir(import.meta.dirname),
-    // Javascript and Typescript files
-    {
-        files: ['**/*.js', '**/*.ts'],
-        extends: [
-            eslintPluginJs.configs.recommended,
-            ...eslintTs.configs.strict,
-            ...eslintTs.configs.stylistic,
-            eslintPluginWebComponentsConfigs['flat/recommended'],
-            eslintPluginLitConfigs['flat/recommended'],
-            eslintPluginLitA11yConfigs.recommended,
-            eslintPluginImport.flatConfigs.recommended,
-        ],
-        plugins: {
-            'simple-import-sort': eslintPluginSimpleImportSort,
-            'unused-imports': eslintPluginUnusedImports,
-            'import-extensions': fixupPluginRules(eslintPluginImportExtension),
-            html: eslintPluginHtml,
-            htmlScripts: eslintPluginHtmlScripts,
-        },
-        languageOptions: { parserOptions },
-        settings: {
-            'import/resolver': {
-                typescript: {
-                    bun: true,
-                    node: true,
-                },
-            },
-            litHtmlSources: true,
-        },
-        rules: {
-            // formatting
-            '@typescript-eslint/no-unused-expressions': [
-                'error',
-                { allowShortCircuit: true, allowTernary: true },
-            ],
-            curly: 'error',
-            'linebreak-style': ['error', 'unix'],
-            quotes: ['error', 'single', { avoidEscape: true }],
-            semi: ['error', 'always'],
-            'no-console': 'error',
-            // inline html
-            'html/require-img-alt': 'error',
-            'html/no-multiple-h1': 'error',
-            'html/no-extra-spacing-attrs': 'error',
-            'html/no-duplicate-id': 'error',
-            'html/require-li-container': 'error',
-            'html/no-obsolete-tags': 'error',
-            'html/require-closing-tags': 'error',
-            'html/no-duplicate-attrs': 'error',
-            // import sorting
-            'simple-import-sort/imports': [
-                'error',
-                {
-                    groups: [
-                        // Side effect imports.
-                        ['^\\u0000'],
-                        // Node.js builtins prefixed with `node:`.
-                        ['^node:'],
-                        // Packages.
-                        // Things that start with a letter (or digit or underscore), or `@` followed by a letter.
-                        ['^@?\\w'],
-                        // Absolute imports and other imports such as Vue-style `@/foo`.
-                        // Anything not matched in another group.
-                        ['^'],
-                        // Relative imports.
-                        // Anything that starts with a dot.
-                        ['^\\.'],
-                        // Assetic imports, most likely inline loaded style files for lit components
-                        // or raw loaded files like images, meta data or fonts.
-                        ['\\?(inline|raw)$'],
-                    ],
-                },
-            ],
-            'simple-import-sort/exports': 'error',
-            // import extensions
-            'import-extensions/require-extensions': ['error', { expectedExtensions: ['js'] }],
-            'import-extensions/require-index': ['error', { expectedExtensions: ['js'] }],
-            // import rules
-            'import/enforce-node-protocol-usage': ['error', 'always'], // enforce node: import prefix
-            'import/consistent-type-specifier-style': ['error', 'prefer-top-level'], // type imports
-            'import/first': 'error',
-            'import/newline-after-import': 'error',
-            'import/no-duplicates': 'error',
-            'import/no-unresolved': 'error',
-            'import/extensions': ['error', 'ignorePackages', { ts: 'never', js: 'always' }],
-            'prettier/prettier': ['error', {}, { usePrettierrc: true }],
-            // unused imports
-            '@typescript-eslint/no-unused-vars': 'off',
-            'unused-imports/no-unused-vars': [
-                'error',
-                { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrors: 'none' },
-            ],
-            'unused-imports/no-unused-imports': 'error',
-            // web components / a11y
-            'wc/guard-super-call': 'off',
-        },
-    },
-    // HTML files
-    {
-        files: ['**/*.html'],
-        plugins: {
-            html: eslintPluginHtml,
-            htmlScripts: eslintPluginHtmlScripts,
-        },
-        extends: ['html/recommended'],
-        language: 'html/html',
-        languageOptions: {
-            parser: eslintParserHtml,
-            parserOptions,
-        },
-        settings: {
-            'html/indent': '+2',
-            'html/lowercase': 'error',
-            'html/no-accesskey-attrs': 'error',
-            'html/no-aria-hidden-body': 'error',
-            'html/no-aria-hidden-on-focusable': 'error',
-            'html/no-duplicate-class': 'error',
-            'html/no-duplicate-in-head': 'error',
-            'html/no-empty-headings': 'error',
-            'html/no-invalid-entities': 'error',
-            'html/no-heading-inside-button': 'error',
-            'html/no-invalid-entity': 'error',
-            'html/no-invalid-role': 'error',
-            'html/no-nested-interactive': 'error',
-            'html/no-multiple-empty-lines': 'error',
-            'html/no-target-blank': 'error',
-            'html/no-trailing-spaces': 'error',
-            'html/report-bad-indent': 'error',
-            'html/require-input-label': 'error',
-        },
-        rules: {
-            'html/indent': ['error', 2],
-        },
-    },
-    // JSON files
-    {
-        files: ['**/*.json'],
-        language: 'json/json',
-        ignores: ['package-lock.json'],
-        plugins: { json: eslintPluginJson },
-        extends: [eslintPluginJson.configs.recommended],
-        rules: {
-            'json/top-level-interop': 'error',
-        },
-    },
+    ...node,
+    ...lit,
+    ...html,
+    ...json,
 ]);
 export default config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enke.dev/lint",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Meta package to provide linting for web projects",
   "homepage": "https://github.com/enke-dev/lint",
   "repository": {
@@ -8,22 +8,62 @@
     "url": "git+https://github.com/enke-dev/lint.git"
   },
   "files": [
-    "eslint.config.d.ts",
-    "eslint.config.js",
-    "eslint-plugins.d.ts",
-    "prettier.config.d.ts",
-    "prettier.config.js",
-    "stylelint.config.d.ts",
-    "stylelint.config.js",
+    "*.config.js",
+    "*.config.d.ts",
+    "configs/eslint/*.js",
+    "configs/eslint/*.d.ts",
+    "presets/eslint/*.js",
+    "presets/eslint/*.d.ts",
     "README.md"
   ],
   "type": "module",
   "main": "eslint.config.js",
   "types": "eslint.config.d.ts",
+  "exports": {
+    ".": {
+      "types": "./eslint.config.d.ts",
+      "default": "./eslint.config.js"
+    },
+    "./eslint/node": {
+      "types": "./configs/eslint/node.config.d.ts",
+      "default": "./configs/eslint/node.config.js"
+    },
+    "./eslint/bun": {
+      "types": "./configs/eslint/bun.config.d.ts",
+      "default": "./configs/eslint/bun.config.js"
+    },
+    "./eslint/lit": {
+      "types": "./configs/eslint/lit.config.d.ts",
+      "default": "./configs/eslint/lit.config.js"
+    },
+    "./eslint/html": {
+      "types": "./configs/eslint/html.config.d.ts",
+      "default": "./configs/eslint/html.config.js"
+    },
+    "./eslint/json": {
+      "types": "./configs/eslint/json.config.d.ts",
+      "default": "./configs/eslint/json.config.js"
+    },
+    "./eslint/presets/frontend": {
+      "types": "./presets/eslint/frontend.preset.d.ts",
+      "default": "./presets/eslint/frontend.preset.js"
+    },
+    "./eslint/presets/node-library": {
+      "types": "./presets/eslint/node-library.preset.d.ts",
+      "default": "./presets/eslint/node-library.preset.js"
+    },
+    "./eslint/presets/bun-library": {
+      "types": "./presets/eslint/bun-library.preset.d.ts",
+      "default": "./presets/eslint/bun-library.preset.js"
+    },
+    "./*": "./*"
+  },
   "scripts": {
     "check": "tsc -p tsconfig.build.json --noEmit",
     "lint": "eslint -c test.eslint.config.ts .",
-    "test": "node --experimental-strip-types --test test.run.ts",
+    "test": "run-p -ns test:*",
+    "test:node": "node --experimental-strip-types --test test.run.node.ts",
+    "test:bun": "bun test ./test.run.bun.ts",
     "inspect": "eslint-config-inspector --config eslint.config.ts",
     "dev": "tsc -p tsconfig.build.json --watch",
     "build": "tsc -p tsconfig.build.json"
@@ -42,8 +82,8 @@
   },
   "peerDependencies": {
     "@awmottaz/prettier-plugin-void-html": "^2.1.0",
-    "eslint": "^10.6.0",
-    "prettier": "^3.9.4"
+    "eslint": "^10.7.0",
+    "prettier": "^3.9.5"
   },
   "optionalDependencies": {
     "jiti": "^2.7.0",
@@ -52,14 +92,14 @@
     "stylelint-config-standard-scss": "^17.0.0",
     "stylelint-order": "^8.1.1",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.62.1"
+    "typescript-eslint": "^8.63.0"
   },
   "dependencies": {
     "@eslint/compat": "2.1.0",
     "@eslint/js": "10.0.1",
     "@eslint/json": "2.0.1",
-    "@html-eslint/eslint-plugin": "0.63.0",
-    "@html-eslint/parser": "0.63.0",
+    "@html-eslint/eslint-plugin": "0.64.0",
+    "@html-eslint/parser": "0.64.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-import-resolver-typescript": "4.4.5",
     "eslint-plugin-html": "8.1.4",
@@ -76,15 +116,16 @@
   "devDependencies": {
     "@awmottaz/prettier-plugin-void-html": "2.1.0",
     "@eslint/config-inspector": "3.0.4",
-    "@types/node": "24.13.2",
-    "eslint": "10.6.0",
+    "@types/node": "24.13.3",
+    "eslint": "10.7.0",
     "jiti": "2.7.0",
-    "prettier": "3.9.4",
+    "npm-run-all2": "9.0.2",
+    "prettier": "3.9.5",
     "stylelint": "17.14.0",
     "stylelint-config-rational-order": "0.1.2",
     "stylelint-config-standard-scss": "17.0.0",
     "stylelint-order": "8.1.1",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.62.1"
+    "typescript-eslint": "8.63.0"
   }
 }

package/presets/eslint/bun-library.preset.d.ts

@@ -0,0 +1,3 @@
+import type { FlatConfig } from '../../configs/eslint/typescript.config.js';
+export declare const bunLibrary: FlatConfig;
+export declare const bunLibraryTypeChecked: FlatConfig;

package/presets/eslint/bun-library.preset.js

@@ -0,0 +1,8 @@
+import { defineConfig } from 'eslint/config';
+import { bun, bunTypeChecked } from '../../configs/eslint/bun.config.js';
+import { json } from '../../configs/eslint/json.config.js';
+// Bun library: same as the node library but with the bun module resolver so builtins
+// such as `bun:test` and `bun:sqlite` resolve instead of being flagged as unresolved.
+export const bunLibrary = defineConfig([...bun, ...json]);
+// Same as `bunLibrary`, plus type-aware rules (needs a tsconfig; see `TypescriptOptions`).
+export const bunLibraryTypeChecked = defineConfig([...bunTypeChecked, ...json]);

package/presets/eslint/frontend.preset.d.ts

@@ -0,0 +1,3 @@
+import type { FlatConfig } from '../../configs/eslint/typescript.config.js';
+export declare const frontend: FlatConfig;
+export declare const frontendTypeChecked: FlatConfig;

package/presets/eslint/frontend.preset.js

@@ -0,0 +1,16 @@
+import { defineConfig } from 'eslint/config';
+import { html } from '../../configs/eslint/html.config.js';
+import { json } from '../../configs/eslint/json.config.js';
+import { lit } from '../../configs/eslint/lit.config.js';
+import { node, nodeTypeChecked } from '../../configs/eslint/node.config.js';
+// Frontend projects: TypeScript/JavaScript with web components (lit), inline and
+// standalone HTML, and JSON. Bundled/emitted via tsc, so node-style `.js` import
+// extensions and the node resolver.
+export const frontend = defineConfig([...node, ...lit, ...html, ...json]);
+// Same as `frontend`, plus type-aware rules (needs a tsconfig; see `TypescriptOptions`).
+export const frontendTypeChecked = defineConfig([
+    ...nodeTypeChecked,
+    ...lit,
+    ...html,
+    ...json,
+]);

package/presets/eslint/node-library.preset.d.ts

@@ -0,0 +1,3 @@
+import type { FlatConfig } from '../../configs/eslint/typescript.config.js';
+export declare const nodeLibrary: FlatConfig;
+export declare const nodeLibraryTypeChecked: FlatConfig;

package/presets/eslint/node-library.preset.js

@@ -0,0 +1,8 @@
+import { defineConfig } from 'eslint/config';
+import { json } from '../../configs/eslint/json.config.js';
+import { node, nodeTypeChecked } from '../../configs/eslint/node.config.js';
+// Node library: TypeScript/JavaScript emitted via tsc plus JSON. No web components or
+// standalone HTML.
+export const nodeLibrary = defineConfig([...node, ...json]);
+// Same as `nodeLibrary`, plus type-aware rules (needs a tsconfig; see `TypescriptOptions`).
+export const nodeLibraryTypeChecked = defineConfig([...nodeTypeChecked, ...json]);