@adguard/agtree 4.0.1 → 4.0.2

package/README.md

@@ -45,9 +45,11 @@ You can install the library using
 [npm-pkg-manager-url]: https://www.npmjs.com/get-npm
 [pnpm-pkg-manager-url]: https://pnpm.io/
 
-## Development & Contribution
+## Documentation
 
-Please read the [CONTRIBUTING.md][contributing-url] file for details on how to contribute to this project.
+- [Changelog](CHANGELOG.md)
+- [Development guide](../../DEVELOPMENT.md)
+- [LLM agent rules](AGENTS.md)
 
 ## Ideas & Questions
 
@@ -88,7 +90,6 @@ resources, please let us know.
 [adg-filters]: https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters
 [adg-scriptlets]: https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#scriptlets
 [compatibility-tables-url]: https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree/src/compatibility-tables
-[contributing-url]: https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree/CONTRIBUTING.md
 [converter-url]: https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree/src/converter
 [discussions-url]: https://github.com/AdguardTeam/tsurlfilter/discussions
 [license-url]: https://github.com/AdguardTeam/tsurlfilter/blob/master/packages/agtree/LICENSE

package/dist/ast-utils/clone.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -8,13 +8,15 @@ import { isNull } from '../utils/type-guards.js';
 
 /**
  * @file Custom clone functions for AST nodes, this is probably the most efficient way to clone AST nodes.
- * @todo Maybe move them to parser classes as 'clone' methods
+ *
+ * @todo Maybe move them to parser classes as 'clone' methods.
  */
 /**
  * Clones a scriptlet rule node.
  *
- * @param node Node to clone
- * @returns Cloned node
+ * @param node Node to clone.
+ *
+ * @returns Cloned node.
  */
 function cloneScriptletRuleNode(node) {
     return {
@@ -25,8 +27,9 @@ function cloneScriptletRuleNode(node) {
 /**
  * Clones a domain list node.
  *
- * @param node Node to clone
- * @returns Cloned node
+ * @param node Node to clone.
+ *
+ * @returns Cloned node.
  */
 function cloneDomainListNode(node) {
     return {
@@ -38,8 +41,9 @@ function cloneDomainListNode(node) {
 /**
  * Clones a modifier list node.
  *
- * @param node Node to clone
- * @returns Cloned node
+ * @param node Node to clone.
+ *
+ * @returns Cloned node.
  */
 function cloneModifierListNode(node) {
     return {

package/dist/ast-utils/modifiers.js

@@ -1,22 +1,23 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { isUndefined } from '../utils/type-guards.js';
 import { clone } from '../utils/clone.js';
+import { isUndefined } from '../utils/type-guards.js';
 
 /**
- * @file Utility functions for working with modifier nodes
+ * @file Utility functions for working with modifier nodes.
  */
 /**
- * Creates a modifier node
+ * Creates a modifier node.
  *
- * @param name Name of the modifier
- * @param value Value of the modifier
- * @param exception Whether the modifier is an exception
- * @returns Modifier node
+ * @param name Name of the modifier.
+ * @param value Value of the modifier.
+ * @param exception Whether the modifier is an exception.
+ *
+ * @returns Modifier node.
  */
 function createModifierNode(name, value = undefined, exception = false) {
     const result = {
@@ -36,10 +37,11 @@ function createModifierNode(name, value = undefined, exception = false) {
     return result;
 }
 /**
- * Creates a modifier list node
+ * Creates a modifier list node.
+ *
+ * @param modifiers Modifiers to put in the list (optional, defaults to an empty list).
  *
- * @param modifiers Modifiers to put in the list (optional, defaults to an empty list)
- * @returns Modifier list node
+ * @returns Modifier list node.
  */
 function createModifierListNode(modifiers = []) {
     const result = {

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

@@ -1,25 +1,26 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { isUndefined } from '../utils/type-guards.js';
 import { NetworkRuleType, RuleCategory } from '../nodes/index.js';
 import { AdblockSyntax } from '../utils/adblockers.js';
 import { clone } from '../utils/clone.js';
+import { isUndefined } from '../utils/type-guards.js';
 
 /**
- * @file Utility functions for working with network rule nodes
+ * @file Utility functions for working with network rule nodes.
  */
 /**
- * Creates a network rule node
+ * Creates a network rule node.
+ *
+ * @param pattern Rule pattern.
+ * @param modifiers Rule modifiers (optional, default: undefined).
+ * @param exception Exception rule flag (optional, default: false).
+ * @param syntax Adblock syntax (optional, default: Common).
  *
- * @param pattern Rule pattern
- * @param modifiers Rule modifiers (optional, default: undefined)
- * @param exception Exception rule flag (optional, default: false)
- * @param syntax Adblock syntax (optional, default: Common)
- * @returns Network rule node
+ * @returns Network rule node.
  */
 function createNetworkRuleNode(pattern, modifiers = undefined, exception = false, syntax = AdblockSyntax.Common) {
     const result = {

package/dist/ast-utils/scriptlets.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -9,14 +9,16 @@ import { QuoteUtils } from '../utils/quotes.js';
 import { isUndefined, isNull } from '../utils/type-guards.js';
 
 /**
- * @file Utility functions for working with scriptlet nodes
+ * @file Utility functions for working with scriptlet nodes.
  */
 /**
- * Get name of the scriptlet from the scriptlet node
+ * Get name of the scriptlet from the scriptlet node.
  *
- * @param scriptletNode Scriptlet node to get name of
- * @returns Name of the scriptlet
- * @throws If the scriptlet is empty
+ * @param scriptletNode Scriptlet node to get name of.
+ *
+ * @returns Name of the scriptlet.
+ *
+ * @throws If the scriptlet is empty.
  */
 function getScriptletName(scriptletNode) {
     if (scriptletNode.children.length === 0) {
@@ -25,11 +27,11 @@ function getScriptletName(scriptletNode) {
     return scriptletNode.children[0]?.value ?? EMPTY;
 }
 /**
- * Transform the nth argument of the scriptlet node
+ * Transform the nth argument of the scriptlet node.
  *
- * @param scriptletNode Scriptlet node to transform argument of
- * @param index Index of the argument to transform (index 0 is the scriptlet name)
- * @param transform Function to transform the argument
+ * @param scriptletNode Scriptlet node to transform argument of.
+ * @param index Index of the argument to transform (index 0 is the scriptlet name).
+ * @param transform Function to transform the argument.
  */
 function transformNthScriptletArgument(scriptletNode, index, transform) {
     const child = scriptletNode.children[index];
@@ -52,10 +54,10 @@ function transformNthScriptletArgument(scriptletNode, index, transform) {
     }
 }
 /**
- * Transform all arguments of the scriptlet node
+ * Transform all arguments of the scriptlet node.
  *
- * @param scriptletNode Scriptlet node to transform arguments of
- * @param transform Function to transform the arguments
+ * @param scriptletNode Scriptlet node to transform arguments of.
+ * @param transform Function to transform the arguments.
  */
 function transformAllScriptletArguments(scriptletNode, transform) {
     for (let i = 0; i < scriptletNode.children.length; i += 1) {
@@ -66,17 +68,17 @@ function transformAllScriptletArguments(scriptletNode, transform) {
  * Set name of the scriptlet.
  * Modifies input `scriptletNode` if needed.
  *
- * @param scriptletNode Scriptlet node to set name of
- * @param name Name to set
+ * @param scriptletNode Scriptlet node to set name of.
+ * @param name Name to set.
  */
 function setScriptletName(scriptletNode, name) {
     transformNthScriptletArgument(scriptletNode, 0, () => name);
 }
 /**
- * Set quote type of the scriptlet parameters
+ * Set quote type of the scriptlet parameters.
  *
- * @param scriptletNode Scriptlet node to set quote type of
- * @param quoteType Preferred quote type
+ * @param scriptletNode Scriptlet node to set quote type of.
+ * @param quoteType Preferred quote type.
  */
 function setScriptletQuoteType(scriptletNode, quoteType) {
     // null is a special value that means "no value", but we can't change its quote type,

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

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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 v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/common/ubo-html-filtering-body-common.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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 v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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,13 +1,13 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { GenericPlatform } from './platforms.js';
+import { AdblockSyntax } from '../utils/adblockers.js';
 import { isUndefined } from '../utils/type-guards.js';
+import { GenericPlatform } from './platforms.js';
 import { isGenericPlatform } from './utils/platform-helpers.js';
-import { AdblockSyntax } from '../utils/adblockers.js';
 
 /* eslint-disable no-bitwise */
 /**
@@ -42,6 +42,7 @@ class CompatibilityTableBase {
      * Helper method to get a 'row' from the compatibility table data by name.
      *
      * @param name Compatibility data name.
+     *
      * @returns Compatibility table row storage or `null` if not found.
      */
     getRowStorage(name) {
@@ -54,12 +55,12 @@ class CompatibilityTableBase {
     /**
      * Checks whether a compatibility data `name` exists for any platform.
      *
-     * @note Technically, do the same as `exists()` method with generic platform _any_
-     * but it is faster because it does not apply complex logic.
-     *
      * @param name Compatibility data name.
      *
      * @returns True if the compatibility data exists, false otherwise.
+     *
+     * @note Technically, do the same as `exists()` method with generic platform _any_
+     * but it is faster because it does not apply complex logic.
      */
     existsAny(name) {
         const normalizedName = this.nameTransformer ? this.nameTransformer(name) : name;

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

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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,14 +1,14 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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 } from '../utils/constants.js';
 import { deepFreeze } from '../utils/deep-freeze.js';
 import { isValidNoopModifier } from '../utils/noop-modifier.js';
+import { CompatibilityTableBase } from './base.js';
+import { modifiersCompatibilityTableData } from './compatibility-table-data.js';
 
 /**
  * @file Compatibility tables for modifiers.
@@ -19,6 +19,7 @@ import { isValidNoopModifier } from '../utils/noop-modifier.js';
  * e.g. '____' is also valid. In this case, we need to normalize the name to '_'.
  *
  * @param name Modifier name to normalize.
+ *
  * @returns Normalized modifier name.
  */
 const noopModifierNameNormalizer = (name) => {

package/dist/compatibility-tables/platforms.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/redirects.js

@@ -1,15 +1,15 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
+import { COLON } from '../utils/constants.js';
+import { deepFreeze } from '../utils/deep-freeze.js';
+import { isString, isNull, isUndefined } from '../utils/type-guards.js';
 import { CompatibilityTableBase } from './base.js';
 import { redirectsCompatibilityTableData } from './compatibility-table-data.js';
-import { deepFreeze } from '../utils/deep-freeze.js';
-import { COLON } from '../utils/constants.js';
 import { getResourceTypeModifier } from './utils/resource-type-helpers.js';
-import { isString, isNull, isUndefined } from '../utils/type-guards.js';
 
 /**
  * @file Compatibility tables for redirects.

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

@@ -1,12 +1,12 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import zod from 'zod';
-import './platform.js';
 import { zodToCamelCase } from '../utils/zod-camelcase.js';
+import './platform.js';
 
 /**
  * @file Base compatibility data schema, which is commonly used in compatibility tables.

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

@@ -1,14 +1,14 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import zod from 'zod';
+import { EMPTY } from '../../utils/constants.js';
+import { getErrorMessage } from '../../utils/error.js';
 import { zodToCamelCase } from '../utils/zod-camelcase.js';
 import { baseCompatibilityDataSchema, nonEmptyStringSchema, booleanSchema, baseRefineLogic } from './base.js';
-import { getErrorMessage } from '../../utils/error.js';
-import { EMPTY } from '../../utils/constants.js';
 
 /**
  * @file Schema for modifier data.
@@ -67,7 +67,7 @@ zodToCamelCase(baseCompatibilityDataSchema.extend({
      * Describes whether the *assignable* modifier value is required.
      * For example, `$cookie` is assignable but it can be used without a value in exception rules:
      * `@@\|\|example.com^$cookie`.
-     * If `false`, the `value_format` is required, e.g. the value of `$app` should always be specified
+     * If `false`, the `value_format` is required, e.g. the value of `$app` should always be specified.
      */
     value_optional: booleanSchema.default(false),
     /**

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

@@ -1,12 +1,12 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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, SPECIFIC_PLATFORM_MAP_REVERSE } from '../utils/platform-helpers.js';
 import { isUndefined } from '../../utils/type-guards.js';
+import { SPECIFIC_PLATFORM_MAP, GENERIC_PLATFORM_MAP, SPECIFIC_PLATFORM_MAP_REVERSE } from '../utils/platform-helpers.js';
 
 /* eslint-disable no-bitwise */
 /**
@@ -65,6 +65,7 @@ const parseRawPlatforms = (rawPlatforms) => {
  * @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) => {

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

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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 v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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 v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 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,12 +1,12 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
+import { deepFreeze } from '../utils/deep-freeze.js';
 import { CompatibilityTableBase } from './base.js';
 import { scriptletsCompatibilityTableData } from './compatibility-table-data.js';
-import { deepFreeze } from '../utils/deep-freeze.js';
 
 /**
  * @file Compatibility tables for scriptlets.

package/dist/compatibility-tables/utils/platform-helpers.js

@@ -1,12 +1,12 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { SpecificPlatform, GenericPlatform } from '../platforms.js';
 import { AdblockProduct } from '../../utils/adblockers.js';
 import { getBitCount } from '../../utils/bit-count.js';
+import { SpecificPlatform, GenericPlatform } from '../platforms.js';
 
 /* eslint-disable no-bitwise */
 /**
@@ -191,7 +191,7 @@ const hasPlatformMultipleProducts = (platform) => {
  * - 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
+ * - `['AdGuard', 'UblockOrigin', 'AdblockPlus']` for GenericPlatform.Any.
  */
 const platformToAdblockProduct = (platform) => {
     const products = [];
@@ -262,7 +262,7 @@ const optimizePlatformRepresentation = (extractedPlatforms, productGenericPlatfo
  * - 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
+ * - Each array contains the minimal representation using generic platforms where possible.
  *
  * @example
  * ```typescript
@@ -310,6 +310,7 @@ const getPlatformsByProduct = (platform) => {
  * @param platform Platform string name, e.g., 'adg_os_windows'.
  *
  * @returns Specific or generic platform enum value.
+ *
  * @throws Error if the platform is unknown.
  */
 const getPlatformId = (platform) => {
@@ -329,6 +330,7 @@ const getPlatformId = (platform) => {
  * @param platform Specific platform enum value.
  *
  * @returns Specific platform string name, e.g., 'adg_os_windows'.
+ *
  * @throws Error if the platform is unknown.
  */
 const getSpecificPlatformName = (platform) => {

package/dist/compatibility-tables/utils/resource-type-helpers.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/compatibility-tables/utils/zod-camelcase.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -12,11 +12,11 @@ import camelCaseKeys from 'camelcase-keys';
 /**
  * Transforms Zod schema to camelCase.
  *
+ * @see {@link https://github.com/colinhacks/zod/issues/486#issuecomment-1501097361}
+ *
  * @param zod Zod schema.
  *
  * @returns Zod schema with camelCase properties.
- *
- * @see {@link https://github.com/colinhacks/zod/issues/486#issuecomment-1501097361}
  */
 const zodToCamelCase = (zod) => {
     return zod.transform((val) => camelCaseKeys(val));

package/dist/converter/base-interfaces/base-converter.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -7,49 +7,55 @@
 import { NotImplementedError } from '../../errors/not-implemented-error.js';
 
 /**
- * @file Base class for converters
+ * @file Base class for converters.
  *
  * TS doesn't support abstract static methods, so we should use
- * a workaround and extend this class instead of implementing it
+ * a workaround and extend this class instead of implementing it.
  */
 /* eslint-disable jsdoc/require-returns-check */
 /* eslint-disable @typescript-eslint/no-unused-vars */
 /**
- * Basic class for rule converters
+ * Basic class for rule converters.
  */
 class BaseConverter {
     /**
-     * Converts some data to AdGuard format
+     * Converts some data to AdGuard format.
+     *
+     * @param data Data to convert.
      *
-     * @param data Data to convert
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the data is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the data is invalid or incompatible.
      */
     static convertToAdg(data) {
         throw new NotImplementedError();
     }
     /**
-     * Converts some data to Adblock Plus format
+     * Converts some data to Adblock Plus format.
+     *
+     * @param data Data to convert.
      *
-     * @param data Data to convert
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the data is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the data is invalid or incompatible.
      */
     static convertToAbp(data) {
         throw new NotImplementedError();
     }
     /**
-     * Converts some data to uBlock Origin format
+     * Converts some data to uBlock Origin format.
+     *
+     * @param data Data to convert.
      *
-     * @param data Data to convert
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the data is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the data is invalid or incompatible.
      */
     static convertToUbo(data) {
         throw new NotImplementedError();