@adguard/agtree 4.0.1 → 4.0.3

package/dist/types/converter/base-interfaces/base-converter.d.ts

@@ -1,42 +1,48 @@
 /**
- * @file Base class for converters
+ * @file Base class for 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.
  */
 import { type ConversionResult } from './conversion-result.js';
 /**
- * Basic class for rule converters
+ * Basic class for rule converters.
  */
 export declare class BaseConverter {
     /**
-     * Converts some data to AdGuard format
+     * Converts some data to AdGuard format.
+     *
+     * @param data Data to convert.
      *
-     * @param data Data to convert
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the data is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the data is invalid or incompatible.
      */
     static convertToAdg(data: unknown): ConversionResult<unknown>;
     /**
-     * Converts some data to Adblock Plus format
+     * Converts some data to Adblock Plus format.
+     *
+     * @param data Data to convert.
      *
-     * @param data Data to convert
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the data is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the data is invalid or incompatible.
      */
     static convertToAbp(data: unknown): ConversionResult<unknown>;
     /**
-     * Converts some data to uBlock Origin format
+     * Converts some data to uBlock Origin format.
+     *
+     * @param data Data to convert.
      *
-     * @param data Data to convert
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the data is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the data is invalid or incompatible.
      */
     static convertToUbo(data: unknown): ConversionResult<unknown>;
 }

package/dist/types/converter/base-interfaces/conversion-result.d.ts

@@ -1,43 +1,47 @@
 /**
- * @file Conversion result interface and helper functions
+ * @file Conversion result interface and helper functions.
  */
 import { type Node } from '../../nodes/index.js';
 /**
- * Common conversion result interface
+ * Common conversion result interface.
  *
- * @template T Type of the item to convert
- * @template U Type of the conversion result (defaults to `T`, but can be `T[]` as well)
+ * @template T Type of the item to convert.
+ * @template U Type of the conversion result (defaults to `T`, but can be `T[]` as well).
  */
 export interface ConversionResult<T, U extends T | T[] = T> {
     /**
-     * Conversion result
+     * Conversion result.
      */
     result: U;
     /**
-     * Indicates whether the input item was converted
+     * Indicates whether the input item was converted.
      */
     isConverted: boolean;
 }
 /**
- * Adblock rule node conversion result interface, where the conversion result is an array of rules
+ * Adblock rule node conversion result interface, where the conversion result is an array of rules.
  */
 export type NodeConversionResult<T extends Node> = ConversionResult<T, T[]>;
 /**
  * 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.
  */
 export declare function createConversionResult<T, U extends T | T[] = T>(result: U, isConverted: boolean): ConversionResult<T, U>;
 /**
  * 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.
  */
 export declare function createNodeConversionResult<T extends Node>(nodes: T[], isConverted: boolean): NodeConversionResult<T>;

package/dist/types/converter/base-interfaces/rule-converter-base.d.ts

@@ -1,44 +1,50 @@
 /**
- * @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.
  */
 import { type Node } from '../../nodes/index.js';
-import { type NodeConversionResult } from './conversion-result.js';
 import { BaseConverter } from './base-converter.js';
+import { type NodeConversionResult } from './conversion-result.js';
 /**
- * Basic class for rule converters
+ * Basic class for rule converters.
  */
 export declare 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: Node): NodeConversionResult<Node>;
     /**
      * 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: Node): NodeConversionResult<Node>;
     /**
      * 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: Node): NodeConversionResult<Node>;
 }

package/dist/types/converter/comment/index.d.ts

@@ -1,23 +1,25 @@
 /**
- * @file Comment rule converter
+ * @file Comment rule converter.
  */
 import { type AnyCommentRule } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { type NodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 /**
- * Comment rule converter class
+ * Comment rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 export declare 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: AnyCommentRule): NodeConversionResult<AnyCommentRule>;
 }

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

@@ -1,23 +1,25 @@
 /**
- * @file CSS injection rule converter
+ * @file CSS injection rule converter.
  */
 import { type CssInjectionRule } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { type NodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 /**
- * CSS injection rule converter class
+ * CSS injection rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 export declare 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: CssInjectionRule): NodeConversionResult<CssInjectionRule>;
 }

package/dist/types/converter/cosmetic/element-hiding.d.ts

@@ -1,23 +1,25 @@
 /**
- * @file Element hiding rule converter
+ * @file Element hiding rule converter.
  */
 import { type ElementHidingRule } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { type NodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 /**
- * Element hiding rule converter class
+ * Element hiding rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 export declare 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: ElementHidingRule): NodeConversionResult<ElementHidingRule>;
 }

package/dist/types/converter/cosmetic/header-removal.d.ts

@@ -1,28 +1,31 @@
 /**
- * @file Converter for request header removal rules
+ * @file Converter for request header removal rules.
  */
 import { type AnyRule } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { type NodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 export declare const ERROR_MESSAGES: {
     EMPTY_PARAMETER: string;
     EXPECTED_END_OF_RULE: string;
     MULTIPLE_DOMAINS_NOT_SUPPORTED: string;
 };
 /**
- * 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).
  */
 export declare 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/types/converter/cosmetic/html.d.ts

@@ -1,9 +1,9 @@
 /**
- * @file HTML filtering rule converter
+ * @file HTML filtering rule converter.
  */
 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';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 /**
  * Error messages used in HTML filtering rule conversion.
  */
@@ -27,9 +27,9 @@ export declare const ERROR_MESSAGES: {
     readonly 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).
  */
 export declare class HtmlRuleConverter extends RuleConverterBase {
     /**
@@ -65,9 +65,9 @@ export declare 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
@@ -102,7 +102,7 @@ export declare 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.
@@ -120,7 +120,7 @@ export declare 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.
@@ -131,7 +131,7 @@ export declare 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.
@@ -141,6 +141,23 @@ export declare class HtmlRuleConverter extends RuleConverterBase {
      * @throws If uBlock-specific pseudo-class selector is found in AdGuard rule.
      */
     private static convertSpecialPseudoClassSelectorAdgToUbo;
+    /**
+     * 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.
+     */
+    private static collectLengthConstraints;
     /**
      * 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.
@@ -150,6 +167,9 @@ export declare 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.
      */

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

@@ -1,33 +1,37 @@
 /**
- * @file Cosmetic rule converter
+ * @file Cosmetic rule converter.
  */
 import { type AnyCosmeticRule, type AnyRule } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { type NodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 /**
- * 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`.
  */
 export declare 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: AnyCosmeticRule): NodeConversionResult<AnyRule>;
     /**
      * 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: AnyCosmeticRule): NodeConversionResult<AnyRule>;
 }

package/dist/types/converter/cosmetic/rule-modifiers/adg.d.ts

@@ -1,21 +1,24 @@
 /**
- * @file Cosmetic rule modifier converter from uBO to ADG
+ * @file Cosmetic rule modifier converter from uBO to ADG.
  */
 import { type ModifierList } from '../../../nodes/index.js';
 import { type ConversionResult } from '../../base-interfaces/conversion-result.js';
 /**
- * Helper class for converting cosmetic rule modifiers from uBO to ADG
+ * Helper class for converting cosmetic rule modifiers from uBO to ADG.
  */
 export declare class AdgCosmeticRuleModifierConverter {
     /**
      * Converts a uBO cosmetic rule modifier list to ADG, if possible.
      *
-     * @param modifierList Cosmetic rule modifier list node to convert
+     * @see {@link https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#cosmetic-filter-operators}
+     *
+     * @param modifierList Cosmetic rule modifier list node to convert.
+     *
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the modifier list cannot be converted
-     * @see {@link https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#cosmetic-filter-operators}
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the modifier list cannot be converted.
      */
     static convertFromUbo(modifierList: ModifierList): ConversionResult<ModifierList>;
 }

package/dist/types/converter/cosmetic/rule-modifiers/ubo.d.ts

@@ -1,21 +1,24 @@
 /**
- * @file Cosmetic rule modifier converter from ADG to uBO
+ * @file Cosmetic rule modifier converter from ADG to uBO.
  */
 import { type DomainList, type ModifierList } from '../../../nodes/index.js';
 import { type ConversionResult } from '../../base-interfaces/conversion-result.js';
 /**
- * Helper class for converting cosmetic rule modifiers from ADG to uBO
+ * Helper class for converting cosmetic rule modifiers from ADG to uBO.
  */
 export declare class UboCosmeticRuleModifierConverter {
     /**
      * Converts a ADG cosmetic rule modifier list to uBO, if possible.
      *
-     * @param modifierList Cosmetic rule modifier list node to convert
+     * @see {@link https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#cosmetic-filter-operators}
+     *
+     * @param modifierList Cosmetic rule modifier list node to convert.
+     *
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the modifier list cannot be converted
-     * @see {@link https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#cosmetic-filter-operators}
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the modifier list cannot be converted.
      */
     static convertFromAdg(modifierList: ModifierList): ConversionResult<{
         modifierList: ModifierList;

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

@@ -1,33 +1,37 @@
 /**
- * @file Scriptlet injection rule converter
+ * @file Scriptlet injection rule converter.
  */
 import { type ScriptletInjectionRule } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { type NodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 /**
- * Scriptlet injection rule converter class
+ * Scriptlet injection rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 export declare class ScriptletRuleConverter extends RuleConverterBase {
     /**
      * Converts a scriptlet 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: ScriptletInjectionRule): NodeConversionResult<ScriptletInjectionRule>;
     /**
      * Converts a scriptlet injection rule to uBlock 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: ScriptletInjectionRule): NodeConversionResult<ScriptletInjectionRule>;
 }

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

@@ -1,6 +1,6 @@
+import { CssTokenStream } from '../../parser/css/css-token-stream.js';
 import { BaseConverter } from '../base-interfaces/base-converter.js';
 import { type ConversionResult } from '../base-interfaces/conversion-result.js';
-import { CssTokenStream } from '../../parser/css/css-token-stream.js';
 export declare const ERROR_MESSAGES: {
     INVALID_ATTRIBUTE_VALUE: string;
 };
@@ -22,19 +22,21 @@ export declare const PseudoElements: {
 };
 export type PseudoElements = typeof PseudoElements[keyof typeof PseudoElements];
 /**
- * CSS selector converter
+ * CSS selector converter.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 export declare class CssSelectorConverter extends BaseConverter {
     /**
-     * Converts Extended CSS elements to AdGuard-compatible ones
+     * Converts Extended CSS elements to AdGuard-compatible ones.
+     *
+     * @param selectorList Selector list to convert.
      *
-     * @param selectorList Selector list to convert
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the rule is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or incompatible.
      */
     static convertToAdg(selectorList: string | CssTokenStream): ConversionResult<string>;
 }

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

@@ -1,6 +1,6 @@
 /**
  * @file Known CSS elements and attributes.
- * TODO: Implement a compatibility table for Extended CSS
+ * TODO: Implement a compatibility table for Extended CSS.
  */
 /**
  * Legacy Extended CSS attribute prefix.