eslint-plugin-sonarjs 4.0.2 → 4.1.0

package/cjs/S124/meta.js

@@ -17,11 +17,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.schema = exports.eslintId = exports.implementation = void 0;
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of

package/cjs/S124/rule.js

@@ -1,11 +1,11 @@
 "use strict";
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of

package/cjs/{S2255 → S1244}/generated-meta.js

@@ -1,11 +1,11 @@
 "use strict";
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -15,7 +15,7 @@
  * You should have received a copy of the Sonar Source-Available License
  * along with this program; if not, see https://sonarsource.com/license/ssal/
  */
-// https://sonarsource.github.io/rspec/#/rspec/S2255/javascript
+// https://sonarsource.github.io/rspec/#/rspec/S1244/javascript
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -31,21 +31,22 @@ 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 });
-exports.requiredDependency = exports.languages = exports.scope = exports.sonarKey = exports.meta = void 0;
+exports.skipOnGeneratedSource = exports.requiredDependency = exports.languages = exports.scope = exports.sonarKey = exports.meta = void 0;
 __exportStar(require("./meta.js"), exports);
 exports.meta = {
     type: 'problem',
     docs: {
-        description: 'Writing cookies is security-sensitive',
-        recommended: false,
-        url: 'https://sonarsource.github.io/rspec/#/rspec/S2255/javascript',
+        description: 'Floating point numbers should not be tested for equality',
+        recommended: true,
+        url: 'https://sonarsource.github.io/rspec/#/rspec/S1244/javascript',
         requiresTypeChecking: false,
     },
     fixable: undefined,
-    deprecated: true,
+    deprecated: false,
     defaultOptions: [],
 };
-exports.sonarKey = 'S2255';
+exports.sonarKey = 'S1244';
 exports.scope = 'Main';
 exports.languages = ['js', 'ts'];
 exports.requiredDependency = [];
+exports.skipOnGeneratedSource = false;

package/cjs/{S4784 → S1244}/index.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.rule = void 0;
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of

package/cjs/{S4817 → S1244}/meta.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.eslintId = exports.implementation = void 0;
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -18,4 +18,4 @@ exports.eslintId = exports.implementation = void 0;
  * along with this program; if not, see https://sonarsource.com/license/ssal/
  */
 exports.implementation = 'original';
-exports.eslintId = 'xpath';
+exports.eslintId = 'no-floating-point-equality';

package/cjs/S1244/rule.js

@@ -0,0 +1,265 @@
+"use strict";
+/*
+ * SonarQube JavaScript Plugin
+ * Copyright (C) SonarSource Sàrl
+ * mailto:info AT sonarsource DOT com
+ *
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the Sonar Source-Available License for more details.
+ *
+ * You should have received a copy of the Sonar Source-Available License
+ * along with this program; if not, see https://sonarsource.com/license/ssal/
+ */
+// https://sonarsource.github.io/rspec/#/rspec/S1244/javascript
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rule = void 0;
+const generate_meta_js_1 = require("../helpers/generate-meta.js");
+const ast_js_1 = require("../helpers/ast.js");
+const equivalence_js_1 = require("../helpers/equivalence.js");
+const assertions_js_1 = require("../helpers/assertions.js");
+const numbers_js_1 = require("../helpers/numbers.js");
+const meta = __importStar(require("./generated-meta.js"));
+const equalityOperators = new Set(['===', '!==', '==', '!=']);
+const arithmeticOperators = new Set(['+', '-', '*', '%', '**']);
+const constantArithmeticOperators = new Set(['+', '-', '*', '/', '%', '**']);
+const indirectEqualityOperators = new Set(['<=', '>=']);
+const indirectInequalityOperators = new Set(['<', '>']);
+exports.rule = {
+    meta: (0, generate_meta_js_1.generateMeta)(meta, {
+        messages: {
+            noExactFloatEquality: 'Do not check floating point equality or inequality with exact values, use a range instead.',
+        },
+    }),
+    create(context) {
+        function report(node) {
+            context.report({
+                messageId: 'noExactFloatEquality',
+                node,
+            });
+        }
+        function isFloatingPointSensitive(node) {
+            return isFloatingPointExpression(context, node, new Set());
+        }
+        function shouldReportComparison(node) {
+            return (equalityOperators.has(node.operator) &&
+                (isFloatingPointSensitive(node.left) || isFloatingPointSensitive(node.right)));
+        }
+        return {
+            BinaryExpression(node) {
+                const binaryExpression = node;
+                if (shouldReportComparison(binaryExpression)) {
+                    report(binaryExpression);
+                }
+            },
+            LogicalExpression(node) {
+                const logicalExpression = node;
+                if (isIndirectExactComparison(context, logicalExpression, isFloatingPointSensitive)) {
+                    report(logicalExpression);
+                }
+            },
+            CallExpression(node) {
+                const assertion = (0, assertions_js_1.extractTestAssertion)(context, node);
+                if (assertion?.kind === 'comparison' &&
+                    (isFloatingPointSensitive(assertion.actual) ||
+                        isFloatingPointSensitive(assertion.expected))) {
+                    report(assertion.reportNode);
+                }
+            },
+            SwitchCase(node) {
+                const { test } = node;
+                if (test && isFloatingPointSensitive(test)) {
+                    report(test);
+                }
+            },
+        };
+    },
+};
+function isFloatingPointLiteral(node) {
+    const raw = String(node.raw).replaceAll('_', '').toLowerCase();
+    if (!raw.includes('.') && !raw.includes('e')) {
+        return false;
+    }
+    if (!/^\d*(?:\.\d*)?(?:e[+-]?\d+)?$/u.test(raw)) {
+        return false;
+    }
+    return !(0, numbers_js_1.isExactlyRepresentableAsBinaryFraction)(raw);
+}
+function isFractionProducingDivision(node) {
+    const leftValue = numericLiteralValue(node.left);
+    const rightValue = numericLiteralValue(node.right);
+    if (leftValue === null || rightValue === null || rightValue === 0) {
+        return false;
+    }
+    const result = leftValue / rightValue;
+    return (Number.isInteger(leftValue) &&
+        !Number.isInteger(result) &&
+        !(0, numbers_js_1.isExactlyRepresentableIntegerDivision)(leftValue, rightValue));
+}
+function numericLiteralValue(node) {
+    if ((0, ast_js_1.isNumberLiteral)(node)) {
+        return node.value;
+    }
+    if (node.type === 'UnaryExpression' &&
+        (node.operator === '+' || node.operator === '-') &&
+        (0, ast_js_1.isNumberLiteral)(node.argument)) {
+        return node.operator === '-' ? -node.argument.value : node.argument.value;
+    }
+    return null;
+}
+function numericExpressionValue(node) {
+    const literalValue = numericLiteralValue(node);
+    if (literalValue !== null) {
+        return literalValue;
+    }
+    if (node.type !== 'BinaryExpression' || !constantArithmeticOperators.has(node.operator)) {
+        return null;
+    }
+    const leftValue = numericExpressionValue(node.left);
+    const rightValue = numericExpressionValue(node.right);
+    if (leftValue === null || rightValue === null) {
+        return null;
+    }
+    switch (node.operator) {
+        case '+':
+            return leftValue + rightValue;
+        case '-':
+            return leftValue - rightValue;
+        case '*':
+            return leftValue * rightValue;
+        case '/':
+            return rightValue === 0 ? null : leftValue / rightValue;
+        case '%':
+            return rightValue === 0 ? null : leftValue % rightValue;
+        case '**':
+            return leftValue ** rightValue;
+        default:
+            return null;
+    }
+}
+function isFloatingPointConst(context, node, visitedVariables) {
+    const variable = (0, ast_js_1.getVariableFromName)(context, node.name, node);
+    if (!variable || visitedVariables.has(variable)) {
+        return false;
+    }
+    const definition = variable.defs[0];
+    if (definition?.type !== 'Variable' || definition.node.type !== 'VariableDeclarator') {
+        return false;
+    }
+    const declaration = definition.parent;
+    if (declaration?.type !== 'VariableDeclaration' ||
+        declaration.kind !== 'const' ||
+        definition.node.id.type !== 'Identifier' ||
+        !definition.node.init) {
+        return false;
+    }
+    visitedVariables.add(variable);
+    return isFloatingPointExpression(context, definition.node.init, visitedVariables);
+}
+function isFloatingPointExpression(context, node, visitedVariables) {
+    if ((0, ast_js_1.isNumberLiteral)(node)) {
+        return isFloatingPointLiteral(node);
+    }
+    if (node.type === 'UnaryExpression') {
+        return (['+', '-'].includes(node.operator) &&
+            isFloatingPointExpression(context, node.argument, visitedVariables));
+    }
+    if (node.type === 'BinaryExpression') {
+        const numericValue = numericExpressionValue(node);
+        if (numericValue !== null && Number.isSafeInteger(numericValue)) {
+            return false;
+        }
+        if (node.operator === '/') {
+            return (isFloatingPointExpression(context, node.left, visitedVariables) ||
+                isFloatingPointExpression(context, node.right, visitedVariables) ||
+                isFractionProducingDivision(node));
+        }
+        return (arithmeticOperators.has(node.operator) &&
+            (isFloatingPointExpression(context, node.left, visitedVariables) ||
+                isFloatingPointExpression(context, node.right, visitedVariables)));
+    }
+    return (0, ast_js_1.isIdentifier)(node) && isFloatingPointConst(context, node, visitedVariables);
+}
+function isIndirectExactComparison(context, node, isFloatingPointSensitive) {
+    const acceptedOperators = acceptedIndirectOperators(node.operator);
+    const { left: leftComparison, right: rightComparison } = node;
+    if (!acceptedOperators ||
+        !isAcceptedComparison(leftComparison, acceptedOperators) ||
+        !isAcceptedComparison(rightComparison, acceptedOperators)) {
+        return false;
+    }
+    return comparisonOrientations(leftComparison).some(left => comparisonOrientations(rightComparison).some(right => left.isAbove !== right.isAbove &&
+        (0, equivalence_js_1.areEquivalent)(left.expression, right.expression, context.sourceCode) &&
+        (0, equivalence_js_1.areEquivalent)(left.threshold, right.threshold, context.sourceCode) &&
+        (isFloatingPointSensitive(left.expression) || isFloatingPointSensitive(left.threshold))));
+}
+function acceptedIndirectOperators(operator) {
+    // && of two <=/>= comparisons collapses to equality; || of two strict </> comparisons
+    // asserts inequality. Keep operator sets, this mapping, and comparisonOrientations in sync.
+    if (operator === '&&') {
+        return indirectEqualityOperators;
+    }
+    if (operator === '||') {
+        return indirectInequalityOperators;
+    }
+    return null;
+}
+function isAcceptedComparison(node, acceptedOperators) {
+    return node.type === 'BinaryExpression' && acceptedOperators.has(node.operator);
+}
+function comparisonOrientations(node) {
+    const { left, right } = node;
+    switch (node.operator) {
+        case '<':
+        case '<=':
+            return [
+                { expression: left, threshold: right, isAbove: false },
+                { expression: right, threshold: left, isAbove: true },
+            ];
+        case '>':
+        case '>=':
+            return [
+                { expression: left, threshold: right, isAbove: true },
+                { expression: right, threshold: left, isAbove: false },
+            ];
+        default:
+            return [];
+    }
+}

package/cjs/S125/generated-meta.js

@@ -1,11 +1,11 @@
 "use strict";
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -31,13 +31,13 @@ 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 });
-exports.requiredDependency = exports.languages = exports.scope = exports.sonarKey = exports.meta = void 0;
+exports.skipOnGeneratedSource = exports.requiredDependency = exports.languages = exports.scope = exports.sonarKey = exports.meta = void 0;
 __exportStar(require("./meta.js"), exports);
 exports.meta = {
     type: 'suggestion',
     docs: {
         description: 'Sections of code should not be commented out',
-        recommended: true,
+        recommended: false,
         url: 'https://sonarsource.github.io/rspec/#/rspec/S125/javascript',
         requiresTypeChecking: false,
     },
@@ -49,3 +49,4 @@ exports.sonarKey = 'S125';
 exports.scope = 'Main';
 exports.languages = ['js', 'ts'];
 exports.requiredDependency = [];
+exports.skipOnGeneratedSource = true;

package/cjs/S125/index.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.rule = void 0;
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of

package/cjs/S125/meta.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.eslintId = exports.implementation = void 0;
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of

package/cjs/S125/rule.js

@@ -1,11 +1,11 @@
 "use strict";
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -61,9 +61,13 @@ const CodeRecognizer_js_1 = require("../helpers/recognizers/CodeRecognizer.js");
 const JavaScriptFootPrint_js_1 = require("../helpers/recognizers/JavaScriptFootPrint.js");
 const node_path_1 = __importDefault(require("node:path"));
 const EXCLUDED_STATEMENTS = new Set(['BreakStatement', 'LabeledStatement', 'ContinueStatement']);
+// Documentation example prefixes that indicate a comment is an intentional usage example,
+// not commented-out dead code (e.g. "e.g. foo()", "example: bar()").
+const DOCUMENTATION_PREFIX_PATTERN = /^(e\.g[.:]|for example\b|examples?:)/i;
 // Cheap prefilter: any meaningful JS statement must contain at least one of these characters,
 // or be an import/export with a string literal (side-effect imports have no punctuation)
 const CODE_CHAR_PATTERN = /[;{}()=<>]|\bimport\s+['"]|\bexport\s/;
+const JSX_ATTRIBUTE_WRAPPER = '_S125Wrapper';
 const recognizer = new CodeRecognizer_js_1.CodeRecognizer(0.9, new JavaScriptFootPrint_js_1.JavaScriptFootPrint());
 exports.rule = {
     meta: (0, generate_meta_js_1.generateMeta)(meta, {
@@ -115,6 +119,7 @@ exports.rule = {
                 for (const groupComment of groupedComments) {
                     const rawTextTrimmed = groupComment.value.trim();
                     if (rawTextTrimmed !== '}' &&
+                        !isDocumentationExample(rawTextTrimmed) &&
                         containsCode(injectMissingBraces(rawTextTrimmed), context)) {
                         context.report({
                             messageId: 'commentedCode',
@@ -166,22 +171,20 @@ function containsCode(value, context) {
     if (!CODE_CHAR_PATTERN.test(value) || !couldBeJsCode(value) || !context.languageOptions.parser) {
         return false;
     }
-    try {
-        const options = {
-            ...context.languageOptions?.parserOptions,
-            filePath: `placeholder${node_path_1.default.extname(context.filename)}`,
-            programs: undefined,
-            project: undefined,
-        };
-        //In case of Vue parser: we will use the JS/TS parser instead of the Vue parser
-        const parser = context.languageOptions?.parserOptions?.parser ?? context.languageOptions?.parser;
-        const result = 'parse' in parser ? parser.parse(value, options) : parser.parseForESLint(value, options).ast;
-        const program = result;
+    const options = {
+        ...context.languageOptions?.parserOptions,
+        filePath: `placeholder${node_path_1.default.extname(context.filename)}`,
+        programs: undefined,
+        project: undefined,
+    };
+    //In case of Vue parser: we will use the JS/TS parser instead of the Vue parser
+    const parser = context.languageOptions?.parserOptions?.parser ?? context.languageOptions?.parser;
+    const program = parseWithRuleParser(value, parser, options);
+    if (program) {
         return program.body.length > 0 && !isExclusion(program.body, value, program, context);
     }
-    catch {
-        return false;
-    }
+    const wrappedProgram = parseWithRuleParser(wrapAsJsxTag(value), parser, options);
+    return hasValidJsxAttributeCode(wrappedProgram);
 }
 function couldBeJsCode(input) {
     return input.split('\n').some(line => recognizer.recognition(line) >= recognizer.threshold);
@@ -189,11 +192,11 @@ function couldBeJsCode(input) {
 function injectMissingBraces(value) {
     let balance = 0;
     let minBalance = 0;
-    for (let i = 0; i < value.length; i++) {
-        if (value[i] === '{') {
+    for (const char of value) {
+        if (char === '{') {
             balance++;
         }
-        else if (value[i] === '}') {
+        else if (char === '}') {
             balance--;
             if (balance < minBalance) {
                 minBalance = balance;
@@ -229,3 +232,47 @@ function isExcludedLiteral(expression) {
     }
     return false;
 }
+function isDocumentationExample(value) {
+    const firstLine = value.split('\n')[0];
+    // Strip any leading '//' markers (e.g. '// foo()' in a nested comment becomes 'foo()')
+    const stripped = firstLine.replace(/^(?:\/\/\s*)+/, '').trim();
+    return DOCUMENTATION_PREFIX_PATTERN.test(stripped);
+}
+function parseWithRuleParser(value, parser, options) {
+    try {
+        return ('parse' in parser ? parser.parse(value, options) : parser.parseForESLint(value, options).ast);
+    }
+    catch {
+        return null;
+    }
+}
+function wrapAsJsxTag(value) {
+    return `<${JSX_ATTRIBUTE_WRAPPER} ${value} />`;
+}
+function hasValidJsxAttributeCode(program) {
+    if (program?.body.length !== 1) {
+        return false;
+    }
+    const statement = program.body[0];
+    if (statement.type !== 'ExpressionStatement' || statement.expression.type !== 'JSXElement') {
+        return false;
+    }
+    const jsxElement = statement.expression;
+    if (jsxElement.openingElement.name.type !== 'JSXIdentifier') {
+        return false;
+    }
+    if (jsxElement.openingElement.name.name !== JSX_ATTRIBUTE_WRAPPER) {
+        return false;
+    }
+    const attributes = jsxElement.openingElement.attributes;
+    return attributes.length > 0 && attributes.every(isValidJsxAttribute);
+}
+function isValidJsxAttribute(attribute) {
+    if (attribute.type === 'JSXSpreadAttribute') {
+        return true;
+    }
+    if (attribute.name.type !== 'JSXIdentifier') {
+        return false;
+    }
+    return attribute.value !== null;
+}

package/cjs/S126/generated-meta.js

@@ -1,11 +1,11 @@
 "use strict";
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -31,7 +31,7 @@ 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 });
-exports.requiredDependency = exports.languages = exports.scope = exports.sonarKey = exports.meta = void 0;
+exports.skipOnGeneratedSource = exports.requiredDependency = exports.languages = exports.scope = exports.sonarKey = exports.meta = void 0;
 __exportStar(require("./meta.js"), exports);
 exports.meta = {
     type: 'suggestion',
@@ -49,3 +49,4 @@ exports.sonarKey = 'S126';
 exports.scope = 'Main';
 exports.languages = ['js', 'ts'];
 exports.requiredDependency = [];
+exports.skipOnGeneratedSource = false;

package/cjs/S126/index.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.rule = void 0;
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of

package/cjs/S126/meta.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.eslintId = exports.implementation = void 0;
 /*
  * SonarQube JavaScript Plugin
- * Copyright (C) 2011-2025 SonarSource Sàrl
+ * Copyright (C) SonarSource Sàrl
  * mailto:info AT sonarsource DOT com
  *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ * You can redistribute and/or modify this program under the terms of
+ * the Sonar Source-Available License Version 1, as published by SonarSource Sàrl.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of