@wowlab/eslint-config 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ESLint Config contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+<!-- @generated by markupwright v0.1.2 -- do not edit by hand. Edit the source template and run `markupwright`. -->
+
+# ESLint Config
+
+Composable ESLint flat configs for JavaScript and TypeScript
+
+## Getting started
+
+```console
+pnpm add --save-dev @wowlab/eslint-config eslint typescript
+```
+
+```js
+import { createConfig, presets } from "@wowlab/eslint-config";
+
+export default createConfig({
+  presets: [
+    presets.next(),
+    presets.react({
+      typeChecked: true,
+      tsconfigRootDir: import.meta.dirname,
+    }),
+    presets.tanstackQuery(),
+  ],
+  internalPatterns: ["^@/", "^@acme/"],
+  ignores: ["dist/**"],
+  rules: {
+    "unicorn/prefer-module": "off",
+  },
+  overrides: [
+    {
+      files: ["scripts/**"],
+      rules: { "no-console": "off" },
+    },
+  ],
+});
+```
+
+`createConfig` includes the base rules. Consumer rules and overrides are applied last.
+
+## Presets
+
+- `deno` adds Deno globals.
+- `next` adds the Next.js Core Web Vitals rules.
+- `node` adds Node.js globals.
+- `react` adds React rules for JavaScript. Set `typescript: true` to add TypeScript support or `typeChecked: true` to add TypeScript and type-aware rules together.
+- `tanstackQuery` adds TanStack Query rules.
+- `typescript` adds TypeScript rules, optionally using the project service.
+
+Presets return ordinary flat-config arrays and work alongside configs from other plugins.
+
+## Development
+
+Development requires Node.js 22.13 or newer, Deno 2, pnpm, and Markupwright.
+
+```console
+cargo install markupwright --locked
+corepack enable
+pnpm install
+pnpm check
+```
+
+Run `pnpm docs:generate` after changing a `.md.in` file or package metadata.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) to get started and [SECURITY.md](SECURITY.md) for vulnerability reports.
+
+## License
+
+[MIT](LICENSE)

package/dist/core/base.d.ts

@@ -0,0 +1,4 @@
+import type { Linter } from "eslint";
+export declare function createBaseConfig({ internalPatterns, }?: {
+    internalPatterns?: string[];
+}): Linter.Config[];

package/dist/core/base.js

@@ -0,0 +1,57 @@
+import comments from "@eslint-community/eslint-plugin-eslint-comments/configs";
+import js from "@eslint/js";
+import sonarjs from "eslint-plugin-sonarjs";
+import switchCase from "eslint-plugin-switch-case";
+import unicorn from "eslint-plugin-unicorn";
+import { perfectionistConfig } from "./perfectionist.js";
+import { stylisticConfig } from "./stylistic.js";
+const ruleOverrides = {
+    "@eslint-community/eslint-comments/disable-enable-pair": [
+        "error",
+        { allowWholeFile: true },
+    ],
+    "@eslint-community/eslint-comments/no-unlimited-disable": "off",
+    "sonarjs/pseudo-random": "off",
+    "sonarjs/todo-tag": "off",
+    "sonarjs/void-use": "off",
+    "unicorn/import-style": "off",
+    "unicorn/no-abusive-eslint-disable": "off",
+    "unicorn/no-array-reduce": "off",
+    "unicorn/no-array-sort": "off",
+    "unicorn/no-await-expression-member": "off",
+    "unicorn/no-null": "off",
+    "unicorn/no-thenable": "off",
+    "unicorn/number-literal-case": "off",
+    "unicorn/prefer-global-this": "off",
+    "unicorn/prefer-spread": "off",
+    "unicorn/prevent-abbreviations": "off",
+};
+export function createBaseConfig({ internalPatterns = [], } = {}) {
+    return [
+        {
+            linterOptions: { reportUnusedDisableDirectives: "error" },
+            name: "wowlab/linter-options",
+        },
+        {
+            ...js.configs.recommended,
+            name: "wowlab/javascript",
+        },
+        perfectionistConfig(internalPatterns),
+        stylisticConfig,
+        {
+            name: "wowlab/switch-case",
+            plugins: { "switch-case": switchCase },
+            rules: {
+                "switch-case/newline-between-switch-case": [
+                    "error",
+                    "always",
+                    { fallthrough: "never" },
+                ],
+            },
+        },
+        unicorn.configs["flat/recommended"],
+        sonarjs.configs.recommended,
+        comments.recommended,
+        { name: "wowlab/rule-defaults", rules: ruleOverrides },
+    ];
+}

package/dist/core/perfectionist.d.ts

@@ -0,0 +1,2 @@
+import type { Linter } from "eslint";
+export declare function perfectionistConfig(internalPatterns: string[]): Linter.Config;

package/dist/core/perfectionist.js

@@ -0,0 +1,51 @@
+import perfectionist from "eslint-plugin-perfectionist";
+// prettier-ignore
+const CLASS_GROUPS = [
+    "index-signature",
+    ["static-property", "static-accessor-property"],
+    "static-block",
+    "static-get-method",
+    "static-set-method",
+    "static-method",
+    ["property", "accessor-property"],
+    ["protected-property", "protected-accessor-property"],
+    ["private-property", "private-accessor-property"],
+    "constructor",
+    "get-method",
+    "set-method",
+    "method",
+    "protected-get-method",
+    "protected-set-method",
+    "protected-method",
+    "private-get-method",
+    "private-set-method",
+    "private-method",
+    "unknown",
+];
+export function perfectionistConfig(internalPatterns) {
+    const importOptions = internalPatterns.length > 0 ? { internalPattern: internalPatterns } : {};
+    return {
+        name: "wowlab/perfectionist",
+        plugins: { perfectionist },
+        rules: {
+            curly: ["error", "all"],
+            "perfectionist/sort-array-includes": "warn",
+            "perfectionist/sort-classes": ["warn", { groups: CLASS_GROUPS }],
+            "perfectionist/sort-decorators": "warn",
+            "perfectionist/sort-enums": ["warn", { partitionByComment: true }],
+            "perfectionist/sort-exports": "warn",
+            "perfectionist/sort-heritage-clauses": "warn",
+            "perfectionist/sort-imports": ["warn", importOptions],
+            "perfectionist/sort-interfaces": "warn",
+            "perfectionist/sort-intersection-types": "warn",
+            "perfectionist/sort-maps": ["warn", { partitionByComment: true }],
+            "perfectionist/sort-modules": "warn",
+            "perfectionist/sort-named-exports": "warn",
+            "perfectionist/sort-named-imports": "warn",
+            "perfectionist/sort-objects": ["warn", { partitionByComment: true }],
+            "perfectionist/sort-sets": ["warn", { partitionByComment: true }],
+            "perfectionist/sort-switch-case": "warn",
+            "perfectionist/sort-variable-declarations": "warn",
+        },
+    };
+}

package/dist/core/stylistic.d.ts

@@ -0,0 +1,2 @@
+import type { Linter } from "eslint";
+export declare const stylisticConfig: Linter.Config;

package/dist/core/stylistic.js

@@ -0,0 +1,120 @@
+import stylistic from "@stylistic/eslint-plugin";
+const prettierCompatible = stylistic.configs.customize({
+    arrowParens: true,
+    blockSpacing: true,
+    braceStyle: "1tbs",
+    commaDangle: "always-multiline",
+    indent: 2,
+    jsx: true,
+    quoteProps: "as-needed",
+    quotes: "double",
+    semi: true,
+    severity: "error",
+});
+const structuralRules = {
+    "@stylistic/function-call-spacing": ["error", "never"],
+    "@stylistic/jsx-pascal-case": "error",
+    "@stylistic/jsx-self-closing-comp": [
+        "error",
+        { component: true, html: true },
+    ],
+    "@stylistic/jsx-wrap-multilines": [
+        "error",
+        {
+            arrow: "parens-new-line",
+            assignment: "parens-new-line",
+            condition: "parens-new-line",
+            declaration: "parens-new-line",
+            logical: "parens-new-line",
+            prop: "ignore",
+            propertyValue: "ignore",
+            return: "parens-new-line",
+        },
+    ],
+    "@stylistic/linebreak-style": ["error", "unix"],
+    "@stylistic/lines-around-comment": [
+        "error",
+        {
+            allowArrayEnd: true,
+            allowArrayStart: true,
+            allowBlockEnd: true,
+            allowBlockStart: true,
+            allowClassEnd: true,
+            allowClassStart: true,
+            allowEnumEnd: true,
+            allowEnumStart: true,
+            allowInterfaceEnd: true,
+            allowInterfaceStart: true,
+            allowModuleEnd: true,
+            allowModuleStart: true,
+            allowObjectEnd: true,
+            allowObjectStart: true,
+            allowTypeEnd: true,
+            allowTypeStart: true,
+            beforeBlockComment: true,
+        },
+    ],
+    "@stylistic/no-extra-semi": "error",
+    "@stylistic/nonblock-statement-body-position": ["error", "beside"],
+    // prettier-ignore
+    "@stylistic/padding-line-between-statements": [
+        "error",
+        { blankLine: "always", next: "return", prev: "*" },
+        { blankLine: "always", next: "*", prev: ["const", "let", "var"] },
+        { blankLine: "any", next: ["const", "let", "var"], prev: ["const", "let", "var"] },
+        { blankLine: "always", next: "*", prev: "directive" },
+        { blankLine: "any", next: "directive", prev: "directive" },
+        { blankLine: "always", next: ["if", "for", "while", "switch", "try", "function", "class"], prev: "*" },
+        { blankLine: "always", next: "*", prev: ["if", "for", "while", "switch", "try", "function", "class"] },
+        { blankLine: "always", next: "block-like", prev: "block-like" },
+        { blankLine: "always", next: "export", prev: "*" },
+        { blankLine: "any", next: "function", prev: "function" },
+        { blankLine: "any", next: "export", prev: "export" },
+    ],
+    "@stylistic/quotes": [
+        "error",
+        "double",
+        { allowTemplateLiterals: "always", avoidEscape: true },
+    ],
+    "@stylistic/semi-style": ["error", "last"],
+    "@stylistic/switch-colon-spacing": ["error", { after: true, before: false }],
+};
+// prettier-ignore
+const prettierOwnedRules = [
+    "array-bracket-newline",
+    "array-element-newline",
+    "curly-newline",
+    "exp-jsx-props-style",
+    "exp-list-style",
+    "function-call-argument-newline",
+    "function-paren-newline",
+    "implicit-arrow-linebreak",
+    "indent",
+    "indent-binary-ops",
+    "jsx-child-element-spacing",
+    "jsx-curly-newline",
+    "jsx-indent",
+    "jsx-newline",
+    "jsx-one-expression-per-line",
+    "jsx-sort-props",
+    "line-comment-position",
+    "max-len",
+    "multiline-comment-style",
+    "multiline-ternary",
+    "newline-per-chained-call",
+    "no-confusing-arrow",
+    "object-curly-newline",
+    "object-property-newline",
+    "one-var-declaration-per-line",
+    "operator-linebreak",
+    "wrap-regex",
+];
+export const stylisticConfig = {
+    ...prettierCompatible,
+    name: "wowlab/stylistic",
+    rules: {
+        ...prettierCompatible.rules,
+        ...structuralRules,
+        ...Object.fromEntries(prettierOwnedRules.map((rule) => [`@stylistic/${rule}`, "off"])),
+    },
+};

package/dist/create-config.d.ts

@@ -0,0 +1,12 @@
+import type { Config, ConfigWithExtendsArray } from "@eslint/config-helpers";
+import type { Linter } from "eslint";
+export interface ConfigOptions {
+    ignores?: string[];
+    internalPatterns?: string[];
+    overrides?: ConfigInput[];
+    presets?: ConfigInput[];
+    rules?: Partial<Linter.RulesRecord>;
+}
+type ConfigInput = ConfigWithExtendsArray[number];
+export declare function createConfig({ ignores, internalPatterns, overrides, presets, rules, }?: ConfigOptions): Config[];
+export {};

package/dist/create-config.js

@@ -0,0 +1,16 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import { createBaseConfig } from "./core/base.js";
+export function createConfig({ ignores = [], internalPatterns = [], overrides = [], presets = [], rules = {}, } = {}) {
+    const config = [
+        ...createBaseConfig({ internalPatterns }),
+        ...presets,
+    ];
+    if (ignores.length > 0) {
+        config.push(globalIgnores(ignores, "wowlab/global-ignores"));
+    }
+    if (Object.keys(rules).length > 0) {
+        config.push({ name: "wowlab/consumer-rules", rules });
+    }
+    config.push(...overrides);
+    return defineConfig(...config);
+}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { deno, node } from "./presets/globals.js";
+import { next } from "./presets/next.js";
+import { react } from "./presets/react.js";
+import { tanstackQuery } from "./presets/tanstack-query.js";
+import { typescript } from "./presets/typescript.js";
+export { type ConfigOptions, createConfig } from "./create-config.js";
+export type { FilesOptions } from "./presets/globals.js";
+export type { ReactOptions } from "./presets/react.js";
+export type { TypeScriptOptions } from "./presets/typescript.js";
+export declare const presets: Readonly<{
+    deno: typeof deno;
+    next: typeof next;
+    node: typeof node;
+    react: typeof react;
+    tanstackQuery: typeof tanstackQuery;
+    typescript: typeof typescript;
+}>;

package/dist/index.js

@@ -0,0 +1,14 @@
+import { deno, node } from "./presets/globals.js";
+import { next } from "./presets/next.js";
+import { react } from "./presets/react.js";
+import { tanstackQuery } from "./presets/tanstack-query.js";
+import { typescript } from "./presets/typescript.js";
+export { createConfig } from "./create-config.js";
+export const presets = Object.freeze({
+    deno,
+    next,
+    node,
+    react,
+    tanstackQuery,
+    typescript,
+});

package/dist/presets/globals.d.ts

@@ -0,0 +1,6 @@
+import type { Linter } from "eslint";
+export interface FilesOptions {
+    files?: string[];
+}
+export declare function deno({ files, }?: FilesOptions): Linter.Config[];
+export declare function node({ files, }?: FilesOptions): Linter.Config[];

package/dist/presets/globals.js

@@ -0,0 +1,16 @@
+import environmentGlobals from "globals";
+export function deno({ files = ["**/*.{js,jsx,ts,tsx,mjs,mts,cjs,cts}"], } = {}) {
+    return environment("denoBuiltin", files);
+}
+export function node({ files = ["**/*.{js,mjs,cjs,ts,mts,cts}"], } = {}) {
+    return environment("node", files);
+}
+function environment(name, files) {
+    return [
+        {
+            files,
+            languageOptions: { globals: { ...environmentGlobals[name] } },
+            name: `wowlab/globals/${name}`,
+        },
+    ];
+}

package/dist/presets/next.d.ts

@@ -0,0 +1,3 @@
+import type { Linter } from "eslint";
+import type { FilesOptions } from "./globals.js";
+export declare function next({ files, }?: FilesOptions): Linter.Config[];

package/dist/presets/next.js

@@ -0,0 +1,10 @@
+import nextPlugin from "@next/eslint-plugin-next";
+export function next({ files = ["**/*.{js,jsx,ts,tsx,mjs,mts,cjs,cts}"], } = {}) {
+    return [
+        {
+            ...nextPlugin.configs["core-web-vitals"],
+            files,
+            name: "wowlab/next/core-web-vitals",
+        },
+    ];
+}

package/dist/presets/react.d.ts

@@ -0,0 +1,9 @@
+import type { Linter } from "eslint";
+import type { FilesOptions } from "./globals.js";
+export interface ReactOptions extends FilesOptions {
+    tsconfigRootDir?: string;
+    typeChecked?: boolean;
+    typescript?: boolean;
+    typescriptFiles?: string[];
+}
+export declare function react({ files, tsconfigRootDir, typeChecked, typescript, typescriptFiles, }?: ReactOptions): Linter.Config[];

package/dist/presets/react.js

@@ -0,0 +1,38 @@
+import eslintReact from "@eslint-react/eslint-plugin";
+import { typescript as typescriptPreset } from "./typescript.js";
+const JAVASCRIPT_FILES = ["**/*.{js,jsx,mjs,cjs}"];
+const TYPESCRIPT_FILES = ["**/*.{ts,tsx,mts,cts}"];
+export function react({ files = JAVASCRIPT_FILES, tsconfigRootDir, typeChecked = false, typescript = false, typescriptFiles = TYPESCRIPT_FILES, } = {}) {
+    const typescriptConfigName = typeChecked
+        ? "recommended-type-checked"
+        : "recommended";
+    const recommendedConfig = eslintReact.configs.recommended;
+    const typescriptConfig = eslintReact.configs[typescriptConfigName];
+    const javascriptConfig = {
+        ...recommendedConfig,
+        files,
+        languageOptions: {
+            ...recommendedConfig.languageOptions,
+            parserOptions: {
+                ecmaFeatures: { jsx: true },
+            },
+        },
+        name: "wowlab/react/recommended",
+    };
+    if (!typescript && !typeChecked) {
+        return [javascriptConfig];
+    }
+    return [
+        javascriptConfig,
+        ...typescriptPreset({
+            files: typescriptFiles,
+            tsconfigRootDir,
+            typeChecked,
+        }),
+        {
+            ...typescriptConfig,
+            files: typescriptFiles,
+            name: `wowlab/react/typescript/${typescriptConfigName}`,
+        },
+    ];
+}

package/dist/presets/tanstack-query.d.ts

@@ -0,0 +1,3 @@
+import type { Linter } from "eslint";
+import type { FilesOptions } from "./globals.js";
+export declare function tanstackQuery({ files, }?: FilesOptions): Linter.Config[];

package/dist/presets/tanstack-query.js

@@ -0,0 +1,8 @@
+import query from "@tanstack/eslint-plugin-query";
+export function tanstackQuery({ files = ["**/*.{js,jsx,ts,tsx,mjs,mts,cjs,cts}"], } = {}) {
+    return query.configs["flat/recommended"].map((config) => ({
+        ...config,
+        files,
+        name: config.name?.replace("tanstack/query/", "wowlab/tanstack-query/"),
+    }));
+}

package/dist/presets/typescript.d.ts

@@ -0,0 +1,7 @@
+import type { Linter } from "eslint";
+import type { FilesOptions } from "./globals.js";
+export interface TypeScriptOptions extends FilesOptions {
+    tsconfigRootDir?: string;
+    typeChecked?: boolean;
+}
+export declare function typescript({ files, tsconfigRootDir, typeChecked, }?: TypeScriptOptions): Linter.Config[];

package/dist/presets/typescript.js

@@ -0,0 +1,23 @@
+import tseslint from "typescript-eslint";
+export function typescript({ files = ["**/*.{ts,tsx,mts,cts}"], tsconfigRootDir, typeChecked = false, } = {}) {
+    const upstreamConfig = (typeChecked
+        ? tseslint.configs.recommendedTypeChecked
+        : tseslint.configs.recommended);
+    return upstreamConfig.map((config) => {
+        const languageOptions = config.languageOptions
+            ? {
+                ...config.languageOptions,
+                parserOptions: {
+                    ...(typeChecked ? { projectService: true } : {}),
+                    ...(tsconfigRootDir ? { tsconfigRootDir } : {}),
+                },
+            }
+            : undefined;
+        return {
+            ...config,
+            files,
+            ...(languageOptions ? { languageOptions } : {}),
+            name: config.name?.replace("typescript-eslint/", "wowlab/typescript/"),
+        };
+    });
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@wowlab/eslint-config",
+  "version": "0.1.0",
+  "description": "Composable ESLint flat configs for JavaScript and TypeScript",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wowlabdev/eslint-config.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wowlabdev/eslint-config/issues"
+  },
+  "homepage": "https://github.com/wowlabdev/eslint-config#readme",
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "flat-config",
+    "javascript",
+    "typescript"
+  ],
+  "engines": {
+    "node": "^22.13.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "eslint": "^10.0.0",
+    "typescript": ">=4.8.4 <6.1.0"
+  },
+  "dependencies": {
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.7.2",
+    "@eslint-react/eslint-plugin": "^5.8.6",
+    "@eslint/config-helpers": "^0.7.0",
+    "@eslint/js": "^10.0.1",
+    "@next/eslint-plugin-next": "16.2.9",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "@tanstack/eslint-plugin-query": "^5.100.14",
+    "eslint-plugin-perfectionist": "^5.9.0",
+    "eslint-plugin-sonarjs": "^4.0.3",
+    "eslint-plugin-switch-case": "^4.0.0",
+    "eslint-plugin-unicorn": "^64.0.0",
+    "globals": "^17.6.0",
+    "typescript-eslint": "8.68.0"
+  }
+}