banned-imports

Report imports forbidden by package-relative architectural boundaries.

Configure rules: [{files: ["lib/domain/**"], deny: ["package:flutter/**"], message: "Keep domain code independent of Flutter."}] in this rule's options. Both lists are required, nonempty lists of nonempty glob strings; message is required and nonblank. Invalid entries are rejected during configuration validation; no configuration means no reports. Globs are case-sensitive, match the entire string, and use / separators: * does not cross directories, while ** does. Source files paths are relative to their nearest enclosing pubspec directory (including lib/). Files without an enclosing pubspec are skipped.

Each deny pattern matches the decoded import URI, without quotes, and the normalized package-relative target of relative or same-package imports. Local target matching does not require the target to exist. External package and SDK imports match only their URI. Primary and all conditional URIs are checked, including inactive alternatives; prefixes, deferred loading and combinators do not exempt an import. Each matching entry reports its custom message once per URI, even if several of its patterns match. Overlapping entries can therefore produce multiple reports. Exports and parts are not imports and are deliberately outside this rule's boundary policy.