@vfourny/node-toolkit 1.0.22 → 1.1.1

package/README.md

@@ -23,6 +23,23 @@ To install **VFourny's Node Toolkit** via npm, make sure you have [Node.js](http
 npm install -D @vfourny/node-toolkit
 ```
 
+### Peer Dependencies
+
+This package requires the following peer dependencies to be installed in your project:
+
+```bash
+npm install -D eslint prettier typescript commitlint semantic-release
+```
+
+**Minimum versions:**
+
+- Node.js: `>=20.13 <25`
+- ESLint: `^9.3.0`
+- Prettier: `^3.2.5`
+- TypeScript: `^5.5.2`
+- Commitlint: `^19.8.0 || ^20.1.0`
+- Semantic Release: `^24.0.0 || ^25.0.0`
+
 ## Environment Variables
 
 For `semantic-release` to work properly, certain environment variables must be defined in your GitHub repository configuration.
@@ -42,17 +59,103 @@ For `semantic-release` to work properly, certain environment variables must be d
 
 ### ESLint
 
-To import the ESLint configuration into your project, add the following code to your [ESLint](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-file) configuration file:
+This package provides multiple ESLint configurations tailored for different project types. Choose the one that fits your project:
 
-```javascript
-import nodeToolkitEslintConfig from '@vfourny/node-toolkit/eslint'
+#### For Node.js Projects
 
-export default {
-  ...nodeToolkitEslintConfig,
-  // Your custom configurations
-}
+```typescript
+// eslint.config.ts
+import nodeConfig from '@vfourny/node-toolkit/eslint/node'
+
+export default nodeConfig
+```
+
+#### For Vue Projects
+
+```typescript
+// eslint.config.ts
+import vueConfig from '@vfourny/node-toolkit/eslint/vue'
+
+export default vueConfig
+```
+
+#### For Nuxt Projects
+
+```typescript
+// eslint.config.ts
+import nuxtConfig from '@vfourny/node-toolkit/eslint/nuxt'
+
+export default nuxtConfig
+```
+
+#### Default Import (Node.js)
+
+```typescript
+// eslint.config.ts
+import config from '@vfourny/node-toolkit/eslint'
+
+export default config
 ```
 
+#### Advanced Usage
+
+For advanced users who want to compose their own configuration:
+
+```typescript
+// eslint.config.ts
+import {
+  baseConfig,
+  nodeGlobalsConfig,
+  typescriptConfigs,
+  prettierConfig,
+} from '@vfourny/node-toolkit/eslint/base'
+import typescriptEslint from 'typescript-eslint'
+
+export default typescriptEslint.config(
+  ...typescriptConfigs,
+  nodeGlobalsConfig,
+  baseConfig,
+  // Your custom configs here
+  prettierConfig, // Should be last
+)
+```
+
+#### Configuration Rules Overview
+
+All ESLint configurations include the following enforced rules:
+
+**Code Quality:**
+
+- `eqeqeq`: Require `===` and `!==` instead of `==` and `!=`
+- `prefer-const`: Prefer `const` over `let` when variables are not reassigned
+- `no-console`: Disallow `console.log` statements (prevents debug code in production)
+- `no-debugger`: Disallow `debugger` statements
+- `no-var`: Require `let` or `const` instead of `var`
+
+**TypeScript:**
+
+- `@typescript-eslint/consistent-type-definitions`: Enforce `interface` over `type`
+- `@typescript-eslint/no-explicit-any`: Disallow `any` type (suggests `unknown` instead)
+- `@typescript-eslint/consistent-type-imports`: Enforce `import type` for type-only imports
+- `@typescript-eslint/no-unused-vars`: Disallow unused variables (except those prefixed with `_`)
+- `@typescript-eslint/naming-convention`: Enforce naming conventions (PascalCase for classes, camelCase for variables, etc.)
+
+**Import Rules:**
+
+- `no-restricted-imports`: **Disallow relative imports** - must use absolute imports with `@/` prefix
+- `import/no-default-export`: Disallow default exports (except in `*.config.{js,ts}` files)
+- `simple-import-sort/imports`: Auto-sort imports alphabetically
+- `simple-import-sort/exports`: Auto-sort exports alphabetically
+
+**Project-Specific:**
+
+- **Node.js**: Includes Node.js global variables (`process`, `__dirname`, etc.)
+- **Vue**: Includes Vue ESLint plugin rules, enforces PascalCase for component names in templates
+- **Nuxt**: Includes Vue rules + auto-import globals for Nuxt composables (`useRouter`, `useFetch`, etc.), allows single-word component names for pages
+
+**Import Resolution:**
+All configurations automatically resolve TypeScript path aliases (like `@/*`) using `eslint-import-resolver-typescript`.
+
 ### Prettier
 
 To import the Prettier configuration into your project, add the following code to your [Prettier](https://prettier.io/docs/en/configuration.html) configuration file:
@@ -74,11 +177,17 @@ To import the TypeScript configuration into your project, add the following code
 {
   "extends": "@vfourny/node-toolkit/tsconfig",
   "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
     // Your custom configurations
   }
 }
 ```
 
+**Important:** The `paths` configuration is required for the ESLint import resolver to work correctly with absolute imports using the `@/` prefix.
+
 ### Semantic Release
 
 To import the Semantic Release configuration into your project, add the following code to your [Semantic Release](https://semantic-release.gitbook.io/semantic-release) configuration file:

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

@@ -0,0 +1,24 @@
+import type { Linter } from 'eslint';
+/**
+ * Base ESLint configuration with TypeScript, import rules, and formatting
+ * This config is meant to be extended by specific project type configurations
+ */
+export declare const baseConfig: Linter.Config;
+/**
+ * Common ignores for all project types
+ */
+export declare const commonIgnores: Linter.Config;
+/**
+ * Allow default exports and relative imports in config files
+ */
+export declare const configFilesOverride: Linter.Config;
+/**
+ * Recommended TypeScript ESLint configs
+ */
+export declare const typescriptConfigs: Linter.Config[];
+/**
+ * Prettier config (should be last in the config array)
+ */
+export declare const prettierConfig: {
+    rules: Record<string, 0 | "off">;
+};

package/dist/{eslint.config.js → configs/eslint/base.js}

@@ -2,48 +2,26 @@ import eslintJS from '@eslint/js';
 import eslintConfigPrettier from 'eslint-config-prettier';
 import importPlugin from 'eslint-plugin-import';
 import simpleImportSort from 'eslint-plugin-simple-import-sort';
-import eslintPluginVue from 'eslint-plugin-vue';
-import globals from 'globals';
-import tsEslint from 'typescript-eslint';
 import typescriptEslint from 'typescript-eslint';
-const vueFilesConfig = {
-    name: 'eslint-config-node-tools/vue',
-    extends: [...eslintPluginVue.configs['flat/recommended']],
-    files: ['**/*.{ts,vue}'],
-    languageOptions: {
-        ecmaVersion: 'latest',
-        sourceType: 'module',
-        globals: globals.browser,
-        parserOptions: {
-            parser: typescriptEslint.parser,
-        },
-    },
-    rules: {
-        'vue/component-name-in-template-casing': [
-            'error',
-            'PascalCase',
-            {
-                registeredComponentsOnly: false,
-            },
-        ],
-    },
-};
-const defaultConfig = {
-    name: 'eslint-config-node-tools/default',
-    languageOptions: {
-        globals: {
-            ...globals.node,
-        },
-    },
-    rules: {},
-};
-const customConfig = {
-    name: 'eslint-config-node-tools/custom-config',
+/**
+ * Base ESLint configuration with TypeScript, import rules, and formatting
+ * This config is meant to be extended by specific project type configurations
+ */
+export const baseConfig = {
+    name: 'node-toolkit/base',
     plugins: {
         import: importPlugin,
         'simple-import-sort': simpleImportSort,
     },
+    settings: {
+        'import/resolver': {
+            typescript: {
+                alwaysTryTypes: true,
+            },
+        },
+    },
     rules: {
+        // General JavaScript/TypeScript rules
         eqeqeq: ['error', 'always'],
         'prefer-const': ['error', { destructuring: 'all' }],
         'no-useless-rename': 'error',
@@ -55,6 +33,7 @@ const customConfig = {
         'no-var': 'error',
         'no-redeclare': 'error',
         'no-const-assign': 'error',
+        // Enforce absolute imports with @/ prefix
         'no-restricted-imports': [
             'error',
             {
@@ -66,7 +45,9 @@ const customConfig = {
                 ],
             },
         ],
+        // Disable default sort-imports in favor of simple-import-sort
         'sort-imports': 'off',
+        // TypeScript-specific rules
         '@typescript-eslint/consistent-type-definitions': ['error', 'interface'],
         '@typescript-eslint/no-explicit-any': ['error', { fixToUnknown: true }],
         '@typescript-eslint/consistent-type-imports': [
@@ -91,7 +72,7 @@ const customConfig = {
             {
                 selector: 'variable',
                 modifiers: ['const'],
-                format: ['camelCase', 'UPPER_CASE'],
+                format: ['camelCase', 'UPPER_CASE', 'PascalCase'],
             },
             {
                 selector: 'typeParameter',
@@ -108,17 +89,42 @@ const customConfig = {
             },
         ],
         '@typescript-eslint/no-unsafe-declaration-merging': 'error',
+        // Import plugin rules
         'import/no-default-export': 'error',
         'import/no-named-as-default': 'error',
         'import/no-named-as-default-member': 'error',
         'import/no-namespace': 'error',
+        // Import sorting
         'simple-import-sort/imports': 'error',
         'simple-import-sort/exports': 'error',
     },
 };
-export default tsEslint.config(eslintJS.configs.recommended, tsEslint.configs.recommended, tsEslint.configs.strict, tsEslint.configs.stylistic, vueFilesConfig, defaultConfig, customConfig, eslintConfigPrettier, {
-    files: ['*.config.{js,ts}'],
-    rules: { 'import/no-default-export': 'off' },
-}, {
-    ignores: ['node_modules', 'dist', '.nuxt', 'coverage', '.output'],
-});
+/**
+ * Common ignores for all project types
+ */
+export const commonIgnores = {
+    ignores: ['node_modules', 'dist', '.nuxt', 'coverage', '.output', 'build'],
+};
+/**
+ * Allow default exports and relative imports in config files
+ */
+export const configFilesOverride = {
+    files: ['**/*.config.{js,ts}'],
+    rules: {
+        'import/no-default-export': 'off',
+        'no-restricted-imports': 'off',
+    },
+};
+/**
+ * Recommended TypeScript ESLint configs
+ */
+export const typescriptConfigs = [
+    eslintJS.configs.recommended,
+    ...typescriptEslint.configs.recommended,
+    ...typescriptEslint.configs.strict,
+    ...typescriptEslint.configs.stylistic,
+];
+/**
+ * Prettier config (should be last in the config array)
+ */
+export const prettierConfig = eslintConfigPrettier;

package/dist/configs/eslint/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ESLint configurations for different project types
+ * @packageDocumentation
+ */
+export * from './base';
+export { default as nodeConfig } from './node';
+export { default as nuxtConfig } from './nuxt';
+export { default as vueConfig } from './vue';
+export { default } from './node';

package/dist/configs/eslint/index.js

@@ -0,0 +1,12 @@
+/**
+ * ESLint configurations for different project types
+ * @packageDocumentation
+ */
+// Export base configuration components for advanced usage
+export * from './base';
+// Export pre-configured setups for different project types
+export { default as nodeConfig } from './node';
+export { default as nuxtConfig } from './nuxt';
+export { default as vueConfig } from './vue';
+// Default export is the Node.js config (most common use case)
+export { default } from './node';

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

@@ -0,0 +1,19 @@
+import type { Linter } from 'eslint';
+/**
+ * Node.js-specific configuration with Node.js globals
+ * Exported for reuse in other configs (Vue, Nuxt, etc.)
+ */
+export declare const nodeGlobalsConfig: Linter.Config;
+/**
+ * Complete ESLint configuration for Node.js projects
+ *
+ * @example
+ * ```typescript
+ * // eslint.config.ts
+ * import nodeConfig from '@vfourny/node-toolkit/eslint/node'
+ *
+ * export default nodeConfig
+ * ```
+ */
+declare const _default: import("typescript-eslint").FlatConfig.ConfigArray;
+export default _default;

package/dist/configs/eslint/node.js

@@ -0,0 +1,27 @@
+import globals from 'globals';
+import typescriptEslint from 'typescript-eslint';
+import { baseConfig, commonIgnores, configFilesOverride, prettierConfig, typescriptConfigs, } from './base';
+/**
+ * Node.js-specific configuration with Node.js globals
+ * Exported for reuse in other configs (Vue, Nuxt, etc.)
+ */
+export const nodeGlobalsConfig = {
+    name: 'node-toolkit/node-globals',
+    languageOptions: {
+        globals: {
+            ...globals.node,
+        },
+    },
+};
+/**
+ * Complete ESLint configuration for Node.js projects
+ *
+ * @example
+ * ```typescript
+ * // eslint.config.ts
+ * import nodeConfig from '@vfourny/node-toolkit/eslint/node'
+ *
+ * export default nodeConfig
+ * ```
+ */
+export default typescriptEslint.config(...typescriptConfigs, nodeGlobalsConfig, baseConfig, prettierConfig, configFilesOverride, commonIgnores);

package/dist/configs/eslint/nuxt.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Complete ESLint configuration for Nuxt projects
+ *
+ * This configuration includes globals for Nuxt's auto-imports (composables, components, etc.)
+ *
+ * @example
+ * ```typescript
+ * // eslint.config.ts
+ * import nuxtConfig from '@vfourny/node-toolkit/eslint/nuxt'
+ *
+ * export default nuxtConfig
+ * ```
+ *
+ * @remarks
+ * For optimal type safety with Nuxt auto-imports, ensure your project:
+ * 1. Has a `.nuxt` directory generated (run `nuxt prepare` or `nuxt dev` once)
+ * 2. Includes `.nuxt/tsconfig.json` in your project's tsconfig extends
+ *
+ * The auto-imported globals defined here cover the most common Nuxt composables,
+ * but you may need to add project-specific auto-imports to your local ESLint config.
+ */
+declare const _default: import("typescript-eslint").FlatConfig.ConfigArray;
+export default _default;

package/dist/configs/eslint/nuxt.js

@@ -0,0 +1,105 @@
+import typescriptEslint from 'typescript-eslint';
+import { baseConfig, commonIgnores, configFilesOverride, prettierConfig, typescriptConfigs, } from './base';
+import { nodeGlobalsConfig } from './node';
+import { vueFilesConfig } from './vue';
+/**
+ * Nuxt-specific globals for auto-imports
+ * These are commonly auto-imported by Nuxt and should not trigger no-undef errors
+ */
+const nuxtGlobals = {
+    name: 'node-toolkit/nuxt-globals',
+    languageOptions: {
+        globals: {
+            // Vue auto-imports
+            ref: 'readonly',
+            computed: 'readonly',
+            reactive: 'readonly',
+            readonly: 'readonly',
+            watch: 'readonly',
+            watchEffect: 'readonly',
+            toRef: 'readonly',
+            toRefs: 'readonly',
+            isRef: 'readonly',
+            unref: 'readonly',
+            shallowRef: 'readonly',
+            shallowReactive: 'readonly',
+            onMounted: 'readonly',
+            onBeforeMount: 'readonly',
+            onBeforeUnmount: 'readonly',
+            onUnmounted: 'readonly',
+            onUpdated: 'readonly',
+            onBeforeUpdate: 'readonly',
+            nextTick: 'readonly',
+            provide: 'readonly',
+            inject: 'readonly',
+            // Nuxt auto-imports
+            useRouter: 'readonly',
+            useRoute: 'readonly',
+            useFetch: 'readonly',
+            useAsyncData: 'readonly',
+            useLazyFetch: 'readonly',
+            useLazyAsyncData: 'readonly',
+            useState: 'readonly',
+            useCookie: 'readonly',
+            useRequestHeaders: 'readonly',
+            useRequestEvent: 'readonly',
+            useRuntimeConfig: 'readonly',
+            useAppConfig: 'readonly',
+            useHead: 'readonly',
+            useSeoMeta: 'readonly',
+            useNuxtApp: 'readonly',
+            useError: 'readonly',
+            navigateTo: 'readonly',
+            abortNavigation: 'readonly',
+            definePageMeta: 'readonly',
+            defineNuxtComponent: 'readonly',
+            defineNuxtPlugin: 'readonly',
+            defineNuxtRouteMiddleware: 'readonly',
+            createError: 'readonly',
+            showError: 'readonly',
+            clearError: 'readonly',
+            reloadNuxtApp: 'readonly',
+            refreshNuxtData: 'readonly',
+            callOnce: 'readonly',
+            prefetchComponents: 'readonly',
+            preloadComponents: 'readonly',
+            preloadRouteComponents: 'readonly',
+            addRouteMiddleware: 'readonly',
+            // Process (Nuxt provides this)
+            $fetch: 'readonly',
+        },
+    },
+};
+/**
+ * Nuxt-specific override for Vue files
+ * Disables multi-word component names rule (pages/index.vue is common in Nuxt)
+ */
+const nuxtVueOverride = {
+    name: 'node-toolkit/nuxt-vue-override',
+    files: ['**/*.vue'],
+    rules: {
+        'vue/multi-word-component-names': 'off',
+    },
+};
+/**
+ * Complete ESLint configuration for Nuxt projects
+ *
+ * This configuration includes globals for Nuxt's auto-imports (composables, components, etc.)
+ *
+ * @example
+ * ```typescript
+ * // eslint.config.ts
+ * import nuxtConfig from '@vfourny/node-toolkit/eslint/nuxt'
+ *
+ * export default nuxtConfig
+ * ```
+ *
+ * @remarks
+ * For optimal type safety with Nuxt auto-imports, ensure your project:
+ * 1. Has a `.nuxt` directory generated (run `nuxt prepare` or `nuxt dev` once)
+ * 2. Includes `.nuxt/tsconfig.json` in your project's tsconfig extends
+ *
+ * The auto-imported globals defined here cover the most common Nuxt composables,
+ * but you may need to add project-specific auto-imports to your local ESLint config.
+ */
+export default typescriptEslint.config(...typescriptConfigs, nodeGlobalsConfig, nuxtGlobals, baseConfig, vueFilesConfig, nuxtVueOverride, prettierConfig, configFilesOverride, commonIgnores);

package/dist/configs/eslint/vue.d.ts

@@ -0,0 +1,20 @@
+import { type ConfigWithExtends } from 'typescript-eslint';
+/**
+ * Vue-specific configuration
+ * Uses ConfigWithExtends to support the 'extends' property for Vue's recommended rules
+ * Exported for reuse in other configs (Nuxt, etc.)
+ */
+export declare const vueFilesConfig: ConfigWithExtends;
+/**
+ * Complete ESLint configuration for Vue projects
+ *
+ * @example
+ * ```typescript
+ * // eslint.config.ts
+ * import vueConfig from '@vfourny/node-toolkit/eslint/vue'
+ *
+ * export default vueConfig
+ * ```
+ */
+declare const _default: import("typescript-eslint").FlatConfig.ConfigArray;
+export default _default;

package/dist/configs/eslint/vue.js

@@ -0,0 +1,44 @@
+import eslintPluginVue from 'eslint-plugin-vue';
+import globals from 'globals';
+import typescriptEslint from 'typescript-eslint';
+import { baseConfig, commonIgnores, configFilesOverride, prettierConfig, typescriptConfigs, } from './base';
+import { nodeGlobalsConfig } from './node';
+/**
+ * Vue-specific configuration
+ * Uses ConfigWithExtends to support the 'extends' property for Vue's recommended rules
+ * Exported for reuse in other configs (Nuxt, etc.)
+ */
+export const vueFilesConfig = {
+    name: 'node-toolkit/vue',
+    extends: [...eslintPluginVue.configs['flat/recommended']],
+    files: ['**/*.vue'],
+    languageOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        globals: globals.browser,
+        parserOptions: {
+            parser: typescriptEslint.parser,
+        },
+    },
+    rules: {
+        'vue/component-name-in-template-casing': [
+            'error',
+            'PascalCase',
+            {
+                registeredComponentsOnly: false,
+            },
+        ],
+    },
+};
+/**
+ * Complete ESLint configuration for Vue projects
+ *
+ * @example
+ * ```typescript
+ * // eslint.config.ts
+ * import vueConfig from '@vfourny/node-toolkit/eslint/vue'
+ *
+ * export default vueConfig
+ * ```
+ */
+export default typescriptEslint.config(...typescriptConfigs, nodeGlobalsConfig, baseConfig, vueFilesConfig, prettierConfig, configFilesOverride, commonIgnores);

package/dist/configs/prettier.config.d.ts

@@ -0,0 +1,30 @@
+import type { Config } from 'prettier';
+/**
+ * Base Prettier configuration
+ *
+ * Opinionated formatting rules for consistent code style:
+ * - Single quotes
+ * - No semicolons
+ * - Trailing commas
+ * - 80 character line width
+ * - LF line endings
+ *
+ * @example
+ * ```javascript
+ * // prettier.config.js
+ * export { default } from '@vfourny/node-toolkit/prettier'
+ * ```
+ *
+ * Or with customization:
+ * ```javascript
+ * // prettier.config.js
+ * import baseConfig from '@vfourny/node-toolkit/prettier'
+ *
+ * export default {
+ *   ...baseConfig,
+ *   printWidth: 100,
+ * }
+ * ```
+ */
+declare const config: Config;
+export default config;

package/dist/configs/prettier.config.js

@@ -0,0 +1,39 @@
+/**
+ * Base Prettier configuration
+ *
+ * Opinionated formatting rules for consistent code style:
+ * - Single quotes
+ * - No semicolons
+ * - Trailing commas
+ * - 80 character line width
+ * - LF line endings
+ *
+ * @example
+ * ```javascript
+ * // prettier.config.js
+ * export { default } from '@vfourny/node-toolkit/prettier'
+ * ```
+ *
+ * Or with customization:
+ * ```javascript
+ * // prettier.config.js
+ * import baseConfig from '@vfourny/node-toolkit/prettier'
+ *
+ * export default {
+ *   ...baseConfig,
+ *   printWidth: 100,
+ * }
+ * ```
+ */
+const config = {
+    singleQuote: true,
+    trailingComma: 'all',
+    semi: false,
+    printWidth: 80,
+    tabWidth: 2,
+    bracketSpacing: true,
+    bracketSameLine: false,
+    arrowParens: 'always',
+    endOfLine: 'lf',
+};
+export default config;

package/dist/configs/tsconfig/base.json

@@ -0,0 +1,34 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "compilerOptions": {
+        /* Language and Environment */
+        "target": "ES2020",
+        /* Modules */
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "resolveJsonModule": true,
+        /* JavaScript Support */
+        "allowJs": true,
+        "checkJs": false,
+        /* Interop Constraints */
+        "esModuleInterop": true,
+        "forceConsistentCasingInFileNames": true,
+        /* Type Checking - Strict mode */
+        "strict": true,
+        "noImplicitAny": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "strictBindCallApply": true,
+        "strictPropertyInitialization": true,
+        "noImplicitThis": true,
+        "useUnknownInCatchVariables": true,
+        "alwaysStrict": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noImplicitReturns": true,
+        "noFallthroughCasesInSwitch": true,
+        "noUncheckedSideEffectImports": true,
+        /* Completeness */
+        "skipLibCheck": true
+    }
+}

package/dist/configs/tsconfig/node.json

@@ -0,0 +1,26 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": "./base.json",
+    "exclude": [
+        "${configDir}/node_modules",
+        "${configDir}/dist",
+        "${configDir}/.nuxt",
+        "${configDir}/.output"
+    ],
+    "include": ["${configDir}/src/**/*"],
+    "compilerOptions": {
+        /* Build Configuration */
+        "tsBuildInfoFile": "${configDir}/.cache/.tsbuildinfo",
+        /* Modules */
+        "rootDir": "${configDir}/src",
+        "baseUrl": "${configDir}",
+        "paths": {
+            "@/*": ["${configDir}/src/*"]
+        },
+        /* Emit */
+        "declaration": true,
+        "outDir": "${configDir}/dist",
+        "removeComments": true,
+        "noEmitOnError": true
+    }
+}

package/dist/configs/tsconfig/nuxt.json

@@ -0,0 +1,12 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": "./base.json",
+    "compilerOptions": {
+        /* Language and Environment */
+        "jsx": "preserve",
+        "lib": ["ES2020", "DOM", "DOM.Iterable"],
+        /* Interop Constraints */
+        "isolatedModules": true,
+        "verbatimModuleSyntax": true
+    }
+}

package/dist/configs/tsconfig/test.json

@@ -0,0 +1,17 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": "./base.json",
+    "compilerOptions": {
+        /* Types */
+        "types": ["vitest/globals"],
+        /* Modules */
+        "baseUrl": "${configDir}",
+        "paths": {
+            "@/*": ["${configDir}/src/*"]
+        },
+        /* Emit */
+        "noEmit": true
+    },
+    "include": ["${configDir}/tests/**/*"],
+    "exclude": ["${configDir}/node_modules", "${configDir}/dist"]
+}

package/dist/configs/tsconfig/vue.json

@@ -0,0 +1,29 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": "./base.json",
+    "exclude": [
+        "${configDir}/node_modules",
+        "${configDir}/dist",
+        "${configDir}/coverage",
+        "${configDir}/build"
+    ],
+    "include": ["${configDir}/src/**/*", "${configDir}/src/**/*.vue"],
+    "compilerOptions": {
+        /* Language and Environment */
+        "jsx": "preserve",
+        "lib": ["ES2020", "DOM", "DOM.Iterable"],
+        /* Modules */
+        "rootDir": "${configDir}/src",
+        "baseUrl": "${configDir}",
+        "paths": {
+            "@/*": ["${configDir}/src/*"]
+        },
+        /* Emit */
+        "declaration": true,
+        "outDir": "${configDir}/dist",
+        "removeComments": true,
+        "noEmitOnError": true,
+        /* Interop Constraints */
+        "isolatedModules": true
+    }
+}

package/dist/configs/vitest.config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Base Vitest configuration for Node.js projects
+ *
+ * This configuration provides sensible defaults for testing Node.js applications:
+ * - Node environment
+ * - Global test APIs (describe, it, expect, etc.)
+ * - Coverage with V8 provider
+ * - Text, JSON, and HTML coverage reports
+ *
+ * @example
+ * ```typescript
+ * // vitest.config.ts
+ * import { defineConfig, mergeConfig } from 'vitest/config'
+ * import baseConfig from '@vfourny/node-toolkit/vitest'
+ *
+ * export default mergeConfig(
+ *   baseConfig,
+ *   defineConfig({
+ *     test: {
+ *       include: ['tests/**\/*.test.ts'],
+ *     },
+ *   })
+ * )
+ * ```
+ */
+declare const config: {
+    test: {
+        reporters: string[];
+        globals: boolean;
+        environment: string;
+        coverage: {
+            provider: string;
+            reporter: string[];
+            clean: boolean;
+        };
+    };
+};
+export default config;

package/dist/configs/vitest.config.js

@@ -0,0 +1,38 @@
+/**
+ * Base Vitest configuration for Node.js projects
+ *
+ * This configuration provides sensible defaults for testing Node.js applications:
+ * - Node environment
+ * - Global test APIs (describe, it, expect, etc.)
+ * - Coverage with V8 provider
+ * - Text, JSON, and HTML coverage reports
+ *
+ * @example
+ * ```typescript
+ * // vitest.config.ts
+ * import { defineConfig, mergeConfig } from 'vitest/config'
+ * import baseConfig from '@vfourny/node-toolkit/vitest'
+ *
+ * export default mergeConfig(
+ *   baseConfig,
+ *   defineConfig({
+ *     test: {
+ *       include: ['tests/**\/*.test.ts'],
+ *     },
+ *   })
+ * )
+ * ```
+ */
+const config = {
+    test: {
+        reporters: ['default'],
+        globals: true,
+        environment: 'node',
+        coverage: {
+            provider: 'v8',
+            reporter: ['text', 'json', 'html'],
+            clean: true,
+        },
+    },
+};
+export default config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfourny/node-toolkit",
-  "version": "1.0.22",
+  "version": "1.1.1",
   "description": "Toolkit for Node.js projects",
   "type": "module",
   "main": "dist/libs/index.js",
@@ -12,31 +12,59 @@
     "lint:fix": "eslint --fix .",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "type-check": "tsc --noEmit",
+    "ts:check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
     "prepare": "husky"
   },
   "files": [
-    "tsconfig.base.json",
     "dist"
   ],
   "exports": {
     "./eslint": {
-      "types": "./dist/eslint.config.d.ts",
-      "default": "./dist/eslint.config.js"
+      "types": "./dist/configs/eslint/index.d.ts",
+      "default": "./dist/configs/eslint/index.js"
+    },
+    "./eslint/base": {
+      "types": "./dist/configs/eslint/base.d.ts",
+      "default": "./dist/configs/eslint/base.js"
+    },
+    "./eslint/node": {
+      "types": "./dist/configs/eslint/node.d.ts",
+      "default": "./dist/configs/eslint/node.js"
+    },
+    "./eslint/vue": {
+      "types": "./dist/configs/eslint/vue.d.ts",
+      "default": "./dist/configs/eslint/vue.js"
+    },
+    "./eslint/nuxt": {
+      "types": "./dist/configs/eslint/nuxt.d.ts",
+      "default": "./dist/configs/eslint/nuxt.js"
     },
     "./prettier": {
-      "types": "./dist/prettier.config.d.ts",
-      "default": "./dist/prettier.config.js"
+      "types": "./dist/configs/prettier.config.d.ts",
+      "default": "./dist/configs/prettier.config.js"
     },
     "./commitlint": {
-      "types": "./dist/commitlint.config.d.ts",
-      "default": "./dist/commitlint.config.js"
+      "types": "./dist/configs/commitlint.config.d.ts",
+      "default": "./dist/configs/commitlint.config.js"
     },
     "./release": {
-      "types": "./dist/release.config.d.ts",
-      "default": "./dist/release.config.js"
+      "types": "./dist/configs/release.config.d.ts",
+      "default": "./dist/configs/release.config.js"
     },
-    "./tsconfig": "./tsconfig.base.json"
+    "./tsconfig": "./dist/configs/tsconfig/node.json",
+    "./tsconfig/base": "./dist/configs/tsconfig/base.json",
+    "./tsconfig/node": "./dist/configs/tsconfig/node.json",
+    "./tsconfig/vue": "./dist/configs/tsconfig/vue.json",
+    "./tsconfig/nuxt": "./dist/configs/tsconfig/nuxt.json",
+    "./tsconfig/test": "./dist/configs/tsconfig/test.json",
+    "./vitest": {
+      "types": "./dist/configs/vitest.config.d.ts",
+      "default": "./dist/configs/vitest.config.js"
+    }
   },
   "keywords": [
     "eslint",
@@ -50,34 +78,37 @@
   "author": "Valentin Fourny",
   "license": "ISC",
   "dependencies": {
-    "@commitlint/config-angular": "^19.3.0",
+    "@commitlint/config-angular": "^20.2.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "eslint-config-prettier": "^10.0.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.0.0",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-vue": "^9.32.0",
-    "globals": "^15.3.0",
-    "typescript-eslint": "^8.0.0"
+    "eslint-plugin-vue": "^10.6.2",
+    "globals": "^16.5.0",
+    "typescript-eslint": "^8.50.0"
   },
   "devDependencies": {
-    "@commitlint/types": "^19.8.0",
-    "@eslint/js": "^9.4.0",
-    "@types/eslint__js": "^8.42.3",
+    "@commitlint/types": "^20.2.0",
+    "@eslint/js": "^9.39.2",
     "@types/eslint-config-prettier": "^6.11.3",
-    "@types/node": "^22.0.0",
-    "commitlint": "^19.8.0",
-    "eslint": "^9.3.0",
-    "husky": "^9.0.11",
-    "prettier": "^3.2.5",
-    "semantic-release": "^24.0.0",
-    "typescript": "^5.5.2"
+    "@types/node": "^25.0.3",
+    "@vitest/ui": "^4.0.16",
+    "commitlint": "^20.2.0",
+    "eslint": "^9.39.2",
+    "husky": "^9.1.7",
+    "prettier": "^3.7.4",
+    "semantic-release": "^25.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16",
+    "vue-eslint-parser": "^10.2.0"
   },
   "peerDependencies": {
-    "commitlint": "^19.8.0",
+    "commitlint": "^19.8.0 || ^20.1.0",
     "eslint": "^9.3.0",
     "prettier": "^3.2.5",
-    "semantic-release": "^24.0.0",
+    "semantic-release": "^24.0.0 || ^25.0.0",
     "typescript": "^5.5.2"
   },
   "repository": {
@@ -89,7 +120,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "engines": {
-    "node": ">=20.13 <23",
-    "npm": ">= 10"
+    "node": ">= 22.22.1",
+    "npm": ">= 10.9.4"
   }
 }

package/dist/eslint.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("@typescript-eslint/utils/ts-eslint").FlatConfig.ConfigArray;
-export default _default;

package/dist/prettier.config.d.ts

@@ -1,12 +0,0 @@
-declare namespace _default {
-    let singleQuote: boolean;
-    let trailingComma: string;
-    let semi: boolean;
-    let printWidth: number;
-    let tabWidth: number;
-    let bracketSpacing: boolean;
-    let bracketSameLine: boolean;
-    let arrowParens: string;
-    let endOfLine: string;
-}
-export default _default;

package/dist/prettier.config.js

@@ -1,11 +0,0 @@
-export default {
-    singleQuote: true,
-    trailingComma: 'all',
-    semi: false,
-    printWidth: 80,
-    tabWidth: 2,
-    bracketSpacing: true,
-    bracketSameLine: false,
-    arrowParens: 'always',
-    endOfLine: 'lf',
-};

package/dist/release.config.d.ts

@@ -1,12 +0,0 @@
-declare namespace _default {
-    let branches: string[];
-    let plugins: (string | (string | {
-        changelogFile: string;
-    })[] | (string | {
-        npmPublish: boolean;
-        pkgRoot: string;
-    })[] | (string | {
-        assets: string[];
-    })[])[];
-}
-export default _default;

package/dist/release.config.js

@@ -1,27 +0,0 @@
-export default {
-    branches: ['main'],
-    plugins: [
-        '@semantic-release/commit-analyzer',
-        '@semantic-release/release-notes-generator',
-        [
-            '@semantic-release/changelog',
-            {
-                changelogFile: 'docs/CHANGELOG.md',
-            },
-        ],
-        '@semantic-release/github',
-        [
-            '@semantic-release/npm',
-            {
-                npmPublish: process.env.PUBLISH === 'true',
-                pkgRoot: '.',
-            },
-        ],
-        [
-            '@semantic-release/git',
-            {
-                assets: ['docs/CHANGELOG.md', 'package.json', 'package-lock.json'],
-            },
-        ],
-    ],
-};

package/tsconfig.base.json

@@ -1,120 +0,0 @@
-{
-  "exclude": [
-    "${configDir}/node_modules",
-    "${configDir}/dist",
-    "${configDir}/.nuxt",
-    "${configDir}/.output"
-  ],
-  "include": ["${configDir}/src/**/*"],
-  "compilerOptions": {
-    /* Visit https://aka.ms/tsconfig to read more about this file */
-
-    /* Projects */
-    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
-    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
-    "tsBuildInfoFile": "${configDir}/.cache/.tsbuildinfo" /* Specify the path to .tsbuildinfo incremental compilation file. */,
-    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
-    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
-    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
-
-    /* Language and Environment */
-    "target": "ES2020" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
-    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
-    // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
-    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
-    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
-    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
-    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
-    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
-    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
-    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
-    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
-
-    /* Modules */
-    "module": "ESNext" /* Specify what module code is generated. */,
-    "rootDir": "${configDir}/src" /* Specify the root folder within your source files. */,
-    "moduleResolution": "bundler" /* Specify how TypeScript looks up a file from a given module specifier. */,
-    "baseUrl": "${configDir}" /* Specify the base directory to resolve non-relative module names. */,
-    "paths": {
-      "@/*": ["${configDir}/src/*"]
-    } /* Specify a set of entries that re-map imports to additional lookup locations. */,
-    // "rootDirs": []                                    /* Allow multiple folders to be treated as one when resolving modules. */,
-    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
-    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
-    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
-    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
-    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
-    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
-    // "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
-    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
-    "resolveJsonModule": true /* Enable importing .json files. */,
-    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
-    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
-
-    /* JavaScript Support */
-    "allowJs": true /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */,
-    "checkJs": true /* Enable error reporting in type-checked JavaScript files. */,
-    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
-
-    /* Emit */
-    "declaration": true /* Generate .d.ts files from TypeScript and JavaScript files in your project. */,
-    //    "declarationMap": true /* Create sourcemaps for d.ts files. */,
-    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
-    //    "sourceMap": true /* Create source map files for emitted JavaScript files. */,
-    //    "inlineSourceMap": true /* Include sourcemap files inside the emitted JavaScript. */,
-    // "outFile": "./" /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */,
-    "outDir": "${configDir}/dist" /* Specify an output folder for all emitted files. */,
-    "removeComments": true /* Disable emitting comments. */,
-    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
-    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
-    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
-    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
-    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
-    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
-    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
-    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
-    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
-    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
-    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
-    "noEmitOnError": true /* Disable emitting files if any type checking errors are reported. */,
-    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
-    // "declarationDir": "./dist/types" /* Specify the output directory for generated declaration files. */,
-    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
-
-    /* Interop Constraints */
-    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
-    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
-    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
-    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
-    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
-    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
-
-    /* Type Checking */
-    "strict": true /* Enable all strict type-checking options. */,
-    "noImplicitAny": true /* Enable error reporting for expressions and declarations with an implied 'any' type. */,
-    "strictNullChecks": true /* When type checking, take into account 'null' and 'undefined'. */,
-    "strictFunctionTypes": true /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */,
-    "strictBindCallApply": true /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */,
-    "strictPropertyInitialization": true /* Check for class properties that are declared but not set in the constructor. */,
-    // "strictBuiltinIteratorReturn": false,             /* Ensure that the return type of generators and async functions are correctly constrained. */
-    "noImplicitThis": true /* Enable error reporting when 'this' is given the type 'any'. */,
-    "useUnknownInCatchVariables": true /* Default catch clause variables as 'unknown' instead of 'any'. */,
-    "alwaysStrict": true /* Ensure 'use strict' is always emitted. */,
-    "noUnusedLocals": true /* Enable error reporting when local variables aren't read. */,
-    "noUnusedParameters": true /* Raise an error when a function parameter isn't read. */,
-    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
-    "noImplicitReturns": true /* Enable error reporting for codepaths that do not explicitly return in a function. */,
-    "noFallthroughCasesInSwitch": true /* Enable error reporting for fallthrough cases in switch statements. */,
-    "noUncheckedSideEffectImports": true /* Enable error reporting for imports that may be converted to a 'require' call. */,
-    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
-    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
-    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
-    "allowUnusedLabels": true /* Disable error reporting for unused labels. */,
-    "allowUnreachableCode": true /* Disable error reporting for unreachable code. */,
-
-    /* Completeness */
-    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
-    "skipLibCheck": true /* Skip type checking all .d.ts files. */
-  }
-}