@adguard/agtree 3.3.1 → 3.4.0

package/dist/ast-utils/clone.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/ast-utils/modifiers.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/ast-utils/network-rules.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/ast-utils/scriptlets.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/common/abp-snippet-injection-body-common.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/common/agent-common.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/common/ubo-selector-common.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/base.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -181,7 +181,7 @@ class CompatibilityTableBase {
      * Returns the first compatibility data record for name and specified platform.
      *
      * @param name Compatibility data name.
-     * @param platform Specific or generic platform.
+     * @param platform Specific, generic, or combined platform.
      *
      * @returns First found compatibility data record or `null` if not found.
      */

package/dist/compatibility-tables/compatibility-table-data.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/modifiers.js

@@ -1,13 +1,14 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { CompatibilityTableBase } from './base.js';
 import { modifiersCompatibilityTableData } from './compatibility-table-data.js';
-import { UNDERSCORE, EMPTY } from '../utils/constants.js';
+import { UNDERSCORE } from '../utils/constants.js';
 import { deepFreeze } from '../utils/deep-freeze.js';
+import { isValidNoopModifier } from '../utils/noop-modifier.js';
 
 /**
  * @file Compatibility tables for modifiers.
@@ -22,7 +23,7 @@ import { deepFreeze } from '../utils/deep-freeze.js';
  */
 const noopModifierNameNormalizer = (name) => {
     if (name.startsWith(UNDERSCORE)) {
-        if (name.split(EMPTY).every((char) => char === UNDERSCORE)) {
+        if (isValidNoopModifier(name)) {
             // in compatibility tables, we just store '_', so we need to reduce the number of underscores to 1
             // before checking the existence of the noop modifier
             return UNDERSCORE;

package/dist/compatibility-tables/platforms.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -15,25 +15,26 @@
 /**
  * List of specific platforms.
  */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
 const SpecificPlatform = {
     AdgOsWindows: 1,
-    AdgOsMac: 1 << 1,
-    AdgOsAndroid: 1 << 2,
-    AdgExtChrome: 1 << 3,
-    AdgExtOpera: 1 << 4,
-    AdgExtEdge: 1 << 5,
-    AdgExtFirefox: 1 << 6,
-    AdgCbAndroid: 1 << 7,
-    AdgCbIos: 1 << 8,
-    AdgCbSafari: 1 << 9,
-    UboExtChrome: 1 << 10,
-    UboExtOpera: 1 << 11,
-    UboExtEdge: 1 << 12,
-    UboExtFirefox: 1 << 13,
-    AbpExtChrome: 1 << 14,
-    AbpExtOpera: 1 << 15,
-    AbpExtEdge: 1 << 16,
-    AbpExtFirefox: 1 << 17,
+    AdgOsMac: (1 << 1),
+    AdgOsAndroid: (1 << 2),
+    AdgExtChrome: (1 << 3),
+    AdgExtOpera: (1 << 4),
+    AdgExtEdge: (1 << 5),
+    AdgExtFirefox: (1 << 6),
+    AdgCbAndroid: (1 << 7),
+    AdgCbIos: (1 << 8),
+    AdgCbSafari: (1 << 9),
+    UboExtChrome: (1 << 10),
+    UboExtOpera: (1 << 11),
+    UboExtEdge: (1 << 12),
+    UboExtFirefox: (1 << 13),
+    AbpExtChrome: (1 << 14),
+    AbpExtOpera: (1 << 15),
+    AbpExtEdge: (1 << 16),
+    AbpExtFirefox: (1 << 17),
 };
 const AdgOsAny = SpecificPlatform.AdgOsWindows
     | SpecificPlatform.AdgOsMac
@@ -58,19 +59,20 @@ const Any = AdgAny | UboAny | AbpAny;
 /**
  * List of generic platforms (combinations of specific platforms).
  */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
 const GenericPlatform = {
-    AdgOsAny,
-    AdgSafariAny,
-    AdgExtChromium,
-    AdgExtAny,
-    AdgAny,
-    UboExtChromium,
-    UboExtAny,
-    UboAny,
-    AbpExtChromium,
-    AbpExtAny,
-    AbpAny,
-    Any,
+    AdgOsAny: AdgOsAny,
+    AdgSafariAny: AdgSafariAny,
+    AdgExtChromium: AdgExtChromium,
+    AdgExtAny: AdgExtAny,
+    AdgAny: AdgAny,
+    UboExtChromium: UboExtChromium,
+    UboExtAny: UboExtAny,
+    UboAny: UboAny,
+    AbpExtChromium: AbpExtChromium,
+    AbpExtAny: AbpExtAny,
+    AbpAny: AbpAny,
+    Any: Any,
 };
 
 export { GenericPlatform, SpecificPlatform };

package/dist/compatibility-tables/redirects.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -66,7 +66,7 @@ class RedirectsCompatibilityTable extends CompatibilityTableBase {
      * based on the `resourceTypes` field.
      *
      * @param redirect Redirect name or redirect data.
-     * @param platform Platform to get the modifiers for.
+     * @param platform Platform to get the modifiers for (can be specific, generic, or combined platforms).
      *
      * @returns Set of resource type modifiers or an empty set if the redirect is not found or has no resource types.
      */

package/dist/compatibility-tables/schemas/base.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/schemas/modifier.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/schemas/platform.js

@@ -1,11 +1,11 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import zod from 'zod';
-import { SPECIFIC_PLATFORM_MAP, GENERIC_PLATFORM_MAP } from '../utils/platform-helpers.js';
+import { SPECIFIC_PLATFORM_MAP, GENERIC_PLATFORM_MAP, SPECIFIC_PLATFORM_MAP_REVERSE } from '../utils/platform-helpers.js';
 import { isUndefined } from '../../utils/type-guards.js';
 
 /* eslint-disable no-bitwise */
@@ -27,7 +27,7 @@ const PLATFORM_NEGATION = '~';
  *
  * @param rawPlatforms Raw platform string, e.g. 'adg_safari_any|adg_os_any'.
  *
- * @returns Platform bitmask.
+ * @returns Platform bitmask (can be specific, generic, or combined platforms).
  */
 const parseRawPlatforms = (rawPlatforms) => {
     // e.g. 'adg_safari_any|adg_os_any'
@@ -58,6 +58,59 @@ const parseRawPlatforms = (rawPlatforms) => {
     }
     return result;
 };
+/**
+ * Converts a platform bitmask back to a string representation.
+ * Prefers generic platforms over specific platforms where possible.
+ *
+ * @param bitmask Platform bitmask (can be specific, generic, or combined platforms).
+ *
+ * @returns Platform string, e.g. 'adg_safari_any|adg_os_any' or 'adg_os_windows|adg_ext_chrome'.
+ * @throws Error if the bitmask is 0 or contains unknown platforms.
+ */
+const stringifyPlatforms = (bitmask) => {
+    if (bitmask === 0) {
+        throw new Error('Invalid bitmask: 0');
+    }
+    // First, try to find an exact match in generic platforms
+    for (const [name, value] of GENERIC_PLATFORM_MAP.entries()) {
+        if (value === bitmask) {
+            return name;
+        }
+    }
+    // Check if the bitmask can be represented as a combination of generic platforms
+    // Try to find the largest generic platforms that fit
+    const platforms = [];
+    let remaining = bitmask;
+    // Sort generic platforms by value (descending) to prefer larger combinations
+    const sortedGenericPlatforms = [...GENERIC_PLATFORM_MAP.entries()].sort((a, b) => b[1] - a[1]);
+    for (const [name, value] of sortedGenericPlatforms) {
+        // Check if this generic platform is fully contained in the remaining bitmask
+        if ((remaining & value) === value) {
+            platforms.push(name);
+            remaining &= ~value;
+            if (remaining === 0) {
+                break;
+            }
+        }
+    }
+    // If we still have remaining bits, add specific platforms
+    if (remaining !== 0) {
+        for (const [value, name] of SPECIFIC_PLATFORM_MAP_REVERSE.entries()) {
+            if (remaining & value) {
+                platforms.push(name);
+                remaining &= ~value;
+                if (remaining === 0) {
+                    break;
+                }
+            }
+        }
+    }
+    // If there are still remaining bits, the bitmask contains unknown platforms
+    if (remaining !== 0) {
+        throw new Error(`Unknown platform bits in bitmask: ${remaining}`);
+    }
+    return platforms.join(PLATFORM_SEPARATOR);
+};
 /**
  * Platform schema.
  */
@@ -66,4 +119,4 @@ zod
     .min(1)
     .transform((value) => parseRawPlatforms(value));
 
-export { parseRawPlatforms };
+export { PLATFORM_NEGATION, PLATFORM_SEPARATOR, parseRawPlatforms, stringifyPlatforms };

package/dist/compatibility-tables/schemas/redirect.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/schemas/resource-type.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/schemas/scriptlet.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/scriptlets.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.1 (build date: Tue, 25 Nov 2025 05:36:56 GMT)
+ * AGTree v3.4.0 (build date: Fri, 28 Nov 2025 09:46:33 GMT)
  * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme