@adguard/agtree 4.0.1 → 4.0.3

package/dist/converter/base-interfaces/conversion-result.js

@@ -1,20 +1,22 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 /**
- * @file Conversion result interface and helper functions
+ * @file Conversion result interface and helper functions.
  */
 /**
  * Helper function to create a generic conversion result.
  *
- * @param result Conversion result
- * @param isConverted Indicates whether the input item was converted
- * @template T Type of the item to convert
- * @template U Type of the conversion result (defaults to `T`, but can be `T[]` as well)
- * @returns Generic conversion result
+ * @template T Type of the item to convert.
+ * @template U Type of the conversion result (defaults to `T`, but can be `T[]` as well).
+ *
+ * @param result Conversion result.
+ * @param isConverted Indicates whether the input item was converted.
+ *
+ * @returns Generic conversion result.
  */
 // eslint-disable-next-line max-len
 function createConversionResult(result, isConverted) {
@@ -26,10 +28,12 @@ function createConversionResult(result, isConverted) {
 /**
  * Helper function to create a node conversion result.
  *
- * @param nodes Array of nodes
- * @param isConverted Indicates whether the input item was converted
- * @template T Type of the node (extends `Node`)
- * @returns Node conversion result
+ * @template T Type of the node (extends `Node`).
+ *
+ * @param nodes Array of nodes.
+ * @param isConverted Indicates whether the input item was converted.
+ *
+ * @returns Node conversion result.
  */
 function createNodeConversionResult(nodes, isConverted) {
     return createConversionResult(nodes, isConverted);

package/dist/converter/base-interfaces/rule-converter-base.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -8,25 +8,27 @@ import { NotImplementedError } from '../../errors/not-implemented-error.js';
 import { BaseConverter } from './base-converter.js';
 
 /**
- * @file Base class for rule converters
+ * @file Base class for rule converters.
  *
  * TS doesn't support abstract static methods, so we should use
- * a workaround and extend this class instead of implementing it
+ * a workaround and extend this class instead of implementing it.
  */
 /* eslint-disable jsdoc/require-returns-check */
 /* eslint-disable @typescript-eslint/no-unused-vars */
 /**
- * Basic class for rule converters
+ * Basic class for rule converters.
  */
 class RuleConverterBase extends BaseConverter {
     /**
      * Converts an adblock filtering rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         throw new NotImplementedError();
@@ -34,11 +36,13 @@ class RuleConverterBase extends BaseConverter {
     /**
      * Converts an adblock filtering rule to Adblock Plus format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAbp(rule) {
         throw new NotImplementedError();
@@ -46,11 +50,13 @@ class RuleConverterBase extends BaseConverter {
     /**
      * Converts an adblock filtering rule to uBlock Origin format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToUbo(rule) {
         throw new NotImplementedError();

package/dist/converter/comment/index.js

@@ -1,32 +1,34 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { CommentRuleType, CommentMarker } from '../../nodes/index.js';
-import { SPACE } from '../../utils/constants.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { clone } from '../../utils/clone.js';
+import { SPACE } from '../../utils/constants.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 
 /**
- * @file Comment rule converter
+ * @file Comment rule converter.
  */
 /**
- * Comment rule converter class
+ * Comment rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class CommentRuleConverter extends RuleConverterBase {
     /**
      * Converts a comment rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         // TODO: Add support for other comment types, if needed

package/dist/converter/cosmetic/css.js

@@ -1,34 +1,36 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { CosmeticRuleSeparator } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { CssSelectorConverter } from '../css/index.js';
+import { CssTokenStream } from '../../parser/css/css-token-stream.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { clone } from '../../utils/clone.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { CssTokenStream } from '../../parser/css/css-token-stream.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
+import { CssSelectorConverter } from '../css/index.js';
 
 /**
- * @file CSS injection rule converter
+ * @file CSS injection rule converter.
  */
 /**
- * CSS injection rule converter class
+ * CSS injection rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class CssInjectionRuleConverter extends RuleConverterBase {
     /**
      * Converts a CSS injection rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         const separator = rule.separator.value;

package/dist/converter/cosmetic/element-hiding.js

@@ -1,34 +1,36 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { CosmeticRuleSeparator } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { CssSelectorConverter } from '../css/index.js';
+import { CssTokenStream } from '../../parser/css/css-token-stream.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { clone } from '../../utils/clone.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { CssTokenStream } from '../../parser/css/css-token-stream.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
+import { CssSelectorConverter } from '../css/index.js';
 
 /**
- * @file Element hiding rule converter
+ * @file Element hiding rule converter.
  */
 /**
- * Element hiding rule converter class
+ * Element hiding rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class ElementHidingRuleConverter extends RuleConverterBase {
     /**
      * Converts an element hiding rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         const separator = rule.separator.value;

package/dist/converter/cosmetic/header-removal.js

@@ -1,42 +1,45 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
+import { createModifierListNode, createModifierNode } from '../../ast-utils/modifiers.js';
+import { createNetworkRuleNode } from '../../ast-utils/network-rules.js';
+import { isUboResponseHeaderRemovalRuleBody } from '../../common/ubo-html-filtering-body-common.js';
 import { RuleConversionError } from '../../errors/rule-conversion-error.js';
 import { RuleCategory, CosmeticRuleType } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { createModifierListNode, createModifierNode } from '../../ast-utils/modifiers.js';
+import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
 import { EMPTY } from '../../utils/constants.js';
 import { ADBLOCK_URL_START, ADBLOCK_URL_SEPARATOR } from '../../utils/regexp.js';
-import { createNetworkRuleNode } from '../../ast-utils/network-rules.js';
-import { AdblockSyntax } from '../../utils/adblockers.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { isUboResponseHeaderRemovalRuleBody } from '../../common/ubo-html-filtering-body-common.js';
-import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 
 /**
- * @file Converter for request header removal rules
+ * @file Converter for request header removal rules.
  */
 const ADG_REMOVEHEADER_MODIFIER = 'removeheader';
 const ERROR_MESSAGES = {
     MULTIPLE_DOMAINS_NOT_SUPPORTED: 'Multiple domains are not supported yet',
 };
 /**
- * Converter for request header removal rules
+ * Converter for request header removal rules.
  *
- * @todo Implement `convertToUbo` (ABP currently doesn't support header removal rules)
+ * @todo Implement `convertToUbo` (ABP currently doesn't support header removal rules).
  */
 class HeaderRemovalRuleConverter extends RuleConverterBase {
     /**
      * Converts a header removal rule to AdGuard syntax, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
+     *
      * @example
      * If the input rule is:
      * ```adblock

package/dist/converter/cosmetic/html.js

@@ -1,25 +1,25 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { sprintf } from 'sprintf-js';
+import { cloneDomainListNode } from '../../ast-utils/clone.js';
+import { RuleConversionError } from '../../errors/rule-conversion-error.js';
+import { AdgHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/adg-html-filtering-body-generator.js';
+import { UboHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/ubo-html-filtering-body-generator.js';
 import { CosmeticRuleSeparator, CosmeticRuleType, RuleCategory } from '../../nodes/index.js';
+import { AdgHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/adg-html-filtering-body-parser.js';
+import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
-import { RuleConversionError } from '../../errors/rule-conversion-error.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { cloneDomainListNode } from '../../ast-utils/clone.js';
 import { EMPTY, EQUALS } from '../../utils/constants.js';
 import { RegExpUtils } from '../../utils/regexp.js';
-import { AdgHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/adg-html-filtering-body-parser.js';
-import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
-import { AdgHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/adg-html-filtering-body-generator.js';
-import { UboHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/ubo-html-filtering-body-generator.js';
+import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 
 /**
- * @file HTML filtering rule converter
+ * @file HTML filtering rule converter.
  */
 /**
  * From the AdGuard docs:
@@ -109,9 +109,9 @@ const ERROR_MESSAGES = {
     SPECIAL_PSEUDO_CLASS_SELECTOR_NOT_SUPPORTED: "Special pseudo-class selector '%s' is not supported in conversion",
 };
 /**
- * HTML filtering rule converter class
+ * HTML filtering rule converter class.
  *
- * @todo Implement `convertToUbo` (ABP currently doesn't support HTML filtering rules)
+ * @todo Implement `convertToUbo` (ABP currently doesn't support HTML filtering rules).
  */
 class HtmlRuleConverter extends RuleConverterBase {
     /**
@@ -138,7 +138,7 @@ class HtmlRuleConverter extends RuleConverterBase {
                  * Mark rule as converted in ADG -> ADG conversion only if
                  * special attribute selectors are present in the rule body,
                  * because they are deprecated and will be removed soon,
-                 * so we convert them to pseudo-class selectors
+                 * so we convert them to pseudo-class selectors.
                  */
                 isConverted = true;
                 return HtmlRuleConverter.convertSpecialAttributeSelectorAdgToAdg(name, value);
@@ -158,7 +158,7 @@ class HtmlRuleConverter extends RuleConverterBase {
             throw new RuleConversionError(ERROR_MESSAGES.ABP_NOT_SUPPORTED);
         }
         // Convert body
-        const convertedBody = HtmlRuleConverter.convertBody(rule.body, parser, AdgHtmlFilteringBodyGenerator, onSpecialAttributeSelector, onSpecialPseudoClassSelector);
+        const convertedBody = HtmlRuleConverter.convertBody(rule.body, parser, AdgHtmlFilteringBodyGenerator, onSpecialAttributeSelector, onSpecialPseudoClassSelector, rule.syntax === AdblockSyntax.Adg);
         if (!isConverted) {
             return createNodeConversionResult([rule], false);
         }
@@ -222,9 +222,9 @@ class HtmlRuleConverter extends RuleConverterBase {
      * - `[wildcard="*content*"]` -> `:contains(/*.content*./s)`
      *   convert search pattern to regular expression
      * - `[min-length="min"]` -> `:contains(/^(?=.{min,}$).*\/s)`
-     *   converts to a length-matching regular expression
+     *   converts to a length-matching regular expression.
      * - `[max-length="max"]` -> `:contains(/^(?=.{0,max}$).*\/s)`
-     *   converts to a length-matching regular expression
+     *   converts to a length-matching regular expression.
      *
      * Note: This attribute selector to pseudo-class selector conversion
      * is needed because AdGuard special attribute selectors are going
@@ -302,7 +302,7 @@ class HtmlRuleConverter extends RuleConverterBase {
      * - `:has-text(text)` -> `:contains(text)`
      *   direct conversion, no changes to argument
      * - `:min-text-length(min)` -> `:contains(/^(?=.{min,MAX_CONVERSION_DEFAULT}$).*\/s)`
-     *   converts to a length-matching regular expression
+     *   converts to a length-matching regular expression.
      *
      * @param name Name of the special pseudo-class selector.
      * @param argument Argument of the special pseudo-class selector.
@@ -345,7 +345,7 @@ class HtmlRuleConverter extends RuleConverterBase {
      *   convert search pattern to regular expression
      * - `[min-length="min"]` -> `:min-text-length(min)`
      *   direct conversion, no changes to value
-     * - `[max-length]` is skipped
+     * - `[max-length]` is skipped.
      *
      * @param name Name of the special attribute selector.
      * @param value Value of the special attribute selector.
@@ -384,7 +384,7 @@ class HtmlRuleConverter extends RuleConverterBase {
     /**
      * Handles special pseudo-class selectors during AdGuard to uBlock conversion:
      * - `:contains(text)` -> `:has-text(text)`
-     *   direct conversion, no changes to argument
+     *   direct conversion, no changes to argument.
      *
      * @param name Name of the special pseudo-class selector.
      * @param argument Argument of the special pseudo-class selector.
@@ -411,6 +411,70 @@ class HtmlRuleConverter extends RuleConverterBase {
             }
         }
     }
+    /**
+     * Pre-scans a complex selector's child selectors
+     * for {@link AdgAttributeSelectors.MinLength}
+     * and {@link AdgAttributeSelectors.MaxLength} attribute selectors.
+     *
+     * Resolves duplicates to the most *restrictive* value:
+     * - for multiple `[min-length]` selectors, the largest value is selected;
+     * - for multiple `[max-length]` selectors, the smallest value is selected.
+     *
+     * Logs a warning when duplicate length selectors are found.
+     *
+     * @param selectors Child selectors of a complex selector to scan.
+     *
+     * @returns Resolved length constraints,
+     * or `null` if no length selectors were found.
+     */
+    static collectLengthConstraints(selectors) {
+        const minValues = [];
+        const maxValues = [];
+        for (let i = 0; i < selectors.length; i += 1) {
+            const selector = selectors[i];
+            if (selector.type !== 'AttributeSelector') {
+                continue;
+            }
+            const { value: name } = selector.name;
+            if (name !== AdgAttributeSelectors.MinLength
+                && name !== AdgAttributeSelectors.MaxLength) {
+                continue;
+            }
+            if (!('value' in selector) || selector.value.value === EMPTY) {
+                continue;
+            }
+            const { value } = selector.value;
+            HtmlRuleConverter.assertValidLengthValue(name, value, ERROR_MESSAGES.SPECIAL_ATTRIBUTE_SELECTOR_VALUE_INT, ERROR_MESSAGES.SPECIAL_ATTRIBUTE_SELECTOR_VALUE_POSITIVE);
+            if (name === AdgAttributeSelectors.MinLength) {
+                minValues.push(Number(value));
+            }
+            else {
+                maxValues.push(Number(value));
+            }
+        }
+        if (minValues.length === 0 && maxValues.length === 0) {
+            return null;
+        }
+        let min = null;
+        let max = null;
+        if (minValues.length > 1) {
+            min = Math.max(...minValues);
+            // eslint-disable-next-line no-console
+            console.warn(`Multiple [min-length] selectors found among: [${minValues.join(', ')}]. Selected largest: ${min}.`);
+        }
+        else if (minValues.length === 1) {
+            [min] = minValues;
+        }
+        if (maxValues.length > 1) {
+            max = Math.min(...maxValues);
+            // eslint-disable-next-line no-console
+            console.warn(`Multiple [max-length] selectors found among: [${maxValues.join(', ')}]. Selected smallest: ${max}.`);
+        }
+        else if (maxValues.length === 1) {
+            [max] = maxValues;
+        }
+        return { min, max };
+    }
     /**
      * Converts a HTML filtering rule body by handling special simple selectors via callbacks.
      * Special simple selectors are skipped in the converted selector list and should be handled from callee.
@@ -420,10 +484,13 @@ class HtmlRuleConverter extends RuleConverterBase {
      * @param generator HTML filtering rule body generator used for generating raw value bodies.
      * @param onSpecialAttributeSelector Callback invoked when a special attribute selector is found.
      * @param onSpecialPseudoClassSelector Callback invoked when a special pseudo-class selector is found.
+     * @param shouldMergeLengthSelectors If true, `[min-length]` and `[max-length]` attribute
+     * selectors within the same complex selector are merged into a single `:contains()` pseudo-class.
+     * Defaults to `false`.
      *
      * @returns Converted selector list without special simple selectors.
      */
-    static convertBody(body, parser, generator, onSpecialAttributeSelector, onSpecialPseudoClassSelector) {
+    static convertBody(body, parser, generator, onSpecialAttributeSelector, onSpecialPseudoClassSelector, shouldMergeLengthSelectors = false) {
         // Handle case when body is raw value string.
         // If so, parse it first as we need to work with AST nodes.
         let processedBody;
@@ -445,6 +512,11 @@ class HtmlRuleConverter extends RuleConverterBase {
             const { children: selectors } = complexSelectors[i];
             // Complex selector node must not be empty
             HtmlRuleConverter.assertNotEmpty(selectors, ERROR_MESSAGES.EMPTY_COMPLEX_SELECTOR);
+            // Pre-scan for [min-length] / [max-length] constraints to merge them into one :contains()
+            const lengthConstraints = shouldMergeLengthSelectors
+                ? HtmlRuleConverter.collectLengthConstraints(selectors)
+                : null;
+            let lengthContainsEmitted = false;
             // Convert each selector
             const convertedSelectors = [];
             for (let j = 0; j < selectors.length; j += 1) {
@@ -482,6 +554,21 @@ class HtmlRuleConverter extends RuleConverterBase {
                         }
                         const name = selector.name.value;
                         const { value } = selector.value;
+                        // Merge [min-length] and [max-length] into a single :contains() (ADG→ADG)
+                        if (lengthConstraints !== null
+                            && (name === AdgAttributeSelectors.MinLength
+                                || name === AdgAttributeSelectors.MaxLength)) {
+                            if (!lengthContainsEmitted) {
+                                // Invoke the callback once to trigger its side effects
+                                // (e.g. the isConverted flag in convertToAdg), but discard
+                                // the individual :contains() it returns — we emit the
+                                // merged one instead.
+                                onSpecialAttributeSelector(name, value);
+                                convertedSelectors.push(HtmlRuleConverter.getPseudoClassSelectorNode(AdgPseudoClasses.Contains, RegExpUtils.getLengthRegexp(lengthConstraints.min, lengthConstraints.max)));
+                                lengthContainsEmitted = true;
+                            }
+                            continue;
+                        }
                         // Invoke callback and:
                         // - add returned simple selector if it's not boolean
                         // - skip adding if returned value is false

package/dist/converter/cosmetic/index.js

@@ -1,48 +1,50 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { CosmeticRuleType, RuleCategory, CosmeticRuleSeparator } from '../../nodes/index.js';
-import { AdblockSyntax } from '../../utils/adblockers.js';
-import { HtmlRuleConverter } from './html.js';
-import { ScriptletRuleConverter } from './scriptlet.js';
 import { RuleConversionError } from '../../errors/rule-conversion-error.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { AdgCosmeticRuleModifierConverter } from './rule-modifiers/adg.js';
-import { CssInjectionRuleConverter } from './css.js';
-import { ElementHidingRuleConverter } from './element-hiding.js';
-import { HeaderRemovalRuleConverter } from './header-removal.js';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { UboCosmeticRuleModifierConverter } from './rule-modifiers/ubo.js';
-import { clone } from '../../utils/clone.js';
+import { CosmeticRuleType, RuleCategory, CosmeticRuleSeparator } from '../../nodes/index.js';
 import { COMMA } from '../../utils/constants.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
 import 'tldts';
 import 'glob-to-regexp';
-import 'sprintf-js';
 import '@adguard/css-tokenizer';
+import 'sprintf-js';
 import 'json5';
-import '../../parser/css/balancing.js';
 import '../data/css.js';
+import '../../parser/css/balancing.js';
+import { clone } from '../../utils/clone.js';
+import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
+import { CssInjectionRuleConverter } from './css.js';
+import { ElementHidingRuleConverter } from './element-hiding.js';
+import { HeaderRemovalRuleConverter } from './header-removal.js';
+import { HtmlRuleConverter } from './html.js';
+import { AdgCosmeticRuleModifierConverter } from './rule-modifiers/adg.js';
+import { UboCosmeticRuleModifierConverter } from './rule-modifiers/ubo.js';
+import { ScriptletRuleConverter } from './scriptlet.js';
 
 /**
- * @file Cosmetic rule converter
+ * @file Cosmetic rule converter.
  */
 /**
- * Cosmetic rule converter class (also known as "non-basic rule converter")
+ * Cosmetic rule converter class (also known as "non-basic rule converter").
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class CosmeticRuleConverter extends RuleConverterBase {
     /**
      * Converts a cosmetic rule to AdGuard syntax, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         let subconverterResult;
@@ -105,11 +107,13 @@ class CosmeticRuleConverter extends RuleConverterBase {
     /**
      * Converts a cosmetic rule to uBlock Origin syntax, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToUbo(rule) {
         // Skip conversation if the rule is already in uBO format