@adguard/agtree 2.2.0 → 3.0.0-alpha.2

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

@@ -0,0 +1,26 @@
+import { type MetadataCommentRule } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `MetadataCommentDeserializer` is responsible for deserializing metadata comments.
+ * Metadata comments are special comments that specify some properties of the list.
+ *
+ * @example
+ * For example, in the case of
+ * ```adblock
+ * ! Title: My List
+ * ```
+ * the name of the header is `Title`, and the value is `My List`, which means that
+ * the list title is `My List`, and it can be used in the adblocker UI.
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#special-comments}
+ */
+export declare class MetadataCommentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a metadata comment node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<MetadataCommentRule>): void;
+}

package/dist/types/deserializer/comment/pre-processor-comment-deserializer.d.ts

@@ -0,0 +1,29 @@
+import type { PreProcessorCommentRule } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `PreProcessorCommentDeserializer` is responsible for deserializing preprocessor rules.
+ * Pre-processor comments are special comments that are used to control the behavior of the filter list processor.
+ * Please note that this parser only handles general syntax for now, and does not validate the parameters at
+ * the parsing stage.
+ *
+ * @example
+ * If your rule is
+ * ```adblock
+ * !#if (adguard)
+ * ```
+ * 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 PreProcessorCommentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a pre-processor comment node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<PreProcessorCommentRule>): void;
+}

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

@@ -0,0 +1,26 @@
+import { type CommentRule } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `SimpleCommentDeserializer` is responsible for deserializing simple comments.
+ *
+ * Some comments have a special meaning in adblock syntax, like agent comments or hints,
+ * but this parser is only responsible for parsing regular comments,
+ * whose only purpose is to provide some human-readable information.
+ *
+ * @example
+ * ```adblock
+ * ! This is a simple comment
+ * # This is a simple comment, but in host-like syntax
+ * ```
+ */
+export declare class SimpleCommentDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a simple comment node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<CommentRule>): void;
+}

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

@@ -0,0 +1,18 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<AnyCosmeticRule>): void;
+}

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

@@ -0,0 +1,15 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: CssInjectionRuleBody): void;
+}

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

@@ -0,0 +1,16 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserializeElementHidingBody(buffer: InputByteBuffer, node: Partial<ElementHidingRuleBody>): void;
+}

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

@@ -0,0 +1,17 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<ScriptletInjectionRuleBody>): void;
+}

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

@@ -0,0 +1,18 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<ScriptletInjectionRuleBody>): void;
+}

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

@@ -0,0 +1,19 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @param frequentScriptletArgs Map of frequently used scriptlet names / arguments
+     * and their serialization index (optional).
+     * @throws If the binary data is malformed.
+     */
+    static deserialize: (buffer: InputByteBuffer, node: Partial<ScriptletInjectionRuleBody>, frequentScriptletArgs?: Map<number, string>) => void;
+}

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

@@ -0,0 +1,17 @@
+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 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

@@ -0,0 +1,16 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: EmptyRule): void;
+}

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

@@ -0,0 +1,34 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<FilterList>): void;
+    /**
+     * Helper method to jump to the children of the filter list node.
+     *
+     * Filter lists serialized in binary format are structured as follows:
+     * - `FilterListNode` filter list node indicator (1 byte)
+     * - Properties:
+     *      - `Children` (1 byte) - children count, followed by children nodes
+     *      - `Start` (1 byte) - start offset, if present, followed by the value
+     *      - `End` (1 byte) - end offset, if present, followed by the value
+     *      - `NULL` (1 byte) - closing indicator
+     *
+     * This method skips indicators, reads the children count and returns it.
+     * This way the buffer is positioned at the beginning of the children nodes.
+     *
+     * @param buffer Reference to the input byte buffer.
+     * @returns Number of children nodes.
+     */
+    static jumpToChildren(buffer: InputByteBuffer): number;
+}

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

@@ -0,0 +1,2 @@
+export { RuleDeserializer } from './rule-deserializer';
+export { getSyntaxDeserializationMap } from './syntax-deserialization-map';

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

@@ -0,0 +1,16 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: InvalidRule): void;
+}

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

@@ -0,0 +1,16 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<InvalidRuleError>): void;
+}

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

@@ -0,0 +1,15 @@
+import { type DomainList } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `DomainListDeserializer` is responsible for deserializing a domain list.
+ */
+export declare class DomainListDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a modifier list node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: DomainList): void;
+}

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

@@ -0,0 +1,19 @@
+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.
+     *
+     * @param buffer Input byte buffer.
+     * @param node Partial list item to deserialize.
+     * @template T Type of the list item.
+     */
+    static deserialize: <T extends ListItemNodeType>(buffer: InputByteBuffer, node: Partial<ListItem<T>>) => void;
+}

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

@@ -0,0 +1,16 @@
+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.
+     *
+     * @param buffer Input byte buffer.
+     * @param items Partial list of items to deserialize.
+     * @template T Type of the list items.
+     */
+    static deserialize: <T extends ListItemNodeType>(buffer: InputByteBuffer, items: Partial<ListItem<T>>[]) => void;
+}

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

@@ -0,0 +1,55 @@
+import { type AnyExpressionNode } from '../../nodes';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+import { BaseDeserializer } from '../base-deserializer';
+/**
+ * Gets the frequent name of the variable from the binary representation.
+ *
+ * @param binary Binary representation of the variable
+ * @returns Frequent name of the variable
+ * @throws If the variable is unknown
+ */
+export declare const getFrequentNameOrFail: (binary: number) => string;
+/**
+ * `LogicalExpressionDeserializer` is responsible for deserializing logical expressions.
+ *
+ * @example
+ * From the following rule:
+ * ```adblock
+ * !#if (adguard_ext_android_cb || adguard_ext_safari)
+ * ```
+ * this parser will parse the expression `(adguard_ext_android_cb || adguard_ext_safari)`.
+ */
+export declare class LogicalExpressionDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a variable node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    private static deserializeVariableNode;
+    /**
+     * Deserializes a parenthesis node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    private static deserializeParenthesisNode;
+    /**
+     * Deserializes an operator node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    private static deserializeOperatorNode;
+    /**
+     * Deserializes a logical expression node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<AnyExpressionNode>): void;
+}

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

@@ -0,0 +1,18 @@
+import { type Modifier } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `ModifierDeserializer` is responsible for deserializing modifiers.
+ *
+ * @example
+ * `match-case`, `~third-party`, `domain=example.com|~example.org`
+ */
+export declare class ModifierDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a modifier node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<Modifier>): void;
+}

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

@@ -0,0 +1,20 @@
+import { type ModifierList } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `ModifierListDeserializer` is responsible for deserializing modifier lists. Please note that the name is not
+ * uniform, "modifiers" are also known as "options".
+ *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#basic-rules-modifiers}
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#non-basic-rules-modifiers}
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#options}
+ */
+export declare class ModifierListDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a modifier list node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: ModifierList): void;
+}

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

@@ -0,0 +1,18 @@
+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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @param frequentValuesMap Optional map of frequent values.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: ParameterList, frequentValuesMap?: Map<number, string>): void;
+}

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

@@ -0,0 +1,17 @@
+import { type Value } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * Value deserializer.
+ */
+export declare class ValueDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a value node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     * @param frequentValuesMap Optional map of frequent values.
+     * @throws If the binary data is malformed.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<Value>, frequentValuesMap?: Map<number, string>): void;
+}

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

@@ -0,0 +1,18 @@
+import { type HostRule } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `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.
+ */
+export declare class HostRuleDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a host rule node from binary format.
+     *
+     * @param buffer Input byte buffer to read from.
+     * @param node Destination node to write to.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<HostRule>): void;
+}

package/dist/types/deserializer/network/hostname-list-deserializer.d.ts

@@ -0,0 +1,15 @@
+import { BaseDeserializer } from '../base-deserializer';
+import { type HostnameList } from '../../nodes';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * Deserializes hostname list nodes from binary format.
+ */
+export declare class HostnameListDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a hostname list node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: HostnameList): void;
+}

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

@@ -0,0 +1,18 @@
+import { type NetworkRule } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+/**
+ * `NetworkRuleDeserializer` is responsible for deserializing network rules.
+ *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#basic-rules}
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#basic}
+ */
+export declare class NetworkRuleDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a network rule node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<NetworkRule>): void;
+}

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

@@ -0,0 +1,17 @@
+import { type AnyRule } from '../nodes';
+import { BaseDeserializer } from './base-deserializer';
+import { type InputByteBuffer } from '../utils/input-byte-buffer';
+/**
+ * `RuleDeserializer` is responsible for deserializing the rules.
+ *
+ * It automatically determines the category and syntax of the rule, so you can pass any kind of rule to it.
+ */
+export declare class RuleDeserializer extends BaseDeserializer {
+    /**
+     * Deserializes a rule node from binary format.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<AnyRule>): void;
+}

package/dist/types/deserializer/syntax-deserialization-map.d.ts

@@ -0,0 +1,2 @@
+import { type AdblockSyntax } from '../utils/adblockers';
+export declare const getSyntaxDeserializationMap: () => Map<number, AdblockSyntax>;

package/dist/types/errors/adblock-syntax-error.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file Customized syntax error class for Adblock Filter Parser.
+ */
+/**
+ * Customized syntax error class for Adblock Filter Parser,
+ * which contains the location range of the error.
+ */
+export declare class AdblockSyntaxError extends SyntaxError {
+    /**
+     * Start offset of the error.
+     */
+    start: number;
+    /**
+     * End offset of the error.
+     */
+    end: number;
+    /**
+     * Constructs a new `AdblockSyntaxError` instance.
+     *
+     * @param message Error message.
+     * @param start Start offset of the error.
+     * @param end End offset of the error.
+     */
+    constructor(message: string, start: number, end: number);
+}

package/dist/types/errors/binary-schema-mismatch-error.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file Customized error for binary schema mismatch.
+ */
+/**
+ * Customized error for binary schema mismatch.
+ */
+export declare class BinarySchemaMismatchError extends Error {
+    /**
+     * Expected schema version.
+     */
+    expectedVersion: number;
+    /**
+     * Actual schema version.
+     */
+    actualVersion: number;
+    /**
+     * Constructs a new `BinarySchemaMismatchError` instance.
+     *
+     * @param expectedVersion Expected schema version.
+     * @param actualVersion Actual schema version.
+     */
+    constructor(expectedVersion: number, actualVersion: number);
+}

package/dist/types/errors/not-implemented-error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file Customized error class for not implemented features.
+ */
+/**
+ * Customized error class for not implemented features.
+ */
+export declare class NotImplementedError extends Error {
+    /**
+     * Constructs a new `NotImplementedError` instance.
+     *
+     * @param message Additional error message (optional)
+     */
+    constructor(message?: string | undefined);
+}