@adguard/agtree 3.0.0 → 3.1.0

package/dist/{esm/serializer/network/network-rule-serializer.mjs → serializer/network/network-rule-serializer.js}

@@ -1,17 +1,17 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ModifierListSerializer } from '../misc/modifier-list-serializer.mjs';
-import { NetworkRuleMarshallingMap } from '../../marshalling-utils/network/network-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.mjs';
+import { NULL } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ModifierListSerializer } from '../misc/modifier-list-serializer.js';
+import { NetworkRuleMarshallingMap } from '../../marshalling-utils/network/network-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.js';
 
 /**
  * `NetworkRuleSerializer` is responsible for serializing network rules.

package/dist/{esm/serializer/rule-serializer.mjs → serializer/rule-serializer.js}

@@ -1,17 +1,17 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { RuleCategory, NetworkRuleType } from '../nodes/index.mjs';
-import { BaseSerializer } from './base-serializer.mjs';
-import { CommentRuleSerializer } from './comment/comment-rule-serializer.mjs';
-import { CosmeticRuleSerializer } from './cosmetic/cosmetic-rule-serializer.mjs';
-import { HostRuleSerializer } from './network/host-rule-serializer.mjs';
-import { NetworkRuleSerializer } from './network/network-rule-serializer.mjs';
-import { EmptyRuleSerializer } from './empty-rule-serializer.mjs';
-import { InvalidRuleSerializer } from './invalid-rule-serializer.mjs';
+import { RuleCategory, NetworkRuleType } from '../nodes/index.js';
+import { BaseSerializer } from './base-serializer.js';
+import { CommentRuleSerializer } from './comment/comment-rule-serializer.js';
+import { CosmeticRuleSerializer } from './cosmetic/cosmetic-rule-serializer.js';
+import { HostRuleSerializer } from './network/host-rule-serializer.js';
+import { NetworkRuleSerializer } from './network/network-rule-serializer.js';
+import { EmptyRuleSerializer } from './empty-rule-serializer.js';
+import { InvalidRuleSerializer } from './invalid-rule-serializer.js';
 
 /**
  * `RuleSerializer` is responsible for serializing the rules.

package/dist/types/common/abp-snippet-injection-body-common.d.ts

@@ -1,8 +1,15 @@
+/**
+ * Common class for the ABP snippet injection body.
+ * This class contains shared constants and utilities for handling ABP snippet injection bodies.
+ */
 export declare class AbpSnippetInjectionBodyCommon {
     /**
      * Error messages used by the parser and generator.
      */
     static ERROR_MESSAGES: {
+        /**
+         * Error message indicating that an ABP snippet call is empty.
+         */
         EMPTY_SCRIPTLET_CALL: string;
     };
 }

package/dist/types/common/ubo-selector-common.d.ts

@@ -1,9 +1,10 @@
 /**
  * Known uBO-specific pseudo-class names.
  */
-export declare const enum UboPseudoName {
-    MatchesMedia = "matches-media",
-    MatchesPath = "matches-path",
-    Remove = "remove",
-    Style = "style"
-}
+export declare const UboPseudoName: {
+    readonly MatchesMedia: "matches-media";
+    readonly MatchesPath: "matches-path";
+    readonly Remove: "remove";
+    readonly Style: "style";
+};
+export type UboPseudoName = typeof UboPseudoName[keyof typeof UboPseudoName];

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

@@ -40,7 +40,7 @@ export declare const redirectsCompatibilityTableData: CompatibilityTable<{
     removed: boolean;
     removalMessage: string | null;
     isBlocking: boolean;
-    resourceTypes: import(".").ResourceType[];
+    resourceTypes: ("object" | "image" | "other" | "font" | "media" | "ping" | "script" | "stylesheet" | "websocket" | "xmlhttprequest" | "main_frame" | "sub_frame")[];
 }>;
 /**
  * Compatibility table data for modifiers.
@@ -64,4 +64,5 @@ export declare const modifiersCompatibilityTableData: CompatibilityTable<{
     exceptionOnly: boolean;
     valueOptional: boolean;
     valueFormat: string | null;
+    valueFormatFlags: string | null;
 }>;

package/dist/types/compatibility-tables/platforms.d.ts

@@ -8,40 +8,42 @@
 /**
  * List of specific platforms.
  */
-export declare enum SpecificPlatform {
-    AdgOsWindows = 1,
-    AdgOsMac = 2,
-    AdgOsAndroid = 4,
-    AdgExtChrome = 8,
-    AdgExtOpera = 16,
-    AdgExtEdge = 32,
-    AdgExtFirefox = 64,
-    AdgCbAndroid = 128,
-    AdgCbIos = 256,
-    AdgCbSafari = 512,
-    UboExtChrome = 1024,
-    UboExtOpera = 2048,
-    UboExtEdge = 4096,
-    UboExtFirefox = 8192,
-    AbpExtChrome = 16384,
-    AbpExtOpera = 32768,
-    AbpExtEdge = 65536,
-    AbpExtFirefox = 131072
-}
+export declare const SpecificPlatform: {
+    readonly AdgOsWindows: 1;
+    readonly AdgOsMac: number;
+    readonly AdgOsAndroid: number;
+    readonly AdgExtChrome: number;
+    readonly AdgExtOpera: number;
+    readonly AdgExtEdge: number;
+    readonly AdgExtFirefox: number;
+    readonly AdgCbAndroid: number;
+    readonly AdgCbIos: number;
+    readonly AdgCbSafari: number;
+    readonly UboExtChrome: number;
+    readonly UboExtOpera: number;
+    readonly UboExtEdge: number;
+    readonly UboExtFirefox: number;
+    readonly AbpExtChrome: number;
+    readonly AbpExtOpera: number;
+    readonly AbpExtEdge: number;
+    readonly AbpExtFirefox: number;
+};
+export type SpecificPlatform = typeof SpecificPlatform[keyof typeof SpecificPlatform];
 /**
  * List of generic platforms (combinations of specific platforms).
  */
-export declare enum GenericPlatform {
-    AdgOsAny = 7,
-    AdgSafariAny = 768,
-    AdgExtChromium = 56,
-    AdgExtAny = 120,
-    AdgAny = 1023,
-    UboExtChromium = 7168,
-    UboExtAny = 15360,
-    UboAny = 15360,
-    AbpExtChromium = 114688,
-    AbpExtAny = 245760,
-    AbpAny = 245760,
-    Any = 262143
-}
+export declare const GenericPlatform: {
+    readonly AdgOsAny: number;
+    readonly AdgSafariAny: number;
+    readonly AdgExtChromium: number;
+    readonly AdgExtAny: number;
+    readonly AdgAny: number;
+    readonly UboExtChromium: number;
+    readonly UboExtAny: number;
+    readonly UboAny: number;
+    readonly AbpExtChromium: number;
+    readonly AbpExtAny: number;
+    readonly AbpAny: number;
+    readonly Any: number;
+};
+export type GenericPlatform = typeof GenericPlatform[keyof typeof GenericPlatform];

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

@@ -117,18 +117,7 @@ export declare const baseRefineLogic: (data: zod.infer<typeof baseCompatibilityD
  *
  * @returns Base file schema.
  */
-export declare const baseFileSchema: <T extends {
-    name: string;
-    description: string | null;
-    aliases: string[] | null;
-    docs: string | null;
-    versionAdded: string | null;
-    versionRemoved: string | null;
-    deprecated: boolean;
-    deprecationMessage: string | null;
-    removed: boolean;
-    removalMessage: string | null;
-}>(dataSchema: zod.ZodType<T>) => zod.ZodPipeline<zod.ZodEffects<zod.ZodRecord<zod.ZodAny, zod.ZodAny>, Record<any, any>, Record<any, any>>, zod.ZodRecord<zod.ZodEffects<zod.ZodString, number, string>, zod.ZodType<T, zod.ZodTypeDef, T>>>;
+export declare const baseFileSchema: <T extends BaseCompatibilityDataSchema>(dataSchema: zod.ZodType<T>) => zod.ZodPipeline<zod.ZodEffects<zod.ZodRecord<zod.ZodAny, zod.ZodAny>, Record<any, any>, Record<any, any>>, zod.ZodRecord<zod.ZodEffects<zod.ZodString, number, string>, zod.ZodType<T, zod.ZodTypeDef, T>>>;
 /**
  * Type of the base file schema.
  */

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

@@ -2,6 +2,10 @@
  * @file Schema for modifier data.
  */
 import zod from 'zod';
+/**
+ * Known validators that don't need to be validated as regex.
+ */
+export declare const KNOWN_VALIDATORS: ReadonlySet<string>;
 /**
  * Zod schema for modifier data.
  */
@@ -24,6 +28,7 @@ export declare const modifierDataSchema: zod.ZodEffects<zod.ZodTypeAny, {
     exceptionOnly: boolean;
     valueOptional: boolean;
     valueFormat: string | null;
+    valueFormatFlags: string | null;
 }, any>;
 /**
  * Type of the modifier data schema.

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: import("./resource-type").ResourceType[];
+    resourceTypes: ("object" | "image" | "other" | "font" | "media" | "ping" | "script" | "stylesheet" | "websocket" | "xmlhttprequest" | "main_frame" | "sub_frame")[];
 }, any>;
 /**
  * Type of the redirect data schema.

package/dist/types/compatibility-tables/schemas/resource-type.d.ts

@@ -7,21 +7,35 @@ import zod from 'zod';
  *
  * @see {@link https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/#type-ResourceType}
  */
-export declare enum ResourceType {
-    MainFrame = "main_frame",
-    SubFrame = "sub_frame",
-    Stylesheet = "stylesheet",
-    Script = "script",
-    Image = "image",
-    Font = "font",
-    Object = "object",
-    XmlHttpRequest = "xmlhttprequest",
-    Ping = "ping",
-    Media = "media",
-    WebSocket = "websocket",
-    Other = "other"
-}
+export declare const ResourceType: {
+    readonly MainFrame: "main_frame";
+    readonly SubFrame: "sub_frame";
+    readonly Stylesheet: "stylesheet";
+    readonly Script: "script";
+    readonly Image: "image";
+    readonly Font: "font";
+    readonly Object: "object";
+    readonly XmlHttpRequest: "xmlhttprequest";
+    readonly Ping: "ping";
+    readonly Media: "media";
+    readonly WebSocket: "websocket";
+    readonly Other: "other";
+};
+export type ResourceType = typeof ResourceType[keyof typeof ResourceType];
 /**
  * Resource type schema.
  */
-export declare const resourceTypeSchema: zod.ZodNativeEnum<typeof ResourceType>;
+export declare const resourceTypeSchema: zod.ZodNativeEnum<{
+    readonly MainFrame: "main_frame";
+    readonly SubFrame: "sub_frame";
+    readonly Stylesheet: "stylesheet";
+    readonly Script: "script";
+    readonly Image: "image";
+    readonly Font: "font";
+    readonly Object: "object";
+    readonly XmlHttpRequest: "xmlhttprequest";
+    readonly Ping: "ping";
+    readonly Media: "media";
+    readonly WebSocket: "websocket";
+    readonly Other: "other";
+}>;

package/dist/types/compatibility-tables/utils/zod-camelcase.d.ts

@@ -12,4 +12,4 @@ import { type CamelCasedPropertiesDeep } from 'type-fest';
  *
  * @see {@link https://github.com/colinhacks/zod/issues/486#issuecomment-1501097361}
  */
-export declare const zodToCamelCase: <T extends zod.ZodTypeAny>(zod: T) => zod.ZodEffects<zod.ZodTypeAny, CamelCasedPropertiesDeep<T["_output"]>, any>;
+export declare const zodToCamelCase: <T extends zod.ZodTypeAny>(zod: T) => zod.ZodEffects<zod.ZodTypeAny, CamelCasedPropertiesDeep<T["_output"]>>;

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

@@ -0,0 +1,24 @@
+/**
+ * @file Cosmetic rule modifier converter from ADG to uBO
+ */
+import { type DomainList, type ModifierList } from '../../../nodes';
+import { type ConversionResult } from '../../base-interfaces/conversion-result';
+/**
+ * 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
+     * @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}
+     */
+    static convertFromAdg(modifierList: ModifierList): ConversionResult<{
+        modifierList: ModifierList;
+        domains?: DomainList;
+    }>;
+}

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

@@ -4,6 +4,23 @@ import { CssTokenStream } from '../../parser/css/css-token-stream';
 export declare const ERROR_MESSAGES: {
     INVALID_ATTRIBUTE_VALUE: string;
 };
+export declare const PseudoClasses: {
+    readonly AbpContains: "-abp-contains";
+    readonly AbpHas: "-abp-has";
+    readonly Contains: "contains";
+    readonly Has: "has";
+    readonly HasText: "has-text";
+    readonly MatchesCss: "matches-css";
+    readonly MatchesCssAfter: "matches-css-after";
+    readonly MatchesCssBefore: "matches-css-before";
+    readonly Not: "not";
+};
+export type PseudoClasses = typeof PseudoClasses[keyof typeof PseudoClasses];
+export declare const PseudoElements: {
+    readonly After: "after";
+    readonly Before: "before";
+};
+export type PseudoElements = typeof PseudoElements[keyof typeof PseudoElements];
 /**
  * CSS selector converter
  *

package/dist/types/deserializer/comment/comment-rule-deserializer.d.ts

@@ -2,60 +2,7 @@ import { type AnyCommentRule } from '../../nodes';
 import { BaseDeserializer } from '../base-deserializer';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
 /**
- * `CommentRuleSerializer` is responsible for serializing any comment-like adblock rules.
- *
- * @example
- * Example rules:
- *  - Adblock agent rules:
- *      - ```adblock
- *        [AdGuard]
- *        ```
- *      - ```adblock
- *        [Adblock Plus 2.0]
- *        ```
- *      - etc.
- *  - AdGuard hint rules:
- *      - ```adblock
- *        !+ NOT_OPTIMIZED
- *        ```
- *      - ```adblock
- *        !+ NOT_OPTIMIZED PLATFORM(windows)
- *        ```
- *      - etc.
- *  - Pre-processor rules:
- *      - ```adblock
- *        !#if (adguard)
- *        ```
- *      - ```adblock
- *        !#endif
- *        ```
- *      - etc.
- *  - Metadata rules:
- *      - ```adblock
- *        ! Title: My List
- *        ```
- *      - ```adblock
- *        ! Version: 2.0.150
- *        ```
- *      - etc.
- *  - AGLint inline config rules:
- *      - ```adblock
- *        ! aglint-enable some-rule
- *        ```
- *      - ```adblock
- *        ! aglint-disable some-rule
- *        ```
- *      - etc.
- *  - Simple comments:
- *      - Regular version:
- *        ```adblock
- *        ! This is just a comment
- *        ```
- *      - uBlock Origin / "hostlist" version:
- *        ```adblock
- *        # This is just a comment
- *        ```
- *      - etc.
+ * `CommentRuleDeserializer` is responsible for deserializing any comment-like adblock rules.
  */
 export declare class CommentRuleDeserializer extends BaseDeserializer {
     /**

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

@@ -1,6 +1,12 @@
 import { type AnyCosmeticRule } from '../../nodes';
 import { BaseDeserializer } from '../base-deserializer';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * Deserializer for cosmetic rules.
+ * Converts binary data into structured cosmetic rule nodes, supporting various types
+ * like element hiding, CSS injection, scriptlet injection, JavaScript injection, and HTML filtering.
+ * Handles rule type, syntax, exceptions, separators, modifiers, and domain lists.
+ */
 export declare class CosmeticRuleDeserializer extends BaseDeserializer {
     /**
      * Deserializes a cosmetic rule node from binary format.

package/dist/types/deserializer/cosmetic/css-injection-body-deserializer.d.ts

@@ -1,6 +1,9 @@
 import { type CssInjectionRuleBody } from '../../nodes';
 import { BaseDeserializer } from '../base-deserializer';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * Deserializes CSS injection rule body nodes from binary format.
+ */
 export declare class CssInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes CSS injection rule body node from binary format.

package/dist/types/deserializer/cosmetic/element-hiding-body-deserializer.d.ts

@@ -1,6 +1,10 @@
 import { BaseDeserializer } from '../base-deserializer';
 import { type ElementHidingRuleBody } from '../../nodes';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * Deserializes element hiding rule body nodes from binary data.
+ * Populates the provided node with the deserialized data.
+ */
 export declare class ElementHidingBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes an element hiding rule body node from binary format.

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

@@ -1,6 +1,10 @@
 import { type ScriptletInjectionRuleBody } from '../../../nodes';
 import { BaseDeserializer } from '../../base-deserializer';
 import { type InputByteBuffer } from '../../../utils/input-byte-buffer';
+/**
+ * Deserializer for ABP snippet injection rule body nodes.
+ * Converts binary data into a structured format using a map of frequently used arguments.
+ */
 export declare class AbpSnippetInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a scriptlet call body node from binary format.

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

@@ -1,6 +1,11 @@
 import { type ScriptletInjectionRuleBody } from '../../../nodes';
 import { BaseDeserializer } from '../../base-deserializer';
 import { type InputByteBuffer } from '../../../utils/input-byte-buffer';
+/**
+ * Deserializer for AdGuard scriptlet injection body nodes.
+ * Converts binary data into a structured scriptlet call body node specific to AdGuard,
+ * using a predefined deserialization map for frequently used scriptlet arguments.
+ */
 export declare class AdgScriptletInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a scriptlet call body node from binary format.

package/dist/types/deserializer/cosmetic/scriptlet-body/scriptlet-body-deserializer.d.ts

@@ -1,6 +1,10 @@
 import { type ScriptletInjectionRuleBody } from '../../../nodes';
 import { BaseDeserializer } from '../../base-deserializer';
 import { type InputByteBuffer } from '../../../utils/input-byte-buffer';
+/**
+ * Deserializes binary data into scriptlet body nodes.
+ * Optionally uses a map of frequently used scriptlet arguments.
+ */
 export declare class ScriptletBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a hint rule node from binary format.

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

@@ -2,12 +2,15 @@ import { type ScriptletInjectionRuleBody } from '../../../nodes';
 import { BaseDeserializer } from '../../base-deserializer';
 import { type InputByteBuffer } from '../../../utils/input-byte-buffer';
 export declare const getFrequentPlatformsDeserializationMap: () => Map<number, string>;
+/**
+ * Deserializes uBlock Origin scriptlet injection body nodes from binary data.
+ */
 export declare class UboScriptletInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a scriptlet call body node from binary format.
      *
      * @param buffer ByteBuffer for reading binary data.
-     * @param node Destination node.
+     * @param node Destination node to populate with deserialized data.
      * @throws If the binary data is malformed.
      */
     static deserialize(buffer: InputByteBuffer, node: Partial<ScriptletInjectionRuleBody>): void;

package/dist/types/deserializer/empty-rule-deserializer.d.ts

@@ -1,6 +1,10 @@
 import { BaseDeserializer } from './base-deserializer';
 import { type EmptyRule } from '../nodes';
 import { type InputByteBuffer } from '../utils/input-byte-buffer';
+/**
+ * Deserializer for empty rule nodes.
+ * This class handles the deserialization of empty rule nodes from binary format.
+ */
 export declare class EmptyRuleDeserializer extends BaseDeserializer {
     /**
      * Deserializes an empty rule node from binary format.

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

@@ -1,6 +1,10 @@
 import { type FilterList } from '../nodes';
 import { BaseDeserializer } from './base-deserializer';
 import { type InputByteBuffer } from '../utils/input-byte-buffer';
+/**
+ * Deserializer for filter lists.
+ * Converts binary data into filter list nodes.
+ */
 export declare class FilterListDeserializer extends BaseDeserializer {
     /**
      * Deserializes a filter list node from binary format.

package/dist/types/deserializer/invalid-rule-deserializer.d.ts

@@ -1,6 +1,10 @@
 import { BaseDeserializer } from './base-deserializer';
 import { type InvalidRule } from '../nodes';
 import { type InputByteBuffer } from '../utils/input-byte-buffer';
+/**
+ * Deserializer for invalid rule nodes.
+ * Converts binary data into invalid rule nodes.
+ */
 export declare class InvalidRuleDeserializer extends BaseDeserializer {
     /**
      * Deserializes an invalid rule node from binary format.

package/dist/types/deserializer/invalid-rule-error-node-deserializer.d.ts

@@ -1,6 +1,10 @@
 import { BaseDeserializer } from './base-deserializer';
 import { type InvalidRuleError } from '../nodes';
 import { type InputByteBuffer } from '../utils/input-byte-buffer';
+/**
+ * Deserializer for invalid rule error nodes.
+ * Converts binary data into invalid rule error nodes.
+ */
 export declare class InvalidRuleErrorNodeDeserializer extends BaseDeserializer {
     /**
      * Deserializes an invalid rule error node from binary format.

package/dist/types/deserializer/misc/list-item-deserializer.d.ts

@@ -1,6 +1,12 @@
 import { BaseDeserializer } from '../base-deserializer';
 import { type ListItem, ListItemNodeType } from '../../nodes';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `ListItemDeserializer` is responsible for deserializing list item nodes from binary format.
+ *
+ * @example
+ * `app`, `domain`, `method`, `stealth-option`
+ */
 export declare class ListItemDeserializer extends BaseDeserializer {
     /**
      * Deserializes a list item from binary format.

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

@@ -1,5 +1,9 @@
 import { type ListItem, type ListItemNodeType } from '../../nodes';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * Deserializes lists of items from binary format.
+ * Converts binary data to structured item nodes.
+ */
 export declare class ListItemsDeserializer {
     /**
      * Deserializes a list of items from binary format.

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

@@ -2,7 +2,7 @@ import { type Modifier } from '../../nodes';
 import { BaseDeserializer } from '../base-deserializer';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
 /**
- * `ModifierSerializer` is responsible for serializing modifiers.
+ * `ModifierDeserializer` is responsible for deserializing modifiers.
  *
  * @example
  * `match-case`, `~third-party`, `domain=example.com|~example.org`

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

@@ -1,6 +1,10 @@
 import { type ParameterList } from '../../nodes';
 import { BaseDeserializer } from '../base-deserializer';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * Deserializes binary data into parameter list nodes.
+ * Optionally uses a map of frequent values for optimization.
+ */
 export declare class ParameterListDeserializer extends BaseDeserializer {
     /**
      * Deserializes a parameter list node from binary format.

package/dist/types/deserializer/network/host-rule-deserializer.d.ts

@@ -2,29 +2,17 @@ import { type HostRule } from '../../nodes';
 import { BaseDeserializer } from '../base-deserializer';
 import { type InputByteBuffer } from '../../utils/input-byte-buffer';
 /**
- * `HostRuleSerializer` is responsible for serializing hosts-like rules.
+ * `HostRuleDeserializer` is responsible for deserializing hosts-like rules.
  *
  * HostRule is a structure for simple host-level rules (i.e. /etc/hosts syntax).
  * It also supports "just domain" syntax. In this case, the IP will be set to 0.0.0.0.
- *
- * Rules syntax looks like this:
- * ```text
- * IP_address canonical_hostname [aliases...]
- * ```
- *
- * @example
- * `192.168.1.13 bar.mydomain.org bar` -- ipv4
- * `ff02::1 ip6-allnodes` -- ipv6
- * `::1 localhost ip6-localhost ip6-loopback` -- ipv6 aliases
- * `example.org` -- "just domain" syntax
- * @see {@link http://man7.org/linux/man-pages/man5/hosts.5.html}
  */
 export declare class HostRuleDeserializer extends BaseDeserializer {
     /**
-     * Deserializes a modifier node from binary format.
+     * Deserializes a host rule node from binary format.
      *
-     * @param buffer ByteBuffer for reading binary data.
-     * @param node Destination node.
+     * @param buffer Input byte buffer to read from.
+     * @param node Destination node to write to.
      */
     static deserialize(buffer: InputByteBuffer, node: Partial<HostRule>): void;
 }