@adguard/agtree 2.0.2 → 2.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,13 +6,13 @@
6
6
  <img alt="AGTree" src="https://cdn.adtidy.org/website/github.com/AGTree/agtree_lightmode.svg" width="350px" />
7
7
  </picture>
8
8
  </p>
9
- <h3 align="center">Universal adblock filter list parser</h3>
9
+ <h3 align="center">Tool set for working with adblock filter lists</h3>
10
10
  <p align="center">Supported syntaxes:</p>
11
11
  <p align="center">
12
12
  <img src="https://cdn.adguard.com/website/github.com/AGLint/adg_logo.svg" width="14px" alt="AdGuard logo" /> <a href="https://adguard.com">AdGuard</a>
13
13
  | <img src="https://cdn.adguard.com/website/github.com/AGLint/ubo_logo.svg" width="14px" alt="uBlock Origin logo" /> <a href="https://github.com/gorhill/uBlock">uBlock Origin</a>
14
- | <img src="https://cdn.adguard.com/website/github.com/AGLint/ab_logo.svg" width="14px" alt="AdBlock logo" /><a href="https://getadblock.com">AdBlock</a>
15
- | <img src="https://cdn.adguard.com/website/github.com/AGLint/abp_logo.svg" width="14px" alt="Adblock Plus logo" /><a href="https://adblockplus.org">Adblock Plus</a>
14
+ | <img src="https://cdn.adguard.com/website/github.com/AGLint/ab_logo.svg" width="14px" alt="AdBlock logo" /> <a href="https://getadblock.com">AdBlock</a>
15
+ | <img src="https://cdn.adguard.com/website/github.com/AGLint/abp_logo.svg" width="14px" alt="Adblock Plus logo" /> <a href="https://adblockplus.org">Adblock Plus</a>
16
16
  </p>
17
17
  <p align="center">
18
18
  <a href="https://www.npmjs.com/package/@adguard/agtree"><img src="https://img.shields.io/npm/v/@adguard/agtree" alt="NPM version" /></a>
@@ -21,43 +21,29 @@
21
21
  </p>
22
22
  <!-- markdownlint-restore -->
23
23
 
24
- Table of Contents:
24
+ ## What is AGTree?
25
25
 
26
- - [Introduction](#introduction)
27
- - [Browser compatibility](#browser-compatibility)
28
- - [Development \& Contribution](#development--contribution)
29
- - [Ideas \& Questions](#ideas--questions)
30
- - [License](#license)
31
- - [References](#references)
26
+ AGTree is a tool set for working with adblock filter lists. It contains the following modules:
32
27
 
33
- ## Introduction
34
-
35
- AGTree is a universal tool for working with adblock filter lists. It contains the following modules:
36
-
37
- - [Adblock rule converter][converter-url]
38
28
  - [Adblock rule parser][parser-url]
29
+ - [Adblock rule converter][converter-url]
39
30
  - [Adblock rule validator][validator-url]
40
31
  - [Compatibility tables][compatibility-tables-url]
41
32
 
42
- AGTree supports all syntaxes currently in use:
33
+ ## Installation
43
34
 
44
- <!--markdownlint-disable MD013-->
45
- - <img src="https://cdn.adguard.com/website/github.com/AGLint/adg_logo.svg" alt="AdGuard logo" width="14px"> [AdGuard][adg-url]
46
- - <img src="https://cdn.adguard.com/website/github.com/AGLint/ubo_logo.svg" alt="uBlock Origin logo" width="14px"> [uBlock Origin][ubo-url]
47
- - <img src="https://cdn.adguard.com/website/github.com/AGLint/abp_logo.svg" alt="Adblock Plus logo" width="14px"> [Adblock Plus][abp-url]
48
- - <img src="https://cdn.adguard.com/website/github.com/AGLint/ab_logo.svg" alt="AdBlock logo" width="14px"> [AdBlock][ab-url]
49
- <!--markdownlint-enable MD013-->
35
+ You can install the library using
36
+
37
+ - [Yarn][yarn-pkg-manager-url]: `yarn add @adguard/agtree`
38
+ - [NPM][npm-pkg-manager-url]: `npm install @adguard/agtree`
39
+ - [PNPM][pnpm-pkg-manager-url]: `pnpm add @adguard/agtree`
50
40
 
51
- ## Browser compatibility
41
+ > [!IMPORTANT]
42
+ > AGTree requires Node.js version 18 or higher.
52
43
 
53
- | Browser | Version |
54
- |-----------------------|:----------|
55
- | Chrome | ✅ 80 |
56
- | Firefox | ✅ 78 |
57
- | Edge | ✅ 80 |
58
- | Opera | ✅ 67 |
59
- | Safari | ✅ 14 |
60
- | Internet Explorer | ❌ |
44
+ [yarn-pkg-manager-url]: https://yarnpkg.com/en/docs/install
45
+ [npm-pkg-manager-url]: https://www.npmjs.com/get-npm
46
+ [pnpm-pkg-manager-url]: https://pnpm.io/
61
47
 
62
48
  ## Development & Contribution
63
49
 
@@ -94,16 +80,13 @@ resources, please let us know.
94
80
  - <img src="https://cdn.adguard.com/website/github.com/AGLint/adg_logo.svg" width="14px" alt="AdGuard logo"> [AdGuard's compatibility table][adg-compatibility-table]
95
81
  <!--markdownlint-enable MD013-->
96
82
 
97
- [ab-url]: https://getadblock.com
98
83
  [abp-ext-css]: https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide-emulation
99
84
  [abp-filters]: https://help.eyeo.com/adblockplus/how-to-write-filters
100
85
  [abp-snippets]: https://help.eyeo.com/adblockplus/snippet-filters-tutorial#snippets-ref
101
- [abp-url]: https://adblockplus.org
102
86
  [adg-compatibility-table]: https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/compatibility-table.md
103
87
  [adg-ext-css]: https://github.com/AdguardTeam/ExtendedCss/blob/master/README.md
104
88
  [adg-filters]: https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters
105
89
  [adg-scriptlets]: https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#scriptlets
106
- [adg-url]: https://adguard.com
107
90
  [compatibility-tables-url]: https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree/src/compatibility-tables
108
91
  [contributing-url]: https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree/CONTRIBUTING.md
109
92
  [converter-url]: https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree/src/converter
@@ -116,4 +99,3 @@ resources, please let us know.
116
99
  [ubo-filters]: https://github.com/gorhill/uBlock/wiki/Static-filter-syntax
117
100
  [ubo-procedural]: https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters
118
101
  [ubo-scriptlets]: https://github.com/gorhill/uBlock/wiki/Resources-Library#available-general-purpose-scriptlets
119
- [ubo-url]: https://github.com/gorhill/uBlock
package/dist/agtree.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /*
2
- * AGTree v2.0.2 (build date: Tue, 10 Sep 2024 15:46:27 GMT)
2
+ * AGTree v2.1.1 (build date: Thu, 19 Sep 2024 13:27:19 GMT)
3
3
  * (c) 2024 Adguard Software Ltd.
4
4
  * Released under the MIT license
5
5
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -3442,9 +3442,6 @@ declare class RegExpUtils {
3442
3442
  static patternToRegexp(pattern: string): string;
3443
3443
  }
3444
3444
 
3445
- /**
3446
- * @file Utility functions for working with quotes
3447
- */
3448
3445
  /**
3449
3446
  * Possible quote types for scriptlet parameters
3450
3447
  */
@@ -3460,7 +3457,11 @@ declare enum QuoteType {
3460
3457
  /**
3461
3458
  * Double quotes (`"`)
3462
3459
  */
3463
- Double = "double"
3460
+ Double = "double",
3461
+ /**
3462
+ * Backtick quotes (`` ` ``)
3463
+ */
3464
+ Backtick = "backtick"
3464
3465
  }
3465
3466
  /**
3466
3467
  * Utility functions for working with quotes