@kiid_brian/eslint-config 0.2.1 → 0.2.5

package/README.md

@@ -1,11 +1,12 @@
-# ESLint Config Kiidbrian
+# @kiid_brian/eslint-config
 
 A comprehensive, flexible ESLint configuration package for TypeScript and JavaScript projects.
 
 ## Features
 
-- ✅ **Multiple Presets**: Choose from base, React, Node.js, or strict configurations
-- ✅ **TypeScript Support**: Full type-aware linting
+- ✅ **TypeScript First**: Comprehensive type-aware linting out of the box
+- ✅ **Full Type Safety**: Complete TypeScript definitions included
+- ✅ **Flexible Presets**: Choose from minimal, base, React, Node.js, or strict configurations
 - ✅ **React Support**: JSX, accessibility, and React-specific rules
 - ✅ **Import Organization**: Automatic import sorting and validation
 - ✅ **Security Rules**: Built-in security best practices
@@ -16,36 +17,101 @@ A comprehensive, flexible ESLint configuration package for TypeScript and JavaSc
 ## Installation
 
 ```bash
-npm install --save-dev eslint-config-kiidbrian
+npm install --save-dev @kiid_brian/eslint-config
 ```
 
+## Preset Options
+
+Choose the right preset for your project needs:
+
+### Minimal Preset
+
+**For basic TypeScript projects** - Only requires essential dependencies
+
+```bash
+npm install --save-dev @kiid_brian/eslint-config
+```
+
+```js
+// eslint.config.js
+import {minimal} from "@kiid_brian/eslint-config";
+
+export default minimal;
+```
+
+**Required peer dependencies:**
+
+- `@eslint/js`, `eslint`, `globals`, `typescript-eslint`
+
+### Standard Presets (Base, React, Node, Strict)
+
+**For full-featured projects** - Includes all optional plugins when available
+
+```bash
+npm install --save-dev @kiid_brian/eslint-config \
+  eslint-config-prettier \
+  eslint-plugin-import \
+  eslint-plugin-prettier \
+  # ... other optional plugins
+```
+
+```js
+// eslint.config.js
+import {react} from "@kiid_brian/eslint-config";
+
+export default react;
+```
+
+## TypeScript Support
+
+This config is **TypeScript-first** with comprehensive type safety:
+
+- ✅ **Full type-aware linting** with project analysis
+- ✅ **Modern TypeScript rules** (consistent types, optional chaining, nullish coalescing)
+- ✅ **TypeScript definitions included** - no additional setup required
+- ✅ **Stylistic consistency** (type imports, interface vs type, const assertions)
+- ✅ **Enhanced type checking** (no unnecessary assertions, inferrable types)
+- ✅ **Comprehensive file support** (`.ts`, `.tsx`, `.mts`, `.cts`, `.d.ts`)
+- ✅ **Smart unused variable detection** with TypeScript patterns
+- ✅ **Type-safe configuration API** with IntelliSense support
+
+**Note**: Make sure you have a `tsconfig.json` in your project root for optimal type checking.
+
 ### Peer Dependencies
 
-Install the required peer dependencies:
+#### Required (for all presets):
 
 ```bash
 npm install --save-dev \
   @eslint/js \
   eslint \
+  globals \
+  typescript-eslint
+```
+
+#### Optional (enhance functionality when installed):
+
+```bash
+npm install --save-dev \
   eslint-config-prettier \
   eslint-plugin-import \
-  eslint-plugin-jsx-a11y \
   eslint-plugin-jsdoc \
+  eslint-plugin-jsx-a11y \
   eslint-plugin-prettier \
   eslint-plugin-react \
   eslint-plugin-security \
-  globals \
-  prettier \
-  typescript-eslint
+  prettier
 ```
 
+**Note**: Optional plugins are loaded conditionally - your config works without them, but provides enhanced rules when they're available.
+
 ## Usage
 
 ### Basic Usage (Default React Configuration)
 
 ```js
 // eslint.config.js
-import config from "eslint-config-kiidbrian";
+import config from "@kiid_brian/eslint-config";
 
 export default config;
 ```
@@ -54,7 +120,7 @@ export default config;
 
 ```js
 // eslint.config.js
-import {react} from "eslint-config-kiidbrian";
+import {react} from "@kiid_brian/eslint-config";
 
 export default react;
 ```
@@ -70,7 +136,7 @@ Available presets:
 
 ```js
 // eslint.config.js
-import reactConfig from "eslint-config-kiidbrian/configs/react.js";
+import reactConfig from "@kiid_brian/eslint-config/configs/react.js";
 
 export default reactConfig;
 ```
@@ -79,7 +145,7 @@ export default reactConfig;
 
 ```js
 // eslint.config.js
-import {createConfig} from "eslint-config-kiidbrian";
+import {createConfig} from "@kiid_brian/eslint-config";
 
 export default createConfig({
   preset: "base",
@@ -103,9 +169,15 @@ export default createConfig({
 
 - Type: `string`
 - Default: `"react"`
-- Options: `"base" | "react" | "node" | "strict"`
+- Options: `"minimal" | "base" | "react" | "node" | "strict"`
+
+Choose the base configuration preset:
 
-Choose the base configuration preset.
+- `"minimal"`: Essential TypeScript rules only
+- `"base"`: Full TypeScript with optional plugins
+- `"react"`: React + TypeScript + accessibility
+- `"node"`: Node.js optimized configuration
+- `"strict"`: Maximum code quality rules
 
 #### `environments`
 
@@ -128,7 +200,7 @@ Custom ESLint configuration objects to merge with the preset.
 
 ```js
 // eslint.config.js
-import config from "eslint-config-kiidbrian";
+import config from "@kiid_brian/eslint-config";
 
 export default config;
 ```
@@ -137,7 +209,7 @@ export default config;
 
 ```js
 // eslint.config.js
-import {node} from "eslint-config-kiidbrian";
+import {node} from "@kiid_brian/eslint-config";
 
 export default node;
 ```
@@ -146,7 +218,7 @@ export default node;
 
 ```js
 // eslint.config.js
-import {strict} from "eslint-config-kiidbrian";
+import {strict} from "@kiid_brian/eslint-config";
 
 export default strict;
 ```
@@ -155,7 +227,7 @@ export default strict;
 
 ```js
 // eslint.config.js
-import {createConfig} from "eslint-config-kiidbrian";
+import {createConfig} from "@kiid_brian/eslint-config";
 
 export default createConfig({
   preset: "react",
@@ -165,9 +237,26 @@ export default createConfig({
 
 ### Custom Overrides
 
+```ts
+// eslint.config.ts (TypeScript)
+import {createConfig} from "@kiid_brian/eslint-config";
+
+export default createConfig({
+  preset: "base",
+  overrides: [
+    {
+      rules: {
+        "no-console": "off",
+        "@typescript-eslint/explicit-function-return-type": "warn",
+      },
+    },
+  ],
+});
+```
+
 ```js
-// eslint.config.js
-import {createConfig} from "eslint-config-kiidbrian";
+// eslint.config.js (JavaScript)
+import {createConfig} from "@kiid_brian/eslint-config";
 
 export default createConfig({
   preset: "base",
@@ -186,10 +275,12 @@ export default createConfig({
 
 ### TypeScript
 
-- Type-aware linting
-- Strict type checking
-- Unused variable detection
-- Import/export validation
+- **Full type-aware linting** with project analysis
+- **Modern TypeScript rules** (consistent types, optional chaining, nullish coalescing)
+- **Stylistic consistency** (type imports, interface vs type, const assertions)
+- **Enhanced type checking** (no unnecessary assertions, inferrable types)
+- **Comprehensive file support** (`.ts`, `.tsx`, `.mts`, `.cts`, `.d.ts`)
+- **Smart unused variable detection** with TypeScript patterns
 
 ### React
 

package/dist/configs/base.d.ts

@@ -0,0 +1,4 @@
+import type { Linter } from "eslint";
+declare const baseConfig: Linter.Config[];
+export default baseConfig;
+//# sourceMappingURL=base.d.ts.map

package/dist/configs/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../configs/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAmCnC,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EA+N9B,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/configs/base.js

@@ -0,0 +1,216 @@
+import js from "@eslint/js";
+import ts from "typescript-eslint";
+import globals from "globals";
+let prettierRecommended = {};
+let importPlugin = { flatConfigs: { recommended: {}, typescript: {} } };
+let jsdoc = { configs: { "flat/recommended": {} } };
+let security = { configs: { recommended: {} } };
+try {
+    prettierRecommended = require("eslint-plugin-prettier/recommended");
+}
+catch {
+}
+try {
+    importPlugin = require("eslint-plugin-import");
+}
+catch {
+}
+try {
+    jsdoc = require("eslint-plugin-jsdoc");
+}
+catch {
+}
+try {
+    security = require("eslint-plugin-security");
+}
+catch {
+}
+const baseConfig = [
+    js.configs.recommended,
+    ...ts.configs.recommended,
+    ...ts.configs.recommendedTypeChecked,
+    ...ts.configs.stylisticTypeChecked,
+    ...(importPlugin.flatConfigs?.recommended
+        ? [importPlugin.flatConfigs.recommended]
+        : []),
+    ...(importPlugin.flatConfigs?.typescript
+        ? [importPlugin.flatConfigs.typescript]
+        : []),
+    ...(security.configs?.recommended ? [security.configs.recommended] : []),
+    ...(jsdoc.configs?.["flat/recommended"]
+        ? [jsdoc.configs["flat/recommended"]]
+        : []),
+    {
+        languageOptions: {
+            globals: {
+                ...globals.node,
+                ...globals.browser,
+                ...globals.es2021,
+            },
+            parser: ts.parser,
+            parserOptions: {
+                ecmaVersion: "latest",
+                sourceType: "module",
+                project: true,
+                projectFolderIgnoreList: ["**/node_modules/**"],
+                tsconfigRootDir: process.cwd(),
+            },
+        },
+        files: ["**/*.ts", "**/*.tsx", "**/*.mts", "**/*.cts"],
+        plugins: {
+            import: importPlugin,
+            jsdoc,
+            security,
+        },
+        rules: {
+            "no-console": "warn",
+            "no-debugger": "error",
+            "@typescript-eslint/explicit-function-return-type": "off",
+            "@typescript-eslint/no-unused-vars": [
+                "error",
+                {
+                    argsIgnorePattern: "^_",
+                    varsIgnorePattern: "^_",
+                    caughtErrorsIgnorePattern: "^_",
+                },
+            ],
+            "@typescript-eslint/no-explicit-any": "warn",
+            "@typescript-eslint/prefer-const": "error",
+            "@typescript-eslint/no-var-requires": "error",
+            "@typescript-eslint/consistent-type-definitions": ["error", "interface"],
+            "@typescript-eslint/consistent-type-imports": [
+                "error",
+                { prefer: "type-imports" },
+            ],
+            "@typescript-eslint/no-import-type-side-effects": "error",
+            "@typescript-eslint/prefer-nullish-coalescing": "error",
+            "@typescript-eslint/prefer-optional-chain": "error",
+            "@typescript-eslint/no-unnecessary-type-assertion": "error",
+            "@typescript-eslint/no-non-null-assertion": "warn",
+            "@typescript-eslint/prefer-as-const": "error",
+            "@typescript-eslint/no-inferrable-types": "error",
+            "@typescript-eslint/consistent-type-exports": "error",
+            ...(importPlugin.flatConfigs?.recommended
+                ? {
+                    "import/no-unresolved": "error",
+                    "import/named": "error",
+                    "import/default": "error",
+                    "import/namespace": "error",
+                    "import/no-absolute-path": "error",
+                    "import/no-dynamic-require": "warn",
+                    "import/no-webpack-loader-syntax": "error",
+                    "import/order": [
+                        "error",
+                        {
+                            groups: [
+                                "builtin",
+                                "external",
+                                "internal",
+                                "parent",
+                                "sibling",
+                                "index",
+                            ],
+                            "newlines-between": "always",
+                            alphabetize: { order: "asc", caseInsensitive: true },
+                        },
+                    ],
+                }
+                : {}),
+            ...(security.configs?.recommended
+                ? {
+                    "security/detect-object-injection": "warn",
+                    "security/detect-non-literal-regexp": "warn",
+                    "security/detect-unsafe-regex": "error",
+                }
+                : {}),
+            ...(jsdoc.configs?.["flat/recommended"]
+                ? {
+                    "jsdoc/require-description": "warn",
+                    "jsdoc/check-values": "warn",
+                    "jsdoc/check-param-names": "error",
+                    "jsdoc/check-tag-names": "error",
+                    "jsdoc/require-param": "warn",
+                    "jsdoc/require-returns": "warn",
+                }
+                : {}),
+            "no-unused-vars": "off",
+            "prefer-const": "error",
+            "no-var": "error",
+            "object-shorthand": "error",
+            "prefer-arrow-callback": "error",
+            "prefer-template": "error",
+            eqeqeq: ["error", "always"],
+            curly: ["error", "all"],
+            "no-duplicate-imports": "error",
+        },
+        settings: {
+            ...(importPlugin.flatConfigs?.recommended
+                ? {
+                    "import/resolver": {
+                        typescript: true,
+                        node: true,
+                    },
+                }
+                : {}),
+        },
+    },
+    {
+        files: ["**/*.js", "**/*.mjs", "**/*.cjs"],
+        rules: {
+            "@typescript-eslint/no-var-requires": "off",
+            "@typescript-eslint/no-require-imports": "off",
+        },
+    },
+    {
+        files: ["**/*.d.ts"],
+        rules: {
+            "@typescript-eslint/no-unused-vars": "off",
+            "no-unused-vars": "off",
+        },
+    },
+    {
+        files: ["**/*.test.{ts,tsx,js,jsx}", "**/*.spec.{ts,tsx,js,jsx}"],
+        languageOptions: {
+            globals: {
+                ...globals.jest,
+            },
+        },
+        rules: {
+            "@typescript-eslint/no-explicit-any": "off",
+            "@typescript-eslint/no-non-null-assertion": "off",
+            "jsdoc/require-description": "off",
+            "jsdoc/require-param": "off",
+            "jsdoc/require-returns": "off",
+        },
+    },
+    {
+        files: [
+            "**/*.config.{ts,js}",
+            "**/vite.config.{ts,js}",
+            "**/vitest.config.{ts,js}",
+        ],
+        rules: {
+            "no-console": "off",
+            "@typescript-eslint/no-var-requires": "off",
+        },
+    },
+    {
+        ignores: [
+            "dist/**",
+            "build/**",
+            "node_modules/**",
+            "*.min.js",
+            "*.bundle.js",
+            "coverage/**",
+            ".next/**",
+            ".nuxt/**",
+            ".output/**",
+            ".vercel/**",
+            ".netlify/**",
+            "public/**",
+            "**/*.d.ts",
+        ],
+    },
+    prettierRecommended,
+];
+export default baseConfig;

package/dist/configs/node.d.ts

@@ -0,0 +1,4 @@
+import type { Linter } from "eslint";
+declare const nodeConfig: Linter.Config[];
+export default nodeConfig;
+//# sourceMappingURL=node.d.ts.map

package/dist/configs/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../configs/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAInC,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAiB9B,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/configs/node.js

@@ -0,0 +1,17 @@
+import globals from "globals";
+import baseConfig from "./base.js";
+const nodeConfig = [
+    ...baseConfig,
+    {
+        languageOptions: {
+            globals: {
+                ...globals.node,
+                ...globals.es2021,
+            },
+        },
+        rules: {
+            "no-console": "off",
+        },
+    },
+];
+export default nodeConfig;

package/dist/configs/react.d.ts

@@ -0,0 +1,4 @@
+import type { Linter } from "eslint";
+declare const reactConfig: Linter.Config[];
+export default reactConfig;
+//# sourceMappingURL=react.d.ts.map

package/dist/configs/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../configs/react.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAanC,QAAA,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAqC/B,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/configs/react.js

@@ -0,0 +1,39 @@
+import react from "eslint-plugin-react";
+import baseConfig from "./base.js";
+let jsxA11y = { flatConfigs: { recommended: {} } };
+try {
+    jsxA11y = require("eslint-plugin-jsx-a11y");
+}
+catch {
+}
+const reactConfig = [
+    ...baseConfig,
+    ...(react.configs.flat?.recommended ? [react.configs.flat.recommended] : []),
+    ...(react.configs.flat?.["jsx-runtime"]
+        ? [react.configs.flat["jsx-runtime"]]
+        : []),
+    ...(jsxA11y.flatConfigs?.recommended
+        ? [jsxA11y.flatConfigs.recommended]
+        : []),
+    {
+        plugins: {
+            ...(jsxA11y.flatConfigs?.recommended ? { "jsx-a11y": jsxA11y } : {}),
+            react,
+        },
+        rules: {
+            "react/prop-types": "off",
+            "react/react-in-jsx-scope": "off",
+            "react/jsx-uses-react": "off",
+            "react/jsx-uses-vars": "error",
+            "react/jsx-key": ["error", { checkFragmentShorthand: true }],
+            "react/jsx-no-useless-fragment": "error",
+            "react/self-closing-comp": "error",
+        },
+        settings: {
+            react: {
+                version: "detect",
+            },
+        },
+    },
+];
+export default reactConfig;

package/dist/configs/strict.d.ts

@@ -0,0 +1,4 @@
+import type { Linter } from "eslint";
+declare const strictConfig: Linter.Config[];
+export default strictConfig;
+//# sourceMappingURL=strict.d.ts.map

package/dist/configs/strict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict.d.ts","sourceRoot":"","sources":["../../configs/strict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAGnC,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EA0BhC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/configs/strict.js

@@ -0,0 +1,20 @@
+import baseConfig from "./base.js";
+const strictConfig = [
+    ...baseConfig,
+    {
+        rules: {
+            "@typescript-eslint/no-explicit-any": "error",
+            "@typescript-eslint/explicit-function-return-type": "warn",
+            "jsdoc/require-description": "error",
+            "jsdoc/require-param": "error",
+            "jsdoc/require-returns": "error",
+            "no-console": "error",
+            "security/detect-object-injection": "error",
+            complexity: ["error", 10],
+            "max-depth": ["error", 4],
+            "max-lines-per-function": ["error", 50],
+            "max-params": ["error", 4],
+        },
+    },
+];
+export default strictConfig;

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import type { Linter } from "eslint";
+import type { ConfigOptions, ESLintConfig, Preset, TestEnvironment } from "./types/index.js";
+export type { Preset, TestEnvironment, ConfigOptions, ESLintConfig };
+export declare function createConfig(options?: ConfigOptions): Linter.Config[];
+export declare const minimal: Linter.Config[];
+export declare const base: Linter.Config[];
+export declare const react: Linter.Config[];
+export declare const node: Linter.Config[];
+export declare const strict: Linter.Config[];
+declare const defaultConfig: Linter.Config[];
+export default defaultConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,MAAM,EACN,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAW1B,YAAY,EAAC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAC,CAAC;AAyBnE,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,CA4DzE;AAKD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAkB,CAAC;AAKtD,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAe,CAAC;AAKhD,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAgB,CAAC;AAKlD,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAe,CAAC;AAKhD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAiB,CAAC;AAKpD,QAAA,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAgB,CAAC;AAEnD,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,59 @@
+import baseConfig from "./configs/base.js";
+import reactConfig from "./configs/react.js";
+import nodeConfig from "./configs/node.js";
+import strictConfig from "./configs/strict.js";
+import minimalConfig from "./presets/minimal.js";
+export function createConfig(options = {}) {
+    const { preset = "react", overrides = [], environments = [], } = options;
+    let config;
+    switch (preset) {
+        case "minimal":
+            config = [...minimalConfig];
+            break;
+        case "base":
+            config = [...baseConfig];
+            break;
+        case "react":
+            config = [...reactConfig];
+            break;
+        case "node":
+            config = [...nodeConfig];
+            break;
+        case "strict":
+            config = [...strictConfig];
+            break;
+        default:
+            throw new Error(`Unknown preset: ${preset}. Available presets: minimal, base, react, node, strict`);
+    }
+    if (environments.includes("jest")) {
+        config.push({
+            files: ["**/*.test.{ts,tsx,js,jsx}", "**/*.spec.{ts,tsx,js,jsx}"],
+            languageOptions: {
+                globals: {
+                    ...require("globals").jest,
+                },
+            },
+        });
+    }
+    if (environments.includes("vitest")) {
+        config.push({
+            files: ["**/*.test.{ts,tsx,js,jsx}", "**/*.spec.{ts,tsx,js,jsx}"],
+            languageOptions: {
+                globals: {
+                    ...require("globals").vitest,
+                },
+            },
+        });
+    }
+    if (overrides.length > 0) {
+        config.push(...overrides);
+    }
+    return config;
+}
+export const minimal = minimalConfig;
+export const base = baseConfig;
+export const react = reactConfig;
+export const node = nodeConfig;
+export const strict = strictConfig;
+const defaultConfig = reactConfig;
+export default defaultConfig;

package/dist/presets/minimal.d.ts

@@ -0,0 +1,4 @@
+import type { Linter } from "eslint";
+declare const minimalConfig: Linter.Config[];
+export default minimalConfig;
+//# sourceMappingURL=minimal.d.ts.map

package/dist/presets/minimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal.d.ts","sourceRoot":"","sources":["../../presets/minimal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAKnC,QAAA,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAiEjC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/presets/minimal.js

@@ -0,0 +1,58 @@
+import js from "@eslint/js";
+import ts from "typescript-eslint";
+import globals from "globals";
+const minimalConfig = [
+    js.configs.recommended,
+    ...ts.configs.recommended,
+    {
+        languageOptions: {
+            globals: {
+                ...globals.node,
+                ...globals.browser,
+                ...globals.es2021,
+            },
+            parser: ts.parser,
+            parserOptions: {
+                ecmaVersion: "latest",
+                sourceType: "module",
+            },
+        },
+        files: ["**/*.ts", "**/*.tsx", "**/*.mts", "**/*.cts"],
+        rules: {
+            "no-console": "warn",
+            "no-debugger": "error",
+            "@typescript-eslint/explicit-function-return-type": "off",
+            "@typescript-eslint/no-unused-vars": [
+                "error",
+                {
+                    argsIgnorePattern: "^_",
+                    varsIgnorePattern: "^_",
+                    caughtErrorsIgnorePattern: "^_",
+                },
+            ],
+            "@typescript-eslint/no-explicit-any": "warn",
+            "prefer-const": "error",
+            "no-var": "error",
+            eqeqeq: ["error", "always"],
+            curly: ["error", "all"],
+        },
+    },
+    {
+        ignores: [
+            "dist/**",
+            "build/**",
+            "node_modules/**",
+            "*.min.js",
+            "*.bundle.js",
+            "coverage/**",
+            ".next/**",
+            ".nuxt/**",
+            ".output/**",
+            ".vercel/**",
+            ".netlify/**",
+            "public/**",
+            "**/*.d.ts",
+        ],
+    },
+];
+export default minimalConfig;

package/dist/types/index.d.ts

@@ -0,0 +1,18 @@
+import type { Linter } from "eslint";
+export type Preset = "minimal" | "base" | "react" | "node" | "strict";
+export type TestEnvironment = "jest" | "vitest";
+export interface ConfigOptions {
+    preset?: Preset;
+    environments?: TestEnvironment[];
+    overrides?: Linter.Config[];
+}
+export type ESLintConfig = Linter.Config[];
+export declare function createConfig(options?: ConfigOptions): ESLintConfig;
+export declare const minimal: ESLintConfig;
+export declare const base: ESLintConfig;
+export declare const react: ESLintConfig;
+export declare const node: ESLintConfig;
+export declare const strict: ESLintConfig;
+declare const _default: ESLintConfig;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAKnC,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAKtE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC;AAKhD,MAAM,WAAW,aAAa;IAE5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IAEjC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;CAC7B;AAKD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;AAK3C,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAElE;AAKD,MAAM,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,YAAY,CAAC;AAC3C,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,YAAY,CAAC;AACxC,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,EAAE,YAAY,CAAC;AACzC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,YAAY,CAAC;AACxC,MAAM,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,YAAY,CAAC;wBAMjB,YAAY;AAArC,wBAAsC"}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+export function createConfig(options) {
+    return [];
+}
+export default config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiid_brian/eslint-config",
-  "version": "0.2.1",
+  "version": "0.2.5",
   "description": "ESLint config for @kiid_brian",
   "keywords": [
     "eslint",
@@ -17,22 +17,44 @@
   "license": "MIT",
   "author": "Brian Paintsil",
   "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
-    ".": "./index.js",
-    "./base": "./configs/base.js",
-    "./react": "./configs/react.js",
-    "./node": "./configs/node.js",
-    "./strict": "./configs/strict.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./minimal": {
+      "types": "./dist/presets/minimal.d.ts",
+      "import": "./dist/presets/minimal.js"
+    },
+    "./base": {
+      "types": "./dist/configs/base.d.ts",
+      "import": "./dist/configs/base.js"
+    },
+    "./react": {
+      "types": "./dist/configs/react.d.ts",
+      "import": "./dist/configs/react.js"
+    },
+    "./node": {
+      "types": "./dist/configs/node.d.ts",
+      "import": "./dist/configs/node.js"
+    },
+    "./strict": {
+      "types": "./dist/configs/strict.d.ts",
+      "import": "./dist/configs/strict.js"
+    }
   },
-  "main": "index.js",
   "files": [
-    "index.js",
-    "configs/"
+    "dist/"
   ],
   "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
     "lint": "eslint . --ext .js,.ts",
     "lint:fix": "eslint . --ext .js,.ts --fix",
-    "test": "node -e \"const fs = require('fs'); const path = require('path'); ['index.js', 'configs/base.js', 'configs/react.js', 'configs/node.js', 'configs/strict.js'].forEach(f => { if (fs.existsSync(f)) console.log('✅', f); else console.log('❌ Missing:', f); });\""
+    "test": "node -e \"const fs = require('fs'); const path = require('path'); ['index.ts', 'configs/base.ts', 'configs/react.ts', 'configs/node.ts', 'configs/strict.ts', 'presets/minimal.ts', 'types/index.ts', 'tsconfig.json'].forEach(f => { if (fs.existsSync(f)) console.log('✅', f); else console.log('❌ Missing:', f); });\""
   },
   "dependencies": {
     "acorn": "^8.15.0",
@@ -254,32 +276,47 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
+    "@types/node": "^22.5.4",
     "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "typescript": "^5.6.2",
+    "typescript-eslint": "^8.51.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsx-a11y": "^6.10.0",
-    "eslint-plugin-jsdoc": "^50.2.2",
     "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-security": "^3.0.1",
-    "globals": "^17.0.0",
-    "prettier": "^3.7.4",
-    "typescript-eslint": "^8.51.0"
+    "prettier": "^3.7.4"
   },
   "peerDependencies": {
     "@eslint/js": "^9.22.0",
     "eslint": "^9.22.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsx-a11y": "^6.10.0",
-    "eslint-plugin-jsdoc": "^50.2.2",
-    "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-security": "^3.0.1",
     "globals": "^17.0.0",
-    "prettier": "^3.7.4",
     "typescript-eslint": "^8.28.0"
   },
+  "peerDependenciesMeta": {
+    "eslint-config-prettier": {
+      "optional": true
+    },
+    "eslint-plugin-import": {
+      "optional": true
+    },
+    "eslint-plugin-jsdoc": {
+      "optional": true
+    },
+    "eslint-plugin-jsx-a11y": {
+      "optional": true
+    },
+    "eslint-plugin-prettier": {
+      "optional": true
+    },
+    "eslint-plugin-react": {
+      "optional": true
+    },
+    "eslint-plugin-security": {
+      "optional": true
+    },
+    "prettier": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=18.0.0"
   },

package/configs/base.js

@@ -1,171 +0,0 @@
-import js from "@eslint/js";
-import ts from "typescript-eslint";
-import globals from "globals";
-import prettierRecommended from "eslint-plugin-prettier/recommended";
-import importPlugin from "eslint-plugin-import";
-import jsdoc from "eslint-plugin-jsdoc";
-import security from "eslint-plugin-security";
-
-export default [
-  // Base ESLint recommended rules
-  js.configs.recommended,
-
-  // TypeScript recommended rules
-  ...ts.configs.recommended,
-  ...ts.configs.recommendedTypeChecked,
-
-  // Import rules
-  importPlugin.flatConfigs.recommended,
-  importPlugin.flatConfigs.typescript,
-
-  // Security rules
-  security.configs.recommended,
-
-  // JSDoc rules
-  jsdoc.configs["flat/recommended"],
-
-  // Custom configuration
-  {
-    languageOptions: {
-      globals: {
-        ...globals.node,
-        ...globals.browser,
-        ...globals.es2021,
-      },
-      parser: ts.parser,
-      parserOptions: {
-        ecmaVersion: "latest",
-        sourceType: "module",
-        project: true, // Enable type-aware rules
-      },
-    },
-    plugins: {
-      import: importPlugin,
-      jsdoc,
-      security,
-    },
-    rules: {
-      // Console and debugging
-      "no-console": "warn",
-      "no-debugger": "error",
-
-      // TypeScript specific rules
-      "@typescript-eslint/explicit-function-return-type": "off",
-      "@typescript-eslint/no-unused-vars": [
-        "error",
-        {
-          argsIgnorePattern: "^_",
-          varsIgnorePattern: "^_",
-          caughtErrorsIgnorePattern: "^_",
-        },
-      ],
-      "@typescript-eslint/no-explicit-any": "warn",
-      "@typescript-eslint/prefer-const": "error",
-      "@typescript-eslint/no-var-requires": "error",
-
-      // Import rules
-      "import/no-unresolved": "error",
-      "import/named": "error",
-      "import/default": "error",
-      "import/namespace": "error",
-      "import/no-absolute-path": "error",
-      "import/no-dynamic-require": "warn",
-      "import/no-webpack-loader-syntax": "error",
-      "import/order": [
-        "error",
-        {
-          groups: [
-            "builtin",
-            "external",
-            "internal",
-            "parent",
-            "sibling",
-            "index",
-          ],
-          "newlines-between": "always",
-          alphabetize: {order: "asc", caseInsensitive: true},
-        },
-      ],
-
-      // Security rules
-      "security/detect-object-injection": "warn",
-      "security/detect-non-literal-regexp": "warn",
-      "security/detect-unsafe-regex": "error",
-
-      // JSDoc rules
-      "jsdoc/require-description": "warn",
-      "jsdoc/check-values": "warn",
-      "jsdoc/check-param-names": "error",
-      "jsdoc/check-tag-names": "error",
-      "jsdoc/require-param": "warn",
-      "jsdoc/require-returns": "warn",
-
-      // General code quality
-      "no-unused-vars": "off", // Use @typescript-eslint/no-unused-vars instead
-      "prefer-const": "error",
-      "no-var": "error",
-      "object-shorthand": "error",
-      "prefer-arrow-callback": "error",
-      "prefer-template": "error",
-      eqeqeq: ["error", "always"],
-      curly: ["error", "all"],
-      "no-duplicate-imports": "error",
-    },
-    settings: {
-      "import/resolver": {
-        typescript: true,
-        node: true,
-      },
-    },
-  },
-
-  // Environment-specific configurations
-  {
-    files: ["**/*.test.{ts,tsx,js,jsx}", "**/*.spec.{ts,tsx,js,jsx}"],
-    languageOptions: {
-      globals: {
-        ...globals.jest,
-      },
-    },
-    rules: {
-      "@typescript-eslint/no-explicit-any": "off", // Allow any in tests
-      "jsdoc/require-description": "off", // Less strict JSDoc in tests
-      "jsdoc/require-param": "off",
-      "jsdoc/require-returns": "off",
-    },
-  },
-
-  {
-    files: [
-      "**/*.config.{ts,js}",
-      "**/vite.config.{ts,js}",
-      "**/vitest.config.{ts,js}",
-    ],
-    rules: {
-      "no-console": "off", // Allow console in config files
-      "@typescript-eslint/no-var-requires": "off", // Allow require in configs
-    },
-  },
-
-  // Ignore patterns
-  {
-    ignores: [
-      "dist/**",
-      "build/**",
-      "node_modules/**",
-      "*.min.js",
-      "*.bundle.js",
-      "coverage/**",
-      ".next/**",
-      ".nuxt/**",
-      ".output/**",
-      ".vercel/**",
-      ".netlify/**",
-      "public/**",
-      "**/*.d.ts",
-    ],
-  },
-
-  // Prettier must be last to override conflicting rules
-  prettierRecommended,
-];

package/configs/node.js

@@ -1,22 +0,0 @@
-import globals from "globals";
-import baseConfig from "./base.js";
-
-export default [
-  ...baseConfig,
-
-  // Node.js-specific configuration
-  {
-    languageOptions: {
-      globals: {
-        ...globals.node,
-        ...globals.es2021,
-      },
-    },
-    rules: {
-      "no-console": "off",
-
-      // Node.js specific rules can be added here
-      // For example, you might want to enforce certain patterns
-    },
-  },
-];

package/configs/react.js

@@ -1,37 +0,0 @@
-import jsxA11y from "eslint-plugin-jsx-a11y";
-import react from "eslint-plugin-react";
-import baseConfig from "./base.js";
-
-export default [
-  ...baseConfig,
-
-  // React recommended rules
-  react.configs.flat.recommended,
-  react.configs.flat["jsx-runtime"],
-
-  // Accessibility rules
-  jsxA11y.flatConfigs.recommended,
-
-  // React-specific configuration
-  {
-    plugins: {
-      "jsx-a11y": jsxA11y,
-      react,
-    },
-    rules: {
-      // React specific rules
-      "react/prop-types": "off", // TypeScript handles prop validation
-      "react/react-in-jsx-scope": "off", // Not needed in React 17+
-      "react/jsx-uses-react": "off", // Not needed in React 17+
-      "react/jsx-uses-vars": "error",
-      "react/jsx-key": ["error", {checkFragmentShorthand: true}],
-      "react/jsx-no-useless-fragment": "error",
-      "react/self-closing-comp": "error",
-    },
-    settings: {
-      react: {
-        version: "detect",
-      },
-    },
-  },
-];

package/configs/strict.js

@@ -1,29 +0,0 @@
-import baseConfig from "./base.js";
-
-export default [
-  ...baseConfig,
-
-  // Strict configuration overrides
-  {
-    rules: {
-      // Stricter TypeScript rules
-      "@typescript-eslint/no-explicit-any": "error", // Upgrade to error
-      "@typescript-eslint/explicit-function-return-type": "warn", // Enable return type requirements
-
-      // Stricter JSDoc requirements
-      "jsdoc/require-description": "error", // Upgrade to error
-      "jsdoc/require-param": "error", // Upgrade to error
-      "jsdoc/require-returns": "error", // Upgrade to error
-
-      // Stricter general rules
-      "no-console": "error", // Upgrade to error
-      "security/detect-object-injection": "error", // Upgrade to error
-
-      // Additional strict rules
-      complexity: ["error", 10], // Limit cyclomatic complexity
-      "max-depth": ["error", 4], // Limit nesting depth
-      "max-lines-per-function": ["error", 50], // Limit function length
-      "max-params": ["error", 4], // Limit parameter count
-    },
-  },
-];

package/index.js

@@ -1,82 +0,0 @@
-import baseConfig from "./configs/base.js";
-import reactConfig from "./configs/react.js";
-import nodeConfig from "./configs/node.js";
-import strictConfig from "./configs/strict.js";
-
-// Default export (backwards compatibility with original eslint.config.js)
-export default reactConfig;
-
-// Named exports for different presets
-export const base = baseConfig;
-export const react = reactConfig;
-export const node = nodeConfig;
-export const strict = strictConfig;
-
-// Function to create custom config with overrides
-export function createConfig(options = {}) {
-  const {
-    preset = "react", // default preset
-    overrides = [],
-    environments = [],
-    typescript = true,
-    react: enableReact = true,
-    accessibility = true,
-    security = true,
-    jsdoc = true,
-    prettier = true,
-  } = options;
-
-  // Start with the chosen preset
-  let config;
-  switch (preset) {
-    case "base":
-      config = [...baseConfig];
-      break;
-    case "react":
-      config = [...reactConfig];
-      break;
-    case "node":
-      config = [...nodeConfig];
-      break;
-    case "strict":
-      config = [...strictConfig];
-      break;
-    default:
-      throw new Error(
-        `Unknown preset: ${preset}. Available presets: base, react, node, strict`
-      );
-  }
-
-  // Add environment-specific configurations
-  if (environments.includes("jest")) {
-    config.push({
-      files: ["**/*.test.{ts,tsx,js,jsx}", "**/*.spec.{ts,tsx,js,jsx}"],
-      languageOptions: {
-        globals: {
-          ...require("globals").jest,
-        },
-      },
-    });
-  }
-
-  if (environments.includes("vitest")) {
-    config.push({
-      files: ["**/*.test.{ts,tsx,js,jsx}", "**/*.spec.{ts,tsx,js,jsx}"],
-      languageOptions: {
-        globals: {
-          ...require("globals").vitest,
-        },
-      },
-    });
-  }
-
-  // Apply custom overrides
-  if (overrides.length > 0) {
-    config.push(...overrides);
-  }
-
-  return config;
-}
-
-// Re-export individual configs for advanced usage
-export {baseConfig, reactConfig, nodeConfig, strictConfig};