eslint-plugin-import-next 2.3.9 → 2.3.11

package/src/index.js

@@ -1,12 +1,6 @@
 "use strict";
-/**
- * Copyright (c) 2025 Ofri Peretz
- * Licensed under the MIT License. Use of this source code is governed by the
- * MIT license that can be found in the LICENSE file.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.clearCircularDependencyCache = exports.configs = exports.plugin = exports.rules = void 0;
-// Module Resolution Rules
 const no_duplicates_1 = require("./rules/no-duplicates");
 const named_1 = require("./rules/named");
 const default_1 = require("./rules/default");
@@ -18,13 +12,11 @@ const no_absolute_path_1 = require("./rules/no-absolute-path");
 const no_dynamic_require_1 = require("./rules/no-dynamic-require");
 const no_relative_packages_1 = require("./rules/no-relative-packages");
 const no_useless_path_segments_1 = require("./rules/no-useless-path-segments");
-// Module System Rules
 const no_amd_1 = require("./rules/no-amd");
 const no_commonjs_1 = require("./rules/no-commonjs");
 const no_nodejs_modules_1 = require("./rules/no-nodejs-modules");
 const no_import_module_exports_1 = require("./rules/no-import-module-exports");
 const unambiguous_1 = require("./rules/unambiguous");
-// Dependency Boundaries Rules
 const no_cycle_1 = require("./rules/no-cycle");
 Object.defineProperty(exports, "clearCircularDependencyCache", { enumerable: true, get: function () { return no_cycle_1.clearCircularDependencyCache; } });
 const no_internal_modules_1 = require("./rules/no-internal-modules");
@@ -32,7 +24,6 @@ const no_cross_domain_imports_1 = require("./rules/no-cross-domain-imports");
 const enforce_dependency_direction_1 = require("./rules/enforce-dependency-direction");
 const no_restricted_paths_1 = require("./rules/no-restricted-paths");
 const no_relative_parent_imports_1 = require("./rules/no-relative-parent-imports");
-// Export Style Rules
 const export_1 = require("./rules/export");
 const no_default_export_1 = require("./rules/no-default-export");
 const no_named_export_1 = require("./rules/no-named-export");
@@ -42,7 +33,6 @@ const no_mutable_exports_1 = require("./rules/no-mutable-exports");
 const no_deprecated_1 = require("./rules/no-deprecated");
 const exports_last_1 = require("./rules/exports-last");
 const group_exports_1 = require("./rules/group-exports");
-// Import Style Rules
 const enforce_import_order_1 = require("./rules/enforce-import-order");
 const no_unassigned_import_1 = require("./rules/no-unassigned-import");
 const first_1 = require("./rules/first");
@@ -54,28 +44,20 @@ const no_named_default_1 = require("./rules/no-named-default");
 const no_namespace_1 = require("./rules/no-namespace");
 const consistent_type_specifier_style_1 = require("./rules/consistent-type-specifier-style");
 const dynamic_import_chunkname_1 = require("./rules/dynamic-import-chunkname");
-// Dependency Management Rules
 const no_extraneous_dependencies_1 = require("./rules/no-extraneous-dependencies");
 const no_unused_modules_1 = require("./rules/no-unused-modules");
 const max_dependencies_1 = require("./rules/max-dependencies");
 const prefer_node_protocol_1 = require("./rules/prefer-node-protocol");
-// Bundle Optimization Rules (Phase 2)
 const no_barrel_file_1 = require("./rules/no-barrel-file");
 const no_barrel_import_1 = require("./rules/no-barrel-import");
 const prefer_tree_shakeable_imports_1 = require("./rules/prefer-tree-shakeable-imports");
 const prefer_direct_import_1 = require("./rules/prefer-direct-import");
 const no_full_package_import_1 = require("./rules/no-full-package-import");
-// Enterprise Governance Rules (Phase 4)
 const enforce_team_boundaries_1 = require("./rules/enforce-team-boundaries");
 const no_legacy_imports_1 = require("./rules/no-legacy-imports");
 const require_import_approval_1 = require("./rules/require-import-approval");
 const prefer_modern_api_1 = require("./rules/prefer-modern-api");
-/**
- * Collection of all ESLint rules provided by this plugin
- * Full backwards compatibility with eslint-plugin-import
- */
 exports.rules = {
-    // Module Resolution Rules
     'no-duplicates': no_duplicates_1.noDuplicates,
     named: named_1.named,
     default: default_1.defaultRule,
@@ -87,20 +69,17 @@ exports.rules = {
     'no-dynamic-require': no_dynamic_require_1.noDynamicRequire,
     'no-relative-packages': no_relative_packages_1.noRelativePackages,
     'no-useless-path-segments': no_useless_path_segments_1.noUselessPathSegments,
-    // Module System Rules
     'no-amd': no_amd_1.noAmd,
     'no-commonjs': no_commonjs_1.noCommonjs,
     'no-nodejs-modules': no_nodejs_modules_1.noNodejsModules,
     'no-import-module-exports': no_import_module_exports_1.noImportModuleExports,
     unambiguous: unambiguous_1.unambiguous,
-    // Dependency Boundaries Rules
     'no-cycle': no_cycle_1.noCycle,
     'no-internal-modules': no_internal_modules_1.noInternalModules,
     'no-cross-domain-imports': no_cross_domain_imports_1.noCrossDomainImports,
     'enforce-dependency-direction': enforce_dependency_direction_1.enforceDependencyDirection,
     'no-restricted-paths': no_restricted_paths_1.noRestrictedPaths,
     'no-relative-parent-imports': no_relative_parent_imports_1.noRelativeParentImports,
-    // Export Style Rules
     export: export_1.exportRule,
     'no-default-export': no_default_export_1.noDefaultExport,
     'no-named-export': no_named_export_1.noNamedExport,
@@ -110,9 +89,8 @@ exports.rules = {
     'no-deprecated': no_deprecated_1.noDeprecated,
     'exports-last': exports_last_1.exportsLast,
     'group-exports': group_exports_1.groupExports,
-    // Import Style Rules
     'enforce-import-order': enforce_import_order_1.enforceImportOrder,
-    order: enforce_import_order_1.enforceImportOrder, // Alias for backwards compat with eslint-plugin-import
+    order: enforce_import_order_1.enforceImportOrder,
     'no-unassigned-import': no_unassigned_import_1.noUnassignedImport,
     first: first_1.first,
     'newline-after-import': newline_after_import_1.newlineAfterImport,
@@ -123,98 +101,62 @@ exports.rules = {
     'no-namespace': no_namespace_1.noNamespace,
     'consistent-type-specifier-style': consistent_type_specifier_style_1.consistentTypeSpecifierStyle,
     'dynamic-import-chunkname': dynamic_import_chunkname_1.dynamicImportChunkname,
-    // Dependency Management Rules
     'no-extraneous-dependencies': no_extraneous_dependencies_1.noExtraneousDependencies,
     'no-unused-modules': no_unused_modules_1.noUnusedModules,
     'max-dependencies': max_dependencies_1.maxDependencies,
     'prefer-node-protocol': prefer_node_protocol_1.preferNodeProtocol,
-    // Bundle Optimization Rules (Phase 2)
     'no-barrel-file': no_barrel_file_1.noBarrelFile,
     'no-barrel-import': no_barrel_import_1.noBarrelImport,
     'prefer-tree-shakeable-imports': prefer_tree_shakeable_imports_1.preferTreeShakeableImports,
     'prefer-direct-import': prefer_direct_import_1.preferDirectImport,
     'no-full-package-import': no_full_package_import_1.noFullPackageImport,
-    // Enterprise Governance Rules (Phase 4)
     'enforce-team-boundaries': enforce_team_boundaries_1.enforceTeamBoundaries,
     'no-legacy-imports': no_legacy_imports_1.noLegacyImports,
     'require-import-approval': require_import_approval_1.requireImportApproval,
     'prefer-modern-api': prefer_modern_api_1.preferModernApi,
 };
-/**
- * ESLint Plugin object following the official plugin structure
- */
 exports.plugin = {
     meta: {
         name: 'eslint-plugin-import-next',
-        version: '2.3.9',
+        version: '2.3.11',
     },
     rules: exports.rules,
 };
-/**
- * Preset configurations for common use cases
- */
 exports.configs = {
-    /**
-     * Flagship preset — exactly the rule from this plugin that appears in the
-     * ecosystem-wide flagship list (`.agent/flagship-rules.md`). Use this when
-     * you want the highest-signal subset shippable in CI gates without the
-     * noise of `recommended`.
-     */
     flagship: {
         plugins: { 'import-next': exports.plugin },
         rules: {
             'import-next/no-cycle': 'error',
         },
     },
-    /**
-     * Recommended configuration for most projects
-     *
-     * Includes essential rules with sensible defaults:
-     * - Errors on unresolved imports
-     * - Errors on circular dependencies
-     * - Warns on module system violations
-     * - Warns on import order issues
-     */
     recommended: {
         plugins: {
             'import-next': exports.plugin,
         },
         rules: {
-            // Module Resolution - Critical
             'import-next/no-unresolved': 'error',
             'import-next/named': 'error',
             'import-next/default': 'error',
             'import-next/namespace': 'warn',
             'import-next/no-duplicates': 'error',
             'import-next/export': 'error',
-            // Dependency Boundaries - Critical
             'import-next/no-cycle': 'error',
             'import-next/no-self-import': 'error',
-            // Helpful Warnings
             'import-next/no-named-as-default': 'warn',
             'import-next/no-named-as-default-member': 'warn',
-            // Module System - Recommended
             'import-next/no-amd': 'warn',
-            // Import Style - Recommended
             'import-next/order': 'warn',
             'import-next/first': 'warn',
             'import-next/newline-after-import': 'warn',
             'import-next/no-empty-named-blocks': 'warn',
-            // Dependency Management
             'import-next/no-extraneous-dependencies': 'warn',
         },
     },
-    /**
-     * Strict configuration for maximum enforcement
-     *
-     * All rules set to error for production-ready code
-     */
     strict: {
         plugins: {
             'import-next': exports.plugin,
         },
         rules: {
-            // Module Resolution
             'import-next/no-unresolved': 'error',
             'import-next/named': 'error',
             'import-next/default': 'error',
@@ -226,13 +168,11 @@ exports.configs = {
             'import-next/no-dynamic-require': 'error',
             'import-next/no-useless-path-segments': 'error',
             'import-next/export': 'error',
-            // Module System
             'import-next/no-amd': 'error',
             'import-next/no-commonjs': 'error',
             'import-next/no-nodejs-modules': 'error',
             'import-next/no-import-module-exports': 'error',
             'import-next/unambiguous': 'error',
-            // Dependency Boundaries
             'import-next/no-cycle': 'error',
             'import-next/no-internal-modules': 'error',
             'import-next/no-cross-domain-imports': 'error',
@@ -240,13 +180,11 @@ exports.configs = {
             'import-next/no-restricted-paths': 'error',
             'import-next/no-relative-parent-imports': 'error',
             'import-next/no-relative-packages': 'error',
-            // Export Style
             'import-next/no-anonymous-default-export': 'error',
             'import-next/no-mutable-exports': 'error',
             'import-next/no-deprecated': 'error',
             'import-next/exports-last': 'error',
             'import-next/group-exports': 'error',
-            // Import Style
             'import-next/order': 'error',
             'import-next/no-unassigned-import': 'error',
             'import-next/first': 'error',
@@ -257,25 +195,19 @@ exports.configs = {
             'import-next/no-named-default': 'error',
             'import-next/no-namespace': 'error',
             'import-next/consistent-type-specifier-style': 'error',
-            // Dependency Management
             'import-next/no-extraneous-dependencies': 'error',
             'import-next/no-unused-modules': 'error',
             'import-next/max-dependencies': 'error',
             'import-next/prefer-node-protocol': 'error',
         },
     },
-    /**
-     * TypeScript configuration
-     *
-     * Optimized for TypeScript projects
-     */
     typescript: {
         plugins: {
             'import-next': exports.plugin,
         },
         rules: {
             'import-next/no-unresolved': 'error',
-            'import-next/named': 'off', // TypeScript handles this
+            'import-next/named': 'off',
             'import-next/default': 'error',
             'import-next/namespace': 'error',
             'import-next/export': 'error',
@@ -287,11 +219,6 @@ exports.configs = {
             'import-next/consistent-type-specifier-style': ['warn', 'prefer-inline'],
         },
     },
-    /**
-     * Module resolution focused configuration
-     *
-     * Ensures all imports resolve correctly
-     */
     'module-resolution': {
         plugins: {
             'import-next': exports.plugin,
@@ -308,11 +235,6 @@ exports.configs = {
             'import-next/no-useless-path-segments': 'warn',
         },
     },
-    /**
-     * Import style focused configuration
-     *
-     * Enforces consistent import formatting
-     */
     'import-style': {
         plugins: {
             'import-next': exports.plugin,
@@ -327,11 +249,6 @@ exports.configs = {
             'import-next/no-namespace': 'warn',
         },
     },
-    /**
-     * ESM-only configuration
-     *
-     * Enforces ES Modules and prohibits CommonJS/AMD
-     */
     esm: {
         plugins: {
             'import-next': exports.plugin,
@@ -344,11 +261,6 @@ exports.configs = {
             'import-next/prefer-node-protocol': 'error',
         },
     },
-    /**
-     * Architecture boundaries configuration
-     *
-     * Enforces clean architecture and module boundaries
-     */
     architecture: {
         plugins: {
             'import-next': exports.plugin,
@@ -363,9 +275,6 @@ exports.configs = {
             'import-next/no-relative-packages': 'error',
         },
     },
-    /**
-     * Errors-only configuration (matches eslint-plugin-import)
-     */
     errors: {
         plugins: {
             'import-next': exports.plugin,
@@ -378,9 +287,6 @@ exports.configs = {
             'import-next/export': 'error',
         },
     },
-    /**
-     * Warnings-only configuration (matches eslint-plugin-import)
-     */
     warnings: {
         plugins: {
             'import-next': exports.plugin,
@@ -391,78 +297,30 @@ exports.configs = {
             'import-next/no-duplicates': 'warn',
         },
     },
-    /**
-     * Performance optimization configuration (Phase 2)
-     *
-     * Detects import patterns that harm build performance and tree-shaking:
-     * - Barrel files that bloat bundles
-     * - Imports from barrel files
-     * - Non-tree-shakeable import patterns (namespace imports)
-     *
-     * Real-world impact:
-     * - Atlassian reduced Jira build times by 75%
-     * - Bundle size reductions of 50-85%
-     *
-     * @see https://marvinh.dev/blog/speeding-up-javascript-ecosystem-part-7/
-     */
     performance: {
         plugins: {
             'import-next': exports.plugin,
         },
         rules: {
-            // Bundle Optimization - Critical
             'import-next/no-barrel-file': 'error',
             'import-next/no-barrel-import': 'warn',
             'import-next/prefer-tree-shakeable-imports': 'warn',
             'import-next/prefer-direct-import': 'warn',
             'import-next/no-full-package-import': 'warn',
-            // Dependency Boundaries - Impact on build graph
             'import-next/no-cycle': 'error',
         },
     },
-    /**
-     * Enterprise governance configuration (Phase 4)
-     *
-     * Rules designed for large organizations (1000+ developers):
-     * - Team boundaries to prevent unauthorized cross-team imports
-     * - Legacy import detection for migration tracking
-     *
-     * Note: These rules require configuration. See documentation for examples.
-     *
-     * @example
-     * // eslint.config.js
-     * {
-     *   plugins: { 'import-next': importNext },
-     *   rules: {
-     *     'import-next/enforce-team-boundaries': ['error', {
-     *       teams: [
-     *         { team: 'platform', paths: ['src/platform/**'], allowedDependencies: ['shared'] },
-     *         { team: 'payments', paths: ['src/payments/**'], allowedDependencies: ['platform', 'shared'] },
-     *       ],
-     *     }],
-     *     'import-next/no-legacy-imports': ['warn', {
-     *       mappings: [
-     *         { deprecated: 'moment', replacement: 'date-fns', reason: 'moment is in maintenance mode' },
-     *       ],
-     *     }],
-     *   },
-     * }
-     */
     enterprise: {
         plugins: {
             'import-next': exports.plugin,
         },
         rules: {
-            // Team boundaries - requires configuration
-            'import-next/enforce-team-boundaries': 'off', // Disabled by default - requires teams config
-            // Legacy import tracking - requires configuration
-            'import-next/no-legacy-imports': 'off', // Disabled by default - requires mappings config
-            // Architecture boundaries
+            'import-next/enforce-team-boundaries': 'off',
+            'import-next/no-legacy-imports': 'off',
             'import-next/no-cross-domain-imports': 'warn',
             'import-next/enforce-dependency-direction': 'warn',
             'import-next/no-internal-modules': 'warn',
         },
     },
 };
-// Default export for ESLint flat config
 exports.default = exports.plugin;

package/src/oxlint.d.ts

@@ -1,20 +1,17 @@
-/**
- * Copyright (c) 2025 Ofri Peretz
- * Licensed under the MIT License. Use of this source code is governed by the
- * MIT license that can be found in the LICENSE file.
- */
-/**
- * oxlint sub-export.
- *
- * Consumers wire oxlint to this entry via:
- *   { "jsPlugins": ["eslint-plugin-import-next/oxlint"] }
- *
- * oxlint's JS plugin loader does `require('eslint-plugin-import-next/oxlint')` and reads
- * `.rules` off the result. The compiled output of `export = plugin` is
- * `module.exports = plugin`, which gives oxlint the plugin object directly
- * (`{ meta, rules }`) — no wrapper, no `.default` indirection.
- *
- * Generated by scripts/generate-oxlint-shims.mjs. Do not edit by hand.
- */
-import { plugin } from './index';
-export = plugin;
+// Minimal declaration written by scripts/build-package.ts.
+//
+// tsc's generated entry declaration inlined every inferred rule-option type
+// (up to 166 kB per plugin) for an API no consumer calls directly. This types
+// what a flat config actually touches. Per-rule option types remain available
+// from the "./types" subpath export where a plugin provides one.
+import type { Linter, Rule } from 'eslint';
+
+export declare const rules: Record<string, Rule.RuleModule>;
+export declare const configs: Record<string, Linter.Config>;
+export declare const plugin: {
+  meta: { name: string; version: string };
+  rules: Record<string, Rule.RuleModule>;
+};
+
+declare const _default: typeof plugin;
+export default _default;

package/src/oxlint.js

@@ -1,21 +1,3 @@
 "use strict";
-/**
- * Copyright (c) 2025 Ofri Peretz
- * Licensed under the MIT License. Use of this source code is governed by the
- * MIT license that can be found in the LICENSE file.
- */
-/**
- * oxlint sub-export.
- *
- * Consumers wire oxlint to this entry via:
- *   { "jsPlugins": ["eslint-plugin-import-next/oxlint"] }
- *
- * oxlint's JS plugin loader does `require('eslint-plugin-import-next/oxlint')` and reads
- * `.rules` off the result. The compiled output of `export = plugin` is
- * `module.exports = plugin`, which gives oxlint the plugin object directly
- * (`{ meta, rules }`) — no wrapper, no `.default` indirection.
- *
- * Generated by scripts/generate-oxlint-shims.mjs. Do not edit by hand.
- */
 const index_1 = require("./index");
 module.exports = index_1.plugin;

package/src/rules/consistent-type-specifier-style.js

@@ -1,9 +1,4 @@
 "use strict";
-/**
- * Copyright (c) 2025 Ofri Peretz
- * Licensed under the MIT License. Use of this source code is governed by the
- * MIT license that can be found in the LICENSE file.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.consistentTypeSpecifierStyle = void 0;
 const eslint_devkit_1 = require("@interlace/eslint-devkit");
@@ -50,10 +45,6 @@ exports.consistentTypeSpecifierStyle = (0, eslint_devkit_1.createRule)({
     create(context) {
         const style = context.options[0] || 'prefer-inline';
         const sourceCode = context.sourceCode;
-        /**
-         * Get the text for a specifier, handling aliasing
-         */
-        // oxlint-disable-next-line consistent-function-scoping
         function getSpecifierText(spec) {
             const imported = spec.imported.type === 'Identifier'
                 ? spec.imported.name
@@ -68,7 +59,6 @@ exports.consistentTypeSpecifierStyle = (0, eslint_devkit_1.createRule)({
             ImportDeclaration(node) {
                 const isTypeImport = node.importKind === 'type';
                 if (style === 'prefer-inline') {
-                    // If using top-level type import with named specifiers, suggest inline
                     if (isTypeImport && node.specifiers.length > 0) {
                         const namedSpecifiers = node.specifiers.filter((s) => s.type === 'ImportSpecifier');
                         if (namedSpecifiers.length > 0) {
@@ -79,9 +69,6 @@ exports.consistentTypeSpecifierStyle = (0, eslint_devkit_1.createRule)({
                                     name: namedSpecifiers.map((s) => s.local.name).join(', '),
                                 },
                                 fix(fixer) {
-                                    // Build the new import statement using AST
-                                    // Convert: import type { Foo, Bar } from 'x'
-                                    // To: import { type Foo, type Bar } from 'x'
                                     const specifiersText = namedSpecifiers
                                         .map((spec) => `type ${getSpecifierText(spec)}`)
                                         .join(', ');
@@ -94,11 +81,8 @@ exports.consistentTypeSpecifierStyle = (0, eslint_devkit_1.createRule)({
                     }
                 }
                 else {
-                    // prefer-top-level
-                    // Check for inline type specifiers
                     const namedSpecifiers = node.specifiers.filter((s) => s.type === 'ImportSpecifier');
                     const inlineTypeSpecifiers = namedSpecifiers.filter((s) => s.importKind === 'type');
-                    // If all named imports are type imports, suggest top-level
                     if (!isTypeImport &&
                         namedSpecifiers.length > 0 &&
                         inlineTypeSpecifiers.length === namedSpecifiers.length) {
@@ -109,9 +93,6 @@ exports.consistentTypeSpecifierStyle = (0, eslint_devkit_1.createRule)({
                                 name: namedSpecifiers.map((s) => s.local.name).join(', '),
                             },
                             fix(fixer) {
-                                // Build the new import statement using AST
-                                // Convert: import { type Foo, type Bar } from 'x'
-                                // To: import type { Foo, Bar } from 'x'
                                 const specifiersText = namedSpecifiers
                                     .map((spec) => getSpecifierText(spec))
                                     .join(', ');

package/src/rules/default.js

@@ -1,9 +1,4 @@
 "use strict";
-/**
- * Copyright (c) 2025 Ofri Peretz
- * Licensed under the MIT License. Use of this source code is governed by the
- * MIT license that can be found in the LICENSE file.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultRule = void 0;
 const tslib_1 = require("tslib");
@@ -46,8 +41,6 @@ exports.defaultRule = (0, eslint_devkit_1.createRule)({
                 const moduleNode = services.esTreeNodeToTSNodeMap.get(node.parent.source);
                 const moduleSymbol = checker?.getSymbolAtLocation?.(moduleNode);
                 if (moduleSymbol && !symbol) {
-                    // If module symbol exists but we can't resolve the default import symbol,
-                    // check if exports contain "default"
                     if (moduleSymbol.exports &&
                         !moduleSymbol.exports.has(typescript_1.default.InternalSymbolName.Default)) {
                         context.report({

package/src/rules/dynamic-import-chunkname.js

@@ -1,9 +1,4 @@
 "use strict";
-/**
- * Copyright (c) 2025 Ofri Peretz
- * Licensed under the MIT License. Use of this source code is governed by the
- * MIT license that can be found in the LICENSE file.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dynamicImportChunkname = void 0;
 const eslint_devkit_1 = require("@interlace/eslint-devkit");
@@ -67,9 +62,7 @@ exports.dynamicImportChunkname = (0, eslint_devkit_1.createRule)({
         const chunkNamePattern = new RegExp(`^${webpackChunknameFormat}$`);
         const sourceCode = context.sourceCode;
         function checkChunkName(node) {
-            // Get leading comments
             const comments = sourceCode.getCommentsBefore(node.source);
-            // Look for webpackChunkName in comments
             let foundChunkName = null;
             let hasWebpackComment = false;
             for (const comment of comments) {
@@ -90,7 +83,6 @@ exports.dynamicImportChunkname = (0, eslint_devkit_1.createRule)({
                             {
                                 messageId: 'suggestChunkName',
                                 fix(fixer) {
-                                    // Generate a chunk name from the import path
                                     const source = node.source;
                                     if (source.type === 'Literal' && typeof source.value === 'string') {
                                         const chunkName = source.value