@gv-tech/eslint-config 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.1.7](https://github.com/Garcia-Ventures/eslint-config/compare/eslint-config-v0.1.6...eslint-config-v0.1.7) (2026-02-08)
+
+
+### Features
+
+* Add blackbox tests for various ESLint configurations and integrate them into CI/CD workflows. ([005ebc7](https://github.com/Garcia-Ventures/eslint-config/commit/005ebc74fc40a11c4fb6eba1b3e7326dbde29d2a))
+* Dynamically import the Next.js ESLint plugin to make it optional and consolidate Next.js configurations into the main package exports. ([01cb660](https://github.com/Garcia-Ventures/eslint-config/commit/01cb660e2307e56b373a8620972991f335e8a5fd))
+* Introduce unit tests for ESLint configurations and update package scripts and CI workflow to include them. ([da749c0](https://github.com/Garcia-Ventures/eslint-config/commit/da749c02489c70ce472e8c2e926e9941c4a74326))
+
+
+### Bug Fixes
+
+* Enhance ESLint configurations to robustly handle array-based recommended configs and remove a JSDoc example. ([4d0de8e](https://github.com/Garcia-Ventures/eslint-config/commit/4d0de8e66cd01698e999eb3bcf9f01714fefa17e))
+
 ## [0.1.6](https://github.com/Garcia-Ventures/eslint-config/compare/eslint-config-v0.1.5...eslint-config-v0.1.6) (2026-02-08)
 
 

package/README.md

@@ -69,8 +69,7 @@ export default [...typescript, ...prettier];
 ### Next.js Project
 
 ```js
-import { next } from '@gv-tech/eslint-config/next';
-import { prettier } from '@gv-tech/eslint-config/prettier';
+import { next, prettier } from '@gv-tech/eslint-config';
 
 export default [...next, ...prettier];
 ```
@@ -85,7 +84,7 @@ import { recommended } from '@gv-tech/eslint-config';
 export default [...recommended];
 
 // Next.js + TypeScript + Prettier
-import { nextjs } from '@gv-tech/eslint-config/next';
+import { nextjs } from '@gv-tech/eslint-config';
 export default [...nextjs];
 ```
 
@@ -115,14 +114,14 @@ export default [
 
 ## Available Configurations
 
-| Export        | Description                                 |
-| ------------- | ------------------------------------------- |
-| `base`        | Core JavaScript rules                       |
-| `typescript`  | TypeScript support (includes base)          |
-| `next`        | Next.js rules (requires `next` import)      |
-| `prettier`    | Prettier formatting integration             |
-| `recommended` | TypeScript + Prettier                       |
-| `nextjs`      | Next.js + Prettier (requires `next` import) |
+| Export        | Description                         |
+| ------------- | ----------------------------------- |
+| `base`        | Core JavaScript rules               |
+| `typescript`  | TypeScript support (includes base)  |
+| `next`        | Next.js rules (includes TypeScript) |
+| `prettier`    | Prettier formatting integration     |
+| `recommended` | TypeScript + Prettier               |
+| `nextjs`      | Next.js + Prettier                  |
 
 ## Exported Utilities
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gv-tech/eslint-config",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Shareable ESLint configuration for Garcia Ventures projects - ESLint v9 flat config",
   "keywords": [
     "eslint",
@@ -37,9 +37,12 @@
     "format": "prettier --write .",
     "format:ci": "prettier --check .",
     "lint": "eslint . --cache",
-    "lint:fix": "eslint . --cache --fix",
+    "lint:fix": "yarn lint --fix",
     "lint:report": "eslint . --cache -o ./eslintReport.html -f html",
-    "prepare": "husky"
+    "prepare": "husky",
+    "test": "yarn test:unit && node test/verify.mjs",
+    "test:unit": "node test/unit.test.mjs",
+    "validate": "yarn lint && yarn test && publint"
   },
   "lint-staged": {
     "*.(js|ts|mjs|cjs)?(x)": [

package/src/base.mjs

@@ -13,27 +13,22 @@ export const jsFiles = ['**/*.js', '**/*.jsx', '**/*.mjs', '**/*.cjs'];
 /** Common ignore patterns */
 export const commonIgnores = ['**/node_modules/**', '**/dist/**', '**/build/**', '**/coverage/**', '**/.git/**'];
 
-/**
- * Base ESLint configuration for JavaScript projects.
- *
- * @example
- *
- * ```js
- * // eslint.config.mjs
- * import { base } from '@gv-tech/eslint-config';
- *
- * export default [...base];
- * ```
- */
+// Helper to ensure we have an array of configs
+const ensureArray = (config) => (Array.isArray(config) ? config : [config]);
+
+/** Base ESLint configuration for JavaScript projects. */
 export const base = [
   // Global ignores
   {
     ignores: commonIgnores,
   },
-  // Base configuration for all JS files
+  // Base configuration for all JS files (properly handling array-based recommended configs)
+  ...ensureArray(js.configs.recommended).map((config) => ({
+    ...config,
+    files: jsFiles,
+  })),
   {
     files: jsFiles,
-    ...js.configs.recommended,
     languageOptions: {
       ecmaVersion: 'latest',
       sourceType: 'module',

package/src/index.mjs

@@ -2,36 +2,16 @@
  * @gv-tech/eslint-config
  *
  * Shareable ESLint configuration for Garcia Ventures projects. Supports ESLint v9+ flat config format.
- *
- * @example Basic JavaScript
- *
- * ```js
- * import { base } from '@gv-tech/eslint-config';
- * export default [...base];
- * ```
- *
- * @example TypeScript
- *
- * ```js
- * import { typescript, prettier } from '@gv-tech/eslint-config';
- * export default [...typescript, ...prettier];
- * ```
- *
- * @example Next.js
- *
- * ```js
- * import { next, prettier } from '@gv-tech/eslint-config';
- * export default [...next, ...prettier];
- * ```
  */
 
 // Import for creating combined presets
 import { base, commonIgnores, jsFiles } from './base.mjs';
+import { next, nextIgnores, nextjs } from './next.mjs';
 import { prettier } from './prettier.mjs';
 import { allJsTsFiles, tsFiles, typescript } from './typescript.mjs';
 
 // Re-export individual configurations
-export { allJsTsFiles, base, commonIgnores, jsFiles, prettier, tsFiles, typescript };
+export { allJsTsFiles, base, commonIgnores, jsFiles, next, nextIgnores, nextjs, prettier, tsFiles, typescript };
 
 /** Recommended configuration for TypeScript projects with Prettier. Combines TypeScript and Prettier configurations. */
 export const recommended = [...typescript, ...prettier];

package/src/next.mjs

@@ -4,46 +4,67 @@
  * Next.js 15+ ESLint configuration with Core Web Vitals. Uses ESLint v9 flat config format.
  */
 
-import nextPlugin from '@next/eslint-plugin-next';
 import { commonIgnores } from './base.mjs';
 import { prettier } from './prettier.mjs';
 import { allJsTsFiles, typescript } from './typescript.mjs';
 
+// Try to load the Next.js plugin dynamically to avoid crashing if it's not installed
+let nextPlugin;
+try {
+  // Allow forcing missing state for tests
+  if (process.env.ESLINT_CONFIG_FORCE_MISSING_NEXT === 'true') {
+    throw new Error('Forced missing state for testing');
+  }
+  const mod = await import('@next/eslint-plugin-next');
+  nextPlugin = mod.default;
+} catch {
+  if (process.env.ESLINT_CONFIG_FORCE_MISSING_NEXT !== 'true') {
+    console.warn("Next.js plugin not found. It's optional.");
+  }
+}
+
 /** Next.js specific ignore patterns */
 export const nextIgnores = [...commonIgnores, '.next/**', 'out/**', 'next-env.d.ts'];
 
-/**
- * Next.js ESLint configuration. Extends TypeScript configuration and adds Next.js-specific rules.
- *
- * @example
- *
- * ```js
- * // eslint.config.mjs
- * import { next } from '@gv-tech/eslint-config/next';
- *
- * export default [...next];
- * ```
- */
-export const next = [
-  // Global ignores including Next.js specific
-  {
-    ignores: nextIgnores,
-  },
-  // Extend TypeScript config
-  ...typescript.filter((config) => !config.ignores),
-  // Next.js plugin configuration
-  {
-    files: allJsTsFiles,
-    plugins: {
-      '@next/next': nextPlugin,
-    },
-    rules: {
-      // Core Web Vitals rules
-      ...nextPlugin.configs.recommended.rules,
-      ...nextPlugin.configs['core-web-vitals'].rules,
-    },
-  },
-];
+/** Next.js ESLint configuration. Extends TypeScript configuration and adds Next.js-specific rules. */
+export const next = nextPlugin
+  ? [
+      // Global ignores including Next.js specific
+      {
+        ignores: nextIgnores,
+      },
+      // Extend TypeScript config
+      ...typescript.filter((config) => !config.ignores),
+      // Next.js plugin configuration
+      {
+        files: allJsTsFiles,
+        plugins: {
+          '@next/next': nextPlugin,
+        },
+        rules: {
+          // Core Web Vitals rules
+          ...nextPlugin.configs.recommended.rules,
+          ...nextPlugin.configs['core-web-vitals'].rules,
+        },
+      },
+    ]
+  : [
+      {
+        // If the plugin is missing, we provide a placeholder that informs the user
+        // but doesn't crash the entire linting process unless this specific config is used.
+        files: allJsTsFiles,
+        rules: {
+          'no-restricted-syntax': [
+            'error',
+            {
+              selector: 'Program',
+              message:
+                "Next.js ESLint configuration was requested but '@next/eslint-plugin-next' is not installed. Please install it to enable Next.js rules.",
+            },
+          ],
+        },
+      },
+    ];
 
 /**
  * Recommended configuration for Next.js projects with Prettier. Combines Next.js (which includes TypeScript) and

package/src/prettier.mjs

@@ -24,7 +24,8 @@ import { allJsTsFiles } from './typescript.mjs';
  */
 export const prettier = [
   // Disable ESLint rules that conflict with Prettier
-  prettierConfig,
+  // Handle case where prettierConfig might be an array in future versions
+  ...(Array.isArray(prettierConfig) ? prettierConfig : [prettierConfig]),
   // Run Prettier as an ESLint rule with @eng618/prettier-config
   {
     files: allJsTsFiles,