@adguard/agtree 3.4.3 → 4.0.1

package/dist/parser/css/css-token-stream.js

@@ -1,16 +1,16 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { TokenType, getFormattedTokenName } from '@adguard/css-tokenizer';
+import { TokenType, getFormattedTokenName, tokenizeExtended } from '@adguard/css-tokenizer';
 import { sprintf } from 'sprintf-js';
 import { tokenizeBalanced } from './balancing.js';
 import { EMPTY } from '../../utils/constants.js';
 import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { ERROR_MESSAGES, END_OF_INPUT } from './constants.js';
-import { EXT_CSS_PSEUDO_CLASSES, EXT_CSS_PSEUDO_CLASSES_STRICT, LEGACY_EXT_CSS_ATTRIBUTE_PREFIX, ABP_EXT_CSS_PREFIX } from '../../converter/data/css.js';
+import { EXT_CSS_PSEUDO_CLASSES, EXT_CSS_PSEUDO_CLASSES_STRICT, NATIVE_CSS_PSEUDO_CLASSES, LEGACY_EXT_CSS_ATTRIBUTE_PREFIX, ABP_EXT_CSS_PREFIX } from '../../converter/data/css.js';
 
 /**
  * @file CSS token stream.
@@ -304,6 +304,7 @@ class CssTokenStream {
     }
     /**
      * Strictly checks whether the token stream contains any Extended CSS elements, such as `:contains()`.
+     *
      * Some Extended CSS elements are natively supported by browsers, like `:has()`.
      * This method is used to check for Extended CSS elements that are not natively supported by browsers,
      * this is why it called "strict", because it strictly checks for Extended CSS elements.
@@ -313,6 +314,42 @@ class CssTokenStream {
     hasAnySelectorExtendedCssNodeStrict() {
         return this.hasAnySelectorExtendedCssNodeInternal(EXT_CSS_PSEUDO_CLASSES_STRICT);
     }
+    /**
+     * _Lightweight_ static check for native CSS pseudo-classes — `:has()`, `:is()`, `:not()`.
+     *
+     * This method uses `tokenizeExtended` directly with early stopping,
+     * avoiding the overhead of:
+     * - full tokenization with balance tracking;
+     * - storing all tokens in memory;
+     * - processing remaining tokens after a match is found.
+     *
+     * Use this method when you only need to detect native pseudo-classes
+     * and don't need the full `CssTokenStream` functionality.
+     *
+     * @param selector CSS selector string to check.
+     * @returns True if the selector contains `:has()`, `:is()`, or `:not()`,
+     * otherwise false.
+     */
+    static hasNativeCssPseudoClass(selector) {
+        let found = false;
+        try {
+            tokenizeExtended(selector, (type, start, end, _props, stop) => {
+                if (type === TokenType.Function) {
+                    // Omit trailing '(' from function name
+                    const name = selector.slice(start, end - 1);
+                    if (NATIVE_CSS_PSEUDO_CLASSES.has(name)) {
+                        found = true;
+                        stop();
+                    }
+                }
+            });
+        }
+        catch {
+            // Invalid CSS, treat as not containing native pseudo-classes
+            return false;
+        }
+        return found;
+    }
     /**
      * Checks whether the token stream contains any Extended CSS elements, such as `:has()`, `:contains()`, etc.
      *

package/dist/parser/css/ubo-selector-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/filterlist-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/index.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/app-list-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/domain-list-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/list-items-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/logical-expression-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/method-list-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/modifier-list.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/modifier-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/parameter-list-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/stealth-option-list-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/ubo-parameter-list-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/misc/value-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/network/host-rule-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/network/network-rule-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/parser/options.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
@@ -18,6 +18,7 @@ const defaultParserOptions = Object.freeze({
     includeRaws: true,
     ignoreComments: false,
     parseHostRules: false,
+    parseHtmlFilteringRuleBodies: false,
 });
 
 export { defaultParserOptions };

package/dist/parser/rule-parser.js

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
+ * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/types/common/ubo-html-filtering-body-common.d.ts

@@ -0,0 +1,12 @@
+import { type HtmlFilteringRuleBody } from '../nodes/index.js';
+/**
+ * Checks whether the given HTML filtering rule body represents a uBlock-style response header removal rule.
+ *
+ * @param node Potential response header removal rule node.
+ *
+ * @returns `true` if the node is a response header removal rule, `false` otherwise.
+ *
+ * @note This method checks `HtmlFilteringRuleBody` because, response header
+ * removal rule syntax is same as uBlock-style HTML filtering rule syntax.
+ */
+export declare function isUboResponseHeaderRemovalRuleBody(node: HtmlFilteringRuleBody): boolean;

package/dist/types/compatibility-tables/compatibility-table-data.d.ts

@@ -18,11 +18,11 @@ export declare const scriptletsCompatibilityTableData: CompatibilityTable<{
     removalMessage: string | null;
     parameters?: {
         name: string;
-        debug: boolean;
-        pattern: string | null;
         description: string | null;
         default: string | null;
         required: boolean;
+        pattern: string | null;
+        debug: boolean;
     }[] | undefined;
 }>;
 /**
@@ -40,7 +40,7 @@ export declare const redirectsCompatibilityTableData: CompatibilityTable<{
     removed: boolean;
     removalMessage: string | null;
     isBlocking: boolean;
-    resourceTypes: ("object" | "image" | "other" | "font" | "media" | "ping" | "script" | "stylesheet" | "websocket" | "xmlhttprequest" | "main_frame" | "sub_frame")[];
+    resourceTypes: ("object" | "main_frame" | "sub_frame" | "stylesheet" | "script" | "image" | "font" | "xmlhttprequest" | "ping" | "media" | "websocket" | "other")[];
 }>;
 /**
  * Compatibility table data for modifiers.

package/dist/types/compatibility-tables/schemas/redirect.d.ts

@@ -17,7 +17,7 @@ export declare const redirectDataSchema: zod.ZodEffects<zod.ZodTypeAny, {
     removed: boolean;
     removalMessage: string | null;
     isBlocking: boolean;
-    resourceTypes: ("object" | "image" | "other" | "font" | "media" | "ping" | "script" | "stylesheet" | "websocket" | "xmlhttprequest" | "main_frame" | "sub_frame")[];
+    resourceTypes: ("object" | "main_frame" | "sub_frame" | "stylesheet" | "script" | "image" | "font" | "xmlhttprequest" | "ping" | "media" | "websocket" | "other")[];
 }, any>;
 /**
  * Type of the redirect data schema.

package/dist/types/compatibility-tables/schemas/scriptlet.d.ts

@@ -18,11 +18,11 @@ export declare const scriptletDataSchema: zod.ZodEffects<zod.ZodTypeAny, {
     removalMessage: string | null;
     parameters?: {
         name: string;
-        debug: boolean;
-        pattern: string | null;
         description: string | null;
         default: string | null;
         required: boolean;
+        pattern: string | null;
+        debug: boolean;
     }[] | undefined;
 }, any>;
 /**

package/dist/types/converter/cosmetic/html.d.ts

@@ -4,25 +4,27 @@
 import { type HtmlFilteringRule } from '../../nodes/index.js';
 import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { type NodeConversionResult } from '../base-interfaces/conversion-result.js';
+/**
+ * Error messages used in HTML filtering rule conversion.
+ */
 export declare const ERROR_MESSAGES: {
-    ABP_NOT_SUPPORTED: string;
-    TAG_SHOULD_BE_FIRST_CHILD: string;
-    EXPECTED_BUT_GOT_WITH_VALUE: string;
-    INVALID_ATTRIBUTE_NAME: string;
-    INVALID_ATTRIBUTE_VALUE: string;
-    INVALID_FLAG: string;
-    INVALID_OPERATOR_FOR_ATTR: string;
-    VALUE_FOR_ATTR_SHOULD_BE_INT: string;
-    INVALID_PSEUDO_CLASS: string;
-    VALUE_FOR_PSEUDO_CLASS_SHOULD_BE_INT: string;
-    REGEXP_NOT_SUPPORTED: string;
-    ATTRIBUTE_SELECTOR_REQUIRES_VALUE: string;
-    INVALID_ATTRIBUTE_SELECTOR_OPERATOR: string;
-    VALUE_SHOULD_BE_SPECIFIED: string;
-    VALUE_SHOULD_BE_POSITIVE: string;
-    OPERATOR_SHOULD_BE_SPECIFIED: string;
-    UNEXPECTED_TOKEN_WITH_VALUE: string;
-    FLAGS_NOT_SUPPORTED: string;
+    readonly ABP_NOT_SUPPORTED: "Invalid rule, ABP does not support HTML filtering rules";
+    readonly INVALID_RULE: "Invalid HTML filtering rule: %s";
+    readonly MIXED_SYNTAX_ADG_UBO: "Mixed AdGuard and uBlock syntax";
+    readonly EMPTY_SELECTOR_LIST: "Selector list of HTML filtering rule must not be empty";
+    readonly EMPTY_COMPLEX_SELECTOR: "Complex selector of selector list must not be empty";
+    readonly INVALID_SELECTOR_COMBINATOR: "Invalid selector combinator '%s' used between selectors";
+    readonly UNKNOWN_SELECTOR_TYPE: "Unknown selector type '%s' found during conversion";
+    readonly SPECIAL_ATTRIBUTE_SELECTOR_OPERATOR_INVALID: "Special attribute selector '%s' has invalid operator '%s'";
+    readonly SPECIAL_ATTRIBUTE_SELECTOR_FLAG_NOT_SUPPORTED: "Special attribute selector '%s' does not support flags";
+    readonly SPECIAL_ATTRIBUTE_SELECTOR_VALUE_REQUIRED: "Special attribute selector '%s' requires a value";
+    readonly SPECIAL_ATTRIBUTE_SELECTOR_VALUE_INT: "Value of special attribute selector '%s' must be an integer, got '%s'";
+    readonly SPECIAL_ATTRIBUTE_SELECTOR_VALUE_POSITIVE: "Value of special attribute selector '%s' must be a positive integer, got '%s'";
+    readonly SPECIAL_ATTRIBUTE_SELECTOR_NOT_SUPPORTED: "Special attribute selector '%s' is not supported in conversion";
+    readonly SPECIAL_PSEUDO_CLASS_SELECTOR_ARGUMENT_REQUIRED: "Special pseudo-class selector '%s' requires an argument";
+    readonly SPECIAL_PSEUDO_CLASS_SELECTOR_ARGUMENT_INT: "Argument of special pseudo-class selector '%s' must be an integer, got '%s'";
+    readonly SPECIAL_PSEUDO_CLASS_SELECTOR_ARGUMENT_POSITIVE: "Argument of special pseudo-class selector '%s' must be a positive integer, got '%s'";
+    readonly SPECIAL_PSEUDO_CLASS_SELECTOR_NOT_SUPPORTED: "Special pseudo-class selector '%s' is not supported in conversion";
 };
 /**
  * HTML filtering rule converter class
@@ -31,39 +33,162 @@ export declare const ERROR_MESSAGES: {
  */
 export declare class HtmlRuleConverter extends RuleConverterBase {
     /**
-     * Converts a HTML rule to AdGuard syntax, if possible. Also can be used to convert
-     * AdGuard rules to AdGuard syntax to validate them.
-     *
-     * _Note:_ uBlock Origin supports multiple selectors within a single rule, but AdGuard doesn't,
-     * so the following rule
-     * ```
-     * example.com##^div[attr1="value1"][attr2="value2"], script:has-text(value)
-     * ```
-     * will be converted to multiple AdGuard rules:
-     * ```
-     * example.com$$div[attr1="value1"][attr2="value2"][max-length="262144"]
-     * example.com$$script[tag-content="value"][max-length="262144"]
-     * ```
-     *
-     * @param rule Rule node to convert
+     * Converts a HTML rule to AdGuard syntax, if possible.
+     * Also can be used to convert AdGuard rules to AdGuard syntax to validate them.
+     *
+     * @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: HtmlFilteringRule): NodeConversionResult<HtmlFilteringRule>;
     /**
-     * Converts a HTML rule to uBlock Origin syntax, if possible.
+     * Converts a HTML rule to uBlock syntax, if possible.
+     * Also can be used to convert uBlock rules to uBlock syntax to validate them.
      *
-     * @note AdGuard rules are often more specific than uBlock Origin rules, so some information
-     * may be lost in conversion. AdGuard's `[max-length]` and `[tag-content]` attributes will be converted to
-     * uBlock's `:min-text-length()` and `:has-text()` pseudo-classes when 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 Error 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 Error if the rule is invalid or cannot be converted.
      */
     static convertToUbo(rule: HtmlFilteringRule): NodeConversionResult<HtmlFilteringRule>;
+    /**
+     * Handles special attribute selectors during AdGuard to AdGuard conversion:
+     * - `[tag-content="content"]` -> `:contains(content)`
+     *   direct conversion, no changes to value
+     * - `[wildcard="*content*"]` -> `:contains(/*.content*./s)`
+     *   convert search pattern to regular expression
+     * - `[min-length="min"]` -> `:contains(/^(?=.{min,}$).*\/s)`
+     *   converts to a length-matching regular expression
+     * - `[max-length="max"]` -> `:contains(/^(?=.{0,max}$).*\/s)`
+     *   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
+     * to be deprecated and removed soon.
+     *
+     * @param name Name of the special attribute selector.
+     * @param value Value of the special attribute selector.
+     *
+     * @returns A {@link SimpleSelector} to add to the current complex selector.
+     */
+    private static convertSpecialAttributeSelectorAdgToAdg;
+    /**
+     * Since special pseudo-class selectors do not need conversion
+     * in AdGuard to AdGuard conversion, we simply return `true` to keep them as-is.
+     *
+     * @param name Name of the special pseudo-class selector.
+     *
+     * @returns `true` to keep the special pseudo-class selector as-is.
+     *
+     * @throws Rule conversion error for mixed syntax.
+     */
+    private static convertSpecialPseudoClassSelectorAdgToAdg;
+    /**
+     * Since special attribute selectors only AdGuard-specific,
+     * we should never encounter them in uBlock rules.
+     *
+     * @throws Rule conversion error for mixed syntax.
+     */
+    private static convertSpecialAttributeSelectorUboToAdg;
+    /**
+     * Handles special pseudo-class selectors during uBlock to AdGuard conversion:
+     * - `: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
+     *
+     * @param name Name of the special pseudo-class selector.
+     * @param argument Argument of the special pseudo-class selector.
+     *
+     * @returns A {@link SimpleSelector} to add to the current complex selector.
+     *
+     * @throws If AdGuard-specific pseudo-class selector is found in uBlock rule.
+     */
+    private static convertSpecialPseudoClassSelectorUboToAdg;
+    /**
+     * Handles special attribute selectors during AdGuard to uBlock conversion:
+     * - `[tag-content="content"]` -> `:has-text(content)`
+     *   direct conversion, no changes to value
+     * - `[wildcard="*content*"]` -> `:has-text(/*.content*./s)`
+     *   convert search pattern to regular expression
+     * - `[min-length="min"]` -> `:min-text-length(min)`
+     *   direct conversion, no changes to value
+     * - `[max-length]` is skipped
+     *
+     * @param name Name of the special attribute selector.
+     * @param value Value of the special attribute selector.
+     *
+     * @returns A {@link SimpleSelector} to add to the current complex selector, or `false` to skip it.
+     */
+    private static convertSpecialAttributeSelectorAdgToUbo;
+    /**
+     * Handles special pseudo-class selectors during AdGuard to uBlock conversion:
+     * - `:contains(text)` -> `:has-text(text)`
+     *   direct conversion, no changes to argument
+     *
+     * @param name Name of the special pseudo-class selector.
+     * @param argument Argument of the special pseudo-class selector.
+     *
+     * @returns A {@link SimpleSelector} to add to the current complex selector.
+     *
+     * @throws If uBlock-specific pseudo-class selector is found in AdGuard rule.
+     */
+    private static convertSpecialPseudoClassSelectorAdgToUbo;
+    /**
+     * 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.
+     *
+     * @param body HTML filtering rule body to convert.
+     * @param parser HTML filtering rule body parser used for parsing raw value bodies.
+     * @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.
+     *
+     * @returns Converted selector list without special simple selectors.
+     */
+    private static convertBody;
+    /**
+     * Clones a simple selector or selector combinator node.
+     *
+     * @param selector Simple selector or selector combinator node to clone.
+     *
+     * @returns Cloned simple selector or selector combinator node.
+     */
+    private static cloneSelector;
+    /**
+     * Creates a CSS pseudo-class selector node.
+     *
+     * @param name The name of the pseudo-class selector.
+     * @param argument Optional argument of the pseudo-class selector.
+     *
+     * @returns CSS pseudo-class selector node.
+     */
+    private static getPseudoClassSelectorNode;
+    /**
+     * Asserts that the given array is not empty.
+     *
+     * @param array Array to check.
+     * @param errorMessage Error message to use if the array is empty.
+     *
+     * @throws If the array is empty.
+     */
+    private static assertNotEmpty;
+    /**
+     * Asserts that the given special attribute / pseudo-class length value is valid.
+     *
+     * @param name Name of the attribute or pseudo-class.
+     * @param value Value to parse.
+     * @param notIntErrorMessage Error message when the value is not an integer.
+     * @param notPositiveErrorMessage Error message when the value is not positive.
+     *
+     * @throws If the value is not a valid number or not positive.
+     */
+    private static assertValidLengthValue;
 }

package/dist/types/converter/data/css.d.ts

@@ -21,18 +21,23 @@ export declare const LEGACY_EXT_CSS_ATTRIBUTE_PREFIX = "-ext-";
  * ```
  */
 export declare const ABP_EXT_CSS_PREFIX = "-abp";
+/**
+ * Known CSS pseudo-classes that are supported by all browsers natively,
+ * but can also be applied as extended.
+ */
+export declare const NATIVE_CSS_PSEUDO_CLASSES: ReadonlySet<string>;
 /**
  * Known _strict_ Extended CSS pseudo-classes. Please, keep this list sorted.
  * Strict means that these pseudo-classes are not supported by any browser natively,
  * and they always require Extended CSS libraries to work.
  */
-export declare const EXT_CSS_PSEUDO_CLASSES_STRICT: Set<string>;
+export declare const EXT_CSS_PSEUDO_CLASSES_STRICT: ReadonlySet<string>;
 /**
  * _ALL_ known Extended CSS pseudo-classes. Please, keep this list sorted.
  * It includes strict pseudo-classes and additional pseudo-classes that may be
  * supported by some browsers natively.
  */
-export declare const EXT_CSS_PSEUDO_CLASSES: Set<string>;
+export declare const EXT_CSS_PSEUDO_CLASSES: ReadonlySet<string>;
 /**
  * Known legacy Extended CSS attributes. These attributes are deprecated and
  * should be replaced with the corresponding pseudo-classes. In a long term,
@@ -40,9 +45,16 @@ export declare const EXT_CSS_PSEUDO_CLASSES: Set<string>;
  *
  * Please, keep this list sorted.
  */
-export declare const EXT_CSS_LEGACY_ATTRIBUTES: Set<string>;
+export declare const EXT_CSS_LEGACY_ATTRIBUTES: ReadonlySet<string>;
+/**
+ * Known extended CSS property that is used to remove elements.
+ *
+ * @see {@link https://github.com/AdguardTeam/ExtendedCss#remove-pseudos}
+ */
+export declare const REMOVE_PROPERTY = "remove";
 /**
- * Known CSS functions that aren't allowed in CSS injection rules, because they
- * able to load external resources. Please, keep this list sorted.
+ * Known extended CSS value for {@link REMOVE_PROPERTY} property to remove elements.
+ *
+ * @see {@link https://github.com/AdguardTeam/ExtendedCss#remove-pseudos}
  */
-export declare const FORBIDDEN_CSS_FUNCTIONS: Set<string>;
+export declare const REMOVE_VALUE = "true";

package/dist/types/generator/cosmetic/html-filtering-body/adg-html-filtering-body-generator.d.ts

@@ -0,0 +1,17 @@
+import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * AdGuard HTML Filtering body generator.
+ */
+export declare class AdgHtmlFilteringBodyGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the AdGuard HTML filtering rule body.
+     *
+     * @param node HTML filtering rule body.
+     *
+     * @returns String representation of the rule body.
+     *
+     * @throws Error if the rule body is invalid.
+     */
+    static generate(node: Value | HtmlFilteringRuleBody): string;
+}