@adguard/agtree 3.4.3 → 4.0.1

package/dist/types/generator/cosmetic/html-filtering-body/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';
+/**
+ * HTML Filtering body generator.
+ */
+export declare class HtmlFilteringBodyGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the 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;
+}

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

@@ -0,0 +1,30 @@
+import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * uBlock HTML Filtering body generator.
+ */
+export declare class UboHtmlFilteringBodyGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the uBlock HTML filtering rule body
+     * and also uBlock-style response header removal rules.
+     *
+     * @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;
+    /**
+     * Generates a string representation of the uBlock-style response header removal rule.
+     *
+     * @param node Potential response header removal rule node.
+     *
+     * @returns String representation of the response header removal rule,
+     * or `null` if the node is not a response header removal rule.
+     *
+     * @note This method accepts `HtmlFilteringRuleBody` as `node` because,
+     * response header removal rule syntax is same as uBlock-style HTML filtering rule syntax.
+     */
+    private static generateResponseHeaderRule;
+}

package/dist/types/generator/cosmetic/selector/attribute-selector-generator.d.ts

@@ -0,0 +1,15 @@
+import { type AttributeSelector } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * Attribute selector generator.
+ */
+export declare class AttributeSelectorGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the attribute selector.
+     *
+     * @param node Attribute selector node.
+     *
+     * @returns String representation of the attribute selector.
+     */
+    static generate(node: AttributeSelector): string;
+}

package/dist/types/generator/cosmetic/selector/class-selector-generator.d.ts

@@ -0,0 +1,15 @@
+import { type ClassSelector } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * Class selector generator.
+ */
+export declare class ClassSelectorGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the class selector.
+     *
+     * @param node Class selector node.
+     *
+     * @returns String representation of the class selector.
+     */
+    static generate(node: ClassSelector): string;
+}

package/dist/types/generator/cosmetic/selector/complex-selector-generator.d.ts

@@ -0,0 +1,17 @@
+import { type ComplexSelector } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * Complex selector generator.
+ */
+export declare class ComplexSelectorGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the complex selector.
+     *
+     * @param node Complex selector node.
+     *
+     * @returns String representation of the complex selector.
+     *
+     * @throws Error if the `node` is invalid.
+     */
+    static generate(node: ComplexSelector): string;
+}

package/dist/types/generator/cosmetic/selector/id-selector-generator.d.ts

@@ -0,0 +1,15 @@
+import { type IdSelector } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * ID selector generator.
+ */
+export declare class IdSelectorGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the ID selector.
+     *
+     * @param node ID selector node.
+     *
+     * @returns String representation of the ID selector.
+     */
+    static generate(node: IdSelector): string;
+}

package/dist/types/generator/cosmetic/selector/pseudo-class-selector-generator.d.ts

@@ -0,0 +1,15 @@
+import { type PseudoClassSelector } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * Pseudo-class selector generator.
+ */
+export declare class PseudoClassSelectorGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the pseudo-class selector.
+     *
+     * @param node Pseudo-class selector node.
+     *
+     * @returns String representation of the pseudo-class selector.
+     */
+    static generate(node: PseudoClassSelector): string;
+}

package/dist/types/generator/cosmetic/selector/selector-combinator-generator.d.ts

@@ -0,0 +1,15 @@
+import { type SelectorCombinator } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * Selector combinator generator.
+ */
+export declare class SelectorCombinatorGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the selector combinator.
+     *
+     * @param node Selector combinator node.
+     *
+     * @returns String representation of the selector combinator.
+     */
+    static generate(node: SelectorCombinator): string;
+}

package/dist/types/generator/cosmetic/selector/selector-list-generator.d.ts

@@ -0,0 +1,17 @@
+import { type SelectorList } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * Selector list generator.
+ */
+export declare class SelectorListGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the selector list.
+     *
+     * @param node Selector list node.
+     *
+     * @returns String representation of the selector list.
+     *
+     * @throws Error if the `node` is invalid.
+     */
+    static generate(node: SelectorList): string;
+}

package/dist/types/generator/cosmetic/selector/type-selector-generator.d.ts

@@ -0,0 +1,15 @@
+import { type TypeSelector } from '../../../nodes/index.js';
+import { BaseGenerator } from '../../base-generator.js';
+/**
+ * Type selector generator.
+ */
+export declare class TypeSelectorGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the type selector.
+     *
+     * @param node Type selector node.
+     *
+     * @returns String representation of the type selector.
+     */
+    static generate(node: TypeSelector): string;
+}

package/dist/types/generator/css/adg-css-injection-generator.d.ts

@@ -4,7 +4,7 @@ import { BaseGenerator } from '../base-generator.js';
  * AdGuard CSS injection generator.
  */
 export declare class AdgCssInjectionGenerator extends BaseGenerator {
-    private static removeDeclaration;
+    private static REMOVE_DECLARATION;
     /**
      * Serializes an AdGuard CSS injection node into a raw string.
      *

package/dist/types/index.d.ts

@@ -2,11 +2,9 @@
  * @file AGTree entry point
  */
 export { RuleParser } from './parser/rule-parser.js';
-export { RuleSerializer } from './serializer/rule-serializer.js';
-export { RuleDeserializer } from './deserializer/rule-deserializer.js';
 export { RuleGenerator } from './generator/rule-generator.js';
 export { type OnParseError, defaultParserOptions, type ParserOptions } from './parser/options.js';
-export { type Agent, type AgentCommentRule, type AnyCommentRule, type AnyCosmeticRule, type AnyExpressionNode, type AnyRule, type CommentBase, CommentMarker, type CommentRule, CommentRuleType, type ConfigCommentRule, type CosmeticRule, CosmeticRuleSeparator, CosmeticRuleType, type CssInjectionRule, type CssInjectionRuleBody, type Domain, type DomainList, type DomainListSeparator, type ElementHidingRule, type ElementHidingRuleBody, type EmptyRule, type ExpressionOperatorNode, type ExpressionParenthesisNode, type ExpressionVariableNode, type FilterList, type Hint, type HintCommentRule, type HtmlFilteringRule, type HtmlFilteringRuleBody, type JsInjectionRule, type Location, type LocationRange, type MetadataCommentRule, type Modifier, type ModifierList, type NetworkRule, type Node, type ParameterList, type PreProcessorCommentRule, type RuleBase, RuleCategory, type ScriptletInjectionRule, type ScriptletInjectionRuleBody, type Value, NetworkRuleType, type HostnameList, type HostRule, type AnyNetworkRule, } from './nodes/index.js';
+export { type Agent, type AgentCommentRule, type AnyCommentRule, type AnyCosmeticRule, type AnyExpressionNode, type AnyRule, type CommentBase, CommentMarker, type CommentRule, CommentRuleType, type ConfigCommentRule, type CosmeticRule, CosmeticRuleSeparator, CosmeticRuleType, type CssInjectionRule, type CssInjectionRuleBody, type Domain, type DomainList, type DomainListSeparator, type ElementHidingRule, type ElementHidingRuleBody, type EmptyRule, type ExpressionOperatorNode, type ExpressionParenthesisNode, type ExpressionVariableNode, type FilterList, type Hint, type HintCommentRule, type HtmlFilteringRule, type HtmlFilteringRuleBody, type SelectorList, type SelectorCombinatorValue, type JsInjectionRule, type Location, type LocationRange, type MetadataCommentRule, type Modifier, type ModifierList, type NetworkRule, type Node, type ParameterList, type PreProcessorCommentRule, type RuleBase, RuleCategory, type ScriptletInjectionRule, type ScriptletInjectionRuleBody, type Value, NetworkRuleType, type HostnameList, type HostRule, type AnyNetworkRule, } from './nodes/index.js';
 export { AdblockSyntaxError } from './errors/adblock-syntax-error.js';
 export { AgentCommentParser } from './parser/comment/agent-comment-parser.js';
 export { AgentParser } from './parser/comment/agent-parser.js';
@@ -18,8 +16,6 @@ export { DomainListParser } from './parser/misc/domain-list-parser.js';
 export { MethodListParser } from './parser/misc/method-list-parser.js';
 export { StealthOptionListParser } from './parser/misc/stealth-option-list-parser.js';
 export { FilterListParser } from './parser/filterlist-parser.js';
-export { FilterListSerializer } from './serializer/filterlist-serializer.js';
-export { FilterListDeserializer } from './deserializer/filterlist-deserializer.js';
 export { HintCommentParser } from './parser/comment/hint-comment-parser.js';
 export { HintParser } from './parser/comment/hint-parser.js';
 export { LogicalExpressionParser } from './parser/misc/logical-expression-parser.js';
@@ -36,7 +32,6 @@ export { BinarySchemaMismatchError } from './errors/binary-schema-mismatch-error
 export { modifierValidator } from './validator/index.js';
 export * from './converter/index.js';
 export { ADG_SCRIPTLET_MASK, AGLINT_COMMAND_PREFIX, COMMA_DOMAIN_LIST_SEPARATOR, NEGATION_MARKER, HINT_MARKER, IF, INCLUDE, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, PIPE_MODIFIER_SEPARATOR, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_SEPARATOR, PREPROCESSOR_MARKER, SAFARI_CB_AFFINITY, UBO_SCRIPTLET_MASK, } from './utils/constants.js';
-export { BINARY_SCHEMA_VERSION } from './utils/binary-schema-version.js';
 export { AdblockSyntax, AdblockProduct, getHumanReadableProductName } from './utils/adblockers.js';
 export { type CosmeticRuleSeparatorFinderResult, CosmeticRuleSeparatorUtils } from './utils/cosmetic-rule-separator.js';
 export { DomainUtils } from './utils/domain.js';
@@ -44,13 +39,8 @@ export { type VariableTable, LogicalExpressionUtils } from './utils/logical-expr
 export { ADBLOCK_URL_START, ADBLOCK_URL_START_REGEX, ADBLOCK_URL_SEPARATOR, ADBLOCK_URL_SEPARATOR_REGEX, ADBLOCK_WILDCARD, ADBLOCK_WILDCARD_REGEX, SPECIAL_REGEX_SYMBOLS, RegExpUtils, } from './utils/regexp.js';
 export { QuoteType, QuoteUtils, } from './utils/quotes.js';
 export { type Position, PositionProvider } from './utils/position-provider.js';
-export { OutputByteBuffer } from './utils/output-byte-buffer.js';
-export { InputByteBuffer } from './utils/input-byte-buffer.js';
-export { ByteBuffer } from './utils/byte-buffer.js';
-export { encodeIntoPolyfill, type TextEncoderPolyfillResult } from './utils/text-encoder-polyfill.js';
-export { decodeTextPolyfill } from './utils/text-decoder-polyfill.js';
 export { RuleCategorizer } from './utils/categorizer.js';
-export { EXT_CSS_PSEUDO_CLASSES, EXT_CSS_LEGACY_ATTRIBUTES, FORBIDDEN_CSS_FUNCTIONS } from './converter/data/css.js';
+export { NATIVE_CSS_PSEUDO_CLASSES, REMOVE_PROPERTY, } from './converter/data/css.js';
+export { CssTokenStream } from './parser/css/css-token-stream.js';
 export { GenericPlatform, SpecificPlatform, modifiersCompatibilityTable, redirectsCompatibilityTable, scriptletsCompatibilityTable, parseRawPlatforms, type CompatibilityTable, type CompatibilityTableRow, type ProductRecords, type RowByProduct, type RowsByProduct, isGenericPlatform, getPlatformId, getSpecificPlatformName, hasPlatformMultipleProducts, getProductGenericPlatforms, getProductSpecificPlatforms, platformToAdblockProduct, getPlatformsByProduct, getHumanReadablePlatformName, getAllPlatformNames, ResourceType, getResourceTypeModifier, isValidResourceType, stringifyPlatforms, type PlatformsByProduct, type AnyPlatform, PLATFORM_NEGATION, PLATFORM_SEPARATOR, } from './compatibility-tables/index.js';
 export { AGTREE_VERSION } from './version.js';
-export { getSyntaxSerializationMap } from './marshalling-utils/syntax-serialization-map.js';

package/dist/types/nodes/index.d.ts

@@ -860,15 +860,171 @@ export interface ScriptletInjectionRuleBody extends Node {
      */
     children: ParameterList[];
 }
+/**
+ * Represents a type selector.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#type-selectors}
+ */
+export interface TypeSelector extends Node {
+    type: 'TypeSelector';
+    /**
+     * Value of the type selector.
+     */
+    value: string;
+}
+/**
+ * Represents a class selector.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#class-html}
+ */
+export interface ClassSelector extends Node {
+    type: 'ClassSelector';
+    /**
+     * Value of the class selector (without dot).
+     */
+    value: string;
+}
+/**
+ * Represents an ID selector.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#id-selectors}
+ */
+export interface IdSelector extends Node {
+    type: 'IdSelector';
+    /**
+     * Value of the ID selector (without hash).
+     */
+    value: string;
+}
+/**
+ * Represents an attribute selector without value.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#attribute-selectors}
+ */
+export interface AttributeSelectorWithoutValue extends Node {
+    type: 'AttributeSelector';
+    /**
+     * Name of the attribute selector.
+     */
+    name: Value;
+}
+/**
+ * Represents CSS attribute selector operator values.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#attribute-selectors}
+ */
+export type AttributeSelectorOperatorValue = '=' | '~=' | '|=' | '^=' | '$=' | '*=';
+/**
+ * Represents CSS attribute selector flag values.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#attribute-selectors}
+ */
+export type AttributeSelectorFlagValue = 'i' | 's';
+/**
+ * Represents an attribute selector with value.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#attribute-selectors}
+ */
+export interface AttributeSelectorWithValue extends Node {
+    type: 'AttributeSelector';
+    /**
+     * Name of the attribute selector.
+     */
+    name: Value;
+    /**
+     * Operator of the attribute selector.
+     */
+    operator: Value<AttributeSelectorOperatorValue>;
+    /**
+     * Value of the attribute selector.
+     */
+    value: Value;
+    /**
+     * Optional flag of the attribute selector.
+     */
+    flag?: Value<AttributeSelectorFlagValue>;
+}
+/**
+ * Represents an attribute selector.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#attribute-selectors}
+ */
+export type AttributeSelector = AttributeSelectorWithoutValue | AttributeSelectorWithValue;
+/**
+ * Represents a pseudo-class selector.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#pseudo-classes}
+ */
+export interface PseudoClassSelector extends Node {
+    type: 'PseudoClassSelector';
+    /**
+     * Name of the pseudo-class selector.
+     */
+    name: Value;
+    /**
+     * Optional argument of the pseudo-class selector.
+     * If not specified, the pseudo-class is not callable (e.g., `:hover`).
+     * If specified, the pseudo-class is callable (e.g., `:nth-child(2n+1)`).
+     */
+    argument?: Value;
+}
+/**
+ * Represents a simple CSS selector.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#simple}
+ */
+export type SimpleSelector = TypeSelector | ClassSelector | IdSelector | AttributeSelector | PseudoClassSelector;
+/**
+ * Represents selector combinator values.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#combinators}
+ */
+export type SelectorCombinatorValue = ' ' | '>' | '+' | '~';
+/**
+ * Represents selector combinators.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#combinators}
+ */
+export interface SelectorCombinator extends Node {
+    type: 'SelectorCombinator';
+    /**
+     * Value of the combinator.
+     */
+    value: SelectorCombinatorValue;
+}
+/**
+ * Represents a complex selector.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#complex}
+ */
+export interface ComplexSelector extends Node {
+    type: 'ComplexSelector';
+    /**
+     * List of simple selectors and combinators that form a complex selector.
+     */
+    children: (SimpleSelector | SelectorCombinator)[];
+}
+/**
+ * Represents a selector list.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4/#selector-list}
+ */
+export interface SelectorList extends Node {
+    type: 'SelectorList';
+    /**
+     * List of complex selectors separated by commas.
+     */
+    children: ComplexSelector[];
+}
 /**
  * Represents an HTML filtering rule body.
  */
 export interface HtmlFilteringRuleBody extends Node {
     type: 'HtmlFilteringRuleBody';
     /**
-     * HTML rule selector(s).
+     * CSS selector list.
      */
-    body: Value;
+    selectorList: SelectorList;
 }
 /**
  * A generic representation of a cosmetic rule.
@@ -1013,7 +1169,7 @@ export interface ScriptletInjectionRule extends CosmeticRule {
  */
 export interface HtmlFilteringRule extends CosmeticRule {
     type: typeof CosmeticRuleType.HtmlFilteringRule;
-    body: Value;
+    body: Value | HtmlFilteringRuleBody;
 }
 /**
  * Representation of a JS injection rule.

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

@@ -0,0 +1,35 @@
+import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { BaseParser } from '../../base-parser.js';
+/**
+ * `AdgHtmlFilteringBodyParser` is responsible for parsing the body of an AdGuard-style HTML filtering rule.
+ *
+ * Please note that the parser will parse any HTML filtering rule if it is syntactically correct.
+ * For example, it will parse this:
+ * ```adblock
+ * example.com$$div[special-attr="value"]
+ * ```
+ *
+ * but it didn't check if the attribute `special-attr` actually supported by any adblocker.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4}
+ * @see {@link https://adguard.com/kb/general/ad-filtering/create-own-filters/#html-filtering-rules}
+ */
+export declare class AdgHtmlFilteringBodyParser extends BaseParser {
+    /**
+     * Parses the body of an AdGuard-style HTML filtering rule.
+     *
+     * @param raw Raw input to parse.
+     * @param options Global parser options.
+     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
+     *
+     * @returns Node of the parsed HTML filtering rule body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
+     * @example
+     * ```
+     * div[some_attribute="some_value"]
+     * ```
+     */
+    static parse(raw: string, options?: import("../../index.js").ParserOptions, baseOffset?: number): Value | HtmlFilteringRuleBody;
+}

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

@@ -0,0 +1,39 @@
+import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { BaseParser } from '../../base-parser.js';
+/**
+ * Class responsible for parsing HTML filtering rule body.
+ *
+ * Please note that the parser will parse any HTML filtering rule body if it is syntactically correct.
+ * For example, it will parse this:
+ * ```adblock
+ * span[special-attr="Example"]
+ * div:special-pseudo(Example)
+ * ```
+ *
+ * but it didn't check if the pseudo selector `special-pseudo` or if
+ * the attribute selector `special-attr` actually supported by any adblocker.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4}
+ * @see {@link https://adguard.com/kb/general/ad-filtering/create-own-filters/#html-filtering-rules}
+ * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#html-filters}
+ */
+export declare class HtmlFilteringBodyParser extends BaseParser {
+    /**
+     * Parses a HTML filtering rule body.
+     *
+     * @param raw Raw input to parse.
+     * @param options Global parser options.
+     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
+     *
+     * @returns Node of the parsed HTML filtering rule body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
+     * @example
+     * ```
+     * span[tag-content="Example"]
+     * div:has-text(Example)
+     * ```
+     */
+    static parse(raw: string, options?: import("../../index.js").ParserOptions, baseOffset?: number): Value | HtmlFilteringRuleBody;
+}

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

@@ -0,0 +1,63 @@
+import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { BaseParser } from '../../base-parser.js';
+/**
+ * `UboHtmlFilteringBodyParser` is responsible for parsing the body of
+ * an uBlock-style HTML filtering rule, and also uBlock-style response header removal rule.
+ *
+ * Please note that the parser will parse any HTML filtering rule if it is syntactically correct.
+ * For example, it will parse this:
+ * ```adblock
+ * example.com##^script:pseudo(content)
+ * example.com##^responseheader(header-name)
+ * ```
+ *
+ * but it didn't check if the pseudo selector `pseudo` or if
+ * the header name `header-name` actually supported by any adblocker.
+ *
+ * @see {@link https://www.w3.org/TR/selectors-4}
+ * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#html-filters}
+ * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#response-header-filtering}
+ */
+export declare class UboHtmlFilteringBodyParser extends BaseParser {
+    /**
+     * Parses the body of an uBlock-style HTML filtering rule
+     * and also uBlock-style response header removal rule.
+     *
+     * @param raw Raw input to parse.
+     * @param options Global parser options.
+     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
+     *
+     * @returns Node of the parsed HTML filtering rule body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
+     * @example
+     * ```
+     * div:has-text(Example)
+     * responseheader(header-name)
+     * ```
+     */
+    static parse(raw: string, options?: import("../../index.js").ParserOptions, baseOffset?: number): Value | HtmlFilteringRuleBody;
+    /**
+     * Parses uBlock-style response header removal rule body.
+     *
+     * @param raw Raw input to parse.
+     * @param options Global parser options.
+     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
+     *
+     * @returns Node of the parsed response header removal rule body
+     * or `null` if the body is not a response header removal rule.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
+     * @example
+     * ```
+     * responseheader(header-name)
+     * ```
+     *
+     * @note This method returns `HtmlFilteringRuleBody` because,
+     * response header removal rule syntax is same as uBlock-style
+     * HTML filtering rule syntax.
+     */
+    static parseResponseHeaderRule(raw: string, options?: import("../../index.js").ParserOptions, baseOffset?: number): HtmlFilteringRuleBody | null;
+}

package/dist/types/parser/cosmetic/selector/context.d.ts

@@ -0,0 +1,42 @@
+import { type ParserOptions } from '../../options.js';
+import { type TokenData, type CssTokenStream } from '../../css/css-token-stream.js';
+import { type SelectorList, type ComplexSelector } from '../../../nodes/index.js';
+/**
+ * Interface that represents current selector list parser context.
+ */
+export interface SelectorListParserContext {
+    /**
+     * Raw input string being parsed.
+     *
+     * Note: This is the full raw string, not just the part being currently parsed.
+     */
+    raw: string;
+    /**
+     * Global parser options.
+     */
+    options: ParserOptions;
+    /**
+     * Starting offset of the input. Node locations are calculated relative to this offset.
+     */
+    baseOffset: number;
+    /**
+     * CSS token stream used for parsing.
+     */
+    stream: CssTokenStream;
+    /**
+     * Current token being processed.
+     */
+    token: TokenData;
+    /**
+     * Resulting selector list node.
+     */
+    result: SelectorList;
+    /**
+     * Currently processed complex selector node.
+     */
+    complexSelector: ComplexSelector;
+    /**
+     * Indicates whether the type selector is already set for `complexSelector`.
+     */
+    isTypeSelectorSet: boolean;
+}

package/dist/types/parser/cosmetic/selector/handlers/attribute-selector-handler.d.ts

@@ -0,0 +1,35 @@
+import { type SelectorListParserContext } from '../context.js';
+/**
+ * Handles attribute selector parsing in selector list.
+ */
+export declare class AttributeSelectorHandler {
+    /**
+     * Set of attribute equality prefixes.
+     *
+     * @see {@link AttributeSelectorOperatorValue}
+     */
+    private static readonly ATTR_EQUALITY_PREFIXES;
+    /**
+     * Set of valid flags for attribute selector values.
+     *
+     * @see {@link AttributeSelectorFlagValue}
+     */
+    private static readonly ALLOWED_ATTRIBUTE_FLAGS;
+    /**
+     * Handles attribute selector parsing by creating an attribute selector node
+     * and appending it to the current complex selector node.
+     *
+     * @param context Selector list parser context.
+     *
+     * @throws If the attribute selector is syntactically incorrect.
+     */
+    static handle(context: SelectorListParserContext): void;
+    /**
+     * Validates attribute selector flag.
+     *
+     * @param flag Attribute selector flag.
+     *
+     * @returns `true` if the flag is valid, otherwise `false`.
+     */
+    private static isValidFlag;
+}

package/dist/types/parser/cosmetic/selector/handlers/class-selector-handler.d.ts

@@ -0,0 +1,15 @@
+import { type SelectorListParserContext } from '../context.js';
+/**
+ * Handles class selector parsing in selector list.
+ */
+export declare class ClassSelectorHandler {
+    /**
+     * Handles class selector parsing by creating a class selector node
+     * and appending it to the current complex selector node.
+     *
+     * @param context Selector list parser context.
+     *
+     * @throws If the class selector is syntactically incorrect.
+     */
+    static handle(context: SelectorListParserContext): void;
+}