@adguard/agtree 3.0.0 → 3.0.1

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/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;
 }

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

@@ -1,6 +1,9 @@
 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.

package/dist/types/generator/comment/agent-comment-generator.d.ts

@@ -1,5 +1,8 @@
 import type { AgentCommentRule } from '../../nodes';
 import { BaseGenerator } from '../base-generator';
+/**
+ * Generator for agent comment rules.
+ */
 export declare class AgentCommentGenerator extends BaseGenerator {
     /**
      * Converts an adblock agent AST to a string.

package/dist/types/generator/comment/agent-generator.d.ts

@@ -1,5 +1,9 @@
 import { BaseGenerator } from '../base-generator';
 import type { Agent } from '../../nodes';
+/**
+ * Generator for adblock agent nodes.
+ * This class is responsible for converting adblock agent nodes into their string representation.
+ */
 export declare class AgentGenerator extends BaseGenerator {
     /**
      * Converts an adblock agent node to a string.

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

@@ -1,60 +1,7 @@
 import { type AnyCommentRule } from '../../nodes';
 import { BaseGenerator } from '../base-generator';
 /**
- * `CommentParser` is responsible for parsing 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.
+ * `CommentRuleGenerator` is responsible for generating any comment-like adblock rules.
  */
 export declare class CommentRuleGenerator extends BaseGenerator {
     /**

package/dist/types/generator/comment/config-comment-generator.d.ts

@@ -1,5 +1,8 @@
 import { BaseGenerator } from '../base-generator';
 import type { ConfigCommentRule } from '../../nodes';
+/**
+ * Converts inline configuration comment nodes to their string format.
+ */
 export declare class ConfigCommentGenerator extends BaseGenerator {
     /**
      * Converts an inline configuration comment node to a string.

package/dist/types/generator/comment/hint-comment-generator.d.ts

@@ -1,5 +1,8 @@
 import { BaseGenerator } from '../base-generator';
 import type { HintCommentRule } from '../../nodes';
+/**
+ * Hint comment generator.
+ */
 export declare class HintCommentGenerator extends BaseGenerator {
     /**
      * Converts a hint rule node to a raw string.

package/dist/types/generator/comment/hint-generator.d.ts

@@ -1,11 +1,14 @@
 import type { Hint } from '../../nodes';
 import { BaseGenerator } from '../base-generator';
+/**
+ * Hint generator.
+ */
 export declare class HintGenerator extends BaseGenerator {
     /**
-     * Converts a single hint AST to a string.
+     * Generates a string representation of a hint.
      *
-     * @param hint Hint AST
-     * @returns Hint string
+     * @param hint Hint AST node
+     * @returns String representation of the hint
      */
     static generate(hint: Hint): string;
 }

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

@@ -1,2 +1 @@
-import { CommentRuleGenerator } from './comment-rule-generator';
-export { CommentRuleGenerator };
+export { CommentRuleGenerator } from './comment-rule-generator';

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

@@ -1,5 +1,8 @@
 import type { MetadataCommentRule } from '../../nodes';
 import { BaseGenerator } from '../base-generator';
+/**
+ * Metadata comment generator.
+ */
 export declare class MetadataCommentGenerator extends BaseGenerator {
     /**
      * Converts a metadata comment rule node to a string.

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

@@ -1,5 +1,8 @@
 import type { PreProcessorCommentRule } from '../../nodes';
 import { BaseGenerator } from '../base-generator';
+/**
+ * Pre-processor comment generator.
+ */
 export declare class PreProcessorCommentGenerator extends BaseGenerator {
     /**
      * Converts a pre-processor comment node to a string.

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

@@ -1,5 +1,8 @@
 import { BaseGenerator } from '../base-generator';
 import type { CommentRule } from '../../nodes';
+/**
+ * Simple comment generator.
+ */
 export declare class SimpleCommentGenerator extends BaseGenerator {
     /**
      * Converts a comment rule node to a string.

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

@@ -1,11 +1,15 @@
 import type { ScriptletInjectionRuleBody } from '../../../nodes';
 import { BaseGenerator } from '../../base-generator';
+/**
+ * Adblock Plus snippet injection body generator.
+ */
 export declare class AbpSnippetInjectionBodyGenerator extends BaseGenerator {
     /**
      * Generates a string representation of the Adblock Plus-style snippet call body.
      *
      * @param node Scriptlet injection rule body
      * @returns String representation of the rule body
+     * @throws Error if the scriptlet call is empty
      */
     static generate(node: ScriptletInjectionRuleBody): string;
 }

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

@@ -1,8 +1,11 @@
 import type { ScriptletInjectionRuleBody } from '../../../nodes';
 import { BaseGenerator } from '../../base-generator';
+/**
+ * AdGuard scriptlet injection body generator.
+ */
 export declare class AdgScriptletInjectionBodyGenerator extends BaseGenerator {
     /**
-     * Error messages used by the parser.
+     * Error messages used by the generator.
      */
     static readonly ERROR_MESSAGES: {
         NO_MULTIPLE_SCRIPTLET_CALLS: string;
@@ -12,6 +15,7 @@ export declare class AdgScriptletInjectionBodyGenerator extends BaseGenerator {
      *
      * @param node Scriptlet injection rule body
      * @returns String representation of the rule body
+     * @throws Error if the scriptlet call has multiple parameters
      */
     static generate(node: ScriptletInjectionRuleBody): string;
 }

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

@@ -1,8 +1,11 @@
 import { BaseGenerator } from '../../base-generator';
 import type { ScriptletInjectionRuleBody } from '../../../nodes';
+/**
+ * uBlock scriptlet injection body generator.
+ */
 export declare class UboScriptletInjectionBodyGenerator extends BaseGenerator {
     /**
-     * Error messages used by the parser.
+     * Error messages used by the generator.
      */
     static readonly ERROR_MESSAGES: {
         NO_MULTIPLE_SCRIPTLET_CALLS: string;
@@ -12,6 +15,7 @@ export declare class UboScriptletInjectionBodyGenerator extends BaseGenerator {
      *
      * @param node Scriptlet injection rule body
      * @returns String representation of the rule body
+     * @throws Error if the scriptlet call has multiple parameters
      */
     static generate(node: ScriptletInjectionRuleBody): string;
 }

package/dist/types/generator/cosmetic/cosmetic-rule-body-generator.d.ts

@@ -1,5 +1,8 @@
 import { BaseGenerator } from '../base-generator';
 import { type AnyCosmeticRule } from '../../nodes';
+/**
+ * Cosmetic rule body generator.
+ */
 export declare class CosmeticRuleBodyGenerator extends BaseGenerator {
     /**
      * Generates the rule body from the node.
@@ -10,6 +13,8 @@ export declare class CosmeticRuleBodyGenerator extends BaseGenerator {
      * - '##.foo' → '.foo'
      * - 'example.com,example.org##.foo' → '.foo'
      * - 'example.com#%#//scriptlet('foo')' → '//scriptlet('foo')'
+     *
+     * @throws Error if the rule type is unknown
      */
     static generate(node: AnyCosmeticRule): string;
 }

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

@@ -12,18 +12,10 @@ export declare const ERROR_MESSAGES: {
     SYNTAX_DISABLED: string;
 };
 /**
- * `CosmeticRuleParser` is responsible for parsing cosmetic rules.
+ * `CosmeticRuleGenerator` is responsible for generating cosmetic rules from their AST representation.
  *
- * Where possible, it automatically detects the difference between supported syntaxes:
- *  - AdGuard
- *  - uBlock Origin
- *  - Adblock Plus
- *
- * If the syntax is common / cannot be determined, the parser gives `Common` syntax.
- *
- * Please note that syntactically correct rules are parsed even if they are not actually
- * compatible with the given adblocker. This is a completely natural behavior, meaningful
- * checking of compatibility is not done at the parser level.
+ * This class takes a parsed cosmetic rule Abstract Syntax Tree (AST) and converts it back into a raw string format.
+ * It handles the generation of the pattern, separator, uBO rule modifiers, and the rule body.
  */
 export declare class CosmeticRuleGenerator extends BaseGenerator {
     /**

package/dist/types/generator/cosmetic/cosmetic-rule-pattern-generator.d.ts

@@ -1,5 +1,8 @@
 import type { AnyCosmeticRule } from '../../nodes';
 import { BaseGenerator } from '../base-generator';
+/**
+ * Cosmetic rule pattern generator.
+ */
 export declare class CosmeticRulePatternGenerator extends BaseGenerator {
     /**
      * Generates the rule pattern from the AST.