@adguard/agtree 2.2.0 → 3.0.0-alpha.2

package/dist/errors/rule-conversion-error.js

@@ -0,0 +1,26 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * @file Customized error class for conversion errors.
+ */
+const ERROR_NAME = 'RuleConversionError';
+/**
+ * Customized error class for conversion errors.
+ */
+class RuleConversionError extends Error {
+    /**
+     * Constructs a new `RuleConversionError` instance.
+     *
+     * @param message Error message
+     */
+    constructor(message) {
+        super(message);
+        this.name = ERROR_NAME;
+    }
+}
+
+export { RuleConversionError };

package/dist/generator/base-generator.js

@@ -0,0 +1,27 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NotImplementedError } from '../errors/not-implemented-error.js';
+
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/**
+ * @file Base generator class.
+ */
+/**
+ * Base class for generators. Each generator should extend this class.
+ */
+class BaseGenerator {
+    /**
+     * Generates a string from the AST node.
+     *
+     * @param node AST node to generate a string from.
+     */
+    static generate(node) {
+        throw new NotImplementedError();
+    }
+}
+
+export { BaseGenerator };

package/dist/generator/comment/agent-comment-generator.js

@@ -0,0 +1,31 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { SEMICOLON, SPACE, CLOSE_SQUARE_BRACKET, OPEN_SQUARE_BRACKET } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { AgentGenerator } from './agent-generator.js';
+
+/**
+ * Generator for agent comment rules.
+ */
+class AgentCommentGenerator extends BaseGenerator {
+    /**
+     * Converts an adblock agent AST to a string.
+     *
+     * @param ast Agent rule AST
+     * @returns Raw string
+     */
+    static generate(ast) {
+        let result = OPEN_SQUARE_BRACKET;
+        result += ast.children
+            .map(AgentGenerator.generate)
+            .join(SEMICOLON + SPACE);
+        result += CLOSE_SQUARE_BRACKET;
+        return result;
+    }
+}
+
+export { AgentCommentGenerator };

package/dist/generator/comment/agent-generator.js

@@ -0,0 +1,36 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.js';
+import { SPACE, EMPTY } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+
+/**
+ * Generator for adblock agent nodes.
+ * This class is responsible for converting adblock agent nodes into their string representation.
+ */
+class AgentGenerator extends BaseGenerator {
+    /**
+     * Converts an adblock agent node to a string.
+     *
+     * @param value Agent node
+     * @returns Raw string
+     */
+    static generate(value) {
+        let result = EMPTY;
+        // Agent adblock name
+        result += value.adblock.value;
+        // Agent adblock version (if present)
+        if (!isUndefined(value.version)) {
+            // Add a space between the name and the version
+            result += SPACE;
+            result += value.version.value;
+        }
+        return result;
+    }
+}
+
+export { AgentGenerator };

package/dist/generator/comment/comment-rule-generator.js

@@ -0,0 +1,47 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { CommentRuleType } from '../../nodes/index.js';
+import { BaseGenerator } from '../base-generator.js';
+import { AgentCommentGenerator } from './agent-comment-generator.js';
+import { HintCommentGenerator } from './hint-comment-generator.js';
+import { PreProcessorCommentGenerator } from './pre-processor-comment-generator.js';
+import { MetadataCommentGenerator } from './metadata-comment-generator.js';
+import { ConfigCommentGenerator } from './config-comment-generator.js';
+import { SimpleCommentGenerator } from './simple-comment-generator.js';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `CommentRuleGenerator` is responsible for generating any comment-like adblock rules.
+ */
+class CommentRuleGenerator extends BaseGenerator {
+    /**
+     * Converts a comment rule node to a string.
+     *
+     * @param node Comment rule node
+     * @returns Raw string
+     */
+    static generate(node) {
+        switch (node.type) {
+            case CommentRuleType.AgentCommentRule:
+                return AgentCommentGenerator.generate(node);
+            case CommentRuleType.HintCommentRule:
+                return HintCommentGenerator.generate(node);
+            case CommentRuleType.PreProcessorCommentRule:
+                return PreProcessorCommentGenerator.generate(node);
+            case CommentRuleType.MetadataCommentRule:
+                return MetadataCommentGenerator.generate(node);
+            case CommentRuleType.ConfigCommentRule:
+                return ConfigCommentGenerator.generate(node);
+            case CommentRuleType.CommentRule:
+                return SimpleCommentGenerator.generate(node);
+            default:
+                throw new Error('Unknown comment rule type');
+        }
+    }
+}
+
+export { CommentRuleGenerator };

package/dist/generator/comment/config-comment-generator.js

@@ -0,0 +1,45 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.js';
+import { SPACE, COMMA, EMPTY } from '../../utils/constants.js';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.js';
+
+/**
+ * Converts inline configuration comment nodes to their string format.
+ */
+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) {
+        let result = EMPTY;
+        result += node.marker.value;
+        result += SPACE;
+        result += node.command.value;
+        if (node.params) {
+            result += SPACE;
+            if (node.params.type === 'ParameterList') {
+                result += ParameterListGenerator.generate(node.params, COMMA);
+            }
+            else {
+                // Trim JSON boundaries
+                result += JSON.stringify(node.params.value).slice(1, -1).trim();
+            }
+        }
+        // Add comment within the config comment
+        if (node.comment) {
+            result += SPACE;
+            result += node.comment.value;
+        }
+        return result;
+    }
+}
+
+export { ConfigCommentGenerator };

package/dist/generator/comment/hint-comment-generator.js

@@ -0,0 +1,28 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.js';
+import { SPACE, HINT_MARKER } from '../../utils/constants.js';
+import { HintGenerator } from './hint-generator.js';
+
+/**
+ * Hint comment generator.
+ */
+class HintCommentGenerator extends BaseGenerator {
+    /**
+     * Converts a hint rule node to a raw string.
+     *
+     * @param node Hint rule node
+     * @returns Raw string
+     */
+    static generate(node) {
+        let result = HINT_MARKER + SPACE;
+        result += node.children.map(HintGenerator.generate).join(SPACE);
+        return result;
+    }
+}
+
+export { HintCommentGenerator };

package/dist/generator/comment/hint-generator.js

@@ -0,0 +1,33 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { OPEN_PARENTHESIS, COMMA, CLOSE_PARENTHESIS, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.js';
+
+/**
+ * Hint generator.
+ */
+class HintGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of a hint.
+     *
+     * @param hint Hint AST node
+     * @returns String representation of the hint
+     */
+    static generate(hint) {
+        let result = EMPTY;
+        result += hint.name.value;
+        if (hint.params && hint.params.children.length > 0) {
+            result += OPEN_PARENTHESIS;
+            result += ParameterListGenerator.generate(hint.params, COMMA);
+            result += CLOSE_PARENTHESIS;
+        }
+        return result;
+    }
+}
+
+export { HintGenerator };

package/dist/generator/comment/metadata-comment-generator.js

@@ -0,0 +1,33 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { SPACE, COLON, EMPTY } from '../../utils/constants.js';
+import { ValueGenerator } from '../misc/value-generator.js';
+import { BaseGenerator } from '../base-generator.js';
+
+/**
+ * Metadata comment generator.
+ */
+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) {
+        let result = EMPTY;
+        result += ValueGenerator.generate(node.marker);
+        result += SPACE;
+        result += ValueGenerator.generate(node.header);
+        result += COLON;
+        result += SPACE;
+        result += ValueGenerator.generate(node.value);
+        return result;
+    }
+}
+
+export { MetadataCommentGenerator };

package/dist/generator/comment/pre-processor-comment-generator.js

@@ -0,0 +1,48 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { SAFARI_CB_AFFINITY, SPACE, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, EMPTY, PREPROCESSOR_MARKER } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ValueGenerator } from '../misc/value-generator.js';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.js';
+import { LogicalExpressionGenerator } from '../misc/logical-expression-generator.js';
+
+/**
+ * Pre-processor comment generator.
+ */
+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) {
+        let result = EMPTY;
+        result += PREPROCESSOR_MARKER;
+        result += node.name.value;
+        if (node.params) {
+            // Space is not allowed after "safari_cb_affinity" directive, so we need to handle it separately.
+            if (node.name.value !== SAFARI_CB_AFFINITY) {
+                result += SPACE;
+            }
+            if (node.params.type === 'Value') {
+                result += ValueGenerator.generate(node.params);
+            }
+            else if (node.params.type === 'ParameterList') {
+                result += OPEN_PARENTHESIS;
+                result += ParameterListGenerator.generate(node.params);
+                result += CLOSE_PARENTHESIS;
+            }
+            else {
+                result += LogicalExpressionGenerator.generate(node.params);
+            }
+        }
+        return result;
+    }
+}
+
+export { PreProcessorCommentGenerator };

package/dist/generator/comment/simple-comment-generator.js

@@ -0,0 +1,29 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.js';
+import { EMPTY } from '../../utils/constants.js';
+import { ValueGenerator } from '../misc/value-generator.js';
+
+/**
+ * Simple comment generator.
+ */
+class SimpleCommentGenerator extends BaseGenerator {
+    /**
+     * Converts a comment rule node to a string.
+     *
+     * @param node Comment rule node.
+     * @returns Raw string.
+     */
+    static generate(node) {
+        let result = EMPTY;
+        result += ValueGenerator.generate(node.marker);
+        result += ValueGenerator.generate(node.text);
+        return result;
+    }
+}
+
+export { SimpleCommentGenerator };

package/dist/generator/cosmetic/body/abp-snippet-injection-body-generator.js

@@ -0,0 +1,38 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { SPACE, SEMICOLON } from '../../../utils/constants.js';
+import { BaseGenerator } from '../../base-generator.js';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.js';
+import { AbpSnippetInjectionBodyCommon } from '../../../common/abp-snippet-injection-body-common.js';
+
+/**
+ * Adblock Plus snippet injection body generator.
+ */
+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) {
+        const result = [];
+        if (node.children.length === 0) {
+            throw new Error(AbpSnippetInjectionBodyCommon.ERROR_MESSAGES.EMPTY_SCRIPTLET_CALL);
+        }
+        for (const scriptletCall of node.children) {
+            if (scriptletCall.children.length === 0) {
+                throw new Error(AbpSnippetInjectionBodyCommon.ERROR_MESSAGES.EMPTY_SCRIPTLET_CALL);
+            }
+            result.push(ParameterListGenerator.generate(scriptletCall, SPACE));
+        }
+        return result.join(SEMICOLON + SPACE);
+    }
+}
+
+export { AbpSnippetInjectionBodyGenerator };

package/dist/generator/cosmetic/body/adg-scriptlet-injection-body-generator.js

@@ -0,0 +1,43 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { CLOSE_PARENTHESIS, EMPTY, ADG_SCRIPTLET_MASK, OPEN_PARENTHESIS } from '../../../utils/constants.js';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.js';
+import { BaseGenerator } from '../../base-generator.js';
+
+/**
+ * AdGuard scriptlet injection body generator.
+ */
+class AdgScriptletInjectionBodyGenerator extends BaseGenerator {
+    /**
+     * Error messages used by the generator.
+     */
+    static ERROR_MESSAGES = {
+        NO_MULTIPLE_SCRIPTLET_CALLS: 'ADG syntaxes does not support multiple scriptlet calls within one single rule',
+    };
+    /**
+     * Generates a string representation of the AdGuard scriptlet call body.
+     *
+     * @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) {
+        const result = [];
+        if (node.children.length > 1) {
+            throw new Error(AdgScriptletInjectionBodyGenerator.ERROR_MESSAGES.NO_MULTIPLE_SCRIPTLET_CALLS);
+        }
+        result.push(ADG_SCRIPTLET_MASK);
+        result.push(OPEN_PARENTHESIS);
+        if (node.children.length > 0) {
+            result.push(ParameterListGenerator.generate(node.children[0]));
+        }
+        result.push(CLOSE_PARENTHESIS);
+        return result.join(EMPTY);
+    }
+}
+
+export { AdgScriptletInjectionBodyGenerator };

package/dist/generator/cosmetic/body/ubo-scriptlet-injection-body-generator.js

@@ -0,0 +1,45 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../../base-generator.js';
+import { CLOSE_PARENTHESIS, EMPTY, UBO_SCRIPTLET_MASK, OPEN_PARENTHESIS } from '../../../utils/constants.js';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.js';
+
+/**
+ * uBlock scriptlet injection body generator.
+ */
+class UboScriptletInjectionBodyGenerator extends BaseGenerator {
+    /**
+     * Error messages used by the generator.
+     */
+    static ERROR_MESSAGES = {
+        NO_MULTIPLE_SCRIPTLET_CALLS: 'uBO syntaxes does not support multiple scriptlet calls within one single rule',
+    };
+    /**
+     * Generates a string representation of the uBlock scriptlet call body.
+     *
+     * @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) {
+        const result = [];
+        if (node.children.length > 1) {
+            throw new Error(UboScriptletInjectionBodyGenerator.ERROR_MESSAGES.NO_MULTIPLE_SCRIPTLET_CALLS);
+        }
+        // During generation, we only support the modern scriptlet mask
+        result.push(UBO_SCRIPTLET_MASK);
+        result.push(OPEN_PARENTHESIS);
+        if (node.children.length > 0) {
+            const [parameterListNode] = node.children;
+            result.push(ParameterListGenerator.generate(parameterListNode));
+        }
+        result.push(CLOSE_PARENTHESIS);
+        return result.join(EMPTY);
+    }
+}
+
+export { UboScriptletInjectionBodyGenerator };

package/dist/generator/cosmetic/cosmetic-rule-body-generator.js

@@ -0,0 +1,94 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.js';
+import { CosmeticRuleType } from '../../nodes/index.js';
+import { CLOSE_PARENTHESIS, SPACE, COLON, OPEN_PARENTHESIS, EMPTY } from '../../utils/constants.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { AdgScriptletInjectionBodyGenerator } from './body/adg-scriptlet-injection-body-generator.js';
+import { AdgCssInjectionGenerator } from '../css/adg-css-injection-generator.js';
+import { AbpSnippetInjectionBodyGenerator } from './body/abp-snippet-injection-body-generator.js';
+import { UboScriptletInjectionBodyGenerator } from './body/ubo-scriptlet-injection-body-generator.js';
+import { UboPseudoName } from '../../common/ubo-selector-common.js';
+
+/**
+ * Cosmetic rule body generator.
+ */
+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')'
+     *
+     * @throws Error if the rule type is unknown
+     */
+    static generate(node) {
+        let result = EMPTY;
+        switch (node.type) {
+            case CosmeticRuleType.ElementHidingRule:
+                result = node.body.selectorList.value;
+                break;
+            case CosmeticRuleType.CssInjectionRule:
+                if (node.syntax === AdblockSyntax.Adg) {
+                    result = AdgCssInjectionGenerator.generate(node.body);
+                }
+                else if (node.syntax === AdblockSyntax.Ubo) {
+                    if (node.body.mediaQueryList) {
+                        result += COLON;
+                        result += UboPseudoName.MatchesMedia;
+                        result += OPEN_PARENTHESIS;
+                        result += node.body.mediaQueryList.value;
+                        result += CLOSE_PARENTHESIS;
+                        result += SPACE;
+                    }
+                    result += node.body.selectorList.value;
+                    if (node.body.remove) {
+                        result += COLON;
+                        result += UboPseudoName.Remove;
+                        result += OPEN_PARENTHESIS;
+                        result += CLOSE_PARENTHESIS;
+                    }
+                    else if (node.body.declarationList) {
+                        result += COLON;
+                        result += UboPseudoName.Style;
+                        result += OPEN_PARENTHESIS;
+                        result += node.body.declarationList.value;
+                        result += CLOSE_PARENTHESIS;
+                    }
+                }
+                break;
+            case CosmeticRuleType.HtmlFilteringRule:
+            case CosmeticRuleType.JsInjectionRule:
+                result = node.body.value;
+                break;
+            case CosmeticRuleType.ScriptletInjectionRule:
+                switch (node.syntax) {
+                    case AdblockSyntax.Adg:
+                        result = AdgScriptletInjectionBodyGenerator.generate(node.body);
+                        break;
+                    case AdblockSyntax.Abp:
+                        result = AbpSnippetInjectionBodyGenerator.generate(node.body);
+                        break;
+                    case AdblockSyntax.Ubo:
+                        result = UboScriptletInjectionBodyGenerator.generate(node.body);
+                        break;
+                    default:
+                        throw new Error('Scriptlet rule should have an explicit syntax');
+                }
+                break;
+            default:
+                throw new Error('Unknown cosmetic rule type');
+        }
+        return result;
+    }
+}
+
+export { CosmeticRuleBodyGenerator };

package/dist/generator/cosmetic/cosmetic-rule-generator.js

@@ -0,0 +1,54 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { COLON, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, SPACE, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { CosmeticRulePatternGenerator } from './cosmetic-rule-pattern-generator.js';
+import { CosmeticRuleBodyGenerator } from './cosmetic-rule-body-generator.js';
+
+/**
+ * `CosmeticRuleGenerator` is responsible for generating cosmetic rules from their AST representation.
+ *
+ * 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.
+ */
+class CosmeticRuleGenerator extends BaseGenerator {
+    /**
+     * Converts a cosmetic rule AST into a string.
+     *
+     * @param node Cosmetic rule AST
+     * @returns Raw string
+     */
+    static generate(node) {
+        let result = EMPTY;
+        // Pattern
+        result += CosmeticRulePatternGenerator.generate(node);
+        // Separator
+        result += node.separator.value;
+        // uBO rule modifiers
+        if (node.syntax === AdblockSyntax.Ubo && node.modifiers) {
+            node.modifiers.children.forEach((modifier) => {
+                result += COLON;
+                result += modifier.name.value;
+                if (modifier.value) {
+                    result += OPEN_PARENTHESIS;
+                    result += modifier.value.value;
+                    result += CLOSE_PARENTHESIS;
+                }
+            });
+            // If there are at least one modifier, add a space
+            if (node.modifiers.children.length) {
+                result += SPACE;
+            }
+        }
+        // Body
+        result += CosmeticRuleBodyGenerator.generate(node);
+        return result;
+    }
+}
+
+export { CosmeticRuleGenerator };