@adguard/agtree 2.1.3 → 3.0.0-alpha.1

package/dist/esm/generator/comment/comment-rule-generator.mjs

@@ -0,0 +1,100 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { AgentCommentGenerator } from './agent-comment-generator.mjs';
+import { HintCommentGenerator } from './hint-comment-generator.mjs';
+import { PreProcessorCommentGenerator } from './pre-processor-comment-generator.mjs';
+import { MetadataCommentGenerator } from './metadata-comment-generator.mjs';
+import { ConfigCommentGenerator } from './config-comment-generator.mjs';
+import { SimpleCommentGenerator } from './simple-comment-generator.mjs';
+
+/* eslint-disable no-param-reassign */
+/**
+ * `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.
+ */
+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/esm/generator/comment/config-comment-generator.mjs

@@ -0,0 +1,42 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { SPACE, COMMA, EMPTY } from '../../utils/constants.mjs';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.mjs';
+
+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/esm/generator/comment/hint-comment-generator.mjs

@@ -0,0 +1,25 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { SPACE, HINT_MARKER } from '../../utils/constants.mjs';
+import { HintGenerator } from './hint-generator.mjs';
+
+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/esm/generator/comment/hint-generator.mjs

@@ -0,0 +1,30 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.mjs';
+
+class HintGenerator extends BaseGenerator {
+    /**
+     * Converts a single hint AST to a string.
+     *
+     * @param hint Hint AST
+     * @returns Hint string
+     */
+    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/esm/generator/comment/metadata-comment-generator.mjs

@@ -0,0 +1,30 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { ValueGenerator } from '../misc/value-generator.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+
+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/esm/generator/comment/pre-processor-comment-generator.mjs

@@ -0,0 +1,45 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { ValueGenerator } from '../misc/value-generator.mjs';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.mjs';
+import { LogicalExpressionGenerator } from '../misc/logical-expression-generator.mjs';
+
+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/esm/generator/comment/simple-comment-generator.mjs

@@ -0,0 +1,26 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { EMPTY } from '../../utils/constants.mjs';
+import { ValueGenerator } from '../misc/value-generator.mjs';
+
+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/esm/generator/cosmetic/body/abp-snippet-injection-body-generator.mjs

@@ -0,0 +1,34 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { BaseGenerator } from '../../base-generator.mjs';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.mjs';
+import { AbpSnippetInjectionBodyCommon } from '../../../common/abp-snippet-injection-body-common.mjs';
+
+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) {
+        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/esm/generator/cosmetic/body/adg-scriptlet-injection-body-generator.mjs

@@ -0,0 +1,39 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.mjs';
+import { BaseGenerator } from '../../base-generator.mjs';
+
+class AdgScriptletInjectionBodyGenerator extends BaseGenerator {
+    /**
+     * Error messages used by the parser.
+     */
+    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
+     */
+    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/esm/generator/cosmetic/body/ubo-scriptlet-injection-body-generator.mjs

@@ -0,0 +1,41 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { CLOSE_PARENTHESIS, EMPTY, UBO_SCRIPTLET_MASK, OPEN_PARENTHESIS } from '../../../utils/constants.mjs';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.mjs';
+
+class UboScriptletInjectionBodyGenerator extends BaseGenerator {
+    /**
+     * Error messages used by the parser.
+     */
+    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
+     */
+    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/esm/generator/cosmetic/cosmetic-rule-body-generator.mjs

@@ -0,0 +1,90 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { CosmeticRuleType } from '../../nodes/index.mjs';
+import { OPEN_PARENTHESIS, CLOSE_PARENTHESIS, SPACE, COLON, EMPTY } from '../../utils/constants.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { AdgScriptletInjectionBodyGenerator } from './body/adg-scriptlet-injection-body-generator.mjs';
+import { AdgCssInjectionGenerator } from '../css/adg-css-injection-generator.mjs';
+import { AbpSnippetInjectionBodyGenerator } from './body/abp-snippet-injection-body-generator.mjs';
+import { UboScriptletInjectionBodyGenerator } from './body/ubo-scriptlet-injection-body-generator.mjs';
+import { UboPseudoName } from '../../common/ubo-selector-common.mjs';
+
+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) {
+        let result = EMPTY;
+        // Body
+        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/esm/generator/cosmetic/cosmetic-rule-generator.mjs

@@ -0,0 +1,64 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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.mjs';
+import { COLON, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, SPACE, EMPTY } from '../../utils/constants.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { CosmeticRulePatternGenerator } from './cosmetic-rule-pattern-generator.mjs';
+import { CosmeticRuleBodyGenerator } from './cosmetic-rule-body-generator.mjs';
+
+/**
+ * `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.
+ */
+// TODO: Make raw body parsing optional
+// TODO: Split into smaller sections
+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 };

package/dist/esm/generator/cosmetic/cosmetic-rule-pattern-generator.mjs

@@ -0,0 +1,39 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { CLOSE_SQUARE_BRACKET, EMPTY, OPEN_SQUARE_BRACKET, DOLLAR_SIGN } from '../../utils/constants.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { ModifierListGenerator } from '../misc/modifier-list-generator.mjs';
+import { DomainListGenerator } from '../misc/domain-list-generator.mjs';
+
+class CosmeticRulePatternGenerator extends BaseGenerator {
+    /**
+     * Generates the rule pattern from the AST.
+     *
+     * @param node Cosmetic rule node
+     * @returns Raw rule pattern
+     * @example
+     * - '##.foo' → ''
+     * - 'example.com,example.org##.foo' → 'example.com,example.org'
+     * - '[$path=/foo/bar]example.com##.foo' → '[$path=/foo/bar]example.com'
+     */
+    static generate(node) {
+        let result = EMPTY;
+        // AdGuard modifiers (if any)
+        if (node.syntax === AdblockSyntax.Adg && node.modifiers && node.modifiers.children.length > 0) {
+            result += OPEN_SQUARE_BRACKET;
+            result += DOLLAR_SIGN;
+            result += ModifierListGenerator.generate(node.modifiers);
+            result += CLOSE_SQUARE_BRACKET;
+        }
+        // Domain list (if any)
+        result += DomainListGenerator.generate(node.domains);
+        return result;
+    }
+}
+
+export { CosmeticRulePatternGenerator };

package/dist/esm/generator/css/adg-css-injection-generator.mjs

@@ -0,0 +1,39 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { COLON, SPACE, SEMICOLON, CSS_MEDIA_MARKER, OPEN_CURLY_BRACKET, CLOSE_CURLY_BRACKET, EMPTY } from '../../utils/constants.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { REMOVE_PROPERTY, REMOVE_VALUE } from '../../parser/css/adg-css-injection-parser.mjs';
+
+class AdgCssInjectionGenerator extends BaseGenerator {
+    static removeDeclaration = `${REMOVE_PROPERTY}${COLON}${SPACE}${REMOVE_VALUE}${SEMICOLON}`;
+    /**
+     * Serializes an AdGuard CSS injection node into a raw string.
+     *
+     * @param node Node to serialize.
+     * @returns Raw string.
+     */
+    static generate(node) {
+        const result = [];
+        if (node.mediaQueryList) {
+            result.push(CSS_MEDIA_MARKER, SPACE, node.mediaQueryList.value, SPACE, OPEN_CURLY_BRACKET, SPACE);
+        }
+        result.push(node.selectorList.value, SPACE, OPEN_CURLY_BRACKET, SPACE);
+        if (node.remove) {
+            result.push(AdgCssInjectionGenerator.removeDeclaration);
+        }
+        else if (node.declarationList?.value) {
+            result.push(node.declarationList.value);
+        }
+        result.push(SPACE, CLOSE_CURLY_BRACKET);
+        if (node.mediaQueryList) {
+            result.push(SPACE, CLOSE_CURLY_BRACKET);
+        }
+        return result.join(EMPTY);
+    }
+}
+
+export { AdgCssInjectionGenerator };