@adguard/agtree 4.0.0 → 4.0.2

package/dist/types/parser/comment/preprocessor-parser.d.ts

@@ -1,5 +1,5 @@
 /**
- * Pre-processor directives
+ * Pre-processor directives.
  *
  * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#pre-processor-directives}
  * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#pre-parsing-directives}
@@ -12,6 +12,9 @@ import { BaseParser } from '../base-parser.js';
  * Please note that this parser only handles general syntax for now, and does not validate the parameters at
  * the parsing stage.
  *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#pre-processor-directives}
+ * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#pre-parsing-directives}
+ *
  * @example
  * If your rule is
  * ```adblock
@@ -19,15 +22,14 @@ import { BaseParser } from '../base-parser.js';
  * ```
  * then the directive's name is `if` and its value is `(adguard)`, but the parameter list
  * is not parsed / validated further.
- * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#pre-processor-directives}
- * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#pre-parsing-directives}
  */
 export declare class PreProcessorCommentParser extends BaseParser {
     /**
      * Determines whether the rule is a pre-processor rule.
      *
-     * @param raw Raw rule
-     * @returns `true` if the rule is a pre-processor rule, `false` otherwise
+     * @param raw Raw rule.
+     *
+     * @returns `true` if the rule is a pre-processor rule, `false` otherwise.
      */
     static isPreProcessorRule(raw: string): boolean;
     /**
@@ -36,8 +38,9 @@ export declare class PreProcessorCommentParser extends BaseParser {
      * @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
-     * Pre-processor comment AST or null (if the raw rule cannot be parsed as a pre-processor comment)
+     * Pre-processor comment AST or null (if the raw rule cannot be parsed as a pre-processor comment).
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): PreProcessorCommentRule | null;
 }

package/dist/types/parser/comment/simple-comment-parser.d.ts

@@ -17,7 +17,9 @@ export declare class SimpleCommentParser extends BaseParser {
      * Checks if the raw rule is a simple comment.
      *
      * @param raw Raw input to check.
+     *
      * @returns `true` if the input is a simple comment, `false` otherwise.
+     *
      * @note This method does not check for adblock agent comments.
      */
     static isSimpleComment(raw: string): boolean;
@@ -27,6 +29,7 @@ export declare class SimpleCommentParser extends BaseParser {
      * @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 Comment rule node or null (if the raw rule cannot be parsed as a simple comment).
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): CommentRule | null;

package/dist/types/parser/cosmetic/cosmetic-rule-parser.d.ts

@@ -17,7 +17,7 @@ export declare const ERROR_MESSAGES: {
  * Where possible, it automatically detects the difference between supported syntaxes:
  *  - AdGuard
  *  - uBlock Origin
- *  - Adblock Plus
+ *  - Adblock Plus.
  *
  * If the syntax is common / cannot be determined, the parser gives `Common` syntax.
  *
@@ -30,22 +30,25 @@ export declare class CosmeticRuleParser extends BaseParser {
      * Determines whether a rule is a cosmetic rule. The rule is considered cosmetic if it
      * contains a cosmetic rule separator.
      *
-     * @param raw Raw rule
-     * @returns `true` if the rule is a cosmetic rule, `false` otherwise
+     * @param raw Raw rule.
+     *
+     * @returns `true` if the rule is a cosmetic rule, `false` otherwise.
      */
     static isCosmeticRule(raw: string): boolean;
     /**
      * Parses a cosmetic rule. The structure of the cosmetic rules:
      *  - pattern (AdGuard pattern can have modifiers, other syntaxes don't)
      *  - separator
-     *  - body
+     *  - 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
-     * Parsed cosmetic rule AST or null if it failed to parse based on the known cosmetic rules
-     * @throws If the input matches the cosmetic rule pattern but syntactically invalid
+     * Parsed cosmetic rule AST or null if it failed to parse based on the known cosmetic rules.
+     *
+     * @throws If the input matches the cosmetic rule pattern but syntactically invalid.
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): AnyCosmeticRule | null;
 }

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

@@ -1,15 +1,15 @@
-import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { type HtmlFilteringRuleBody, type Value } 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:
+ * 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.
+ * 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}

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

@@ -1,17 +1,17 @@
-import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { type HtmlFilteringRuleBody, type Value } 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:
+ * 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.
+ * 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}

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

@@ -1,18 +1,18 @@
-import { type Value, type HtmlFilteringRuleBody } from '../../../nodes/index.js';
+import { type HtmlFilteringRuleBody, type Value } 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:
+ * 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.
+ * 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}

package/dist/types/parser/cosmetic/scriptlet-body/abp-snippet-injection-body-parser.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file uBlock scriptlet injection body parser
+ * @file UBlock scriptlet injection body parser.
  */
 import { type ScriptletInjectionRuleBody } from '../../../nodes/index.js';
 import { BaseParser } from '../../base-parser.js';
@@ -7,12 +7,12 @@ import { BaseParser } from '../../base-parser.js';
  * `AbpSnippetInjectionBodyParser` is responsible for parsing the body of an Adblock Plus-style snippet rule.
  *
  * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com#$#snippet0 arg0
  * ```
  *
- * but it didn't check if the scriptlet `snippet0` actually supported by any adblocker.
+ * But it didn't check if the scriptlet `snippet0` actually supported by any adblocker..
  *
  * @see {@link https://help.eyeo.com/adblockplus/snippet-filters-tutorial}
  */
@@ -23,8 +23,11 @@ export declare class AbpSnippetInjectionBodyParser extends BaseParser {
      * @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 scriptlet call body
-     * @throws If the body is syntactically incorrect
+     *
+     * @returns Node of the parsed scriptlet call body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
      * @example
      * ```
      * #$#snippet0 arg0

package/dist/types/parser/cosmetic/scriptlet-body/adg-scriptlet-injection-body-parser.d.ts

@@ -1,18 +1,18 @@
 /**
- * @file AdGuard scriptlet injection body parser
+ * @file AdGuard scriptlet injection body parser.
  */
-import { BaseParser } from '../../base-parser.js';
 import { type ScriptletInjectionRuleBody } from '../../../nodes/index.js';
+import { BaseParser } from '../../base-parser.js';
 /**
  * `AdgScriptletInjectionBodyParser` is responsible for parsing the body of an AdGuard-style scriptlet rule.
  *
  * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com#%#//scriptlet('scriptlet0', 'arg0')
  * ```
  *
- * but it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker.
+ * But it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker..
  *
  * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#scriptlets}
  */
@@ -36,8 +36,11 @@ export declare class AdgScriptletInjectionBodyParser extends BaseParser {
      * @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 scriptlet call body
-     * @throws If the body is syntactically incorrect
+     *
+     * @returns Node of the parsed scriptlet call body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
      * @example
      * ```
      * //scriptlet('scriptlet0', 'arg0')

package/dist/types/parser/cosmetic/scriptlet-body/ubo-scriptlet-injection-body-parser.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file uBlock scriptlet injection body parser
+ * @file UBlock scriptlet injection body parser.
  */
 import { type ScriptletInjectionRuleBody } from '../../../nodes/index.js';
 import { BaseParser } from '../../base-parser.js';
@@ -7,12 +7,12 @@ import { BaseParser } from '../../base-parser.js';
  * `UboScriptletInjectionBodyParser` is responsible for parsing the body of a uBlock-style scriptlet rule.
  *
  * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com##+js(scriptlet0, arg0)
  * ```
  *
- * but it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker.
+ * But it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker..
  *
  * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#scriptlet-injection}
  */
@@ -33,8 +33,11 @@ export declare class UboScriptletInjectionBodyParser extends BaseParser {
      * @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 scriptlet call body
-     * @throws If the body is syntactically incorrect
+     *
+     * @returns Node of the parsed scriptlet call body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
      * @example
      * ```
      * ##+js(scriptlet0, arg0)

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

@@ -1,6 +1,6 @@
+import { type ComplexSelector, type SelectorList } from '../../../nodes/index.js';
+import { type CssTokenStream, type TokenData } from '../../css/css-token-stream.js';
 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.
  */

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

@@ -4,12 +4,12 @@ import { BaseParser } from '../../base-parser.js';
  * Class responsible for parsing selector lists.
  *
  * Please note that the parser will parse any selector list if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * div[attr1="value1"] > h1[attr2="value2"], span[attr3="value3"]
  * ```
  *
- * but it didn't check if the given attribute or pseudo-class is valid or not.
+ * But it didn't check if the given attribute or pseudo-class is valid or not..
  *
  * @see {@link https://www.w3.org/TR/selectors-4/#selector-list}'
  */

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

@@ -20,6 +20,7 @@ export declare class AdgCssInjectionParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns Parsed AdGuard CSS injection {@link CssInjectionRuleBody}.
+     *
      * @throws An {@link AdblockSyntaxError} if the selector list is syntactically invalid.
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): CssInjectionRuleBody;

package/dist/types/parser/css/balancing.d.ts

@@ -5,14 +5,16 @@ import { type OnErrorCallback, type OnTokenCallback, type TokenizerContextFuncti
 /**
  * Utility type to get the last element from a tuple, handling optional last elements correctly.
  *
- * @param T - The tuple to extract the last element from.
+ * @param T The tuple to extract the last element from.
+ *
  * @returns The last element of the tuple if present; `L | undefined` if the last element is optional.
  */
 type Last<T extends unknown[]> = T extends [...infer _I, infer L] ? L : T extends [...infer _I, (infer L)?] ? L | undefined : never;
 /**
  * Utility type to remove the last element from a tuple, handling optional last elements correctly.
  *
- * @param T - The tuple to remove the last element from.
+ * @param T The tuple to remove the last element from.
+ *
  * @returns A tuple without the last element. If the last element is optional, it is also removed.
  */
 type OmitLast<T extends unknown[]> = T extends [...infer Rest, infer _Last] ? Rest : T extends [...infer Rest, (infer _Last)?] ? Rest : never;
@@ -29,6 +31,7 @@ type OnTokenCallbackParameters = Parameters<OnTokenCallback>;
  * @param props Additional properties of the token (if any - can be `undefined`, depending on the token type).
  * @param balance Calculated balance level of the token.
  * @param stop Function to halt tokenization.
+ *
  * @note This function is keeping the same signature as the original `OnTokenCallback` to avoid breaking changes,
  * just adding the `balance` parameter at the end.
  */
@@ -36,21 +39,23 @@ export type OnBalancedTokenCallback = (...args: [...OmitLast<OnTokenCallbackPara
 /**
  * Tokenize and ensure balanced pairs for standard CSS.
  *
- * @param raw Raw CSS string to tokenize
- * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter
- * @param onError Error callback which is called when a parsing error is found (optional)
- * @param functionHandlers Custom function handlers (optional)
- * @throws If the input is not balanced
+ * @param raw Raw CSS string to tokenize.
+ * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter.
+ * @param onError Error callback which is called when a parsing error is found (optional).
+ * @param functionHandlers Custom function handlers (optional).
+ *
+ * @throws If the input is not balanced.
  */
 export declare const tokenizeBalanced: (raw: string, onToken: OnBalancedTokenCallback, onError?: OnErrorCallback, functionHandlers?: Map<number, TokenizerContextFunction>) => void;
 /**
  * Tokenize and ensure balanced pairs for function calls.
  *
- * @param raw Raw CSS string to tokenize
- * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter
- * @param onError Error callback which is called when a parsing error is found (optional)
- * @param functionHandlers Custom function handlers (optional)
- * @throws If the input is not balanced
+ * @param raw Raw CSS string to tokenize.
+ * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter.
+ * @param onError Error callback which is called when a parsing error is found (optional).
+ * @param functionHandlers Custom function handlers (optional).
+ *
+ * @throws If the input is not balanced.
  */
 export declare const tokenizeFnBalanced: (raw: string, onToken: OnBalancedTokenCallback, onError?: OnErrorCallback, functionHandlers?: Map<number, TokenizerContextFunction>) => void;
 export {};

package/dist/types/parser/css/css-token-stream.d.ts

@@ -92,6 +92,7 @@ export declare class CssTokenStream {
      * Gets the token at the specified index.
      *
      * @param index The index of the token to retrieve.
+     *
      * @returns The token at the specified index or undefined if the index is out of bounds.
      */
     get(index?: number): TokenData | undefined;
@@ -99,7 +100,9 @@ export declare class CssTokenStream {
      * Gets the token at the specified index or throws if no token is found at the specified index.
      *
      * @param index The index of the token to retrieve.
+     *
      * @returns The token at the specified index or undefined if the index is out of bounds.
+     *
      * @throws If no token is found at the specified index.
      */
     getOrFail(index?: number): TokenData;
@@ -107,6 +110,7 @@ export declare class CssTokenStream {
      * Gets the source fragment of the token at the specified index.
      *
      * @param index The index of the token to retrieve the fragment for.
+     *
      * @returns The source fragment of the token or an empty string if the index is out of bounds.
      */
     fragment(index?: number): string;
@@ -120,6 +124,7 @@ export declare class CssTokenStream {
      * Looks ahead in the stream without changing the index.
      *
      * @param index The relative index to look ahead to, starting from the current index.
+     *
      * @returns The next token or undefined if the end of the stream is reached.
      */
     lookahead(index?: number): TokenData | undefined;
@@ -127,6 +132,7 @@ export declare class CssTokenStream {
      * Looks behind in the stream without changing the index.
      *
      * @param index The relative index to look behind to, starting from the current index.
+     *
      * @returns The previous token or undefined if the current token is the first in the stream.
      */
     lookbehind(index?: number): TokenData | undefined;
@@ -151,6 +157,7 @@ export declare class CssTokenStream {
      *
      * @param type The type of token to skip until.
      * @param balance The balance level of the token to skip until.
+     *
      * @returns The number of tokens skipped.
      */
     skipUntil(type: TokenType, balance?: number): number;
@@ -161,6 +168,7 @@ export declare class CssTokenStream {
      *
      * @param type The type of token to skip until.
      * @param balance The balance level of the token to skip until.
+     *
      * @returns An array containing the number of tokens skipped and the number of tokens skipped without leading and
      * trailing whitespace tokens.
      */
@@ -174,6 +182,7 @@ export declare class CssTokenStream {
      *
      * @param type The expected token type.
      * @param data Optional expectation data.
+     *
      * @throws If the end of the stream is reached or if the token type or expectation data does not match.
      */
     expect(type: TokenType, data?: ExpectationData): void;
@@ -181,6 +190,7 @@ export declare class CssTokenStream {
      * Gets the balance level of the token at the specified index.
      *
      * @param index The index of the token to retrieve the balance level for.
+     *
      * @returns The balance level of the token or 0 if the index is out of bounds.
      */
     getBalance(index?: number): number;
@@ -213,6 +223,7 @@ export declare class CssTokenStream {
      * 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.
      */

package/dist/types/parser/css/ubo-selector-parser.d.ts

@@ -20,7 +20,9 @@ export declare const ERROR_MESSAGES: {
  *
  * @param name Pseudo name.
  * @param wrapper Wrapper pseudo name (eg. `not`) (optional, defaults to `undefined`).
+ *
  * @returns Formatted pseudo name.
+ *
  * @example
  * ```ts
  * formatPseudoName('matches-path', 'not'); // => ':not(:matches-path(...))'
@@ -40,6 +42,7 @@ export declare class UboSelectorParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns Parsed uBO selector {@link UboSelectorParser}.
+     *
      * @throws An {@link AdblockSyntaxError} if the selector list is syntactically invalid.
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): UboSelector;

package/dist/types/parser/filterlist-parser.d.ts

@@ -11,7 +11,11 @@ export declare class FilterListParser extends BaseParser {
      * @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 AST of the source code (list of rules)
+     *
+     * @returns AST of the source code (list of rules).
+     *
+     * @throws If one of the rules is syntactically invalid (if `tolerant` is `false`).
+     *
      * @example
      * ```js
      * import { readFileSync } from 'fs';
@@ -23,7 +27,6 @@ export declare class FilterListParser extends BaseParser {
      * // Parse the filter list content, then do something with the AST
      * const ast = FilterListParser.parse(content);
      * ```
-     * @throws If one of the rules is syntactically invalid (if `tolerant` is `false`)
      */
     static parse(raw: string, options?: import("./options.js").ParserOptions, baseOffset?: number): FilterList;
 }

package/dist/types/parser/misc/app-list-parser.d.ts

@@ -15,6 +15,7 @@ export declare class AppListParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns App list AST.
+     *
      * @throws An {@link AdblockSyntaxError} if the app list is syntactically invalid.
      * @throws An {@link Error} if the options are invalid.
      */

package/dist/types/parser/misc/domain-list-parser.d.ts

@@ -3,22 +3,24 @@ import { BaseParser } from '../base-parser.js';
 /**
  * `DomainListParser` is responsible for parsing a domain list.
  *
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
+ *
  * @example
  * - If the rule is `example.com,~example.net##.ads`, the domain list is `example.com,~example.net`.
  * - If the rule is `ads.js^$script,domains=example.com|~example.org`, the domain list is `example.com|~example.org`.
  * This parser is responsible for parsing these domain lists.
- * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
  */
 export declare class DomainListParser extends BaseParser {
     /**
-     * Parses a domain list, eg. `example.com,example.org,~example.org`
+     * Parses a domain list, eg. `example.com,example.org,~example.org`.
      *
      * @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.
-     * @param separator Separator character (default: comma)
+     * @param separator Separator character (default: comma).
      *
      * @returns Domain list AST.
+     *
      * @throws An {@link AdblockSyntaxError} if the domain list is syntactically invalid.
      * @throws An {@link Error} if the options are invalid.
      */

package/dist/types/parser/misc/list-items-parser.d.ts

@@ -18,15 +18,17 @@ export declare class ListItemsParser {
      * Parses a `raw` modifier value which may be represented as a list of items separated by `separator`.
      * Needed for $app, $denyallow, $domain, $method.
      *
+     * @template T Type of the list items.
+     *
      * @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.
-     * @param separator Separator character (default: comma)
+     * @param separator Separator character (default: comma).
      * @param type Type of the list items (default: {@link ListItemNodeType.Domain}).
-     * @template T Type of the list items.
      *
      * @returns List of parsed items.
-     * @throws An {@link AdblockSyntaxError} if the list is syntactically invalid
+     *
+     * @throws An {@link AdblockSyntaxError} if the list is syntactically invalid.
      *
      * @example
      * - parses an app list — `com.example.app|Example.exe`

package/dist/types/parser/misc/logical-expression-parser.d.ts

@@ -23,10 +23,12 @@ export declare class LogicalExpressionParser extends BaseParser {
     /**
      * Split the expression into tokens.
      *
-     * @param raw Source code of the expression
+     * @param raw Source code of the expression.
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @returns Token list
-     * @throws {AdblockSyntaxError} If the expression is invalid
+     *
+     * @returns Token list.
+     *
+     * @throws {AdblockSyntaxError} If the expression is invalid.
      */
     private static tokenize;
     /**
@@ -35,8 +37,10 @@ export declare class LogicalExpressionParser extends BaseParser {
      * @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 Parsed expression
-     * @throws {AdblockSyntaxError} If the expression is invalid
+     *
+     * @returns Parsed expression.
+     *
+     * @throws {AdblockSyntaxError} If the expression is invalid.
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): AnyExpressionNode;
 }

package/dist/types/parser/misc/method-list-parser.d.ts

@@ -15,6 +15,7 @@ export declare class MethodListParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns Method list AST.
+     *
      * @throws An {@link AdblockSyntaxError} if the method list is syntactically invalid.
      * @throws An {@link Error} if the options are invalid.
      */

package/dist/types/parser/misc/modifier-list.d.ts

@@ -18,7 +18,8 @@ export declare class ModifierListParser extends BaseParser {
      * @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 Parsed modifiers interface
+     *
+     * @returns Parsed modifiers interface.
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): ModifierList;
 }

package/dist/types/parser/misc/modifier-parser.d.ts

@@ -14,7 +14,8 @@ export declare class ModifierParser extends BaseParser {
      * @param options Global parser options.
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
-     * @returns Parsed modifier
+     * @returns Parsed modifier.
+     *
      * @throws An error if modifier name or value is empty.
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number): Modifier;

package/dist/types/parser/misc/parameter-list-parser.d.ts

@@ -10,8 +10,9 @@ export declare class ParameterListParser extends BaseParser {
      * @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.
-     * @param separator Separator character (default: comma)
-     * @returns Parameter list AST
+     * @param separator Separator character (default: comma).
+     *
+     * @returns Parameter list AST.
      */
     static parse(raw: string, options?: import("../index.js").ParserOptions, baseOffset?: number, separator?: string): ParameterList;
 }

package/dist/types/parser/misc/stealth-option-list-parser.d.ts

@@ -15,6 +15,7 @@ export declare class StealthOptionListParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns Stealth option list AST.
+     *
      * @throws An {@link AdblockSyntaxError} if the stealth option list is syntactically invalid.
      * @throws An {@link Error} if the options are invalid.
      */