@boundaries/eslint-plugin 5.3.1 → 6.0.0-beta.1

package/dist/Settings/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./Settings";
 export * from "./Validations";
-export * from "./Settings.types";
 export * from "./Helpers";

package/dist/Settings/index.js

@@ -16,5 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Settings"), exports);
 __exportStar(require("./Validations"), exports);
-__exportStar(require("./Settings.types"), exports);
 __exportStar(require("./Helpers"), exports);

package/dist/{Settings → Shared}/Settings.types.d.ts

@@ -1,4 +1,4 @@
-import type { DependencyKind, ElementDescriptors, ElementsSelector, CapturedValues, ExternalLibrariesSelector } from "@boundaries/elements";
+import type { DependencyKind, DependencySelector, ElementDescriptors, ElementsSelector, FlagAsExternalOptions, DependencyDataSelector, SimpleElementSelectorByType, BaseElementSelectorWithOptions, MicromatchPatternNullable } from "@boundaries/elements";
 import type { ESLint, Linter, Rule } from "eslint";
 export declare const PLUGIN_NAME: "boundaries";
 export declare const PLUGIN_ENV_VARS_PREFIX: "ESLINT_PLUGIN_BOUNDARIES";
@@ -9,7 +9,9 @@ export declare const DEPENDENCY_NODE_REQUIRE: "require";
 export declare const DEPENDENCY_NODE_IMPORT: "import";
 export declare const DEPENDENCY_NODE_DYNAMIC_IMPORT: "dynamic-import";
 export declare const DEPENDENCY_NODE_EXPORT: "export";
+/** @deprecated Use DEPENDENCIES instead */
 export declare const ELEMENT_TYPES: "element-types";
+export declare const DEPENDENCIES: "dependencies";
 export declare const ENTRY_POINT: "entry-point";
 export declare const EXTERNAL: "external";
 export declare const NO_IGNORED: "no-ignored";
@@ -20,7 +22,9 @@ export declare const NO_UNKNOWN: "no-unknown";
  * Map of all rule short names, without the plugin prefix.
  */
 export declare const RULE_SHORT_NAMES_MAP: {
+    /** @deprecated Use DEPENDENCIES instead */
     readonly ELEMENT_TYPES: "element-types";
+    readonly DEPENDENCIES: "dependencies";
     readonly ENTRY_POINT: "entry-point";
     readonly EXTERNAL: "external";
     readonly NO_IGNORED: "no-ignored";
@@ -32,7 +36,9 @@ export declare const RULE_SHORT_NAMES_MAP: {
  * Map of all rule names, including the default plugin prefix.
  */
 export declare const RULE_NAMES_MAP: {
+    /** @deprecated Use DEPENDENCIES instead */
     readonly ELEMENT_TYPES: "boundaries/element-types";
+    readonly DEPENDENCIES: "boundaries/dependencies";
     readonly ENTRY_POINT: "boundaries/entry-point";
     readonly EXTERNAL: "boundaries/external";
     readonly NO_IGNORED: "boundaries/no-ignored";
@@ -43,7 +49,7 @@ export declare const RULE_NAMES_MAP: {
 /**
  * List of all rule names
  */
-export declare const RULE_NAMES: readonly ("boundaries/element-types" | "boundaries/entry-point" | "boundaries/external" | "boundaries/no-ignored" | "boundaries/no-private" | "boundaries/no-unknown-files" | "boundaries/no-unknown")[];
+export declare const RULE_NAMES: readonly ("boundaries/element-types" | "boundaries/dependencies" | "boundaries/entry-point" | "boundaries/external" | "boundaries/no-ignored" | "boundaries/no-private" | "boundaries/no-unknown-files" | "boundaries/no-unknown")[];
 /**
  * Type representing all valid rule names, including the default plugin prefix.
  */
@@ -55,7 +61,7 @@ export type RuleNames = typeof RULE_NAMES;
 /**
  * List of all rule short names, without the plugin prefix.
  */
-export declare const RULE_SHORT_NAMES: readonly ("external" | "element-types" | "entry-point" | "no-ignored" | "no-private" | "no-unknown-files" | "no-unknown")[];
+export declare const RULE_SHORT_NAMES: readonly ("element-types" | "dependencies" | "entry-point" | "external" | "no-ignored" | "no-private" | "no-unknown-files" | "no-unknown")[];
 /**
  * Type representing all valid rule short names, without the plugin prefix.
  */
@@ -64,10 +70,6 @@ export type RuleShortName = (typeof RULE_SHORT_NAMES)[number];
  * List of all rule short names, without the plugin prefix.
  */
 export type RuleShortNames = typeof RULE_SHORT_NAMES;
-/**
- * Main key used in rule definitions.
- */
-export declare const FROM: "from";
 /**
  * Different types of dependency nodes supported by the plugin by default.
  * Each type corresponds to a common way of importing or requiring modules in JavaScript/TypeScript.
@@ -116,9 +118,13 @@ export declare const SETTINGS: {
     readonly ADDITIONAL_DEPENDENCY_NODES: "boundaries/additional-dependency-nodes";
     readonly LEGACY_TEMPLATES: "boundaries/legacy-templates";
     readonly CACHE: "boundaries/cache";
+    readonly FLAG_AS_EXTERNAL: "boundaries/flag-as-external";
+    readonly DEBUG_SETTING: "boundaries/debug";
     readonly DEBUG: "ESLINT_PLUGIN_BOUNDARIES_DEBUG";
     readonly ENV_ROOT_PATH: "ESLINT_PLUGIN_BOUNDARIES_ROOT_PATH";
+    /** @deprecated Use RULE_DEPENDENCIES instead */
     readonly RULE_ELEMENT_TYPES: "boundaries/element-types";
+    readonly RULE_DEPENDENCIES: "boundaries/dependencies";
     readonly RULE_ENTRY_POINT: "boundaries/entry-point";
     readonly RULE_EXTERNAL: "boundaries/external";
     readonly RULE_NO_IGNORED: "boundaries/no-ignored";
@@ -133,30 +139,38 @@ export declare const SETTINGS: {
         readonly require: readonly [{
             readonly selector: "CallExpression[callee.name=require] > Literal";
             readonly kind: "value";
+            readonly name: "require";
         }];
         readonly import: readonly [{
             readonly selector: "ImportDeclaration:not([importKind=type]) > Literal";
             readonly kind: "value";
+            readonly name: "import";
         }, {
             readonly selector: "ImportDeclaration[importKind=type] > Literal";
             readonly kind: "type";
+            readonly name: "import";
         }];
         readonly "dynamic-import": readonly [{
             readonly selector: "ImportExpression > Literal";
             readonly kind: "value";
+            readonly name: "dynamic-import";
         }];
         readonly export: readonly [{
             readonly selector: "ExportAllDeclaration:not([exportKind=type]) > Literal";
             readonly kind: "value";
+            readonly name: "export";
         }, {
             readonly selector: "ExportAllDeclaration[exportKind=type] > Literal";
             readonly kind: "type";
+            readonly name: "export";
         }, {
             readonly selector: "ExportNamedDeclaration:not([exportKind=type]) > Literal";
             readonly kind: "value";
+            readonly name: "export";
         }, {
             readonly selector: "ExportNamedDeclaration[exportKind=type] > Literal";
             readonly kind: "type";
+            readonly name: "export";
         }];
     };
 };
@@ -176,6 +190,8 @@ export declare const SETTINGS_KEYS_MAP: {
     /** @deprecated Use import/resolver settings instead */
     readonly ALIAS: "boundaries/alias";
     readonly CACHE: "boundaries/cache";
+    readonly FLAG_AS_EXTERNAL: "boundaries/flag-as-external";
+    readonly DEBUG: "boundaries/debug";
 };
 /**
  * Default value for the legacy templates setting.
@@ -185,6 +201,10 @@ export declare const LEGACY_TEMPLATES_DEFAULT: true;
  * Default value for the cache setting.
  */
 export declare const CACHE_DEFAULT: true;
+/**
+ * Default value for the check-config setting.
+ */
+export declare const CHECK_CONFIG_DEFAULT: false;
 /**
  * Valid keys for the plugin settings.
  */
@@ -210,6 +230,50 @@ export type RootPathSetting = string;
  * @deprecated Use "import/resolver" settings instead
  */
 export type AliasSetting = Record<string, string>;
+export type DebugFilterSetting = {
+    /** File selectors used to filter file debug messages */
+    files?: ElementsSelector[];
+    /** Dependency selectors used to filter dependency debug messages */
+    dependencies?: DependencySelector[];
+};
+export type DebugSetting = {
+    /** Enables debug output when true */
+    enabled?: boolean;
+    /** Enables specific debug messages */
+    messages?: {
+        /** Whether to enable debug messages for files */
+        files?: boolean;
+        /** Whether to enable debug messages for dependencies */
+        dependencies?: boolean;
+        /** Whether to enable debug messages for rule violations */
+        violations?: boolean;
+    };
+    /** Optional filters for file and dependency debug messages */
+    filter?: DebugFilterSetting;
+};
+/**
+ * Normalized debug setting.
+ */
+export type DebugSettingNormalized = {
+    /** Whether debug mode is enabled */
+    enabled: boolean;
+    /** Settings to enable/disable specific debug messages */
+    messages: {
+        /** Whether to enable debug messages for files */
+        files: boolean;
+        /** Whether to enable debug messages for dependencies */
+        dependencies: boolean;
+        /** Whether to enable debug messages for rule violations */
+        violations: boolean;
+    };
+    /** Debug filters **/
+    filter: {
+        /** File selectors used to filter file debug messages */
+        files?: ElementsSelector[];
+        /** Dependency selectors used to filter dependency debug messages */
+        dependencies?: DependencySelector[];
+    };
+};
 /**
  * Settings for the eslint-plugin-boundaries plugin.
  */
@@ -259,6 +323,10 @@ export type Settings = {
     [SETTINGS_KEYS_MAP.ALIAS]?: AliasSetting;
     /** Whether to enable caching for the plugin analysis */
     [SETTINGS_KEYS_MAP.CACHE]?: boolean;
+    /** Configuration for categorizing dependencies as external or local */
+    [SETTINGS_KEYS_MAP.FLAG_AS_EXTERNAL]?: FlagAsExternalOptions;
+    /** Debug configuration for tracing files and dependencies */
+    [SETTINGS_KEYS_MAP.DEBUG]?: DebugSetting;
 };
 /**
  * Normalized settings for the eslint-plugin-boundaries plugin.
@@ -281,6 +349,10 @@ export type SettingsNormalized = {
     legacyTemplates: boolean;
     /** Whether caching is enabled */
     cache: boolean;
+    /** Configuration for categorizing dependencies as external or local */
+    flagAsExternal: FlagAsExternalOptions;
+    /** Debug configuration */
+    debug: DebugSettingNormalized;
 };
 /**
  * Eslint boundaries plugin rules.
@@ -289,8 +361,9 @@ export type SettingsNormalized = {
  * @template PluginName - The name of the plugin, defaults to "boundaries". It defines the prefix for the rule names.
  */
 export type Rules<PluginName extends string = typeof PLUGIN_NAME> = {
-    [K in `${PluginName}/${typeof ELEMENT_TYPES | typeof ENTRY_POINT | typeof EXTERNAL | typeof NO_IGNORED | typeof NO_PRIVATE | typeof NO_UNKNOWN_FILES | typeof NO_UNKNOWN}`]?: K extends `${PluginName}/${typeof ELEMENT_TYPES}` ? Linter.RuleEntry<ElementTypesRuleOptions[]> : K extends `${PluginName}/${typeof ENTRY_POINT}` ? Linter.RuleEntry<EntryPointRuleOptions[]> : K extends `${PluginName}/${typeof EXTERNAL}` ? Linter.RuleEntry<ExternalRuleOptions[]> : K extends `${PluginName}/${typeof NO_PRIVATE}` ? Linter.RuleEntry<NoPrivateOptions[]> : Linter.RuleEntry<never>;
+    [K in `${PluginName}/${typeof ELEMENT_TYPES | typeof DEPENDENCIES | typeof ENTRY_POINT | typeof EXTERNAL | typeof NO_IGNORED | typeof NO_PRIVATE | typeof NO_UNKNOWN_FILES | typeof NO_UNKNOWN}`]?: K extends `${PluginName}/${typeof ELEMENT_TYPES}` ? Linter.RuleEntry<ElementTypesRuleOptions[]> : K extends `${PluginName}/${typeof DEPENDENCIES}` ? Linter.RuleEntry<DependenciesRuleOptions[]> : K extends `${PluginName}/${typeof ENTRY_POINT}` ? Linter.RuleEntry<EntryPointRuleOptions[]> : K extends `${PluginName}/${typeof EXTERNAL}` ? Linter.RuleEntry<ExternalRuleOptions[]> : K extends `${PluginName}/${typeof NO_PRIVATE}` ? Linter.RuleEntry<NoPrivateOptions[]> : Linter.RuleEntry<never>;
 };
+export type FlagAsExternalBooleanOptionKey = "unresolvableAlias" | "inNodeModules" | "outsideRootPath";
 /**
  * ESLint configuration with optional settings and rules specific to the boundaries plugin.
  */
@@ -349,49 +422,49 @@ export type RuleBaseOptions = {
     /** Custom message for all rule violations. It can be overridden at the rule level. */
     message?: string;
 };
-export type RuleReport = {
-    message?: string;
-    isDefault?: boolean;
-    importKind?: DependencyKind;
-    disallow?: ElementsSelector;
-    element: ElementsSelector;
-    index: number;
-};
-export type RuleResultReport = {
-    path: string | null;
-    specifiers?: string[];
-};
-export type RuleResult = {
-    result: boolean;
-    ruleReport: RuleReport | null;
-    report: RuleResultReport | null;
-};
-export type RuleMatcherElementsCapturedValues = {
-    from: CapturedValues;
-    target: CapturedValues;
-};
+export type RulePolicyEntry = SimpleElementSelectorByType | BaseElementSelectorWithOptions | DependencySelector;
 /**
  * Rule that defines allowed or disallowed dependencies between different element types.
  */
-export type ElementTypesRule = {
+export type DependenciesRule = {
+    dependency?: DependencyDataSelector;
     /** Selectors of the source elements that the rule applies to (the elements importing) */
     from?: ElementsSelector;
     /** Selectors of the target elements that are disallowed to be imported */
     to?: ElementsSelector;
     /** Selectors of the elements that are disallowed to be imported */
-    disallow?: ElementsSelector;
+    disallow?: RulePolicyEntry | RulePolicyEntry[];
     /** Selectors of the elements that are allowed to be imported */
-    allow?: ElementsSelector;
+    allow?: RulePolicyEntry | RulePolicyEntry[];
     /** Kind of import that the rule applies to (e.g., "type", "value") */
     importKind?: DependencyKind;
     /** Custom message for rule violations */
     message?: string;
 };
 /**
- * Options for the element-types rule, including default policy and specific rules.
+ * Legacy type for the renamed element-types rule, kept for backward compatibility. It has the same shape as the dependencies rule but with "target" instead of "to" and without the "dependency" field.
+ * @deprecated Use DependenciesRule instead
  */
-export type ElementTypesRuleOptions = Omit<RuleBaseOptions, "rules"> & {
+export type ElementTypesRule = DependenciesRule;
+/**
+ * Options for the dependencies rule, including default policy and specific rules.
+ */
+export type DependenciesRuleOptions = Omit<RuleBaseOptions, "rules"> & {
     /** Specific rules for defining boundaries between elements */
+    rules?: DependenciesRule[];
+    /** Whether to check dependencies from all origins (including external and core) or only from local elements (default: `false`, only local). */
+    checkAllOrigins?: boolean;
+    /** Whether to check local dependencies with unknown elements (not matching any element descriptor) or to ignore them. (default: `false`, ignore them) */
+    checkUnknownLocals?: boolean;
+    /** Whether to check internal dependencies (dependencies within files in the same element) (default: `false`, ignore them) */
+    checkInternals?: boolean;
+};
+/**
+ * Legacy type for the renamed element-types rule options, kept for backward compatibility.
+ * @deprecated Use DependenciesRuleOptions instead
+ */
+export type ElementTypesRuleOptions = Omit<DependenciesRuleOptions, "rules"> & {
+    /** Specific rules for defining element types */
     rules?: ElementTypesRule[];
 };
 /**
@@ -416,6 +489,38 @@ export type EntryPointRuleOptions = Omit<RuleBaseOptions, "rules"> & {
     /** Specific rules for defining entry points between elements */
     rules?: EntryPointRule[];
 };
+/**
+ * Options for selecting external libraries, including path patterns and optional specifiers.
+ * If specifiers are provided, they will be used to match specific imports from the external library.
+ */
+export type ExternalLibrarySelectorOptions = {
+    /**
+     * Micromatch pattern(s) to match only one or more specific subpaths of the external library.
+     */
+    path?: MicromatchPatternNullable;
+    /** Micromatch pattern(s) to match only specific imports/exports */
+    specifiers?: string[];
+};
+/**
+ * External library selector with options, represented as a tuple where the first element is the import path of the external library, and the second element is an object containing options for selecting only specific paths or specifiers from that library.
+ */
+export type ExternalLibrarySelectorWithOptions = [
+    string,
+    ExternalLibrarySelectorOptions
+];
+/**
+ * External library selector, which can be a simple string (the import path) or an external library selector with options.
+ */
+export type ExternalLibrarySelector = string | ExternalLibrarySelectorWithOptions;
+/**
+ * External library selectors, which can be a single external library selector or an array of external library selectors.
+ * @deprecated Use ExternalLibrariesSelector instead.
+ */
+export type ExternalLibrarySelectors = ExternalLibrariesSelector;
+/**
+ * External libraries selector, which can be a single external library selector or an array of external library selectors.
+ */
+export type ExternalLibrariesSelector = ExternalLibrarySelector | ExternalLibrarySelector[];
 /**
  * Rule that defines allowed or disallowed external library imports for specific element types.
  */
@@ -449,10 +554,11 @@ export type NoPrivateOptions = {
     /** Custom message for rule violations */
     message?: string;
 };
-export type RuleOptionsWithRules = ExternalRuleOptions | EntryPointRuleOptions | ElementTypesRuleOptions;
+export type RuleOptionsWithRules = ExternalRuleOptions | EntryPointRuleOptions | DependenciesRuleOptions;
 export type RuleOptions = RuleOptionsWithRules | NoPrivateOptions;
-export type RuleOptionsRules = ExternalRule | EntryPointRule | ElementTypesRule;
-export type RuleMainKey = "from" | "to" | "target";
+export type RuleOptionsRules = ExternalRule | EntryPointRule | DependenciesRule;
+export declare const FROM: "from";
+export type RuleMainKey = typeof FROM | "to" | "target";
 export type ValidateRulesOptions = {
     mainKey?: RuleMainKey;
     onlyMainKey?: boolean;

package/dist/{Settings → Shared}/Settings.types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RULE_POLICIES_MAP = exports.RULE_POLICY_DISALLOW = exports.RULE_POLICY_ALLOW = exports.CACHE_DEFAULT = exports.LEGACY_TEMPLATES_DEFAULT = exports.SETTINGS_KEYS_MAP = exports.SETTINGS = exports.DEPENDENCY_NODE_KEYS_MAP = exports.FROM = exports.RULE_SHORT_NAMES = exports.RULE_NAMES = exports.RULE_NAMES_MAP = exports.RULE_SHORT_NAMES_MAP = exports.NO_UNKNOWN = exports.NO_UNKNOWN_FILES = exports.NO_PRIVATE = exports.NO_IGNORED = exports.EXTERNAL = exports.ENTRY_POINT = exports.ELEMENT_TYPES = exports.DEPENDENCY_NODE_EXPORT = exports.DEPENDENCY_NODE_DYNAMIC_IMPORT = exports.DEPENDENCY_NODE_IMPORT = exports.DEPENDENCY_NODE_REQUIRE = exports.PLUGIN_ISSUES_URL = exports.WEBSITE_URL = exports.REPO_URL = exports.PLUGIN_ENV_VARS_PREFIX = exports.PLUGIN_NAME = void 0;
+exports.FROM = exports.RULE_POLICIES_MAP = exports.RULE_POLICY_DISALLOW = exports.RULE_POLICY_ALLOW = exports.CHECK_CONFIG_DEFAULT = exports.CACHE_DEFAULT = exports.LEGACY_TEMPLATES_DEFAULT = exports.SETTINGS_KEYS_MAP = exports.SETTINGS = exports.DEPENDENCY_NODE_KEYS_MAP = exports.RULE_SHORT_NAMES = exports.RULE_NAMES = exports.RULE_NAMES_MAP = exports.RULE_SHORT_NAMES_MAP = exports.NO_UNKNOWN = exports.NO_UNKNOWN_FILES = exports.NO_PRIVATE = exports.NO_IGNORED = exports.EXTERNAL = exports.ENTRY_POINT = exports.DEPENDENCIES = exports.ELEMENT_TYPES = exports.DEPENDENCY_NODE_EXPORT = exports.DEPENDENCY_NODE_DYNAMIC_IMPORT = exports.DEPENDENCY_NODE_IMPORT = exports.DEPENDENCY_NODE_REQUIRE = exports.PLUGIN_ISSUES_URL = exports.WEBSITE_URL = exports.REPO_URL = exports.PLUGIN_ENV_VARS_PREFIX = exports.PLUGIN_NAME = void 0;
 // Plugin constants
 exports.PLUGIN_NAME = "boundaries";
 exports.PLUGIN_ENV_VARS_PREFIX = "ESLINT_PLUGIN_BOUNDARIES";
@@ -12,7 +12,9 @@ exports.DEPENDENCY_NODE_IMPORT = "import";
 exports.DEPENDENCY_NODE_DYNAMIC_IMPORT = "dynamic-import";
 exports.DEPENDENCY_NODE_EXPORT = "export";
 // Rule short names
+/** @deprecated Use DEPENDENCIES instead */
 exports.ELEMENT_TYPES = "element-types";
+exports.DEPENDENCIES = "dependencies";
 exports.ENTRY_POINT = "entry-point";
 exports.EXTERNAL = "external";
 exports.NO_IGNORED = "no-ignored";
@@ -23,7 +25,9 @@ exports.NO_UNKNOWN = "no-unknown";
  * Map of all rule short names, without the plugin prefix.
  */
 exports.RULE_SHORT_NAMES_MAP = {
+    /** @deprecated Use DEPENDENCIES instead */
     ELEMENT_TYPES: exports.ELEMENT_TYPES,
+    DEPENDENCIES: exports.DEPENDENCIES,
     ENTRY_POINT: exports.ENTRY_POINT,
     EXTERNAL: exports.EXTERNAL,
     NO_IGNORED: exports.NO_IGNORED,
@@ -31,7 +35,9 @@ exports.RULE_SHORT_NAMES_MAP = {
     NO_UNKNOWN_FILES: exports.NO_UNKNOWN_FILES,
     NO_UNKNOWN: exports.NO_UNKNOWN,
 };
+/** @deprecated Use DEPENDENCIES_FULL instead */
 const ELEMENT_TYPES_FULL = `${exports.PLUGIN_NAME}/${exports.ELEMENT_TYPES}`;
+const DEPENDENCIES_FULL = `${exports.PLUGIN_NAME}/${exports.DEPENDENCIES}`;
 const ENTRY_POINT_FULL = `${exports.PLUGIN_NAME}/${exports.ENTRY_POINT}`;
 const EXTERNAL_FULL = `${exports.PLUGIN_NAME}/${exports.EXTERNAL}`;
 const NO_IGNORED_FULL = `${exports.PLUGIN_NAME}/${exports.NO_IGNORED}`;
@@ -42,7 +48,9 @@ const NO_UNKNOWN_FULL = `${exports.PLUGIN_NAME}/${exports.NO_UNKNOWN}`;
  * Map of all rule names, including the default plugin prefix.
  */
 exports.RULE_NAMES_MAP = {
+    /** @deprecated Use DEPENDENCIES instead */
     ELEMENT_TYPES: ELEMENT_TYPES_FULL,
+    DEPENDENCIES: DEPENDENCIES_FULL,
     ENTRY_POINT: ENTRY_POINT_FULL,
     EXTERNAL: EXTERNAL_FULL,
     NO_IGNORED: NO_IGNORED_FULL,
@@ -60,10 +68,6 @@ exports.RULE_NAMES = [...Object.values(exports.RULE_NAMES_MAP)];
 exports.RULE_SHORT_NAMES = [
     ...Object.values(exports.RULE_SHORT_NAMES_MAP),
 ];
-/**
- * Main key used in rule definitions.
- */
-exports.FROM = "from";
 /**
  * Different types of dependency nodes supported by the plugin by default.
  * Each type corresponds to a common way of importing or requiring modules in JavaScript/TypeScript.
@@ -96,11 +100,15 @@ exports.SETTINGS = {
     ADDITIONAL_DEPENDENCY_NODES: `${exports.PLUGIN_NAME}/additional-dependency-nodes`,
     LEGACY_TEMPLATES: `${exports.PLUGIN_NAME}/legacy-templates`,
     CACHE: `${exports.PLUGIN_NAME}/cache`,
+    FLAG_AS_EXTERNAL: `${exports.PLUGIN_NAME}/flag-as-external`,
+    DEBUG_SETTING: `${exports.PLUGIN_NAME}/debug`,
     // env vars
     DEBUG: `${exports.PLUGIN_ENV_VARS_PREFIX}_DEBUG`,
     ENV_ROOT_PATH: `${exports.PLUGIN_ENV_VARS_PREFIX}_ROOT_PATH`,
     // rules
+    /** @deprecated Use RULE_DEPENDENCIES instead */
     RULE_ELEMENT_TYPES: `${exports.PLUGIN_NAME}/${exports.ELEMENT_TYPES}`,
+    RULE_DEPENDENCIES: `${exports.PLUGIN_NAME}/${exports.DEPENDENCIES}`,
     RULE_ENTRY_POINT: `${exports.PLUGIN_NAME}/${exports.ENTRY_POINT}`,
     RULE_EXTERNAL: `${exports.PLUGIN_NAME}/${exports.EXTERNAL}`,
     RULE_NO_IGNORED: `${exports.PLUGIN_NAME}/${exports.NO_IGNORED}`,
@@ -119,6 +127,7 @@ exports.SETTINGS = {
             {
                 selector: "CallExpression[callee.name=require] > Literal",
                 kind: "value",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.REQUIRE,
             },
         ],
         [exports.DEPENDENCY_NODE_KEYS_MAP.IMPORT]: [
@@ -126,37 +135,47 @@ exports.SETTINGS = {
             {
                 selector: "ImportDeclaration:not([importKind=type]) > Literal",
                 kind: "value",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.IMPORT,
             },
             // Note: detects "import type x from 'source'"
             {
                 selector: "ImportDeclaration[importKind=type] > Literal",
                 kind: "type",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.IMPORT,
             },
         ],
         [exports.DEPENDENCY_NODE_KEYS_MAP.DYNAMIC_IMPORT]: [
             // Note: detects "import('source')"
-            { selector: "ImportExpression > Literal", kind: "value" },
+            {
+                selector: "ImportExpression > Literal",
+                kind: "value",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.DYNAMIC_IMPORT,
+            },
         ],
         [exports.DEPENDENCY_NODE_KEYS_MAP.EXPORT]: [
             // Note: detects "export * from 'source'";
             {
                 selector: "ExportAllDeclaration:not([exportKind=type]) > Literal",
                 kind: "value",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.EXPORT,
             },
             // Note: detects "export type * from 'source'";
             {
                 selector: "ExportAllDeclaration[exportKind=type] > Literal",
                 kind: "type",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.EXPORT,
             },
             // Note: detects "export { x } from 'source'";
             {
                 selector: "ExportNamedDeclaration:not([exportKind=type]) > Literal",
                 kind: "value",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.EXPORT,
             },
             // Note: detects "export type { x } from 'source'";
             {
                 selector: "ExportNamedDeclaration[exportKind=type] > Literal",
                 kind: "type",
+                name: exports.DEPENDENCY_NODE_KEYS_MAP.EXPORT,
             },
         ],
     },
@@ -177,6 +196,8 @@ exports.SETTINGS_KEYS_MAP = {
     /** @deprecated Use import/resolver settings instead */
     ALIAS: exports.SETTINGS.ALIAS,
     CACHE: exports.SETTINGS.CACHE,
+    FLAG_AS_EXTERNAL: exports.SETTINGS.FLAG_AS_EXTERNAL,
+    DEBUG: exports.SETTINGS.DEBUG_SETTING,
 };
 /**
  * Default value for the legacy templates setting.
@@ -186,6 +207,10 @@ exports.LEGACY_TEMPLATES_DEFAULT = true;
  * Default value for the cache setting.
  */
 exports.CACHE_DEFAULT = true;
+/**
+ * Default value for the check-config setting.
+ */
+exports.CHECK_CONFIG_DEFAULT = false;
 exports.RULE_POLICY_ALLOW = "allow";
 exports.RULE_POLICY_DISALLOW = "disallow";
 /**
@@ -195,3 +220,4 @@ exports.RULE_POLICIES_MAP = {
     ALLOW: exports.RULE_POLICY_ALLOW,
     DISALLOW: exports.RULE_POLICY_DISALLOW,
 };
+exports.FROM = "from";

package/dist/{Support/Common.d.ts → Shared/TypeHelpers.d.ts}

@@ -16,12 +16,30 @@ export declare function isString(object: unknown): object is string;
  * @returns True if the object is a boolean, false otherwise.
  */
 export declare function isBoolean(object: unknown): object is boolean;
+/**
+ * Determines if the provided object is null.
+ * @param object The object to check.
+ * @returns True if the object is null, false otherwise.
+ */
+export declare function isNull(object: unknown): object is null;
 /**
  * Determines if the provided object is a non-null object (but not an array).
  * @param object The object to check.
  * @returns True if the object is a non-null object, false otherwise.
  */
 export declare function isObject(object: unknown): object is Record<string, unknown>;
+/**
+ * Determines if the provided object is undefined.
+ * @param object The object to check.
+ * @returns True if the object is undefined, false otherwise.
+ */
+export declare function isUndefined(object: unknown): object is undefined;
+/**
+ * Determines if the provided object is null or undefined.
+ * @param object The object to check.
+ * @returns True if the object is null or undefined, false otherwise.
+ */
+export declare function isNullish(object: unknown): object is null | undefined;
 /**
  * Returns the value as an array if it is an array, or null otherwise.
  * @param value The value to check.

package/dist/{Support/Common.js → Shared/TypeHelpers.js}

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isArray = isArray;
 exports.isString = isString;
 exports.isBoolean = isBoolean;
+exports.isNull = isNull;
 exports.isObject = isObject;
+exports.isUndefined = isUndefined;
+exports.isNullish = isNullish;
 exports.getArrayOrNull = getArrayOrNull;
 /**
  * Determines if the provided object is an array.
@@ -29,13 +32,37 @@ function isString(object) {
 function isBoolean(object) {
     return typeof object === "boolean";
 }
+/**
+ * Determines if the provided object is null.
+ * @param object The object to check.
+ * @returns True if the object is null, false otherwise.
+ */
+function isNull(object) {
+    return object === null;
+}
 /**
  * Determines if the provided object is a non-null object (but not an array).
  * @param object The object to check.
  * @returns True if the object is a non-null object, false otherwise.
  */
 function isObject(object) {
-    return typeof object === "object" && object !== null && !isArray(object);
+    return typeof object === "object" && !isNull(object) && !isArray(object);
+}
+/**
+ * Determines if the provided object is undefined.
+ * @param object The object to check.
+ * @returns True if the object is undefined, false otherwise.
+ */
+function isUndefined(object) {
+    return object === undefined;
+}
+/**
+ * Determines if the provided object is null or undefined.
+ * @param object The object to check.
+ * @returns True if the object is null or undefined, false otherwise.
+ */
+function isNullish(object) {
+    return isNull(object) || isUndefined(object);
 }
 /**
  * Returns the value as an array if it is an array, or null otherwise.

package/dist/Shared/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./TypeHelpers";
+export * from "./Settings.types";

package/dist/Shared/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./TypeHelpers"), exports);
+__exportStar(require("./Settings.types"), exports);

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { PluginBoundaries } from "./Settings";
+import type { PluginBoundaries } from "./Shared";
 export * from "./Public";
 /**
  * Eslint plugin ensuring that architecture boundaries are respected by the elements in a project