@adguard/agtree 2.1.2 → 3.0.0-alpha.1

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

@@ -0,0 +1,12 @@
+import { BaseDeserializer } from './base-deserializer';
+import { type InvalidRuleError } from '../nodes';
+import { type InputByteBuffer } from '../utils/input-byte-buffer';
+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,13 @@
+import { BaseDeserializer } from '../base-deserializer';
+import { type ListItem, ListItemNodeType } from '../../nodes';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+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,12 @@
+import { type ListItem, type ListItemNodeType } from '../../nodes';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+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';
+/**
+ * `ModifierSerializer` is responsible for serializing 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,14 @@
+import { type ParameterList } from '../../nodes';
+import { BaseDeserializer } from '../base-deserializer';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+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,30 @@
+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.
+ *
+ * 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.
+     *
+     * @param buffer ByteBuffer for reading binary data.
+     * @param node Destination node.
+     */
+    static deserialize(buffer: InputByteBuffer, node: Partial<HostRule>): void;
+}

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

@@ -0,0 +1,12 @@
+import { BaseDeserializer } from '../base-deserializer';
+import { type HostnameList } from '../../nodes';
+import { type InputByteBuffer } from '../../utils/input-byte-buffer';
+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);
+}

package/dist/types/errors/rule-conversion-error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file Customized error class for conversion errors.
+ */
+/**
+ * Customized error class for conversion errors.
+ */
+export declare class RuleConversionError extends Error {
+    /**
+     * Constructs a new `RuleConversionError` instance.
+     *
+     * @param message Error message
+     */
+    constructor(message: string);
+}

package/dist/types/generator/base-generator.d.ts

@@ -0,0 +1,12 @@
+import { type Node } from '../nodes';
+/**
+ * Base class for generators. Each generator should extend this class.
+ */
+export declare class BaseGenerator {
+    /**
+     * Generates a string from the AST node.
+     *
+     * @param node AST node to generate a string from.
+     */
+    static generate(node: Node): string;
+}

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

@@ -0,0 +1,11 @@
+import type { AgentCommentRule } from '../../nodes';
+import { BaseGenerator } from '../base-generator';
+export declare class AgentCommentGenerator extends BaseGenerator {
+    /**
+     * Converts an adblock agent AST to a string.
+     *
+     * @param ast Agent rule AST
+     * @returns Raw string
+     */
+    static generate(ast: AgentCommentRule): string;
+}

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

@@ -0,0 +1,11 @@
+import { BaseGenerator } from '../base-generator';
+import type { Agent } from '../../nodes';
+export declare class AgentGenerator extends BaseGenerator {
+    /**
+     * Converts an adblock agent node to a string.
+     *
+     * @param value Agent node
+     * @returns Raw string
+     */
+    static generate(value: Agent): string;
+}

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

@@ -0,0 +1,67 @@
+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.
+ */
+export declare class CommentRuleGenerator extends BaseGenerator {
+    /**
+     * Converts a comment rule node to a string.
+     *
+     * @param node Comment rule node
+     * @returns Raw string
+     */
+    static generate(node: AnyCommentRule): string;
+}

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

@@ -0,0 +1,11 @@
+import { BaseGenerator } from '../base-generator';
+import type { ConfigCommentRule } from '../../nodes';
+export declare class ConfigCommentGenerator extends BaseGenerator {
+    /**
+     * Converts an inline configuration comment node to a string.
+     *
+     * @param node Inline configuration comment node
+     * @returns Raw string
+     */
+    static generate(node: ConfigCommentRule): string;
+}

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

@@ -0,0 +1,11 @@
+import { BaseGenerator } from '../base-generator';
+import type { HintCommentRule } from '../../nodes';
+export declare class HintCommentGenerator extends BaseGenerator {
+    /**
+     * Converts a hint rule node to a raw string.
+     *
+     * @param node Hint rule node
+     * @returns Raw string
+     */
+    static generate(node: HintCommentRule): string;
+}

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

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

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

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

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

@@ -0,0 +1,11 @@
+import type { MetadataCommentRule } from '../../nodes';
+import { BaseGenerator } from '../base-generator';
+export declare class MetadataCommentGenerator extends BaseGenerator {
+    /**
+     * Converts a metadata comment rule node to a string.
+     *
+     * @param node Metadata comment rule node.
+     * @returns Raw string.
+     */
+    static generate(node: MetadataCommentRule): string;
+}

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

@@ -0,0 +1,11 @@
+import type { PreProcessorCommentRule } from '../../nodes';
+import { BaseGenerator } from '../base-generator';
+export declare class PreProcessorCommentGenerator extends BaseGenerator {
+    /**
+     * Converts a pre-processor comment node to a string.
+     *
+     * @param node Pre-processor comment node
+     * @returns Raw string
+     */
+    static generate(node: PreProcessorCommentRule): string;
+}

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

@@ -0,0 +1,11 @@
+import { BaseGenerator } from '../base-generator';
+import type { CommentRule } from '../../nodes';
+export declare class SimpleCommentGenerator extends BaseGenerator {
+    /**
+     * Converts a comment rule node to a string.
+     *
+     * @param node Comment rule node.
+     * @returns Raw string.
+     */
+    static generate(node: CommentRule): string;
+}

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

@@ -0,0 +1,11 @@
+import type { ScriptletInjectionRuleBody } from '../../../nodes';
+import { BaseGenerator } from '../../base-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
+     */
+    static generate(node: ScriptletInjectionRuleBody): string;
+}

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

@@ -0,0 +1,17 @@
+import type { ScriptletInjectionRuleBody } from '../../../nodes';
+import { BaseGenerator } from '../../base-generator';
+export declare class AdgScriptletInjectionBodyGenerator extends BaseGenerator {
+    /**
+     * Error messages used by the parser.
+     */
+    static readonly ERROR_MESSAGES: {
+        NO_MULTIPLE_SCRIPTLET_CALLS: string;
+    };
+    /**
+     * Generates a string representation of the AdGuard scriptlet call body.
+     *
+     * @param node Scriptlet injection rule body
+     * @returns String representation of the rule body
+     */
+    static generate(node: ScriptletInjectionRuleBody): string;
+}

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

@@ -0,0 +1,17 @@
+import { BaseGenerator } from '../../base-generator';
+import type { ScriptletInjectionRuleBody } from '../../../nodes';
+export declare class UboScriptletInjectionBodyGenerator extends BaseGenerator {
+    /**
+     * Error messages used by the parser.
+     */
+    static readonly ERROR_MESSAGES: {
+        NO_MULTIPLE_SCRIPTLET_CALLS: string;
+    };
+    /**
+     * Generates a string representation of the uBlock scriptlet call body.
+     *
+     * @param node Scriptlet injection rule body
+     * @returns String representation of the rule body
+     */
+    static generate(node: ScriptletInjectionRuleBody): string;
+}

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

@@ -0,0 +1,15 @@
+import { BaseGenerator } from '../base-generator';
+import { type AnyCosmeticRule } from '../../nodes';
+export declare class CosmeticRuleBodyGenerator extends BaseGenerator {
+    /**
+     * Generates the rule body from the node.
+     *
+     * @param node Cosmetic rule node
+     * @returns Raw rule body
+     * @example
+     * - '##.foo' → '.foo'
+     * - 'example.com,example.org##.foo' → '.foo'
+     * - 'example.com#%#//scriptlet('foo')' → '//scriptlet('foo')'
+     */
+    static generate(node: AnyCosmeticRule): string;
+}

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

@@ -0,0 +1,36 @@
+import { type AnyCosmeticRule } from '../../nodes';
+import { BaseGenerator } from '../base-generator';
+/**
+ * Possible error messages for uBO selectors. Formatted with {@link sprintf}.
+ */
+export declare const ERROR_MESSAGES: {
+    EMPTY_RULE_BODY: string;
+    INVALID_BODY_FOR_SEPARATOR: string;
+    MISSING_ADGUARD_MODIFIER_LIST_END: string;
+    MISSING_ADGUARD_MODIFIER_LIST_MARKER: string;
+    SYNTAXES_CANNOT_BE_MIXED: string;
+    SYNTAX_DISABLED: string;
+};
+/**
+ * `CosmeticRuleParser` is responsible for parsing cosmetic rules.
+ *
+ * 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.
+ */
+export declare class CosmeticRuleGenerator extends BaseGenerator {
+    /**
+     * Converts a cosmetic rule AST into a string.
+     *
+     * @param node Cosmetic rule AST
+     * @returns Raw string
+     */
+    static generate(node: AnyCosmeticRule): string;
+}