@adguard/agtree 3.0.0 → 3.1.0

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

@@ -2,15 +2,15 @@ import { type OutputByteBuffer } from '../../../utils/output-byte-buffer';
 import { type ScriptletInjectionRuleBody } from '../../../nodes';
 import { BaseSerializer } from '../../base-serializer';
 /**
- * `AdgScriptletInjectionBodyParser` is responsible for parsing the body of an AdGuard-style scriptlet rule.
+ * `AdgScriptletInjectionBodySerializer` is responsible for serializing the body of an AdGuard-style scriptlet rule.
  *
- * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * Please note that the serializer will serialize any scriptlet rule if it is syntactically correct.
+ * For example, it will serialize this:
  * ```adblock
  * example.com#%#//scriptlet('scriptlet0', 'arg0')
  * ```
  *
- * but it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker.
+ * but it doesn't check if the scriptlet `scriptlet0` is actually supported by any adblocker.
  *
  * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#scriptlets}
  */

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

@@ -1,14 +1,17 @@
 import { type ScriptletInjectionRuleBody } from '../../../nodes';
 import { type OutputByteBuffer } from '../../../utils/output-byte-buffer';
 import { BaseSerializer } from '../../base-serializer';
+/**
+ * Serializer for scriptlet injection rule body nodes.
+ */
 export declare class ScriptletBodySerializer extends BaseSerializer {
     /**
-     * Serializes a hint rule node to binary format.
+     * Serializes a scriptlet injection rule body node into a compact binary format.
      *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     * @param frequentScriptletArgs Map of frequently used scriptlet names / arguments
-     * and their serialization index (optional).
+     * @param node The ScriptletInjectionRuleBody node to serialize.
+     * @param buffer The OutputByteBuffer used for writing the binary data.
+     * @param frequentScriptletArgs An optional map of frequently used scriptlet names and their arguments,
+     * along with their corresponding serialization index.
      */
     static serialize: (node: ScriptletInjectionRuleBody, buffer: OutputByteBuffer, frequentScriptletArgs?: Map<string, number>) => void;
 }

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

@@ -2,18 +2,11 @@ import { type AnyCosmeticRule } from '../../nodes';
 import { type OutputByteBuffer } from '../../utils/output-byte-buffer';
 import { BaseSerializer } from '../base-serializer';
 /**
- * `CosmeticRuleParser` is responsible for parsing cosmetic rules.
+ * `CosmeticRuleSerializer` is responsible for serializing cosmetic rules into a binary format.
  *
- * 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 cosmetic rule Abstract Syntax Tree (AST) and converts it into a compact binary representation.
+ * It handles the serialization of different types of cosmetic rules, including element hiding, CSS injection,
+ * JavaScript injection, HTML filtering, and scriptlet injection rules.
  */
 export declare class CosmeticRuleSerializer extends BaseSerializer {
     /**

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

@@ -1,6 +1,9 @@
 import { type CssInjectionRuleBody } from '../../nodes';
 import type { OutputByteBuffer } from '../../utils/output-byte-buffer';
 import { BaseSerializer } from '../base-serializer';
+/**
+ * Serializer for CSS injection rule body nodes.
+ */
 export declare class CssInjectionBodySerializer extends BaseSerializer {
     /**
      * Serializes a CSS injection rule body node to binary format.

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

@@ -1,6 +1,9 @@
 import { BaseSerializer } from '../base-serializer';
 import { type ElementHidingRuleBody } from '../../nodes';
 import type { OutputByteBuffer } from '../../utils/output-byte-buffer';
+/**
+ * Serializer for element hiding rule body nodes.
+ */
 export declare class ElementHidingBodySerializer extends BaseSerializer {
     /**
      * Serializes an element hiding rule body node to binary format.

package/dist/types/serializer/empty-rule-serializer.d.ts

@@ -1,6 +1,9 @@
 import { BaseSerializer } from './base-serializer';
 import { type EmptyRule } from '../nodes';
 import type { OutputByteBuffer } from '../utils/output-byte-buffer';
+/**
+ * Serializer for empty rule nodes.
+ */
 export declare class EmptyRuleSerializer extends BaseSerializer {
     /**
      * Serializes an empty rule node to binary format.

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

@@ -2,8 +2,7 @@ import { type FilterList } from '../nodes';
 import { type OutputByteBuffer } from '../utils/output-byte-buffer';
 import { BaseSerializer } from './base-serializer';
 /**
- * `FilterListParser` is responsible for parsing a whole adblock filter list (list of rules).
- * It is a wrapper around `RuleParser` which parses each line separately.
+ * Serializes filter list nodes to binary format.
  */
 export declare class FilterListSerializer extends BaseSerializer {
     /**

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

@@ -1,6 +1,9 @@
 import { BaseSerializer } from './base-serializer';
 import { type InvalidRuleError } from '../nodes';
 import type { OutputByteBuffer } from '../utils/output-byte-buffer';
+/**
+ * Serializer for invalid rule error nodes.
+ */
 export declare class InvalidRuleErrorNodeSerializer extends BaseSerializer {
     /**
      * Serializes an invalid rule error node to binary format.

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

@@ -1,6 +1,9 @@
 import { BaseSerializer } from './base-serializer';
 import { type InvalidRule } from '../nodes';
 import type { OutputByteBuffer } from '../utils/output-byte-buffer';
+/**
+ * Serializer for invalid rule nodes.
+ */
 export declare class InvalidRuleSerializer extends BaseSerializer {
     /**
      * Serializes an invalid rule node to binary format.

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

@@ -2,12 +2,12 @@ import { type DomainList } from '../../nodes';
 import { type OutputByteBuffer } from '../../utils/output-byte-buffer';
 import { BaseSerializer } from '../base-serializer';
 /**
- * `DomainListParser` is responsible for parsing a domain list.
+ * `DomainListSerializer` is responsible for serializing a domain list.
  *
  * @example
  * - If the rule is `example.com,~example.net##.ads`, the domain list is `example.com,~example.net`.
  * - If the rule is `ads.js^$script,domains=example.com|~example.org`, the domain list is `example.com|~example.org`.
- * This parser is responsible for parsing these domain lists.
+ * This serializer is responsible for serializing these domain lists.
  * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
  */
 export declare class DomainListSerializer extends BaseSerializer {

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

@@ -1,6 +1,9 @@
 import { BaseSerializer } from '../base-serializer';
 import { type ListItem, ListItemNodeType } from '../../nodes';
 import { type OutputByteBuffer } from '../../utils/output-byte-buffer';
+/**
+ * Serializer for list item nodes.
+ */
 export declare class ListItemSerializer extends BaseSerializer {
     /**
      * Serializes a list item to binary format.

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

@@ -1,5 +1,8 @@
 import { type ListItem, type ListItemNodeType } from '../../nodes';
 import { type OutputByteBuffer } from '../../utils/output-byte-buffer';
+/**
+ * Serializer for list items.
+ */
 export declare class ListItemsSerializer {
     /**
      * Serializes a list of items to binary format.

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

@@ -4,13 +4,14 @@ import { BaseSerializer } from '../base-serializer';
 /**
  * Possible node types in the logical expression.
  */
-export declare const enum NodeType {
-    Variable = "Variable",
-    Operator = "Operator",
-    Parenthesis = "Parenthesis"
-}
+export declare const NodeType: {
+    readonly Variable: "Variable";
+    readonly Operator: "Operator";
+    readonly Parenthesis: "Parenthesis";
+};
+export type NodeType = typeof NodeType[keyof typeof NodeType];
 /**
- * `LogicalExpressionParser` is responsible for parsing logical expressions.
+ * `LogicalExpressionSerializer` is responsible for serializing logical expressions.
  *
  * @example
  * From the following rule:

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

@@ -1,6 +1,9 @@
 import { type ParameterList } from '../../nodes';
 import { type OutputByteBuffer } from '../../utils/output-byte-buffer';
 import { BaseSerializer } from '../base-serializer';
+/**
+ * Serializer for parameter list nodes.
+ */
 export declare class ParameterListSerializer extends BaseSerializer {
     /**
      * Serializes a parameter list node to binary format.

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

@@ -1,6 +1,9 @@
 import { BaseSerializer } from '../base-serializer';
 import { type HostnameList } from '../../nodes';
 import type { OutputByteBuffer } from '../../utils/output-byte-buffer';
+/**
+ * Serializer for hostname list nodes.
+ */
 export declare class HostnameListSerializer extends BaseSerializer {
     /**
      * Serializes a hostname list node to binary format.

package/dist/types/utils/adblockers.d.ts

@@ -4,7 +4,7 @@
 /**
  * Possible adblock syntaxes (supported by this library)
  */
-export declare enum AdblockSyntax {
+export declare const AdblockSyntax: {
     /**
      * Common syntax, which is supported by more than one adblocker (or by all adblockers).
      *
@@ -16,7 +16,7 @@ export declare enum AdblockSyntax {
      * we cannot determine at parsing level whether `important` is a valid option or not, and if it is valid,
      * then which adblocker supports it.
      */
-    Common = "Common",
+    readonly Common: "Common";
     /**
      * Adblock Plus syntax.
      *
@@ -25,7 +25,7 @@ export declare enum AdblockSyntax {
      * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
      * @see {@link https://adblockplus.org/}
      */
-    Abp = "AdblockPlus",
+    readonly Abp: "AdblockPlus";
     /**
      * uBlock Origin syntax.
      *
@@ -34,7 +34,7 @@ export declare enum AdblockSyntax {
      * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
      * @see {@link https://github.com/gorhill/uBlock}
      */
-    Ubo = "UblockOrigin",
+    readonly Ubo: "UblockOrigin";
     /**
      * AdGuard syntax.
      *
@@ -44,5 +44,6 @@ export declare enum AdblockSyntax {
      * syntax).
      * @see {@link https://adguard.com/}
      */
-    Adg = "AdGuard"
-}
+    readonly Adg: "AdGuard";
+};
+export type AdblockSyntax = typeof AdblockSyntax[keyof typeof AdblockSyntax];

package/dist/types/utils/constants.d.ts

@@ -127,6 +127,11 @@ export declare const ADG_SCRIPTLET_MASK = "//scriptlet";
 export declare const UBO_SCRIPTLET_MASK = "+js";
 export declare const UBO_SCRIPTLET_MASK_LEGACY = "script:inject";
 export declare const UBO_HTML_MASK = "^";
+export declare const UBO_MATCHES_PATH_OPERATOR = "matches-path";
+export declare const ADG_PATH_MODIFIER = "path";
+export declare const ADG_DOMAINS_MODIFIER = "domain";
+export declare const ADG_APP_MODIFIER = "app";
+export declare const ADG_URL_MODIFIER = "url";
 export declare const MODIFIERS_SEPARATOR = ",";
 export declare const MODIFIER_ASSIGN_OPERATOR = "=";
 export declare const NEGATION_MARKER = "~";

package/dist/types/utils/domain.d.ts

@@ -15,6 +15,9 @@ export declare const WILDCARD_TLD: string;
  * `*.example.org` — matches with any subdomain, e.g. `foo.example.org` or `bar.example.org`
  */
 export declare const WILDCARD_SUBDOMAIN: string;
+/**
+ * Utility functions for domain and hostname validation.
+ */
 export declare class DomainUtils {
     /**
      * Check if the input is a valid domain or hostname.

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

@@ -1,4 +1,4 @@
-export { ADG_SCRIPTLET_MASK, AGLINT_COMMAND_PREFIX, COMMA_DOMAIN_LIST_SEPARATOR, NEGATION_MARKER, HINT_MARKER, IF, INCLUDE, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, PIPE_MODIFIER_SEPARATOR, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_SEPARATOR, PREPROCESSOR_MARKER, SAFARI_CB_AFFINITY, UBO_SCRIPTLET_MASK, } from './constants';
+export { ADG_SCRIPTLET_MASK, AGLINT_COMMAND_PREFIX, COMMA_DOMAIN_LIST_SEPARATOR, NEGATION_MARKER, HINT_MARKER, IF, INCLUDE, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, PIPE_MODIFIER_SEPARATOR, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_SEPARATOR, PREPROCESSOR_MARKER, SAFARI_CB_AFFINITY, UBO_SCRIPTLET_MASK, COMMA, PIPE, } from './constants';
 export { BINARY_SCHEMA_VERSION } from './binary-schema-version';
 export { AdblockSyntax } from './adblockers';
 export { type CosmeticRuleSeparatorFinderResult, CosmeticRuleSeparatorUtils } from './cosmetic-rule-separator';

package/dist/types/utils/input-byte-buffer.d.ts

@@ -137,4 +137,10 @@ export declare class InputByteBuffer extends ByteBuffer {
      * @returns Capacity of the buffer.
      */
     get capacity(): number;
+    /**
+     * Gets the chunks of the buffer.
+     *
+     * @returns Chunks of the buffer.
+     */
+    getChunks(): Uint8Array[];
 }

package/dist/types/utils/output-byte-buffer.d.ts

@@ -123,4 +123,10 @@ export declare class OutputByteBuffer extends ByteBuffer {
      * @returns Current offset in the buffer for writing.
      */
     get currentOffset(): number;
+    /**
+     * Gets the chunks of the buffer.
+     *
+     * @returns Chunks of the buffer.
+     */
+    getChunks(): Uint8Array[];
 }

package/dist/types/utils/quotes.d.ts

@@ -8,24 +8,25 @@ export declare const QUOTE_SET: Set<string>;
 /**
  * Possible quote types for scriptlet parameters
  */
-export declare enum QuoteType {
+export declare const QuoteType: {
     /**
      * No quotes at all
      */
-    None = "none",
+    readonly None: "none";
     /**
      * Single quotes (`'`)
      */
-    Single = "single",
+    readonly Single: "single";
     /**
      * Double quotes (`"`)
      */
-    Double = "double",
+    readonly Double: "double";
     /**
      * Backtick quotes (`` ` ``)
      */
-    Backtick = "backtick"
-}
+    readonly Backtick: "backtick";
+};
+export type QuoteType = typeof QuoteType[keyof typeof QuoteType];
 /**
  * Utility functions for working with quotes
  */

package/dist/types/utils/regexp.d.ts

@@ -33,6 +33,20 @@ export declare class RegExpUtils {
      * @returns `true` if the string is a RegExp pattern, `false` otherwise
      */
     static isRegexPattern(pattern: string): boolean;
+    /**
+     * Checks whether a string is a negated RegExp pattern.
+     *
+     * @param pattern - Pattern to check
+     * @returns `true` if the string is a negated RegExp pattern, `false` otherwise
+     */
+    static isNegatedRegexPattern(pattern: string): boolean;
+    /**
+     * Removes negation from a RegExp pattern.
+     *
+     * @param pattern - RegExp pattern to remove negation from
+     * @returns RegExp pattern without negation
+     */
+    static removeNegationFromRegexPattern(pattern: string): string;
     /**
      * Negates a RegExp pattern. Technically, this method wraps the pattern in `^((?!` and `).)*$`.
      *
@@ -42,6 +56,13 @@ export declare class RegExpUtils {
      * @returns Negated RegExp pattern
      */
     static negateRegexPattern(pattern: string): string;
+    /**
+     * Ensures that a pattern is wrapped in slashes.
+     *
+     * @param pattern Pattern to ensure slashes for
+     * @returns Pattern with slashes
+     */
+    static ensureSlashes(pattern: string): string;
     /**
      * Converts a basic adblock rule pattern to a RegExp pattern. Based on
      * https://github.com/AdguardTeam/tsurlfilter/blob/9b26e0b4a0e30b87690bc60f7cf377d112c3085c/packages/tsurlfilter/src/rules/simple-regex.ts#L219

package/dist/types/utils/string.d.ts

@@ -5,6 +5,9 @@ export declare const SINGLE_QUOTE_MARKER = "'";
 export declare const DOUBLE_QUOTE_MARKER = "\"";
 export type NewLineType = 'lf' | 'crlf' | 'cr';
 export type NewLineSplit = [string, NewLineType | null][];
+/**
+ * Utility functions for string manipulation.
+ */
 export declare class StringUtils {
     /**
      * Finds the first occurrence of a character that:

package/dist/types/validator/value.d.ts

@@ -5,7 +5,8 @@ import { type ValidationResult } from './helpers';
  *
  * @param modifier Modifier AST node.
  * @param valueFormat Value format for the modifier.
+ * @param valueFormatFlags Optional; RegExp flags for the value format.
  *
  * @returns Validation result.
  */
-export declare const validateValue: (modifier: Modifier, valueFormat: string) => ValidationResult;
+export declare const validateValue: (modifier: Modifier, valueFormat: string, valueFormatFlags?: string | null) => ValidationResult;

package/dist/{esm/utils/adblockers.mjs → utils/adblockers.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
@@ -10,8 +10,7 @@
 /**
  * Possible adblock syntaxes (supported by this library)
  */
-var AdblockSyntax;
-(function (AdblockSyntax) {
+const AdblockSyntax = {
     /**
      * Common syntax, which is supported by more than one adblocker (or by all adblockers).
      *
@@ -23,7 +22,7 @@ var AdblockSyntax;
      * we cannot determine at parsing level whether `important` is a valid option or not, and if it is valid,
      * then which adblocker supports it.
      */
-    AdblockSyntax["Common"] = "Common";
+    Common: 'Common',
     /**
      * Adblock Plus syntax.
      *
@@ -32,7 +31,7 @@ var AdblockSyntax;
      * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
      * @see {@link https://adblockplus.org/}
      */
-    AdblockSyntax["Abp"] = "AdblockPlus";
+    Abp: 'AdblockPlus',
     /**
      * uBlock Origin syntax.
      *
@@ -41,7 +40,7 @@ var AdblockSyntax;
      * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
      * @see {@link https://github.com/gorhill/uBlock}
      */
-    AdblockSyntax["Ubo"] = "UblockOrigin";
+    Ubo: 'UblockOrigin',
     /**
      * AdGuard syntax.
      *
@@ -51,7 +50,7 @@ var AdblockSyntax;
      * syntax).
      * @see {@link https://adguard.com/}
      */
-    AdblockSyntax["Adg"] = "AdGuard";
-})(AdblockSyntax || (AdblockSyntax = {}));
+    Adg: 'AdGuard',
+};
 
 export { AdblockSyntax };

package/dist/{esm/utils/binary-schema-version.mjs → utils/binary-schema-version.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/utils/byte-buffer.mjs → utils/byte-buffer.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/utils/categorizer.mjs → utils/categorizer.js}

@@ -1,12 +1,12 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { CosmeticRuleParser } from '../parser/cosmetic/cosmetic-rule-parser.mjs';
-import { isNull } from './type-guards.mjs';
-import { defaultParserOptions } from '../parser/options.mjs';
+import { CosmeticRuleParser } from '../parser/cosmetic/cosmetic-rule-parser.js';
+import { isNull } from './type-guards.js';
+import { defaultParserOptions } from '../parser/options.js';
 
 /**
  * Utility functions for categorizing rules.

package/dist/{esm/utils/clone.mjs → utils/clone.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/utils/constants.mjs → utils/constants.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
@@ -199,6 +199,11 @@ const ADG_SCRIPTLET_MASK = '//scriptlet';
 const UBO_SCRIPTLET_MASK = '+js';
 const UBO_SCRIPTLET_MASK_LEGACY = 'script:inject';
 const UBO_HTML_MASK = '^';
+const UBO_MATCHES_PATH_OPERATOR = 'matches-path';
+const ADG_PATH_MODIFIER = 'path';
+const ADG_DOMAINS_MODIFIER = 'domain';
+const ADG_APP_MODIFIER = 'app';
+const ADG_URL_MODIFIER = 'url';
 // Modifiers are separated by ",". For example: "script,domain=example.com"
 const MODIFIERS_SEPARATOR = ',';
 const MODIFIER_ASSIGN_OPERATOR = '=';
@@ -229,6 +234,8 @@ const COMMA_DOMAIN_LIST_SEPARATOR = ',';
 const PIPE_MODIFIER_SEPARATOR = '|';
 const CSS_MEDIA_MARKER = '@media';
 const CSS_NOT_PSEUDO = 'not';
+const CSS_BLOCK_OPEN = '{';
+const CSS_BLOCK_CLOSE = '}';
 const HINT_MARKER = '!+';
 const HINT_MARKER_LEN = HINT_MARKER.length;
 const NETWORK_RULE_EXCEPTION_MARKER = '@@';
@@ -246,4 +253,4 @@ const NULL = 0;
 const UINT8_MAX = 255;
 const UINT16_MAX = 65535;
 
-export { ADG_SCRIPTLET_MASK, AGLINT_COMMAND_PREFIX, AGLINT_CONFIG_COMMENT_MARKER, AMPERSAND, ASTERISK, AT_SIGN, BACKSLASH, BACKTICK_QUOTE, CAPITAL_LETTERS, CAPITAL_LETTER_A, CAPITAL_LETTER_B, CAPITAL_LETTER_C, CAPITAL_LETTER_D, CAPITAL_LETTER_E, CAPITAL_LETTER_F, CAPITAL_LETTER_G, CAPITAL_LETTER_H, CAPITAL_LETTER_I, CAPITAL_LETTER_J, CAPITAL_LETTER_K, CAPITAL_LETTER_L, CAPITAL_LETTER_M, CAPITAL_LETTER_N, CAPITAL_LETTER_O, CAPITAL_LETTER_P, CAPITAL_LETTER_Q, CAPITAL_LETTER_R, CAPITAL_LETTER_S, CAPITAL_LETTER_T, CAPITAL_LETTER_U, CAPITAL_LETTER_V, CAPITAL_LETTER_W, CAPITAL_LETTER_X, CAPITAL_LETTER_Y, CAPITAL_LETTER_Z, CARET, CLOSE_CURLY_BRACKET, CLOSE_PARENTHESIS, CLOSE_SQUARE_BRACKET, COLON, COMMA, COMMA_DOMAIN_LIST_SEPARATOR, CR, CRLF, CSS_MEDIA_MARKER, CSS_NOT_PSEUDO, DOLLAR_SIGN, DOT, DOUBLE_QUOTE, EMPTY, EQUALS, ESCAPE_CHARACTER, EXCLAMATION_MARK, FF, HASHMARK, HINT_MARKER, HINT_MARKER_LEN, IF, INCLUDE, LF, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, NEGATION_MARKER, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_EXCEPTION_MARKER_LEN, NETWORK_RULE_SEPARATOR, NEWLINE, NULL, NUMBERS, NUMBER_0, NUMBER_1, NUMBER_2, NUMBER_3, NUMBER_4, NUMBER_5, NUMBER_6, NUMBER_7, NUMBER_8, NUMBER_9, OPEN_CURLY_BRACKET, OPEN_PARENTHESIS, OPEN_SQUARE_BRACKET, PIPE, PIPE_MODIFIER_SEPARATOR, PLUS, PREPROCESSOR_MARKER, PREPROCESSOR_MARKER_LEN, PREPROCESSOR_SEPARATOR, QUESTION_MARK, REGEX_MARKER, SAFARI_CB_AFFINITY, SEMICOLON, SINGLE_QUOTE, SLASH, SMALL_LETTERS, SMALL_LETTER_A, SMALL_LETTER_B, SMALL_LETTER_C, SMALL_LETTER_D, SMALL_LETTER_E, SMALL_LETTER_F, SMALL_LETTER_G, SMALL_LETTER_H, SMALL_LETTER_I, SMALL_LETTER_J, SMALL_LETTER_K, SMALL_LETTER_L, SMALL_LETTER_M, SMALL_LETTER_N, SMALL_LETTER_O, SMALL_LETTER_P, SMALL_LETTER_Q, SMALL_LETTER_R, SMALL_LETTER_S, SMALL_LETTER_T, SMALL_LETTER_U, SMALL_LETTER_V, SMALL_LETTER_W, SMALL_LETTER_X, SMALL_LETTER_Y, SMALL_LETTER_Z, SPACE, TAB, UBO_HTML_MASK, UBO_SCRIPTLET_MASK, UBO_SCRIPTLET_MASK_LEGACY, UINT16_MAX, UINT8_MAX, UNDERSCORE, WILDCARD };
+export { ADG_APP_MODIFIER, ADG_DOMAINS_MODIFIER, ADG_PATH_MODIFIER, ADG_SCRIPTLET_MASK, ADG_URL_MODIFIER, AGLINT_COMMAND_PREFIX, AGLINT_CONFIG_COMMENT_MARKER, AMPERSAND, ASTERISK, AT_SIGN, BACKSLASH, BACKTICK_QUOTE, CAPITAL_LETTERS, CAPITAL_LETTER_A, CAPITAL_LETTER_B, CAPITAL_LETTER_C, CAPITAL_LETTER_D, CAPITAL_LETTER_E, CAPITAL_LETTER_F, CAPITAL_LETTER_G, CAPITAL_LETTER_H, CAPITAL_LETTER_I, CAPITAL_LETTER_J, CAPITAL_LETTER_K, CAPITAL_LETTER_L, CAPITAL_LETTER_M, CAPITAL_LETTER_N, CAPITAL_LETTER_O, CAPITAL_LETTER_P, CAPITAL_LETTER_Q, CAPITAL_LETTER_R, CAPITAL_LETTER_S, CAPITAL_LETTER_T, CAPITAL_LETTER_U, CAPITAL_LETTER_V, CAPITAL_LETTER_W, CAPITAL_LETTER_X, CAPITAL_LETTER_Y, CAPITAL_LETTER_Z, CARET, CLOSE_CURLY_BRACKET, CLOSE_PARENTHESIS, CLOSE_SQUARE_BRACKET, COLON, COMMA, COMMA_DOMAIN_LIST_SEPARATOR, CR, CRLF, CSS_BLOCK_CLOSE, CSS_BLOCK_OPEN, CSS_MEDIA_MARKER, CSS_NOT_PSEUDO, DOLLAR_SIGN, DOT, DOUBLE_QUOTE, EMPTY, EQUALS, ESCAPE_CHARACTER, EXCLAMATION_MARK, FF, HASHMARK, HINT_MARKER, HINT_MARKER_LEN, IF, INCLUDE, LF, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, NEGATION_MARKER, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_EXCEPTION_MARKER_LEN, NETWORK_RULE_SEPARATOR, NEWLINE, NULL, NUMBERS, NUMBER_0, NUMBER_1, NUMBER_2, NUMBER_3, NUMBER_4, NUMBER_5, NUMBER_6, NUMBER_7, NUMBER_8, NUMBER_9, OPEN_CURLY_BRACKET, OPEN_PARENTHESIS, OPEN_SQUARE_BRACKET, PIPE, PIPE_MODIFIER_SEPARATOR, PLUS, PREPROCESSOR_MARKER, PREPROCESSOR_MARKER_LEN, PREPROCESSOR_SEPARATOR, QUESTION_MARK, REGEX_MARKER, SAFARI_CB_AFFINITY, SEMICOLON, SINGLE_QUOTE, SLASH, SMALL_LETTERS, SMALL_LETTER_A, SMALL_LETTER_B, SMALL_LETTER_C, SMALL_LETTER_D, SMALL_LETTER_E, SMALL_LETTER_F, SMALL_LETTER_G, SMALL_LETTER_H, SMALL_LETTER_I, SMALL_LETTER_J, SMALL_LETTER_K, SMALL_LETTER_L, SMALL_LETTER_M, SMALL_LETTER_N, SMALL_LETTER_O, SMALL_LETTER_P, SMALL_LETTER_Q, SMALL_LETTER_R, SMALL_LETTER_S, SMALL_LETTER_T, SMALL_LETTER_U, SMALL_LETTER_V, SMALL_LETTER_W, SMALL_LETTER_X, SMALL_LETTER_Y, SMALL_LETTER_Z, SPACE, TAB, UBO_HTML_MASK, UBO_MATCHES_PATH_OPERATOR, UBO_SCRIPTLET_MASK, UBO_SCRIPTLET_MASK_LEGACY, UINT16_MAX, UINT8_MAX, UNDERSCORE, WILDCARD };

package/dist/{esm/utils/cosmetic-rule-separator.mjs → utils/cosmetic-rule-separator.js}

@@ -1,11 +1,11 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { CosmeticRuleSeparator } from '../nodes/index.mjs';
-import { AT_SIGN, SPACE } from './constants.mjs';
+import { CosmeticRuleSeparator } from '../nodes/index.js';
+import { AT_SIGN, SPACE } from './constants.js';
 
 /**
  * @file Cosmetic rule separator finder and categorizer

package/dist/{esm/utils/deep-freeze.mjs → utils/deep-freeze.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/utils/domain.mjs → utils/domain.js}

@@ -1,11 +1,11 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { parse } from 'tldts';
-import { WILDCARD, DOT } from './constants.mjs';
+import { WILDCARD, DOT } from './constants.js';
 
 /**
  * @file Utility functions for domain and hostname validation.
@@ -24,6 +24,9 @@ const WILDCARD_TLD = DOT + WILDCARD;
  * `*.example.org` — matches with any subdomain, e.g. `foo.example.org` or `bar.example.org`
  */
 const WILDCARD_SUBDOMAIN = WILDCARD + DOT;
+/**
+ * Utility functions for domain and hostname validation.
+ */
 class DomainUtils {
     /**
      * Check if the input is a valid domain or hostname.

package/dist/{esm/utils/error.mjs → utils/error.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */