@depup/angular-eslint__eslint-plugin 22.1.0-depup.1 → 22.3.0-depup.0

package/dist/rules/reactive-context-must-read-signal.js

@@ -0,0 +1,357 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RULE_DOCS_EXTENSION = exports.RULE_NAME = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const tsutils = __importStar(require("ts-api-utils"));
+const typescript_1 = __importDefault(require("typescript"));
+const create_eslint_rule_1 = require("../utils/create-eslint-rule");
+const signals_1 = require("../utils/signals");
+exports.RULE_NAME = 'reactive-context-must-read-signal';
+/**
+ * Reactive contexts that should depend on at least one signal. The tracked
+ * function is the one whose signal reads define the context's dependencies:
+ * - `computed`/`effect`: the first argument.
+ * - `linkedSignal`: the first argument (shorthand) or the `source`/`computation`
+ *   functions of the options object.
+ * - `afterRenderEffect`: the first argument (shorthand) or the phase functions
+ *   of the options object.
+ */
+const DEFAULT_PRIMITIVES = {
+    afterRenderEffect: {
+        args: [0],
+        optionKeys: ['earlyRead', 'write', 'mixedReadWrite', 'read'],
+    },
+    computed: { args: [0], optionKeys: [] },
+    effect: { args: [0], optionKeys: [] },
+    linkedSignal: { args: [0], optionKeys: ['source', 'computation'] },
+};
+/**
+ * For resources, only the `params` (formerly `request`) function defines the
+ * reactive dependencies; reading a signal in the `loader`/`stream` does not make
+ * the resource reload. These are opt-in via the `checkResources` option.
+ */
+const RESOURCE_PRIMITIVES = {
+    resource: { args: [0], optionKeys: ['params', 'request'] },
+    rxResource: { args: [0], optionKeys: ['params', 'request'] },
+};
+function isFunction(node) {
+    return (node?.type === utils_1.AST_NODE_TYPES.FunctionExpression ||
+        node?.type === utils_1.AST_NODE_TYPES.ArrowFunctionExpression);
+}
+exports.default = (0, create_eslint_rule_1.createESLintRule)({
+    name: exports.RULE_NAME,
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Ensures that reactive contexts such as computed(), linkedSignal() and effect() read at least one reactive value (a signal). A reactive context with no reactive dependencies never re-runs, which is almost always a mistake.',
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    checkResources: {
+                        type: 'boolean',
+                        description: 'Also check that the `params` function of `resource()` and `rxResource()` reads a signal.',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            mustReadSignal: '{{primitive}}() must read at least one signal, otherwise it will never re-run when state changes.',
+        },
+    },
+    defaultOptions: [{ checkResources: false }],
+    create(context, [{ checkResources = false }]) {
+        const services = utils_1.ESLintUtils.getParserServices(context);
+        const checker = services.program.getTypeChecker();
+        const primitives = checkResources
+            ? { ...DEFAULT_PRIMITIVES, ...RESOURCE_PRIMITIVES }
+            : DEFAULT_PRIMITIVES;
+        const analyses = new Map();
+        const trackedFnToCall = new Map();
+        const frameStack = [];
+        /**
+         * Returns true if calling `callee` reads a signal, i.e. `callee` has one of
+         * the known signal types. This mirrors the detection used by
+         * `no-uncalled-signals`.
+         */
+        function isSignalRead(callee) {
+            const type = services.getTypeAtLocation(callee);
+            const symbol = type.getSymbol();
+            if (symbol && signals_1.KNOWN_SIGNAL_TYPES.has(symbol.name)) {
+                return true;
+            }
+            // The `Signal` type is a type alias, so it is only reachable via the
+            // alias symbol. Other signal types (e.g. `InputSignal`) are interfaces
+            // and are found through `getSymbol()` above.
+            if (type.aliasSymbol && signals_1.KNOWN_SIGNAL_TYPES.has(type.aliasSymbol.name)) {
+                return true;
+            }
+            return false;
+        }
+        /**
+         * Returns true if the symbol is only declared in TypeScript's default
+         * library files. Those declarations (arrays, strings, `Math`, `JSON`,
+         * `Object`, `console`, DOM APIs, ...) cannot read an Angular signal.
+         */
+        function isDeclaredInDefaultLib(symbol) {
+            const declarations = symbol.getDeclarations();
+            return (!!declarations?.length &&
+                declarations.every((declaration) => services.program.isSourceFileDefaultLibrary(declaration.getSourceFile())));
+        }
+        /**
+         * Returns true if the node is a function-typed value that we cannot look
+         * inside, e.g. `this.transform` in `this.items.map(this.transform)`. The
+         * callee could invoke it, and it could read a signal.
+         */
+        function isOpaqueFunctionValue(node) {
+            if (isFunction(node)) {
+                // Inline functions are visited by this rule, so any signal they read is
+                // attributed to the enclosing reactive context.
+                return false;
+            }
+            if (node.type === utils_1.AST_NODE_TYPES.SpreadElement) {
+                // We cannot tell what a spread expands to, so assume the worst.
+                return true;
+            }
+            const type = services.getTypeAtLocation(node);
+            if (tsutils.isTypeFlagSet(type, typescript_1.default.TypeFlags.Any | typescript_1.default.TypeFlags.Unknown)) {
+                // We know nothing about the value, so it could well be a function
+                // that reads a signal.
+                return true;
+            }
+            return tsutils
+                .unionConstituents(type)
+                .some((constituent) => constituent.getCallSignatures().length > 0);
+        }
+        /**
+         * Returns true if the property with the given name is a getter on any
+         * constituent of the type. A getter runs arbitrary code, so it can read a
+         * signal even though reading the property does not look like a call.
+         */
+        function isGetter(type, name) {
+            return tsutils.unionConstituents(type).some((constituent) => {
+                const property = constituent.getProperty(name);
+                return (property !== undefined &&
+                    tsutils.isSymbolFlagSet(property, typescript_1.default.SymbolFlags.GetAccessor));
+            });
+        }
+        /**
+         * Records what a call, `new` expression or tagged template tells us about
+         * the reactive context we are currently inside. It is only known not to
+         * read a signal when the callee resolves to a declaration in a TypeScript
+         * default library and no argument is an opaque function value.
+         */
+        function analyseCallLike(callee, args, analysis) {
+            let symbol = services.getSymbolAtLocation(callee);
+            if (symbol && tsutils.isSymbolFlagSet(symbol, typescript_1.default.SymbolFlags.Alias)) {
+                symbol = checker.getAliasedSymbol(symbol);
+            }
+            if (!symbol ||
+                !isDeclaredInDefaultLib(symbol) ||
+                args.some(isOpaqueFunctionValue)) {
+                analysis.hasUnknown = true;
+            }
+        }
+        /** The analysis of the reactive context we are currently inside, if any. */
+        function currentAnalysis() {
+            const top = frameStack[frameStack.length - 1];
+            return top && analyses.get(top.call);
+        }
+        function registerTrackedFunction(node, call, analysis) {
+            if (isFunction(node)) {
+                trackedFnToCall.set(node, call);
+                analysis.hasTrackedFn = true;
+            }
+            else {
+                // The tracked slot holds something we cannot look inside, such as a
+                // signal passed directly as `source`, or a reference to a function
+                // declared elsewhere. It may well be reactive, so stay silent.
+                analysis.hasUnknown = true;
+            }
+        }
+        function registerTrackedOptions(options, call, config, analysis) {
+            for (const property of options.properties) {
+                if (property.type === utils_1.AST_NODE_TYPES.SpreadElement) {
+                    // The spread could provide any of the tracked options.
+                    analysis.hasUnknown = true;
+                }
+                else if (!property.computed &&
+                    property.key.type === utils_1.AST_NODE_TYPES.Identifier &&
+                    config.optionKeys.includes(property.key.name)) {
+                    registerTrackedFunction(property.value, call, analysis);
+                }
+            }
+        }
+        function registerTrackedFunctions(call, config, analysis) {
+            for (const index of config.args) {
+                const arg = call.arguments[index];
+                if (arg === undefined) {
+                    continue;
+                }
+                if (config.optionKeys.length > 0 &&
+                    arg.type === utils_1.AST_NODE_TYPES.ObjectExpression) {
+                    registerTrackedOptions(arg, call, config, analysis);
+                }
+                else {
+                    registerTrackedFunction(arg, call, analysis);
+                }
+            }
+        }
+        function enterFunction(node) {
+            const call = trackedFnToCall.get(node);
+            if (call) {
+                frameStack.push({ fn: node, call });
+            }
+        }
+        function exitFunction(node) {
+            const top = frameStack[frameStack.length - 1];
+            if (top?.fn === node) {
+                frameStack.pop();
+            }
+        }
+        return {
+            ArrowFunctionExpression: enterFunction,
+            'ArrowFunctionExpression:exit': exitFunction,
+            FunctionExpression: enterFunction,
+            'FunctionExpression:exit': exitFunction,
+            MemberExpression(node) {
+                const analysis = currentAnalysis();
+                if (!analysis) {
+                    return;
+                }
+                // A getter runs arbitrary code, so `this.name` can read a signal even
+                // though it does not look like a call.
+                const symbol = services.getSymbolAtLocation(node);
+                if (symbol &&
+                    tsutils.isSymbolFlagSet(symbol, typescript_1.default.SymbolFlags.GetAccessor)) {
+                    analysis.hasUnknown = true;
+                }
+            },
+            ObjectPattern(node) {
+                const analysis = currentAnalysis();
+                if (!analysis) {
+                    return;
+                }
+                // Destructuring invokes getters just like a member expression does,
+                // e.g. `const { double } = this`.
+                const type = services.getTypeAtLocation(node);
+                for (const property of node.properties) {
+                    if (property.type !== utils_1.AST_NODE_TYPES.Property ||
+                        property.computed ||
+                        property.key.type !== utils_1.AST_NODE_TYPES.Identifier) {
+                        // A rest element copies every property and a computed or literal
+                        // key can name any property, so assume a getter could be involved.
+                        analysis.hasUnknown = true;
+                    }
+                    else if (isGetter(type, property.key.name)) {
+                        analysis.hasUnknown = true;
+                    }
+                }
+            },
+            NewExpression(node) {
+                const analysis = currentAnalysis();
+                if (analysis) {
+                    analyseCallLike(node.callee, node.arguments, analysis);
+                }
+            },
+            TaggedTemplateExpression(node) {
+                const analysis = currentAnalysis();
+                if (analysis) {
+                    analyseCallLike(node.tag, node.quasi.expressions, analysis);
+                }
+            },
+            CallExpression(node) {
+                // Attribute this call to the tracked function we are currently inside,
+                // if any. This runs before registration below, so a reactive context
+                // nested inside another tracked function is correctly treated as an
+                // (unknown) call of the outer function.
+                const analysis = currentAnalysis();
+                if (analysis) {
+                    if (isSignalRead(node.callee)) {
+                        analysis.hasReactiveRead = true;
+                    }
+                    else {
+                        analyseCallLike(node.callee, node.arguments, analysis);
+                    }
+                }
+                // Register this call if it is one of the reactive contexts.
+                if (node.callee.type !== utils_1.AST_NODE_TYPES.Identifier) {
+                    return;
+                }
+                const config = primitives[node.callee.name];
+                if (!config) {
+                    return;
+                }
+                const newAnalysis = {
+                    call: node,
+                    primitiveName: node.callee.name,
+                    hasTrackedFn: false,
+                    hasReactiveRead: false,
+                    hasUnknown: false,
+                };
+                registerTrackedFunctions(node, config, newAnalysis);
+                analyses.set(node, newAnalysis);
+            },
+            'CallExpression:exit'(node) {
+                const analysis = analyses.get(node);
+                if (!analysis) {
+                    return;
+                }
+                analyses.delete(node);
+                // Only report when we are certain there is no reactivity: there is a
+                // tracked function, no signal was read, and there was nothing that
+                // might have read a signal on our behalf.
+                if (analysis.hasTrackedFn &&
+                    !analysis.hasReactiveRead &&
+                    !analysis.hasUnknown) {
+                    context.report({
+                        node: analysis.call,
+                        messageId: 'mustReadSignal',
+                        data: { primitive: analysis.primitiveName },
+                    });
+                }
+            },
+        };
+    },
+});
+exports.RULE_DOCS_EXTENSION = {
+    rationale: 'Reactive contexts like `computed()`, `linkedSignal()`, `effect()` and `afterRenderEffect()` re-run whenever a signal they read changes. If the relevant function never reads a signal, the context runs once and can never react to anything, so it adds overhead without providing reactivity. This is usually a mistake: either the developer forgot to call a signal (e.g. wrote `firstName` instead of `firstName()`), or the value is actually static and should be a plain constant, a `signal()`, or an `afterNextRender()` in the case of `afterRenderEffect()`. To avoid false positives, the rule only reports when everything the tracked function does is known not to read a signal. Calls into the TypeScript standard library (arrays, strings, `Math`, `JSON`, `console`, DOM APIs, etc.) are known to be safe; anything else keeps the rule silent, including a helper function, a service method, a getter, an unresolved symbol, and any Angular API such as `untracked()`. One known limitation: a standard library call that reaches user code through a protocol method, such as `toJSON()` in `JSON.stringify()` or `toString()` in a template literal, is still treated as safe, so a signal read inside such a method is not detected. For `resource()`/`rxResource()` only the `params` function defines the dependencies, and these are opt-in via the `checkResources` option.',
+};

package/dist/rules/relative-url-prefix.js

@@ -16,8 +16,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
         messages: {
             relativeUrlPrefix: `The ./ and ../ prefix is standard syntax for relative URLs.`,
         },
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         return {
             [`${utils_1.Selectors.COMPONENT_CLASS_DECORATOR} Property[key.name='templateUrl']`]({ value, }) {

package/dist/rules/require-lifecycle-on-prototype.js

@@ -25,8 +25,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
         messages: {
             defineOnPrototype: `The {{ method }} lifecycle method should be defined on the object's prototype. See more at ${ISSUE_LINK}`,
         },
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         return {
             [propertyDefinitionSelector](node) {

package/dist/rules/require-localize-metadata.js

@@ -44,8 +44,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
             requireLocalizeMeaning: `$localize tagged messages should contain a meaning. See more at ${STYLE_GUIDE_LINK_METADATA_FOR_TRANSLATION}`,
             requireLocalizeCustomId: `$localize tagged messages should contain a custom id{{patternMessage}}. See more at ${STYLE_GUIDE_LINK_METADATA_FOR_TRANSLATION}`,
         },
+        defaultOptions: [DEFAULT_OPTIONS],
     },
-    defaultOptions: [DEFAULT_OPTIONS],
     create(context, [{ requireDescription, requireMeaning, requireCustomId }]) {
         return {
             TaggedTemplateExpression(taggedTemplateExpression) {

package/dist/rules/runtime-localize.js

@@ -15,8 +15,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
         messages: {
             runtimeLocalize: `$localize could be called before translations are loaded`,
         },
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         return {
             TaggedTemplateExpression(taggedTemplateExpression) {

package/dist/rules/sort-keys-in-type-decorator.js

@@ -103,8 +103,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
         messages: {
             incorrectOrder: 'Keys in @{{decorator}} decorator should be ordered: {{expectedOrder}}',
         },
+        defaultOptions: [DEFAULT_ORDER],
     },
-    defaultOptions: [DEFAULT_ORDER],
     create(context, [orderConfig]) {
         function checkContext(node, decoratorName) {
             const expectedOrder = orderConfig[decoratorName];

package/dist/rules/sort-lifecycle-methods.js

@@ -15,8 +15,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
         messages: {
             lifecycleMethodsNotSorted: `Lifecycle Methods are not declared in order of execution`,
         },
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         const isBefore = (method1, method2) => {
             const methodIndex1 = utils_1.ASTUtils.angularLifecycleMethodsOrdered.indexOf(utils_1.ASTUtils.getMethodName(method1));

package/dist/rules/use-component-selector.js

@@ -16,8 +16,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
         messages: {
             useComponentSelector: 'The selector of the component is mandatory',
         },
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         return {
             [utils_1.Selectors.COMPONENT_CLASS_DECORATOR](node) {

package/dist/rules/use-component-view-encapsulation.js

@@ -18,8 +18,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
             useComponentViewEncapsulation: `Using \`${VIEW_ENCAPSULATION_NONE}\` makes your styles global, which may have an unintended effect`,
             suggestRemoveViewEncapsulationNone: `Remove \`${VIEW_ENCAPSULATION_NONE}\``,
         },
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         const sourceCode = context.sourceCode;
         return {

package/dist/rules/use-injectable-provided-in.d.ts

@@ -1,6 +1,9 @@
-export type Options = [{
-    readonly ignoreClassNamePattern?: string;
-}];
+export type Options = [
+    {
+        readonly ignoreClassNamePattern?: string;
+        readonly allowProvidedInNull?: boolean;
+    }
+];
 export type MessageIds = 'useInjectableProvidedIn' | 'suggestInjector';
 export declare const RULE_NAME = "use-injectable-provided-in";
 declare const _default: import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageIds, Options, import("../utils/create-eslint-rule").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {

package/dist/rules/use-injectable-provided-in.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-injectable-provided-in.d.ts","sourceRoot":"","sources":["../../src/rules/use-injectable-provided-in.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,CAAC;IAAE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACrE,MAAM,MAAM,UAAU,GAAG,yBAAyB,GAAG,iBAAiB,CAAC;AACvE,eAAO,MAAM,SAAS,+BAA+B,CAAC;;;;AAGtD,wBA2DG;AAEH,eAAO,MAAM,mBAAmB;;CAE/B,CAAC"}
+{"version":3,"file":"use-injectable-provided-in.d.ts","sourceRoot":"","sources":["../../src/rules/use-injectable-provided-in.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG;IACpB;QACE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;QACzC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;KACxC;CACF,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,yBAAyB,GAAG,iBAAiB,CAAC;AACvE,eAAO,MAAM,SAAS,+BAA+B,CAAC;;;;AAMtD,wBAiEG;AAEH,eAAO,MAAM,mBAAmB;;CAE/B,CAAC"}

package/dist/rules/use-injectable-provided-in.js

@@ -5,6 +5,9 @@ const utils_1 = require("@angular-eslint/utils");
 const create_eslint_rule_1 = require("../utils/create-eslint-rule");
 exports.RULE_NAME = 'use-injectable-provided-in';
 const METADATA_PROPERTY_NAME = 'providedIn';
+const DEFAULT_OPTIONS = {
+    allowProvidedInNull: false,
+};
 exports.default = (0, create_eslint_rule_1.createESLintRule)({
     name: exports.RULE_NAME,
     meta: {
@@ -20,6 +23,10 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
                     ignoreClassNamePattern: {
                         type: 'string',
                     },
+                    allowProvidedInNull: {
+                        type: 'boolean',
+                        default: DEFAULT_OPTIONS.allowProvidedInNull,
+                    },
                 },
                 additionalProperties: false,
             },
@@ -28,16 +35,18 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
             useInjectableProvidedIn: `The \`${METADATA_PROPERTY_NAME}\` property is mandatory for \`Injectables\``,
             suggestInjector: `Use \`${METADATA_PROPERTY_NAME}: '{{injector}}'\``,
         },
+        defaultOptions: [DEFAULT_OPTIONS],
     },
-    defaultOptions: [{}],
-    create(context, [{ ignoreClassNamePattern }]) {
+    create(context, [{ ignoreClassNamePattern, allowProvidedInNull }]) {
         const injectableClassDecorator = `ClassDeclaration:not([id.name=${ignoreClassNamePattern}]):not(:has(TSClassImplements:matches([expression.property.name='HttpInterceptor'], [expression.name='HttpInterceptor']))) > Decorator[expression.callee.name="Injectable"]`;
         const providedInMetadataProperty = utils_1.Selectors.metadataProperty(METADATA_PROPERTY_NAME);
         const withoutProvidedInDecorator = `${injectableClassDecorator}:matches([expression.arguments.length=0], [expression.arguments.0.type='ObjectExpression']:not(:has(${providedInMetadataProperty})))`;
-        const nullableProvidedInProperty = `${injectableClassDecorator} ${providedInMetadataProperty}:matches([value.type='Identifier'][value.name='undefined'], [value.type='Literal'][value.raw='null'])`;
+        const undefinedProvidedInProperty = `${injectableClassDecorator} ${providedInMetadataProperty}[value.type='Identifier'][value.name='undefined']`;
+        const nullProvidedInProperty = `${injectableClassDecorator} ${providedInMetadataProperty}[value.type='Literal'][value.raw='null']`;
         const selectors = [
             withoutProvidedInDecorator,
-            nullableProvidedInProperty,
+            undefinedProvidedInProperty,
+            ...(allowProvidedInNull ? [] : [nullProvidedInProperty]),
         ].join(',');
         return {
             [selectors](node) {
@@ -59,5 +68,5 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
     },
 });
 exports.RULE_DOCS_EXTENSION = {
-    rationale: `Using 'providedIn' in the @Injectable() decorator (like '@Injectable({ providedIn: "root" })') enables tree-shaking, which means Angular can remove the service from your production bundle if it's never actually used. Without 'providedIn', services must be registered in a module's providers array, and Angular must include them in the bundle even if they're unused. This can significantly increase bundle size. Additionally, 'providedIn' makes services easier to use (no need to add them to module providers) and makes circular dependencies less likely. The 'providedIn' syntax is the modern, recommended way to provide services.`,
+    rationale: `Using 'providedIn' in the @Injectable() decorator (like '@Injectable({ providedIn: "root" })') enables tree-shaking, which means Angular can remove the service from your production bundle if it's never actually used. Without 'providedIn', services must be registered in a module's providers array, and Angular must include them in the bundle even if they're unused. This can significantly increase bundle size. Additionally, 'providedIn' makes services easier to use (no need to add them to module providers) and makes circular dependencies less likely. The 'providedIn' syntax is the modern, recommended way to provide services. Angular treats 'providedIn: null' as equivalent to omitting the property, so it is flagged by default. Set 'allowProvidedInNull' to true if you need to permit this pattern.`,
 };

package/dist/rules/use-lifecycle-interface.js

@@ -17,8 +17,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
             useLifecycleInterface: `Lifecycle interface '{{interfaceName}}' should be implemented for method '{{methodName}}'. (${STYLE_GUIDE_LINK})`,
         },
         fixable: 'code',
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         const angularLifecycleMethodsPattern = (0, utils_1.toPattern)([
             ...utils_1.ASTUtils.ANGULAR_LIFECYCLE_METHODS,

package/dist/rules/use-pipe-transform-interface.js

@@ -18,8 +18,8 @@ exports.default = (0, create_eslint_rule_1.createESLintRule)({
         messages: {
             usePipeTransformInterface: `Pipes should implement \`${PIPE_TRANSFORM}\` interface`,
         },
+        defaultOptions: [],
     },
-    defaultOptions: [],
     create(context) {
         return {
             [`ClassDeclaration:not(:has(TSClassImplements:matches([expression.name='${PIPE_TRANSFORM}'], [expression.property.name='${PIPE_TRANSFORM}']))) > Decorator[expression.callee.name='Pipe']`]({ parent: classDeclaration, }) {

package/dist/utils/create-eslint-rule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-eslint-rule.d.ts","sourceRoot":"","sources":["../../src/utils/create-eslint-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiCD,eAAO,MAAM,gBAAgB;;CAG5B,CAAC"}
+{"version":3,"file":"create-eslint-rule.d.ts","sourceRoot":"","sources":["../../src/utils/create-eslint-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB;;CAG5B,CAAC"}

package/dist/utils/create-eslint-rule.js

@@ -2,27 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createESLintRule = void 0;
 const utils_1 = require("@typescript-eslint/utils");
-/**
- * We need to patch the RuleCreator in order to preserve the defaultOptions
- * to use as part of documentation generation.
- */
-const patchedRuleCreator = (urlCreator) => {
-    return function createRule({ name, meta, defaultOptions, create }) {
-        const resolvedDefaultOptions = (defaultOptions ?? []);
-        return {
-            name,
-            meta: Object.assign(Object.assign({}, meta), {
-                docs: Object.assign(Object.assign({}, meta.docs), {
-                    url: urlCreator(name),
-                }),
-            }),
-            defaultOptions: resolvedDefaultOptions,
-            create(context) {
-                const optionsWithDefault = utils_1.ESLintUtils.applyDefault(resolvedDefaultOptions, context.options);
-                return create(context, optionsWithDefault);
-            },
-        };
-    };
-};
-patchedRuleCreator.withoutDocs = utils_1.ESLintUtils.RuleCreator.withoutDocs;
-exports.createESLintRule = patchedRuleCreator((ruleName) => `https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/${ruleName}.md`);
+exports.createESLintRule = utils_1.ESLintUtils.RuleCreator((ruleName) => `https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/${ruleName}.md`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@depup/angular-eslint__eslint-plugin",
-  "version": "22.1.0-depup.1",
+  "version": "22.3.0-depup.0",
   "description": "ESLint plugin for Angular applications, following https://angular.dev/style-guide (with updated dependencies)",
   "license": "MIT",
   "main": "dist/index.js",
@@ -20,12 +20,12 @@
     "changes.json"
   ],
   "dependencies": {
-    "ts-api-utils": "^2.5.0",
-    "@angular-eslint/bundled-angular-compiler": "22.1.0",
-    "@angular-eslint/utils": "22.1.0"
+    "@angular-eslint/bundled-angular-compiler": "22.3.0",
+    "@angular-eslint/utils": "22.3.0",
+    "ts-api-utils": "^2.5.0"
   },
   "devDependencies": {
-    "@angular-eslint/test-utils": "22.1.0"
+    "@angular-eslint/test-utils": "22.3.0"
   },
   "peerDependencies": {
     "@typescript-eslint/utils": "^8.0.0",
@@ -50,8 +50,8 @@
     },
     "depsUpdated": 1,
     "originalPackage": "@angular-eslint/eslint-plugin",
-    "originalVersion": "22.1.0",
-    "processedAt": "2026-07-21T19:24:01.669Z",
+    "originalVersion": "22.3.0",
+    "processedAt": "2026-09-07T08:13:08.078Z",
     "smokeTest": "passed"
   }
 }