@adguard/agtree 3.3.0 → 3.4.0

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

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/cosmetic/cosmetic-rule-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/cosmetic/css-injection-body-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/cosmetic/element-hiding-body-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/empty-rule-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/filterlist-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/index.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/invalid-rule-error-node-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/invalid-rule-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/domain-list-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/list-item-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/list-items-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/logical-expression-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/modifier-list-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/modifier-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/parameter-list-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/misc/value-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/network/host-rule-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/network/hostname-list-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/network/network-rule-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/serializer/rule-serializer.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v3.3.0 (build date: Thu, 20 Nov 2025 14:22:17 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/types/compatibility-tables/base.d.ts

@@ -2,9 +2,9 @@
  * @file Provides common compatibility table methods.
  */
 import { type BaseCompatibilityDataSchema } from './schemas/index.js';
-import { GenericPlatform, type SpecificPlatform } from './platforms.js';
+import { type AnyPlatform, type SpecificPlatform } from './platforms.js';
 import { type CompatibilityTable } from './types.js';
-import { AdblockSyntax } from '../utils/adblockers.js';
+import { type AdblockProduct } from '../utils/adblockers.js';
 /**
  * Lists all supported entity records by a product.
  *
@@ -18,14 +18,14 @@ export type ProductRecords<T> = {
 /**
  * Defines a compatibility table row by product.
  *
- * Keys are Adblock syntaxes, values are product records.
+ * Keys are Adblock products, values are product records.
  *
  * @template T Compatibility data schema.
  */
 export type RowByProduct<T> = {
-    [AdblockSyntax.Adg]: ProductRecords<T>;
-    [AdblockSyntax.Ubo]: ProductRecords<T>;
-    [AdblockSyntax.Abp]: ProductRecords<T>;
+    [AdblockProduct.Adg]: ProductRecords<T>;
+    [AdblockProduct.Ubo]: ProductRecords<T>;
+    [AdblockProduct.Abp]: ProductRecords<T>;
 };
 /**
  * Defines multiple compatibility table rows by product.
@@ -100,7 +100,7 @@ export declare abstract class CompatibilityTableBase<T extends BaseCompatibility
      *
      * @returns True if the compatibility data exists, false otherwise.
      */
-    exists(name: string, platform: SpecificPlatform | GenericPlatform): boolean;
+    exists(name: string, platform: AnyPlatform): boolean;
     /**
      * Returns a compatibility data by name and specific platform.
      *
@@ -121,7 +121,7 @@ export declare abstract class CompatibilityTableBase<T extends BaseCompatibility
      *
      * @note Platform enum values can be converted to string names using {@link getSpecificPlatformName} on demand.
      */
-    getMultiple(name: string, platform: SpecificPlatform | GenericPlatform): SinglePlatformRecords<T> | null;
+    getMultiple(name: string, platform: AnyPlatform): SinglePlatformRecords<T> | null;
     /**
      * Returns all compatibility data records for the specified platform.
      *
@@ -129,16 +129,16 @@ export declare abstract class CompatibilityTableBase<T extends BaseCompatibility
      *
      * @returns Array of multiple records grouped by platforms.
      */
-    getAllMultiple(platform: SpecificPlatform | GenericPlatform): SinglePlatformRecords<T>[];
+    getAllMultiple(platform: AnyPlatform): SinglePlatformRecords<T>[];
     /**
      * 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.
      */
-    getFirst(name: string, platform: SpecificPlatform | GenericPlatform): T | null;
+    getFirst(name: string, platform: AnyPlatform): T | null;
     /**
      * Returns all compatibility data records for the specified name.
      *

package/dist/types/compatibility-tables/index.d.ts

@@ -7,7 +7,8 @@ export { scriptletsCompatibilityTable } from './scriptlets.js';
 export * from './types.js';
 export * from './platforms.js';
 export type { ProductRecords, RowByProduct, RowsByProduct, } from './base.js';
-export { parseRawPlatforms, stringifyPlatforms as serializePlatforms } from './schemas/index.js';
-export { isGenericPlatform, getPlatformId, getSpecificPlatformName, getHumanReadablePlatformName, } from './utils/platform-helpers.js';
+export { parseRawPlatforms, stringifyPlatforms, PLATFORM_NEGATION, PLATFORM_SEPARATOR, } from './schemas/index.js';
+export { isGenericPlatform, hasPlatformMultipleProducts, getProductGenericPlatforms, getProductSpecificPlatforms, platformToAdblockProduct, getPlatformsByProduct, getPlatformId, getSpecificPlatformName, getHumanReadablePlatformName, getAllPlatformNames, } from './utils/platform-helpers.js';
+export type { PlatformsByProduct } from './utils/platform-helpers.js';
 export { ResourceType, } from './schemas/resource-type.js';
 export { getResourceTypeModifier, isValidResourceType, } from './utils/resource-type-helpers.js';

package/dist/types/compatibility-tables/platforms.d.ts

@@ -5,46 +5,80 @@
  * while generic platforms are groups of specific platforms
  * (e.g. AdGuard for any OS, AdGuard for any Chromium-based extension, etc.).
  */
+/**
+ * Unique symbol to brand SpecificPlatform type.
+ */
+declare const SpecificPlatformBrand: unique symbol;
+/**
+ * Unique symbol to brand GenericPlatform type.
+ */
+declare const GenericPlatformBrand: unique symbol;
+/**
+ * Branded type for specific platform values.
+ */
+export type SpecificPlatform = number & {
+    readonly [SpecificPlatformBrand]: true;
+};
 /**
  * List of specific platforms.
  */
 export declare const SpecificPlatform: {
-    readonly AdgOsWindows: 1;
-    readonly AdgOsMac: number;
-    readonly AdgOsAndroid: number;
-    readonly AdgExtChrome: number;
-    readonly AdgExtOpera: number;
-    readonly AdgExtEdge: number;
-    readonly AdgExtFirefox: number;
-    readonly AdgCbAndroid: number;
-    readonly AdgCbIos: number;
-    readonly AdgCbSafari: number;
-    readonly UboExtChrome: number;
-    readonly UboExtOpera: number;
-    readonly UboExtEdge: number;
-    readonly UboExtFirefox: number;
-    readonly AbpExtChrome: number;
-    readonly AbpExtOpera: number;
-    readonly AbpExtEdge: number;
-    readonly AbpExtFirefox: number;
+    AdgOsWindows: SpecificPlatform;
+    AdgOsMac: SpecificPlatform;
+    AdgOsAndroid: SpecificPlatform;
+    AdgExtChrome: SpecificPlatform;
+    AdgExtOpera: SpecificPlatform;
+    AdgExtEdge: SpecificPlatform;
+    AdgExtFirefox: SpecificPlatform;
+    AdgCbAndroid: SpecificPlatform;
+    AdgCbIos: SpecificPlatform;
+    AdgCbSafari: SpecificPlatform;
+    UboExtChrome: SpecificPlatform;
+    UboExtOpera: SpecificPlatform;
+    UboExtEdge: SpecificPlatform;
+    UboExtFirefox: SpecificPlatform;
+    AbpExtChrome: SpecificPlatform;
+    AbpExtOpera: SpecificPlatform;
+    AbpExtEdge: SpecificPlatform;
+    AbpExtFirefox: SpecificPlatform;
+};
+/**
+ * Branded type for generic platform values.
+ */
+export type GenericPlatform = number & {
+    readonly [GenericPlatformBrand]: true;
 };
-export type SpecificPlatform = typeof SpecificPlatform[keyof typeof SpecificPlatform];
 /**
  * List of generic platforms (combinations of specific platforms).
  */
 export declare const GenericPlatform: {
-    readonly AdgOsAny: number;
-    readonly AdgSafariAny: number;
-    readonly AdgExtChromium: number;
-    readonly AdgExtAny: number;
-    readonly AdgAny: number;
-    readonly UboExtChromium: number;
-    readonly UboExtAny: number;
-    readonly UboAny: number;
-    readonly AbpExtChromium: number;
-    readonly AbpExtAny: number;
-    readonly AbpAny: number;
-    readonly Any: number;
+    AdgOsAny: GenericPlatform;
+    AdgSafariAny: GenericPlatform;
+    AdgExtChromium: GenericPlatform;
+    AdgExtAny: GenericPlatform;
+    AdgAny: GenericPlatform;
+    UboExtChromium: GenericPlatform;
+    UboExtAny: GenericPlatform;
+    UboAny: GenericPlatform;
+    AbpExtChromium: GenericPlatform;
+    AbpExtAny: GenericPlatform;
+    AbpAny: GenericPlatform;
+    Any: GenericPlatform;
 };
-export type GenericPlatform = typeof GenericPlatform[keyof typeof GenericPlatform];
-export type AnyPlatform = SpecificPlatform | GenericPlatform;
+/**
+ * Represents any platform: specific, generic, or a combination of platforms.
+ *
+ * The `number` type is included to support combined platforms created via bitwise OR operations.
+ * For example: `GenericPlatform.AdgAny | GenericPlatform.UboAny` results in a `number` at the type level.
+ *
+ * @example
+ * ```typescript
+ * // Single platform
+ * const singlePlatform: AnyPlatform = SpecificPlatform.AdgOsWindows;
+ *
+ * // Combined platforms (result is number)
+ * const combinedPlatforms: AnyPlatform = GenericPlatform.AdgAny | GenericPlatform.UboAny;
+ * ```
+ */
+export type AnyPlatform = SpecificPlatform | GenericPlatform | number;
+export {};

package/dist/types/compatibility-tables/redirects.d.ts

@@ -4,7 +4,7 @@
 import { CompatibilityTableBase } from './base.js';
 import { type RedirectDataSchema } from './schemas/index.js';
 import { type CompatibilityTable } from './types.js';
-import { type GenericPlatform, type SpecificPlatform } from './platforms.js';
+import { type AnyPlatform } from './platforms.js';
 /**
  * Compatibility table for redirects.
  */
@@ -20,11 +20,11 @@ declare class RedirectsCompatibilityTable extends CompatibilityTableBase<Redirec
      * 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.
      */
-    getResourceTypeModifiers(redirect: string | RedirectDataSchema, platform: SpecificPlatform | GenericPlatform): Set<string>;
+    getResourceTypeModifiers(redirect: string | RedirectDataSchema, platform: AnyPlatform): Set<string>;
 }
 /**
  * Compatibility table instance for redirects.

package/dist/types/compatibility-tables/schemas/base.d.ts

@@ -117,7 +117,7 @@ export declare const baseRefineLogic: (data: zod.infer<typeof baseCompatibilityD
  *
  * @returns Base file schema.
  */
-export declare const baseFileSchema: <T extends BaseCompatibilityDataSchema>(dataSchema: zod.ZodType<T>) => zod.ZodPipeline<zod.ZodEffects<zod.ZodRecord<zod.ZodAny, zod.ZodAny>, Record<any, any>, Record<any, any>>, zod.ZodRecord<zod.ZodEffects<zod.ZodString, number, string>, zod.ZodType<T, zod.ZodTypeDef, T>>>;
+export declare const baseFileSchema: <T extends BaseCompatibilityDataSchema>(dataSchema: zod.ZodType<T>) => zod.ZodPipeline<zod.ZodEffects<zod.ZodRecord<zod.ZodAny, zod.ZodAny>, Record<any, any>, Record<any, any>>, zod.ZodRecord<zod.ZodEffects<zod.ZodString, number | import("../index.js").SpecificPlatform | import("../index.js").GenericPlatform, string>, zod.ZodType<T, zod.ZodTypeDef, T>>>;
 /**
  * Type of the base file schema.
  */

package/dist/types/compatibility-tables/schemas/platform.d.ts

@@ -2,25 +2,36 @@
  * @file Platform schema.
  */
 import zod from 'zod';
+import { type AnyPlatform } from '../platforms.js';
+/**
+ * Platform separator, e.g. 'adg_os_any|adg_safari_any' means any AdGuard OS platform and
+ * any AdGuard Safari content blocker platform.
+ */
+export declare const PLATFORM_SEPARATOR = "|";
+/**
+ * Platform negation character, e.g. 'adg_any|~adg_safari_any' means any AdGuard product except
+ * Safari content blockers.
+ */
+export declare const PLATFORM_NEGATION = "~";
 /**
  * Parses a raw platform string into a platform bitmask.
  *
  * @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).
  */
-export declare const parseRawPlatforms: (rawPlatforms: string) => number;
+export declare const parseRawPlatforms: (rawPlatforms: string) => AnyPlatform;
 /**
  * Converts a platform bitmask back to a string representation.
  * Prefers generic platforms over specific platforms where possible.
  *
- * @param bitmask Platform bitmask.
+ * @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.
  */
-export declare const stringifyPlatforms: (bitmask: number) => string;
+export declare const stringifyPlatforms: (bitmask: AnyPlatform) => string;
 /**
  * Platform schema.
  */
-export declare const platformSchema: zod.ZodEffects<zod.ZodString, number, string>;
+export declare const platformSchema: zod.ZodEffects<zod.ZodString, number | import("../index.js").SpecificPlatform | import("../index.js").GenericPlatform, string>;

package/dist/types/compatibility-tables/utils/platform-helpers.d.ts

@@ -2,6 +2,8 @@
  * @file Provides platform mapping and helper functions.
  */
 import { type AnyPlatform, GenericPlatform, SpecificPlatform } from '../platforms.js';
+import { AdblockProduct } from '../../utils/adblockers.js';
+import { type ReadonlyRecord } from '../../utils/types.js';
 /**
  * Map of specific platforms string names to their corresponding enum values.
  */
@@ -17,13 +19,89 @@ export declare const SPECIFIC_PLATFORM_MAP_REVERSE: Map<SpecificPlatform, string
  */
 export declare const GENERIC_PLATFORM_MAP: Map<string, GenericPlatform>;
 /**
- * Check if the platform is a generic platform.
+ * Initializes and returns the product generic platforms map.
+ * Filters all generic platforms by product prefix and sorts by specificity (fewer bits = more specific).
+ *
+ * @returns Map of products to their generic platforms, ordered from most to least specific.
+ */
+export declare const getProductGenericPlatforms: () => ReadonlyRecord<AdblockProduct, readonly GenericPlatform[]>;
+/**
+ * Check if the platform is a generic platform (or a combination of platforms).
+ *
+ * @param platform Platform to check.
+ *
+ * @returns True if the platform is a generic platform or combined platforms, false if it's a specific platform.
+ */
+export declare const isGenericPlatform: (platform: AnyPlatform) => platform is GenericPlatform | number;
+/**
+ * Check if the platform has multiple products specified.
+ * Multiple products means at least 2 of: AdgAny, AbpAny, UboAny.
  *
  * @param platform Platform to check.
  *
- * @returns True if the platform is a generic platform, false otherwise.
+ * @returns True if at least 2 products are specified, false otherwise.
+ */
+export declare const hasPlatformMultipleProducts: (platform: AnyPlatform) => boolean;
+/**
+ * Converts a platform to its corresponding adblock products.
+ *
+ * Note: This conversion is less specific than the platform itself, as it only returns
+ * which products (AdGuard/uBlock/Abp) are present, dropping specific platform information
+ * (e.g., Windows vs Chrome extension).
+ *
+ * @param platform Platform to convert.
+ *
+ * @returns Array of AdblockProduct values:
+ * - Empty array `[]` if platform is 0 or no products are found
+ * - Array of specific products based on which products are present
+ *   (e.g., `['AdGuard', 'UblockOrigin']` if both AdGuard and uBlock Origin are specified)
+ * - `['AdGuard', 'UblockOrigin', 'AdblockPlus']` for GenericPlatform.Any
+ */
+export declare const platformToAdblockProduct: (platform: AnyPlatform) => AdblockProduct[];
+/**
+ * Platforms grouped by product.
+ * Maps each product to an array of its platform values.
+ */
+export type PlatformsByProduct = Partial<Record<AdblockProduct, AnyPlatform[]>>;
+/**
+ * Splits a platform by products, returning a record mapping each product to its platforms.
+ * This is useful for iterating over each product separately when validating or processing.
+ *
+ * The function optimizes the platform representation by combining specific platforms
+ * into generic ones when possible, returning the minimal set needed.
+ *
+ * @param platform Platform to split (can be single or multi-product).
+ *
+ * @returns Record mapping products to optimized platform arrays:
+ * - Empty object `{}` if platform is 0 or no products are found
+ * - Object with single product key for single-product platforms
+ * - Object with multiple product keys for multi-product platforms
+ * - Each array contains the minimal representation using generic platforms where possible
+ *
+ * @example
+ * ```typescript
+ * // Multi-product platform
+ * const platforms = getPlatformsByProduct(GenericPlatform.AdgAny | GenericPlatform.UboAny);
+ * // Returns: {
+ * //   'AdGuard': [GenericPlatform.AdgAny],
+ * //   'UblockOrigin': [GenericPlatform.UboAny]
+ * // }
+ *
+ * // Mixed specific and generic
+ * const mixed = SpecificPlatform.AdgExtChrome | SpecificPlatform.AdgExtFirefox | SpecificPlatform.AdgOsWindows;
+ * const result = getPlatformsByProduct(mixed);
+ * // Might return: { 'AdGuard': [GenericPlatform.AdgExtChromium, SpecificPlatform.AdgOsWindows] }
+ *
+ * // Iterate and validate for each product
+ * for (const [product, platformList] of Object.entries(platforms)) {
+ *     for (const p of platformList) {
+ *         const result = modifierValidator.validate(p, modifier);
+ *         console.log(`${product}: ${result.valid}`);
+ *     }
+ * }
+ * ```
  */
-export declare const isGenericPlatform: (platform: AnyPlatform) => boolean;
+export declare const getPlatformsByProduct: (platform: AnyPlatform) => PlatformsByProduct;
 /**
  * Returns the platform enum value for the given platform string name.
  *
@@ -52,3 +130,34 @@ export declare const getSpecificPlatformName: (platform: SpecificPlatform) => st
  * @throws Error if the platform is unknown.
  */
 export declare const getHumanReadablePlatformName: (platform: AnyPlatform) => string;
+/**
+ * Gets all specific platforms for a given AdblockProduct.
+ * Results are cached after the first call.
+ *
+ * @param product AdblockProduct to get specific platforms for.
+ *
+ * @returns Array of all specific platforms for the given product.
+ *
+ * @example
+ * ```typescript
+ * const adgPlatforms = getProductSpecificPlatforms(AdblockProduct.Adg);
+ * // Returns: [AdgOsWindows, AdgOsMac, AdgOsAndroid, AdgExtChrome, ...]
+ * ```
+ */
+export declare const getProductSpecificPlatforms: (product: AdblockProduct) => readonly SpecificPlatform[];
+/**
+ * Gets all available platform names from the platform maps.
+ *
+ * @returns Object containing arrays of all specific and generic platform names.
+ *
+ * @example
+ * ```typescript
+ * const { specificPlatformNames, genericPlatformNames } = getAllPlatformNames();
+ * // specificPlatformNames: ['adg_os_windows', 'adg_os_mac', 'adg_os_android', ...]
+ * // genericPlatformNames: ['adg_os_any', 'adg_safari_any', 'adg_ext_chromium', ...]
+ * ```
+ */
+export declare const getAllPlatformNames: () => {
+    specificPlatformNames: readonly string[];
+    genericPlatformNames: readonly string[];
+};

package/dist/types/compatibility-tables/utils/resource-type-helpers.d.ts

@@ -1,15 +1,15 @@
-import { type GenericPlatform, type SpecificPlatform } from '../platforms.js';
+import { type AnyPlatform } from '../platforms.js';
 import { ResourceType } from '../schemas/resource-type.js';
 /**
  * Gets the adblock modifier name for the given resource type.
  *
  * @param resourceType Resource type to get the modifier name for.
- * @param platform Platform to get the modifier for.
+ * @param platform Platform to get the modifier for (can be specific, generic, or combined platforms).
  *
  * @returns A string containing the adblock modifier name for the given resource type
  * or `null` if the modifier could not be found.
  */
-export declare const getResourceTypeModifier: (resourceType: ResourceType, platform: SpecificPlatform | GenericPlatform) => string | null;
+export declare const getResourceTypeModifier: (resourceType: ResourceType, platform: AnyPlatform) => string | null;
 /**
  * Checks if the given resource type is valid.
  *

package/dist/types/index.d.ts

@@ -37,7 +37,7 @@ export { modifierValidator } from './validator/index.js';
 export * from './converter/index.js';
 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 './utils/constants.js';
 export { BINARY_SCHEMA_VERSION } from './utils/binary-schema-version.js';
-export { AdblockSyntax } from './utils/adblockers.js';
+export { AdblockSyntax, AdblockProduct } from './utils/adblockers.js';
 export { type CosmeticRuleSeparatorFinderResult, CosmeticRuleSeparatorUtils } from './utils/cosmetic-rule-separator.js';
 export { DomainUtils } from './utils/domain.js';
 export { type VariableTable, LogicalExpressionUtils } from './utils/logical-expression.js';
@@ -51,6 +51,6 @@ export { encodeIntoPolyfill, type TextEncoderPolyfillResult } from './utils/text
 export { decodeTextPolyfill } from './utils/text-decoder-polyfill.js';
 export { RuleCategorizer } from './utils/categorizer.js';
 export { EXT_CSS_PSEUDO_CLASSES, EXT_CSS_LEGACY_ATTRIBUTES, FORBIDDEN_CSS_FUNCTIONS } from './converter/data/css.js';
-export { GenericPlatform, SpecificPlatform, modifiersCompatibilityTable, redirectsCompatibilityTable, scriptletsCompatibilityTable, parseRawPlatforms, type CompatibilityTable, type CompatibilityTableRow, type ProductRecords, type RowByProduct, type RowsByProduct, isGenericPlatform, getPlatformId, getSpecificPlatformName, ResourceType, getResourceTypeModifier, isValidResourceType, } from './compatibility-tables/index.js';
+export { GenericPlatform, SpecificPlatform, modifiersCompatibilityTable, redirectsCompatibilityTable, scriptletsCompatibilityTable, parseRawPlatforms, type CompatibilityTable, type CompatibilityTableRow, type ProductRecords, type RowByProduct, type RowsByProduct, isGenericPlatform, getPlatformId, getSpecificPlatformName, hasPlatformMultipleProducts, getProductGenericPlatforms, getProductSpecificPlatforms, platformToAdblockProduct, getPlatformsByProduct, getHumanReadablePlatformName, getAllPlatformNames, ResourceType, getResourceTypeModifier, isValidResourceType, stringifyPlatforms, type PlatformsByProduct, type AnyPlatform, PLATFORM_NEGATION, PLATFORM_SEPARATOR, } from './compatibility-tables/index.js';
 export { AGTREE_VERSION } from './version.js';
 export { getSyntaxSerializationMap } from './marshalling-utils/syntax-serialization-map.js';